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

package/dist/core/shard-service.js

@@ -0,0 +1,189 @@
+/*
+ * 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 } from "@bufbuild/protobuf";
+import { Code, ConnectError } from "@connectrpc/connect";
+import { ExpiredSessionSchema, ExpiredSessionsReleasedSchema, LiquorPickUpOutcomeSchema as PickUpOutcomeSchema, ShardAlreadyPickedUpSchema as AlreadyPickedUpSchema, ShardPickedUpSchema, ShardService, } from "@spine-event-engine/proto/delivery-server";
+import { InMemoryDeliveryState } from "./in-memory-delivery-state.js";
+import { MAX_DELIVERY_RESPONSE_SHARDS, MAX_DELIVERY_WORKER_BYTES } from "./limits.js";
+import { MutationAdmission } from "./mutation-admission.js";
+import { DeliveryShards, DeliveryWorkers } from "./wire-values.js";
+/**
+ * Provides Shard RPC handler implementations.
+ */
+export const ShardHandlers = Object.freeze({
+    create: (state, admission, now, processingTimeoutMs, onTransition) => ({
+        pickShard: async (request, context) => {
+            const shard = ShardInputs.requireShard(request.shard);
+            const worker = DeliveryWorkers.copy(ShardInputs.requireWorker(request.worker));
+            const pendingOnly = ShardInputs.pendingOnly(context.requestHeader);
+            return admission.run(context.signal, () => {
+                const pickedAt = ShardTime.current(now);
+                const current = state.session(shard);
+                const stale = current !== undefined &&
+                    processingTimeoutMs > 0 &&
+                    pickedAt - ShardInputs.requireWhenPicked(current) > processingTimeoutMs;
+                const refreshed = current !== undefined &&
+                    !stale &&
+                    ShardInputs.revalidating(context.requestHeader) &&
+                    ShardInputs.sameWorker(current.worker, worker);
+                if (current === undefined || stale || refreshed) {
+                    if (pendingOnly && !state.hasPending(shard))
+                        throw ShardErrors.noPendingWork();
+                    state.setSession(shard, worker, pickedAt);
+                    if (ShardInputs.revalidating(context.requestHeader))
+                        context.responseHeader.set("x-spine-delivery-revalidation", refreshed ? "refreshed" : "picked");
+                    if (pendingOnly)
+                        context.responseHeader.set("x-spine-delivery-outcome", "pending-acknowledged");
+                    onTransition?.(shard);
+                    return create(PickUpOutcomeSchema, {
+                        value: {
+                            case: "pickedUp",
+                            value: create(ShardPickedUpSchema, {
+                                shard: DeliveryShards.copy(shard),
+                                worker: DeliveryWorkers.copy(worker),
+                                whenPicked: ShardTime.timestamp(pickedAt),
+                            }),
+                        },
+                    });
+                }
+                if (pendingOnly)
+                    context.responseHeader.set("x-spine-delivery-outcome", "pending-acknowledged");
+                if (ShardInputs.revalidating(context.requestHeader))
+                    context.responseHeader.set("x-spine-delivery-revalidation", "lost");
+                return create(PickUpOutcomeSchema, {
+                    value: {
+                        case: "alreadyPickedUp",
+                        value: create(AlreadyPickedUpSchema, {
+                            worker: DeliveryWorkers.copy(ShardInputs.requireWorker(current.worker)),
+                            whenPicked: ShardTime.timestamp(ShardInputs.requireWhenPicked(current)),
+                        }),
+                    },
+                });
+            });
+        },
+        releaseSession: async (request, context) => {
+            const shard = ShardInputs.requireShard(request.shard);
+            const worker = ShardInputs.requireWorker(request.worker);
+            await admission.run(context.signal, () => {
+                const current = state.session(shard);
+                if (current !== undefined && ShardInputs.sameWorker(current.worker, worker)) {
+                    state.release(shard);
+                    onTransition?.(shard);
+                }
+            });
+            return {};
+        },
+        releaseSessions: async (request, context) => {
+            if (request.inactivityPeriod === undefined)
+                throw ShardErrors.invalid("Inactivity period is missing.");
+            if (!ShardInputs.validDuration(request.inactivityPeriod))
+                throw ShardErrors.invalid("Inactivity period is invalid.");
+            const period = Number(request.inactivityPeriod.seconds) * 1_000 +
+                Math.trunc(request.inactivityPeriod.nanos / 1_000_000);
+            if (!Number.isFinite(period) || period < 0)
+                throw ShardErrors.invalid("Inactivity period is invalid.");
+            return admission.run(context.signal, () => {
+                const releasedAt = ShardTime.current(now);
+                const released = [];
+                for (const record of state.shards.values()) {
+                    if (released.length === MAX_DELIVERY_RESPONSE_SHARDS)
+                        break;
+                    const session = state.session(record.shard);
+                    if (session !== undefined &&
+                        releasedAt - ShardInputs.requireWhenPicked(session) >= period) {
+                        state.release(record.shard);
+                        onTransition?.(record.shard);
+                        released.push(create(ExpiredSessionSchema, {
+                            shard: DeliveryShards.copy(session.shard),
+                            worker: DeliveryWorkers.copy(ShardInputs.requireWorker(session.worker)),
+                            whenPicked: ShardTime.timestamp(ShardInputs.requireWhenPicked(session)),
+                            whenReleased: ShardTime.timestamp(releasedAt),
+                        }));
+                    }
+                }
+                return create(ExpiredSessionsReleasedSchema, { shard: released });
+            });
+        },
+    }),
+});
+/**
+ * Validates Shard requests and converts their inputs.
+ */
+const ShardInputs = Object.freeze({
+    requireWhenPicked: (record) => {
+        if (record.whenLastPicked === undefined)
+            throw new TypeError("Delivery shard session is invalid.");
+        return record.whenLastPicked;
+    },
+    requireWorker: (worker) => {
+        if (worker?.nodeId === undefined ||
+            worker.value.trim().length === 0 ||
+            worker.nodeId.value.trim().length === 0 ||
+            ShardInputs.utf8Bytes(worker.value) + ShardInputs.utf8Bytes(worker.nodeId.value) >
+                MAX_DELIVERY_WORKER_BYTES) {
+            throw ShardErrors.invalid("Delivery worker is invalid.");
+        }
+        return worker;
+    },
+    sameWorker: (first, second) => first?.nodeId?.value === second.nodeId?.value && first?.value === second.value,
+    revalidating: (headers) => headers?.get("x-spine-delivery-revalidate") === "true",
+    requireShard: (shard) => {
+        if (shard === undefined ||
+            !Number.isInteger(shard.index) ||
+            shard.index < 0 ||
+            !Number.isInteger(shard.ofTotal) ||
+            shard.ofTotal < 1 ||
+            shard.index >= shard.ofTotal) {
+            throw ShardErrors.invalid("Delivery shard is invalid.");
+        }
+        return shard;
+    },
+    pendingOnly: (headers) => {
+        const mode = headers?.get("x-spine-delivery-pickup-mode");
+        if (mode === null || mode === undefined)
+            return false;
+        if (mode === "pending")
+            return true;
+        throw ShardErrors.invalid("Delivery pickup mode is invalid.");
+    },
+    validDuration: (value) => value.seconds >= 0n &&
+        value.seconds <= 315576000000n &&
+        Number.isInteger(value.nanos) &&
+        value.nanos >= 0 &&
+        value.nanos < 1_000_000_000,
+    utf8Bytes: (value) => new TextEncoder().encode(value).byteLength,
+});
+/**
+ * Validates Shard clocks and converts protobuf timestamps.
+ */
+const ShardTime = Object.freeze({
+    timestamp: (milliseconds) => {
+        const seconds = Math.floor(milliseconds / 1_000);
+        return { seconds: BigInt(seconds), nanos: (milliseconds - seconds * 1_000) * 1_000_000 };
+    },
+    current: (now) => {
+        const value = now();
+        if (!Number.isInteger(value) || value < -62_135_596_800_000 || value > 253_402_300_799_999)
+            throw new RangeError("Delivery clock returned an invalid millisecond value.");
+        return value;
+    },
+});
+/**
+ * Creates Shard RPC errors.
+ */
+const ShardErrors = Object.freeze({
+    invalid: (message) => new ConnectError(message, Code.InvalidArgument),
+    noPendingWork: () => new ConnectError("Delivery shard has no pending work.", Code.FailedPrecondition, new Headers([["x-spine-delivery-outcome", "no-pending-work"]])),
+});
+//# sourceMappingURL=shard-service.js.map

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

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

