@spine-event-engine/server 2.0.0-snapshot.24 → 2.0.0-snapshot.26

package/dist/stand/read-side-filter-engine.js

@@ -0,0 +1,356 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { clone, fromBinary, toBinary, } from "@bufbuild/protobuf";
+import { AnySchema } from "@bufbuild/protobuf/wkt";
+import { Code, ConnectError } from "@connectrpc/connect";
+import { ReadSideMessages } from "./read-side-message.js";
+/**
+ * Applies one ordered filter scope to detached domain message trees.
+ */
+export class ReadSideFilterEngine {
+    #registry;
+    #filters = new Map();
+    #nested;
+    /**
+     * Resolves each policy through the ordinary registry's exact registered URL.
+     *
+     * @param filters Policies in registration order.
+     * @param registry Application's existing Proto type registry.
+     */
+    constructor(filters, registry) {
+        this.#registry = registry;
+        this.#nested = filters.some((filter) => filter.nested);
+        for (const filter of filters) {
+            const metadata = registry.findBySchema(filter.schema);
+            if (metadata === undefined)
+                throw new TypeError(`Read-side filter schema ${filter.schema.typeName} is not registered.`);
+            const selected = this.#filters.get(metadata.typeUrl) ?? [];
+            selected.push(filter);
+            this.#filters.set(metadata.typeUrl, selected);
+        }
+    }
+    /**
+     * Returns an isolated filtered view without mutating stored or caller data.
+     *
+     * @typeParam Schema Generated root domain message schema.
+     * @param schema Declared root domain message schema.
+     * @param message Domain value returned by the read side.
+     * @param context Actual read operation and trusted invocation facts.
+     * @returns Filtered same-type message, or null when the root was removed.
+     */
+    async apply(schema, message, context) {
+        if (this.#registry.findBySchema(schema) === undefined)
+            throw new TypeError(`Read-side root schema ${schema.typeName} is not registered.`);
+        let result = null;
+        const stable = this.#context(context);
+        const pending = [
+            {
+                kind: "visit",
+                schema,
+                value: ReadSideMessages.copy(message),
+                context: stable,
+                root: true,
+                put: (value) => {
+                    result = value;
+                },
+            },
+        ];
+        while (pending.length > 0) {
+            this.#check(stable.signal);
+            const work = pending.pop();
+            if (work === undefined)
+                break;
+            if (work.kind === "finish")
+                work.commit();
+            else
+                await this.#visit(work, pending);
+        }
+        return result;
+    }
+    /**
+     * Transforms the domain payload of a retained Event without changing its type URL.
+     *
+     * @param packed Original packed domain message.
+     * @param context Actual history call and current trusted facts.
+     * @returns Repacked visible payload, or null when policy removes it.
+     */
+    async applyPacked(packed, context) {
+        if (!this.#nested && !this.#filters.has(packed.typeUrl))
+            return clone(AnySchema, packed);
+        const metadata = this.#registry.findByTypeUrl(packed.typeUrl);
+        if (metadata === undefined)
+            throw new TypeError(`Read-side payload ${packed.typeUrl} is not registered.`);
+        const original = fromBinary(metadata.schema, packed.value);
+        const visible = await this.apply(metadata.schema, original, context);
+        if (visible === null)
+            return null;
+        const result = clone(AnySchema, packed);
+        result.value = toBinary(metadata.schema, visible);
+        return result;
+    }
+    /**
+     * Runs this occurrence's policies before scheduling its surviving children.
+     *
+     * @param work Current domain occurrence.
+     * @param pending Iterative traversal stack.
+     */
+    async #visit(work, pending) {
+        let value = work.value;
+        ReadSideMessages.checkShallow(work.schema, value);
+        const url = this.#registry.findByFullName(work.schema.typeName)?.typeUrl;
+        for (const filter of url === undefined ? [] : (this.#filters.get(url) ?? [])) {
+            if (!work.root && !filter.nested)
+                continue;
+            const candidate = ReadSideMessages.copy(value);
+            const next = await filter.filter(candidate, this.#context(work.context));
+            this.#check(work.context.signal);
+            if (next === null) {
+                value = null;
+                break;
+            }
+            value = ReadSideMessages.copy(next);
+            ReadSideMessages.checkShallow(work.schema, value);
+        }
+        work.put(value);
+        if (value !== null)
+            this.#children(work.schema, value, work.context, work.put, pending);
+    }
+    /**
+     * Schedules declared message children in field order and deterministic key order.
+     *
+     * @param schema Parent schema.
+     * @param value Surviving parent message.
+     * @param context Parent invocation context.
+     * @param put Parent update for a removed Any payload.
+     * @param pending Iterative traversal stack.
+     */
+    #children(schema, value, context, put, pending) {
+        const children = [];
+        const commits = [];
+        let baseline;
+        /**
+         * Captures a stable parent only when a registered nested child policy needs it.
+         */
+        const parentFor = (childSchema) => {
+            const url = this.#registry.findByFullName(childSchema.typeName)?.typeUrl;
+            if (url === undefined || !this.#filters.get(url)?.some((filter) => filter.nested))
+                return undefined;
+            baseline ??= ReadSideMessages.copy(value);
+            return baseline;
+        };
+        if (schema.typeName === AnySchema.typeName && this.#nested)
+            this.#packedChild(value, parentFor, context, put, children, commits);
+        else
+            for (const field of schema.fields) {
+                this.#fieldChildren(field, value, parentFor, context, children, commits);
+            }
+        pending.push(...commits);
+        for (let index = children.length - 1; index >= 0; index--) {
+            const child = children[index];
+            if (child !== undefined)
+                pending.push(child);
+        }
+    }
+    /**
+     * Adds the selected message field, list, or map without visiting scalar data.
+     *
+     * @param field Declared field.
+     * @param value Current mutable parent.
+     * @param parentFor Captures a parent baseline only for a matching child.
+     * @param context Current invocation facts.
+     * @param children Ordered child work.
+     * @param commits Container updates after child traversal.
+     */
+    #fieldChildren(field, value, parentFor, context, children, commits) {
+        if (field.fieldKind === "message")
+            this.#singular(field, value, parentFor, context, children);
+        else if (field.fieldKind === "list" && field.listKind === "message")
+            this.#list(field, value, parentFor, context, children, commits);
+        else if (field.fieldKind === "map" && field.mapKind === "message")
+            this.#map(field, value, parentFor, context, children, commits);
+    }
+    /**
+     * Visits an active singular or oneof message and clears its selection on null.
+     *
+     * @param field Declared message field.
+     * @param value Mutable containing message.
+     * @param parentFor Captures a stable parent before siblings are visited.
+     * @param context Invocation context.
+     * @param children Ordered work.
+     */
+    #singular(field, value, parentFor, context, children) {
+        const record = value;
+        const oneof = field.oneof?.localName;
+        const selected = oneof === undefined
+            ? undefined
+            : record[oneof];
+        if (selected !== undefined && selected.case !== field.localName)
+            return;
+        const child = oneof === undefined ? record[field.localName] : selected?.value;
+        if (child === undefined)
+            return;
+        this.#add(field.message, child, parentFor, { name: field.name }, context, (next) => {
+            if (oneof !== undefined)
+                record[oneof] =
+                    next === null ? { case: undefined } : { case: field.localName, value: next };
+            else if (next === null)
+                record[field.localName] = undefined;
+            else
+                record[field.localName] = next;
+        }, children);
+    }
+    /**
+     * Rebuilds a repeated message field after each original element is visited.
+     *
+     * @param field Declared repeated field.
+     * @param value Mutable containing message.
+     * @param parentFor Captures a stable parent before siblings are visited.
+     * @param context Invocation context.
+     * @param children Ordered work.
+     * @param commits Deferred stable list update.
+     */
+    #list(field, value, parentFor, context, children, commits) {
+        const record = value;
+        const list = record[field.localName];
+        if (!Array.isArray(list))
+            throw new TypeError(`Invalid repeated field ${field.name}.`);
+        const slots = list.slice();
+        slots.forEach((child, index) => {
+            this.#add(field.message, child, parentFor, { name: field.name, index }, context, (next) => {
+                slots[index] = next;
+            }, children);
+        });
+        commits.push({
+            kind: "finish",
+            commit: () => {
+                record[field.localName] = slots.filter((item) => item !== null);
+            },
+        });
+    }
+    /**
+     * Visits message map entries in sorted-key order and removes only null values.
+     *
+     * @param field Declared map field.
+     * @param value Mutable containing message.
+     * @param parentFor Captures a stable parent before siblings are visited.
+     * @param context Invocation context.
+     * @param children Ordered work.
+     * @param commits Deferred map update.
+     */
+    #map(field, value, parentFor, context, children, commits) {
+        const record = value;
+        const map = record[field.localName];
+        if (map === null || typeof map !== "object" || Array.isArray(map))
+            throw new TypeError(`Invalid message map ${field.name}.`);
+        const slots = new Map(Object.entries(map));
+        for (const key of [...slots.keys()].sort())
+            this.#add(field.message, slots.get(key), parentFor, { name: field.name, key }, context, (next) => {
+                if (next === null)
+                    slots.delete(key);
+                else
+                    slots.set(key, next);
+            }, children);
+        commits.push({
+            kind: "finish",
+            commit: () => {
+                record[field.localName] = Object.fromEntries(slots);
+            },
+        });
+    }
+    /**
+     * Decodes a registered Any for nested inspection and repacks its original URL.
+     *
+     * @param packed Mutable Any wrapper.
+     * @param parentFor Captures the Any wrapper before payload filtering.
+     * @param context Invocation context.
+     * @param put Containing field update when the payload is removed.
+     * @param children Ordered payload work.
+     * @param commits Deferred original-URL repack.
+     */
+    #packedChild(packed, parentFor, context, put, children, commits) {
+        const metadata = this.#registry.findByTypeUrl(packed.typeUrl);
+        if (metadata === undefined)
+            throw new TypeError(`Unregistered nested Any URL ${packed.typeUrl}.`);
+        const payload = fromBinary(metadata.schema, packed.value);
+        let filtered = payload;
+        this.#add(metadata.schema, payload, parentFor, { name: "value" }, context, (next) => {
+            filtered = next;
+        }, children);
+        commits.push({
+            kind: "finish",
+            commit: () => {
+                if (filtered === null)
+                    put(null);
+                else
+                    packed.value = toBinary(metadata.schema, filtered);
+            },
+        });
+    }
+    /**
+     * Adds one typed message child and its detached parent metadata.
+     *
+     * @param schema Declared child schema.
+     * @param value Child field value.
+     * @param parentFor Captures a stable parent only for matching nested filters.
+     * @param field Containing field and position.
+     * @param context Invocation context.
+     * @param put Parent or container update.
+     * @param children Ordered work.
+     */
+    #add(schema, value, parentFor, field, context, put, children) {
+        if (value === null || typeof value !== "object" || !("$typeName" in value))
+            throw new TypeError(`Invalid nested message in ${field.name}.`);
+        const { parent: previousParent, field: previousField, ...facts } = context;
+        void previousParent;
+        void previousField;
+        const parent = parentFor(schema);
+        children.push({
+            kind: "visit",
+            schema,
+            value: value,
+            context: Object.freeze({
+                ...facts,
+                ...(parent === undefined ? {} : { parent }),
+                field: Object.freeze(field),
+            }),
+            root: false,
+            put,
+        });
+    }
+    /**
+     * Detaches and freezes caller-provided identity and operation facts.
+     *
+     * @param source Caller read context.
+     * @returns Stable per-invocation context.
+     */
+    #context(source) {
+        const { signal, producingContext, ...facts } = source;
+        const copied = ReadSideMessages.freeze(ReadSideMessages.copy(facts));
+        return Object.freeze({
+            ...copied,
+            ...(signal === undefined ? {} : { signal }),
+            ...(producingContext === undefined ? {} : { producingContext }),
+        });
+    }
+    /**
+     * Stops work promptly when the current read has been canceled.
+     *
+     * @param signal Current cancellation signal.
+     */
+    #check(signal) {
+        if (signal?.aborted)
+            throw new ConnectError("Read canceled.", Code.Canceled);
+    }
+}
+//# sourceMappingURL=read-side-filter-engine.js.map

