@spine-event-engine/server 2.0.0-snapshot.2

package/dist/context/local-inbox-handoff.d.ts

@@ -0,0 +1,244 @@
+import type { Any } from "@bufbuild/protobuf/wkt";
+import type { TenantId } from "@spine-event-engine/proto";
+import { Delivery, type DeliveryEndpointMessage } from "../delivery/delivery.js";
+import type { DeliveryInbox, DeliveryWorkRegistry } from "../delivery/delivery-ports.js";
+import type { DeliverySource } from "../delivery/delivery-supervisor.js";
+import { type InboxMessage } from "../delivery/inbox.js";
+import { ShardIndex } from "../delivery/shard-index.js";
+/**
+ * Names the delivery labels that local inbox routes can handle.
+ */
+export type SupportedDeliveryLabel = DeliveryEndpointMessage["label"];
+/**
+ * Describes one delivery target assigned to a shard.
+ */
+export interface DeliveryEndpoint {
+    /**
+     * Names the delivery action performed for the target.
+     */
+    readonly label: SupportedDeliveryLabel;
+    /**
+     * Names the target message type.
+     */
+    readonly targetTypeUrl: string;
+    /**
+     * Locates the target within its delivery shard set.
+     */
+    readonly shard: ShardIndex;
+}
+/**
+ * Describes a delivery route that became eligible after persistence.
+ */
+export interface DeliveryReady extends DeliveryEndpoint {
+    /**
+     * Identifies the tenant when this route is tenant-scoped.
+     */
+    readonly tenantId?: TenantId;
+}
+/**
+ * Observes a delivery route that became eligible after persistence.
+ *
+ * @param ready Describes the route that is ready to drain.
+ * @returns Returns an optional asynchronous observation outcome.
+ */
+export type OnDeliveryReady = (ready: DeliveryReady) => unknown;
+/**
+ * Groups the inbox and shard registry selected by a server environment.
+ *
+ * @internal
+ */
+export interface EnvironmentDeliveryPorts {
+    /**
+     * Persists and reads environment-owned delivery messages.
+     */
+    readonly inbox: DeliveryInbox;
+    /**
+     * Coordinates environment-owned shard work.
+     */
+    readonly workRegistry: DeliveryWorkRegistry;
+    /**
+     * Supplies remote Admin recovery and notification observations when delivery is remote.
+     */
+    readonly source?: DeliverySource;
+}
+/**
+ * Coordinates readiness notifications while delivery ownership changes hands.
+ */
+export declare class DeliveryReadiness {
+    #private;
+    /**
+     * Creates a readiness coordinator.
+     *
+     * @param onReady Observes routes made ready before ownership is transferred.
+     */
+    constructor(onReady?: OnDeliveryReady);
+    /**
+     * Sets the observer used before routing takes ownership.
+     *
+     * @param onReady Observes routes that become ready.
+     * @returns Returns a function that removes this observer when still active.
+     */
+    onReady(onReady: OnDeliveryReady): () => void;
+    /**
+     * Acquires readiness ownership for a persisted route.
+     *
+     * @param ready Describes the route when persistence made it ready.
+     * @returns Returns a claim that must be completed or abandoned.
+     */
+    claim(ready?: DeliveryReady): DeliveryHandoff;
+    /**
+     * Routes a context-created delivery through the attached environment ports.
+     *
+     * Direct local delivery remains unchanged. Once ownership is transferred,
+     * inbox writes and workers must use the same environment-owned facility.
+     *
+     * @param delivery Supplies the context-created delivery configuration.
+     * @returns The delivery selected for the current ownership mode.
+     * @internal
+     */
+    route(delivery: Delivery): Delivery;
+    /**
+     * Updates readiness ownership to use configured delivery routes.
+     *
+     * @param scopes Lists the routes that may receive buffered readiness.
+     * @param onReady Observes readiness after routed ownership begins.
+     * @param options Allows an empty configured route set when `allowEmpty` is true.
+     * @returns A promise that resolves after the readiness transition completes.
+     */
+    transition(scopes: readonly DeliveryReady[], onReady: OnDeliveryReady, options?: {
+        readonly allowEmpty?: boolean;
+        readonly ports?: EnvironmentDeliveryPorts;
+    }): Promise<void>;
+}
+/**
+ * Represents a post-persistence claim held while direct delivery remains active.
+ */
+export interface DeliveryHandoff {
+    /**
+     * Completes the claim after draining the durable message.
+     *
+     * @param onDrain Drains the message associated with this claim.
+     * @returns A promise that resolves after the claim drains and completes.
+     */
+    complete(onDrain: () => Promise<void>): Promise<void>;
+    /**
+     * Cancels the claim without draining it.
+     */
+    abandon(): void;
+}
+/**
+ * Configures one bounded attempt to drain a local inbox message.
+ */
+export interface LocalInboxDrainOptions {
+    /**
+     * Selects the delivery runtime that owns the inbox message.
+     */
+    readonly delivery: Delivery;
+    /**
+     * Identifies the persisted message to drain.
+     */
+    readonly received: InboxMessage;
+    /**
+     * Names the local delivery node acquiring the message.
+     */
+    readonly node: string;
+    /**
+     * Calls target replay after the delivery runtime acquires a message.
+     *
+     * @param message Contains the acquired inbox message.
+     * @returns Resolves after the target replay finishes.
+     */
+    readonly onReplay: (message: InboxMessage) => Promise<void> | void;
+    /**
+     * Determines whether the replay callback owns a message.
+     *
+     * @param message Contains a pending Inbox message.
+     * @returns `true` when the replay callback owns the message.
+     * @internal
+     */
+    readonly acceptMessage?: (message: InboxMessage) => boolean;
+    /**
+     * Observes exact durable acknowledgements produced by the same shard drain.
+     *
+     * @param message Contains the acknowledged Inbox message.
+     * @internal
+     */
+    readonly onAcknowledged?: (message: InboxMessage) => void;
+    /**
+     * Explains a replay failure that lacks an Error instance.
+     */
+    readonly replayFailureMessage: string;
+    /**
+     * Explains a delivery skipped before target replay.
+     */
+    readonly skippedMessage: string;
+    /**
+     * Explains exhaustion of local drain attempts.
+     */
+    readonly unfinishedMessage: string;
+}
+/**
+ * Identifies the fields that deduplicate an in-flight inbox handoff.
+ */
+export interface LocalInboxKeyInput {
+    /**
+     * Identifies the inbox target receiving the message.
+     */
+    readonly inboxId: {
+        readonly targetId: Any;
+        readonly targetTypeUrl: string;
+    };
+    /**
+     * Identifies the source signal persisted in the inbox.
+     */
+    readonly signalId: string;
+    /**
+     * Names the delivery action for the message.
+     */
+    readonly label: InboxMessage["label"];
+    /**
+     * Locates the message in its delivery shard set.
+     */
+    readonly shard: InboxMessage["shard"];
+}
+/**
+ * Coordinates durable local inbox ownership and delivery handoffs.
+ */
+export declare const InboxHandoff: Readonly<{
+    ready(endpoint: DeliveryEndpoint, tenantId?: TenantId): DeliveryReady;
+    configuredScopes(scopes: readonly DeliveryReady[], allowEmpty: boolean): Map<string, DeliveryReady>;
+    readyKey(ready: DeliveryReady): string;
+    cloneReady(ready: DeliveryReady): DeliveryReady;
+    isPromiseLike(value: unknown): value is PromiseLike<unknown>;
+    coordinate(options: {
+        readonly handoffs: Map<string, Promise<InboxMessage>>;
+        readonly key: string;
+        readonly onHandoff: () => Promise<InboxMessage>;
+    }): Promise<InboxMessage>;
+    drain(options: LocalInboxDrainOptions): Promise<void>;
+    runDrain(options: LocalInboxDrainOptions): Promise<void>;
+    key(input: LocalInboxKeyInput, tenantId?: TenantId): string;
+    sameMessageId(left: {
+        readonly value: string;
+        readonly shard: {
+            readonly index: number;
+            readonly ofTotal: number;
+        };
+    }, right: {
+        readonly value: string;
+        readonly shard: {
+            readonly index: number;
+            readonly ofTotal: number;
+        };
+    }): boolean;
+    messageIdKey(message: Pick<InboxMessage, "id">): string;
+    endpoint(input: {
+        readonly label: SupportedDeliveryLabel;
+        readonly inboxId: {
+            readonly targetTypeUrl: string;
+        };
+        readonly shard: ShardIndex;
+    }): DeliveryEndpoint;
+    configuredEndpoint(message: InboxMessage, endpoints: readonly DeliveryEndpoint[]): DeliveryEndpoint | undefined;
+}>;
+//# sourceMappingURL=local-inbox-handoff.d.ts.map

