@spine-event-engine/deployment 2.0.0-snapshot.10

package/dist/registry/leased-node-registry.d.ts

@@ -0,0 +1,118 @@
+import { RecordSpec, type StorageFactory } from "@spine-event-engine/storage";
+import { type ApplicationNodeLease } from "@spine-event-engine/proto/generated/spine/deployment/node_discovery_pb.js";
+import { type NodeId } from "@spine-event-engine/proto/generated/spine/server/server_environment_pb.js";
+import { ApplicationNode } from "../discovery/application-node.js";
+/**
+ * Stores and reads live application-node leases in one caller-owned storage namespace.
+ */
+export declare class LeasedNodeRegistry {
+    #private;
+    /**
+     * Creates a leased node registry over an explicit atomic record storage handle.
+     *
+     * @param options Supplies the operator-selected storage factory and namespace.
+     */
+    constructor(options: LeasedNodeRegistryOptions);
+    /**
+     * Registers one previously absent node lease.
+     *
+     * @param lease Supplies the node, owning registration identity, and expiry time.
+     * @param signal Cancels this cooperative storage mutation.
+     * @returns Whether the registration was written.
+     */
+    register(lease: NodeLease, signal?: AbortSignal): Promise<boolean>;
+    /**
+     * Updates a lease only when its registration identity still owns the node ID.
+     *
+     * @param nodeId Supplies the stable node identity.
+     * @param registrationId Supplies the opaque owning process identity.
+     * @param expiresAt Supplies the renewed expiry in epoch milliseconds.
+     * @param signal Cancels this cooperative storage mutation.
+     * @returns Whether the owner still held and renewed the lease.
+     */
+    renew(nodeId: string, registrationId: string, expiresAt: number, signal?: AbortSignal): Promise<boolean>;
+    /**
+     * Deletes a lease only when its registration identity still owns the node ID.
+     *
+     * @param nodeId Supplies the stable node identity.
+     * @param registrationId Supplies the opaque owning process identity.
+     * @param signal Cancels this cooperative storage mutation.
+     * @returns Whether the caller's lease was deleted.
+     */
+    remove(nodeId: string, registrationId: string, signal?: AbortSignal): Promise<boolean>;
+    /**
+     * Reads one complete validated snapshot of live nodes at a supplied clock time.
+     *
+     * @param now Supplies epoch milliseconds used for exact expiry filtering.
+     * @param signal Cancels this cooperative complete-snapshot read.
+     * @returns Every non-expired node after every stored row validates.
+     */
+    read(now: number, signal?: AbortSignal): Promise<readonly ApplicationNode[]>;
+    /**
+     * Reads one validated live lease at its exact storage slot.
+     *
+     * @param nodeId Supplies the stable node identity.
+     * @param now Supplies epoch milliseconds for expiry evaluation.
+     * @param signal Cancels this cooperative ownership lookup.
+     * @returns The live lease, or undefined when absent or expired.
+     */
+    lookup(nodeId: string, now: number, signal?: AbortSignal): Promise<NodeLease | undefined>;
+    /**
+     * Deletes one finite batch of expired leases conditionally.
+     *
+     * @param now Supplies epoch milliseconds used for exact expiry filtering.
+     * @param signal Cancels this cooperative finite cleanup pass.
+     * @returns The number of rows this pass removed.
+     */
+    cleanup(now: number, signal?: AbortSignal): Promise<number>;
+    /**
+     * Joins started operations after fencing this handle once.
+     *
+     * @returns Completes after every active registry operation settles.
+     */
+    close(): Promise<void>;
+    private requireOpen;
+    private start;
+    private readAll;
+}
+/**
+ * Supplies storage ownership and finite cleanup settings for one registry.
+ */
+export interface LeasedNodeRegistryOptions {
+    /**
+     * Selects the caller-owned storage factory.
+     */
+    readonly factory: StorageFactory;
+    /**
+     * Selects the caller-owned logical storage namespace.
+     */
+    readonly namespace: string;
+    /**
+     * Limits expired rows considered by one cleanup pass.
+     */
+    readonly cleanupBatchSize?: number;
+}
+/**
+ * Supplies the durable data owned by one registration attempt.
+ */
+export interface NodeLease {
+    /**
+     * Identifies the stable reachable application node.
+     */
+    readonly node: ApplicationNode;
+    /**
+     * Identifies the opaque owning application process.
+     */
+    readonly registrationId: string;
+    /**
+     * Specifies the epoch-millisecond expiry of this lease.
+     */
+    readonly expiresAt: number;
+}
+/**
+ * Declares the internal persisted lease record layout.
+ *
+ * @internal
+ */
+export declare const leaseRecordSpec: RecordSpec<NodeId, ApplicationNodeLease>;
+//# sourceMappingURL=leased-node-registry.d.ts.map

