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

package/dist/server/delivery-server-log.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.
+ */
+/**
+ * Records a contained delivery-listener error without changing listener failure semantics.
+ *
+ * @param logger Receives the contained record when supplied.
+ */
+export const deliveryServerLog = Object.freeze({
+    error(logger) {
+        if (logger === undefined)
+            return;
+        try {
+            const record = logger.withMetadata({
+                operation: "delivery.listener.start",
+                reasonCode: "failed",
+            });
+            const emit = record.error.bind(record);
+            const emitted = emit("delivery.listener.start_failed");
+            if (deliveryServerLog.isPromiseLike(emitted))
+                void Promise.resolve(emitted).catch(() => undefined);
+        }
+        catch {
+            // Logging must not affect the containing runtime outcome.
+        }
+    },
+    isPromiseLike(value) {
+        return ((typeof value === "object" || typeof value === "function") &&
+            value !== null &&
+            "then" in value &&
+            typeof value.then === "function");
+    },
+});
+//# sourceMappingURL=delivery-server-log.js.map

package/dist/server/delivery-server-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-server-log.js","sourceRoot":"","sources":["../../src/server/delivery-server-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAGzB,MAAM,CAAC,MAAM,CAAC;IACjB,KAAK,CAAC,MAA6B;QACjC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;gBACjC,SAAS,EAAE,yBAAyB;gBACpC,UAAU,EAAE,QAAQ;aACrB,CAAC,CAAC;YACH,MAAM,IAAI,GAA+B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnE,MAAM,OAAO,GAAG,IAAI,CAAC,gCAAgC,CAAC,CAAC;YACvD,IAAI,iBAAiB,CAAC,aAAa,CAAC,OAAO,CAAC;gBAC1C,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;IACH,CAAC;IAED,aAAa,CAAC,KAAc;QAC1B,OAAO,CACL,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;YAC1D,KAAK,KAAK,IAAI;YACd,MAAM,IAAI,KAAK;YACf,OAAQ,KAA4B,CAAC,IAAI,KAAK,UAAU,CACzD,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,103 @@
+import type { ILogLayer } from "loglayer";
+/**
+ * Construction-time configuration for {@link DeliveryServer}.
+ */
+export interface DeliveryServerOptions {
+    /**
+     * Listener host. The explicit option overrides `HOST`; the default is the
+     * local-only address `127.0.0.1`. Blank values are rejected.
+     */
+    readonly host?: string;
+    /**
+     * Listener port. The explicit option overrides `PORT`; the default is `8484`.
+     * Accepts integers from `0` through `65535`; zero requests an ephemeral port.
+     */
+    readonly port?: number;
+    /**
+     * Maximum inbound RPC message size in bytes. The explicit option overrides
+     * `MAX_INBOUND_MESSAGE_SIZE`; the default is 4 MiB (`4_194_304`). Accepts
+     * positive integers through `2_147_483_647`.
+     */
+    readonly maxInboundMessageBytes?: number;
+    /**
+     * Automatic stale-pickup timeout in seconds. The explicit option overrides
+     * `SHARD_PROCESSING_TIMEOUT`; the default is zero (disabled). Accepts
+     * non-negative integers through `2_147_483_647`.
+     */
+    readonly processingTimeoutSeconds?: number;
+    /**
+     * Maximum retained Inbox records. The explicit option overrides
+     * `MAX_RETAINED_MESSAGES`; the default is `10_000`. Accepts integers from 1
+     * through `2_147_483_647`.
+     */
+    readonly maxRetainedMessages?: number;
+    /**
+     * Maximum serialized bytes retained across Inbox records. The explicit option
+     * overrides `MAX_RETAINED_BYTES`; the default is 32 MiB (`33_554_432`).
+     * Accepts integers from 1 through `2_147_483_647`.
+     */
+    readonly maxRetainedBytes?: number;
+    /**
+     * Maximum distinct shards retained by messages or pickup sessions. The
+     * explicit option overrides `MAX_TRACKED_SHARDS`; the default is `1_000`.
+     * Accepts integers from 1 through `1_000`.
+     */
+    readonly maxTrackedShards?: number;
+    /**
+     * Application-owned logger reserved for component-local records. The component
+     * does not retain or close the supplied logger.
+     */
+    readonly logger?: ILogLayer;
+}
+/**
+ * A small in-memory Connect listener for the frozen delivery simple-server API.
+ */
+export declare class DeliveryServer {
+    #private;
+    /**
+     * Configured listener host, resolved and validated during construction.
+     */
+    readonly host: string;
+    /**
+     * Creates a terminal-lifecycle server and resolves configuration exactly once.
+     *
+     * Invalid options or environment values fail synchronously before any listener
+     * is created or bound.
+     *
+     * @param options Holds explicit listener and retained-state options.
+     */
+    constructor(options?: DeliveryServerOptions);
+    /**
+     * Returns the configured port before startup or the bound port after a successful
+     * ephemeral (`0`) bind.
+     *
+     * @returns The configured or bound listener port.
+     */
+    get port(): number;
+    /**
+     * Returns the HTTP base URL of the running cleartext HTTP/2 listener.
+     *
+     * @returns The configured listener base URL.
+     * @throws If read before startup completes successfully.
+     */
+    get baseUrl(): string;
+    /**
+     * Starts the listener once.
+     *
+     * Concurrent and repeated calls share the same promise and listener. A failed
+     * or closed instance is terminal and cannot retry startup.
+     *
+     * @returns The shared startup promise.
+     */
+    start(): Promise<this>;
+    /**
+     * Closes ordered terminal resources once.
+     *
+     * Concurrent and repeated calls share one promise. Closing before startup
+     * prevents binding; closing during startup waits for reached-resource cleanup.
+     *
+     * @returns Completes after terminal resources close.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=delivery-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-server.d.ts","sourceRoot":"","sources":["../../src/server/delivery-server.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAc1C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAGpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEzC;;;;OAIG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAE3C;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,cAAc;;IAGzB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAYtB;;;;;;;OAOG;gBACS,OAAO,GAAE,qBAA0B;IAO/C;;;;;OAKG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,IAAI,OAAO,IAAI,MAAM,CAGpB;IAED;;;;;;;OAOG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB;;;;;;;OAOG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuGvB"}

package/dist/server/delivery-server.js

@@ -0,0 +1,201 @@
+/*
+ * 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 * as http2 from "node:http2";
+import { connectNodeAdapter } from "@connectrpc/connect-node";
+import { AdminService, Health, InboxService, ShardService, } from "@spine-event-engine/proto/delivery-server";
+import { HealthHandlers } from "../health/health-service.js";
+import { DeliveryAssembly } from "./assembly.js";
+import { DeliveryConfig } from "./config.js";
+import { DeliveryShutdown } from "./shutdown.js";
+import { deliveryServerLog } from "./delivery-server-log.js";
+/**
+ * A small in-memory Connect listener for the frozen delivery simple-server API.
+ */
+export class DeliveryServer {
+    // prettier-ignore
+    /**
+     * Configured listener host, resolved and validated during construction.
+     */
+    host;
+    #port;
+    #configuration;
+    #logger;
+    #server;
+    #start;
+    #close;
+    #started = false;
+    #serving = true;
+    #assembly;
+    #sessions = new Set();
+    /**
+     * Creates a terminal-lifecycle server and resolves configuration exactly once.
+     *
+     * Invalid options or environment values fail synchronously before any listener
+     * is created or bound.
+     *
+     * @param options Holds explicit listener and retained-state options.
+     */
+    constructor(options = {}) {
+        this.#configuration = DeliveryConfig.resolve(options);
+        this.host = this.#configuration.host;
+        this.#port = this.#configuration.port;
+        this.#logger = options.logger;
+    }
+    /**
+     * Returns the configured port before startup or the bound port after a successful
+     * ephemeral (`0`) bind.
+     *
+     * @returns The configured or bound listener port.
+     */
+    get port() {
+        return this.#port;
+    }
+    /**
+     * Returns the HTTP base URL of the running cleartext HTTP/2 listener.
+     *
+     * @returns The configured listener base URL.
+     * @throws If read before startup completes successfully.
+     */
+    get baseUrl() {
+        if (!this.#started)
+            throw new Error("Delivery server has not started.");
+        return `http://${this.host.includes(":") ? `[${this.host}]` : this.host}:${String(this.#port)}`;
+    }
+    /**
+     * Starts the listener once.
+     *
+     * Concurrent and repeated calls share the same promise and listener. A failed
+     * or closed instance is terminal and cannot retry startup.
+     *
+     * @returns The shared startup promise.
+     */
+    start() {
+        if (this.#close !== undefined)
+            return Promise.reject(new Error("Delivery server is closed."));
+        if (this.#start !== undefined)
+            return this.#start;
+        this.#start = this.#startOnce();
+        return this.#start;
+    }
+    /**
+     * Closes ordered terminal resources once.
+     *
+     * Concurrent and repeated calls share one promise. Closing before startup
+     * prevents binding; closing during startup waits for reached-resource cleanup.
+     *
+     * @returns Completes after terminal resources close.
+     */
+    close() {
+        if (this.#close !== undefined)
+            return this.#close;
+        this.#close = DeliveryShutdown.run({
+            markNotServing: () => {
+                this.#serving = false;
+            },
+            closeAdmission: () => {
+                this.#assembly?.closeAdmission();
+            },
+            closeAdmin: () => {
+                this.#assembly?.closeAdmin();
+            },
+            closeNetwork: async () => {
+                try {
+                    await this.#start;
+                    // spine-log-boundary: delivery_server.listener_start_close
+                }
+                catch {
+                    // A failed listener has already reached its terminal state.
+                }
+                const server = this.#server;
+                if (server?.listening) {
+                    const closing = this.#closeListener(server);
+                    for (const session of this.#sessions)
+                        session.close();
+                    await closing;
+                }
+            },
+        });
+        return this.#close;
+    }
+    async #startOnce() {
+        const core = DeliveryAssembly.create(this.#configuration);
+        this.#assembly = core;
+        const server = http2.createServer(connectNodeAdapter({
+            routes: (router) => {
+                router.service(InboxService, core.inbox);
+                router.service(ShardService, core.shards);
+                router.service(AdminService, core.admin);
+                router.service(Health, HealthHandlers.create(() => this.#serving));
+            },
+            readMaxBytes: this.#configuration.maxInboundMessageBytes,
+        }));
+        server.on("session", (session) => {
+            this.#sessions.add(session);
+            session.on("close", () => this.#sessions.delete(session));
+        });
+        this.#server = server;
+        try {
+            const address = await this.#listen(server, this.host, this.#port);
+            this.#port = address.port;
+            this.#started = true;
+            return this;
+        }
+        catch (error) {
+            // spine-log-boundary: delivery_server.listener_start
+            deliveryServerLog.error(this.#logger);
+            await this.#closeListener(server);
+            throw error;
+        }
+    }
+    /**
+     * Waits for a cleartext HTTP/2 listener to bind and reports its address.
+     */
+    #listen(server, host, port) {
+        return new Promise((resolve, reject) => {
+            const done = () => {
+                server.off("error", fail);
+                server.off("listening", ready);
+            };
+            const fail = (error) => {
+                done();
+                reject(error);
+            };
+            const ready = () => {
+                done();
+                resolve(server.address());
+            };
+            server.once("error", fail);
+            server.once("listening", ready);
+            server.listen(port, host);
+        });
+    }
+    /**
+     * Closes a bound cleartext HTTP/2 listener without changing terminal state.
+     */
+    #closeListener(server) {
+        return new Promise((resolve, reject) => {
+            if (!server.listening) {
+                resolve();
+                return;
+            }
+            server.close((error) => {
+                if (error === undefined)
+                    resolve();
+                else
+                    reject(error);
+            });
+        });
+    }
+}
+//# sourceMappingURL=delivery-server.js.map

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

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

package/dist/server/shutdown.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Describes the ordered resources closed during delivery-server shutdown.
+ */
+export interface DeliveryServerShutdownResources {
+    /**
+     * Sets Health to no longer serving.
+     */
+    readonly markNotServing: () => void;
+    /**
+     * Closes the shared mutation-admission boundary.
+     */
+    readonly closeAdmission: () => void;
+    /**
+     * Closes Admin subscribers and publishing.
+     */
+    readonly closeAdmin: () => void;
+    /**
+     * Closes the listener and active HTTP/2 sessions.
+     *
+     * @returns Completes after the listener closes.
+     */
+    readonly closeNetwork: () => Promise<void>;
+}
+/**
+ * Provides the delivery-server terminal shutdown sequence.
+ */
+export declare const DeliveryShutdown: Readonly<{
+    /**
+     * Runs the required Health, admission, Admin, listener, and session shutdown order.
+     *
+     * @param resources Holds the shutdown resources in their required phases.
+     * @returns A promise that resolves after network shutdown completes.
+     */
+    run: (resources: DeliveryServerShutdownResources) => Promise<void>;
+}>;
+//# sourceMappingURL=shutdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/server/shutdown.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAG9C;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC;IAGtC;;;;;OAKG;IACH,GAAG,EAAE,CAAC,SAAS,EAAE,+BAA+B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE,CAOC,CAAC"}

package/dist/server/shutdown.js

@@ -0,0 +1,25 @@
+/*
+ * 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.
+ */
+/**
+ * Provides the delivery-server terminal shutdown sequence.
+ */
+export const DeliveryShutdown = Object.freeze({
+    run: async (resources) => {
+        resources.markNotServing();
+        resources.closeAdmission();
+        resources.closeAdmin();
+        await resources.closeNetwork();
+    },
+});
+//# sourceMappingURL=shutdown.js.map

package/dist/server/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../../src/server/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+BH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAUxB,MAAM,CAAC,MAAM,CAAC;IACjB,GAAG,EAAE,KAAK,EAAE,SAA0C,EAAiB,EAAE;QACvE,SAAS,CAAC,cAAc,EAAE,CAAC;QAC3B,SAAS,CAAC,cAAc,EAAE,CAAC;QAC3B,SAAS,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC;IACjC,CAAC;CACF,CAAC,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Exports test support for applications that host a Delivery server assembly in-process.
+ */
+export { DeliveryAssembly } from "../server/assembly.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,18 @@
+/*
+ * 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.
+ */
+/**
+ * Exports test support for applications that host a Delivery server assembly in-process.
+ */
+export { DeliveryAssembly } from "../server/assembly.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}