package/dist/core/wire-values.d.ts

@@ -0,0 +1,22 @@
+import { type InboxMessage, type ShardIndex, type WorkerId } from "@spine-event-engine/proto/delivery";
+/**
+ * Provides canonical detached delivery message values.
+ */
+export declare const DeliveryMessages: Readonly<{
+    key(message: InboxMessage): string;
+    copy(message: InboxMessage): InboxMessage;
+}>;
+/**
+ * Provides canonical detached delivery shard values.
+ */
+export declare const DeliveryShards: Readonly<{
+    key(shard: ShardIndex): string;
+    copy(shard: ShardIndex): ShardIndex;
+}>;
+/**
+ * Provides canonical detached delivery worker values.
+ */
+export declare const DeliveryWorkers: Readonly<{
+    copy(worker: WorkerId): WorkerId;
+}>;
+//# sourceMappingURL=wire-values.d.ts.map

package/dist/core/wire-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-values.d.ts","sourceRoot":"","sources":["../../src/core/wire-values.ts"],"names":[],"mappings":"AAeA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC;IACtC,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAAC;CAC3C,CAkBC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC;IACpC,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;CACrC,CAgBC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC;IAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAAE,CASzE,CAAC"}

package/dist/core/wire-values.js

@@ -0,0 +1,66 @@
+/*
+ * 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 } from "@bufbuild/protobuf";
+import { InboxMessageSchema, ShardIndexSchema, WorkerIdSchema, } from "@spine-event-engine/proto/delivery";
+/**
+ * Provides canonical detached delivery message values.
+ */
+export const DeliveryMessages = Object.freeze({
+    // prettier-ignore
+    /**
+     * Returns the stable key for a message identity.
+     */
+    key(message) {
+        if (message.id?.index === undefined)
+            throw new TypeError("Delivery message identity is missing.");
+        return `${DeliveryShards.key(message.id.index)}:${message.id.uuid}`;
+    },
+    /**
+     * Returns a detached message clone.
+     */
+    copy(message) {
+        return clone(InboxMessageSchema, message);
+    },
+});
+/**
+ * Provides canonical detached delivery shard values.
+ */
+export const DeliveryShards = Object.freeze({
+    // prettier-ignore
+    /**
+     * Returns the stable key for a shard.
+     */
+    key(shard) {
+        return `${String(shard.index)}/${String(shard.ofTotal)}`;
+    },
+    /**
+     * Returns a detached shard clone.
+     */
+    copy(shard) {
+        return clone(ShardIndexSchema, shard);
+    },
+});
+/**
+ * Provides canonical detached delivery worker values.
+ */
+export const DeliveryWorkers = Object.freeze({
+    // prettier-ignore
+    /**
+     * Returns a detached worker clone.
+     */
+    copy(worker) {
+        return clone(WorkerIdSchema, worker);
+    },
+});
+//# sourceMappingURL=wire-values.js.map

