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

package/dist/entity/entity-metadata.js

@@ -0,0 +1,187 @@
+/*
+ * 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 { getOption, hasOption } from "@bufbuild/protobuf";
+import { column, entity, EntityOption_Kind, EntityOption_Visibility, set_once, } from "@spine-event-engine/proto";
+const entitySchema = Symbol("spine-ts.entity-schema");
+/**
+ * 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 function attachEntitySchema(entityType, schema) {
+    const current = Object.prototype.hasOwnProperty.call(entityType, entitySchema)
+        ? Reflect.get(entityType, entitySchema)
+        : undefined;
+    if (current !== undefined && current !== schema) {
+        throw new Error("Entity class already has different generated state schema metadata.");
+    }
+    if (current === undefined) {
+        Object.defineProperty(entityType, entitySchema, {
+            configurable: false,
+            enumerable: false,
+            value: schema,
+            writable: false,
+        });
+    }
+}
+/**
+ * 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 function entitySchemaOf(entityType) {
+    return Object.prototype.hasOwnProperty.call(entityType, entitySchema)
+        ? Reflect.get(entityType, entitySchema)
+        : undefined;
+}
+/**
+ * Error thrown when descriptor metadata cannot be derived for a schema.
+ */
+export class DescriptorMetadataError extends Error {
+    // prettier-ignore
+    /**
+     * Stable code for callers/tests that need structured failure handling.
+     */
+    code;
+    /**
+     * Creates a descriptor metadata error.
+     *
+     * @param code Stable failure code.
+     * @param message Human-readable explanation of the invalid descriptor.
+     */
+    constructor(code, message) {
+        super(message);
+        this.name = "DescriptorMetadataError";
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Determines whether a schema declares Spine `(entity)` metadata.
+ *
+ * @param schema Generated schema to inspect.
+ * @returns `true` when the schema declares an entity option.
+ */
+export function isEntitySchema(schema) {
+    return hasOption(schema, entity);
+}
+/**
+ * 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 function describeEntityMetadata(schema) {
+    if (!isEntitySchema(schema)) {
+        throw new DescriptorMetadataError("NOT_ENTITY_SCHEMA", `Schema "${schema.typeName}" requires an (entity) option before entity metadata can be derived.`);
+    }
+    const entityOption = getOption(schema, entity);
+    const kind = EntityDescriptors.kind(schema, entityOption.kind);
+    const declaredVisibility = EntityDescriptors.visibility(schema, entityOption.visibility);
+    const visibility = EntityDescriptors.resolvedVisibility(kind, declaredVisibility);
+    const idFieldDescriptor = schema.fields[0];
+    if (idFieldDescriptor === undefined) {
+        throw new DescriptorMetadataError("MISSING_ENTITY_ID_FIELD", `Entity schema "${schema.typeName}" must declare at least one field for its ID and routing metadata.`);
+    }
+    const idField = EntityDescriptors.field(idFieldDescriptor);
+    const firstFieldRoutingHint = Object.freeze({
+        strategy: "first-field",
+        field: idField,
+    });
+    const columns = EntityDescriptors.columns(schema, kind);
+    const setOnceFields = Object.freeze(schema.fields
+        .filter((field) => hasOption(field, set_once) && getOption(field, set_once))
+        .map(EntityDescriptors.field));
+    const metadata = {
+        schema,
+        descriptor: schema,
+        fullTypeName: schema.typeName,
+        fileDescriptor: schema.file,
+        fileName: `${schema.file.name}.proto`,
+        kind,
+        declaredVisibility,
+        visibility,
+        visibilitySource: declaredVisibility === "default" ? "default" : "explicit",
+        idField,
+        firstFieldRoutingHint,
+        columns,
+        setOnceFields,
+    };
+    return Object.freeze(metadata);
+}
+/**
+ * Normalizes private descriptors used to build entity metadata.
+ */
+const EntityDescriptors = Object.freeze({
+    field(field) {
+        return Object.freeze({
+            descriptor: field,
+            name: field.name,
+            localName: field.localName,
+            jsonName: field.jsonName,
+            number: field.number,
+        });
+    },
+    kind(schema, value) {
+        switch (value) {
+            case EntityOption_Kind.AGGREGATE:
+                return "aggregate";
+            case EntityOption_Kind.PROJECTION:
+                return "projection";
+            case EntityOption_Kind.PROCESS_MANAGER:
+                return "process-manager";
+            case EntityOption_Kind.ENTITY:
+                return "entity";
+            default:
+                throw new DescriptorMetadataError("UNSUPPORTED_ENTITY_KIND", `Schema "${schema.typeName}" declares unsupported entity kind ` +
+                    `"${EntityOption_Kind[value] || String(value)}".`);
+        }
+    },
+    visibility(schema, value) {
+        switch (value) {
+            case EntityOption_Visibility.DEFAULT:
+                return "default";
+            case EntityOption_Visibility.NONE:
+                return "none";
+            case EntityOption_Visibility.SUBSCRIBE:
+                return "subscribe";
+            case EntityOption_Visibility.QUERY:
+                return "query";
+            case EntityOption_Visibility.FULL:
+                return "full";
+            default:
+                throw new DescriptorMetadataError("UNSUPPORTED_ENTITY_VISIBILITY", `Schema "${schema.typeName}" declares unsupported entity visibility "${String(value)}".`);
+        }
+    },
+    resolvedVisibility(kind, declared) {
+        return declared === "default" ? (kind === "projection" ? "full" : "none") : declared;
+    },
+    columns(schema, kind) {
+        if (kind !== "projection" && kind !== "process-manager")
+            return Object.freeze([]);
+        return Object.freeze(schema.fields
+            .filter((field) => hasOption(field, column) && getOption(field, column))
+            .map((field) => {
+            if (field.fieldKind === "list" || field.fieldKind === "map")
+                throw new DescriptorMetadataError("INVALID_COLUMN_FIELD", `Entity column field "${schema.typeName}.${field.name}" must be singular; ` +
+                    "repeated and map fields are unsupported.");
+            return EntityDescriptors.field(field);
+        }));
+    },
+});
+//# sourceMappingURL=entity-metadata.js.map

package/dist/entity/entity-metadata.js.map

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

package/dist/entity/entity-storage-descriptor.d.ts

@@ -0,0 +1,64 @@
+import { type Message } from "@bufbuild/protobuf";
+import { type Any } from "@bufbuild/protobuf/wkt";
+import { type EntityRecord } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
+import { RecordColumn, RecordSpec, type StorageContext } from "@spine-event-engine/storage";
+import type { EntityStorageInput } from "@spine-event-engine/storage/internal/entity-history";
+import { type DescriptorMessageSchema } from "./entity-metadata.js";
+import type { PrimitiveId } from "../repository/primitive-id.js";
+/**
+ * Converts repository current state to and from the JVM EntityRecord envelope.
+ *
+ * @internal
+ */
+export declare const EntityRecords: EntityRecordConverter;
+/**
+ * Creates provider input from a class-derived EntityRecord specification.
+ *
+ * @param context Identifies the storage namespace for entity records.
+ * @param spec The Entity-class storage specification.
+ * @returns The storage input for generated JVM EntityRecord values.
+ */
+export declare function entityStorageDescriptor<I>(context: StorageContext, spec: RecordSpec<I, EntityRecord>): EntityStorageInput<I, Message>;
+/**
+ * Packs Entity IDs according to the declaration-first ID field of their state.
+ *
+ * @internal
+ */
+export declare const EntityIds: Readonly<{
+    pack(schema: DescriptorMessageSchema, entityId: unknown): Any;
+}>;
+/**
+ * Creates the internal Stand storage input for a registered Entity state schema.
+ *
+ * @param context Identifies the storage namespace for entity records.
+ * @param schema The registered generated state schema.
+ * @param columns The state columns selected by Stand registration.
+ * @returns Storage input backed by generated JVM EntityRecord values.
+ * @internal
+ */
+export declare function standEntityStorageDescriptor(context: StorageContext, schema: DescriptorMessageSchema, columns: readonly RecordColumn<Message>[]): EntityStorageInput<unknown, Message>;
+/**
+ * Builds the shared JVM EntityRecord specification for one Entity state schema.
+ *
+ * @param schema Generated Entity state schema.
+ * @param columns State columns materialized from an unpacked EntityRecord.
+ * @returns The generated EntityRecord specification.
+ * @internal
+ */
+export declare function entityRecordSpec(schema: DescriptorMessageSchema, columns: readonly RecordColumn<Message>[]): RecordSpec<Message | PrimitiveId, EntityRecord>;
+type EntityRecordValue = Readonly<{
+    readonly archived: boolean;
+    readonly deleted: boolean;
+    readonly state: Message;
+    readonly version: bigint;
+    readonly versionMessage: import("@spine-event-engine/proto").Version;
+}>;
+type EntityRecordConverter = Readonly<{
+    pack(schema: DescriptorMessageSchema, entityId: unknown, state: Message, version: bigint | import("@spine-event-engine/proto").Version, lifecycle: {
+        readonly archived: boolean;
+        readonly deleted: boolean;
+    }): EntityRecord;
+    unpack(schema: DescriptorMessageSchema, record: EntityRecord): EntityRecordValue;
+}>;
+export {};
+//# sourceMappingURL=entity-storage-descriptor.d.ts.map

package/dist/entity/entity-storage-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-storage-descriptor.d.ts","sourceRoot":"","sources":["../../src/entity/entity-storage-descriptor.ts"],"names":[],"mappings":"AAcA,OAAO,EAAuC,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAa,KAAK,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,sEAAsE,CAAC;AAC9E,OAAO,EAEL,YAAY,EACZ,UAAU,EACV,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AAE9F,OAAO,EAA0B,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,qBAmE1B,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,YAAY,CAAC,GAChC,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,CAoBhC;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,OAAO,GAAG,GAAG,CAAC;CAC/D,CAkBC,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,SAAS,YAAY,CAAC,OAAO,CAAC,EAAE,GACxC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAKtC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,SAAS,YAAY,CAAC,OAAO,CAAC,EAAE,GACxC,UAAU,CAAC,OAAO,GAAG,WAAW,EAAE,YAAY,CAAC,CA0CjD;AAuCD,KAAK,iBAAiB,GAAG,QAAQ,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,OAAO,2BAA2B,EAAE,OAAO,CAAC;CACtE,CAAC,CAAC;AAEH,KAAK,qBAAqB,GAAG,QAAQ,CAAC;IACpC,IAAI,CACF,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GAAG,OAAO,2BAA2B,EAAE,OAAO,EAC7D,SAAS,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GACnE,YAAY,CAAC;IAChB,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,YAAY,GAAG,iBAAiB,CAAC;CAClF,CAAC,CAAC"}

package/dist/entity/entity-storage-descriptor.js

@@ -0,0 +1,227 @@
+/*
+ * 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, ScalarType, toBinary } from "@bufbuild/protobuf";
+import { AnySchema } from "@bufbuild/protobuf/wkt";
+import { AnyMessages, Identifiers } from "@spine-event-engine/core";
+import { VersionSchema } from "@spine-event-engine/proto";
+import { EntityRecordSchema, LifecycleFlagsSchema, } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
+import { ColumnTypes, RecordColumn, RecordSpec, } from "@spine-event-engine/storage";
+import { describeEntityMetadata } from "./entity-metadata.js";
+/**
+ * Converts repository current state to and from the JVM EntityRecord envelope.
+ *
+ * @internal
+ */
+export const EntityRecords = Object.freeze({
+    // prettier-ignore
+    /**
+     * Packs one current Entity state and its durable metadata.
+     *
+     * @param schema The generated Entity state schema.
+     * @param entityId The authoritative routed Entity ID.
+     * @param state The current Entity state.
+     * @param version The persisted Entity version.
+     * @param lifecycle The persisted Entity lifecycle.
+     * @returns The generated JVM EntityRecord envelope.
+     */
+    pack(schema, entityId, state, version, lifecycle) {
+        const versionNumber = typeof version === "bigint" ? version : BigInt(version.number);
+        if (versionNumber < 0n || versionNumber > 2147483647n) {
+            throw new RangeError("EntityRecord version must fit the non-negative JVM int32 range.");
+        }
+        const packedId = EntityIds.pack(schema, entityId);
+        return create(EntityRecordSchema, {
+            entityId: packedId,
+            state: AnyMessages.pack(schema, state),
+            version: typeof version === "bigint"
+                ? create(VersionSchema, { number: Number(version) })
+                : clone(VersionSchema, version),
+            lifecycleFlags: create(LifecycleFlagsSchema, lifecycle),
+        });
+    },
+    /**
+     * Restores state and durable metadata from one generated EntityRecord.
+     *
+     * @param schema The generated Entity state schema.
+     * @param record The JVM EntityRecord envelope.
+     * @returns The unpacked state and durable metadata.
+     */
+    unpack(schema, record) {
+        const cached = stateCache.get(record)?.get(schema);
+        if (cached !== undefined)
+            return cached;
+        const packedState = record.state;
+        const state = packedState === undefined ? undefined : AnyMessages.unpack(packedState, schema);
+        if (state === undefined)
+            throw new Error("EntityRecord state does not match the Entity state schema.");
+        const version = BigInt(record.version?.number ?? 0);
+        if (version < 0n)
+            throw new RangeError("EntityRecord version must be non-negative.");
+        const value = Object.freeze({
+            archived: record.lifecycleFlags?.archived ?? false,
+            deleted: record.lifecycleFlags?.deleted ?? false,
+            state,
+            version,
+            versionMessage: clone(VersionSchema, record.version ?? create(VersionSchema)),
+        });
+        let cachedBySchema = stateCache.get(record);
+        if (cachedBySchema === undefined) {
+            cachedBySchema = new Map();
+            stateCache.set(record, cachedBySchema);
+        }
+        cachedBySchema.set(schema, value);
+        return value;
+    },
+});
+/**
+ * Creates provider input from a class-derived EntityRecord specification.
+ *
+ * @param context Identifies the storage namespace for entity records.
+ * @param spec The Entity-class storage specification.
+ * @returns The storage input for generated JVM EntityRecord values.
+ */
+export function entityStorageDescriptor(context, spec) {
+    return {
+        columns: spec.columns,
+        context,
+        id: {
+            clone: (id) => structuredClone(id),
+            key: (id) => canonicalEntityIdKey(spec.sourceType, id),
+            pack: (id) => EntityIds.pack(spec.sourceType, id),
+            unpack: (id) => {
+                try {
+                    return spec.idValueIn(create(EntityRecordSchema, { entityId: id }));
+                }
+                catch {
+                    return undefined;
+                }
+            },
+        },
+        recordSpec: spec,
+        sourceType: spec.sourceType,
+        stateSchema: spec.sourceType,
+    };
+}
+/**
+ * Packs Entity IDs according to the declaration-first ID field of their state.
+ *
+ * @internal
+ */
+export const EntityIds = Object.freeze({
+    pack(schema, entityId) {
+        const idField = describeEntityMetadata(schema).idField.descriptor;
+        if (idField.fieldKind === "message") {
+            return Identifiers.pack(idField.message, entityId);
+        }
+        if (idField.fieldKind === "scalar") {
+            switch (primitiveIdKind(idField.scalar)) {
+                case "string":
+                    return Identifiers.pack("string", entityId);
+                case "int32":
+                    return Identifiers.pack("int32", entityId);
+                case "int64":
+                    return Identifiers.pack("int64", entityId);
+            }
+        }
+        throw new Error("Entity ID field must be scalar or message-valued.");
+    },
+});
+/**
+ * Creates the internal Stand storage input for a registered Entity state schema.
+ *
+ * @param context Identifies the storage namespace for entity records.
+ * @param schema The registered generated state schema.
+ * @param columns The state columns selected by Stand registration.
+ * @returns Storage input backed by generated JVM EntityRecord values.
+ * @internal
+ */
+export function standEntityStorageDescriptor(context, schema, columns) {
+    return entityStorageDescriptor(context, entityRecordSpec(schema, columns));
+}
+/**
+ * Builds the shared JVM EntityRecord specification for one Entity state schema.
+ *
+ * @param schema Generated Entity state schema.
+ * @param columns State columns materialized from an unpacked EntityRecord.
+ * @returns The generated EntityRecord specification.
+ * @internal
+ */
+export function entityRecordSpec(schema, columns) {
+    const metadata = describeEntityMetadata(schema);
+    const input = {
+        sourceType: schema,
+        recordType: EntityRecordSchema,
+        columns: [
+            new RecordColumn("archived", ColumnTypes.scalar(ScalarType.BOOL), (record) => record.lifecycleFlags?.archived ?? false),
+            new RecordColumn("deleted", ColumnTypes.scalar(ScalarType.BOOL), (record) => record.lifecycleFlags?.deleted ?? false),
+            new RecordColumn("version", ColumnTypes.message(VersionSchema), (record) => clone(VersionSchema, record.version ?? create(VersionSchema))),
+            ...columns.map((column) => new RecordColumn(column.name, column.type, (record) => column.valueIn(EntityRecords.unpack(schema, record).state))),
+        ],
+    };
+    const idField = metadata.idField.descriptor;
+    if (idField.fieldKind === "message")
+        return new RecordSpec({
+            ...input,
+            idSchema: idField.message,
+            extractId: (record) => unpackMessageId(record, idField.message),
+        });
+    if (idField.fieldKind === "scalar")
+        return new RecordSpec({
+            ...input,
+            idKind: primitiveIdKind(idField.scalar),
+            extractId: (record) => unpackPrimitiveId(record, primitiveIdKind(idField.scalar)),
+        });
+    throw new Error(`Entity ID field "${idField.name}" must be scalar or message-valued.`);
+}
+function primitiveIdKind(type) {
+    switch (type) {
+        case ScalarType.STRING:
+            return "string";
+        case ScalarType.INT32:
+        case ScalarType.SINT32:
+        case ScalarType.SFIXED32:
+            return "int32";
+        case ScalarType.INT64:
+        case ScalarType.SINT64:
+        case ScalarType.SFIXED64:
+            return "int64";
+        default:
+            throw new Error("Spine JVM storage does not support this primitive Entity ID type.");
+    }
+}
+function unpackMessageId(record, schema) {
+    if (record.entityId === undefined)
+        throw new Error("EntityRecord has no packed entity ID.");
+    const id = AnyMessages.unpack(record.entityId, schema);
+    if (id === undefined)
+        throw new Error("EntityRecord ID does not match the Entity ID schema.");
+    return id;
+}
+function unpackPrimitiveId(record, kind) {
+    const id = record.entityId === undefined
+        ? undefined
+        : kind === "string"
+            ? Identifiers.unpack("string", record.entityId)
+            : kind === "int32"
+                ? Identifiers.unpack("int32", record.entityId)
+                : Identifiers.unpack("int64", record.entityId);
+    if (id === undefined)
+        throw new Error("EntityRecord ID does not match the Entity ID schema.");
+    return id;
+}
+const stateCache = new WeakMap();
+function canonicalEntityIdKey(schema, id) {
+    return Buffer.from(toBinary(AnySchema, EntityIds.pack(schema, id))).toString("base64");
+}
+//# sourceMappingURL=entity-storage-descriptor.js.map

package/dist/entity/entity-storage-descriptor.js.map

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