@spine-event-engine/delivery-server 2.0.0-snapshot.10

package/dist/core/inbox-service.js

@@ -0,0 +1,212 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { create, toBinary, } from "@bufbuild/protobuf";
+import { Code, ConnectError } from "@connectrpc/connect";
+import { CommandSchema, EventSchema } from "@spine-event-engine/proto";
+import { InboxService, OptionalInboxMessageSchema, PageOfMessagesSchema, } from "@spine-event-engine/proto/delivery-server";
+import { InboxLabel, InboxMessageSchema, InboxMessageStatus, } from "@spine-event-engine/proto/delivery";
+import { InMemoryDeliveryState } from "./in-memory-delivery-state.js";
+import { MAX_DELIVERY_BATCH_MESSAGES, MAX_DELIVERY_RPC_BYTES, MAX_INBOX_PAYLOAD_BYTES, MAX_INBOX_RECORD_BYTES, } from "./limits.js";
+import { MutationAdmission } from "./mutation-admission.js";
+import { DeliveryMessages, DeliveryShards } from "./wire-values.js";
+/**
+ * Provides Inbox RPC handler implementations.
+ */
+export const InboxHandlers = Object.freeze({
+    create: (state, admission, onMessageTransition) => ({
+        writeOne: async (request, context) => {
+            const message = InboxMessages.required(request.message);
+            await admission.run(context.signal, () => {
+                for (const inserted of state.putAll([message]))
+                    onMessageTransition?.(InboxShards.required(inserted.id?.index), 1);
+            });
+            return {};
+        },
+        writeMany: async (request, context) => {
+            const shard = InboxShards.required(request.shard);
+            InboxMessages.requiredBatchLength(request.message.length);
+            const messages = request.message.map(InboxMessages.required);
+            InboxShards.ensure(messages.map((value) => value.message), shard);
+            await admission.run(context.signal, () => {
+                for (const inserted of state.putAll(messages))
+                    onMessageTransition?.(InboxShards.required(inserted.id?.index), 1);
+            });
+            return {};
+        },
+        removeOne: async (request, context) => {
+            const message = InboxMessages.required(request.message);
+            await admission.run(context.signal, () => {
+                if (state.delete(message.message))
+                    onMessageTransition?.(InboxShards.required(message.message.id?.index), -1);
+            });
+            return {};
+        },
+        removeMany: async (request, context) => {
+            const shard = InboxShards.required(request.shard);
+            InboxMessages.requiredBatchLength(request.message.length);
+            const messages = request.message.map(InboxMessages.required);
+            InboxShards.ensure(messages.map((value) => value.message), shard);
+            await admission.run(context.signal, () => {
+                for (const message of messages)
+                    if (state.delete(message.message))
+                        onMessageTransition?.(InboxShards.required(message.message.id?.index), -1);
+            });
+            return {};
+        },
+        findOne: (request) => {
+            if (request.index === undefined || request.uuid.trim().length === 0)
+                throw InboxResponses.invalid("Delivery message identity is missing.");
+            InboxShards.required(request.index);
+            const message = state.messages.get(`${DeliveryShards.key(request.index)}:${request.uuid}`);
+            return InboxResponses.bounded(OptionalInboxMessageSchema, message === undefined ? {} : { message: DeliveryMessages.copy(message) });
+        },
+        findManyInShard: (request) => {
+            const shard = InboxShards.required(request.shard);
+            if (!Number.isInteger(request.pageSize) || request.pageSize < 1 || request.pageSize > 1_000)
+                throw InboxResponses.invalid("Delivery page size must be between 1 and 1000.");
+            if (request.sinceWhen !== undefined && !InboxTime.valid(request.sinceWhen))
+                throw InboxResponses.invalid("Delivery page timestamp is invalid.");
+            const message = [...state.messages.values()]
+                .filter((value) => value.id?.index !== undefined &&
+                DeliveryShards.key(value.id.index) === DeliveryShards.key(shard))
+                .filter((value) => request.sinceWhen === undefined || InboxTime.compare(value, request.sinceWhen) > 0)
+                .sort(InboxMessages.compare)
+                .slice(0, request.pageSize)
+                .map(DeliveryMessages.copy);
+            return InboxResponses.bounded(PageOfMessagesSchema, { message }, "Delivery page exceeds the 4 MiB response limit; request a smaller page.");
+        },
+        newestMessageToDeliver: (shard) => {
+            const key = DeliveryShards.key(InboxShards.required(shard));
+            const newest = [...state.messages.values()]
+                .filter((value) => value.id?.index !== undefined &&
+                DeliveryShards.key(value.id.index) === key &&
+                value.status === InboxMessageStatus.TO_DELIVER)
+                .sort(InboxMessages.compare)
+                .at(-1);
+            return InboxResponses.bounded(OptionalInboxMessageSchema, newest === undefined ? {} : { message: DeliveryMessages.copy(newest) });
+        },
+    }),
+});
+/**
+ * Validates Inbox messages and preserves their delivery ordering.
+ */
+const InboxMessages = Object.freeze({
+    required: (message) => {
+        if (message?.id?.index === undefined || message.inboxId?.entityId?.id === undefined)
+            throw InboxResponses.invalid("Delivery message identity is incomplete.");
+        if (message.signalId === undefined || message.whenReceived === undefined)
+            throw InboxResponses.invalid("Delivery message fields are incomplete.");
+        if (message.id.uuid.trim().length === 0 ||
+            message.signalId.value.trim().length === 0 ||
+            message.inboxId.typeUrl.trim().length === 0 ||
+            message.inboxId.entityId.id.typeUrl.trim().length === 0 ||
+            !InboxShards.valid(message.id.index) ||
+            !InboxTime.valid(message.whenReceived) ||
+            (message.keepUntil !== undefined && !InboxTime.valid(message.keepUntil)) ||
+            !Number.isSafeInteger(message.version) ||
+            message.version < 0) {
+            throw InboxResponses.invalid("Delivery message is incomplete.");
+        }
+        if (!InboxMessages.validPayload(message))
+            throw InboxResponses.invalid("Delivery message payload is invalid.");
+        if (!InboxMessages.validLabel(message.label) || !InboxMessages.validStatus(message.status))
+            throw InboxResponses.invalid("Delivery message enum is invalid.");
+        const bytes = toBinary(InboxMessageSchema, message).byteLength;
+        if (bytes > MAX_INBOX_RECORD_BYTES)
+            throw InboxResponses.invalid("Delivery message record is too large.");
+        return { message: DeliveryMessages.copy(message), bytes };
+    },
+    requiredBatchLength: (length) => {
+        if (length < 1 || length > MAX_DELIVERY_BATCH_MESSAGES)
+            throw InboxResponses.invalid("Delivery message batch is invalid.");
+    },
+    compare: (left, right) => {
+        const received = InboxTime.compare(left, right.whenReceived);
+        if (received !== 0)
+            return received;
+        const version = left.version - right.version;
+        if (version !== 0)
+            return version;
+        return (left.id?.uuid ?? "").localeCompare(right.id?.uuid ?? "");
+    },
+    validPayload: (message) => {
+        const payload = message.payload;
+        if (payload.case !== "command" && payload.case !== "event")
+            return false;
+        const schema = payload.case === "command" ? CommandSchema : EventSchema;
+        return (toBinary(schema, payload.value, { writeUnknownFields: false }).byteLength <=
+            MAX_INBOX_PAYLOAD_BYTES);
+    },
+    validLabel: (label) => label === InboxLabel.HANDLE_COMMAND ||
+        label === InboxLabel.UPDATE_SUBSCRIBER ||
+        label === InboxLabel.REACT_UPON_EVENT ||
+        label === InboxLabel.CATCH_UP,
+    validStatus: (status) => status === InboxMessageStatus.TO_DELIVER ||
+        status === InboxMessageStatus.SCHEDULED ||
+        status === InboxMessageStatus.DELIVERED ||
+        status === InboxMessageStatus.TO_CATCH_UP,
+});
+/**
+ * Validates Inbox shard identities and batch consistency.
+ */
+const InboxShards = Object.freeze({
+    required: (shard) => {
+        if (shard === undefined || !InboxShards.valid(shard))
+            throw InboxResponses.invalid("Delivery shard is invalid.");
+        return shard;
+    },
+    valid: (shard) => Number.isInteger(shard.index) &&
+        shard.index >= 0 &&
+        Number.isInteger(shard.ofTotal) &&
+        shard.ofTotal >= 1 &&
+        shard.index < shard.ofTotal,
+    ensure: (messages, shard) => {
+        for (const message of messages) {
+            if (message.id?.index === undefined ||
+                DeliveryShards.key(message.id.index) !== DeliveryShards.key(shard))
+                throw InboxResponses.invalid("Delivery batch spans shards.");
+        }
+    },
+});
+/**
+ * Validates and compares Inbox timestamps.
+ */
+const InboxTime = Object.freeze({
+    valid: (value) => value.seconds >= -62135596800n &&
+        value.seconds <= 253402300799n &&
+        Number.isInteger(value.nanos) &&
+        value.nanos >= 0 &&
+        value.nanos < 1_000_000_000,
+    compare: (left, right) => {
+        if (right === undefined || left.whenReceived === undefined)
+            throw new TypeError("Delivery message receive time is missing.");
+        if (left.whenReceived.seconds !== right.seconds)
+            return left.whenReceived.seconds < right.seconds ? -1 : 1;
+        return left.whenReceived.nanos - right.nanos;
+    },
+});
+/**
+ * Bounds Inbox responses and creates RPC errors.
+ */
+const InboxResponses = Object.freeze({
+    bounded: (schema, initializer, errorMessage = "Delivery response exceeds the 4 MiB limit.") => {
+        const response = create(schema, initializer);
+        if (toBinary(schema, response).byteLength > MAX_DELIVERY_RPC_BYTES)
+            throw InboxResponses.exhausted(errorMessage);
+        return response;
+    },
+    invalid: (message) => new ConnectError(message, Code.InvalidArgument),
+    exhausted: (message) => new ConnectError(message, Code.ResourceExhausted),
+});
+//# sourceMappingURL=inbox-service.js.map

