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

package/dist/delivery/delivery.d.ts

@@ -0,0 +1,238 @@
+import { type WorkerId } from "@spine-event-engine/proto/delivery";
+import type { StorageContext, StorageFactory } from "@spine-event-engine/storage";
+import type { DeliveryControlledRun } from "./delivery-run-control.js";
+import { DeliveryMonitor } from "./delivery-monitor.js";
+import type { DeliveryInbox, DeliveryWorkRegistry } from "./delivery-ports.js";
+import { type InboxMessage } from "./inbox.js";
+import { ShardIndex } from "./shard-index.js";
+import type { DeliveryResult, DeliveryRunOptions, DeliveryStrategy } from "./delivery-builder.js";
+/**
+ * Describes an endpoint snapshot supplied for direct Inbox delivery.
+ */
+export type DeliveryEndpointMessage = InboxMessage;
+/**
+ * Dispatches one persisted Inbox message to an endpoint.
+ *
+ * @param message The message to dispatch.
+ * @returns A promise that settles when endpoint dispatch completes.
+ */
+export type OnDeliveryMessage = (message: DeliveryEndpointMessage) => void | Promise<void>;
+/**
+ * Reports one direct drain and whether it durably acknowledged the selected message.
+ *
+ * @internal
+ */
+export interface DeliveryDirectRun {
+    /**
+     * Contains the terminal shard-drain outcome.
+     */
+    readonly run: DeliveryRun;
+    /**
+     * Indicates whether this drain durably marked the selected message delivered.
+     */
+    readonly acknowledged: boolean;
+}
+/**
+ * Summarizes one finite direct delivery run.
+ */
+export interface DeliveryRun {
+    /**
+     * Identifies the terminal delivery outcome.
+     */
+    readonly status: "DRAINED" | "SKIPPED" | "FAILED" | "STOPPED";
+    /**
+     * Counts messages considered for dispatch.
+     */
+    readonly processed: number;
+    /**
+     * Counts messages admitted to the endpoint.
+     */
+    readonly accepted: number;
+    /**
+     * Counts messages durably acknowledged as delivered.
+     */
+    readonly delivered: number;
+    /**
+     * Counts dispatch or acknowledgement failures.
+     */
+    readonly failed: number;
+    /**
+     * Lists ephemeral delivery failures.
+     */
+    readonly failures: readonly DeliveryFailure[];
+}
+/**
+ * Describes ephemeral delivery failure evidence that is never persisted.
+ */
+export interface DeliveryFailure {
+    /**
+     * Identifies the message associated with the failure.
+     */
+    readonly message: InboxMessage;
+    /**
+     * Supplies the observed failure.
+     */
+    readonly error: unknown;
+}
+/**
+ * Executes direct Inbox delivery for one complete worker identity.
+ */
+export declare class Delivery {
+    #private;
+    /**
+     * Identifies the immutable storage namespace.
+     */
+    readonly context: StorageContext;
+    /**
+     * Supplies durable record storage.
+     */
+    readonly storageFactory: StorageFactory;
+    /**
+     * Maps targets to delivery shards.
+     */
+    readonly strategy: DeliveryStrategy;
+    /**
+     * Identifies this worker's opaque durable ownership identity.
+     */
+    readonly worker: WorkerId;
+    /**
+     * Names the worker node for compatibility integrations.
+     */
+    readonly node: string;
+    /**
+     * Bounds each direct Inbox read.
+     */
+    readonly pageSize: number;
+    /**
+     * Reads and acknowledges direct Inbox rows.
+     */
+    readonly inbox: DeliveryInbox;
+    /**
+     * Acquires and releases direct shard ownership.
+     */
+    readonly shards: DeliveryWorkRegistry;
+    /**
+     * Creates direct delivery from immutable options.
+     *
+     * @param options The delivery configuration.
+     */
+    constructor(options: DeliveryOptions);
+    /**
+     * Executes one finite shard delivery.
+     *
+     * @param options The selected shard and endpoint callback.
+     * @returns The terminal public delivery result.
+     */
+    run(options: DeliveryRunOptions): Promise<DeliveryResult>;
+    /**
+     * Executes one finite shard delivery under an operation signal.
+     *
+     * @param options The controlled shard, endpoint, and cancellation signal.
+     * @returns The terminal public delivery result.
+     */
+    runControlled(options: DeliveryControlledRun): Promise<DeliveryResult>;
+    /**
+     * Delivers the selected message's shard for local handoff integration.
+     *
+     * @param message The message selecting the shard to drain.
+     * @param input The endpoint callback or callback configuration.
+     * @returns The terminal direct-delivery result.
+     */
+    drainMessage(message: InboxMessage, input: OnDeliveryMessage | {
+        readonly node?: string;
+        readonly onMessage: OnDeliveryMessage;
+        /**
+         * Observes a durable delivered transition.
+         *
+         * @param message Contains the acknowledged Inbox message.
+         * @internal
+         */
+        readonly onDelivered?: (message: InboxMessage) => void;
+        /**
+         * Selects messages owned by this direct callback.
+         *
+         * @param message Contains a pending Inbox message.
+         * @returns `true` when the callback owns the message.
+         * @internal
+         */
+        readonly acceptMessage?: (message: InboxMessage) => boolean;
+    }): Promise<DeliveryDirectRun>;
+    /**
+     * Executes one owned shard drain while containing monitor and endpoint failures.
+     *
+     * @param shard The shard to acquire and drain.
+     * @param options The endpoint and optional operation signal.
+     * @returns The terminal direct-delivery result.
+     */
+    drain(shard: ShardIndex, options: DeliveryDrainOptions): Promise<DeliveryRun>;
+}
+/**
+ * Configures one direct delivery owner.
+ */
+export interface DeliveryOptions {
+    /**
+     * Identifies the storage namespace.
+     */
+    readonly context: StorageContext;
+    /**
+     * Supplies durable record storage.
+     */
+    readonly storageFactory: StorageFactory;
+    /**
+     * Supplies direct shard ownership when customized.
+     */
+    readonly workRegistry?: DeliveryWorkRegistry;
+    /**
+     * Supplies direct Inbox access when customized.
+     */
+    readonly inbox?: DeliveryInbox;
+    /**
+     * Maps targets to shards when customized.
+     */
+    readonly strategy?: DeliveryStrategy;
+    /**
+     * Supplies delivery lifecycle and failure policy hooks.
+     */
+    readonly monitor?: DeliveryMonitor;
+    /**
+     * Supplies a complete opaque worker identity.
+     */
+    readonly worker?: WorkerId;
+    /**
+     * Names the node used to derive a default worker identity.
+     */
+    readonly node?: string;
+    /**
+     * Bounds each direct Inbox read.
+     */
+    readonly pageSize?: number;
+}
+/**
+ * Configures one direct shard drain.
+ */
+export interface DeliveryDrainOptions {
+    /**
+     * Dispatches supported Inbox messages.
+     */
+    readonly onMessage: OnDeliveryMessage;
+    /**
+     * Observes a durable delivered transition.
+     *
+     * @param message Contains the acknowledged Inbox message.
+     * @internal
+     */
+    readonly onDelivered?: (message: InboxMessage) => void;
+    /**
+     * Determines whether this drain callback owns a message.
+     *
+     * @param message Contains a pending Inbox message.
+     * @returns `true` when the callback owns the message.
+     * @internal
+     */
+    readonly acceptMessage?: (message: InboxMessage) => boolean;
+    /**
+     * Propagates cancellation through the drain.
+     */
+    readonly operation?: import("./delivery-ports.js").DeliveryOperationOptions;
+}
+//# sourceMappingURL=delivery.d.ts.map