package/dist/core/wire-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-values.js","sourceRoot":"","sources":["../../src/core/wire-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GAIf,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAGxB,MAAM,CAAC,MAAM,CAAC;IACjB,kBAAkB;IAElB;;OAEG;IACH,GAAG,CAAC,OAAqB;QACvB,IAAI,OAAO,CAAC,EAAE,EAAE,KAAK,KAAK,SAAS;YACjC,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;QAC/D,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAqB;QACxB,OAAO,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAGtB,MAAM,CAAC,MAAM,CAAC;IACjB,kBAAkB;IAElB;;OAEG;IACH,GAAG,CAAC,KAAiB;QACnB,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAiB;QACpB,OAAO,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmD,MAAM,CAAC,MAAM,CAAC;IAC3F,kBAAkB;IAElB;;OAEG;IACH,IAAI,CAAC,MAAgB;QACnB,OAAO,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;CACF,CAAC,CAAC"}

package/dist/health/health-service.d.ts

@@ -0,0 +1,9 @@
+import { type ServiceImpl } from "@connectrpc/connect";
+import { Health } from "@spine-event-engine/proto/delivery-server";
+/**
+ * Provides Delivery health handler implementations.
+ */
+export declare const HealthHandlers: Readonly<{
+    create(serving: () => boolean): ServiceImpl<typeof Health>;
+}>;
+//# sourceMappingURL=health-service.d.ts.map

