tigrbl-atoms 0.4.5.dev4__tar.gz → 0.4.5.dev6__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-atoms
-Version: 0.4.5.dev4
+Version: 0.4.5.dev6
 Summary: Runtime atom package for Tigrbl stages, phases, typed contexts, event anchors, protocol execution, and composable pipeline algebra.
 License: Apache License
                                     Version 2.0, January 2004
@@ -232,7 +232,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Dist: jinja2 (>=3.1)
 Requires-Dist: sqlalchemy (>=2.0)
-Requires-Dist: tigrbl-core
+Requires-Dist: tigrbl-core (>=0.4.5.dev6)
 Requires-Dist: tigrbl-ops-olap
 Requires-Dist: tigrbl-ops-oltp
 Requires-Dist: tigrbl-ops-realtime
@@ -243,7 +243,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_atoms
+Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/40_atoms/tigrbl_atoms
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -253,7 +253,7 @@ Description-Content-Type: text/markdown
 <a href="https://pypi.org/project/tigrbl-atoms/"><img src="https://img.shields.io/pypi/v/tigrbl-atoms?label=PyPI" alt="PyPI version for tigrbl-atoms"/></a>
 <a href="https://pypi.org/project/tigrbl-atoms/"><img src="https://static.pepy.tech/badge/tigrbl-atoms" alt="Downloads for tigrbl-atoms"/></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-atoms"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_atoms/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_atoms/README.md.svg?label=hits" alt="Repository hits for tigrbl-atoms README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/40_atoms/tigrbl_atoms/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/40_atoms/tigrbl_atoms/README.md.svg?label=hits" alt="Repository hits for tigrbl-atoms 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%2C%203.11%2C%203.12%2C%203.13%2C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-atoms"/></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-atoms"/></a>
@@ -277,12 +277,23 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 ## Where does tigrbl-atoms fit?
 
-`tigrbl-atoms` lives at `pkgs/core/tigrbl_atoms` and serves a focused layer in the split Tigrbl framework.
+`tigrbl-atoms` lives at `pkgs/40_atoms/tigrbl_atoms` and serves a focused layer in the split Tigrbl framework.
 
 ## How does tigrbl-atoms work?
 
 It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
 
+Inbound materialization belongs to `wire.validate_in`, which uses the core schema
+materializer and declared field types (or mapped storage types when no field type
+is declared). Member identifiers are selector inputs even when the primary key
+is not writable. Route selectors take precedence over payload identifiers and
+invalid selectors raise 422 before persistence. Persistence atoms consume the
+validated payload and path carriers, including bulk values; CRUD helpers do not
+repeat type coercion. Selector operations currently use the full atom pipeline
+because the compiled scalar input shortcut does not implement route alias and
+selector precedence validation. CRUD operations retain their existing flush-only
+transaction contract; the caller owns commit or rollback.
+
 
 ## Install
 
@@ -299,7 +310,7 @@ pip install tigrbl-atoms
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/) |
-| Repository path | [`pkgs/core/tigrbl_atoms`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_atoms) |
+| Repository path | [`pkgs/40_atoms/tigrbl_atoms`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/40_atoms/tigrbl_atoms) |
 | Python import root | `tigrbl_atoms` |
 | Console scripts | none declared |
 | Entry points | none declared |
@@ -466,7 +477,7 @@ Choose `tigrbl-atoms` when the quick-answer table matches your use case. Choose
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_atoms](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_atoms).
+- Repository: [pkgs/40_atoms/tigrbl_atoms](https://github.com/tigrbl/tigrbl/tree/master/pkgs/40_atoms/tigrbl_atoms).
 
 ## Package-local Boundary
 
@@ -477,7 +488,7 @@ This file is a package-local distribution entry point. This README is the packag
 - 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_atoms-0.4.5.dev4 → tigrbl_atoms-0.4.5.dev6}/README.md