package/dist/core/inbox-service.js.map

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

package/dist/core/limits.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Delivery-server resource limits. They deliberately remain well below the
+ * 4 MiB delivery RPC ceiling, so one bounded shard response can be encoded.
+ */
+export interface DeliveryStateLimits {
+    /**
+     * Limits retained messages.
+     */
+    readonly maxRetainedMessages: number;
+    /**
+     * Limits retained serialized bytes.
+     */
+    readonly maxRetainedBytes: number;
+    /**
+     * Limits tracked shards.
+     */
+    readonly maxTrackedShards: number;
+}
+/**
+ * Limits encoded delivery RPC bytes.
+ */
+export declare const MAX_DELIVERY_RPC_BYTES = 4194304;
+/**
+ * Limits messages accepted in one batch.
+ */
+export declare const MAX_DELIVERY_BATCH_MESSAGES = 100;
+/**
+ * Limits encoded Inbox payload bytes.
+ */
+export declare const MAX_INBOX_PAYLOAD_BYTES = 1048576;
+/**
+ * Leaves room for the optional/page response wrapper below the RPC ceiling.
+ */
+export declare const MAX_INBOX_RECORD_BYTES: number;
+/**
+ * Limits shards in a delivery response.
+ */
+export declare const MAX_DELIVERY_RESPONSE_SHARDS = 1000;
+/**
+ * Keeps one bounded 1,000-session expiration response below the 4 MiB RPC ceiling.
+ */
+export declare const MAX_DELIVERY_WORKER_BYTES = 128;
+/**
+ * Limits generic delivery integer values.
+ */
+export declare const MAX_DELIVERY_LIMIT = 2147483647;
+/**
+ * Provides default retained-state bounds.
+ */
+export declare const DEFAULT_DELIVERY_STATE_LIMITS: DeliveryStateLimits;
+/**
+ * Provides delivery limit validation.
+ */
+export declare const DeliveryLimits: Readonly<{
+    /**
+     * Resolves and validates retained-state limits.
+     *
+     * @param options Overrides default retained-state bounds.
+     * @returns Provides frozen validated limits.
+     */
+    resolve(options?: Partial<DeliveryStateLimits>): DeliveryStateLimits;
+    require(value: number, maximum: number, name: string): void;
+}>;
+//# sourceMappingURL=limits.d.ts.map