package/dist/delivery/delivery.d.ts.map

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

package/dist/delivery/delivery.js

@@ -0,0 +1,400 @@
+/*
+ * 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, create } from "@bufbuild/protobuf";
+import { AnySchema } from "@bufbuild/protobuf/wkt";
+import { randomUUID } from "node:crypto";
+import { WorkerIdSchema } from "@spine-event-engine/proto/delivery";
+import { AlreadyPickedUp, DeliveryMonitor, FailedPickUp, FailedReception, } from "./delivery-monitor.js";
+import { Inbox, InboxTargets } from "./inbox.js";
+import { InboxStorage } from "./inbox-storage.js";
+import { ShardIndex } from "./shard-index.js";
+import { ShardedWorkRegistry } from "./sharded-work-registry.js";
+import { withDeliveryCommitFence } from "../repository/commit-fence.js";
+/**
+ * Executes direct Inbox delivery for one complete worker identity.
+ */
+export class Delivery {
+    // prettier-ignore
+    /**
+     * Identifies the immutable storage namespace.
+     */
+    context;
+    /**
+     * Supplies durable record storage.
+     */
+    storageFactory;
+    /**
+     * Maps targets to delivery shards.
+     */
+    strategy;
+    /**
+     * Identifies this worker's opaque durable ownership identity.
+     */
+    worker;
+    /**
+     * Names the worker node for compatibility integrations.
+     */
+    node;
+    /**
+     * Bounds each direct Inbox read.
+     */
+    pageSize;
+    /**
+     * Reads and acknowledges direct Inbox rows.
+     */
+    inbox;
+    /**
+     * Acquires and releases direct shard ownership.
+     */
+    shards;
+    #monitor;
+    /**
+     * Creates direct delivery from immutable options.
+     *
+     * @param options The delivery configuration.
+     */
+    constructor(options) {
+        if (options.worker !== undefined &&
+            options.node !== undefined &&
+            options.worker.nodeId?.value !== options.node) {
+            throw new Error("Delivery worker node must match the configured delivery node.");
+        }
+        this.context = Object.freeze({ ...options.context });
+        this.storageFactory = options.storageFactory;
+        this.strategy = options.strategy ?? { shardCount: 1, shardFor: () => ShardIndex.single() };
+        this.worker =
+            options.worker === undefined
+                ? workerId(options.node ?? "local")
+                : snapshotWorker(options.worker);
+        this.node = this.worker.nodeId?.value ?? "local";
+        this.pageSize = options.pageSize ?? 100;
+        this.inbox =
+            options.inbox ??
+                new Inbox(new InboxStorage({ context: this.context, storageFactory: this.storageFactory }));
+        this.shards =
+            options.workRegistry ??
+                new ShardedWorkRegistry({ context: this.context, storageFactory: this.storageFactory });
+        this.#monitor = options.monitor ?? new DeliveryMonitor();
+        Object.freeze(this);
+    }
+    /**
+     * Executes one finite shard delivery.
+     *
+     * @param options The selected shard and endpoint callback.
+     * @returns The terminal public delivery result.
+     */
+    async run(options) {
+        const shard = options.shard ?? ShardIndex.single();
+        const run = await this.drain(shard, { onMessage: options.onMessage });
+        return Object.freeze({
+            status: run.status === "SKIPPED"
+                ? "SKIPPED"
+                : run.status === "FAILED"
+                    ? "FAILED"
+                    : run.status === "STOPPED"
+                        ? "STOPPED"
+                        : "COMPLETED",
+        });
+    }
+    /**
+     * Executes one finite shard delivery under an operation signal.
+     *
+     * @param options The controlled shard, endpoint, and cancellation signal.
+     * @returns The terminal public delivery result.
+     */
+    runControlled(options) {
+        const shard = options.shard;
+        return this.drain(shard, {
+            onMessage: options.onMessage,
+            ...(options.acceptMessage === undefined ? {} : { acceptMessage: options.acceptMessage }),
+            operation: { signal: options.signal },
+        }).then((run) => Object.freeze({
+            status: run.status === "SKIPPED"
+                ? "SKIPPED"
+                : run.status === "FAILED"
+                    ? "FAILED"
+                    : run.status === "STOPPED"
+                        ? "STOPPED"
+                        : "COMPLETED",
+        }));
+    }
+    /**
+     * Delivers the selected message's shard for local handoff integration.
+     *
+     * @param message The message selecting the shard to drain.
+     * @param input The endpoint callback or callback configuration.
+     * @returns The terminal direct-delivery result.
+     */
+    async drainMessage(message, input) {
+        const onMessage = typeof input === "function" ? input : input.onMessage;
+        const observeDelivered = typeof input === "function" ? undefined : input.onDelivered;
+        let acknowledged = false;
+        const run = await this.drain(message.shard, {
+            onMessage,
+            ...(typeof input === "function" || input.acceptMessage === undefined
+                ? {}
+                : { acceptMessage: input.acceptMessage }),
+            onDelivered: (next) => {
+                acknowledged ||=
+                    next.id.value === message.id.value && next.id.shard.key() === message.id.shard.key();
+                observeDelivered?.(next);
+            },
+        });
+        return Object.freeze({ run, acknowledged });
+    }
+    /**
+     * Executes one owned shard drain while containing monitor and endpoint failures.
+     *
+     * @param shard The shard to acquire and drain.
+     * @param options The endpoint and optional operation signal.
+     * @returns The terminal direct-delivery result.
+     */
+    async drain(shard, options) {
+        if (options.operation?.signal?.aborted)
+            return result("STOPPED");
+        let session;
+        try {
+            session = await this.shards.pickUp(shard, this.worker, options.operation);
+        }
+        catch (error) {
+            await safely(async () => (await this.#monitor.onShardPickUpFailure(new FailedPickUp(shard, error))).execute());
+            return result("FAILED");
+        }
+        if (session === undefined) {
+            await safely(async () => (await this.#monitor.onShardAlreadyPicked(new AlreadyPickedUp(shard))).execute());
+            return result("SKIPPED");
+        }
+        if (options.operation?.signal?.aborted) {
+            const released = await safelyValue(() => this.shards.release(session), false);
+            return result(released ? "STOPPED" : "FAILED");
+        }
+        const statistics = counts();
+        const failures = [];
+        const complete = (status, value = statistics, runFailures = failures) => result(status, value, runFailures);
+        let current = session;
+        const ownership = { lost: false };
+        const validate = async () => {
+            const validated = await safelyValue(() => this.shards.validateOwnership(current, options.operation), undefined);
+            if (validated === undefined) {
+                ownership.lost = true;
+                return false;
+            }
+            current = validated;
+            return true;
+        };
+        const cleanupPage = async () => {
+            if (this.inbox.removeDelivered === undefined)
+                return true;
+            if (!(await validate()))
+                return false;
+            let after;
+            for (let page = 0; page < 2; page += 1) {
+                let removedAny = false;
+                const delivered = await this.inbox.read(shard, {
+                    statuses: ["DELIVERED"],
+                    limit: this.pageSize,
+                    ...(after === undefined ? {} : { after }),
+                    ...(options.operation ?? {}),
+                });
+                for (const message of delivered) {
+                    if (options.operation?.signal?.aborted || !(await validate()))
+                        return false;
+                    const removed = await this.inbox.removeDelivered(message, current, options.operation);
+                    if (options.operation?.signal?.aborted || (!removed && !(await validate())))
+                        return false;
+                    removedAny ||= removed;
+                }
+                const last = delivered.at(-1);
+                if (removedAny || last === undefined || delivered.length < this.pageSize)
+                    break;
+                after = {
+                    messageId: last.id.value,
+                    whenReceived: last.whenReceived,
+                    version: last.version,
+                };
+            }
+            return true;
+        };
+        const dispatch = (message) => withDeliveryCommitFence(async () => {
+            if (!(await validate()))
+                throw new Error("Shard ownership was lost.");
+        }, () => Promise.resolve(options.onMessage(message)));
+        const markDelivered = async (message) => {
+            if ((await this.inbox.markDelivered(message, options.operation)) === undefined)
+                throw new Error("Inbox message was not marked delivered.");
+            statistics.delivered += 1;
+            options.onDelivered?.(message);
+        };
+        try {
+            if (!(await safelyBoolean(() => this.#monitor.shouldContinueAfter("DELIVERY"))))
+                return complete("STOPPED");
+            if (!(await safely(() => this.#monitor.onDeliveryStarted(shard))))
+                return complete("STOPPED");
+            const blockedTargets = new Set();
+            let after;
+            for (;;) {
+                const messages = await this.inbox.read(shard, {
+                    statuses: ["TO_DELIVER"],
+                    limit: this.pageSize,
+                    ...(after === undefined ? {} : { after }),
+                    ...(options.operation ?? {}),
+                });
+                if (messages.length === 0) {
+                    if (!(await cleanupPage()))
+                        return complete("STOPPED");
+                    break;
+                }
+                const deliveredBefore = statistics.delivered;
+                for (const message of messages) {
+                    if (options.operation?.signal?.aborted)
+                        return complete("STOPPED");
+                    if (!isEndpointMessage(message))
+                        continue;
+                    if (options.acceptMessage !== undefined && !options.acceptMessage(message))
+                        continue;
+                    const target = `${message.inboxId.targetTypeUrl}:${InboxTargets.key(message.inboxId.targetId)}`;
+                    if (blockedTargets.has(target))
+                        continue;
+                    statistics.processed += 1;
+                    if (!(await safelyBoolean(() => this.#monitor.shouldContinueAfter("PAGE"))))
+                        return complete("STOPPED");
+                    if (!(await validate()))
+                        return complete("STOPPED");
+                    try {
+                        statistics.accepted += 1;
+                        await dispatch(message);
+                        if (options.operation?.signal?.aborted)
+                            return complete("STOPPED");
+                        if (!(await validate()))
+                            return complete("STOPPED");
+                        await markDelivered(message);
+                    }
+                    catch (error) {
+                        statistics.failed += 1;
+                        failures.push(Object.freeze({ message: snapshot(message), error }));
+                        const reception = new FailedReception(message, error, async () => {
+                            if (!(await validate()))
+                                throw new Error("Shard ownership was lost.");
+                            await markDelivered(message);
+                        }, async () => {
+                            await dispatch(message);
+                            if (!(await validate()))
+                                throw new Error("Shard ownership was lost.");
+                            await markDelivered(message);
+                        });
+                        const action = await safelyValue(() => this.#monitor.onReceptionFailure(reception), reception.markDelivered());
+                        if (!(await safely(() => action.execute())) &&
+                            !(await safely(() => reception.markDelivered().execute()))) {
+                            blockedTargets.add(target);
+                        }
+                        if (ownership.lost)
+                            return complete("STOPPED");
+                    }
+                }
+                if (!(await cleanupPage()))
+                    return complete("STOPPED");
+                const last = messages.at(-1);
+                if (statistics.delivered !== deliveredBefore) {
+                    after = undefined;
+                    continue;
+                }
+                if (last === undefined || messages.length < this.pageSize)
+                    break;
+                after = {
+                    messageId: last.id.value,
+                    whenReceived: last.whenReceived,
+                    version: last.version,
+                };
+                // Reached a full page without progress: continue past it once. A later
+                // independent target may still be actionable; exhaustion ends the run.
+            }
+            return complete("DRAINED");
+        }
+        finally {
+            const released = await safelyValue(() => this.shards.release(current, options.operation), false);
+            if (!released) {
+                // The release result changes the terminal delivery outcome: a shard is
+                // not complete until ownership is confirmed released.
+                // eslint-disable-next-line no-unsafe-finally
+                return complete("FAILED");
+            }
+            await safely(() => this.#monitor.onDeliveryCompleted(Object.freeze({
+                processed: statistics.processed,
+                delivered: statistics.delivered,
+                failed: statistics.failed,
+            })));
+        }
+    }
+}
+function workerId(node) {
+    return create(WorkerIdSchema, { nodeId: { value: node }, value: randomUUID() });
+}
+function snapshotWorker(worker) {
+    return Object.freeze({
+        nodeId: Object.freeze({ value: worker.nodeId?.value ?? "" }),
+        value: worker.value,
+    });
+}
+function counts() {
+    return { processed: 0, accepted: 0, delivered: 0, failed: 0 };
+}
+function result(status, value = counts(), failures = []) {
+    const run = Object.freeze({ status, ...value, failures: Object.freeze([...failures]) });
+    return run;
+}
+function snapshot(message) {
+    return Object.freeze({
+        ...message,
+        id: Object.freeze({
+            ...message.id,
+            shard: new ShardIndex(message.id.shard.index, message.id.shard.ofTotal),
+        }),
+        inboxId: Object.freeze({ ...message.inboxId }),
+        ...(message.signal === undefined ? {} : { signal: clone(AnySchema, message.signal) }),
+        shard: new ShardIndex(message.shard.index, message.shard.ofTotal),
+        whenReceived: new Date(message.whenReceived),
+        ...(message.keepUntil === undefined ? {} : { keepUntil: new Date(message.keepUntil) }),
+    });
+}
+async function safely(action) {
+    try {
+        await action();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function safelyBoolean(action) {
+    try {
+        return await action();
+    }
+    catch {
+        return false;
+    }
+}
+async function safelyValue(action, fallback) {
+    try {
+        return await action();
+    }
+    catch {
+        return fallback;
+    }
+}
+function isEndpointMessage(message) {
+    return (message.label === "HANDLE_COMMAND" ||
+        message.label === "UPDATE_SUBSCRIBER" ||
+        message.label === "REACT_UPON_EVENT");
+}
+//# sourceMappingURL=delivery.js.map

package/dist/delivery/delivery.js.map

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