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

package/dist/repository/primitive-id.d.ts

@@ -0,0 +1,75 @@
+import { type Message } from "@bufbuild/protobuf";
+import { type Any } from "@bufbuild/protobuf/wkt";
+/**
+ * Represents a scalar value that may identify an entity.
+ */
+export type PrimitiveId = string | number | bigint | boolean;
+/**
+ * Packs and reads scalar entity identifiers.
+ */
+export interface PrimitiveIdCodec {
+    /**
+     * Packs an identifier into a Protobuf `Any` value.
+     *
+     * @param id Identifier to pack.
+     * @returns Packed identifier.
+     */
+    pack(id: PrimitiveId): Any;
+    /**
+     * Reads a scalar identifier from an unknown value.
+     *
+     * @param value Value to inspect.
+     * @returns Scalar identifier, or `undefined` when the value is unsupported.
+     */
+    read(value: unknown): PrimitiveId | undefined;
+    /**
+     * Reads a finite scalar identifier from an unknown value.
+     *
+     * @param value Value to inspect.
+     * @returns Scalar identifier, or `undefined` when it is unsupported or non-finite.
+     */
+    readFinite(value: unknown): PrimitiveId | undefined;
+    /**
+     * Unpacks a scalar identifier from a Protobuf `Any` value.
+     *
+     * @param id Packed identifier to unpack.
+     * @returns Scalar identifier, or `undefined` when it is absent or unsupported.
+     */
+    unpack(id: Any | undefined): PrimitiveId | undefined;
+}
+/**
+ * A generated Protobuf message that identifies an entity.
+ *
+ * The message is validated against the Entity state ID-field schema at the
+ * routing boundary. Its complete declared field set is the identifier.
+ */
+export interface MessageId extends Message {
+    /**
+     * Fully qualified Protobuf message type name.
+     */
+    readonly $typeName: string;
+}
+/**
+ * Reads message-shaped entity identifiers.
+ */
+export interface MessageIdCodec {
+    /**
+     * Performs shallow message-shape recognition for an unknown identifier.
+     *
+     * Repository routing validates the recognized message against its target
+     * schema before durable use.
+     *
+     * @param value Value to inspect.
+     * @returns Identifier, or `undefined` when the value is malformed.
+     */
+    read(value: unknown): MessageId | undefined;
+}
+/**
+ * Provides the default scalar identifier codec.
+ */
+export declare const PrimitiveIds: PrimitiveIdCodec;
+/**
+ * Provides the default message-shaped identifier codec.
+ */
+export declare const MessageIds: MessageIdCodec;
+//# sourceMappingURL=primitive-id.d.ts.map

package/dist/repository/primitive-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-id.d.ts","sourceRoot":"","sources":["../../src/repository/primitive-id.ts"],"names":[],"mappings":"AAcA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAML,KAAK,GAAG,EACT,MAAM,wBAAwB,CAAC;AAIhC;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAG/B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,EAAE,WAAW,GAAG,GAAG,CAAC;IAE3B;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAE9C;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAEpD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,GAAG,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;CACtD;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,OAAO;IAGxC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAG7B;;;;;;;;OAQG;IACH,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;CAC7C;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,gBAsCzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,cAIvB,CAAC"}

package/dist/repository/primitive-id.js

@@ -0,0 +1,85 @@
+/*
+ * 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 { BoolValueSchema, DoubleValueSchema, Int32ValueSchema, Int64ValueSchema, StringValueSchema, } from "@bufbuild/protobuf/wkt";
+import { AnyMessages } from "@spine-event-engine/core";
+import { UserIdSchema } from "@spine-event-engine/proto";
+/**
+ * Provides the default scalar identifier codec.
+ */
+export const PrimitiveIds = Object.freeze({
+    pack(id) {
+        switch (typeof id) {
+            case "string":
+                return AnyMessages.pack(StringValueSchema, create(StringValueSchema, { value: id }));
+            case "number":
+                return AnyMessages.pack(DoubleValueSchema, create(DoubleValueSchema, { value: id }));
+            case "boolean":
+                return AnyMessages.pack(BoolValueSchema, create(BoolValueSchema, { value: id }));
+            case "bigint":
+                return AnyMessages.pack(Int64ValueSchema, create(Int64ValueSchema, { value: id }));
+        }
+    },
+    read(value) {
+        return IdValues.primitive(value);
+    },
+    readFinite(value) {
+        const id = IdValues.primitive(value);
+        return typeof id === "number" && !Number.isFinite(id) ? undefined : id;
+    },
+    unpack(id) {
+        if (id === undefined) {
+            return undefined;
+        }
+        return (AnyMessages.unpack(id, StringValueSchema)?.value ??
+            AnyMessages.unpack(id, Int32ValueSchema)?.value ??
+            AnyMessages.unpack(id, DoubleValueSchema)?.value ??
+            AnyMessages.unpack(id, Int64ValueSchema)?.value ??
+            AnyMessages.unpack(id, BoolValueSchema)?.value ??
+            AnyMessages.unpack(id, UserIdSchema)?.value);
+    },
+});
+/**
+ * Provides the default message-shaped identifier codec.
+ */
+export const MessageIds = Object.freeze({
+    read(value) {
+        return IdValues.message(value);
+    },
+});
+/**
+ * Validates and decodes values shared by identifier codecs.
+ */
+const IdValues = Object.freeze({
+    primitive(value) {
+        if (typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "bigint" ||
+            typeof value === "boolean") {
+            return value;
+        }
+        return undefined;
+    },
+    isMessage(value) {
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            return false;
+        }
+        return (Object.hasOwn(value, "$typeName") &&
+            typeof value.$typeName === "string");
+    },
+    message(value) {
+        return IdValues.isMessage(value) ? value : undefined;
+    },
+});
+//# sourceMappingURL=primitive-id.js.map

package/dist/repository/primitive-id.js.map

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