package/dist/core/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/core/limits.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAGlC;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,UAAY,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,uBAAuB,UAAY,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAoC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,kBAAkB,aAAgB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAI1C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC;IAGpC;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,CAAC;IACrE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7D,CAyBC,CAAC"}

package/dist/core/limits.js

@@ -0,0 +1,73 @@
+/*
+ * 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.
+ */
+/**
+ * Limits encoded delivery RPC bytes.
+ */
+export const MAX_DELIVERY_RPC_BYTES = 4_194_304;
+/**
+ * Limits messages accepted in one batch.
+ */
+export const MAX_DELIVERY_BATCH_MESSAGES = 100;
+/**
+ * Limits encoded Inbox payload bytes.
+ */
+export const MAX_INBOX_PAYLOAD_BYTES = 1_048_576;
+/**
+ * Leaves room for the optional/page response wrapper below the RPC ceiling.
+ */
+export const MAX_INBOX_RECORD_BYTES = MAX_DELIVERY_RPC_BYTES - 64;
+/**
+ * Limits shards in a delivery response.
+ */
+export const MAX_DELIVERY_RESPONSE_SHARDS = 1_000;
+/**
+ * Keeps one bounded 1,000-session expiration response below the 4 MiB RPC ceiling.
+ */
+export const MAX_DELIVERY_WORKER_BYTES = 128;
+/**
+ * Limits generic delivery integer values.
+ */
+export const MAX_DELIVERY_LIMIT = 2_147_483_647;
+/**
+ * Provides default retained-state bounds.
+ */
+export const DEFAULT_DELIVERY_STATE_LIMITS = Object.freeze({
+    maxRetainedMessages: 10_000,
+    maxRetainedBytes: 32 * 1_024 * 1_024,
+    maxTrackedShards: MAX_DELIVERY_RESPONSE_SHARDS,
+});
+/**
+ * Provides delivery limit validation.
+ */
+export const DeliveryLimits = Object.freeze({
+    resolve(options = {}) {
+        const limits = {
+            maxRetainedMessages: options.maxRetainedMessages ?? DEFAULT_DELIVERY_STATE_LIMITS.maxRetainedMessages,
+            maxRetainedBytes: options.maxRetainedBytes ?? DEFAULT_DELIVERY_STATE_LIMITS.maxRetainedBytes,
+            maxTrackedShards: options.maxTrackedShards ?? DEFAULT_DELIVERY_STATE_LIMITS.maxTrackedShards,
+        };
+        DeliveryLimits.require(limits.maxRetainedMessages, MAX_DELIVERY_LIMIT, "maxRetainedMessages");
+        DeliveryLimits.require(limits.maxRetainedBytes, MAX_DELIVERY_LIMIT, "maxRetainedBytes");
+        DeliveryLimits.require(limits.maxTrackedShards, MAX_DELIVERY_RESPONSE_SHARDS, "maxTrackedShards");
+        return Object.freeze(limits);
+    },
+    /**
+     * Requires a bounded positive integer limit.
+     */
+    require(value, maximum, name) {
+        if (!Number.isSafeInteger(value) || value < 1 || value > maximum)
+            throw new RangeError(`Delivery server ${name} is invalid.`);
+    },
+});
+//# sourceMappingURL=limits.js.map

