@spine-event-engine/server 2.0.0-snapshot.25 → 2.0.0-snapshot.28

package/dist/stand/subscription-read-filters.js

@@ -0,0 +1,91 @@
+/*
+ * 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 } from "@bufbuild/protobuf";
+import { SubscriptionUpdateSchema, } from "@spine-event-engine/proto/client";
+/**
+ * Applies one read-policy scope to data in an already matched subscription update.
+ */
+class SubscriptionReadFilterScope {
+    /**
+     * Processes only domain data, retaining acknowledgements and existing removals.
+     *
+     * @param update Matched source update with original identity and envelope fields.
+     * @param filters Installed BC or Server read-policy scope.
+     * @param facts Actual subscription operation and trusted activation facts.
+     * @returns Detached surviving data or control, or null for an empty data batch.
+     */
+    async apply(update, filters, facts) {
+        const visible = clone(SubscriptionUpdateSchema, update);
+        if (filters === undefined)
+            return visible;
+        if (visible.update.case === "entityUpdates")
+            return this.#states(visible, filters, facts);
+        if (visible.update.case === "eventUpdates")
+            return this.#events(visible, filters, facts);
+        return visible;
+    }
+    /**
+     * Replaces Entity states or emits removal using their original packed IDs.
+     *
+     * @param update Detached Entity data batch.
+     * @param filters Scope selected for this delivery boundary.
+     * @param facts Current reader and Topic facts.
+     * @returns Entity update with filtered states or removal controls.
+     */
+    async #states(update, filters, facts) {
+        if (update.update.case !== "entityUpdates")
+            return update;
+        for (const item of update.update.value.update) {
+            if (item.kind.case !== "state")
+                continue;
+            const state = await filters.applyPacked(item.kind.value, facts);
+            item.kind =
+                state === null
+                    ? { case: "noLongerMatching", value: true }
+                    : { case: "state", value: state };
+        }
+        return update;
+    }
+    /**
+     * Replaces visible domain payloads inside their original Event envelopes.
+     *
+     * @param update Detached Event data batch.
+     * @param filters Scope selected for this delivery boundary.
+     * @param facts Current reader and Topic facts.
+     * @returns Event update or null when every Event was removed.
+     */
+    async #events(update, filters, facts) {
+        if (update.update.case !== "eventUpdates")
+            return update;
+        const surviving = [];
+        for (const event of update.update.value.event) {
+            if (event.message === undefined)
+                throw new TypeError("Subscription Event payload is missing.");
+            const payload = await filters.applyPacked(event.message, facts);
+            if (payload !== null) {
+                event.message = payload;
+                surviving.push(event);
+            }
+        }
+        if (surviving.length === 0)
+            return null;
+        update.update.value.event = surviving;
+        return update;
+    }
+}
+/**
+ * Reuses one policy traversal without exposing an additional constructor.
+ */
+export const SubscriptionReadFilters = new SubscriptionReadFilterScope();
+//# sourceMappingURL=subscription-read-filters.js.map

package/dist/stand/subscription-read-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-read-filters.js","sourceRoot":"","sources":["../../src/stand/subscription-read-filters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EACL,wBAAwB,GAEzB,MAAM,kCAAkC,CAAC;AAsB1C;;GAEG;AACH,MAAM,2BAA2B;IAC/B;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CACT,MAA0B,EAC1B,OAAyC,EACzC,KAAsB;QAEtB,MAAM,OAAO,GAAG,KAAK,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC;QAC1C,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,eAAe;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1F,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACzF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CACX,MAA0B,EAC1B,OAA6B,EAC7B,KAAsB;QAEtB,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,eAAe;YAAE,OAAO,MAAM,CAAC;QAC1D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;gBAAE,SAAS;YACzC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAChE,IAAI,CAAC,IAAI;gBACP,KAAK,KAAK,IAAI;oBACZ,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE;oBAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CACX,MAA0B,EAC1B,OAA6B,EAC7B,KAAsB;QAEtB,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc;YAAE,OAAO,MAAM,CAAC;QACzD,MAAM,SAAS,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAC9C,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;gBAC7B,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAChE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;gBACxB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAClC,IAAI,2BAA2B,EAAE,CAAC"}