package/dist/stand/read-side-filter-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-side-filter-engine.js","sourceRoot":"","sources":["../../src/stand/read-side-filter-engine.ts"],"names":[],"mappings":"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"}

package/dist/stand/read-side-filter.d.ts

@@ -0,0 +1,247 @@
+import type { Message, MessageShape } from "@bufbuild/protobuf";
+import type { GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { ActorContext, TenantId } from "@spine-event-engine/proto";
+import type { AppQuery, Query, Subscription, Topic } from "@spine-event-engine/proto/client";
+import type { TrustedReaderContext } from "@spine-event-engine/core/spi/trusted-reader";
+import type { NormalizedQueryPlan, RecordQuery } from "@spine-event-engine/storage";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { HistoryRead } from "@spine-event-engine/ai";
+import type { AgentHistoryView } from "@spine-event-engine/storage/provider";
+import type { BoundedContext } from "../context/bounded-context.js";
+/**
+ * Exposes byte contents without mutation methods to read-side policies.
+ */
+type ReadonlyBytes = Readonly<Pick<Uint8Array, "length" | "at" | "slice"> & Record<number, number>>;
+/**
+ * Exposes nested Proto data for inspection without writable fields or byte mutators.
+ *
+ * @typeParam Value Proto message or nested field value.
+ */
+type ReadonlyMessage<Value> = Value extends Uint8Array ? ReadonlyBytes : Value extends readonly (infer Item)[] ? readonly ReadonlyMessage<Item>[] : Value extends object ? {
+    readonly [Key in keyof Value]: ReadonlyMessage<Value[Key]>;
+} : Value;
+/**
+ * Identifies the real read operation without inventing a transport request.
+ */
+export type ReadSideOperation = Readonly<{
+    /**
+     * QueryService read.
+     */
+    kind: "query";
+    /**
+     * Submitted entity query.
+     */
+    query: ReadonlyMessage<Query>;
+}> | Readonly<{
+    /**
+     * Application query handler read.
+     */
+    kind: "app-query";
+    /**
+     * Submitted application query.
+     */
+    appQuery: ReadonlyMessage<AppQuery>;
+}> | Readonly<{
+    /**
+     * Subscription delivery read.
+     */
+    kind: "subscription";
+    /**
+     * Active subscription.
+     */
+    subscription: ReadonlyMessage<Subscription>;
+    /**
+     * Topic that produced this occurrence.
+     */
+    topic: ReadonlyMessage<Topic>;
+}> | Readonly<{
+    /**
+     * Direct Stand read with its actual requested state and identifier.
+     */
+    kind: "direct";
+    /**
+     * Requested state schema URL and typed Entity ID.
+     */
+    read: Readonly<{
+        /**
+         * Requested state schema URL.
+         */
+        typeUrl: string;
+        /**
+         * Typed Entity ID supplied to Stand.
+         */
+        id: unknown;
+    }>;
+}> | Readonly<{
+    /**
+     * Direct in-process Stand subscription delivery.
+     */
+    kind: "direct";
+    /**
+     * Registered state type selected when the observer subscribed.
+     */
+    subscription: Readonly<{
+        /**
+         * State schema URL registered for this direct subscription.
+         */
+        typeUrl: string;
+    }>;
+}> | Readonly<{
+    /**
+     * Direct Stand query with its caller-supplied record query.
+     */
+    kind: "direct";
+    /**
+     * Detached caller-supplied record query.
+     */
+    query: Readonly<RecordQuery<unknown>>;
+}> | Readonly<{
+    /**
+     * Direct Stand query with its normalized storage plan.
+     */
+    kind: "direct";
+    /**
+     * Detached normalized storage plan.
+     */
+    plan: Readonly<NormalizedQueryPlan<unknown>>;
+}> | Readonly<{
+    /**
+     * Retained history read with its actual ID, page, or time input.
+     */
+    kind: "history";
+    /**
+     * Captured retained-history request for the actual source.
+     */
+    history: Readonly<{
+        /**
+         * State-at read of an Entity's retained snapshots.
+         */
+        source: "entity-state-at";
+        /**
+         * Entity ID used for the retained read.
+         */
+        entityId: unknown;
+        /**
+         * Latest permitted state timestamp.
+         */
+        time: ReadonlyMessage<Timestamp>;
+    }> | Readonly<{
+        /**
+         * State or Event retained-history category.
+         */
+        source: "entity-states" | "entity-events";
+        /**
+         * Entity ID used for the retained read.
+         */
+        entityId: unknown;
+        /**
+         * Requested number of records.
+         */
+        depth: number;
+    }> | Readonly<{
+        /**
+         * Indexed Agent history category.
+         */
+        source: "agent";
+        /**
+         * Agent ID used for the retained read.
+         */
+        entityId: unknown;
+        /**
+         * Selected Agent history view.
+         */
+        view: ReadonlyMessage<AgentHistoryView>;
+        /**
+         * Captured page size and continuation.
+         */
+        request: ReadonlyMessage<HistoryRead>;
+    }>;
+}>;
+/**
+ * Identifies the field and optional container position of a nested occurrence.
+ */
+export interface ReadSideField {
+    /**
+     * Protobuf field name containing this occurrence.
+     */
+    readonly name: string;
+    /**
+     * Original repeated-field position, if this is a list element.
+     */
+    readonly index?: number;
+    /**
+     * Map key, if this is a map value.
+     */
+    readonly key?: string;
+}
+/**
+ * Invocation-local facts supplied to one read-side filter callback.
+ */
+export interface ReadSideContext extends TrustedReaderContext {
+    /**
+     * Actual operation that returned the domain message.
+     */
+    readonly operation: ReadSideOperation;
+    /**
+     * Effective actor and tenant metadata; it is not authentication proof.
+     */
+    readonly actorContext?: ReadonlyMessage<ActorContext>;
+    /**
+     * Effective tenant after admission, when the read is tenant-scoped.
+     */
+    readonly effectiveTenant?: ReadonlyMessage<TenantId>;
+    /**
+     * Enclosing application query when a handler reads a child Entity.
+     */
+    readonly enclosingAppQuery?: ReadonlyMessage<AppQuery>;
+    /**
+     * Bounded Context that produced this message, when applicable.
+     */
+    readonly producingContext?: BoundedContext;
+    /**
+     * Cancellation of the current read or subscription delivery.
+     */
+    readonly signal?: AbortSignal;
+    /**
+     * Detached read-only containing message for a nested occurrence.
+     */
+    readonly parent?: ReadonlyMessage<Message>;
+    /**
+     * Field containing this nested occurrence.
+     */
+    readonly field?: ReadSideField;
+}
+/**
+ * Typed application policy for one registered Proto message schema.
+ *
+ * @typeParam Schema Generated schema for the domain message being filtered.
+ */
+export declare abstract class ReadSideFilter<Schema extends GenMessage<Message>> {
+    /**
+     * Generated schema used for exact registered type-URL matching.
+     */
+    readonly schema: Schema;
+    /**
+     * Whether this policy also examines occurrences below the returned root.
+     */
+    readonly nested: boolean;
+    /**
+     * Binds the message type and optional nested occurrence matching.
+     *
+     * @param schema Generated schema of values passed to filter().
+     * @param options Enables nested matching when requested.
+     */
+    protected constructor(schema: Schema, options?: Readonly<{
+        nested?: boolean;
+    }>);
+    /**
+     * Updates, replaces, or removes a detached domain message.
+     *
+     * @param message Mutable detached message of the declared schema.
+     * @param context Trusted invocation facts and optional containing snapshot.
+     * @returns Same-type message or null to remove this occurrence.
+     */
+    abstract filter(message: MessageShape<Schema>, context: ReadSideContext): MessageShape<Schema> | null | Promise<MessageShape<Schema> | null>;
+}
+export {};
+//# sourceMappingURL=read-side-filter.d.ts.map

package/dist/stand/read-side-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-side-filter.d.ts","sourceRoot":"","sources":["../../src/stand/read-side-filter.ts"],"names":[],"mappings":"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"}

package/dist/stand/read-side-filter.js

@@ -0,0 +1,39 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+/**
+ * Typed application policy for one registered Proto message schema.
+ *
+ * @typeParam Schema Generated schema for the domain message being filtered.
+ */
+export class ReadSideFilter {
+    /**
+     * Generated schema used for exact registered type-URL matching.
+     */
+    schema;
+    /**
+     * Whether this policy also examines occurrences below the returned root.
+     */
+    nested;
+    /**
+     * Binds the message type and optional nested occurrence matching.
+     *
+     * @param schema Generated schema of values passed to filter().
+     * @param options Enables nested matching when requested.
+     */
+    constructor(schema, options = {}) {
+        this.schema = schema;
+        this.nested = options.nested === true;
+    }
+}
+//# sourceMappingURL=read-side-filter.js.map

package/dist/stand/read-side-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-side-filter.js","sourceRoot":"","sources":["../../src/stand/read-side-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsQH;;;;GAIG;AACH,MAAM,OAAgB,cAAc;IAClC;;OAEG;IACM,MAAM,CAAS;IAExB;;OAEG;IACM,MAAM,CAAU;IAEzB;;;;;OAKG;IACH,YAAsB,MAAc,EAAE,UAA0C,EAAE;QAChF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC;IACxC,CAAC;CAaF"}