tigrbl-ops-oltp 0.4.5.dev4__tar.gz → 0.4.5.dev6__tar.gz

{tigrbl_ops_oltp-0.4.5.dev4 → tigrbl_ops_oltp-0.4.5.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-ops-oltp
-Version: 0.4.5.dev4
+Version: 0.4.5.dev6
 Summary: Transactional OLTP operation handlers for Tigrbl CRUD, bulk, REST, JSON-RPC, and database-backed workloads.
 License: Apache License
                                     Version 2.0, January 2004
@@ -232,7 +232,7 @@ Project-URL: Discord, https://discord.gg/K4YTAPapjR
 Project-URL: Homepage, https://github.com/tigrbl/tigrbl
 Project-URL: Issues, https://github.com/tigrbl/tigrbl/issues
 Project-URL: Organization, https://github.com/tigrbl
-Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_ops_oltp
+Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/60_ops/tigrbl_ops_oltp
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -242,7 +242,7 @@ Description-Content-Type: text/markdown
 <a href="https://pypi.org/project/tigrbl-ops-oltp/"><img src="https://img.shields.io/pypi/v/tigrbl-ops-oltp?label=PyPI" alt="PyPI version for tigrbl-ops-oltp"/></a>
 <a href="https://pypi.org/project/tigrbl-ops-oltp/"><img src="https://static.pepy.tech/badge/tigrbl-ops-oltp" alt="Downloads for tigrbl-ops-oltp"/></a>
 <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-ops-oltp"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_ops_oltp/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_ops_oltp/README.md.svg?label=hits" alt="Repository hits for tigrbl-ops-oltp README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/60_ops/tigrbl_ops_oltp/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/60_ops/tigrbl_ops_oltp/README.md.svg?label=hits" alt="Repository hits for tigrbl-ops-oltp README"/></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
 <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-ops-oltp"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-ops-oltp"/></a>
@@ -266,7 +266,7 @@ Framework maintainers and extension authors working near Tigrbl operation dispat
 
 ## Where does tigrbl-ops-oltp fit?
 
-`tigrbl-ops-oltp` lives at `pkgs/core/tigrbl_ops_oltp` and serves focused operation dispatch behavior inside the Tigrbl runtime model.
+`tigrbl-ops-oltp` lives at `pkgs/60_ops/tigrbl_ops_oltp` and serves focused operation dispatch behavior inside the Tigrbl runtime model.
 
 ## How does tigrbl-ops-oltp work?
 
@@ -288,7 +288,7 @@ pip install tigrbl-ops-oltp
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/) |
-| Repository path | [`pkgs/core/tigrbl_ops_oltp`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_ops_oltp) |
+| Repository path | [`pkgs/60_ops/tigrbl_ops_oltp`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/60_ops/tigrbl_ops_oltp) |
 | Python import root | `tigrbl_ops_oltp` |
 | Console scripts | none declared |
 | Entry points | none declared |
