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

package/dist/context/tenant-index.d.ts

@@ -1,66 +1,71 @@
 import type { TenantId } from "@spine-event-engine/proto";
-import { type StorageFactory } from "@spine-event-engine/storage";
-import type { TenantCatalogCursor, TenantCatalogRead } from "@spine-event-engine/storage/provider";
-type TenantMode = "single-tenant" | "multitenant";
+import type { StorageFactory } from "@spine-event-engine/storage";
+import { type TenantCatalogCursor, type TenantCatalogRead, type TenantCatalogSignal } from "@spine-event-engine/storage/provider";
 /**
- * Tracks tenants admitted through one factory-owned provider catalog.
+ * Finite read request for a live tenant index.
+ */
+export type TenantIndexRead = TenantCatalogRead;
+/**
+ * Cancellation port for tenant-index traversal.
+ */
+export type TenantIndexSignal = TenantCatalogSignal;
+/**
+ * Opaque continuation returned by the same index instance.
+ */
+export type TenantIndexCursor = TenantCatalogCursor;
+/**
+ * Live application membership independent of storage destination resolution.
  */
 export interface TenantIndex {
     /**
-     * Identifies whether the owning context accepts tenant IDs.
+     * Checks current membership without registration or storage preparation.
+     *
+     * @param tenantId Complete tenant identity to inspect.
+     * @returns Whether this index currently includes the tenant.
      */
-    readonly tenantMode: TenantMode;
+    contains(tenantId: TenantId): Promise<boolean>;
     /**
-     * Lists complete tenants discovered by the provider.
+     * Lists complete currently registered tenant identities.
      *
-     * @returns The provider-owned tenant IDs.
+     * @returns Complete currently registered tenant identities.
      */
     all(): Promise<readonly TenantId[]>;
     /**
-     * Reads a finite page for Agent recovery without enumerating the catalog.
+     * Reads a finite page from this index.
      *
-     * @param request Bounded provider page and cancellation.
-     * @returns Complete tenant IDs and an opaque continuation.
+     * @param request Bounded page and cancellation.
+     * @returns Tenant identities and an opaque continuation.
      */
-    page(request: TenantCatalogRead): Promise<TenantIndexPage>;
+    page(request: TenantIndexRead): Promise<TenantIndexPage>;
     /**
-     * Records one complete tenant through provider-native catalog state.
+     * Registers a tenant and returns after membership becomes visible.
      *
-     * @param tenantId The complete generated tenant ID.
-     * @returns Completion of provider catalog admission.
+     * @param tenantId Complete tenant identity to register.
+     * @returns Completion or rejection from this index.
      */
     keep(tenantId: TenantId): Promise<void>;
-    /**
-     * Closes this context view without closing the factory-owned catalog.
-     */
-    close(): void;
 }
 /**
- * One finite provider tenant page for Agent discovery.
+ * One finite page of complete tenant identities.
  */
 export interface TenantIndexPage {
     /**
-     * Complete generated tenant identities from this provider page.
+     * Complete generated tenant identities.
      */
     readonly ids: readonly TenantId[];
     /**
-     * Opaque continuation when another provider page remains.
+     * Opaque continuation when another page remains.
      */
-    readonly after?: TenantCatalogCursor;
+    readonly after?: TenantIndexCursor;
     /**
-     * Whether the finite catalog traversal has another page.
+     * Whether another page belongs to this traversal.
      */
     readonly hasMore: boolean;
 }
 /**
- * Creates context views over factory-owned tenant catalogs.
+ * Creates an environment default from a provider catalog or transient memory.
  */
 export declare const TenantIndexes: Readonly<{
-    create(input: {
-        readonly contextName: string;
-        readonly tenantMode: TenantMode;
-        readonly storageFactory: StorageFactory;
-    }): TenantIndex;
+    fromFactory(factory: StorageFactory): TenantIndex;
 }>;
-export {};
 //# sourceMappingURL=tenant-index.d.ts.map

