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

package/dist/delivery/delivery-builder.js

@@ -0,0 +1,323 @@
+/*
+ * 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 { ServerEnvironment } from "../server/server-environment.js";
+import { Delivery as CoreDelivery } from "./delivery.js";
+import { DeliveryMonitor } from "./delivery-monitor.js";
+import { InboxTargets } from "./inbox.js";
+import { ShardIndex } from "./shard-index.js";
+import { ShardedWorkRegistry, shardedWorkRegistryAccess } from "./sharded-work-registry.js";
+const defaultContext = Object.freeze({
+    name: "__System_Delivery__",
+    multitenant: false,
+});
+const defaultPageSize = 100;
+const controlledDeliveryRunners = new WeakMap();
+/**
+ * Exposes package-local controls for builder-created deliveries.
+ */
+export const deliveryControls = Object.freeze({
+    // prettier-ignore
+    /**
+     * Finds controlled execution for a builder-created delivery.
+     */
+    runner(delivery) {
+        return controlledDeliveryRunners.get(delivery);
+    },
+});
+/**
+ * Places every target in one local shard.
+ */
+export class UniformAcrossAllShards {
+    static #single = new UniformAcrossAllShards(1);
+    /**
+     * Returns a strategy with the requested positive number of shards.
+     *
+     * @param shards The number of addressable shards.
+     * @returns A uniform shard strategy.
+     */
+    static forNumber(shards) {
+        return new UniformAcrossAllShards(shards);
+    }
+    /**
+     * Returns the shared single-shard strategy.
+     *
+     * @returns The shared single-shard strategy.
+     */
+    static singleShard() {
+        return this.#single;
+    }
+    /**
+     * Number of uniformly distributed shards.
+     */
+    shardCount;
+    constructor(shards) {
+        if (!Number.isSafeInteger(shards) || shards <= 0) {
+            throw new Error("Delivery shard count must be a positive safe integer.");
+        }
+        this.shardCount = shards;
+        Object.freeze(this);
+    }
+    /**
+     * Determines a stable shard from a target identity.
+     *
+     * @param targetId The target identity.
+     * @param targetType The target type URL.
+     * @returns The stable shard for the target.
+     */
+    shardFor(targetId, targetType) {
+        if (typeof targetId.typeUrl !== "string" || targetId.typeUrl.length === 0) {
+            throw new Error("Delivery target ID must be a non-default Any.");
+        }
+        if (typeof targetType !== "string" || targetType.length === 0) {
+            throw new Error("Delivery target type must be a non-empty string.");
+        }
+        return new ShardIndex(DeliveryValues.hash(`${targetType}:${InboxTargets.shardKey(targetId)}`) % this.shardCount, this.shardCount);
+    }
+}
+export { DeliveryMonitor } from "./delivery-monitor.js";
+/**
+ * Configures and snapshots one public {@link Delivery}.
+ */
+export class DeliveryBuilder {
+    #context;
+    #storageFactory;
+    #workRegistry;
+    #inbox;
+    #strategy;
+    #monitor;
+    #pageSize;
+    #node;
+    #worker;
+    /**
+     * Sets the storage namespace for Inbox and shard records.
+     *
+     * @param context The delivery storage namespace.
+     * @returns This builder.
+     */
+    withContext(context) {
+        this.#context = DeliveryValues.snapshotContext(context);
+        return this;
+    }
+    /**
+     * Sets the storage factory.
+     *
+     * @param storageFactory The durable storage factory.
+     * @returns This builder.
+     */
+    withStorageFactory(storageFactory) {
+        this.#storageFactory = storageFactory;
+        return this;
+    }
+    /**
+     * Sets the registry used for exclusive shard pickup.
+     *
+     * @param workRegistry The shard work registry.
+     * @returns This builder.
+     */
+    withWorkRegistry(workRegistry) {
+        this.#workRegistry = workRegistry;
+        return this;
+    }
+    /**
+     * Sets an inbox port instead of the local durable inbox default.
+     *
+     * @param inbox The inbox port.
+     * @returns This builder.
+     */
+    withInbox(inbox) {
+        this.#inbox = inbox;
+        return this;
+    }
+    /**
+     * Sets the target-to-shard strategy.
+     *
+     * @param strategy The target strategy.
+     * @returns This builder.
+     */
+    withStrategy(strategy) {
+        this.#strategy = DeliveryValues.requireStrategy(strategy);
+        return this;
+    }
+    /**
+     * Sets finite-run observation and cancellation.
+     *
+     * @param monitor The run monitor.
+     * @returns This builder.
+     */
+    withMonitor(monitor) {
+        this.#monitor = monitor;
+        return this;
+    }
+    /**
+     * Sets the positive accepted-work bound for one page.
+     *
+     * @param pageSize The positive page size.
+     * @returns This builder.
+     */
+    withPageSize(pageSize) {
+        this.#pageSize = DeliveryValues.requireBound("Delivery page size", pageSize, 1_000);
+        return this;
+    }
+    /**
+     * Sets the node identity used for shard pickup.
+     *
+     * @param node The non-empty node identity.
+     * @returns This builder.
+     */
+    withNode(node) {
+        if (typeof node !== "string" || node.length === 0) {
+            throw new Error("Delivery node must be a non-empty string.");
+        }
+        if (this.#worker?.nodeId?.value !== undefined && this.#worker.nodeId.value !== node) {
+            throw new Error("Delivery node must match the configured worker node.");
+        }
+        this.#node = node;
+        return this;
+    }
+    /**
+     * Sets the complete opaque worker identity used for shard ownership.
+     *
+     * @param worker The generated worker identity for this delivery lifetime.
+     * @returns This builder.
+     */
+    withWorker(worker) {
+        if (worker.nodeId === undefined ||
+            worker.nodeId.value.trim() === "" ||
+            worker.value.trim() === "") {
+            throw new Error("Delivery worker must contain non-blank node and value.");
+        }
+        if (this.#node !== undefined && this.#node !== worker.nodeId.value) {
+            throw new Error("Delivery worker node must match the configured delivery node.");
+        }
+        this.#worker = DeliveryValues.snapshotWorker(worker);
+        return this;
+    }
+    /**
+     * Creates one immutable delivery from the current builder configuration.
+     *
+     * @returns The configured delivery.
+     */
+    build() {
+        const context = this.#context ?? defaultContext;
+        const strategy = DeliveryValues.snapshotStrategy(this.#strategy ?? UniformAcrossAllShards.singleShard());
+        let storageFactory = this.#storageFactory;
+        let node = this.#node;
+        if (storageFactory === undefined || node === undefined) {
+            const environment = ServerEnvironment.instance();
+            storageFactory ??= environment.storageFactory;
+            node ??= this.#worker?.nodeId?.value ?? environment.nodeId;
+        }
+        if (this.#workRegistry instanceof ShardedWorkRegistry &&
+            !shardedWorkRegistryAccess.matches(this.#workRegistry, context, storageFactory)) {
+            throw new Error("Delivery work registry must use the delivery storage context and factory.");
+        }
+        const workRegistry = this.#workRegistry ?? new ShardedWorkRegistry({ context, storageFactory });
+        const inboxSessionKind = this.#inbox?.sessionKind ?? "LEASED";
+        if (inboxSessionKind !== workRegistry.sessionKind)
+            throw new Error("Delivery inbox and work registry session kinds must match.");
+        const core = new CoreDelivery({
+            context,
+            storageFactory,
+            workRegistry,
+            ...(this.#inbox === undefined ? {} : { inbox: this.#inbox }),
+            strategy,
+            ...(this.#monitor === undefined ? {} : { monitor: this.#monitor }),
+            pageSize: this.#pageSize ?? defaultPageSize,
+            node,
+            ...(this.#worker === undefined ? {} : { worker: this.#worker }),
+        });
+        return new BuiltDelivery(core);
+    }
+}
+class BuiltDelivery {
+    context;
+    storageFactory;
+    strategy;
+    node;
+    worker;
+    pageSize;
+    inbox;
+    #core;
+    constructor(core) {
+        this.#core = core;
+        this.context = core.context;
+        this.storageFactory = core.storageFactory;
+        this.strategy = core.strategy;
+        this.node = core.node;
+        this.worker = core.worker;
+        this.pageSize = core.pageSize;
+        this.inbox = core.inbox;
+        controlledDeliveryRunners.set(this, (options) => core.runControlled(options));
+        Object.freeze(this);
+    }
+    run(options) {
+        return this.#core.run(options);
+    }
+}
+/**
+ * Groups immutable delivery configuration operations.
+ */
+const DeliveryValues = Object.freeze({
+    requireStrategy(strategy) {
+        if (!Number.isSafeInteger(strategy.shardCount) || strategy.shardCount <= 0) {
+            throw new Error("Delivery strategy shard count must be a positive safe integer.");
+        }
+        return strategy;
+    },
+    snapshotStrategy(strategy) {
+        const shardCount = this.requireStrategy(strategy).shardCount;
+        return Object.freeze({
+            shardCount,
+            shardFor(targetId, targetType) {
+                const shard = strategy.shardFor(InboxTargets.clone(targetId), targetType);
+                if (shard.ofTotal !== shardCount) {
+                    throw new Error("Delivery strategy shard total must equal its resolved shard count.");
+                }
+                return shard;
+            },
+        });
+    },
+    hash(value) {
+        let result = 0;
+        for (const character of value) {
+            result = (result * 31 + character.charCodeAt(0)) >>> 0;
+        }
+        return result;
+    },
+    requireBound(name, value, max) {
+        if (!Number.isSafeInteger(value) || value <= 0) {
+            throw new Error(`${name} must be a positive safe integer.`);
+        }
+        if (value > max) {
+            throw new Error(`${name} must be at most ${String(max)}.`);
+        }
+        return value;
+    },
+    snapshotContext(context) {
+        if (typeof context.name !== "string" || context.name.length === 0) {
+            throw new Error("Delivery storage context name must be a non-empty string.");
+        }
+        return Object.freeze({ ...context });
+    },
+    snapshotWorker(worker) {
+        const nodeId = worker.nodeId;
+        if (nodeId === undefined)
+            throw new Error("Delivery worker must include a node identifier.");
+        return Object.freeze({
+            nodeId: Object.freeze({ value: nodeId.value }),
+            value: worker.value,
+        });
+    },
+});
+//# sourceMappingURL=delivery-builder.js.map

package/dist/delivery/delivery-builder.js.map

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

package/dist/delivery/delivery-lease.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Smallest supported worker and shard lease duration in milliseconds.
+ */
+export declare const minDeliveryLeaseMs = 1000;
+/**
+ * Largest supported worker and shard lease duration in milliseconds.
+ */
+export declare const maxDeliveryLeaseMs = 2147483647;
+/**
+ * Validates delivery and shard lease durations.
+ */
+export declare const DeliveryLeases: Readonly<{
+    requireMs(owner: "Delivery" | "ShardedWorkRegistry", value: unknown): number;
+}>;
+//# sourceMappingURL=delivery-lease.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-lease.d.ts","sourceRoot":"","sources":["../../src/delivery/delivery-lease.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,kBAAkB,aAAgB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC;IACpC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,qBAAqB,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9E,CAwBC,CAAC"}

package/dist/delivery/delivery-lease.js

@@ -0,0 +1,44 @@
+/*
+ * 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.
+ */
+/**
+ * Smallest supported worker and shard lease duration in milliseconds.
+ */
+export const minDeliveryLeaseMs = 1_000;
+/**
+ * Largest supported worker and shard lease duration in milliseconds.
+ */
+export const maxDeliveryLeaseMs = 2_147_483_647;
+/**
+ * Validates delivery and shard lease durations.
+ */
+export const DeliveryLeases = Object.freeze({
+    // prettier-ignore
+    /**
+     * Validates one delivery or shard lease duration.
+     *
+     * @param owner Names the component that owns the lease.
+     * @param value Supplies the requested lease duration.
+     * @returns The validated lease duration in milliseconds.
+     */
+    requireMs(owner, value) {
+        if (!Number.isSafeInteger(value) || value < minDeliveryLeaseMs) {
+            throw new Error(`${owner} leaseMs must be a positive safe integer at least ${String(minDeliveryLeaseMs)}.`);
+        }
+        if (value > maxDeliveryLeaseMs) {
+            throw new Error(`${owner} leaseMs must be a positive safe integer at most ${String(maxDeliveryLeaseMs)}.`);
+        }
+        return value;
+    },
+});
+//# sourceMappingURL=delivery-lease.js.map

package/dist/delivery/delivery-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-lease.js","sourceRoot":"","sources":["../../src/delivery/delivery-lease.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAEtB,MAAM,CAAC,MAAM,CAAC;IACjB,kBAAkB;IAElB;;;;;;OAMG;IACH,SAAS,CAAC,KAAyC,EAAE,KAAc;QACjE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,GAAG,kBAAkB,EAAE,CAAC;YAC3E,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,qDAAqD,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAC3F,CAAC;QACJ,CAAC;QACD,IAAK,KAAgB,GAAG,kBAAkB,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,oDAAoD,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAC1F,CAAC;QACJ,CAAC;QAED,OAAO,KAAe,CAAC;IACzB,CAAC;CACF,CAAC,CAAC"}

package/dist/delivery/delivery-loop.d.ts

@@ -0,0 +1,113 @@
+import type { Delivery, OnDeliveryMessage } from "./delivery.js";
+import type { DeliveryOperationOptions } from "./delivery-ports.js";
+import { ShardIndex } from "./shard-index.js";
+/**
+ * Runs one finite direct delivery drain at a time.
+ */
+export declare class DeliveryLoop {
+    #private;
+    /**
+     * Creates a loop for one selected shard.
+     *
+     * @param options The immutable drain configuration.
+     */
+    constructor(options: DeliveryLoopOptions);
+    /**
+     * Stops admission of later loop runs.
+     */
+    stop(): void;
+    /**
+     * Stops the loop and waits for its active drain to settle.
+     *
+     * @returns A promise that settles after the active drain, if any.
+     */
+    close(): Promise<void>;
+    /**
+     * Executes one finite direct delivery drain.
+     *
+     * @returns The terminal loop result.
+     */
+    run(): Promise<DeliveryLoopRun>;
+    /**
+     * Returns the latest immutable loop progress.
+     *
+     * @returns The latest terminal progress.
+     */
+    progress(): DeliveryLoopProgress;
+}
+/**
+ * Configures one finite direct delivery loop.
+ */
+export interface DeliveryLoopOptions {
+    /**
+     * Supplies the direct delivery runtime.
+     */
+    readonly delivery: Delivery;
+    /**
+     * Selects the shard to drain.
+     */
+    readonly shard: ShardIndex;
+    /**
+     * Dispatches one supported Inbox message.
+     */
+    readonly onMessage: OnDeliveryMessage;
+    /**
+     * Propagates cancellation and deadline information.
+     */
+    readonly operation?: DeliveryOperationOptions;
+}
+/**
+ * Identifies the terminal state of a finite loop.
+ */
+export type DeliveryLoopStatus = "IDLE" | "SKIPPED" | "STOPPED" | "FAILED";
+/**
+ * Combines loop progress with its terminal state.
+ */
+export interface DeliveryLoopRun extends DeliveryLoopProgress {
+    /**
+     * Identifies why the loop ended.
+     */
+    readonly status: DeliveryLoopStatus;
+}
+/**
+ * Counts work observed by one finite loop.
+ */
+export interface DeliveryLoopProgress {
+    /**
+     * Counts finite drains started by the loop.
+     */
+    readonly runs: number;
+    /**
+     * Counts messages considered for dispatch.
+     */
+    readonly processed: number;
+    /**
+     * Counts messages whose endpoint callback ran.
+     */
+    readonly accepted: number;
+    /**
+     * Counts messages acknowledged as delivered.
+     */
+    readonly delivered: number;
+    /**
+     * Counts dispatch or acknowledgement failures.
+     */
+    readonly failed: number;
+    /**
+     * Lists retained ephemeral failure facts.
+     */
+    readonly failures: readonly import("./delivery.js").DeliveryFailure[];
+}
+/**
+ * Exposes package-local loop progress for retained integrations.
+ */
+export declare const deliveryLoopAccess: Readonly<{
+    /**
+     * Returns the current progress for one loop.
+     *
+     * @param loop The loop to inspect.
+     * @returns The loop's immutable progress.
+     */
+    progress(loop: DeliveryLoop): DeliveryLoopProgress;
+}>;
+//# sourceMappingURL=delivery-loop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-loop.d.ts","sourceRoot":"","sources":["../../src/delivery/delivery-loop.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAe,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,qBAAa,YAAY;;IAMvB;;;;OAIG;gBACS,OAAO,EAAE,mBAAmB;IAWxC;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;OAIG;IACH,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;IAiB/B;;;;OAIG;IACH,QAAQ,IAAI,oBAAoB;CAmBjC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAGlC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,wBAAwB,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAG3D;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAGnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,eAAe,EAAE,eAAe,EAAE,CAAC;CACvE;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC;IAGxC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,oBAAoB,CAAC;CACpD,CAIC,CAAC"}

package/dist/delivery/delivery-loop.js

@@ -0,0 +1,119 @@
+/*
+ * 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 { ShardIndex } from "./shard-index.js";
+/**
+ * Runs one finite direct delivery drain at a time.
+ */
+export class DeliveryLoop {
+    #options;
+    #stopped = false;
+    #progress = empty();
+    #running;
+    /**
+     * Creates a loop for one selected shard.
+     *
+     * @param options The immutable drain configuration.
+     */
+    constructor(options) {
+        this.#options = Object.freeze({
+            delivery: options.delivery,
+            shard: new ShardIndex(options.shard.index, options.shard.ofTotal),
+            onMessage: options.onMessage,
+            ...(options.operation === undefined
+                ? {}
+                : { operation: Object.freeze({ ...options.operation }) }),
+        });
+    }
+    /**
+     * Stops admission of later loop runs.
+     */
+    stop() {
+        this.#stopped = true;
+    }
+    /**
+     * Stops the loop and waits for its active drain to settle.
+     *
+     * @returns A promise that settles after the active drain, if any.
+     */
+    async close() {
+        this.stop();
+        await this.#running;
+    }
+    /**
+     * Executes one finite direct delivery drain.
+     *
+     * @returns The terminal loop result.
+     */
+    run() {
+        if (this.#running !== undefined)
+            return Promise.reject(new Error("DeliveryLoop is already running."));
+        if (this.#stopped)
+            return Promise.resolve(this.#stoppedRun());
+        const running = this.#options.delivery
+            .drain(this.#options.shard, {
+            onMessage: this.#options.onMessage,
+            ...(this.#options.operation === undefined ? {} : { operation: this.#options.operation }),
+        })
+            .then((run) => this.#finish(map(run.status), run))
+            .finally(() => {
+            this.#running = undefined;
+        });
+        this.#running = running;
+        return running;
+    }
+    /**
+     * Returns the latest immutable loop progress.
+     *
+     * @returns The latest terminal progress.
+     */
+    progress() {
+        return this.#progress;
+    }
+    #finish(status, run) {
+        this.#progress = Object.freeze({
+            runs: 1,
+            processed: run.processed,
+            accepted: run.accepted,
+            delivered: run.delivered,
+            failed: run.failed,
+            failures: run.failures,
+        });
+        return Object.freeze({ status, ...this.#progress });
+    }
+    #stoppedRun() {
+        return Object.freeze({ status: "STOPPED", ...this.#progress });
+    }
+}
+/**
+ * Exposes package-local loop progress for retained integrations.
+ */
+export const deliveryLoopAccess = Object.freeze({
+    progress(loop) {
+        return loop.progress();
+    },
+});
+function empty() {
+    return Object.freeze({
+        runs: 0,
+        processed: 0,
+        accepted: 0,
+        delivered: 0,
+        failed: 0,
+        failures: Object.freeze([]),
+    });
+}
+function map(status) {
+    return status === "DRAINED" ? "IDLE" : status;
+}
+//# sourceMappingURL=delivery-loop.js.map

package/dist/delivery/delivery-loop.js.map

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