@@ -5,7 +5,7 @@
 <a href="https://pypi.org/project/tigrbl-atoms/"><img src="https://img.shields.io/pypi/v/tigrbl-atoms?label=PyPI" alt="PyPI version for tigrbl-atoms"/></a>
 <a href="https://pypi.org/project/tigrbl-atoms/"><img src="https://static.pepy.tech/badge/tigrbl-atoms" alt="Downloads for tigrbl-atoms"/></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-atoms"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_atoms/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_atoms/README.md.svg?label=hits" alt="Repository hits for tigrbl-atoms README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/40_atoms/tigrbl_atoms/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/40_atoms/tigrbl_atoms/README.md.svg?label=hits" alt="Repository hits for tigrbl-atoms 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%2C%203.11%2C%203.12%2C%203.13%2C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-atoms"/></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-atoms"/></a>
@@ -29,12 +29,23 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 ## Where does tigrbl-atoms fit?
 
-`tigrbl-atoms` lives at `pkgs/core/tigrbl_atoms` and serves a focused layer in the split Tigrbl framework.
+`tigrbl-atoms` lives at `pkgs/40_atoms/tigrbl_atoms` and serves a focused layer in the split Tigrbl framework.
 
 ## How does tigrbl-atoms work?
 
 It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
 
+Inbound materialization belongs to `wire.validate_in`, which uses the core schema
+materializer and declared field types (or mapped storage types when no field type
+is declared). Member identifiers are selector inputs even when the primary key
+is not writable. Route selectors take precedence over payload identifiers and
+invalid selectors raise 422 before persistence. Persistence atoms consume the
+validated payload and path carriers, including bulk values; CRUD helpers do not
+repeat type coercion. Selector operations currently use the full atom pipeline
+because the compiled scalar input shortcut does not implement route alias and
+selector precedence validation. CRUD operations retain their existing flush-only
+transaction contract; the caller owns commit or rollback.
+
 
 ## Install
 
@@ -51,7 +62,7 @@ pip install tigrbl-atoms
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/) |
-| Repository path | [`pkgs/core/tigrbl_atoms`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_atoms) |
+| Repository path | [`pkgs/40_atoms/tigrbl_atoms`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/40_atoms/tigrbl_atoms) |
 | Python import root | `tigrbl_atoms` |
 | Console scripts | none declared |
 | Entry points | none declared |