package/dist/registry/leased-node-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leased-node-registry.d.ts","sourceRoot":"","sources":["../../src/registry/leased-node-registry.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,UAAU,EAIV,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2EAA2E,CAAC;AACnF,OAAO,EAEL,KAAK,MAAM,EACZ,MAAM,2EAA2E,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAOnE;;GAEG;AACH,qBAAa,kBAAkB;;IAQ7B;;;;OAIG;gBACS,OAAO,EAAE,yBAAyB;IAwB9C;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlE;;;;;;;;OAQG;IACH,KAAK,CACH,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC;IAmBnB;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IActF;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAY5E;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAazF;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB3D;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,KAAK;YAeC,OAAO;CAoBtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IAGxC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IAGxB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,UAAU,CAAC,MAAM,EAAE,oBAAoB,CAOnE,CAAC"}

package/dist/registry/leased-node-registry.js

@@ -0,0 +1,333 @@
+/*
+ * 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 { TimestampSchema } from "@bufbuild/protobuf/wkt";
+import { RecordSpec, } from "@spine-event-engine/storage";
+import { ApplicationNodeLeaseSchema, } from "@spine-event-engine/proto/generated/spine/deployment/node_discovery_pb.js";
+import { NodeIdSchema, } from "@spine-event-engine/proto/generated/spine/server/server_environment_pb.js";
+import { ApplicationNode } from "../discovery/application-node.js";
+const defaultCleanupBatchSize = 32;
+const maximumCleanupBatchSize = 256;
+const maximumTimestampMilliseconds = 253_402_300_799_999;
+const readPageSize = 256;
+/**
+ * Stores and reads live application-node leases in one caller-owned storage namespace.
+ */
+export class LeasedNodeRegistry {
+    #storage;
+    #cleanupBatchSize;
+    #closed = false;
+    #closing;
+    #operations = new Set();
+    #cleanupAfter;
+    /**
+     * Creates a leased node registry over an explicit atomic record storage handle.
+     *
+     * @param options Supplies the operator-selected storage factory and namespace.
+     */
+    constructor(options) {
+        if (options.namespace.trim().length === 0)
+            throw new Error("Lease storage namespace must be non-empty.");
+        const cleanupBatchSize = options.cleanupBatchSize ?? defaultCleanupBatchSize;
+        if (!Number.isSafeInteger(cleanupBatchSize) ||
+            cleanupBatchSize < 1 ||
+            cleanupBatchSize > maximumCleanupBatchSize) {
+            throw new RangeError(`Lease cleanup batch size must be between 1 and ${String(maximumCleanupBatchSize)}.`);
+        }
+        this.#storage = options.factory.createRecordStorage({ name: options.namespace, multitenant: false }, leaseRecordSpec);
+        if (!this.#storage.atomicCompareAndSet) {
+            this.#storage.close();
+            throw new Error("Leased node registry requires atomic compare-and-set storage.");
+        }
+        this.#cleanupBatchSize = cleanupBatchSize;
+    }
+    /**
+     * Registers one previously absent node lease.
+     *
+     * @param lease Supplies the node, owning registration identity, and expiry time.
+     * @param signal Cancels this cooperative storage mutation.
+     * @returns Whether the registration was written.
+     */
+    register(lease, signal) {
+        return this.start(async () => {
+            signal?.throwIfAborted();
+            const record = LeaseRecords.write(lease);
+            const result = await this.#storage.compareAndSet(LeaseRecords.id(record), undefined, record);
+            signal?.throwIfAborted();
+            return result;
+        });
+    }
+    /**
+     * Updates a lease only when its registration identity still owns the node ID.
+     *
+     * @param nodeId Supplies the stable node identity.
+     * @param registrationId Supplies the opaque owning process identity.
+     * @param expiresAt Supplies the renewed expiry in epoch milliseconds.
+     * @param signal Cancels this cooperative storage mutation.
+     * @returns Whether the owner still held and renewed the lease.
+     */
+    renew(nodeId, registrationId, expiresAt, signal) {
+        return this.start(async () => {
+            signal?.throwIfAborted();
+            const id = LeaseRecords.nodeId(nodeId);
+            const current = await this.#storage.read(id);
+            signal?.throwIfAborted();
+            if (current === undefined)
+                return false;
+            const lease = LeaseRecords.read(current, id);
+            if (lease.registrationId !== registrationId)
+                return false;
+            const result = await this.#storage.compareAndSet(id, current, LeaseRecords.write({ ...lease, expiresAt }));
+            signal?.throwIfAborted();
+            return result;
+        });
+    }
+    /**
+     * Deletes a lease only when its registration identity still owns the node ID.
+     *
+     * @param nodeId Supplies the stable node identity.
+     * @param registrationId Supplies the opaque owning process identity.
+     * @param signal Cancels this cooperative storage mutation.
+     * @returns Whether the caller's lease was deleted.
+     */
+    remove(nodeId, registrationId, signal) {
+        return this.start(async () => {
+            signal?.throwIfAborted();
+            const id = LeaseRecords.nodeId(nodeId);
+            const current = await this.#storage.read(id);
+            signal?.throwIfAborted();
+            if (current === undefined || LeaseRecords.read(current, id).registrationId !== registrationId)
+                return false;
+            const result = await this.#storage.compareAndSet(id, current, undefined);
+            signal?.throwIfAborted();
+            return result;
+        });
+    }
+    /**
+     * Reads one complete validated snapshot of live nodes at a supplied clock time.
+     *
+     * @param now Supplies epoch milliseconds used for exact expiry filtering.
+     * @param signal Cancels this cooperative complete-snapshot read.
+     * @returns Every non-expired node after every stored row validates.
+     */
+    read(now, signal) {
+        return this.start(async () => {
+            signal?.throwIfAborted();
+            LeaseRecords.requireTime(now);
+            const leases = (await this.readAll(signal)).map(({ id, record }) => LeaseRecords.read(record, id));
+            signal?.throwIfAborted();
+            return leases.filter((lease) => lease.expiresAt > now).map((lease) => lease.node);
+        });
+    }
+    /**
+     * Reads one validated live lease at its exact storage slot.
+     *
+     * @param nodeId Supplies the stable node identity.
+     * @param now Supplies epoch milliseconds for expiry evaluation.
+     * @param signal Cancels this cooperative ownership lookup.
+     * @returns The live lease, or undefined when absent or expired.
+     */
+    lookup(nodeId, now, signal) {
+        return this.start(async () => {
+            signal?.throwIfAborted();
+            LeaseRecords.requireTime(now);
+            const id = LeaseRecords.nodeId(nodeId);
+            const record = await this.#storage.read(id);
+            signal?.throwIfAborted();
+            if (record === undefined)
+                return undefined;
+            const lease = LeaseRecords.read(record, id);
+            return lease.expiresAt > now ? lease : undefined;
+        });
+    }
+    /**
+     * Deletes one finite batch of expired leases conditionally.
+     *
+     * @param now Supplies epoch milliseconds used for exact expiry filtering.
+     * @param signal Cancels this cooperative finite cleanup pass.
+     * @returns The number of rows this pass removed.
+     */
+    cleanup(now, signal) {
+        return this.start(async () => {
+            signal?.throwIfAborted();
+            LeaseRecords.requireTime(now);
+            const records = await this.#storage.queryEntries({
+                sort: [{ field: "id" }],
+                ...(this.#cleanupAfter === undefined ? {} : { after: this.#cleanupAfter }),
+                limit: this.#cleanupBatchSize,
+            });
+            signal?.throwIfAborted();
+            this.#cleanupAfter =
+                records.length === 0 ? undefined : LeasePages.continuation(records.at(-1));
+            if (records.length < this.#cleanupBatchSize)
+                this.#cleanupAfter = undefined;
+            const removals = await Promise.all(records.map(async ({ id, record }) => {
+                const lease = LeaseRecords.read(record, id);
+                return (lease.expiresAt <= now && (await this.#storage.compareAndSet(id, record, undefined)));
+            }));
+            return removals.filter(Boolean).length;
+        });
+    }
+    /**
+     * Joins started operations after fencing this handle once.
+     *
+     * @returns Completes after every active registry operation settles.
+     */
+    close() {
+        if (this.#closing !== undefined)
+            return this.#closing;
+        this.#closed = true;
+        this.#closing = Promise.allSettled([...this.#operations]).then(() => {
+            this.#storage.close();
+        });
+        return this.#closing;
+    }
+    requireOpen() {
+        if (this.#closed)
+            throw new Error("Leased node registry is closed.");
+    }
+    start(operation) {
+        try {
+            this.requireOpen();
+        }
+        catch (error) {
+            return Promise.reject(error instanceof Error ? error : new Error(String(error)));
+        }
+        const pending = operation();
+        this.#operations.add(pending);
+        void pending.then(() => this.#operations.delete(pending), () => this.#operations.delete(pending));
+        return pending;
+    }
+    async readAll(signal) {
+        const records = [];
+        let after;
+        for (;;) {
+            signal?.throwIfAborted();
+            const page = await this.#storage.queryEntries({
+                sort: [{ field: "id" }],
+                ...(after === undefined ? {} : { after }),
+                limit: readPageSize,
+            });
+            signal?.throwIfAborted();
+            records.push(...page);
+            if (page.length < readPageSize)
+                return records;
+            const last = page.at(-1);
+            if (last === undefined)
+                throw new Error("Lease page has no continuation row.");
+            after = { values: [{ field: "id", value: last.id }], id: last.id };
+        }
+    }
+}
+/**
+ * Declares the internal persisted lease record layout.
+ *
+ * @internal
+ */
+export const leaseRecordSpec = new RecordSpec({
+    recordType: ApplicationNodeLeaseSchema,
+    idSchema: NodeIdSchema,
+    extractId: (record) => LeaseRecords.id(record),
+});
+const LeaseRecords = Object.freeze({
+    id(record) {
+        if (!record.nodeId?.value.trim())
+            throw new Error("Application node lease record has no node ID.");
+        return record.nodeId;
+    },
+    nodeId(value) {
+        if (!value.trim())
+            throw new Error("Application node lease record has no node ID.");
+        return create(NodeIdSchema, { value });
+    },
+    read(record, expectedId) {
+        const id = this.id(record);
+        const endpoint = record.endpoint?.origin;
+        const expiresAt = this.milliseconds(record.whenExpires);
+        const registrationId = record.registrationId?.value;
+        if (expectedId !== undefined && id.value !== expectedId.value)
+            throw new Error("Application node lease record is invalid.");
+        try {
+            if (endpoint === undefined || !Number.isSafeInteger(expiresAt))
+                throw Error();
+            const node = new ApplicationNode({
+                id: id.value,
+                endpoint,
+                ...(record.endpoint?.tlsServerName === undefined ||
+                    record.endpoint.tlsServerName.length === 0
+                    ? {}
+                    : { tlsServerName: record.endpoint.tlsServerName }),
+            });
+            this.requireTime(expiresAt);
+            if (!registrationId?.trim())
+                throw Error();
+            return Object.freeze({ node, registrationId, expiresAt });
+        }
+        catch {
+            throw new Error("Application node lease record is invalid.");
+        }
+    },
+    write(lease) {
+        this.requireTime(lease.expiresAt);
+        if (!lease.registrationId.trim())
+            throw new Error("Lease registration identity must be non-empty.");
+        const node = new ApplicationNode({
+            id: lease.node.id,
+            endpoint: lease.node.endpoint,
+            ...(lease.node.tlsServerName === undefined
+                ? {}
+                : { tlsServerName: lease.node.tlsServerName }),
+        });
+        return create(ApplicationNodeLeaseSchema, {
+            nodeId: { value: node.id },
+            endpoint: {
+                origin: node.endpoint,
+                ...(node.tlsServerName === undefined ? {} : { tlsServerName: node.tlsServerName }),
+            },
+            whenExpires: this.timestamp(lease.expiresAt),
+            registrationId: { value: lease.registrationId },
+        });
+    },
+    milliseconds(timestamp) {
+        if (timestamp === undefined ||
+            timestamp.seconds < 0n ||
+            timestamp.nanos < 0 ||
+            timestamp.nanos >= 1_000_000_000 ||
+            timestamp.nanos % 1_000_000 !== 0) {
+            throw new Error("Application node lease record is invalid.");
+        }
+        const milliseconds = timestamp.seconds * 1000n + BigInt(timestamp.nanos / 1_000_000);
+        if (milliseconds > BigInt(maximumTimestampMilliseconds))
+            throw new Error("Application node lease record is invalid.");
+        return Number(milliseconds);
+    },
+    timestamp(milliseconds) {
+        return create(TimestampSchema, {
+            seconds: BigInt(Math.floor(milliseconds / 1_000)),
+            nanos: (milliseconds % 1_000) * 1_000_000,
+        });
+    },
+    requireTime(value) {
+        if (!Number.isSafeInteger(value) || value < 0 || value > maximumTimestampMilliseconds)
+            throw new RangeError("Lease expiry must be within the supported Protobuf Timestamp range.");
+    },
+});
+const LeasePages = Object.freeze({
+    continuation(entry) {
+        if (entry === undefined)
+            throw new Error("Lease page has no continuation row.");
+        return { values: [{ field: "id", value: entry.id }], id: entry.id };
+    },
+});
+//# sourceMappingURL=leased-node-registry.js.map

package/dist/registry/leased-node-registry.js.map

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

package/dist/spi/backend-membership.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Exports backend-membership contracts shared by deployment integrations.
+ */
+export { BackendMembershipKernel, type BackendMemberClient, type BackendMembershipKernelOptions, } from "../internal/backend-membership-kernel.js";
+//# sourceMappingURL=backend-membership.d.ts.map

package/dist/spi/backend-membership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-membership.d.ts","sourceRoot":"","sources":["../../src/spi/backend-membership.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,OAAO,EACL,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,GACpC,MAAM,0CAA0C,CAAC"}

package/dist/spi/backend-membership.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 backend-membership contracts shared by deployment integrations.
+ */
+export { BackendMembershipKernel, } from "../internal/backend-membership-kernel.js";
+//# sourceMappingURL=backend-membership.js.map

package/dist/spi/backend-membership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-membership.js","sourceRoot":"","sources":["../../src/spi/backend-membership.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,OAAO,EACL,uBAAuB,GAGxB,MAAM,0CAA0C,CAAC"}