package/dist/stand/subscription-reader-binding.d.ts

@@ -0,0 +1,20 @@
+import type { ReaderIdentity } from "@spine-event-engine/core/spi/trusted-reader";
+import { type SubscriptionReaderBinding } from "@spine-event-engine/proto/client";
+/**
+ * Converts stable verified reader IDs to the maintained subscription record field.
+ */
+export declare const SubscriptionReaderBindings: Readonly<{
+    /**
+     * Decodes a persisted binding without treating an absent legacy field as anonymous.
+     *
+     * @param binding Stored reader field, or undefined for a legacy record.
+     * @returns Stable reader identity, or undefined when no binding was stored.
+     */ read(binding: SubscriptionReaderBinding | undefined): ReaderIdentity | undefined;
+    /**
+     * Encodes the stable reader identity in the maintained record field.
+     *
+     * @param reader Verified reader identity, or undefined for a legacy record.
+     * @returns Binding field when a stable identity is present.
+     */ write(reader: ReaderIdentity | undefined): SubscriptionReaderBinding | undefined;
+}>;
+//# sourceMappingURL=subscription-reader-binding.d.ts.map

package/dist/stand/subscription-reader-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-reader-binding.d.ts","sourceRoot":"","sources":["../../src/stand/subscription-reader-binding.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC;IAChD;;;;;OAKG,CAAC,IAAI,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC;IAErF;;;;;OAKG,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,yBAAyB,GAAG,SAAS,CAAC;CACtF,CAgCC,CAAC"}

package/dist/stand/subscription-reader-binding.js

@@ -0,0 +1,56 @@
+/*
+ * 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 { create } from "@bufbuild/protobuf";
+import { EmptySchema } from "@bufbuild/protobuf/wkt";
+import { SubscriptionReaderBindingSchema, } from "@spine-event-engine/proto/client";
+/**
+ * Converts stable verified reader IDs to the maintained subscription record field.
+ */
+export const SubscriptionReaderBindings = Object.freeze({
+    /**
+     * Reads one bound identity while leaving older records explicitly unbound.
+     *
+     * @param binding Stored reader field, possibly absent on a legacy record.
+     * @returns Stable identity or undefined only when the field is absent.
+     */
+    read(binding) {
+        if (binding === undefined)
+            return undefined;
+        if (binding.identity.case === "principalId" && binding.identity.value.trim())
+            return Object.freeze({ kind: "principal", id: binding.identity.value });
+        if (binding.identity.case === "anonymous")
+            return Object.freeze({ kind: "anonymous" });
+        throw new Error("Subscription reader binding is invalid.");
+    },
+    /**
+     * Writes one stable identity without storing authority facts or credentials.
+     *
+     * @param reader Verified reader identity, or undefined for an old unbound record.
+     * @returns Maintained Proto binding field when present.
+     */
+    write(reader) {
+        if (reader === undefined)
+            return undefined;
+        if (reader.kind === "anonymous")
+            return create(SubscriptionReaderBindingSchema, {
+                identity: { case: "anonymous", value: create(EmptySchema) },
+            });
+        if (!reader.id.trim())
+            throw new Error("Subscription reader principal ID is invalid.");
+        return create(SubscriptionReaderBindingSchema, {
+            identity: { case: "principalId", value: reader.id },
+        });
+    },
+});
+//# sourceMappingURL=subscription-reader-binding.js.map

package/dist/stand/subscription-reader-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-reader-binding.js","sourceRoot":"","sources":["../../src/stand/subscription-reader-binding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EACL,+BAA+B,GAEhC,MAAM,kCAAkC,CAAC;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAclC,MAAM,CAAC,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,OAA8C;QACjD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5C,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE;YAC1E,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1E,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAkC;QACtC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;YAC7B,OAAO,MAAM,CAAC,+BAA+B,EAAE;gBAC7C,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE;aAC5D,CAAC,CAAC;QACL,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACvF,OAAO,MAAM,CAAC,+BAA+B,EAAE;YAC7C,QAAQ,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE;SACpD,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/stand/subscription-records.d.ts

