Synapse

====================

Features and Enhancements
-------------------------
- Update the cron subsystem logs to include the cron name, as well as adding
additional data for structured logging output.
(`2477 <https://github.com/vertexproject/synapse/pull/2477>`_)
- Add a ``sort_keys`` argument to the ``$lib.yaml.save()`` Stormtype API.
(`2474 <https://github.com/vertexproject/synapse/pull/2474>`_)

Bugfixes
--------
- Update the ``asyncio-socks`` version to a version which has a pinned version
range for the ``python-socks`` dependency.
(`2478 <https://github.com/vertexproject/synapse/pull/2478>`_)

====================

Bugfixes
--------
- Update the ``PyOpenSSL`` version to ``21.0.0`` and pin a range of modern
versions of the ``cryptography`` which have stronger API compatibility.
This resolves an API compatibility issue with the two libraries which
affected SSL certificate generation.
(`2476 <https://github.com/vertexproject/synapse/pull/2476>`_)

====================

Features and Enhancements
-------------------------
- Add support for asynchronous triggers. This mode of trigger operation queues
up the trigger event in the View for eventual processing.
(`2464 <https://github.com/vertexproject/synapse/pull/2464>`_)
- Update the crypto model to add a ``crypto:smart:token`` form to represent a
token managed by a smart contract.
(`2462 <https://github.com/vertexproject/synapse/pull/2462>`_)
- Add ``$lib.axon.readlines()`` and ``$lib.axon.jsonlines()`` to Stormtypes.
(`2468 <https://github.com/vertexproject/synapse/pull/2468>`_)
- Add the Storm ``mode`` to the structured log output of a Cortex executing a
Storm query.
(`2466 <https://github.com/vertexproject/synapse/pull/2466>`_)

Bugfixes
--------
- Fix an error when converting Lark exceptions to Synapse ``BadSyntaxError``.
(`2471 <https://github.com/vertexproject/synapse/pull/2471>`_)

Improved Documentation
----------------------
- Revise the Synapse documentation layout.
(`2460 <https://github.com/vertexproject/synapse/pull/2460>`_)
- Update type specific behavior documentation for ``time`` types, including
the recently added wildcard time syntax.
(`2467 <https://github.com/vertexproject/synapse/pull/2467>`_)
- Sort the Storm Type documentation by name.
(`2465 <https://github.com/vertexproject/synapse/pull/2465>`_)
- Add 404 handler pages to our documentation.
(`2461 <https://github.com/vertexproject/synapse/pull/2461>`_)
(`2470 <https://github.com/vertexproject/synapse/pull/2470>`_)

Deprecations
------------
- Remove ``$path.trace()`` objects.
(`2445 <https://github.com/vertexproject/synapse/pull/2445>`_)

====================

Bugfixes
--------
- Fix an issue where ``$path.meta`` data was not being properly serialized
when heavy Stormtype objects were set on the ``$path.meta`` dictionary.
(`2456 <https://github.com/vertexproject/synapse/pull/2456>`_)
- Fix an issue with Stormtypes ``Str.encode()`` and ``Bytes.decode()`` methods
when handling potentially malformed Unicode string data.
(`2457 <https://github.com/vertexproject/synapse/pull/2457>`_)

Improved Documentation
----------------------
- Update the Storm Control Flow documentation with additional examples.
(`2443 <https://github.com/vertexproject/synapse/pull/2443>`_)

====================

Features and Enhancements
-------------------------
- Add ``:dst:handshake`` and ``src:handshake`` properties to ``inet:flow`` to
record text representations of the handshake strings of a given connection.
(`2451 <https://github.com/vertexproject/synapse/pull/2451>`_)
- Add a ``proj:attachment`` form to the ``project`` model to represent
attachments to a given ``proj:ticket``.
(`2451 <https://github.com/vertexproject/synapse/pull/2451>`_)
- Add a implicit wildcard behavior to the ``time`` type when lifting or
filtering nodes. Dates ending in a ``*`` are converted into ranges covering
all possible times in them. For example, ``.created=202101*`` would lift all
nodes created on the first month of 2021.
(`2446 <https://github.com/vertexproject/synapse/pull/2446>`_)
- Add the following ``$lib.time`` functions to chop information from a time
value.
(`2446 <https://github.com/vertexproject/synapse/pull/2446>`_)

- ``$lib.time.year()``
- ``$lib.time.month()``
- ``$lib.time.day()``
- ``$lib.time.hour()``
- ``$lib.time.minute()``
- ``$lib.time.second()``
- ``$lib.time.dayofweek()``
- ``$lib.time.dayofmonth()``
- ``$lib.time.monthofyear()``

- Add ``List.extend()``, ``List.slice()``, ``Str.find()``, and ``Str.size()``
functions to Stormtypes.
(`2450 <https://github.com/vertexproject/synapse/pull/2450>`_)
(`2451 <https://github.com/vertexproject/synapse/pull/2451>`_)
- Add ``$lib.json.schema()`` and a ``json:schema`` object to Stormtypes.
These can be used to validate arbitrary data JSON structures in Storm using
JSON Schema.
(`2448 <https://github.com/vertexproject/synapse/pull/2448>`_)
- Update syntax checking rules and address deprecation warnings for strings
in the Synapse codebase.
(`2426 <https://github.com/vertexproject/synapse/pull/2426>`_)

====================

Features and Enhancements
-------------------------
- Add support for building Optic Workflows for Storm Packages in the
``synapse.tools.genpkg`` tool.
(`2444 <https://github.com/vertexproject/synapse/pull/2444>`_)
- The ``synapse.tools.storm`` CLI tool now prints out node properties in
precedence order.
(`2449 <https://github.com/vertexproject/synapse/pull/2449>`_)
- Update the global Stormtypes registry to better track types when they are
added or removed.
(`2447 <https://github.com/vertexproject/synapse/pull/2447>`_)