Deploying to gh-pages from @ litestar-org/advanced-alchemy@20a1f71 🚀

Author: cofin

756/_modules/advanced_alchemy/service/_async.html

@@ -3,6 +3,158 @@
 1.x Changelog
 =============
 
+.. changelog:: 1.11.0
+    :date: 2026-05-30
+
+    .. change:: add configurable schema dump settings
+        :type: feature
+        :pr: 750
+
+        Adds ``SchemaDumpConfig`` for service input conversion, allowing schema
+        dumping behavior to be configured once on a service or overridden for a
+        single write operation. Pydantic, msgspec, attrs, and dataclass inputs
+        now flow through the shared ``schema_dump()`` utility, with options for
+        excluding unset values, ``None`` values, defaults, and sentinel values
+        while preserving the existing partial-update defaults.
+
+    .. change:: deprecate DictProtocol
+        :type: misc
+        :issue: 583
+
+        Deprecates ``advanced_alchemy.typing.DictProtocol`` and schedules it
+        for removal in 2.0. Runtime code should rely on ``has_dict_attribute()``
+        or direct ``__dict__`` duck typing instead of Protocol-based instance
+        checks.
+
+    .. change:: add choices and boolean filters
+        :type: feature
+        :pr: 723
+        :issue: 72
+
+        Adds ``ChoicesFilter`` for matching fields against a collection of
+        allowed values and ``BooleanFilter`` for optional boolean query
+        parameters. Both filters are exported through the public filter API and
+        included in ``FilterMap`` for framework integration.
+
+    .. change:: add dialect-aware vector columns
+        :type: feature
+        :pr: 739
+
+        Adds ``Vector`` as a portable column type that selects the native vector
+        implementation for Oracle 23ai and PostgreSQL/CockroachDB when
+        available, and falls back to JSON storage elsewhere. Returned vector
+        values are normalized to ``list[float]`` so callers can use one API
+        across supported dialects.
+
+    .. change:: add vector distance operators for similarity search
+        :type: feature
+        :pr: 756
+
+        Adds ``cosine_distance``, ``l2_distance``, ``l1_distance``, and
+        ``max_inner_product`` comparator methods to the ``Vector`` type so a
+        vector column can be ordered by similarity directly. Each compiles to
+        native SQL per dialect — pgvector operators on PostgreSQL/CockroachDB
+        and ``VECTOR_DISTANCE`` on Oracle 23ai — and raises a clear
+        ``NotImplementedError`` on JSON-fallback dialects.
+
+    .. change:: use native Oracle JSON when available
+        :type: feature
+        :pr: 741
+
+        Updates ``ORA_JSONB`` to prefer SQLAlchemy's native Oracle JSON type on
+        Oracle 21c and newer when running with SQLAlchemy 2.1 or newer, while
+        keeping the existing BLOB plus ``IS JSON`` check-constraint fallback for
+        older SQLAlchemy or Oracle versions. ``JsonB`` is also exposed in the
+        Alembic migration templates.
+
+    .. change:: add Oracle 23c-aware boolean columns
+        :type: feature
+        :pr: 742
+
+        Adds ``Bool`` as a dialect-aware boolean type that uses native Oracle
+        ``BOOLEAN`` support on Oracle 23c with SQLAlchemy 2.1 or newer, and
+        keeps the existing SQLAlchemy boolean behavior everywhere else. The new
+        type is exported from ``advanced_alchemy.types`` and added to the
+        Alembic migration templates.
+
+    .. change:: update Litestar parameter declarations
+        :type: feature
+        :pr: 746
+
+        Updates Litestar integration code to use the newer parameter marker
+        declarations introduced by recent Litestar releases, replacing
+        deprecated parameter specification patterns.
+
+    .. change:: support Typer 0.26 in the FastAPI CLI integration
+        :type: bugfix
+        :pr: 748
+
+        Adapts FastAPI CLI registration for Typer 0.26 and newer, where Typer
+        no longer accepts external Click command groups directly. The FastAPI
+        extension now bridges the existing Click migration command group through
+        Typer while preserving both ``database`` and ``db`` command names.
+
+    .. change:: correct Litestar server-side session backend docs
+        :type: bugfix
+        :pr: 749
+        :issue: 707 745
+
+        Corrects the Litestar server-side session guide to show both supported
+        database-backed wiring styles: registering ``SQLAlchemyStore`` under the
+        session store name, or wiring ``SessionMiddleware`` with an explicit
+        ``SQLAlchemyAsyncSessionBackend``. The examples are now executable docs
+        coverage so the documented session rows are verified against the
+        database.
+
+    .. change:: index repository classes in intersphinx inventories
+        :type: bugfix
+        :pr: 751
+        :issue: 729
+
+        Fixes the repository reference page so repository classes are included
+        in the generated ``objects.inv`` inventory for downstream Sphinx
+        projects. The memory repository classes are now documented as well, and
+        malformed deprecation directives in memory repository docstrings were
+        corrected for warning-free docs builds.
+
+    .. change:: extract provider dependency utilities
+        :type: misc
+        :pr: 721
+        :issue: 602
+
+        Moves shared framework dependency helpers into
+        ``advanced_alchemy.utils.dependencies``. Litestar and FastAPI provider
+        generation now share the same primitives while preserving framework
+        specific dependency caches and normalizing multi-field sort defaults
+        before building ``OrderBy`` filters.
+
+    .. change:: document GUID storage and UUIDv7 usage
+        :type: misc
+        :pr: 743
+
+        Expands the GUID documentation with Oracle storage details and guidance
+        for using UUIDv7 primary keys where time-ordered identifiers improve
+        index locality.
+
+    .. change:: document custom non-autogenerated primary keys
+        :type: misc
+        :pr: 754
+        :issue: 649
+
+        Documents how to compose ``DefaultBase`` with ``AuditColumns`` when a
+        model needs caller-supplied primary keys instead of autogenerated
+        identifiers, including string and integer primary-key examples.
+
+    .. change:: document mixin column ordering
+        :type: misc
+        :pr: 753
+        :issue: 584
+
+        Adds documentation for the ``sort_order`` values used by Advanced
+        Alchemy mixins so users can understand the physical column order
+        produced for newly-created tables.
+
+
 .. changelog:: 1.10.0
     :date: 2026-05-23