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

package/dist/delivery/sharded-work-registry.js

@@ -0,0 +1,361 @@
+/*
+ * 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, create } from "@bufbuild/protobuf";
+import { TenantIdSchema } from "@spine-event-engine/proto";
+import { ShardIndexSchema, ShardSessionRecordSchema, WorkerIdSchema, } from "@spine-event-engine/proto/delivery";
+import { RecordSpec, } from "@spine-event-engine/storage";
+import { TenantBoundary } from "@spine-event-engine/storage/provider";
+import { DeliveryStorageCorruptionError } from "./delivery-storage-error.js";
+import { DeliveryLeases } from "./delivery-lease.js";
+import { ShardIndex } from "./shard-index.js";
+const retries = 8;
+const leaseDefault = 30_000;
+/**
+ * Defines direct durable shard-session records keyed by their generated shard index.
+ */
+export const shardSessionRecordSpec = new RecordSpec({
+    sourceType: ShardSessionRecordSchema,
+    recordType: ShardSessionRecordSchema,
+    idSchema: ShardIndexSchema,
+    extractId: (record) => {
+        if (record.index === undefined)
+            throw new DeliveryStorageCorruptionError("Shard session index is missing.");
+        return record.index;
+    },
+});
+/**
+ * Coordinates durable exclusive ownership of delivery shards.
+ */
+export class ShardedWorkRegistry {
+    // prettier-ignore
+    /**
+     * Identifies the renewable leased session model.
+     */
+    sessionKind = "LEASED";
+    #context;
+    #factory;
+    #lease;
+    #now;
+    /**
+     * Opens a registry over direct shard-session storage.
+     *
+     * @param options Configures durable storage, lease duration, and clock.
+     */
+    constructor(options) {
+        this.#context = copy(options.context);
+        this.#factory = options.storageFactory;
+        this.#lease = DeliveryLeases.requireMs("ShardedWorkRegistry", options.leaseMs ?? leaseDefault);
+        this.#now = options.now ?? (() => new Date());
+        configs.set(this, {
+            context: this.#context,
+            storageFactory: this.#factory,
+            lease: this.#lease,
+            now: this.#now,
+        });
+        Object.freeze(this);
+    }
+    /**
+     * Acquires a shard for one complete durable worker identity.
+     *
+     * @param shard Identifies the shard to acquire.
+     * @param worker Identifies the worker requesting ownership.
+     * @returns The live owned session, or `undefined` when another worker owns it.
+     */
+    async pickUp(shard, worker) {
+        const nextShard = checkedShard(shard);
+        const nextWorker = checkedWorker(worker);
+        const storage = this.#storage();
+        try {
+            atomic(storage);
+            for (let i = 0; i < retries; i++) {
+                const id = wireId(nextShard);
+                const record = await storage.read(id);
+                const current = record === undefined ? undefined : session(record, nextShard, this.#lease);
+                const now = time(this.#now());
+                if (current?.worker !== undefined && current.expiresAt.getTime() > now) {
+                    return sameWorker(current.worker, nextWorker) ? current : undefined;
+                }
+                const next = owned(nextShard, nextWorker, now, this.#lease);
+                if (await storage.compareAndSet(id, record, toRecord(next)))
+                    return next;
+            }
+            throw concurrent("Shard pickup");
+        }
+        finally {
+            storage.close();
+        }
+    }
+    /**
+     * Returns one renewed exact live shard-session snapshot.
+     *
+     * @param expected Supplies the previously observed session.
+     * @returns The renewed session, or `undefined` when ownership was lost.
+     */
+    async renew(expected) {
+        return this.#update(expected);
+    }
+    /**
+     * Returns the renewed exact ownership session.
+     *
+     * @param expected Supplies the previously observed session.
+     * @returns The renewed session, or `undefined` when ownership was lost.
+     */
+    validateOwnership(expected) {
+        return this.renew(expected);
+    }
+    /**
+     * Returns whether one exact live shard-session snapshot became unowned.
+     *
+     * @param expected Supplies the session to release.
+     * @returns Whether the session is or became unowned.
+     */
+    async release(expected) {
+        const storage = this.#storage();
+        try {
+            atomic(storage);
+            for (let i = 0; i < retries; i++) {
+                const record = await storage.read(wireId(expected.shard));
+                if (record === undefined)
+                    return false;
+                const current = session(record, expected.shard, this.#lease);
+                if (!same(current, expected) || current.expiresAt.getTime() <= time(this.#now())) {
+                    return current.worker === undefined;
+                }
+                if (await storage.compareAndSet(wireId(expected.shard), record, unowned(current)))
+                    return true;
+            }
+            throw concurrent("Shard release");
+        }
+        finally {
+            storage.close();
+        }
+    }
+    /**
+     * Returns after draining one exclusively owned shard until a full rescan is empty.
+     *
+     * @param shard Identifies the shard to drain.
+     * @param worker Identifies the worker retaining ownership.
+     * @param read Reads the next pending shard contents.
+     * @param deliver Delivers one pending value under the current session.
+     * @returns A promise that settles after release or ownership loss.
+     */
+    async drainUntilEmpty(shard, worker, read, deliver) {
+        let current = await this.pickUp(shard, worker);
+        if (current === undefined)
+            return;
+        try {
+            for (;;) {
+                current = await this.renew(current);
+                if (current === undefined)
+                    return;
+                const values = await read();
+                if (values.length === 0)
+                    return;
+                for (const value of values) {
+                    current = await this.renew(current);
+                    if (current === undefined)
+                        return;
+                    await deliver(value, current);
+                }
+            }
+        }
+        finally {
+            if (current !== undefined)
+                await this.release(current);
+        }
+    }
+    async #update(expected) {
+        const storage = this.#storage();
+        try {
+            atomic(storage);
+            for (let i = 0; i < retries; i++) {
+                const record = await storage.read(wireId(expected.shard));
+                if (record === undefined)
+                    return undefined;
+                const current = session(record, expected.shard, this.#lease);
+                const now = time(this.#now());
+                if (!same(current, expected)) {
+                    return current.worker !== undefined &&
+                        expected.worker !== undefined &&
+                        sameWorker(current.worker, expected.worker) &&
+                        current.expiresAt.getTime() > now
+                        ? current
+                        : undefined;
+                }
+                if (current.worker === undefined || current.expiresAt.getTime() <= now)
+                    return undefined;
+                const next = owned(current.shard, current.worker, now, this.#lease);
+                if (await storage.compareAndSet(wireId(expected.shard), record, toRecord(next)))
+                    return next;
+            }
+            throw concurrent("Shard renewal");
+        }
+        finally {
+            storage.close();
+        }
+    }
+    #storage() {
+        return this.#factory.createRecordStorage(context(this.#context), shardSessionRecordSpec);
+    }
+}
+/**
+ * Represents one exact durable shard ownership snapshot.
+ */
+export class ShardSession {
+    shard;
+    worker;
+    pickedUpAt;
+    expiresAt;
+    // prettier-ignore
+    /**
+     * Identifies the leased session model.
+     */
+    kind = "LEASED";
+    /**
+     * Creates an immutable shard ownership snapshot.
+     *
+     * @param shard Identifies the owned shard.
+     * @param worker Identifies the owner, or `undefined` for an unowned row.
+     * @param pickedUpAt Records the durable pickup time.
+     * @param expiresAt Records the derived lease-expiry time.
+     */
+    constructor(shard, worker, pickedUpAt, expiresAt) {
+        this.shard = shard;
+        this.worker = worker;
+        this.pickedUpAt = pickedUpAt;
+        this.expiresAt = expiresAt;
+        Object.freeze(this);
+    }
+}
+const configs = new WeakMap();
+/**
+ * Exposes package-internal registry construction observations for integrations.
+ */
+export const shardedWorkRegistryAccess = Object.freeze({
+    matches(registry, contextValue, storageFactory) {
+        const value = configs.get(registry);
+        return (value?.storageFactory === storageFactory &&
+            value.context.name === contextValue.name &&
+            value.context.multitenant === contextValue.multitenant &&
+            TenantBoundary.of(value.context).key === TenantBoundary.of(contextValue).key);
+    },
+});
+function wireId(value) {
+    return create(ShardIndexSchema, { index: value.index, ofTotal: value.ofTotal });
+}
+function checkedShard(value) {
+    if (!(value instanceof ShardIndex))
+        throw new Error("Shard index is invalid.");
+    return value;
+}
+function checkedWorker(value) {
+    if (value.nodeId === undefined)
+        throw new Error("Shard worker is invalid.");
+    const node = value.nodeId.value;
+    if (typeof node !== "string" ||
+        node.trim() === "" ||
+        typeof value.value !== "string" ||
+        value.value.trim() === "")
+        throw new Error("Shard worker is invalid.");
+    return create(WorkerIdSchema, { nodeId: { value: node }, value: value.value });
+}
+function time(value) {
+    if (!(value instanceof Date) || !Number.isFinite(value.getTime()))
+        throw new Error("Shard time is invalid.");
+    return value.getTime();
+}
+function session(record, expected, lease) {
+    const index = record.index;
+    if (index?.index !== expected.index || index.ofTotal !== expected.ofTotal)
+        throw new DeliveryStorageCorruptionError("Shard session does not match its storage ID.");
+    const picked = timestamp(record.whenLastPicked);
+    const worker = record.worker === undefined ? undefined : checkedWorker(record.worker);
+    const expires = picked.getTime() + lease;
+    if (!Number.isSafeInteger(expires) || !Number.isFinite(new Date(expires).getTime()))
+        throw new DeliveryStorageCorruptionError("Shard lease expiry is invalid.");
+    return new ShardSession(expected, worker, picked, new Date(expires));
+}
+function atomic(storage) {
+    if (!storage.atomicCompareAndSet)
+        throw new DeliveryStorageCorruptionError("Shard storage requires atomic compare-and-set.");
+}
+function timestamp(value) {
+    if (value === undefined ||
+        !Number.isInteger(value.nanos) ||
+        value.nanos < 0 ||
+        value.nanos >= 1e9)
+        throw new DeliveryStorageCorruptionError("Shard pickup time is invalid.");
+    const ms = Number(value.seconds) * 1000 + Math.floor(value.nanos / 1e6);
+    if (!Number.isSafeInteger(ms))
+        throw new DeliveryStorageCorruptionError("Shard pickup time is invalid.");
+    return new Date(ms);
+}
+function owned(shard, worker, now, lease) {
+    const expiresAt = now + lease;
+    if (!Number.isSafeInteger(expiresAt) || !Number.isFinite(new Date(expiresAt).getTime()))
+        throw new Error("Shard lease expiry is invalid.");
+    return new ShardSession(shard, worker, new Date(now), new Date(expiresAt));
+}
+function toRecord(value) {
+    if (value.worker === undefined)
+        throw new Error("Shard worker is invalid.");
+    return create(ShardSessionRecordSchema, {
+        index: wireId(value.shard),
+        whenLastPicked: {
+            seconds: BigInt(Math.floor(value.pickedUpAt.getTime() / 1000)),
+            nanos: (value.pickedUpAt.getTime() % 1000) * 1e6,
+        },
+        worker: value.worker,
+    });
+}
+function unowned(value) {
+    return create(ShardSessionRecordSchema, {
+        index: wireId(value.shard),
+        whenLastPicked: {
+            seconds: BigInt(Math.floor(value.pickedUpAt.getTime() / 1000)),
+            nanos: (value.pickedUpAt.getTime() % 1000) * 1e6,
+        },
+    });
+}
+function same(a, b) {
+    return (a.shard.key() === b.shard.key() &&
+        a.pickedUpAt.getTime() === b.pickedUpAt.getTime() &&
+        a.worker?.nodeId?.value === b.worker?.nodeId?.value &&
+        a.worker?.value === b.worker?.value);
+}
+function sameWorker(a, b) {
+    return a.nodeId?.value === b.nodeId?.value && a.value === b.value;
+}
+function context(value) {
+    return value.multitenant
+        ? {
+            name: `${value.name}.delivery.shards`,
+            multitenant: true,
+            tenantId: clone(TenantIdSchema, value.tenantId),
+        }
+        : { name: `${value.name}.delivery.shards`, multitenant: false };
+}
+function copy(value) {
+    return value.multitenant
+        ? {
+            name: value.name,
+            multitenant: true,
+            tenantId: clone(TenantIdSchema, value.tenantId),
+        }
+        : { name: value.name, multitenant: false };
+}
+function concurrent(label) {
+    return new Error(`${label} could not be completed due to concurrent changes.`);
+}
+//# sourceMappingURL=sharded-work-registry.js.map

package/dist/delivery/sharded-work-registry.js.map

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

package/dist/entity/entity-metadata.d.ts

@@ -0,0 +1,173 @@
+import type { DescField, DescFile, Message } from "@bufbuild/protobuf";
+import type { GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Entity } from "./entity.js";
+/**
+ * Protobuf-ES message schema accepted by the server descriptor metadata APIs.
+ */
+export type DescriptorMessageSchema = GenMessage<Message>;
+/**
+ * Constructible class from the Spine Entity family.
+ *
+ * @internal
+ */
+export type EntityConstructor = typeof Entity;
+/**
+ * Attaches generated state-schema metadata directly to an Entity class.
+ *
+ * @internal
+ * @param entityType The Entity class that owns the schema metadata.
+ * @param schema The generated Entity state schema.
+ */
+export declare function attachEntitySchema(entityType: EntityConstructor, schema: DescriptorMessageSchema): void;
+/**
+ * Reads generated state-schema metadata from an Entity class.
+ *
+ * @internal
+ * @param entityType The Entity class whose metadata is read.
+ * @returns The attached generated state schema, when present.
+ */
+export declare function entitySchemaOf(entityType: EntityConstructor): DescriptorMessageSchema | undefined;
+/**
+ * Normalized Spine entity kind derived from `(entity).kind`.
+ */
+export type EntityKind = "aggregate" | "projection" | "process-manager" | "entity";
+/**
+ * Normalized Spine entity visibility after default application.
+ */
+export type EntityVisibility = "none" | "subscribe" | "query" | "full";
+/**
+ * Visibility declared directly in `(entity).visibility`, before defaulting.
+ */
+export type DeclaredEntityVisibility = EntityVisibility | "default";
+/**
+ * Machine-readable codes for descriptor metadata extraction failures.
+ */
+export type DescriptorMetadataErrorCode = "NOT_ENTITY_SCHEMA" | "UNSUPPORTED_ENTITY_KIND" | "UNSUPPORTED_ENTITY_VISIBILITY" | "MISSING_ENTITY_ID_FIELD" | "INVALID_COLUMN_FIELD";
+/**
+ * Descriptor-derived metadata for one Protobuf field.
+ */
+export interface DescriptorFieldMetadata<Field extends DescField = DescField> {
+    /**
+     * Descriptor identity for the field.
+     */
+    readonly descriptor: Field;
+    /**
+     * Protobuf field name as declared in source.
+     */
+    readonly name: Field["name"];
+    /**
+     * ECMAScript-safe property name generated by Protobuf-ES.
+     */
+    readonly localName: Field["localName"];
+    /**
+     * JSON field name.
+     */
+    readonly jsonName: Field["jsonName"];
+    /**
+     * Protobuf field number.
+     */
+    readonly number: Field["number"];
+}
+/**
+ * Hint for later default command/event routing by the first declared field.
+ */
+export interface FirstFieldRoutingHint<Field extends DescField = DescField> {
+    /**
+     * Current default routing strategy preserved from Spine descriptor order.
+     */
+    readonly strategy: "first-field";
+    /**
+     * Field that later routing logic should inspect.
+     */
+    readonly field: DescriptorFieldMetadata<Field>;
+}
+/**
+ * Descriptor-derived entity metadata used by handler, repository, and context assembly.
+ */
+export interface EntityMetadata<Schema extends DescriptorMessageSchema = DescriptorMessageSchema> {
+    /**
+     * Generated Protobuf-ES schema describing the entity state message.
+     */
+    readonly schema: Schema;
+    /**
+     * Alias for the schema as the descriptor-bearing message declaration.
+     */
+    readonly descriptor: Schema;
+    /**
+     * Fully qualified Protobuf type name.
+     */
+    readonly fullTypeName: Schema["typeName"];
+    /**
+     * Declaring file descriptor.
+     */
+    readonly fileDescriptor: DescFile;
+    /**
+     * Declaring file name with `.proto` restored.
+     */
+    readonly fileName: string;
+    /**
+     * Normalized entity kind.
+     */
+    readonly kind: EntityKind;
+    /**
+     * Visibility directly declared in `(entity).visibility`.
+     */
+    readonly declaredVisibility: DeclaredEntityVisibility;
+    /**
+     * Effective visibility after Spine defaults are applied.
+     */
+    readonly visibility: EntityVisibility;
+    /**
+     * Whether visibility came from an explicit option or a kind default.
+     */
+    readonly visibilitySource: "default" | "explicit";
+    /**
+     * Canonical entity ID field, taken from the first declared field.
+     */
+    readonly idField: DescriptorFieldMetadata;
+    /**
+     * Descriptor hint for later first-field routing.
+     */
+    readonly firstFieldRoutingHint: FirstFieldRoutingHint;
+    /**
+     * Fields marked `(column) = true`, in descriptor declaration order, for
+     * column-eligible entity kinds only. Aggregate and generic entity column
+     * declarations are ignored in this slice.
+     */
+    readonly columns: readonly DescriptorFieldMetadata[];
+    /**
+     * Fields marked `(set_once) = true`, in descriptor declaration order.
+     */
+    readonly setOnceFields: readonly DescriptorFieldMetadata[];
+}
+/**
+ * Error thrown when descriptor metadata cannot be derived for a schema.
+ */
+export declare class DescriptorMetadataError extends Error {
+    /**
+     * Stable code for callers/tests that need structured failure handling.
+     */
+    readonly code: DescriptorMetadataErrorCode;
+    /**
+     * Creates a descriptor metadata error.
+     *
+     * @param code Stable failure code.
+     * @param message Human-readable explanation of the invalid descriptor.
+     */
+    constructor(code: DescriptorMetadataErrorCode, message: string);
+}
+/**
+ * Determines whether a schema declares Spine `(entity)` metadata.
+ *
+ * @param schema Generated schema to inspect.
+ * @returns `true` when the schema declares an entity option.
+ */
+export declare function isEntitySchema(schema: DescriptorMessageSchema): boolean;
+/**
+ * Describes deterministic entity metadata from a Protobuf-ES schema descriptor.
+ *
+ * @param schema Generated entity-state schema to describe.
+ * @returns Frozen metadata derived from the schema descriptor.
+ */
+export declare function describeEntityMetadata<Schema extends DescriptorMessageSchema>(schema: Schema): EntityMetadata<Schema>;
+//# sourceMappingURL=entity-metadata.d.ts.map

package/dist/entity/entity-metadata.d.ts.map

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