package/dist/health/health-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-service.d.ts","sourceRoot":"","sources":["../../src/health/health-service.ts"],"names":[],"mappings":"AAcA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EACL,MAAM,EAEP,MAAM,2CAA2C,CAAC;AAUnD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC;IACpC,MAAM,CAAC,OAAO,EAAE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,MAAM,CAAC,CAAC;CAC5D,CAsBC,CAAC"}

package/dist/health/health-service.js

@@ -0,0 +1,47 @@
+/*
+ * 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";
+import { Health, HealthCheckResponse_ServingStatus as ServingStatus, } from "@spine-event-engine/proto/delivery-server";
+const known = new Set([
+    "",
+    "grpc.health.v1.Health",
+    "spine.delivery.InboxService",
+    "spine.delivery.ShardService",
+    "spine.delivery.AdminService",
+]);
+/**
+ * Provides Delivery health handler implementations.
+ */
+export const HealthHandlers = Object.freeze({
+    // prettier-ignore
+    /**
+     * Creates health handlers.
+     *
+     * @param serving Reports whether the server accepts traffic.
+     * @returns Provides Connect health handlers.
+     */
+    create(serving) {
+        return {
+            check: (request) => ({
+                status: serving() && known.has(request.service)
+                    ? ServingStatus.SERVING
+                    : ServingStatus.NOT_SERVING,
+            }),
+            watch: () => {
+                throw new ConnectError("Delivery health watch is not implemented.", Code.Unimplemented);
+            },
+        };
+    },
+});
+//# sourceMappingURL=health-service.js.map

package/dist/health/health-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-service.js","sourceRoot":"","sources":["../../src/health/health-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EACL,MAAM,EACN,iCAAiC,IAAI,aAAa,GACnD,MAAM,2CAA2C,CAAC;AAEnD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC;IACpB,EAAE;IACF,uBAAuB;IACvB,6BAA6B;IAC7B,6BAA6B;IAC7B,6BAA6B;CAC9B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAEtB,MAAM,CAAC,MAAM,CAAC;IACjB,kBAAkB;IAElB;;;;;OAKG;IACH,MAAM,CAAC,OAAsB;QAC3B,OAAO;YACL,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACnB,MAAM,EACJ,OAAO,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;oBACrC,CAAC,CAAC,aAAa,CAAC,OAAO;oBACvB,CAAC,CAAC,aAAa,CAAC,WAAW;aAChC,CAAC;YACF,KAAK,EAAE,GAAG,EAAE;gBACV,MAAM,IAAI,YAAY,CAAC,2CAA2C,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1F,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { InMemoryDelivery, type DeliveryCore, type DeliveryCoreOptions, } from "./core/in-memory-delivery-core.js";
+export { DeliveryServer, type DeliveryServerOptions } from "./server/delivery-server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/*
+ * 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.
+ */
+export { InMemoryDelivery, } from "./core/in-memory-delivery-core.js";
+export { DeliveryServer } from "./server/delivery-server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,gBAAgB,GAGjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,cAAc,EAA8B,MAAM,6BAA6B,CAAC"}