package/dist/core/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/core/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAyBH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAW,sBAAsB,GAAG,EAAE,CAAC;AAE1E;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB,MAAM,CAAC,MAAM,CAAC;IAC9E,mBAAmB,EAAE,MAAM;IAC3B,gBAAgB,EAAE,EAAE,GAAG,KAAK,GAAG,KAAK;IACpC,gBAAgB,EAAE,4BAA4B;CAC/C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAWtB,MAAM,CAAC,MAAM,CAAC;IACjB,OAAO,CAAC,UAAwC,EAAE;QAChD,MAAM,MAAM,GAAG;YACb,mBAAmB,EACjB,OAAO,CAAC,mBAAmB,IAAI,6BAA6B,CAAC,mBAAmB;YAClF,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,6BAA6B,CAAC,gBAAgB;YAC5F,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,6BAA6B,CAAC,gBAAgB;SAC7F,CAAC;QACF,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;QAC9F,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QACxF,cAAc,CAAC,OAAO,CACpB,MAAM,CAAC,gBAAgB,EACvB,4BAA4B,EAC5B,kBAAkB,CACnB,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAa,EAAE,OAAe,EAAE,IAAY;QAClD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,OAAO;YAC9D,MAAM,IAAI,UAAU,CAAC,mBAAmB,IAAI,cAAc,CAAC,CAAC;IAChE,CAAC;CACF,CAAC,CAAC"}