package/dist/context/local-inbox-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-inbox-handoff.d.ts","sourceRoot":"","sources":["../../src/context/local-inbox-handoff.ts"],"names":[],"mappings":"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"}

package/dist/context/local-inbox-handoff.js

@@ -0,0 +1,334 @@
+/*
+ * 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";
+import { Delivery } from "../delivery/delivery.js";
+import { InboxTargets } from "../delivery/inbox.js";
+import { ShardIndex } from "../delivery/shard-index.js";
+/**
+ * Coordinates readiness notifications while delivery ownership changes hands.
+ */
+export class DeliveryReadiness {
+    #onReady;
+    #active = new Set();
+    #mode = "direct";
+    #configured = new Map();
+    #buffered = new Map();
+    #invalidTransition = false;
+    #ports;
+    /**
+     * Creates a readiness coordinator.
+     *
+     * @param onReady Observes routes made ready before ownership is transferred.
+     */
+    constructor(onReady = () => undefined) {
+        this.#onReady = onReady;
+    }
+    /**
+     * Sets the observer used before routing takes ownership.
+     *
+     * @param onReady Observes routes that become ready.
+     * @returns Returns a function that removes this observer when still active.
+     */
+    onReady(onReady) {
+        if (this.#mode === "routed") {
+            return () => undefined;
+        }
+        this.#onReady = onReady;
+        return () => {
+            if (this.#onReady === onReady) {
+                this.#onReady = () => undefined;
+            }
+        };
+    }
+    /**
+     * Acquires readiness ownership for a persisted route.
+     *
+     * @param ready Describes the route when persistence made it ready.
+     * @returns Returns a claim that must be completed or abandoned.
+     */
+    claim(ready) {
+        if (this.#mode === "direct") {
+            const handoff = this.#directHandoff();
+            if (ready !== undefined) {
+                this.#notify(ready);
+            }
+            return handoff;
+        }
+        if (ready !== undefined) {
+            if (this.#mode === "transition") {
+                const key = InboxHandoff.readyKey(ready);
+                if (this.#configured.has(key)) {
+                    this.#buffered.set(key, InboxHandoff.cloneReady(ready));
+                }
+                else {
+                    this.#invalidTransition = true;
+                }
+            }
+            else if (this.#mode === "routed") {
+                this.#notify(ready);
+            }
+        }
+        return settledHandoff;
+    }
+    /**
+     * Routes a context-created delivery through the attached environment ports.
+     *
+     * Direct local delivery remains unchanged. Once ownership is transferred,
+     * inbox writes and workers must use the same environment-owned facility.
+     *
+     * @param delivery Supplies the context-created delivery configuration.
+     * @returns The delivery selected for the current ownership mode.
+     * @internal
+     */
+    route(delivery) {
+        const ports = this.#ports;
+        if (ports === undefined)
+            return delivery;
+        return new Delivery({
+            context: delivery.context,
+            storageFactory: delivery.storageFactory,
+            strategy: delivery.strategy,
+            node: delivery.node,
+            pageSize: delivery.pageSize,
+            inbox: ports.inbox,
+            workRegistry: ports.workRegistry,
+        });
+    }
+    /**
+     * Updates readiness ownership to use configured delivery routes.
+     *
+     * @param scopes Lists the routes that may receive buffered readiness.
+     * @param onReady Observes readiness after routed ownership begins.
+     * @param options Allows an empty configured route set when `allowEmpty` is true.
+     * @returns A promise that resolves after the readiness transition completes.
+     */
+    transition(scopes, onReady, options = {}) {
+        if (this.#mode !== "direct" && this.#mode !== "failed") {
+            return Promise.reject(new Error("Delivery readiness ownership is already transferred."));
+        }
+        let configured;
+        try {
+            configured = InboxHandoff.configuredScopes(scopes, options.allowEmpty === true);
+        }
+        catch (error) {
+            return Promise.resolve().then(() => {
+                throw error;
+            });
+        }
+        this.#configured = configured;
+        this.#buffered.clear();
+        this.#invalidTransition = false;
+        this.#mode = "transition";
+        const admitted = [...this.#active];
+        return Promise.allSettled(admitted).then(() => {
+            if (this.#invalidTransition) {
+                this.#buffered.clear();
+                this.#mode = "failed";
+                throw new Error("Delivery readiness transition received an unconfigured scope.");
+            }
+            this.#onReady = onReady;
+            this.#ports = options.ports;
+            this.#mode = "routed";
+            for (const ready of this.#buffered.values()) {
+                this.#notify(ready);
+            }
+            this.#buffered.clear();
+        });
+    }
+    #directHandoff() {
+        const gate = Promise.withResolvers();
+        this.#active.add(gate.promise);
+        let abandoned = false;
+        let completion;
+        const finish = () => {
+            gate.resolve(undefined);
+            this.#active.delete(gate.promise);
+        };
+        return Object.freeze({
+            complete: (onDrain) => {
+                if (completion !== undefined) {
+                    return completion;
+                }
+                if (abandoned) {
+                    return settled;
+                }
+                const shared = Promise.withResolvers();
+                completion = shared.promise;
+                void completion.then(finish, finish);
+                try {
+                    void Promise.resolve(onDrain()).then(() => {
+                        shared.resolve(undefined);
+                    }, shared.reject);
+                }
+                catch (error) {
+                    shared.reject(error);
+                }
+                return completion;
+            },
+            abandon: () => {
+                if (completion !== undefined || abandoned) {
+                    return;
+                }
+                abandoned = true;
+                finish();
+            },
+        });
+    }
+    #notify(ready) {
+        try {
+            const result = Reflect.apply(this.#onReady, undefined, [ready]);
+            if (InboxHandoff.isPromiseLike(result)) {
+                void Promise.resolve(result).catch(() => undefined);
+            }
+        }
+        catch {
+            // Readiness observation cannot alter durable receive or exact-drain outcomes.
+        }
+    }
+}
+const settled = Promise.resolve();
+const settledHandoff = Object.freeze({
+    complete: () => settled,
+    abandon: () => undefined,
+});
+const drainLimit = 8;
+/**
+ * Coordinates durable local inbox ownership and delivery handoffs.
+ */
+export const InboxHandoff = Object.freeze({
+    ready(endpoint, tenantId) {
+        return Object.freeze({
+            ...(tenantId === undefined ? {} : { tenantId }),
+            label: endpoint.label,
+            targetTypeUrl: endpoint.targetTypeUrl,
+            shard: new ShardIndex(endpoint.shard.index, endpoint.shard.ofTotal),
+        });
+    },
+    configuredScopes(scopes, allowEmpty) {
+        const configured = new Map();
+        for (const scope of scopes) {
+            configured.set(InboxHandoff.readyKey(scope), InboxHandoff.cloneReady(scope));
+        }
+        if (configured.size === 0 && !allowEmpty) {
+            throw new Error("Delivery readiness transition requires configured scopes.");
+        }
+        return configured;
+    },
+    readyKey(ready) {
+        return JSON.stringify([
+            tenantKey(ready.tenantId),
+            ready.label,
+            ready.targetTypeUrl,
+            ready.shard.index,
+            ready.shard.ofTotal,
+        ]);
+    },
+    cloneReady(ready) {
+        return InboxHandoff.ready(ready, ready.tenantId);
+    },
+    isPromiseLike(value) {
+        if ((typeof value !== "object" || value === null) && typeof value !== "function") {
+            return false;
+        }
+        return "then" in value && typeof value.then === "function";
+    },
+    async coordinate(options) {
+        const inFlightHandoff = options.handoffs.get(options.key);
+        if (inFlightHandoff !== undefined) {
+            return await inFlightHandoff;
+        }
+        const handoff = options.onHandoff();
+        options.handoffs.set(options.key, handoff);
+        try {
+            return await handoff;
+        }
+        finally {
+            if (options.handoffs.get(options.key) === handoff) {
+                options.handoffs.delete(options.key);
+            }
+        }
+    },
+    async drain(options) {
+        await InboxHandoff.runDrain(options);
+    },
+    async runDrain(options) {
+        const { delivery, received, node, onReplay, replayFailureMessage, skippedMessage, unfinishedMessage, } = options;
+        for (let attempt = 0; attempt < drainLimit; attempt += 1) {
+            const direct = await delivery.drainMessage(received, {
+                node,
+                onMessage: onReplay,
+                ...(options.acceptMessage === undefined ? {} : { acceptMessage: options.acceptMessage }),
+                ...(options.onAcknowledged === undefined ? {} : { onDelivered: options.onAcknowledged }),
+            });
+            if (direct.acknowledged)
+                return;
+            const run = direct.run;
+            const target = await delivery.inbox.readMessage(received.id);
+            if (target?.status === "DELIVERED") {
+                return;
+            }
+            const failure = run.failures.find(({ message }) => InboxHandoff.sameMessageId(message.id, received.id));
+            if (failure !== undefined) {
+                throw failure.error instanceof Error
+                    ? failure.error
+                    : new Error(replayFailureMessage, { cause: failure.error });
+            }
+            if (run.status === "SKIPPED") {
+                throw new Error(skippedMessage);
+            }
+            if (run.accepted === 0 && run.delivered === 0 && run.failed === 0) {
+                break;
+            }
+        }
+        throw new Error(unfinishedMessage);
+    },
+    key(input, deliveryTenantId) {
+        return JSON.stringify([
+            tenantKey(deliveryTenantId),
+            input.label,
+            input.signalId,
+            input.inboxId.targetTypeUrl,
+            InboxTargets.key(input.inboxId.targetId),
+            input.shard.index,
+            input.shard.ofTotal,
+        ]);
+    },
+    sameMessageId(left, right) {
+        return (left.value === right.value &&
+            left.shard.index === right.shard.index &&
+            left.shard.ofTotal === right.shard.ofTotal);
+    },
+    messageIdKey(message) {
+        return JSON.stringify([message.id.value, message.id.shard.index, message.id.shard.ofTotal]);
+    },
+    endpoint(input) {
+        return Object.freeze({
+            label: input.label,
+            targetTypeUrl: input.inboxId.targetTypeUrl,
+            shard: new ShardIndex(input.shard.index, input.shard.ofTotal),
+        });
+    },
+    configuredEndpoint(message, endpoints) {
+        if (message.status !== "TO_DELIVER") {
+            return undefined;
+        }
+        return endpoints.find((endpoint) => endpoint.targetTypeUrl === message.inboxId.targetTypeUrl &&
+            endpoint.label === message.label &&
+            endpoint.shard.key() === message.shard.key());
+    },
+});
+function tenantKey(tenantId) {
+    return tenantId === undefined ? "" : String(TenantBoundary.from(tenantId).key);
+}
+//# sourceMappingURL=local-inbox-handoff.js.map