@@ -1,12 +1,39 @@
 import { SubscriptionRecordSchema, type SubscriptionRecord } from "@spine-event-engine/proto/client";
 import type { StandSubscriptionEntry } from "./subscription-registry.js";
+import type { ReaderIdentity } from "@spine-event-engine/core/spi/trusted-reader";
 /**
  * Encodes and validates the approved durable subscription record.
  */
 export declare const StandSubscriptionRecords: {
     readonly schema: typeof SubscriptionRecordSchema;
-    read(record: SubscriptionRecord, expectedId?: string): StandSubscriptionEntry;
-    write(entry: StandSubscriptionEntry): SubscriptionRecord;
-    decode(bytes: Uint8Array, expectedId?: string): StandSubscriptionEntry;
+    /**
+     * Validates and decodes a retained Stand subscription record.
+     *
+     * @param record The durable subscription record.
+     * @param expectedId Expected canonical subscription ID.
+     * @returns The detached subscription entry with its stable reader binding.
+     */ read(record: SubscriptionRecord, expectedId?: string): StandSubscriptionEntry;
+    /**
+     * Encodes a validated reader-bound entry as the maintained Proto record.
+     *
+     * @param entry Retained subscription entry.
+     * @returns The serialized record ready for storage.
+     */ write(entry: StandSubscriptionEntry): SubscriptionRecord;
+    /**
+     * Decodes a bounded wire record and validates its stored subscription fields.
+     *
+     * @param bytes The serialized message bytes.
+     * @param expectedId Expected canonical subscription ID.
+     * @returns The validated detached subscription entry.
+     */ decode(bytes: Uint8Array, expectedId?: string): StandSubscriptionEntry;
+    /**
+     * Validates the pending phase and its activation expiry.
+     *
+     * @param record The durable subscription record.
+     * @param subscription The subscription definition being processed.
+     * @param createdAt The record creation time in milliseconds.
+     * @param reader The verified reader facts for this operation.
+     * @returns The pending subscription entry.
+     */ pending(record: SubscriptionRecord, subscription: SubscriptionRecord["subscription"], createdAt: number, reader: ReaderIdentity | undefined): StandSubscriptionEntry;
 };
 //# sourceMappingURL=subscription-records.d.ts.map