package/dist/core/mutation-admission.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A finite FIFO boundary for all state-changing delivery operations.
+ */
+export declare class MutationAdmission {
+    #private;
+    /**
+     * Closes admission and rejects pending mutations.
+     */
+    close(): void;
+    /**
+     * Queues one synchronous state mutation.
+     * @param signal Cancels admission before commit.
+     * @param commit Performs the linearized mutation.
+     * @returns Resolves with the committed value.
+     */
+    run<T>(signal: AbortSignal | undefined, commit: () => T): Promise<T>;
+}
+//# sourceMappingURL=mutation-admission.d.ts.map

package/dist/core/mutation-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-admission.d.ts","sourceRoot":"","sources":["../../src/core/mutation-admission.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,qBAAa,iBAAiB;;IAK5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAwCrE"}

package/dist/core/mutation-admission.js

@@ -0,0 +1,78 @@
+/*
+ * 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 { Code, ConnectError } from "@connectrpc/connect";
+/**
+ * A finite FIFO boundary for all state-changing delivery operations.
+ */
+export class MutationAdmission {
+    #pending = [];
+    #scheduled = false;
+    #closed = false;
+    /**
+     * Closes admission and rejects pending mutations.
+     */
+    close() {
+        this.#closed = true;
+        const error = new ConnectError("Delivery server is closed.", Code.Unavailable);
+        for (const pending of this.#pending)
+            pending.reject(error);
+        this.#pending = [];
+    }
+    /**
+     * Queues one synchronous state mutation.
+     * @param signal Cancels admission before commit.
+     * @param commit Performs the linearized mutation.
+     * @returns Resolves with the committed value.
+     */
+    run(signal, commit) {
+        if (this.#closed)
+            return Promise.reject(new ConnectError("Delivery server is closed.", Code.Unavailable));
+        if (signal?.aborted)
+            return Promise.reject(this.#abortError(signal));
+        if (this.#pending.length >= 100)
+            return Promise.reject(new ConnectError("Delivery mutation queue is full.", Code.ResourceExhausted));
+        return new Promise((resolve, reject) => {
+            const admission = () => {
+                if (signal?.aborted) {
+                    reject(this.#abortError(signal));
+                    return;
+                }
+                try {
+                    resolve(commit());
+                }
+                catch (error) {
+                    reject(error instanceof Error ? error : new Error("Delivery mutation failed."));
+                }
+            };
+            this.#pending.push({ admit: admission, reject });
+            if (!this.#scheduled) {
+                this.#scheduled = true;
+                queueMicrotask(() => {
+                    this.#flush();
+                });
+            }
+        });
+    }
+    #flush() {
+        this.#scheduled = false;
+        const pending = this.#pending;
+        this.#pending = [];
+        for (const admission of pending)
+            admission.admit();
+    }
+    #abortError(signal) {
+        return signal.reason instanceof Error ? signal.reason : new Error("Delivery mutation aborted.");
+    }
+}
+//# sourceMappingURL=mutation-admission.js.map

package/dist/core/mutation-admission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-admission.js","sourceRoot":"","sources":["../../src/core/mutation-admission.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC5B,QAAQ,GAA8E,EAAE,CAAC;IACzF,UAAU,GAAG,KAAK,CAAC;IACnB,OAAO,GAAG,KAAK,CAAC;IAEhB;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,4BAA4B,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/E,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAI,MAA+B,EAAE,MAAe;QACrD,IAAI,IAAI,CAAC,OAAO;YACd,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,4BAA4B,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1F,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QACrE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG;YAC7B,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,YAAY,CAAC,kCAAkC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAC7E,CAAC;QACJ,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,SAAS,GAAG,GAAG,EAAE;gBACrB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;oBACjC,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC;oBACH,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACpB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC;gBAClF,CAAC;YACH,CAAC,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gBACvB,cAAc,CAAC,GAAG,EAAE;oBAClB,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,KAAK,MAAM,SAAS,IAAI,OAAO;YAAE,SAAS,CAAC,KAAK,EAAE,CAAC;IACrD,CAAC;IAED,WAAW,CAAC,MAAmB;QAC7B,OAAO,MAAM,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAClG,CAAC;CACF"}

package/dist/core/shard-service.d.ts

@@ -0,0 +1,22 @@
+import { type ServiceImpl } from "@connectrpc/connect";
+import { ShardService } from "@spine-event-engine/proto/delivery-server";
+import type { ShardIndex } from "@spine-event-engine/proto/delivery";
+import { InMemoryDeliveryState } from "./in-memory-delivery-state.js";
+import { MutationAdmission } from "./mutation-admission.js";
+/**
+ * Provides Shard RPC handler implementations.
+ */
+export declare const ShardHandlers: Readonly<{
+    /**
+     * Creates Shard RPC handlers.
+     *
+     * @param state Stores the Shard sessions served by the handlers.
+     * @param admission Controls mutation admission and cancellation.
+     * @param now Supplies the current millisecond time.
+     * @param processingTimeoutMs Holds the automatic processing timeout.
+     * @param onTransition Observes picked and released shard transitions.
+     * @returns The Shard service implementation.
+     */
+    create: (state: InMemoryDeliveryState, admission: MutationAdmission, now: () => number, processingTimeoutMs: number, onTransition?: (shard: ShardIndex) => void) => ServiceImpl<typeof ShardService>;
+}>;
+//# sourceMappingURL=shard-service.d.ts.map

package/dist/core/shard-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shard-service.d.ts","sourceRoot":"","sources":["../../src/core/shard-service.ts"],"names":[],"mappings":"AAeA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAML,YAAY,EACb,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,oCAAoC,CAAC;AAE/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC;IAGnC;;;;;;;;;OASG;IACH,MAAM,EAAE,CACN,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,iBAAiB,EAC5B,GAAG,EAAE,MAAM,MAAM,EACjB,mBAAmB,EAAE,MAAM,EAC3B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,KACvC,WAAW,CAAC,OAAO,YAAY,CAAC,CAAC;CACvC,CA6GC,CAAC"}