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

package/dist/server/process-server-coordinator.js

@@ -0,0 +1,112 @@
+/*
+ * 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 { emitServerError } from "./server-log.js";
+const running = [];
+let signalsInstalled = false;
+let closingRunning;
+/**
+ * Coordinates process-owned server shutdown without exposing lifecycle seams.
+ *
+ * @internal
+ */
+export const ProcessServerCoordinator = Object.freeze({
+    add(server, environment, logger, onRetired) {
+        const record = { server, environment, logger, retirement: undefined };
+        running.push(record);
+        ProcessServerCoordinator.installSignals();
+        return {
+            host: server.host,
+            port: server.port,
+            baseUrl: server.baseUrl,
+            close: async () => {
+                await server.close();
+                await ProcessServerCoordinatorValues.retire(record);
+                onRetired();
+            },
+        };
+    },
+    installSignals() {
+        if (signalsInstalled)
+            return;
+        signalsInstalled = true;
+        process.on("SIGINT", ProcessServerCoordinator.onSignal);
+        process.on("SIGTERM", ProcessServerCoordinator.onSignal);
+    },
+    onSignal() {
+        void ProcessServerCoordinator.closeRunning();
+    },
+    closeRunning() {
+        closingRunning ??= ProcessServerCoordinatorValues.closeRunning().finally(() => {
+            closingRunning = undefined;
+        });
+        return closingRunning;
+    },
+});
+/**
+ * Groups private process-owned run retirement operations.
+ *
+ * @internal
+ */
+const ProcessServerCoordinatorValues = Object.freeze({
+    async closeRunning() {
+        for (const record of [...running].reverse()) {
+            try {
+                await record.server.close();
+                await ProcessServerCoordinatorValues.retire(record);
+                // spine-log-boundary: server.process_shutdown_close
+            }
+            catch {
+                process.exitCode = 1;
+                if (record.logger !== undefined) {
+                    emitServerError(record.logger, "Process-owned server shutdown failed.", {
+                        operation: "server.process_shutdown",
+                        reasonCode: "close_failed",
+                    });
+                }
+            }
+        }
+    },
+    remove(record) {
+        const index = running.indexOf(record);
+        if (index >= 0)
+            running.splice(index, 1);
+        if (running.length > 0)
+            return;
+        process.off("SIGINT", ProcessServerCoordinator.onSignal);
+        process.off("SIGTERM", ProcessServerCoordinator.onSignal);
+        signalsInstalled = false;
+    },
+    retire(record) {
+        const current = record.retirement;
+        if (current !== undefined)
+            return current;
+        const retirement = Promise.resolve()
+            .then(async () => {
+            if (!running.includes(record))
+                return;
+            if (record.environment !== undefined &&
+                !running.some((candidate) => candidate !== record && candidate.environment !== undefined)) {
+                await record.environment.close();
+            }
+            ProcessServerCoordinatorValues.remove(record);
+        })
+            .catch((error) => {
+            record.retirement = undefined;
+            throw error;
+        });
+        record.retirement = retirement;
+        return retirement;
+    },
+});
+//# sourceMappingURL=process-server-coordinator.js.map

package/dist/server/process-server-coordinator.js.map

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

package/dist/server/reserved-spine-rpc-paths.json

@@ -0,0 +1,8 @@
+[
+    "/spine.auth.AuthenticationService/ResolveContext",
+    "/spine.client.CommandService/Post",
+    "/spine.client.QueryService/Read",
+    "/spine.client.SubscriptionService/Subscribe",
+    "/spine.client.SubscriptionService/Activate",
+    "/spine.client.SubscriptionService/Cancel"
+]