package/dist/server/assembly.d.ts

@@ -0,0 +1,41 @@
+import type { ServiceImpl } from "@connectrpc/connect";
+import { AdminService, InboxService, ShardService } from "@spine-event-engine/proto/delivery-server";
+import type { DeliveryConfiguration } from "./config.js";
+/**
+ * Groups handlers and shutdown boundaries that share delivery runtime state.
+ */
+export interface DeliveryAssembly {
+    /**
+     * Provides Inbox handlers backed by the shared delivery state.
+     */
+    readonly inbox: ServiceImpl<typeof InboxService>;
+    /**
+     * Provides Shard handlers backed by the shared delivery state.
+     */
+    readonly shards: ServiceImpl<typeof ShardService>;
+    /**
+     * Provides Admin handlers backed by the shared delivery state.
+     */
+    readonly admin: ServiceImpl<typeof AdminService>;
+    /**
+     * Closes the shared mutation-admission boundary.
+     */
+    closeAdmission(): void;
+    /**
+     * Closes the shared Admin publisher.
+     */
+    closeAdmin(): void;
+}
+/**
+ * Provides assembly construction for the delivery RPC handlers.
+ */
+export declare const DeliveryAssembly: Readonly<{
+    /**
+     * Creates delivery handlers with one shared state and admission boundary.
+     *
+     * @param configuration Configures the shared state and shard timeout.
+     * @returns The assembled delivery handlers and shutdown boundaries.
+     */
+    create: (configuration?: Pick<DeliveryConfiguration, "processingTimeoutMs" | "maxRetainedMessages" | "maxRetainedBytes" | "maxTrackedShards">) => DeliveryAssembly;
+}>;
+//# sourceMappingURL=assembly.d.ts.map

package/dist/server/assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly.d.ts","sourceRoot":"","sources":["../../src/server/assembly.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACb,MAAM,2CAA2C,CAAC;AAQnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAG/B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,YAAY,CAAC,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,YAAY,CAAC,CAAC;IAElD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,YAAY,CAAC,CAAC;IAEjD;;OAEG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC;IAGtC;;;;;OAKG;IACH,MAAM,EAAE,CACN,aAAa,CAAC,EAAE,IAAI,CAClB,qBAAqB,EACrB,qBAAqB,GAAG,qBAAqB,GAAG,kBAAkB,GAAG,kBAAkB,CACxF,KACE,gBAAgB,CAAC;CACvB,CAmCC,CAAC"}

package/dist/server/assembly.js

@@ -0,0 +1,49 @@
+/*
+ * 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 { AdminService, InboxService, ShardService, } from "@spine-event-engine/proto/delivery-server";
+import { AdminPublisher } from "../admin/admin-service.js";
+import { InMemoryDeliveryState } from "../core/in-memory-delivery-state.js";
+import { InboxHandlers } from "../core/inbox-service.js";
+import { MutationAdmission } from "../core/mutation-admission.js";
+import { ShardHandlers } from "../core/shard-service.js";
+import { DEFAULT_DELIVERY_STATE_LIMITS } from "../core/limits.js";
+/**
+ * Provides assembly construction for the delivery RPC handlers.
+ */
+export const DeliveryAssembly = Object.freeze({
+    create: (configuration = {
+        processingTimeoutMs: 0,
+        ...DEFAULT_DELIVERY_STATE_LIMITS,
+    }) => {
+        const state = new InMemoryDeliveryState(configuration);
+        const admission = new MutationAdmission();
+        const admin = AdminPublisher.create(state);
+        return Object.freeze({
+            inbox: InboxHandlers.create(state, admission, (shard, delta) => {
+                admin.recordMessageTransition(shard, delta);
+            }),
+            shards: ShardHandlers.create(state, admission, Date.now, configuration.processingTimeoutMs, (shard) => {
+                admin.publish(shard);
+            }),
+            admin: admin.service,
+            closeAdmission: () => {
+                admission.close();
+            },
+            closeAdmin: () => {
+                admin.close();
+            },
+        });
+    },
+});
+//# sourceMappingURL=assembly.js.map