package/dist/context/local-inbox-handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-inbox-handoff.js","sourceRoot":"","sources":["../../src/context/local-inbox-handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAgC,MAAM,yBAAyB,CAAC;AAGjF,OAAO,EAAE,YAAY,EAAqB,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAyExD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC5B,QAAQ,CAAkB;IACjB,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC5C,KAAK,GAAkD,QAAQ,CAAC;IAChE,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC7C,kBAAkB,GAAG,KAAK,CAAC;IAC3B,MAAM,CAAuC;IAE7C;;;;OAIG;IACH,YAAY,UAA2B,GAAG,EAAE,CAAC,SAAS;QACpD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAwB;QAC9B,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBAC9B,IAAI,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC;YAClC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAqB;QACzB,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YACtC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;gBAChC,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACzC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC1D,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;gBACjC,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACnC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,QAAkB;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QACzC,OAAO,IAAI,QAAQ,CAAC;YAClB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,KAAK,CAAC,YAAY;SACjC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CACR,MAAgC,EAChC,OAAwB,EACxB,UAGI,EAAE;QAEN,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,UAAsC,CAAC;QAC3C,IAAI,CAAC;YACH,UAAU,GAAG,YAAY,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBACjC,MAAM,KAAK,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC1B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAC5C,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC5B,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBACvB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;YACnF,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;YAC5B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC5C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,cAAc;QACZ,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAa,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,UAAqC,CAAC;QAC1C,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,CAAC,OAA4B,EAAE,EAAE;gBACzC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC7B,OAAO,UAAU,CAAC;gBACpB,CAAC;gBACD,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,OAAO,CAAC;gBACjB,CAAC;gBACD,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,EAAa,CAAC;gBAClD,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;gBAC5B,KAAK,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,IAAI,CAAC;oBACH,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;wBACxC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;oBAC5B,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBACpB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;gBACD,OAAO,UAAU,CAAC;YACpB,CAAC;YACD,OAAO,EAAE,GAAG,EAAE;gBACZ,IAAI,UAAU,KAAK,SAAS,IAAI,SAAS,EAAE,CAAC;oBAC1C,OAAO;gBACT,CAAC;gBACD,SAAS,GAAG,IAAI,CAAC;gBACjB,MAAM,EAAE,CAAC;YACX,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,KAAoB;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YAChE,IAAI,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvC,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8EAA8E;QAChF,CAAC;IACH,CAAC;CACF;AAsBD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;AAClC,MAAM,cAAc,GAAoB,MAAM,CAAC,MAAM,CAAC;IACpD,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO;IACvB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;CACzB,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,CAAC,CAAC;AA8FrB;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAqCpB,MAAM,CAAC,MAAM,CAAC;IACjB,KAAK,CAAC,QAA0B,EAAE,QAAmB;QACnD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;YAC/C,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,KAAK,EAAE,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;SACpE,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CACd,MAAgC,EAChC,UAAmB;QAEnB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;QACpD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,QAAQ,CAAC,KAAoB;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC;YACzB,KAAK,CAAC,KAAK;YACX,KAAK,CAAC,aAAa;YACnB,KAAK,CAAC,KAAK,CAAC,KAAK;YACjB,KAAK,CAAC,KAAK,CAAC,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,KAAoB;QAC7B,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,aAAa,CAAC,KAAc;QAC1B,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YACjF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAIhB;QACC,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAE1D,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,MAAM,eAAe,CAAC;QAC/B,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC;QACvB,CAAC;gBAAS,CAAC;YACT,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC;gBAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAA+B;QACzC,MAAM,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAA+B;QAC5C,MAAM,EACJ,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GAClB,GAAG,OAAO,CAAC;QAEZ,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE;gBACnD,IAAI;gBACJ,SAAS,EAAE,QAAQ;gBACnB,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;gBACxF,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;aACzF,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,YAAY;gBAAE,OAAO;YAChC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAE7D,IAAI,MAAM,EAAE,MAAM,KAAK,WAAW,EAAE,CAAC;gBACnC,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAChD,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CACpD,CAAC;YAEF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,OAAO,CAAC,KAAK,YAAY,KAAK;oBAClC,CAAC,CAAC,OAAO,CAAC,KAAK;oBACf,CAAC,CAAC,IAAI,KAAK,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YAChE,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;YAClC,CAAC;YACD,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClE,MAAM;YACR,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,KAAyB,EAAE,gBAA2B;QACxD,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,SAAS,CAAC,gBAAgB,CAAC;YAC3B,KAAK,CAAC,KAAK;YACX,KAAK,CAAC,QAAQ;YACd,KAAK,CAAC,OAAO,CAAC,aAAa;YAC3B,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YACxC,KAAK,CAAC,KAAK,CAAC,KAAK;YACjB,KAAK,CAAC,KAAK,CAAC,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CACX,IAGC,EACD,KAGC;QAED,OAAO,CACL,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAC1B,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,KAAK;YACtC,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,CAC3C,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,OAAiC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,QAAQ,CAAC,KAIR;QACC,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,aAAa;YAC1C,KAAK,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB,CAChB,OAAqB,EACrB,SAAsC;QAEtC,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACpC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,SAAS,CAAC,IAAI,CACnB,CAAC,QAAQ,EAAE,EAAE,CACX,QAAQ,CAAC,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,aAAa;YACxD,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;YAChC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAC/C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,SAAS,CAAC,QAA8B;IAC/C,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;AACjF,CAAC"}

