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

package/dist/delivery/inbox-records.js

@@ -0,0 +1,291 @@
+/*
+ * 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, fromBinary, ScalarType, toBinary } from "@bufbuild/protobuf";
+import { AnySchema, Int32ValueSchema, Int64ValueSchema, StringValueSchema, TimestampSchema, } from "@bufbuild/protobuf/wkt";
+import { CommandSchema, EventSchema } from "@spine-event-engine/proto";
+import { InboxIdSchema, InboxLabel, InboxMessageIdSchema, InboxMessageSchema, InboxMessageStatus, InboxSignalIdSchema, ShardIndexSchema, } from "@spine-event-engine/proto/delivery";
+import { ColumnTypes, RecordColumn, RecordSpec } from "@spine-event-engine/storage";
+import { DeliveryStorageCorruptionError } from "./delivery-storage-error.js";
+import { InboxMessageError, } from "./inbox.js";
+import { ShardIndex } from "./shard-index.js";
+/**
+ * Converts between the ergonomic port view and the generated durable record.
+ */
+export const InboxRecords = Object.freeze({
+    read(record, expectedId) {
+        return Values.read(record, expectedId);
+    },
+    write(message) {
+        return Values.write(message);
+    },
+});
+/**
+ * Defines the direct generated record specification for durable inbox rows.
+ */
+export const inboxRecordSpec = new RecordSpec({
+    sourceType: InboxMessageSchema,
+    recordType: InboxMessageSchema,
+    idSchema: InboxMessageIdSchema,
+    extractId: (record) => Values.id(record),
+    columns: [
+        new RecordColumn("inbox_id", ColumnTypes.fromField(InboxMessageSchema.field.inboxId), (record) => record.inboxId),
+        new RecordColumn("signal_id", ColumnTypes.fromField(InboxMessageSchema.field.signalId), (record) => record.signalId),
+        new RecordColumn("shard_index", ColumnTypes.scalar(ScalarType.INT32), (record) => Values.shard(record).index),
+        new RecordColumn("shard_total", ColumnTypes.scalar(ScalarType.INT32), (record) => Values.shard(record).ofTotal),
+        new RecordColumn("status", ColumnTypes.fromField(InboxMessageSchema.field.status), (record) => record.status),
+        new RecordColumn("when_received", ColumnTypes.fromField(InboxMessageSchema.field.whenReceived), (record) => record.whenReceived),
+        new RecordColumn("version", ColumnTypes.fromField(InboxMessageSchema.field.version), (record) => record.version),
+        new RecordColumn("message_id", ColumnTypes.scalar(ScalarType.STRING), (record) => Values.text(record.id?.uuid, "Inbox message ID")),
+    ],
+});
+const Values = Object.freeze({
+    write(input) {
+        const message = Values.input(input);
+        Values.target(message.inboxId.targetId, InboxMessageError);
+        Values.payloadForLabel(message.label, message.signal, InboxMessageError);
+        const payload = message.signal === undefined ? { case: undefined } : Values.payload(message.signal);
+        return create(InboxMessageSchema, {
+            id: create(InboxMessageIdSchema, {
+                uuid: message.id.value,
+                index: create(ShardIndexSchema, {
+                    index: message.shard.index,
+                    ofTotal: message.shard.ofTotal,
+                }),
+            }),
+            signalId: create(InboxSignalIdSchema, { value: message.signalId }),
+            inboxId: create(InboxIdSchema, {
+                entityId: {
+                    id: clone(AnySchema, message.inboxId.targetId),
+                },
+                typeUrl: message.inboxId.targetTypeUrl,
+            }),
+            payload,
+            label: Values.label(message.label),
+            status: Values.status(message.status),
+            whenReceived: Values.timestamp(message.whenReceived.getTime()),
+            version: Number(message.version),
+            ...(message.keepUntil === undefined
+                ? {}
+                : { keepUntil: Values.timestamp(message.keepUntil.getTime()) }),
+        });
+    },
+    read(record, expectedId) {
+        const id = Values.id(record);
+        const shard = Values.shard(record);
+        if (expectedId !== undefined &&
+            (id.uuid !== expectedId.uuid ||
+                id.index?.index !== expectedId.index?.index ||
+                id.index?.ofTotal !== expectedId.index?.ofTotal))
+            throw new DeliveryStorageCorruptionError("Inbox message does not match its storage ID.");
+        const inbox = record.inboxId;
+        const entity = inbox?.entityId?.id;
+        const signal = record.signalId?.value;
+        if (inbox === undefined ||
+            typeof entity?.typeUrl !== "string" ||
+            entity.typeUrl.trim().length === 0 ||
+            typeof signal !== "string" ||
+            signal.trim().length === 0 ||
+            typeof inbox.typeUrl !== "string" ||
+            inbox.typeUrl.trim().length === 0 ||
+            record.whenReceived === undefined ||
+            !Number.isSafeInteger(record.version) ||
+            record.version < 0)
+            throw new DeliveryStorageCorruptionError("Inbox message record is invalid.");
+        if (!(entity.value instanceof Uint8Array))
+            throw new DeliveryStorageCorruptionError("Inbox target ID is invalid.");
+        Values.target(entity, DeliveryStorageCorruptionError);
+        const payload = record.payload.case === undefined
+            ? undefined
+            : Values.signal(record.payload.case, record.payload.value);
+        Values.payloadForLabel(Values.readLabel(record.label), payload, DeliveryStorageCorruptionError);
+        return Object.freeze({
+            id: Object.freeze({ value: Values.text(id.uuid, "Inbox message ID"), shard }),
+            inboxId: Object.freeze({ targetId: clone(AnySchema, entity), targetTypeUrl: inbox.typeUrl }),
+            signalId: signal,
+            ...(payload === undefined ? {} : { signal: payload }),
+            label: Values.readLabel(record.label),
+            status: Values.readStatus(record.status),
+            shard,
+            whenReceived: Values.date(record.whenReceived, "Inbox receive time"),
+            version: BigInt(record.version),
+            ...(record.keepUntil === undefined
+                ? {}
+                : { keepUntil: Values.date(record.keepUntil, "Inbox keep-until time") }),
+        });
+    },
+    input(value) {
+        const id = value.id;
+        const inbox = value.inboxId;
+        const shard = value.shard;
+        if (typeof id.value !== "string" ||
+            id.value.trim().length === 0 ||
+            !(id.shard instanceof ShardIndex) ||
+            !(shard instanceof ShardIndex) ||
+            id.shard.key() !== shard.key())
+            throw new InboxMessageError("Inbox message ID shard does not match message shard.");
+        if (typeof inbox.targetId.typeUrl !== "string" ||
+            inbox.targetId.typeUrl.trim().length === 0 ||
+            !(inbox.targetId.value instanceof Uint8Array) ||
+            typeof inbox.targetTypeUrl !== "string" ||
+            inbox.targetTypeUrl.trim().length === 0 ||
+            typeof value.signalId !== "string" ||
+            value.signalId.trim().length === 0 ||
+            !(value.whenReceived instanceof Date) ||
+            !Number.isFinite(value.whenReceived.getTime()) ||
+            typeof value.version !== "bigint" ||
+            value.version < 0n ||
+            value.version > BigInt(0x7fffffff))
+            throw new InboxMessageError("Inbox message is invalid.");
+        Values.inputLabel(value.label);
+        Values.inputStatus(value.status);
+        if (value.keepUntil !== undefined &&
+            (!(value.keepUntil instanceof Date) || !Number.isFinite(value.keepUntil.getTime())))
+            throw new InboxMessageError("Inbox keep-until time is invalid.");
+        return value;
+    },
+    payload(signal) {
+        if (signal.typeUrl === "type.spine.io/spine.core.Command")
+            return { case: "command", value: fromBinary(CommandSchema, signal.value) };
+        if (signal.typeUrl === "type.spine.io/spine.core.Event")
+            return { case: "event", value: fromBinary(EventSchema, signal.value) };
+        throw new InboxMessageError("Inbox signal must contain a command or event payload.");
+    },
+    target(value, ErrorType) {
+        try {
+            switch (value.typeUrl) {
+                case "type.googleapis.com/google.protobuf.StringValue":
+                    if (fromBinary(StringValueSchema, value.value).value.trim().length === 0)
+                        throw new TypeError("String target ID is blank.");
+                    break;
+                case "type.googleapis.com/google.protobuf.Int32Value":
+                    fromBinary(Int32ValueSchema, value.value);
+                    break;
+                case "type.googleapis.com/google.protobuf.Int64Value":
+                    fromBinary(Int64ValueSchema, value.value);
+                    break;
+            }
+        }
+        catch (error) {
+            throw new ErrorType("Inbox target ID is invalid.", { cause: error });
+        }
+    },
+    payloadForLabel(label, signal, ErrorType) {
+        const expected = label === "HANDLE_COMMAND"
+            ? "type.spine.io/spine.core.Command"
+            : "type.spine.io/spine.core.Event";
+        if (signal?.typeUrl !== expected)
+            throw new ErrorType("Inbox delivery label does not match its signal payload.");
+    },
+    signal(kind, payload) {
+        return kind === "command"
+            ? create(AnySchema, {
+                typeUrl: "type.spine.io/spine.core.Command",
+                value: toBinary(CommandSchema, payload),
+            })
+            : create(AnySchema, {
+                typeUrl: "type.spine.io/spine.core.Event",
+                value: toBinary(EventSchema, payload),
+            });
+    },
+    id(record) {
+        if (record.id === undefined)
+            throw new DeliveryStorageCorruptionError("Inbox message ID is missing.");
+        return record.id;
+    },
+    shard(record) {
+        const index = record.id?.index;
+        if (index === undefined)
+            throw new DeliveryStorageCorruptionError("Inbox message ID shard is missing.");
+        try {
+            return new ShardIndex(index.index, index.ofTotal);
+        }
+        catch (error) {
+            throw new DeliveryStorageCorruptionError("Inbox message shard is invalid.", { cause: error });
+        }
+    },
+    timestamp(ms) {
+        const seconds = Math.floor(ms / 1_000);
+        return create(TimestampSchema, {
+            seconds: BigInt(seconds),
+            nanos: (ms - seconds * 1_000) * 1_000_000,
+        });
+    },
+    date(value, label) {
+        const ms = Number(value.seconds) * 1000 + Math.floor(value.nanos / 1_000_000);
+        if (!Number.isInteger(value.nanos) ||
+            value.nanos < 0 ||
+            value.nanos >= 1_000_000_000 ||
+            !Number.isSafeInteger(ms))
+            throw new DeliveryStorageCorruptionError(`${label} is invalid.`);
+        return new Date(ms);
+    },
+    label(value) {
+        return {
+            HANDLE_COMMAND: InboxLabel.HANDLE_COMMAND,
+            UPDATE_SUBSCRIBER: InboxLabel.UPDATE_SUBSCRIBER,
+            REACT_UPON_EVENT: InboxLabel.REACT_UPON_EVENT,
+            CATCH_UP: InboxLabel.CATCH_UP,
+        }[value];
+    },
+    status(value) {
+        return {
+            TO_DELIVER: InboxMessageStatus.TO_DELIVER,
+            SCHEDULED: InboxMessageStatus.SCHEDULED,
+            DELIVERED: InboxMessageStatus.DELIVERED,
+            TO_CATCH_UP: InboxMessageStatus.TO_CATCH_UP,
+        }[value];
+    },
+    readLabel(value) {
+        const result = {
+            [InboxLabel.HANDLE_COMMAND]: "HANDLE_COMMAND",
+            [InboxLabel.UPDATE_SUBSCRIBER]: "UPDATE_SUBSCRIBER",
+            [InboxLabel.REACT_UPON_EVENT]: "REACT_UPON_EVENT",
+            [InboxLabel.CATCH_UP]: "CATCH_UP",
+        };
+        if (result[value] === undefined)
+            throw new DeliveryStorageCorruptionError("Inbox label is invalid.");
+        return result[value];
+    },
+    readStatus(value) {
+        const result = {
+            [InboxMessageStatus.TO_DELIVER]: "TO_DELIVER",
+            [InboxMessageStatus.SCHEDULED]: "SCHEDULED",
+            [InboxMessageStatus.DELIVERED]: "DELIVERED",
+            [InboxMessageStatus.TO_CATCH_UP]: "TO_CATCH_UP",
+        };
+        if (result[value] === undefined)
+            throw new DeliveryStorageCorruptionError("Inbox status is invalid.");
+        return result[value];
+    },
+    inputLabel(value) {
+        if (!(value === "HANDLE_COMMAND" ||
+            value === "UPDATE_SUBSCRIBER" ||
+            value === "REACT_UPON_EVENT" ||
+            value === "CATCH_UP"))
+            throw new InboxMessageError("Inbox delivery label is invalid.");
+    },
+    inputStatus(value) {
+        if (!(value === "TO_DELIVER" ||
+            value === "SCHEDULED" ||
+            value === "DELIVERED" ||
+            value === "TO_CATCH_UP"))
+            throw new InboxMessageError("Inbox delivery status is invalid.");
+    },
+    text(value, label) {
+        if (typeof value !== "string" || value.trim().length === 0)
+            throw new DeliveryStorageCorruptionError(`${label} is invalid.`);
+        return value;
+    },
+});
+//# sourceMappingURL=inbox-records.js.map