package/dist/server/assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly.js","sourceRoot":"","sources":["../../src/server/assembly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAmClE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAexB,MAAM,CAAC,MAAM,CAAC;IACjB,MAAM,EAAE,CACN,gBAGI;QACF,mBAAmB,EAAE,CAAC;QACtB,GAAG,6BAA6B;KACjC,EACiB,EAAE;QACpB,MAAM,KAAK,GAAG,IAAI,qBAAqB,CAAC,aAAa,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC7D,KAAK,CAAC,uBAAuB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9C,CAAC,CAAC;YACF,MAAM,EAAE,aAAa,CAAC,MAAM,CAC1B,KAAK,EACL,SAAS,EACT,IAAI,CAAC,GAAG,EACR,aAAa,CAAC,mBAAmB,EACjC,CAAC,KAAK,EAAE,EAAE;gBACR,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC,CACF;YACD,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,cAAc,EAAE,GAAG,EAAE;gBACnB,SAAS,CAAC,KAAK,EAAE,CAAC;YACpB,CAAC;YACD,UAAU,EAAE,GAAG,EAAE;gBACf,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/server/config.d.ts

@@ -0,0 +1,57 @@
+import { type DeliveryStateLimits } from "../core/limits.js";
+import type { DeliveryServerOptions } from "./delivery-server.js";
+/**
+ * Describes the resolved delivery listener and retained-state configuration.
+ */
+export interface DeliveryConfiguration extends DeliveryStateLimits {
+    /**
+     * Holds the validated listener host.
+     */
+    readonly host: string;
+    /**
+     * Holds the validated listener port.
+     */
+    readonly port: number;
+    /**
+     * Holds the maximum inbound RPC message size in bytes.
+     */
+    readonly maxInboundMessageBytes: number;
+    /**
+     * Holds the automatic Shard processing timeout in milliseconds.
+     */
+    readonly processingTimeoutMs: number;
+}
+/**
+ * Provides delivery listener configuration resolution.
+ */
+export declare const DeliveryConfig: Readonly<{
+    /**
+     * Resolves delivery configuration from explicit options, environment, and defaults.
+     *
+     * @param options Holds explicit delivery server options.
+     * @returns The frozen validated delivery configuration.
+     */
+    resolve: (options?: DeliveryServerOptions) => DeliveryConfiguration;
+    /**
+     * Resolves and validates a bounded numeric option.
+     *
+     * @param explicit Holds the explicit numeric override.
+     * @param environment Names the environment variable.
+     * @param fallback Holds the default value.
+     * @param minimum Holds the inclusive lower bound.
+     * @param maximum Holds the inclusive upper bound.
+     * @param name Describes the value in validation errors.
+     * @returns The resolved validated numeric value.
+     */
+    number: (explicit: number | undefined, environment: string, fallback: number, minimum: number, maximum: number, name: string) => number;
+    /**
+     * Parses an environment numeric option or returns its default.
+     *
+     * @param value Holds the environment value.
+     * @param fallback Holds the default value.
+     * @param name Describes the value in validation errors.
+     * @returns The parsed environment value or default.
+     */
+    environmentNumber: (value: string | undefined, fallback: number, name: string) => number;
+}>;
+//# sourceMappingURL=config.d.ts.map

package/dist/server/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"AAcA,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAGhE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC;IAGpC;;;;;OAKG;IACH,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,qBAAqB,KAAK,qBAAqB,CAAC;IAEpE;;;;;;;;;;OAUG;IACH,MAAM,EAAE,CACN,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,KACT,MAAM,CAAC;IAEZ;;;;;;;OAOG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1F,CA2EC,CAAC"}