@@ -375,7 +375,7 @@ Choose `tigrbl-ops-oltp` when the quick-answer table matches your use case. Choo
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_ops_oltp](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_ops_oltp).
+- Repository: [pkgs/60_ops/tigrbl_ops_oltp](https://github.com/tigrbl/tigrbl/tree/master/pkgs/60_ops/tigrbl_ops_oltp).
 
 ## Package-local Boundary
 
@@ -386,7 +386,7 @@ This README is the package-local distribution entry point for `tigrbl-ops-oltp`.
 - Package status: governed package in the `tigrbl/tigrbl` workspace.
 - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
 - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
-- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Local certification guard: `pkgs/97_tests/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
 - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
 
 ## License

{tigrbl_ops_oltp-0.4.5.dev4 → tigrbl_ops_oltp-0.4.5.dev6}/README.md

@@ -5,7 +5,7 @@
 <a href="https://pypi.org/project/tigrbl-ops-oltp/"><img src="https://img.shields.io/pypi/v/tigrbl-ops-oltp?label=PyPI" alt="PyPI version for tigrbl-ops-oltp"/></a>
 <a href="https://pypi.org/project/tigrbl-ops-oltp/"><img src="https://static.pepy.tech/badge/tigrbl-ops-oltp" alt="Downloads for tigrbl-ops-oltp"/></a>
 <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-ops-oltp"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_ops_oltp/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_ops_oltp/README.md.svg?label=hits" alt="Repository hits for tigrbl-ops-oltp README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/60_ops/tigrbl_ops_oltp/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/60_ops/tigrbl_ops_oltp/README.md.svg?label=hits" alt="Repository hits for tigrbl-ops-oltp README"/></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
 <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-ops-oltp"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-ops-oltp"/></a>
@@ -29,7 +29,7 @@ Framework maintainers and extension authors working near Tigrbl operation dispat
 
 ## Where does tigrbl-ops-oltp fit?
 
-`tigrbl-ops-oltp` lives at `pkgs/core/tigrbl_ops_oltp` and serves focused operation dispatch behavior inside the Tigrbl runtime model.
+`tigrbl-ops-oltp` lives at `pkgs/60_ops/tigrbl_ops_oltp` and serves focused operation dispatch behavior inside the Tigrbl runtime model.
 
 ## How does tigrbl-ops-oltp work?
 
@@ -51,7 +51,7 @@ pip install tigrbl-ops-oltp
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/) |
-| Repository path | [`pkgs/core/tigrbl_ops_oltp`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_ops_oltp) |
+| Repository path | [`pkgs/60_ops/tigrbl_ops_oltp`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/60_ops/tigrbl_ops_oltp) |
 | Python import root | `tigrbl_ops_oltp` |
 | Console scripts | none declared |
 | Entry points | none declared |
@@ -138,7 +138,7 @@ Choose `tigrbl-ops-oltp` when the quick-answer table matches your use case. Choo
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_ops_oltp](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_ops_oltp).
+- Repository: [pkgs/60_ops/tigrbl_ops_oltp](https://github.com/tigrbl/tigrbl/tree/master/pkgs/60_ops/tigrbl_ops_oltp).
 
 ## Package-local Boundary
 
@@ -149,7 +149,7 @@ This README is the package-local distribution entry point for `tigrbl-ops-oltp`.
 - Package status: governed package in the `tigrbl/tigrbl` workspace.
 - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
 - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
-- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Local certification guard: `pkgs/97_tests/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
 - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
 
 ## License

{tigrbl_ops_oltp-0.4.5.dev4 → tigrbl_ops_oltp-0.4.5.dev6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-ops-oltp"
-version = "0.4.5.dev4"
+version = "0.4.5.dev6"
 description = "Transactional OLTP operation handlers for Tigrbl CRUD, bulk, REST, JSON-RPC, and database-backed workloads."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -52,7 +52,7 @@ dependencies = [
 Organization = "https://github.com/tigrbl"
 Discord = "https://discord.gg/K4YTAPapjR"
 Homepage = "https://github.com/tigrbl/tigrbl"
-Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_ops_oltp"
+Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/60_ops/tigrbl_ops_oltp"
 Issues = "https://github.com/tigrbl/tigrbl/issues"
 
 [tool.uv.sources]

{tigrbl_ops_oltp-0.4.5.dev4 → tigrbl_ops_oltp-0.4.5.dev6}/tigrbl_ops_oltp/crud/bulk.py

@@ -9,7 +9,6 @@ from .helpers import (
     AsyncSession,
     Session,
     sa_delete,
-    _coerce_pk_value,
     _immutable_columns,
     _maybe_delete,
     _maybe_execute,
@@ -113,7 +112,7 @@ async def bulk_merge(
     to_create: List[Mapping[str, Any]] = []
     for r in rows or ():
         r = dict(r)
-        ident = _coerce_pk_value(model, r.get(pk))
+        ident = r.get(pk)
         if ident is not None:
             existing = await _maybe_get(db, model, ident)
             if existing is not None:

{tigrbl_ops_oltp-0.4.5.dev4 → tigrbl_ops_oltp-0.4.5.dev6}/tigrbl_ops_oltp/crud/helpers/__init__.py

@@ -18,13 +18,12 @@ except Exception:  # pragma: no cover
 from .model import (
     _pk_columns,
     _single_pk_name,
-    _coerce_pk_value,
     _model_columns,
     _colspecs,
     _filter_in_values,
     _immutable_columns,
 )
-from .filters import _CANON_OPS, _coerce_filters, _apply_filters, _apply_sort
+from .filters import _CANON_OPS, _authorize_filters, _apply_filters, _apply_sort
 from .db import (
     _is_async_db,
     _maybe_get,
@@ -51,8 +50,7 @@ __all__ = [
     "_apply_filters",
     "_apply_sort",
     "_CANON_OPS",
-    "_coerce_filters",
-    "_coerce_pk_value",
+    "_authorize_filters",
     "_colspecs",
     "_filter_in_values",
     "_immutable_columns",

{tigrbl_ops_oltp-0.4.5.dev4 → tigrbl_ops_oltp-0.4.5.dev6}/tigrbl_ops_oltp/crud/helpers/filters.py

@@ -4,6 +4,8 @@ from typing import Any, Dict, Iterable, Mapping, Optional, Sequence
 
 import logging
 
+from tigrbl_typing.status.exceptions import HTTPException
+
 from . import select, and_, asc, desc
 from .model import _model_columns, _colspecs
 
@@ -36,29 +38,33 @@ _CANON_OPS = {
 }
 
 
-def _coerce_filters(
-    model: type, filters: Optional[Mapping[str, Any]]
+def _authorize_filters(
+    model: type, filters: Optional[Mapping[str, Any]], *, strict: bool = False
 ) -> Dict[str, Any]:
-    logger.debug("_coerce_filters called with filters=%s", filters)
+    logger.debug("_authorize_filters called with filters=%s", filters)
     cols = set(_model_columns(model))
     specs = _colspecs(model)
     raw = dict(filters or {})
     out: Dict[str, Any] = {}
     for k, v in raw.items():
         name, op = k.split("__", 1) if "__" in k else (k, "eq")
-        if name not in cols:
-            continue
         canon = _CANON_OPS.get(op, op)
         sp = specs.get(name)
-        if sp is not None:
-            io = getattr(sp, "io", None)
-            ops = set(getattr(io, "filter_ops", ()) or [])
-            ops = {_CANON_OPS.get(o, o) for o in ops}
-            if not ops or canon not in ops:
-                continue
+        io = getattr(sp, "io", None)
+        ops = {_CANON_OPS.get(o, o) for o in getattr(io, "filter_ops", ()) or ()}
+        if (
+            name not in cols
+            or (sp is not None and canon not in ops)
+            or (strict and op not in _CANON_OPS)
+        ):
+            if strict:
+                raise HTTPException(
+                    status_code=422, detail=f"Unsupported clear filter: {k}"
+                )
+            continue
         key = name if canon == "eq" else f"{name}__{canon}"
         out[key] = v
-    logger.debug("_coerce_filters returning %s", out)
+    logger.debug("_authorize_filters returning %s", out)
     return out
 
 

{tigrbl_ops_oltp-0.4.5.dev4 → tigrbl_ops_oltp-0.4.5.dev6}/tigrbl_ops_oltp/crud/helpers/model.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import datetime as dt
 from functools import lru_cache
 from typing import Any, Dict, Mapping, Tuple
 
@@ -61,11 +60,11 @@ def _filter_plan_cache_token(model: type, verb: str) -> tuple[int, int, int, int
 @lru_cache(maxsize=512)
 def _filter_plan_cached(
     model: type, verb: str, cache_token: tuple[int, int, int, int, int]
-) -> tuple[Mapping[str, bool], frozenset[str], Mapping[str, Any]]:
+) -> tuple[Mapping[str, bool], frozenset[str]]:
     del cache_token
     specs = _colspecs(model)
     if not specs:
-        return {}, frozenset(), _table_python_types(model)
+        return {}, frozenset()
 
     allowed_by_field: dict[str, bool] = {}
     for name, sp in specs.items():
@@ -80,28 +79,7 @@ def _filter_plan_cached(
         )
         allowed_by_field[name] = allowed
 
-    return (
-        allowed_by_field,
-        _excluded_schema_fields(model, verb),
-        _table_python_types(model),
-    )
-
-
-@lru_cache(maxsize=256)
-def _table_python_types(model: type) -> Mapping[str, Any]:
-    table = getattr(model, "__table__", None)
-    columns = getattr(table, "columns", None)
-    if columns is None:
-        return {}
-    resolved: dict[str, Any] = {}
-    for col in columns:
-        try:
-            py_t = getattr(getattr(col, "type", None), "python_type", None)
-        except Exception:
-            py_t = None
-        if py_t is not None:
-            resolved[getattr(col, "name", "")] = py_t
-    return resolved
+    return allowed_by_field, _excluded_schema_fields(model, verb)
 
 
 def _pk_columns(model: type) -> Tuple[Any, ...]:
@@ -124,23 +102,6 @@ def _single_pk_name(model: type) -> str:
     return name
 
 
-def _coerce_pk_value(model: type, value: Any) -> Any:
-    if value is None:
-        return None
-    try:
-        col = _pk_columns(model)[0]
-        py_type = col.type.python_type  # type: ignore[attr-defined]
-    except Exception:  # pragma: no cover - best effort
-        return value
-    if isinstance(value, py_type):
-        return value
-    try:
-        coerced = py_type(value)
-        return coerced
-    except Exception:  # pragma: no cover - fallback to original
-        return value
-
-
 def _model_columns(model: type) -> Tuple[str, ...]:
     table = getattr(model, "__table__", None)
     if table is None:
@@ -156,7 +117,7 @@ def _colspecs(model: type) -> Mapping[str, Any]:
 def _filter_in_values(
     model: type, data: Mapping[str, Any], verb: str
 ) -> Dict[str, Any]:
-    allowed_by_field, excluded_fields, column_types = _filter_plan_cached(
+    allowed_by_field, excluded_fields = _filter_plan_cached(
         model, verb, _filter_plan_cache_token(model, verb)
     )
     if not allowed_by_field and not excluded_fields:
@@ -171,19 +132,7 @@ def _filter_in_values(
             out[k] = v
             continue
         if allowed:
-            try:
-                py_t = column_types.get(k)
-                if py_t is not None and v is not None and not isinstance(v, py_t):
-                    if py_t in (dt.datetime, dt.date) and isinstance(v, str):
-                        parsed = py_t.fromisoformat(v)
-                        out[k] = parsed
-                    else:
-                        out[k] = py_t(v)
-                else:
-                    out[k] = v
-            except Exception:
-                # Best effort coercion only; preserve original value on failure.
-                out[k] = v
+            out[k] = v
     return out
 
 

{tigrbl_ops_oltp-0.4.5.dev4 → tigrbl_ops_oltp-0.4.5.dev6}/tigrbl_ops_oltp/crud/ops.py

@@ -21,8 +21,7 @@ from .helpers import (
     sa_delete,
     _apply_filters,
     _apply_sort,
-    _coerce_filters,
-    _coerce_pk_value,
+    _authorize_filters,
     _filter_in_values,
     _immutable_columns,
     _maybe_delete,
@@ -38,6 +37,20 @@ from .helpers import (
 logger = logging.getLogger("uvicorn")
 
 _MAPPED_MODELS: "WeakSet[type]" = WeakSet()
+_NO_NATIVE_OPERATION = object()
+
+
+async def _call_native_operation(
+    db: Any,
+    name: str,
+    *args: Any,
+    **kwargs: Any,
+) -> Any:
+    operation = getattr(db, name, None)
+    if not callable(operation):
+        return _NO_NATIVE_OPERATION
+    result = operation(*args, **kwargs)
+    return await result if inspect.isawaitable(result) else result
 
 
 @lru_cache(maxsize=512)
@@ -127,9 +140,12 @@ async def create(
     Flush-only (commit happens later in TX_COMMIT).
     """
     logger.debug("create called with model=%s data=%s", model, data)
-    _ensure_model_mapped(model)
     data = _filter_in_values(model, data or {}, "create")
     _validate_enum_values(model, data)
+    native = await _call_native_operation(db, "create_record", model, data)
+    if native is not _NO_NATIVE_OPERATION:
+        return native
+    _ensure_model_mapped(model)
     obj = model(**data)
     if hasattr(db, "add"):
         try:
@@ -170,6 +186,9 @@ async def read(model: type, ident: Any, db: Union[Session, AsyncSession]) -> Any
     Load a single row by primary key. Raises NoResultFound if not found.
     """
     logger.debug("read called with model=%s ident=%s", model, ident)
+    native = await _call_native_operation(db, "read_record", model, ident)
+    if native is not _NO_NATIVE_OPERATION:
+        return native
     _ensure_model_mapped(model)
     obj = await _maybe_get(db, model, ident)
     if obj is None:
@@ -233,7 +252,6 @@ async def merge(
     logger.debug("merge called with model=%s ident=%s data=%s", model, ident, data)
     _ensure_model_mapped(model)
     pk = _single_pk_name(model)
-    ident = _coerce_pk_value(model, ident)
     obj = await _maybe_get(db, model, ident)
 
     verb = "update" if obj is not None else "create"
@@ -260,6 +278,9 @@ async def delete(
     Flush-only.
     """
     logger.debug("delete called with model=%s ident=%s", model, ident)
+    native = await _call_native_operation(db, "delete_record", model, ident)
+    if native is not _NO_NATIVE_OPERATION:
+        return native
     _ensure_model_mapped(model)
     obj = await read(model, ident, db)
     await _maybe_delete(db, obj)
@@ -280,13 +301,23 @@ async def list(*_args: Any, **_kwargs: Any) -> List[Any]:  # noqa: A001  (shadow
     """
     logger.debug("list called with args=%s kwargs=%s", _args, _kwargs)
     model, params = _normalize_list_call(_args, _kwargs)
-    _ensure_model_mapped(model)
-
-    filters: Mapping[str, Any] = _coerce_filters(model, params["filters"])
+    filters: Mapping[str, Any] = _authorize_filters(model, params["filters"])
     skip: Optional[int] = params["skip"]
     limit: Optional[int] = params["limit"]
     db: Union[Session, AsyncSession] = params["db"]
     sort = params["sort"]
+    native = await _call_native_operation(
+        db,
+        "list_records",
+        model,
+        filters=filters,
+        skip=skip,
+        limit=limit,
+        sort=sort,
+    )
+    if native is not _NO_NATIVE_OPERATION:
+        return native
+    _ensure_model_mapped(model)
 
     if select is None:  # pragma: no cover
         # Fallback: legacy query API
@@ -331,13 +362,23 @@ async def clear(
     # Reuse normalizer to accept the same shapes
     logger.debug("clear called with args=%s kwargs=%s", args, kwargs)
     model, params = _normalize_list_call(args, kwargs)
-    _ensure_model_mapped(model)
-    raw_filters: Mapping[str, Any] = params["filters"]
+    filters: Mapping[str, Any] = _authorize_filters(
+        model, params["filters"], strict=True
+    )
     db: Union[Session, AsyncSession] = params["db"]
+    native = await _call_native_operation(
+        db,
+        "clear_records",
+        model,
+        filters=filters,
+    )
+    if native is not _NO_NATIVE_OPERATION:
+        return native
+    _ensure_model_mapped(model)
 
     if sa_delete is None:  # pragma: no cover
         # Fallback path: manual iteration
-        items = await list(model, raw_filters, db=db)
+        items = await list(model, filters, db=db)
         n = 0
         for obj in items:
             await _maybe_delete(db, obj)
@@ -345,8 +386,7 @@ async def clear(
         await _maybe_flush(db)
         return {"deleted": n}
 
-    filt = _coerce_filters(model, raw_filters)
-    where = _apply_filters(model, filt)
+    where = _apply_filters(model, filters)
     stmt = sa_delete(model)
     if where is not None:
         stmt = stmt.where(where)
@@ -361,10 +401,17 @@ async def clear(
 async def count(*args: Any, **kwargs: Any) -> Dict[str, int]:
     """Count rows matching equality filters."""
     model, params = _normalize_list_call(args, kwargs)
-    _ensure_model_mapped(model)
-
-    filters: Mapping[str, Any] = _coerce_filters(model, params["filters"])
+    filters: Mapping[str, Any] = _authorize_filters(model, params["filters"])
     db: Union[Session, AsyncSession] = params["db"]
+    native = await _call_native_operation(
+        db,
+        "count_records",
+        model,
+        filters=filters,
+    )
+    if native is not _NO_NATIVE_OPERATION:
+        return native
+    _ensure_model_mapped(model)
     stmt = select(func.count()).select_from(model)
     where = _apply_filters(model, filters)
     if where is not None:
@@ -374,8 +421,13 @@ async def count(*args: Any, **kwargs: Any) -> Dict[str, int]:
     return {"count": int(value or 0)}
 
 
-async def exists(model: type, ident: Any, db: Union[Session, AsyncSession]) -> Dict[str, bool]:
+async def exists(
+    model: type, ident: Any, db: Union[Session, AsyncSession]
+) -> Dict[str, bool]:
     """Check whether a row exists by primary key."""
+    native = await _call_native_operation(db, "exists_record", model, ident)
+    if native is not _NO_NATIVE_OPERATION:
+        return native
     _ensure_model_mapped(model)
     obj = await _maybe_get(db, model, ident)
     return {"exists": obj is not None}