package/dist/stand/subscription-records.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscription-records.d.ts","sourceRoot":"","sources":["../../src/stand/subscription-records.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,wBAAwB,EAIxB,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAIzE;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,wBAAwB,CAAC;IACjD,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;IAC9E,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,kBAAkB,CAAC;IACzD,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;CAiEvE,CAAC"}
+{"version":3,"file":"subscription-records.d.ts","sourceRoot":"","sources":["../../src/stand/subscription-records.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,wBAAwB,EAIxB,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAIlF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,wBAAwB,CAAC;IAEjD;;;;;;OAMG,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;IAElF;;;;;OAKG,CAAC,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,kBAAkB,CAAC;IAE7D;;;;;;OAMG,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;IAE3E;;;;;;;;OAQG,CAAC,OAAO,CACT,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,kBAAkB,CAAC,cAAc,CAAC,EAChD,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC,sBAAsB,CAAC;CAyG1B,CAAC"}

package/dist/stand/subscription-records.js

@@ -13,13 +13,20 @@
  */
 import { clone, create, fromBinary, toBinary } from "@bufbuild/protobuf";
 import { SubscriptionRecordSchema, SubscriptionIdSchema, SubscriptionSchema, SubscriptionStatus, } from "@spine-event-engine/proto/client";
+import { SubscriptionReaderBindings } from "./subscription-reader-binding.js";
 const maximumBytes = 1_048_576;
 /**
  * Encodes and validates the approved durable subscription record.
  */
 export const StandSubscriptionRecords = Object.freeze({
     schema: SubscriptionRecordSchema,
-    read(record, expectedId) {
+    /**
+     * Validates and decodes a retained Stand subscription record.
+     *
+     * @param record The durable subscription record.
+     * @param expectedId Expected canonical subscription ID.
+     * @returns The detached subscription entry with its stable reader binding.
+     */ read(record, expectedId) {
         try {
             const id = record.id?.value;
             const subscription = record.subscription;
@@ -31,30 +38,49 @@ export const StandSubscriptionRecords = Object.freeze({
                 subscription.topic.id.value.trim() === "")
                 throw Error();
             const createdAt = milliseconds(record.whenCreated);
-            if (record.status === SubscriptionStatus.PENDING) {
-                const pendingUntil = milliseconds(record.whenActivationExpires);
-                if (pendingUntil < createdAt)
-                    throw Error();
-                return Object.freeze({
-                    subscription: clone(SubscriptionSchema, subscription),
-                    phase: "pending",
-                    createdAt,
-                    pendingUntil,
-                });
-            }
+            const reader = SubscriptionReaderBindings.read(record.reader);
+            if (record.status === SubscriptionStatus.PENDING)
+                return this.pending(record, subscription, createdAt, reader);
             if (record.status !== SubscriptionStatus.ACTIVE || record.whenActivationExpires !== undefined)
                 throw Error();
             return Object.freeze({
                 subscription: clone(SubscriptionSchema, subscription),
                 phase: "active",
                 createdAt,
+                ...(reader === undefined ? {} : { reader }),
             });
         }
         catch {
             throw new Error("Stand subscription record is invalid.");
         }
     },
-    write(entry) {
+    /**
+     * Reads a pending row only when its activation deadline follows creation.
+     *
+     * @param record The durable subscription record.
+     * @param subscription The subscription definition being processed.
+     * @param createdAt The record creation time in milliseconds.
+     * @param reader The verified reader facts for this operation.
+     * @returns The pending subscription entry.
+     */
+    pending(record, subscription, createdAt, reader) {
+        const pendingUntil = milliseconds(record.whenActivationExpires);
+        if (pendingUntil < createdAt || subscription === undefined)
+            throw Error();
+        return Object.freeze({
+            subscription: clone(SubscriptionSchema, subscription),
+            phase: "pending",
+            createdAt,
+            pendingUntil,
+            ...(reader === undefined ? {} : { reader }),
+        });
+    },
+    /**
+     * Encodes a validated reader-bound entry as the maintained Proto record.
+     *
+     * @param entry Retained subscription entry.
+     * @returns The serialized record ready for storage.
+     */ write(entry) {
         const id = entry.subscription.id;
         if (id === undefined)
             throw new TypeError("Stand subscription ID must be non-blank.");
@@ -63,6 +89,9 @@ export const StandSubscriptionRecords = Object.freeze({
             subscription: clone(SubscriptionSchema, entry.subscription),
             status: entry.phase === "pending" ? SubscriptionStatus.PENDING : SubscriptionStatus.ACTIVE,
             whenCreated: timestamp(entry.createdAt),
+            ...(entry.reader === undefined
+                ? {}
+                : { reader: SubscriptionReaderBindings.write(entry.reader) }),
             ...(entry.phase === "pending"
                 ? { whenActivationExpires: timestamp(entry.pendingUntil) }
                 : {}),
@@ -72,7 +101,13 @@ export const StandSubscriptionRecords = Object.freeze({
             throw new RangeError("Stand subscription record exceeds 1048576 bytes.");
         return record;
     },
-    decode(bytes, expectedId) {
+    /**
+     * Decodes a bounded wire record and validates its stored subscription fields.
+     *
+     * @param bytes The serialized message bytes.
+     * @param expectedId Expected canonical subscription ID.
+     * @returns The validated detached subscription entry.
+     */ decode(bytes, expectedId) {
         if (bytes.byteLength > maximumBytes)
             throw new Error("Malformed Stand subscription record.");
         try {
@@ -83,7 +118,12 @@ export const StandSubscriptionRecords = Object.freeze({
         }
     },
 });
-function milliseconds(value) {
+/**
+ * Converts a Proto timestamp to epoch milliseconds.
+ *
+ * @param value Stored Proto timestamp, if present.
+ * @returns The timestamp in milliseconds.
+ */ function milliseconds(value) {
     if (value === undefined || value.seconds < 0n || value.nanos < 0 || value.nanos >= 1_000_000_000)
         throw Error();
     const result = Number(value.seconds) * 1000 + Math.floor(value.nanos / 1_000_000);
@@ -91,7 +131,12 @@ function milliseconds(value) {
         throw Error();
     return result;
 }
-function timestamp(value) {
+/**
+ * Creates a Proto timestamp from epoch milliseconds.
+ *
+ * @param value Validated epoch milliseconds.
+ * @returns The Proto timestamp.
+ */ function timestamp(value) {
     if (!Number.isSafeInteger(value) || value < 0)
         throw new RangeError("Stand subscription time is invalid.");
     return { seconds: BigInt(Math.floor(value / 1000)), nanos: (value % 1000) * 1_000_000 };

package/dist/stand/subscription-records.js.map

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

package/dist/stand/subscription-registry.d.ts

@@ -1,5 +1,14 @@
+import { type ReaderIdentity } from "@spine-event-engine/core/spi/trusted-reader";
 import { type Subscription, type SubscriptionId, type SubscriptionRecord } from "@spine-event-engine/proto/client";
-import { RecordSpec, type StorageContext, type StorageFactory } from "@spine-event-engine/storage";
+import { RecordSpec, StorageGroup, type StorageContext, type StorageFactory } from "@spine-event-engine/storage";
+import { type StoragePreparationMode } from "@spine-event-engine/storage/provider";
+/**
+ * Maps a logical Bounded Context name to one provider-safe durable record family.
+ *
+ * @param contextName Logical Bounded Context name.
+ * @returns A stable physical StorageGroup.
+ */
+export declare const subscriptionRecordGroup: (contextName: string) => StorageGroup;
 /**
  * Exact durable subscription layout shared by the registry and preparation.
  */
@@ -12,6 +21,10 @@ interface StandSubscriptionEntryBase {
      * Provides the subscription definition.
      */
     readonly subscription: Subscription;
+    /**
+     * Stable verified reader binding, absent only in legacy records.
+     */
+    readonly reader?: ReaderIdentity;
     /**
      * Records when the definition was created, in milliseconds since Unix epoch.
      */
@@ -77,11 +90,16 @@ export type StandActivateResult = Readonly<{
      * Identifies an absent or expired definition.
      */
     kind: "missing" | "expired";
+}> | Readonly<{
+    /**
+     * The current record is bound to a different or unverifiable reader.
+     */
+    kind: "denied";
 }>;
 /**
  * Identifies the outcome of deleting a durable subscription definition.
  */
-export type StandDeleteResult = "deleted" | "missing";
+export type StandDeleteResult = "deleted" | "missing" | "denied";
 /**
  * Describes one finite cleanup pass.
  */
@@ -124,22 +142,25 @@ export interface StandSubscriptionRegistry {
      *
      * @param subscription Provides the definition to create.
      * @returns Resolves to the creation outcome.
+     * @param reader The verified reader facts for this operation.
      */
-    create(subscription: Subscription): Promise<StandCreateResult>;
+    create(subscription: Subscription, reader?: ReaderIdentity): Promise<StandCreateResult>;
     /**
      * Activates the definition identified by an explicit subscription ID.
      *
      * @param id Identifies the definition to activate.
      * @returns Resolves to the activation outcome.
+     * @param reader The verified reader facts for this operation.
      */
-    activate(id: SubscriptionId): Promise<StandActivateResult>;
+    activate(id: SubscriptionId, reader?: ReaderIdentity): Promise<StandActivateResult>;
     /**
      * Deletes the definition identified by an explicit subscription ID.
      *
      * @param id Identifies the definition to delete.
      * @returns Resolves to the deletion outcome.
+     * @param reader The verified reader facts for this operation.
      */
-    delete(id: SubscriptionId): Promise<StandDeleteResult>;
+    delete(id: SubscriptionId, reader?: ReaderIdentity): Promise<StandDeleteResult>;
     /**
      * Gets an isolated current definition, when it exists.
      *
@@ -180,22 +201,25 @@ export declare class InMemorySubscriptionRegistry implements StandSubscriptionRe
      *
      * @param subscription Provides the definition to create.
      * @returns Resolves to the creation outcome.
+     * @param reader The verified reader facts for this operation.
      */
-    create(subscription: Subscription): Promise<StandCreateResult>;
+    create(subscription: Subscription, reader?: ReaderIdentity): Promise<StandCreateResult>;
     /**
      * Activates an unexpired in-memory pending definition.
      *
      * @param value Identifies the definition to activate.
      * @returns Resolves to the activation outcome.
+     * @param reader The verified reader facts for this operation.
      */
-    activate(value: SubscriptionId): Promise<StandActivateResult>;
+    activate(value: SubscriptionId, reader?: ReaderIdentity): Promise<StandActivateResult>;
     /**
      * Deletes an in-memory definition, when present.
      *
      * @param value Identifies the definition to delete.
      * @returns Resolves to the deletion outcome.
+     * @param reader The verified reader facts for this operation.
      */
-    delete(value: SubscriptionId): Promise<StandDeleteResult>;
+    delete(value: SubscriptionId, reader?: ReaderIdentity): Promise<StandDeleteResult>;
     /**
      * Gets an isolated in-memory definition, when present.
      *
@@ -228,37 +252,48 @@ export declare class InMemorySubscriptionRegistry implements StandSubscriptionRe
 export declare class StorageSubscriptionRegistry implements StandSubscriptionRegistry {
     #private;
     /**
-     * Indicates that the backing storage owns durable definitions.
+     * Indicates that the backing storage retains durable definitions.
      */
     readonly persistent = true;
     /**
      * Creates a registry backed by one compare-and-set-capable record handle.
      *
-     * @param context Identifies the storage namespace.
+     * @param context Identifies the storage context.
      * @param storageFactory Creates the registry record handle.
+     * @param storageGroup Selects the physical subscription record family.
+     */
+    constructor(context: StorageContext, storageFactory: StorageFactory, storageGroup: StorageGroup);
+    /**
+     * Prepares this registry's captured factory, context, and physical group.
+     *
+     * @param mode Required preparation mode.
+     * @returns Completion of storage preparation.
      */
-    constructor(context: StorageContext, storageFactory: StorageFactory);
+    prepare(mode: StoragePreparationMode): Promise<void>;
     /**
      * Creates a pending durable definition or finds its identical predecessor.
      *
      * @param subscription Provides the definition to create.
      * @returns Resolves to the creation outcome.
+     * @param reader The verified reader facts for this operation.
      */
-    create(subscription: Subscription): Promise<StandCreateResult>;
+    create(subscription: Subscription, reader?: ReaderIdentity): Promise<StandCreateResult>;
     /**
      * Activates an unexpired durable pending definition.
      *
      * @param value Identifies the definition to activate.
      * @returns Resolves to the activation outcome.
+     * @param reader The verified reader facts for this operation.
      */
-    activate(value: SubscriptionId): Promise<StandActivateResult>;
+    activate(value: SubscriptionId, reader?: ReaderIdentity): Promise<StandActivateResult>;
     /**
      * Deletes a durable definition after observing its current record.
      *
      * @param value Identifies the definition to delete.
      * @returns Resolves to the deletion outcome.
+     * @param reader The verified reader facts for this operation.
      */
-    delete(value: SubscriptionId): Promise<StandDeleteResult>;
+    delete(value: SubscriptionId, reader?: ReaderIdentity): Promise<StandDeleteResult>;
     /**
      * Gets an isolated durable definition, when present.
      *

package/dist/stand/subscription-registry.d.ts.map

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