package/dist/context/tenant-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tenant-index.d.ts","sourceRoot":"","sources":["../../src/context/tenant-index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAEV,mBAAmB,EAEnB,iBAAiB,EAClB,MAAM,sCAAsC,CAAC;AAK9C,KAAK,UAAU,GAAG,eAAe,GAAG,aAAa,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,WAAW;IAG1B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC;;;;OAIG;IACH,GAAG,IAAI,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IAEpC;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,SAAS,QAAQ,EAAE,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE;QACZ,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;QAChC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;KACzC,GAAG,WAAW,CAAC;CACjB,CAcC,CAAC"}
+{"version":3,"file":"tenant-index.d.ts","sourceRoot":"","sources":["../../src/context/tenant-index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAIL,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,sCAAsC,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,WAAW;IAG1B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/C;;;;OAIG;IACH,GAAG,IAAI,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IAEpC;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEzD;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,SAAS,QAAQ,EAAE,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC;IAAE,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAAA;CAAE,CActF,CAAC"}

package/dist/context/tenant-index.js

@@ -11,196 +11,194 @@
  * or implied. See the License for the specific language governing permissions and limitations under
  * the License.
  */
-import {} from "@spine-event-engine/storage";
-import { TenantBoundary } from "@spine-event-engine/storage/provider";
-import { TenantCatalogReads } from "@spine-event-engine/storage/provider";
-import { EffectiveTenants } from "./effective-tenant.js";
+import { TenantBoundary, TenantCatalogReads, } from "@spine-event-engine/storage/provider";
 /**
- * Creates context views over factory-owned tenant catalogs.
+ * Creates an environment default from a provider catalog or transient memory.
  */
 export const TenantIndexes = Object.freeze({
-    // prettier-ignore
     /**
-     * Creates an index view for one context.
+     * Selects a provider catalog when available without creating records.
      *
-     * @param input Identifies the diagnostic context, tenancy mode, and factory.
-     * @returns The matching tenant index.
-     */
-    create(input) {
-        return input.tenantMode === "single-tenant"
-            ? new SingleTenantIndex(input.contextName)
-            : new StorageTenantIndex(input.contextName, tenantCatalog(input.storageFactory));
+     * @param factory Environment storage factory.
+     * @returns One live index for the environment lifetime.
+     */
+    fromFactory(factory) {
+        const provider = factory;
+        return typeof provider.tenantCatalog === "function"
+            ? new StorageTenantIndex(provider.tenantCatalog())
+            : new MemoryTenantIndex();
     },
 });
 /**
- * Reports the effective identity of one single-tenant context.
+ * Adapts a provider catalog to the public live membership contract.
  */
-class SingleTenantIndex {
-    contextName;
-    // prettier-ignore
-    /**
-     * Identifies the index mode.
-     */
-    tenantMode = "single-tenant";
-    /**
-     * Whether callers may still use this index.
-     */
-    #open = true;
+class StorageTenantIndex {
+    catalog;
     /**
-     * Captures the context name for closed-index diagnostics.
+     * Binds the index to a provider catalog.
      *
-     * @param contextName Name reported in diagnostics.
+     * @param catalog Provider catalog retained by its storage factory.
      */
-    constructor(contextName) {
-        this.contextName = contextName;
+    constructor(catalog) {
+        this.catalog = catalog;
     }
     /**
-     * Lists the effective single-tenant identity while open.
+     * Checks membership through the catalog.
      *
-     * @returns The single effective tenant, or rejection after close.
+     * @param tenantId Tenant to inspect.
+     * @returns Live catalog membership.
      */
-    all() {
-        const closed = this.closedError();
-        return closed === undefined
-            ? Promise.resolve(Object.freeze([EffectiveTenants.current(false, undefined)]))
-            : Promise.reject(closed);
+    async contains(tenantId) {
+        return this.catalog.contains(TenantBoundary.from(tenantId));
     }
     /**
-     * Returns the single effective tenant without a provider catalog.
+     * Lists complete named tenant identities.
      *
-     * @param request Finite page request.
-     * @returns One terminal tenant page.
+     * @returns Complete named tenant identities.
      */
-    page(request) {
-        return Promise.resolve().then(() => {
-            const closed = this.closedError();
-            if (closed !== undefined)
-                throw closed;
-            TenantCatalogReads.require(request);
-            if (request.after !== undefined)
-                throw new TypeError("Single-tenant catalog does not accept a continuation.");
-            return { ids: [EffectiveTenants.current(false, undefined)], hasMore: false };
-        });
+    async all() {
+        return Object.freeze((await this.catalog.all()).map((boundary) => this.named(boundary)));
     }
     /**
-     * Rejects tenant recording because a single-tenant context has a fixed identity.
+     * Reads a finite provider page.
      *
-     * @returns A rejected promise explaining why recording is unavailable.
+     * @param request Finite provider page.
+     * @returns Complete tenant page.
      */
-    keep() {
-        const closed = this.closedError();
-        return Promise.reject(closed ??
-            new Error(`Single-tenant context "${this.contextName}" does not accept tenant recording.`));
+    async page(request) {
+        TenantCatalogReads.require(request);
+        const page = await this.catalog.page(request);
+        request.signal.throwIfAborted();
+        return {
+            ids: page.boundaries.map((boundary) => this.named(boundary)),
+            ...(page.after === undefined ? {} : { after: page.after }),
+            hasMore: page.hasMore,
+        };
     }
     /**
-     * Stops accepting index operations.
+     * Registers a tenant through the provider catalog.
+     *
+     * @param tenantId Tenant to register.
+     * @returns Provider confirmation.
      */
-    close() {
-        this.#open = false;
+    async keep(tenantId) {
+        return this.catalog.keep(TenantBoundary.from(tenantId));
     }
     /**
-     * Returns a closed-index error while preserving an open index.
+     * Validates a named provider boundary.
      *
-     * @returns An error only when the index is closed.
+     * @param boundary Provider boundary.
+     * @returns Its complete named identity.
      */
-    closedError() {
-        return this.#open ? undefined : new Error("TenantIndex is closed.");
+    named(boundary) {
+        if (boundary.single || boundary.tenantId === undefined)
+            throw new Error("Multitenant provider catalog returned a single-tenant boundary.");
+        return boundary.tenantId;
     }
 }
 /**
- * Reads named tenants from the storage provider's catalog.
+ * Retains explicit membership when a custom factory has no catalog.
  */
-class StorageTenantIndex {
-    contextName;
-    catalog;
-    // prettier-ignore
-    /**
-     * Identifies the index mode.
-     */
-    tenantMode = "multitenant";
+class MemoryTenantIndex {
+    #tenants = new Map();
+    #order = [];
+    #identity = {};
     /**
-     * Whether callers may still use this index.
+     * Checks explicit memory membership.
+     *
+     * @param tenantId Tenant to inspect.
+     * @returns Explicit membership.
      */
-    #open = true;
+    contains(tenantId) {
+        return Promise.resolve().then(() => this.#tenants.has(String(TenantBoundary.from(tenantId).key)));
+    }
     /**
-     * Captures the provider catalog used for this context.
+     * Lists detached complete tenant identities.
      *
-     * @param contextName Name reported in diagnostics.
-     * @param catalog Provider catalog for named tenants.
+     * @returns Detached complete tenant identities.
      */
-    constructor(contextName, catalog) {
-        this.contextName = contextName;
-        this.catalog = catalog;
+    all() {
+        return Promise.resolve(Object.freeze(this.#order.map((boundary) => boundary.tenantId)));
     }
     /**
-     * Lists named tenants from the provider catalog.
+     * Reads a bounded page without copying the full directory.
      *
-     * @returns Named tenant IDs, or rejection for an invalid/closed catalog.
+     * @param request Finite page request.
+     * @returns Bounded membership page.
      */
-    async all() {
-        this.requireOpen();
-        return Object.freeze((await this.catalog.all()).map((boundary) => {
-            if (boundary.single || boundary.tenantId === undefined)
-                throw new Error("Multitenant provider catalog returned a single-tenant boundary.");
-            return boundary.tenantId;
-        }));
+    page(request) {
+        return Promise.resolve().then(() => this.readPage(request));
     }
     /**
-     * Reads exactly one bounded provider page.
+     * Reads one page after promise admission.
      *
      * @param request Finite page request.
-     * @returns Validated complete tenant IDs.
+     * @returns Bounded membership page.
      */
-    async page(request) {
-        this.requireOpen();
+    readPage(request) {
         TenantCatalogReads.require(request);
-        const page = await this.catalog.page(request);
+        const cursor = request.after;
+        if (cursor !== undefined && !(cursor instanceof MemoryTenantIndexCursor))
+            throw new TypeError("TenantIndex continuation is invalid.");
+        const state = cursor?.position(this.#identity);
+        const start = state?.index ?? 0;
+        const length = state?.length ?? this.#order.length;
+        const end = Math.min(length, start + request.count);
         request.signal.throwIfAborted();
-        this.requireOpen();
-        const ids = page.boundaries.map((boundary) => {
-            if (boundary.single || boundary.tenantId === undefined)
-                throw new Error("Multitenant provider catalog returned a single-tenant boundary.");
-            return boundary.tenantId;
-        });
         return {
-            ids,
-            ...(page.after === undefined ? {} : { after: page.after }),
-            hasMore: page.hasMore,
+            ids: this.#order.slice(start, end).map((boundary) => boundary.tenantId),
+            ...(end < length ? { after: new MemoryTenantIndexCursor(this.#identity, end, length) } : {}),
+            hasMore: end < length,
         };
     }
     /**
-     * Records a named tenant in the provider catalog.
+     * Registers one detached complete tenant identity.
      *
-     * @param tenantId Named tenant to record.
-     * @returns Completion after the catalog records the tenant.
+     * @param tenantId Tenant to register.
+     * @returns Visible membership completion.
      */
     keep(tenantId) {
         return Promise.resolve().then(() => {
-            this.requireOpen();
-            return this.catalog.keep(TenantBoundary.from(tenantId));
+            const boundary = TenantBoundary.from(tenantId);
+            const key = String(boundary.key);
+            if (this.#tenants.has(key))
+                return;
+            this.#tenants.set(key, boundary);
+            this.#order.push(boundary);
         });
     }
+}
+/**
+ * Instance-bound continuation for a transient in-memory index.
+ */
+class MemoryTenantIndexCursor {
+    [Symbol.toStringTag] = "TenantCatalogCursor";
+    #identity;
+    #index;
+    #length;
     /**
-     * Stops accepting index operations.
-     */
-    close() {
-        this.#open = false;
+     * Captures one finite sweep position.
+     *
+     * @param identity Index identity.
+     * @param index Next position.
+     * @param length Sweep length.
+     */
+    constructor(identity, index, length) {
+        this.#identity = identity;
+        this.#index = index;
+        this.#length = length;
+        Object.freeze(this);
     }
     /**
-     * Rejects use of a closed index.
+     * Verifies the issuing index before returning the sweep position.
+     *
+     * @param identity Expected index identity.
+     * @returns Finite sweep position.
      */
-    requireOpen() {
-        if (!this.#open)
-            throw new Error(`TenantIndex for "${this.contextName}" is closed.`);
+    position(identity) {
+        if (this.#identity !== identity)
+            throw new TypeError("TenantIndex continuation is invalid.");
+        return { index: this.#index, length: this.#length };
     }
 }
-function tenantCatalog(factory) {
-    const provider = factory;
-    if (typeof provider.tenantCatalog !== "function")
-        throw new Error("Multitenant storage requires a provider-owned tenant catalog.");
-    const catalog = provider.tenantCatalog();
-    if (typeof catalog.page !== "function")
-        throw new Error("Multitenant Agent storage requires a paged provider tenant catalog.");
-    return catalog;
-}
 //# sourceMappingURL=tenant-index.js.map

package/dist/context/tenant-index.js.map

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

package/dist/context/tenant-unknown-error.d.ts

@@ -0,0 +1,33 @@
+import type { TenantId } from "@spine-event-engine/proto";
+import type { TenantIndex } from "./tenant-index.js";
+/**
+ * Identifies a complete tenant absent from a receiving Bounded Context's live index.
+ */
+export declare class TenantUnknownError extends Error {
+    #private;
+    readonly contextName: string;
+    /**
+     * Stable structured error type for missing live membership.
+     */
+    readonly type: "TENANT_UNKNOWN";
+    /**
+     * Captures the rejected tenant without retaining a mutable caller message.
+     *
+     * @param tenantId Complete unknown tenant identity.
+     * @param contextName Receiving Bounded Context name.
+     */
+    constructor(tenantId: TenantId, contextName: string);
+    /**
+     * Returns a detached copy of the complete rejected identity.
+     *
+     * @returns Complete tenant identity.
+     */
+    get tenantId(): TenantId;
+}
+/**
+ * Checks a receiving context's current membership after shape validation.
+ */
+export declare const TenantAdmissions: Readonly<{
+    require(index: TenantIndex, contextName: string, multitenant: boolean, tenantId?: TenantId): Promise<void>;
+}>;
+//# sourceMappingURL=tenant-unknown-error.d.ts.map

package/dist/context/tenant-unknown-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-unknown-error.d.ts","sourceRoot":"","sources":["../../src/context/tenant-unknown-error.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;;IAgBzC,QAAQ,CAAC,WAAW,EAAE,MAAM;IAf9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;IAI1C;;;;;OAKG;gBAED,QAAQ,EAAE,QAAQ,EACT,WAAW,EAAE,MAAM;IAW9B;;;;OAIG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAEvB;CACF;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC;IACtC,OAAO,CACL,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,OAAO,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB,CAsBC,CAAC"}

package/dist/context/tenant-unknown-error.js

@@ -0,0 +1,75 @@
+/*
+ * 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 { TenantBoundary } from "@spine-event-engine/storage/provider";
+/**
+ * Identifies a complete tenant absent from a receiving Bounded Context's live index.
+ */
+export class TenantUnknownError extends Error {
+    contextName;
+    /**
+     * Stable structured error type for missing live membership.
+     */
+    type = "TENANT_UNKNOWN";
+    #tenant;
+    /**
+     * Captures the rejected tenant without retaining a mutable caller message.
+     *
+     * @param tenantId Complete unknown tenant identity.
+     * @param contextName Receiving Bounded Context name.
+     */
+    constructor(tenantId, contextName) {
+        const tenant = TenantBoundary.from(tenantId);
+        const kind = tenant.tenantId.kind;
+        const label = kind.case === "value" ? kind.value : kind.case === undefined ? "" : kind.value.value;
+        super(`Tenant "${label}" is not registered for ${contextName}.`);
+        this.contextName = contextName;
+        this.name = "TenantUnknownError";
+        this.#tenant = tenant;
+    }
+    /**
+     * Returns a detached copy of the complete rejected identity.
+     *
+     * @returns Complete tenant identity.
+     */
+    get tenantId() {
+        return this.#tenant.tenantId;
+    }
+}
+/**
+ * Checks a receiving context's current membership after shape validation.
+ */
+export const TenantAdmissions = Object.freeze({
+    /**
+     * Requires live membership before tenant-specific work.
+     *
+     * @param index Receiving Bounded Context's effective index.
+     * @param contextName Diagnostic context name.
+     * @param multitenant Whether a tenant identity applies.
+     * @param tenantId Complete supplied tenant identity, when applicable.
+     * @returns Completion when current membership permits this input.
+     */
+    async require(index, contextName, multitenant, tenantId) {
+        if (!multitenant) {
+            if (tenantId !== undefined)
+                throw new Error(`Single-tenant storage "${contextName}" does not accept context.tenantId.`);
+            return;
+        }
+        if (tenantId === undefined)
+            throw new Error(`Multitenant storage "${contextName}" requires context.tenantId.`);
+        const boundary = TenantBoundary.from(tenantId);
+        if (!(await index.contains(boundary.tenantId)))
+            throw new TenantUnknownError(boundary.tenantId, contextName);
+    },
+});
+//# sourceMappingURL=tenant-unknown-error.js.map

package/dist/context/tenant-unknown-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-unknown-error.js","sourceRoot":"","sources":["../../src/context/tenant-unknown-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAGtE;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAgBhC;IAfX;;OAEG;IACM,IAAI,GAAG,gBAAyB,CAAC;IAEjC,OAAO,CAAyC;IAEzD;;;;;OAKG;IACH,YACE,QAAkB,EACT,WAAmB;QAE5B,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAClC,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QACvF,KAAK,CAAC,WAAW,KAAK,2BAA2B,WAAW,GAAG,CAAC,CAAC;QANxD,gBAAW,GAAX,WAAW,CAAQ;QAO5B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAOxB,MAAM,CAAC,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ;QACrD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,QAAQ,KAAK,SAAS;gBACxB,MAAM,IAAI,KAAK,CAAC,0BAA0B,WAAW,qCAAqC,CAAC,CAAC;YAC9F,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS;YACxB,MAAM,IAAI,KAAK,CAAC,wBAAwB,WAAW,8BAA8B,CAAC,CAAC;QACrF,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACjE,CAAC;CACF,CAAC,CAAC"}