@@ -218,7 +229,7 @@ Choose `tigrbl-atoms` when the quick-answer table matches your use case. Choose
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_atoms](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_atoms).
+- Repository: [pkgs/40_atoms/tigrbl_atoms](https://github.com/tigrbl/tigrbl/tree/master/pkgs/40_atoms/tigrbl_atoms).
 
 ## Package-local Boundary
 
@@ -229,7 +240,7 @@ This file is a package-local distribution entry point. This README is the packag
 - 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_atoms-0.4.5.dev4 → tigrbl_atoms-0.4.5.dev6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-atoms"
-version = "0.4.5.dev4"
+version = "0.4.5.dev6"
 description = "Runtime atom package for Tigrbl stages, phases, typed contexts, event anchors, protocol execution, and composable pipeline algebra."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -55,7 +55,7 @@ dependencies = [
     "tigrbl-ops-olap",
     "tigrbl-ops-realtime",
     "tigrbl-ops-webtransport",
-    "tigrbl-core",
+    "tigrbl-core>=0.4.5.dev6",
     "tigrbl-typing",
     "jinja2>=3.1",
     "sqlalchemy>=2.0",
@@ -67,10 +67,11 @@ 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_atoms"
+Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/40_atoms/tigrbl_atoms"
 Issues = "https://github.com/tigrbl/tigrbl/issues"
 
 [tool.uv.sources]
+"tigrbl-kernel" = { workspace = true }
 "tigrbl-ops-oltp" = { workspace = true }
 "tigrbl-ops-olap" = { workspace = true }
 "tigrbl-ops-realtime" = { workspace = true }
@@ -90,6 +91,7 @@ packages = [
 
 [dependency-groups]
 dev = [
+    "tigrbl-kernel",
     "pytest>=8.0",
     "pytest-asyncio>=0.24.0",
     "pytest-timeout>=2.3.1",

tigrbl_atoms-0.4.5.dev6/tigrbl_atoms/_opview_helpers.py

@@ -0,0 +1,377 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any
+
+from tigrbl_core.schema.builder.helpers import (
+    _spec_python_type,
+    _input_selector_entries,
+    _input_filter_entries,
+)
+
+_READ_ONLY_TARGETS = frozenset(
+    {
+        "read",
+        "list",
+        "count",
+        "exists",
+        "aggregate",
+        "group_by",
+        "subscribe",
+        "tail",
+        "download",
+    }
+)
+_NON_PERSISTING_TARGETS = frozenset(
+    {"delete", "clear", "bulk_delete", "close_stream", "close_session"}
+)
+_CREATE_LIKE_TARGETS = frozenset({"create", "bulk_create"})
+_UPDATE_LIKE_TARGETS = frozenset({"update", "merge", "bulk_update", "bulk_merge"})
+_REPLACE_LIKE_TARGETS = frozenset({"replace", "bulk_replace"})
+
+
+def _storage_requires_input(storage: Any, op: str) -> bool:
+    if storage is None or op == "update":
+        return False
+    if bool(getattr(storage, "primary_key", False)):
+        if op in {"replace", "delete"}:
+            return True
+        auto = getattr(storage, "autoincrement", False)
+        if auto not in (False, None) or getattr(storage, "identity", None) is not None:
+            return False
+    has_default = (
+        getattr(storage, "default", None) is not None
+        or getattr(storage, "server_default", None) is not None
+        or callable(getattr(storage, "default_factory", None))
+    )
+    return not bool(getattr(storage, "nullable", True)) and not has_default
+
+
+def _storage_has_server_default(spec: Any, storage: Any) -> bool:
+    return bool(
+        getattr(storage, "default", None) is not None
+        or getattr(storage, "server_default", None) is not None
+        or callable(getattr(storage, "default_factory", None))
+        or callable(getattr(spec, "default_factory", None))
+    )
+
+
+def _supports_stored_shape(op: str) -> bool:
+    lowered = str(op or "").lower()
+    return lowered not in _READ_ONLY_TARGETS and lowered not in _NON_PERSISTING_TARGETS
+
+
+def _is_input_enabled(io: Any, op: str) -> bool:
+    return op in set(getattr(io, "in_verbs", ()) or ())
+
+
+def _is_paired_enabled(io: Any, op: str) -> bool:
+    cfg = getattr(io, "_paired", None)
+    if cfg is None:
+        return False
+    return op in set(getattr(cfg, "verbs", ()) or ())
+
+
+def _include_in_stored_schema(spec: Any, io: Any, storage: Any, op: str) -> bool:
+    lowered = str(op or "").lower()
+    if storage is None or not _supports_stored_shape(lowered):
+        return False
+    if _is_input_enabled(io, op) or _is_paired_enabled(io, op):
+        return True
+    if lowered in _CREATE_LIKE_TARGETS or lowered in _UPDATE_LIKE_TARGETS:
+        return True
+    if lowered in _REPLACE_LIKE_TARGETS:
+        return True
+    return False
+
+
+def _stored_required(spec: Any, storage: Any, op: str, *, derived: bool) -> bool:
+    lowered = str(op or "").lower()
+    if lowered in _UPDATE_LIKE_TARGETS:
+        return False
+    if lowered in _READ_ONLY_TARGETS or lowered in _NON_PERSISTING_TARGETS:
+        return False
+    if derived:
+        return True
+    return not bool(
+        getattr(storage, "nullable", True)
+    ) and not _storage_has_server_default(
+        spec,
+        storage,
+    )
+
+
+def _ensure_temp(ctx: Any) -> dict[str, Any]:
+    tmp = getattr(ctx, "temp", None)
+    if not isinstance(tmp, dict):
+        tmp = {}
+        setattr(ctx, "temp", tmp)
+    return tmp
+
+
+def _ensure_ov(ctx: Any):
+    ov = getattr(ctx, "opview", None)
+    if ov is None:
+        raise RuntimeError("ctx_missing:opview")
+    return ov
+
+
+def _normalize_schema_from_specs(ctx: Any) -> None:
+    specs = getattr(ctx, "specs", None)
+    op = getattr(ctx, "op", None)
+    if not isinstance(specs, Mapping) or not isinstance(op, str) or not op:
+        raise RuntimeError("ctx_missing:opview")
+
+    in_fields: list[str] = []
+    out_fields: list[str] = []
+    stored_fields: list[str] = []
+    by_field_in: dict[str, dict[str, Any]] = {}
+    by_field_out: dict[str, dict[str, Any]] = {}
+    by_field_stored: dict[str, dict[str, Any]] = {}
+    required_from_client: list[str] = []
+
+    for field_name, spec in specs.items():
+        if not isinstance(field_name, str):
+            continue
+        io = getattr(spec, "io", None)
+        fs = getattr(spec, "field", None)
+        storage = getattr(spec, "storage", None)
+
+        in_verbs = set(getattr(io, "in_verbs", ()) or ())
+        out_verbs = set(getattr(io, "out_verbs", ()) or ())
+
+        if op in in_verbs:
+            in_fields.append(field_name)
+            in_meta: dict[str, Any] = {"in_enabled": True}
+            if storage is None:
+                in_meta["virtual"] = True
+            py_type = _spec_python_type(spec)
+            if py_type is not None and py_type is not Any:
+                in_meta["py_type"] = py_type
+            constraints = getattr(fs, "constraints", {}) or {}
+            if isinstance(constraints, Mapping):
+                max_length = constraints.get("max_length")
+                if isinstance(max_length, int) and max_length > 0:
+                    in_meta["max_length"] = max_length
+
+            default_factory = getattr(spec, "default_factory", None)
+            if callable(default_factory):
+                in_meta["default_factory"] = default_factory
+
+            alias_in = getattr(io, "alias_in", None)
+            if alias_in:
+                in_meta["alias_in"] = alias_in
+
+            header_in = getattr(io, "header_in", None)
+            if header_in:
+                in_meta["header_in"] = header_in
+                in_meta["header_required_in"] = bool(
+                    getattr(io, "header_required_in", False)
+                )
+
+            in_meta["required"] = bool(
+                (fs and op in getattr(fs, "required_in", ()))
+                or _storage_requires_input(storage, op)
+            )
+            in_meta["nullable"] = (
+                True if storage is None else bool(getattr(storage, "nullable", True))
+            )
+            in_meta["coerce"] = True
+            by_field_in[field_name] = in_meta
+
+        if op in out_verbs:
+            out_fields.append(field_name)
+            out_meta: dict[str, Any] = {}
+
+            alias_out = getattr(io, "alias_out", None)
+            if alias_out:
+                out_meta["alias_out"] = alias_out
+            if storage is None:
+                out_meta["virtual"] = True
+
+            py_type = getattr(getattr(fs, "py_type", None), "__name__", None)
+            if py_type:
+                out_meta["py_type"] = py_type
+            by_field_out[field_name] = out_meta
+
+        if _include_in_stored_schema(spec, io, storage, op):
+            stored_fields.append(field_name)
+            input_enabled = _is_input_enabled(io, op)
+            paired_enabled = _is_paired_enabled(io, op)
+            server_default = _storage_has_server_default(spec, storage)
+            py_type = getattr(fs, "py_type", None) if fs is not None else None
+            if py_type is not None and py_type is not Any:
+                resolved_py_type = py_type
+            else:
+                storage_type = getattr(storage, "type_", None)
+                resolved_py_type = (
+                    Any
+                    if storage_type is None
+                    else getattr(storage_type, "python_type", Any)
+                )
+            stored_meta: dict[str, Any] = {
+                "nullable": bool(getattr(storage, "nullable", True)),
+                "from_client": input_enabled,
+                "required_from_client": bool(
+                    input_enabled and _storage_requires_input(storage, op)
+                ),
+                "server_default": server_default,
+            }
+            if resolved_py_type is not Any:
+                stored_meta["py_type"] = resolved_py_type
+            constraints = getattr(fs, "constraints", {}) or {}
+            if isinstance(constraints, Mapping):
+                max_length = constraints.get("max_length")
+                if isinstance(max_length, int) and max_length > 0:
+                    stored_meta["max_length"] = max_length
+            derived = paired_enabled or callable(
+                getattr(getattr(storage, "transform", None), "to_stored", None)
+            )
+            stored_meta["derived"] = derived
+            stored_meta["required"] = _stored_required(
+                spec,
+                storage,
+                op,
+                derived=derived,
+            )
+            if stored_meta["required_from_client"]:
+                required_from_client.append(field_name)
+            by_field_stored[field_name] = stored_meta
+
+    target = str(getattr(ctx, "target", None) or op)
+    for name, meta in {
+        **_input_filter_entries(specs, target),
+        **_input_selector_entries(specs, target),
+    }.items():
+        if name not in by_field_in:
+            in_fields.append(name)
+            by_field_in[name] = meta
+        elif meta.get("selector"):
+            by_field_in[name] = {**meta, **by_field_in[name], "selector": True}
+
+    in_fields_sorted = tuple(sorted(in_fields))
+    out_fields_sorted = tuple(sorted(out_fields))
+    stored_fields_sorted = tuple(sorted(stored_fields))
+
+    setattr(
+        ctx,
+        "schema_in",
+        {
+            "fields": in_fields_sorted,
+            "by_field": {f: by_field_in.get(f, {}) for f in in_fields_sorted},
+            "required": tuple(
+                f for f in in_fields_sorted if by_field_in.get(f, {}).get("required")
+            ),
+        },
+    )
+    setattr(
+        ctx,
+        "schema_out",
+        {
+            "fields": out_fields_sorted,
+            "by_field": {f: by_field_out.get(f, {}) for f in out_fields_sorted},
+            "expose": out_fields_sorted,
+        },
+    )
+    setattr(
+        ctx,
+        "schema_stored",
+        {
+            "fields": stored_fields_sorted,
+            "by_field": {f: by_field_stored.get(f, {}) for f in stored_fields_sorted},
+            "required_from_client": tuple(sorted(required_from_client)),
+            "required": tuple(
+                f
+                for f in stored_fields_sorted
+                if by_field_stored.get(f, {}).get("required")
+            ),
+        },
+    )
+
+
+def _ensure_schema_in(ctx: Any) -> Mapping[str, Any]:
+    temp = _ensure_temp(ctx)
+    cached = temp.get("schema_in")
+    if isinstance(cached, Mapping):
+        return cached
+
+    schema_in = getattr(ctx, "schema_in", None)
+    if isinstance(schema_in, Mapping):
+        temp["schema_in"] = schema_in
+        return schema_in
+
+    try:
+        ov = _ensure_ov(ctx)
+        bf = ov.schema_in.by_field
+        req = tuple(n for n, e in bf.items() if e.get("required"))
+        temp["schema_in"] = {
+            "fields": ov.schema_in.fields,
+            "by_field": bf,
+            "required": req,
+        }
+    except RuntimeError as exc:
+        if str(exc) != "ctx_missing:opview":
+            raise
+        _normalize_schema_from_specs(ctx)
+        temp["schema_in"] = getattr(ctx, "schema_in")
+    return temp["schema_in"]
+
+
+def _ensure_schema_out(ctx: Any) -> Mapping[str, Any]:
+    temp = _ensure_temp(ctx)
+    cached = temp.get("schema_out")
+    if isinstance(cached, Mapping):
+        return cached
+
+    schema_out = getattr(ctx, "schema_out", None)
+    if isinstance(schema_out, Mapping):
+        temp["schema_out"] = schema_out
+        return schema_out
+
+    try:
+        ov = _ensure_ov(ctx)
+        temp["schema_out"] = {
+            "fields": ov.schema_out.fields,
+            "by_field": ov.schema_out.by_field,
+            "expose": ov.schema_out.expose,
+        }
+    except RuntimeError as exc:
+        if str(exc) != "ctx_missing:opview":
+            raise
+        _normalize_schema_from_specs(ctx)
+        temp["schema_out"] = getattr(ctx, "schema_out")
+    return temp["schema_out"]
+
+
+def _ensure_schema_stored(ctx: Any) -> Mapping[str, Any]:
+    temp = _ensure_temp(ctx)
+    cached = temp.get("schema_stored")
+    if isinstance(cached, Mapping):
+        return cached
+
+    schema_stored = getattr(ctx, "schema_stored", None)
+    if isinstance(schema_stored, Mapping):
+        temp["schema_stored"] = schema_stored
+        return schema_stored
+
+    try:
+        ov = _ensure_ov(ctx)
+        stored = getattr(ov, "schema_stored", None)
+        if stored is None:
+            raise RuntimeError("ctx_missing:opview")
+        temp["schema_stored"] = {
+            "fields": stored.fields,
+            "by_field": stored.by_field,
+            "required_from_client": getattr(stored, "required_from_client", ()),
+            "required": tuple(
+                field
+                for field, meta in getattr(stored, "by_field", {}).items()
+                if meta.get("required")
+            ),
+        }
+    except RuntimeError as exc:
+        if str(exc) != "ctx_missing:opview":
+            raise
+        _normalize_schema_from_specs(ctx)
+        temp["schema_stored"] = getattr(ctx, "schema_stored")
+    return temp["schema_stored"]

{tigrbl_atoms-0.4.5.dev4 → tigrbl_atoms-0.4.5.dev6}/tigrbl_atoms/atoms/framing/__init__.py

@@ -20,22 +20,34 @@ from .codec import (
     get_frame_codec,
     supported_frame_codecs,
 )
+from . import websocket_jsonrpc as websocket_jsonrpc
+from .webtransport_records import (
+    DEFAULT_MAX_RECORD_BYTES,
+    WebTransportRecordDecoder,
+    decode_jsonrpc_records,
+    encode_jsonrpc_record,
+)
 
 __all__ = [
     "DEFAULT_MAX_PAYLOAD_SIZE",
+    "DEFAULT_MAX_RECORD_BYTES",
     "FRAME_CODECS",
     "HEADER_SIZE",
     "RESERVED_FLAG_MASK",
     "SUPPORTED_VERSION",
     "FrameCodec",
     "FrameStreamDecoder",
+    "WebTransportRecordDecoder",
     "decode_app_frame",
     "decode_app_frames",
     "decode_frame",
+    "decode_jsonrpc_records",
     "decode_webtransport_inner_frame",
     "encode_app_frame",
     "encode_frame",
+    "encode_jsonrpc_record",
     "encode_webtransport_inner_frame",
     "get_frame_codec",
     "supported_frame_codecs",
+    "websocket_jsonrpc",
 ]

tigrbl_atoms-0.4.5.dev6/tigrbl_atoms/atoms/framing/websocket_jsonrpc.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .codec import decode_frame, encode_frame
+
+
+def _ctx_get(ctx: Any, key: str, default: Any = None) -> Any:
+    getter = getattr(ctx, "get", None)
+    if callable(getter):
+        try:
+            return getter(key, default)
+        except Exception:
+            pass
+    return getattr(ctx, key, default)
+
+
+def _ctx_set(ctx: Any, key: str, value: Any) -> None:
+    try:
+        ctx[key] = value
+        return
+    except Exception:
+        pass
+    setattr(ctx, key, value)
+
+
+def _temp(ctx: Any) -> dict[str, Any]:
+    temp = _ctx_get(ctx, "temp")
+    if not isinstance(temp, dict):
+        temp = {}
+        _ctx_set(ctx, "temp", temp)
+    return temp
+
+
+def _ws_state(ctx: Any) -> dict[str, Any]:
+    return _temp(ctx).setdefault("websocket", {})
+
+
+async def decode(ctx: Any) -> Any:
+    state = _ws_state(ctx)
+    payload = decode_frame("websocket.jsonrpc", state.get("message"))
+    state["decoded"] = payload
+    return payload
+
+
+async def encode(ctx: Any) -> Any:
+    state = _ws_state(ctx)
+    outbound = encode_frame("websocket.jsonrpc", state.get("response"))
+    state["outbound"] = outbound
+    return outbound
+
+
+setattr(decode, "__tigrbl_atom_name__", "framing.decode")
+setattr(decode, "__tigrbl_label", "atom:framing.decode")
+setattr(encode, "__tigrbl_atom_name__", "framing.encode")
+setattr(encode, "__tigrbl_label", "atom:framing.encode")
+
+
+__all__ = ["decode", "encode"]