package/dist/context/projection-handoff.d.ts

@@ -0,0 +1,46 @@
+import type { TenantId } from "@spine-event-engine/proto";
+import { Delivery } from "../delivery/delivery.js";
+import type { InboxMessage } from "../delivery/inbox.js";
+import type { ProjectionInbox, ProjectionInboxTarget } from "../repository/repository.js";
+import { type DeliveryEndpoint, DeliveryReadiness, type OnDeliveryReady } from "./local-inbox-handoff.js";
+/**
+ * Persists and replays delivery rows for projection subscribers.
+ */
+export declare class LocalProjectionInbox implements ProjectionInbox {
+    #private;
+    /**
+     * Creates a local projection inbox.
+     * @param contextName Names the bounded context that owns this inbox.
+     * @param readiness Coordinates delivery readiness after persistence.
+     * @param keepTenant Records a tenant before its message is persisted.
+     */
+    constructor(contextName: string, readiness?: DeliveryReadiness | OnDeliveryReady, keepTenant?: (tenantId: TenantId) => Promise<void>);
+    /**
+     * Registers a target that replays projection messages.
+     * @param target Handles messages for one projection type.
+     */
+    register(target: ProjectionInboxTarget): void;
+    /**
+     * Lists endpoints registered for projection delivery.
+     * @returns Returns immutable endpoint descriptions.
+     */
+    endpoints(): readonly DeliveryEndpoint[];
+    /**
+     * Dispatches a durable inbox row through its projection target.
+     * @param message Contains the persisted inbox row to replay.
+     * @param deliveryTenantId Identifies the tenant that owns the row when present.
+     * @returns A promise that resolves after the inbox row is replayed.
+     */
+    replay(message: InboxMessage, deliveryTenantId?: TenantId): Promise<void>;
+    /**
+     * Persists and drains one projection inbox message.
+     * @param delivery Stores and drains the inbox row.
+     * @param input Describes the message to persist.
+     * @param deliveryTenantId Identifies the tenant that owns the message when present.
+     * @returns Resolves to the persisted inbox row.
+     */
+    receive(delivery: Delivery, input: ProjectionInput, deliveryTenantId?: TenantId): Promise<InboxMessage>;
+}
+type ProjectionInput = Parameters<ProjectionInbox["receive"]>[1];
+export {};
+//# sourceMappingURL=projection-handoff.d.ts.map

package/dist/context/projection-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-handoff.d.ts","sourceRoot":"","sources":["../../src/context/projection-handoff.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EACL,KAAK,gBAAgB,EACrB,iBAAiB,EAEjB,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAIlC;;GAEG;AACH,qBAAa,oBAAqB,YAAW,eAAe;;IAW1D;;;;;OAKG;gBAED,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,iBAAiB,GAAG,eAAyC,EACxE,UAAU,GAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAA2B;IAQ7E;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAc7C;;;OAGG;IACH,SAAS,IAAI,SAAS,gBAAgB,EAAE;IAIxC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,gBAAgB,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE;;;;;;OAMG;IACG,OAAO,CACX,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,eAAe,EACtB,gBAAgB,CAAC,EAAE,QAAQ,GAC1B,OAAO,CAAC,YAAY,CAAC;CAoHzB;AAED,KAAK,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}