Change Log

Copy Markdown View Source

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

v0.5.1 (2026-05-10)

Improvements

  • Documentation (#249) — ex_doc configuration overhauled: extras reorganised with titled entries, module groups defined for AshNeo4j, Introspection, Cypher, Utilities and Internals, Livebook added to How To, CHANGELOG included in About AshNeo4j, maintainer contact updated.

Bug Fixes

  • Aggregate filters honoured (#252) — filters declared via filter expr(...) on aggregate definitions were silently dropped. Filtered aggregates now load full destination records in Elixir and apply Ash.Filter.Runtime.filter_matches/3 per source group before reducing. The fast Cypher push-down path is preserved for unfiltered aggregates.

  • Aggregate names with ? suffix (#251) — aggregate names following the Elixir predicate convention (e.g. exists :cvc_defined?, :characteristics) caused Neo4j to reject the generated Cypher with an invalid identifier error. Column aliases are now backtick-quoted, allowing any valid Elixir atom as an aggregate name.

v0.5.0 (2026-05-08)

Features

  • Aggregates — full support for :count, :exists, :sum, :avg, :min, :max, :first, :list aggregate kinds, declared in the standard Ash aggregates block. Aggregates are executed as Cypher OPTIONAL MATCH traversals; single-hop and multi-hop relationship paths are both supported.
  • Aggregates on embedded/JSON-type fields — when field: points to an attribute stored as JSON (Ash.TypedStruct, Ash.Type.NewType, embedded resources, Ash.Type.Map, etc.) AshNeo4j collects raw JSON from Neo4j and deserializes in Elixir. :list and :first return fully-typed structs; :sum/:avg/:min/:max work on directly comparable values.
  • Expression aggregates (expr:) — programmatic aggregate API (Ash.aggregate/3) accepts expr: to aggregate over a sub-field of an embedded struct or any Ash expression, without needing to elevate the field. Uses Ash.Expr.eval_hydrated/2 on full destination records.
  • Expression calculations — calculate :name, :type, expr(...) declarations are now evaluated in Elixir after records are loaded. Supports load (Ash.load!), filter (Ash.Query.filter), and sort (Ash.Query.sort). Embedded struct fields work directly via get_path — no elevation needed.

Improvements

  • Cypher query struct family extended; Neo4jHelper refactored to use it
  • Calculation-based filter predicates are excluded from Cypher WHERE and evaluated in-memory via Ash.Filter.Runtime
  • Calculation-based sort terms are applied post-load via Ash.Actions.Sort.runtime_sort/3

v0.4.1 (2026-05-06)

What's Changed

v0.4.0 (2026-05-01)

Features:

  • real Neo4j transactions via Bolty.transaction — can?(_, :transact) now advertised, rollback genuinely aborts the database transaction
  • AshNeo4j.Sandbox — test isolation adapter analogous to Ecto.Adapters.SQL.Sandbox, enabling safe parallel test execution with async: true

Improvements:

  • silenced spurious runtime Logger.warning calls that fired on normal OPTIONAL MATCH traversal
  • full test suite parallelised with async: true

v0.3.1 (2026-04-23)

This release changes the storage type for Ash.Type.DateTime, Ash.Type.UtcDateTime and Ash.Type.UtcDateTimeUsec

What's Changed

  • use native neo4j 5.x datetime by @matt-beanland

v0.3.0 (2026-04-18)

This release changes the storage type for most types. Ash.Type dump_to_native/cast_stored are used where possible.T String.Chars is no longer required and JSON blobs/Base64 are employed. Native Neo4j types are used except for datetime, instead we use ISO8601 strings to work around Neo4j 5.x incompatibility. There is no data migration supported.

What's Changed

v0.2.15 (2026-03-19)

Fixes

  • fix domain label incorrect

v0.2.14 (2026-03-19)

Fixes

  • fix relationship enrichment inconsistent across neo4j versions

v0.2.13 (2026-03-12)

Features

  • translate using attribute source (translate DSL removed)
  • nodes are also labelled with domain label

Fixes

  • fixed dates and times not native

Maintenance

v0.2.12 (2025-11-18)

Features

  • 173 relationship source attribute filtering by @matt-beanland in #174

Maintenance

  • added deep wiki badge by @matt-beanland in #171

v0.2.11 (2025-10-13)

Features

  • REUSE compliant

Fixes

  • updated ash dependency for CVE-2025-48043 fix

v0.2.10 (2025-09-09)

Maintenance

  • fixed update on_lookup relate on has_many exclusivity

v0.2.9 (2025-08-16)

Maintenance

  • fixed Ash.Error.Unknown when reading structs embedded in structs

v0.2.8 (2025-08-14)

Features

  • relate destination node label
  • independent relationships
  • simplified dsl

Maintenance

  • fixed unexpected empty query result
  • fixed has_many enrichment incorrect cypher
  • fixed create with multiple relationships doesn't relate nodes

v0.2.7 (2025-08-03)

Features

  • relates node cypher avoids cartesian product warning

Maintenance

  • fixed Ash.Error.Unknown no result to unrelate nodes
  • fixed create or update belongs_to on same resoruce adds rather than replaces
  • fixed Ash.Error.Unknown no case clause matching on update
  • fixed guard edge label regex
  • fixed sorting not working
  • fixed nested calculations with references are nil

v0.2.6 (2025-07-25)

Maintenance

  • fixed nested calculations with references are nil
  • fixed cypher error when filtering on atom type
  • fixed Ash.Error.Unknown when a delete is guarded
  • fixed Ash.Error.Unknown invalid filter statement provided

v0.2.5 (2025-07-21)

Features:

  • guard against destroy
  • improved has_one and belongs_to enrichment
  • improved logging

Maintenance

  • fixed destroy should fail when destination has allow_nil?: false

v0.2.4 (2025-07-16)

Features:

  • support AshStateMachine
  • improved enrichment
  • query on relationship attribute
  • create with multiple relationships

Maintenance

  • fixed Ash.Error.Unknown no function matching clause in AshNeo4j.Cypher.expression/4

v0.2.3 (2025-07-10)

Features:

  • expression calculations
  • unloaded attributes are Ash.NotLoaded
  • improved metadata
  • improved relate error messages
  • improved relate verification

v0.2.2 (2025-06-26)

Maintenance:

  • refactored tests
  • fixed Ash.Error.Unknown when filtering using contains
  • fixed Ash.Error.Unknown in datalayer when relate not defined

v0.2.1 (2025-06-17)

Features:

  • many to many relationship (back to back has_many)
  • has one relationship

v0.2.0 (2025-06-05)

Features:

  • improved BoltxHelper
  • create relate
  • livebook

v0.1.6 (2025-06-02)

Features:

  • embedded resources
  • nil attributes
  • nil relationship attributes

v0.1.5 (2025-05-31)

Features:

  • logger
  • upsert nodes
  • optional label

v0.1.4 (2025-05-28)

Features:

  • spark improvements

v0.1.3 (2025-05-24)

Features:

  • sort, offset, limit

v0.1.2 (2025-05-23)

Features:

  • property types, duration, relate, destroy

v0.1.1 (2025-05-05)

Features:

  • create

Bug Fixes:

  • read arbitrary resource

v0.1.0 (2025-04-30)

Features:

  • initial version, read only