package/dist/delivery/inbox-records.js.map

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

package/dist/delivery/inbox-storage.d.ts

@@ -0,0 +1,83 @@
+import type { StorageContext, StorageFactory } from "@spine-event-engine/storage";
+import { type InboxMessage, type InboxMessageId, type InboxReadOptions, type InboxWriteResult } from "./inbox.js";
+import { ShardIndex } from "./shard-index.js";
+import type { DeliveryWorkSession } from "./delivery-ports.js";
+/**
+ * Stores direct generated inbox records in the configured durable family.
+ */
+export declare class InboxStorage {
+    #private;
+    /**
+     * Opens direct inbox storage.
+     *
+     * @param options Configures the storage context, factory, and optional clock.
+     */
+    constructor(options: InboxStorageOptions);
+    /**
+     * Reads ordered direct inbox rows from one shard.
+     *
+     * @param shard Identifies the shard to query.
+     * @param options Filters and bounds the returned page.
+     * @returns The matching durable inbox messages.
+     */
+    read(shard: ShardIndex, options?: InboxReadOptions): Promise<readonly InboxMessage[]>;
+    /**
+     * Reads one exact direct inbox row.
+     *
+     * @param id Identifies the message and shard.
+     * @returns The durable message, or `undefined` when it is absent.
+     */
+    readMessage(id: InboxMessageId): Promise<InboxMessage | undefined>;
+    /**
+     * Writes one direct inbox row without overwriting a collision.
+     *
+     * @param message Supplies the message to persist.
+     * @returns Whether the row was written or matched an existing duplicate.
+     */
+    write(message: InboxMessage): Promise<InboxWriteResult>;
+    /**
+     * Marks one exact pending row delivered.
+     *
+     * @param message Supplies the expected pending snapshot.
+     * @returns The delivered row, or `undefined` when the snapshot no longer matches.
+     */
+    markDelivered(message: InboxMessage): Promise<InboxMessage | undefined>;
+    /**
+     * Removes one eligible delivered row when the leased session remains current.
+     *
+     * @param message Supplies the exact delivered snapshot to remove.
+     * @param session Supplies the leased session that owns the message shard.
+     * @param options Propagates cancellation and a delivery deadline.
+     * @returns Whether the provider atomically removed the exact durable row.
+     */
+    removeDelivered(message: InboxMessage, session: DeliveryWorkSession, options?: import("./delivery-ports.js").DeliveryOperationOptions): Promise<boolean>;
+    /**
+     * Removes one exact pending duplicate while its leased session remains current.
+     *
+     * @param message Supplies the expected pending snapshot.
+     * @param session Supplies the session that holds the message shard.
+     * @param options Propagates cancellation and a delivery deadline.
+     * @returns Whether the provider atomically removed the exact pending snapshot.
+     */
+    removeDuplicate(message: InboxMessage, session: DeliveryWorkSession, options?: import("./delivery-ports.js").DeliveryOperationOptions): Promise<boolean>;
+}
+/**
+ * Configures direct durable inbox storage.
+ */
+export interface InboxStorageOptions {
+    /**
+     * Storage context that owns this inbox family.
+     */
+    readonly context: StorageContext;
+    /**
+     * Factory that opens the direct inbox record storage.
+     */
+    readonly storageFactory: StorageFactory;
+    /**
+     * Returns the current time used when evaluating delivered-row retention.
+     *
+     * @returns The current time.
+     */
+    readonly now?: () => Date;
+}
+//# sourceMappingURL=inbox-storage.d.ts.map

package/dist/delivery/inbox-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-storage.d.ts","sourceRoot":"","sources":["../../src/delivery/inbox-storage.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAiB,cAAc,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGjG,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK/D;;GAEG;AACH,qBAAa,YAAY;;IAKvB;;;;OAIG;gBACS,OAAO,EAAE,mBAAmB;IAOxC;;;;;;OAMG;IACG,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;IA0B/F;;;;;OAKG;IACG,WAAW,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAWxE;;;;;OAKG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmB7D;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IA2B7E;;;;;;;OAOG;IACG,eAAe,CACnB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,wBAAwB,GAC/D,OAAO,CAAC,OAAO,CAAC;IASnB;;;;;;;OAOG;IACG,eAAe,CACnB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,wBAAwB,GAC/D,OAAO,CAAC,OAAO,CAAC;CAsEpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAGlC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B"}