package/dist/server/config.js

@@ -0,0 +1,52 @@
+/*
+ * 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 { DEFAULT_DELIVERY_STATE_LIMITS, MAX_DELIVERY_LIMIT, MAX_DELIVERY_RESPONSE_SHARDS, MAX_DELIVERY_RPC_BYTES, DeliveryLimits, } from "../core/limits.js";
+/**
+ * Provides delivery listener configuration resolution.
+ */
+export const DeliveryConfig = Object.freeze({
+    resolve: (options = {}) => {
+        const host = options.host ?? process.env.HOST ?? "127.0.0.1";
+        if (typeof host !== "string" || host.trim().length === 0)
+            throw new RangeError("Delivery server host is invalid.");
+        return Object.freeze({
+            host,
+            port: DeliveryConfig.number(options.port, "PORT", 8484, 0, 65_535, "port"),
+            maxInboundMessageBytes: DeliveryConfig.number(options.maxInboundMessageBytes, "MAX_INBOUND_MESSAGE_SIZE", MAX_DELIVERY_RPC_BYTES, 1, MAX_DELIVERY_LIMIT, "inbound message size"),
+            processingTimeoutMs: DeliveryConfig.number(options.processingTimeoutSeconds, "SHARD_PROCESSING_TIMEOUT", 0, 0, MAX_DELIVERY_LIMIT, "processing timeout") * 1_000,
+            ...DeliveryLimits.resolve({
+                maxRetainedMessages: DeliveryConfig.number(options.maxRetainedMessages, "MAX_RETAINED_MESSAGES", DEFAULT_DELIVERY_STATE_LIMITS.maxRetainedMessages, 1, MAX_DELIVERY_LIMIT, "retained message limit"),
+                maxRetainedBytes: DeliveryConfig.number(options.maxRetainedBytes, "MAX_RETAINED_BYTES", DEFAULT_DELIVERY_STATE_LIMITS.maxRetainedBytes, 1, MAX_DELIVERY_LIMIT, "retained byte limit"),
+                maxTrackedShards: DeliveryConfig.number(options.maxTrackedShards, "MAX_TRACKED_SHARDS", DEFAULT_DELIVERY_STATE_LIMITS.maxTrackedShards, 1, MAX_DELIVERY_RESPONSE_SHARDS, "tracked shard limit"),
+            }),
+        });
+    },
+    number: (explicit, environment, fallback, minimum, maximum, name) => {
+        const value = explicit ?? DeliveryConfig.environmentNumber(process.env[environment], fallback, name);
+        if (!Number.isInteger(value) || value < minimum || value > maximum)
+            throw new RangeError(`Delivery server ${name} is invalid.`);
+        return value;
+    },
+    environmentNumber: (value, fallback, name) => {
+        if (value === undefined || value === "")
+            return fallback;
+        if (!/^(?:0|[1-9][0-9]*)$/.test(value))
+            throw new RangeError(`Delivery server ${name} is invalid.`);
+        const number = Number(value);
+        if (!Number.isSafeInteger(number))
+            throw new RangeError(`Delivery server ${name} is invalid.`);
+        return number;
+    },
+});
+//# sourceMappingURL=config.js.map

package/dist/server/config.js.map

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

package/dist/server/delivery-server-log.d.ts

@@ -0,0 +1,11 @@
+import type { ILogLayer } from "loglayer";
+/**
+ * Records a contained delivery-listener error without changing listener failure semantics.
+ *
+ * @param logger Receives the contained record when supplied.
+ */
+export declare const deliveryServerLog: Readonly<{
+    error(logger: ILogLayer | undefined): void;
+    isPromiseLike(value: unknown): value is PromiseLike<unknown>;
+}>;
+//# sourceMappingURL=delivery-server-log.d.ts.map

package/dist/server/delivery-server-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-server-log.d.ts","sourceRoot":"","sources":["../../src/server/delivery-server-log.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC;IACvC,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IAC3C,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;CAC9D,CAyBC,CAAC"}