package/dist/server/retryable-close.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Closes resources in order and retains failures for a later retry.
+ */
+export declare class RetryableCloseGroup {
+    #private;
+    /**
+     * Creates a retryable close sequence.
+     *
+     * @param closeables Supplies resources to close in order.
+     * @param message Describes a combined close failure.
+     */
+    constructor(closeables: readonly unknown[], message: string);
+    /**
+     * Closes each remaining resource and aggregates any failures.
+     *
+     * @returns A promise that settles after each remaining resource is attempted.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Collects nested close failures without losing deterministic order.
+ *
+ * @internal
+ */
+export declare const CloseErrors: {
+    readonly collect: (error: unknown, errors: unknown[]) => void;
+};
+//# sourceMappingURL=retryable-close.d.ts.map

package/dist/server/retryable-close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryable-close.d.ts","sourceRoot":"","sources":["../../src/server/retryable-close.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,qBAAa,mBAAmB;;IAK9B;;;;;OAKG;gBACS,UAAU,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM;IAK3D;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B7B;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAgDrF,CAAC"}

package/dist/server/retryable-close.js

@@ -0,0 +1,129 @@
+/*
+ * 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.
+ */
+/**
+ * Closes resources in order and retains failures for a later retry.
+ */
+export class RetryableCloseGroup {
+    #closeables;
+    #message;
+    #closedIndexes = new Set();
+    /**
+     * Creates a retryable close sequence.
+     *
+     * @param closeables Supplies resources to close in order.
+     * @param message Describes a combined close failure.
+     */
+    constructor(closeables, message) {
+        this.#closeables = closeables;
+        this.#message = message;
+    }
+    /**
+     * Closes each remaining resource and aggregates any failures.
+     *
+     * @returns A promise that settles after each remaining resource is attempted.
+     */
+    async close() {
+        const errors = [];
+        for (const [index, closeable] of this.#closeables.entries()) {
+            if (this.#closedIndexes.has(index)) {
+                continue;
+            }
+            await this.#closeOne(closeable, index, errors);
+        }
+        if (errors.length > 0) {
+            throw new AggregateError(errors, this.#message);
+        }
+    }
+    async #closeOne(closeable, index, errors) {
+        try {
+            const close = RetryableCloseValues.closeMethod(closeable);
+            if (close === undefined) {
+                this.#closedIndexes.add(index);
+                return;
+            }
+            await close();
+            this.#closedIndexes.add(index);
+        }
+        catch (error) {
+            CloseErrors.collect(error, errors);
+        }
+    }
+}
+/**
+ * Collects nested close failures without losing deterministic order.
+ *
+ * @internal
+ */
+export const CloseErrors = Object.freeze({
+    // prettier-ignore
+    /**
+     * Appends leaf close failures in stable aggregate order.
+     *
+     * @param error Supplies a direct or aggregate close failure.
+     * @param errors Receives flattened leaf failures.
+     */
+    collect(error, errors) {
+        const ancestors = new Set();
+        const work = [{ type: "visit", error }];
+        while (work.length > 0) {
+            const frame = work.pop();
+            if (frame === undefined) {
+                continue;
+            }
+            if (frame.type === "leave") {
+                ancestors.delete(frame.aggregate);
+                continue;
+            }
+            if (!(frame.error instanceof AggregateError)) {
+                errors.push(frame.error);
+                continue;
+            }
+            if (ancestors.has(frame.error)) {
+                errors.push(frame.error);
+                continue;
+            }
+            ancestors.add(frame.error);
+            const causes = [...frame.error.errors];
+            if (causes.length === 0) {
+                ancestors.delete(frame.error);
+                errors.push(frame.error);
+                continue;
+            }
+            work.push({ type: "leave", aggregate: frame.error });
+            for (let index = causes.length - 1; index >= 0; index -= 1) {
+                work.push({ type: "visit", error: causes[index] });
+            }
+        }
+    },
+});
+/**
+ *
+ * @internal Groups private close-operation reflection used by retryable shutdown.
+ */
+const RetryableCloseValues = Object.freeze({
+    closeMethod(closeable) {
+        if (typeof closeable !== "object" || closeable === null) {
+            return undefined;
+        }
+        const close = Reflect.get(closeable, "close");
+        if (typeof close !== "function") {
+            return undefined;
+        }
+        return () => {
+            const result = Reflect.apply(close, closeable, []);
+            return result;
+        };
+    },
+});
+//# sourceMappingURL=retryable-close.js.map

package/dist/server/retryable-close.js.map

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

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

@@ -0,0 +1,180 @@
+import { type StorageFactory } from "@spine-event-engine/storage";
+import { type ILogLayer } from "loglayer";
+import { type TransportFactory } from "@spine-event-engine/transport";
+import { type TypeRegistryLookup } from "@spine-event-engine/core";
+import { type BoundedContext } from "../context/bounded-context.js";
+import type { DeliveryInbox, DeliveryWorkRegistry } from "../delivery/delivery-ports.js";
+import type { DeliverySource } from "../delivery/delivery-supervisor.js";
+import { type EnvironmentAttachOptions, type EnvironmentAttachmentHandle, type EnvironmentGenerationWorker } from "./environment-attachment.js";
+import { Environment, EnvironmentType } from "./environment.js";
+/**
+ * Common closeable facility owned by a server environment.
+ */
+export interface ServerEnvironmentCloseable {
+    /**
+     * Closes the facility.
+     *
+     * @returns An optional asynchronous close operation.
+     */
+    close(): unknown;
+}
+/**
+ * A closeable environment facility that must open before attachment admission.
+ */
+export interface ServerEnvironmentDelivery extends ServerEnvironmentCloseable {
+    /**
+     * Opens the facility before the environment admits attachments.
+     *
+     * @returns An optional asynchronous open operation.
+     */
+    open(): unknown;
+    /**
+     * Supplies the inbox port used by environment delivery generations.
+     */
+    readonly inbox: DeliveryInbox;
+    /**
+     * Supplies the shard work-registry port used by environment delivery generations.
+     */
+    readonly workRegistry: DeliveryWorkRegistry;
+    /**
+     * Supplies the remote Admin source used to recover and observe shard work.
+     */
+    readonly source?: DeliverySource;
+}
+/**
+ * Facilities configured for one Node environment type.
+ */
+export interface ServerEnvironmentSettings {
+    /**
+     * Storage facility selected for server assembly, including server-added context builders.
+     */
+    readonly storageFactory?: StorageFactory;
+    /**
+     * Optional message-channel factory for private bounded-context integration brokers.
+     *
+     * When omitted, this environment owns one `InMemoryTransportFactory` shared
+     * by every local broker in the process and closes it once with the environment.
+     */
+    readonly integrationChannelFactory?: TransportFactory;
+    /**
+     * Complete generated application schema lookup used for ThirdParty event encoding.
+     * Production requires it; local/test environments fall back to `spineCoreRegistry` only.
+     */
+    readonly typeRegistry?: TypeRegistryLookup;
+    /**
+     * Optional closeable delivery owner for durable delivery seams.
+     */
+    readonly delivery?: ServerEnvironmentCloseable;
+    /**
+     * Optional tracing factory placeholder for later tracing adapters.
+     */
+    readonly tracerFactory?: ServerEnvironmentCloseable;
+    /**
+     * Application-owned logger used by this environment and its attached runtime parts.
+     * The caller retains transport flush and close ownership.
+     */
+    readonly logger?: ILogLayer;
+}
+/**
+ * Creates facilities for the selected server environment.
+ *
+ * @returns The facilities selected for the environment.
+ */
+export type ServerEnvironmentSettingsFactory = () => ServerEnvironmentSettings;
+type SettingsInput = ServerEnvironmentSettings | ServerEnvironmentSettingsFactory;
+/**
+ * Process-wide server facilities for the canonical {@link Environment}.
+ */
+export declare class ServerEnvironment implements ServerEnvironmentCloseable {
+    #private;
+    /**
+     * The environment whose settings resolved these facilities.
+     */
+    readonly environment: Environment;
+    /**
+     * Stable identity shared by every server in this singleton lifecycle.
+     */
+    readonly nodeId: string;
+    /**
+     * Storage facility selected for server assembly, including server-added context builders.
+     */
+    readonly storageFactory: StorageFactory;
+    /**
+     * Message-channel factory selected for private bounded-context integration.
+     *
+     * This is either the configured override or one environment-owned
+     * `InMemoryTransportFactory` shared by every local broker in the process and
+     * closed once with the environment.
+     */
+    readonly integrationChannelFactory: TransportFactory;
+    /**
+     * Read-only application schema lookup used by private integration boundaries.
+     */
+    readonly typeRegistry: TypeRegistryLookup;
+    /**
+     * Optional closeable delivery owner selected for this environment.
+     */
+    readonly delivery: ServerEnvironmentCloseable | undefined;
+    /**
+     * Optional tracing factory selected for this environment.
+     */
+    readonly tracerFactory: ServerEnvironmentCloseable | undefined;
+    private constructor();
+    /**
+     * Sets facilities for an environment type before first resolution.
+     *
+     * @param type Identifies the environment to configure.
+     * @returns A one-use configuration entry point.
+     */
+    static when(type: EnvironmentType): {
+        use(settings: SettingsInput): void;
+    };
+    /**
+     * Resolves this module graph's configured server facilities exactly once.
+     *
+     * @returns The process-wide server environment.
+     */
+    static instance(): ServerEnvironment;
+    /**
+     * Closes this environment after all attached servers retire.
+     *
+     * Admission permanently closes the environment and prevents reuse. If it is
+     * in use, closure rejects without owned-facility teardown. Failed facility
+     * closes are retryable and already closed facilities are not closed again.
+     *
+     * @returns A promise that settles after the environment and owned facilities close.
+     *
+     */
+    close(): Promise<void>;
+}
+/**
+ * Provides controlled server-environment lifecycle operations for package owners.
+ *
+ * @internal
+ */
+export declare const ServerEnvironmentLifecycle: {
+    readonly resetForTest: () => Promise<void>;
+};
+interface ServerEnvironmentAccess {
+    attach(environment: ServerEnvironment, options: EnvironmentAttachOptions): Promise<EnvironmentAttachmentHandle>;
+    failedStartPending(environment: ServerEnvironment): boolean;
+    failedStartRetryPending(environment: ServerEnvironment, error: unknown): boolean;
+    retryFailedStart(environment: ServerEnvironment): Promise<void>;
+    detach(environment: ServerEnvironment, attachment: EnvironmentAttachmentHandle): Promise<void>;
+    retryDetach(environment: ServerEnvironment, attachment: EnvironmentAttachmentHandle): Promise<void>;
+    detachRetryPending(environment: ServerEnvironment, attachment: EnvironmentAttachmentHandle): boolean;
+    endpointSafe(environment: ServerEnvironment, attachment: EnvironmentAttachmentHandle): boolean;
+    stopDelivery(environment: ServerEnvironment): Promise<void>;
+    retryDeliveryStop(environment: ServerEnvironment): Promise<void>;
+    installTestAttachments(environment: ServerEnvironment, createWorker: () => EnvironmentGenerationWorker): void;
+    loggerFor(environment: ServerEnvironment): ILogLayer;
+    warnVolatileRegistry(environment: ServerEnvironment, context: BoundedContext): void;
+}
+/**
+ * Provides package-only environment delivery attachment access for server lifecycle owners.
+ *
+ * @internal
+ */
+export declare const serverEnvironmentAccess: ServerEnvironmentAccess;
+export {};
+//# sourceMappingURL=server-environment.d.ts.map

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

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