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

package/dist/delivery/inbox-storage.js

@@ -0,0 +1,336 @@
+/*
+ * 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, toBinary } from "@bufbuild/protobuf";
+import { TimestampSchema } from "@bufbuild/protobuf/wkt";
+import { TenantIdSchema } from "@spine-event-engine/proto";
+import { InboxMessageIdSchema } from "@spine-event-engine/proto/delivery";
+import { ShardIndexSchema, ShardSessionRecordSchema } from "@spine-event-engine/proto/delivery";
+import { DeliveryCleanupStorageFactories } from "@spine-event-engine/storage/provider";
+import { InboxMessageError, } from "./inbox.js";
+import { InboxRecords, inboxRecordSpec } from "./inbox-records.js";
+import { ShardIndex } from "./shard-index.js";
+import { shardSessionRecordSpec } from "./sharded-work-registry.js";
+const defaultReadLimit = 100;
+const maxReadLimit = 1_000;
+/**
+ * Stores direct generated inbox records in the configured durable family.
+ */
+export class InboxStorage {
+    #context;
+    #storageFactory;
+    #now;
+    /**
+     * Opens direct inbox storage.
+     *
+     * @param options Configures the storage context, factory, and optional clock.
+     */
+    constructor(options) {
+        this.#context = Values.snapshotContext(options.context);
+        this.#storageFactory = options.storageFactory;
+        this.#now = options.now ?? (() => new Date());
+        Object.freeze(this);
+    }
+    /**
+     * 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.
+     */
+    async read(shard, options = {}) {
+        const requested = Values.shard(shard);
+        const limit = Values.limit(options.limit ?? defaultReadLimit);
+        const offset = Values.offset(options.offset);
+        const after = Values.after(options.after, requested);
+        const storage = this.#storage();
+        try {
+            const rows = await storage.queryEntries({
+                filters: [
+                    { column: "shard_index", value: requested.index },
+                    { column: "shard_total", value: requested.ofTotal },
+                    ...(options.statuses === undefined
+                        ? []
+                        : [{ column: "status", value: options.statuses.map(Values.status) }]),
+                ],
+                sort: [{ field: "when_received" }, { field: "version" }, { field: "message_id" }],
+                limit,
+                ...(offset === undefined ? {} : { offset }),
+                ...(after === undefined ? {} : { after }),
+            });
+            return Object.freeze(rows.map((row) => InboxRecords.read(row.record, row.id)));
+        }
+        finally {
+            storage.close();
+        }
+    }
+    /**
+     * Reads one exact direct inbox row.
+     *
+     * @param id Identifies the message and shard.
+     * @returns The durable message, or `undefined` when it is absent.
+     */
+    async readMessage(id) {
+        const wireId = Values.id(id);
+        const storage = this.#storage();
+        try {
+            const record = await storage.read(wireId);
+            return record === undefined ? undefined : InboxRecords.read(record, wireId);
+        }
+        finally {
+            storage.close();
+        }
+    }
+    /**
+     * 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.
+     */
+    async write(message) {
+        const record = InboxRecords.write(message);
+        const id = Values.wireId(record);
+        const storage = this.#storage();
+        try {
+            Values.atomic(storage);
+            if (await storage.compareAndSet(id, undefined, record)) {
+                return Object.freeze({ outcome: "WRITTEN", message: InboxRecords.read(record, id) });
+            }
+            const existing = await storage.read(id);
+            if (existing !== undefined && Values.same(existing, record)) {
+                return Object.freeze({ outcome: "DUPLICATE", message: InboxRecords.read(existing, id) });
+            }
+            throw new InboxMessageError("Inbox message ID already exists.");
+        }
+        finally {
+            storage.close();
+        }
+    }
+    /**
+     * 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.
+     */
+    async markDelivered(message) {
+        const expected = InboxRecords.write(message);
+        const id = Values.wireId(expected);
+        const storage = this.#storage();
+        try {
+            Values.atomic(storage);
+            const current = await storage.read(id);
+            if (current === undefined)
+                return undefined;
+            const decoded = InboxRecords.read(current, id);
+            if (decoded.status === "DELIVERED") {
+                return Values.same(current, InboxRecords.write({ ...message, status: "DELIVERED" }))
+                    ? decoded
+                    : undefined;
+            }
+            if (decoded.status !== "TO_DELIVER" || !Values.same(current, expected))
+                return undefined;
+            const delivered = InboxRecords.write({ ...decoded, status: "DELIVERED" });
+            if (await storage.compareAndSet(id, current, delivered))
+                return InboxRecords.read(delivered, id);
+            const successor = await storage.read(id);
+            return successor !== undefined && Values.same(successor, delivered)
+                ? InboxRecords.read(successor, id)
+                : undefined;
+        }
+        finally {
+            storage.close();
+        }
+    }
+    /**
+     * 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.
+     */
+    async removeDelivered(message, session, options) {
+        if (message.status !== "DELIVERED" ||
+            (message.keepUntil !== undefined && message.keepUntil.getTime() > Values.now(this.#now)))
+            return false;
+        return this.#remove(message, session, options);
+    }
+    /**
+     * 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.
+     */
+    async removeDuplicate(message, session, options) {
+        if (message.status !== "TO_DELIVER")
+            return false;
+        return this.#remove(message, session, options);
+    }
+    async #remove(message, session, options) {
+        const isActive = this.#activeOperation(options);
+        if (isActive === undefined ||
+            !isActive() ||
+            session.kind !== "LEASED" ||
+            !this.#matchesSession(message, session))
+            return false;
+        return this.#removeCurrent(message, session, options, isActive);
+    }
+    #activeOperation(options) {
+        if (options?.timeoutMs !== undefined &&
+            (!Number.isSafeInteger(options.timeoutMs) || options.timeoutMs < 0))
+            return undefined;
+        const deadline = options?.timeoutMs === undefined ? undefined : Values.now(this.#now) + options.timeoutMs;
+        return () => !options?.signal?.aborted && (deadline === undefined || Values.now(this.#now) < deadline);
+    }
+    #matchesSession(message, session) {
+        return session.kind === "LEASED" && session.shard.key() === message.shard.key();
+    }
+    async #removeCurrent(message, session, options, isActive) {
+        const expected = InboxRecords.write(message);
+        const cleanup = DeliveryCleanupStorageFactories.create(this.#storageFactory);
+        try {
+            return await cleanup.remove({
+                context: Values.context(this.#context),
+                ...(options === undefined ? {} : { operation: { ...options, isActive } }),
+                inbox: { spec: inboxRecordSpec, id: Values.wireId(expected), expected },
+                session: {
+                    spec: shardSessionRecordSpec,
+                    id: create(ShardIndexSchema, {
+                        index: session.shard.index,
+                        ofTotal: session.shard.ofTotal,
+                    }),
+                    expected: Values.session(session),
+                    isCurrent: (current) => Values.sessionCurrent(current, session, Values.now(this.#now)),
+                },
+            });
+        }
+        finally {
+            cleanup.close();
+        }
+    }
+    #storage() {
+        return this.#storageFactory.createRecordStorage(Values.context(this.#context), inboxRecordSpec);
+    }
+}
+const Values = Object.freeze({
+    snapshotContext(context) {
+        return context.multitenant
+            ? {
+                name: context.name,
+                multitenant: true,
+                tenantId: clone(TenantIdSchema, context.tenantId),
+            }
+            : { name: context.name, multitenant: false };
+    },
+    status(value) {
+        return { TO_DELIVER: 1, SCHEDULED: 2, DELIVERED: 3, TO_CATCH_UP: 4 }[value];
+    },
+    id(value) {
+        return create(InboxMessageIdSchema, {
+            uuid: value.value,
+            index: { index: value.shard.index, ofTotal: value.shard.ofTotal },
+        });
+    },
+    wireId(value) {
+        if (value.id === undefined)
+            throw new InboxMessageError("Inbox message ID is invalid.");
+        return value.id;
+    },
+    same(left, right) {
+        return Buffer.from(toBinary(inboxRecordSpec.recordType, left)).equals(Buffer.from(toBinary(inboxRecordSpec.recordType, right)));
+    },
+    shard(value) {
+        if (!(value instanceof ShardIndex))
+            throw new InboxMessageError("Inbox shard is invalid.");
+        return value;
+    },
+    limit(value) {
+        if (!Number.isSafeInteger(value) ||
+            typeof value !== "number" ||
+            value <= 0 ||
+            value > maxReadLimit) {
+            throw new InboxMessageError(`Inbox read limit must be a positive safe integer at most ${String(maxReadLimit)}.`);
+        }
+        return value;
+    },
+    offset(value) {
+        if (value === undefined)
+            return undefined;
+        if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+            throw new InboxMessageError("Inbox read offset must be a non-negative safe integer.");
+        return value;
+    },
+    after(value, shard) {
+        if (value === undefined)
+            return undefined;
+        if (typeof value.messageId !== "string" ||
+            value.messageId.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 read continuation is invalid.");
+        return {
+            values: [
+                { field: "when_received", value: Values.timestamp(value.whenReceived.getTime()) },
+                { field: "version", value: Number(value.version) },
+                { field: "message_id", value: value.messageId },
+            ],
+            id: Values.id({ value: value.messageId, shard }),
+        };
+    },
+    timestamp(ms) {
+        const seconds = Math.floor(ms / 1_000);
+        return create(TimestampSchema, {
+            seconds: BigInt(seconds),
+            nanos: (ms - seconds * 1_000) * 1_000_000,
+        });
+    },
+    atomic(storage) {
+        if (!storage.atomicCompareAndSet)
+            throw new InboxMessageError("Inbox storage requires atomic compare-and-set.");
+    },
+    now(clock) {
+        const value = clock();
+        if (!(value instanceof Date) || !Number.isFinite(value.getTime()))
+            throw new InboxMessageError("Inbox storage clock returned an invalid time.");
+        return value.getTime();
+    },
+    context(context) {
+        return context.multitenant
+            ? {
+                name: `${context.name}.delivery.inbox`,
+                multitenant: true,
+                tenantId: clone(TenantIdSchema, context.tenantId),
+            }
+            : { name: `${context.name}.delivery.inbox`, multitenant: false };
+    },
+    session(value) {
+        return create(ShardSessionRecordSchema, {
+            index: { index: value.shard.index, ofTotal: value.shard.ofTotal },
+            whenLastPicked: Values.timestamp(value.pickedUpAt.getTime()),
+            worker: value.worker,
+        });
+    },
+    sessionCurrent(value, expected, now) {
+        return (value.index?.index === expected.shard.index &&
+            value.index.ofTotal === expected.shard.ofTotal &&
+            value.worker?.nodeId?.value === expected.worker?.nodeId?.value &&
+            value.worker?.value === expected.worker?.value &&
+            expected.expiresAt.getTime() > now);
+    },
+});
+//# sourceMappingURL=inbox-storage.js.map

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

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

package/dist/delivery/inbox.d.ts

@@ -0,0 +1,272 @@
+import { type Any } from "@bufbuild/protobuf/wkt";
+import type { InboxStorage } from "./inbox-storage.js";
+import type { DeliveryOperationOptions, DeliveryWorkSession } from "./delivery-ports.js";
+import type { ShardIndex } from "./shard-index.js";
+/**
+ * Small JVM-style inbox facade over durable storage.
+ */
+export declare class Inbox {
+    #private;
+    /**
+     * Local inbox work is admitted only under a renewable leased session.
+     */
+    readonly sessionKind: "LEASED";
+    /**
+     * Intentional low-level escape hatch for storage-focused tests and integrations.
+     */
+    readonly storage: InboxStorage;
+    /**
+     * Opens an inbox over durable inbox storage.
+     *
+     * @param storage Stores pending and delivered inbox rows directly.
+     */
+    constructor(storage: InboxStorage);
+    /**
+     * Stores one message in durable inbox storage.
+     *
+     * @param input Describes the message to make durable.
+     * @returns The write or deduplication outcome.
+     */
+    receive(input: InboxMessageInput): Promise<InboxWriteResult>;
+    /**
+     * Reads ordered messages for one shard.
+     *
+     * @param shard Selects the shard to inspect.
+     * @param options Filters and bounds the ordered page.
+     * @returns The matching durable messages.
+     */
+    read(shard: ShardIndex, options?: InboxReadOptions): Promise<readonly InboxMessage[]>;
+    /**
+     * Reads one exact durable inbox message by ID.
+     *
+     * @param id Identifies the durable message.
+     * @returns The message when it remains durable.
+     */
+    readMessage(id: InboxMessageId): Promise<InboxMessage | undefined>;
+    /**
+     * Updates one pending message to delivered when its snapshot still matches.
+     *
+     * @param message Supplies the pending message snapshot.
+     * @returns The delivered message, or `undefined` when the durable row is missing,
+     * not pending, or no longer matches the snapshot. Matching delivered rows return
+     * idempotently so concurrent workers converge without re-dispatching.
+     */
+    markDelivered(message: InboxMessage): Promise<InboxMessage | undefined>;
+    /**
+     * Removes one exact pending duplicate while its shard session remains current.
+     *
+     * @param message Supplies the pending duplicate snapshot.
+     * @param session Supplies the session that holds the message shard.
+     * @param options Propagates cancellation and a delivery deadline.
+     * @returns Whether storage atomically removed the exact pending snapshot.
+     */
+    removeDuplicate(message: InboxMessage, session: DeliveryWorkSession, options?: DeliveryOperationOptions): Promise<boolean>;
+    /**
+     * Removes one delivered message only when direct provider cleanup can prove
+     * current ownership and the exact durable snapshot in one atomic operation.
+     *
+     * @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?: DeliveryOperationOptions): Promise<boolean>;
+}
+/**
+ * Durable target inbox identity.
+ */
+export interface InboxId {
+    /**
+     * Target Entity ID packed as canonical `Any` type URL and bytes.
+     *
+     * Durable boundaries snapshot this value. Callers and custom delivery
+     * strategies must treat it as typed identity, not as a display string.
+     */
+    readonly targetId: Any;
+    /**
+     * Target entity state type URL.
+     */
+    readonly targetTypeUrl: string;
+}
+/**
+ * Provides canonical typed Inbox target identity operations.
+ */
+export declare const InboxTargets: Readonly<{
+    clone(value: Any): Any;
+    key(value: Any): string;
+    shardKey(value: Any): string;
+    equal(left: Any, right: Any): boolean;
+}>;
+/**
+ * Durable inbox message identity.
+ */
+export interface InboxMessageId {
+    /**
+     * Message UUID within one shard.
+     */
+    readonly value: string;
+    /**
+     * Shard that owns the message; must match `InboxMessage.shard`.
+     */
+    readonly shard: ShardIndex;
+}
+/**
+ * Raised by public delivery APIs when a caller provides an invalid inbox
+ * message. Corrupt durable delivery rows raise
+ * `DeliveryStorageCorruptionError`.
+ */
+export declare class InboxMessageError extends Error {
+    /**
+     * Creates an error for invalid public inbox input.
+     *
+     * @param message Describes the invalid input.
+     * @param options Optionally preserves the originating failure.
+     */
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Delivery destination label.
+ */
+export type DeliveryLabel = "HANDLE_COMMAND" | "UPDATE_SUBSCRIBER" | "REACT_UPON_EVENT" | "CATCH_UP";
+/**
+ * Durable delivery state.
+ */
+export type DeliveryStatus = "TO_DELIVER" | "SCHEDULED" | "DELIVERED" | "TO_CATCH_UP";
+/**
+ * One durable inbox message.
+ */
+export interface InboxMessage {
+    /**
+     * Durable record identity.
+     */
+    readonly id: InboxMessageId;
+    /**
+     * Target inbox identity.
+     */
+    readonly inboxId: InboxId;
+    /**
+     * Original signal identity used for delivery deduplication.
+     */
+    readonly signalId: string;
+    /**
+     * Optional packed signal payload.
+     */
+    readonly signal?: Any;
+    /**
+     * Delivery destination label.
+     */
+    readonly label: DeliveryLabel;
+    /**
+     * Current delivery status.
+     */
+    readonly status: DeliveryStatus;
+    /**
+     * Shard responsible for delivery; must match `id.shard`.
+     */
+    readonly shard: ShardIndex;
+    /**
+     * Durable receive time.
+     */
+    readonly whenReceived: Date;
+    /**
+     * Ordering tie-breaker for equal receive times.
+     */
+    readonly version: bigint;
+    /**
+     * Optional deduplication retention deadline.
+     */
+    readonly keepUntil?: Date;
+}
+/**
+ * Write request for one new inbox message.
+ */
+export interface InboxMessageInput {
+    /**
+     * Target inbox identity.
+     */
+    readonly inboxId: InboxId;
+    /**
+     * Original signal identity used for delivery deduplication.
+     */
+    readonly signalId: string;
+    /**
+     * Optional packed signal payload.
+     */
+    readonly signal?: Any;
+    /**
+     * Delivery destination label.
+     */
+    readonly label: DeliveryLabel;
+    /**
+     * Current delivery status.
+     */
+    readonly status: DeliveryStatus;
+    /**
+     * Shard responsible for delivery.
+     */
+    readonly shard: ShardIndex;
+    /**
+     * Durable receive time.
+     */
+    readonly whenReceived: Date;
+    /**
+     * Ordering tie-breaker for equal receive times.
+     */
+    readonly version: bigint;
+    /**
+     * Optional deduplication retention deadline.
+     */
+    readonly keepUntil?: Date;
+}
+/**
+ * Read filter for one shard page.
+ */
+export interface InboxReadOptions {
+    /**
+     * Optional delivery statuses to keep.
+     */
+    readonly statuses?: readonly DeliveryStatus[];
+    /**
+     * Optional page limit for one ordered page; must be positive and at most 1000.
+     */
+    readonly limit?: number;
+    /**
+     * Optional stable inbox row key after which the ordered read should continue.
+     */
+    readonly after?: InboxReadContinuation;
+    /**
+     * Optional non-negative page offset in inbox order; defaults to the first row.
+     */
+    readonly offset?: number;
+}
+/**
+ * Stable ordered inbox row key used to continue an ordered read.
+ */
+export interface InboxReadContinuation {
+    /**
+     * Inbox message UUID from the last row of the previous page.
+     */
+    readonly messageId: string;
+    /**
+     * Receive time from the last row of the previous page.
+     */
+    readonly whenReceived: Date;
+    /**
+     * Version from the last row of the previous page.
+     */
+    readonly version: bigint;
+}
+/**
+ * Durable inbox write outcome.
+ */
+export interface InboxWriteResult {
+    /**
+     * Whether the message was written or matched an existing dedup key.
+     */
+    readonly outcome: "WRITTEN" | "DUPLICATE";
+    /**
+     * Stored message selected for the outcome.
+     */
+    readonly message: InboxMessage;
+}
+//# sourceMappingURL=inbox.d.ts.map

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

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