@beignet/core 0.0.1 → 0.0.2

package/dist/outbox/index.js

@@ -0,0 +1,482 @@
+/**
+ * @beignet/core/outbox
+ *
+ * Durable outbox primitives for transactionally recording events and jobs that
+ * should be delivered after the owning database transaction commits.
+ */
+import { parseEventPayload, } from "../events";
+import { parseJobPayload } from "../jobs";
+/**
+ * Default lease duration for claimed outbox messages.
+ */
+export const DEFAULT_OUTBOX_LEASE_MS = 30_000;
+/**
+ * Default maximum delivery attempts before a message is dead-lettered.
+ */
+export const DEFAULT_OUTBOX_MAX_ATTEMPTS = 3;
+/**
+ * Error thrown when an outbox payload is not JSON serializable.
+ */
+export class OutboxSerializationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OutboxSerializationError";
+    }
+}
+/**
+ * Error thrown when an outbox message cannot be resolved through the registry.
+ */
+export class OutboxRegistryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OutboxRegistryError";
+    }
+}
+/**
+ * Error thrown when a claimed message cannot be updated with the supplied token.
+ */
+export class OutboxClaimError extends Error {
+    /**
+     * Message ID involved in the claim error.
+     */
+    id;
+    constructor(args) {
+        super(args.message);
+        this.name = "OutboxClaimError";
+        this.id = args.id;
+    }
+}
+function assertNonEmptyString(name, value) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`${name} must be a non-empty string`);
+    }
+}
+function assertPositiveInteger(name, value) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`${name} must be a positive integer`);
+    }
+}
+function cloneDate(value) {
+    return new Date(value.getTime());
+}
+function createId() {
+    if (!globalThis.crypto?.randomUUID) {
+        throw new Error("crypto.randomUUID is required to create outbox IDs.");
+    }
+    return globalThis.crypto.randomUUID();
+}
+function assertJsonValue(value, path = [], seen = new WeakSet()) {
+    const label = path.length > 0 ? path.join(".") : "payload";
+    if (value === null)
+        return null;
+    if (typeof value === "string" ||
+        typeof value === "boolean" ||
+        typeof value === "number") {
+        if (typeof value === "number" && !Number.isFinite(value)) {
+            throw new OutboxSerializationError(`Outbox ${label} must be a finite number.`);
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        if (seen.has(value)) {
+            throw new OutboxSerializationError(`Outbox ${label} must be JSON serializable. Circular references are not supported.`);
+        }
+        seen.add(value);
+        try {
+            return value.map((item, index) => assertJsonValue(item, [...path, String(index)], seen));
+        }
+        finally {
+            seen.delete(value);
+        }
+    }
+    if (typeof value === "object") {
+        if (value instanceof Date) {
+            throw new OutboxSerializationError(`Outbox ${label} must be JSON serializable. Convert Date values to strings before enqueueing.`);
+        }
+        if (seen.has(value)) {
+            throw new OutboxSerializationError(`Outbox ${label} must be JSON serializable. Circular references are not supported.`);
+        }
+        seen.add(value);
+        try {
+            const record = value;
+            const output = {};
+            for (const key of Object.keys(record)) {
+                const child = record[key];
+                if (child === undefined) {
+                    throw new OutboxSerializationError(`Outbox ${[...path, key].join(".")} cannot be undefined.`);
+                }
+                output[key] = assertJsonValue(child, [...path, key], seen);
+            }
+            return output;
+        }
+        finally {
+            seen.delete(value);
+        }
+    }
+    throw new OutboxSerializationError(`Outbox ${label} must be JSON serializable. Received ${typeof value}.`);
+}
+/**
+ * Convert an unknown value to an outbox-safe JSON value.
+ *
+ * Dates, undefined values, functions, non-finite numbers, symbols, and circular
+ * references are rejected so durable adapters can store the payload safely.
+ */
+export function toOutboxJsonValue(value) {
+    const jsonValue = assertJsonValue(value);
+    return JSON.parse(JSON.stringify(jsonValue));
+}
+/**
+ * Serialize an unknown delivery error into outbox error metadata.
+ */
+export function serializeOutboxError(error) {
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+            stack: error.stack,
+        };
+    }
+    if (typeof error === "string") {
+        return { message: error };
+    }
+    return { message: "Unknown outbox delivery error" };
+}
+function copyMessage(message) {
+    return {
+        ...message,
+        availableAt: cloneDate(message.availableAt),
+        claimedAt: message.claimedAt ? cloneDate(message.claimedAt) : null,
+        lockedUntil: message.lockedUntil ? cloneDate(message.lockedUntil) : null,
+        deliveredAt: message.deliveredAt ? cloneDate(message.deliveredAt) : null,
+        createdAt: cloneDate(message.createdAt),
+        updatedAt: cloneDate(message.updatedAt),
+        lastError: message.lastError ? { ...message.lastError } : null,
+    };
+}
+function toClaimedMessage(message) {
+    if (message.status !== "claimed" ||
+        !message.claimToken ||
+        !message.claimedAt ||
+        !message.lockedUntil) {
+        throw new OutboxClaimError({
+            id: message.id,
+            message: `Outbox message "${message.id}" is not claimed.`,
+        });
+    }
+    return {
+        ...copyMessage(message),
+        status: "claimed",
+        claimToken: message.claimToken,
+        claimedAt: cloneDate(message.claimedAt),
+        lockedUntil: cloneDate(message.lockedUntil),
+    };
+}
+/**
+ * Create a validated pending outbox message.
+ */
+export function createOutboxMessage(input, options = {}) {
+    assertNonEmptyString("kind", input.kind);
+    assertNonEmptyString("name", input.name);
+    if (input.id !== undefined)
+        assertNonEmptyString("id", input.id);
+    if (input.maxAttempts !== undefined) {
+        assertPositiveInteger("maxAttempts", input.maxAttempts);
+    }
+    const now = options.now ?? new Date();
+    return {
+        id: options.id ?? input.id ?? createId(),
+        kind: input.kind,
+        name: input.name,
+        payload: toOutboxJsonValue(input.payload),
+        status: "pending",
+        attempts: 0,
+        maxAttempts: input.maxAttempts ?? DEFAULT_OUTBOX_MAX_ATTEMPTS,
+        availableAt: input.availableAt
+            ? cloneDate(input.availableAt)
+            : cloneDate(now),
+        claimedAt: null,
+        lockedUntil: null,
+        claimToken: null,
+        deliveredAt: null,
+        lastError: null,
+        createdAt: cloneDate(now),
+        updatedAt: cloneDate(now),
+    };
+}
+function isEligible(message, now) {
+    if (message.status === "pending") {
+        return message.availableAt.getTime() <= now.getTime();
+    }
+    return (message.status === "claimed" &&
+        message.lockedUntil !== null &&
+        message.lockedUntil.getTime() <= now.getTime());
+}
+/**
+ * Create an in-memory outbox for tests and local examples.
+ *
+ * The memory outbox is process-local and not durable.
+ */
+export function createMemoryOutbox() {
+    const messages = new Map();
+    function getClaimedOrThrow(id, claimToken) {
+        const message = messages.get(id);
+        if (!message) {
+            throw new OutboxClaimError({
+                id,
+                message: `Outbox message "${id}" does not exist.`,
+            });
+        }
+        if (message.status !== "claimed" || message.claimToken !== claimToken) {
+            throw new OutboxClaimError({
+                id,
+                message: `Outbox message "${id}" is not claimed by this worker.`,
+            });
+        }
+        return message;
+    }
+    return {
+        get messages() {
+            return [...messages.values()].map(copyMessage);
+        },
+        async enqueue(input) {
+            const message = createOutboxMessage(input);
+            if (messages.has(message.id)) {
+                throw new Error(`Outbox message "${message.id}" already exists.`);
+            }
+            messages.set(message.id, message);
+            return copyMessage(message);
+        },
+        async claimBatch(options) {
+            assertPositiveInteger("limit", options.limit);
+            const now = options.now ?? new Date();
+            const leaseMs = options.leaseMs ?? DEFAULT_OUTBOX_LEASE_MS;
+            assertPositiveInteger("leaseMs", leaseMs);
+            const lockedUntil = new Date(now.getTime() + leaseMs);
+            const claimed = [];
+            const eligible = [...messages.values()]
+                .filter((message) => isEligible(message, now))
+                .sort((a, b) => {
+                const available = a.availableAt.getTime() - b.availableAt.getTime();
+                if (available !== 0)
+                    return available;
+                return a.createdAt.getTime() - b.createdAt.getTime();
+            })
+                .slice(0, options.limit);
+            for (const message of eligible) {
+                message.status = "claimed";
+                message.attempts += 1;
+                message.claimToken = createId();
+                message.claimedAt = cloneDate(now);
+                message.lockedUntil = cloneDate(lockedUntil);
+                message.updatedAt = cloneDate(now);
+                claimed.push(toClaimedMessage(message));
+            }
+            return claimed;
+        },
+        async markDelivered(input) {
+            assertNonEmptyString("id", input.id);
+            assertNonEmptyString("claimToken", input.claimToken);
+            const message = getClaimedOrThrow(input.id, input.claimToken);
+            const now = input.now ?? new Date();
+            message.status = "delivered";
+            message.deliveredAt = cloneDate(now);
+            message.claimToken = null;
+            message.claimedAt = null;
+            message.lockedUntil = null;
+            message.updatedAt = cloneDate(now);
+        },
+        async markFailed(input) {
+            assertNonEmptyString("id", input.id);
+            assertNonEmptyString("claimToken", input.claimToken);
+            const message = getClaimedOrThrow(input.id, input.claimToken);
+            const now = input.now ?? new Date();
+            message.status = input.deadLetter ? "deadLettered" : "pending";
+            message.lastError = serializeOutboxError(input.error);
+            message.availableAt = input.retryAt
+                ? cloneDate(input.retryAt)
+                : cloneDate(now);
+            message.claimToken = null;
+            message.claimedAt = null;
+            message.lockedUntil = null;
+            message.updatedAt = cloneDate(now);
+        },
+        clear() {
+            messages.clear();
+        },
+    };
+}
+function mapDefinitions(kind, defs) {
+    const map = new Map();
+    for (const def of defs) {
+        if (map.has(def.name)) {
+            throw new OutboxRegistryError(`Duplicate ${kind} definition "${def.name}" in outbox registry.`);
+        }
+        map.set(def.name, def);
+    }
+    return map;
+}
+/**
+ * Define the events and jobs that an outbox drain worker can deliver.
+ *
+ * Duplicate names throw because message delivery resolves by name.
+ */
+export function defineOutboxRegistry(input) {
+    return {
+        events: mapDefinitions("event", input.events ?? []),
+        jobs: mapDefinitions("job", input.jobs ?? []),
+    };
+}
+/**
+ * Validate an event payload and enqueue it as an outbox message.
+ */
+export async function enqueueEvent(outbox, event, payload, options = {}) {
+    const parsed = await parseEventPayload(event, payload);
+    return outbox.enqueue({
+        id: options.id,
+        kind: "event",
+        name: event.name,
+        payload: toOutboxJsonValue(parsed),
+        availableAt: options.availableAt,
+        maxAttempts: options.maxAttempts,
+    });
+}
+/**
+ * Validate a job payload and enqueue it as an outbox message.
+ */
+export async function enqueueJob(outbox, job, payload, options = {}) {
+    const parsed = await parseJobPayload(job, payload);
+    return outbox.enqueue({
+        id: options.id,
+        kind: "job",
+        name: job.name,
+        payload: toOutboxJsonValue(parsed),
+        availableAt: options.availableAt,
+        maxAttempts: options.maxAttempts,
+    });
+}
+/**
+ * Create a domain event recorder that writes events to the outbox.
+ */
+export function createOutboxEventRecorder(outbox, options = {}) {
+    return {
+        async record(event, payload) {
+            await enqueueEvent(outbox, event, payload, options);
+        },
+        entries() {
+            return [];
+        },
+        clear() { },
+        async flush() { },
+    };
+}
+/**
+ * Create a job dispatcher that writes jobs to the outbox.
+ */
+export function createOutboxJobDispatcher(outbox, options = {}) {
+    return {
+        async dispatch(job, payload) {
+            await enqueueJob(outbox, job, payload, options);
+        },
+    };
+}
+function resolveRetryDelayMs(options, message, error, now) {
+    if (typeof options.retryDelayMs === "function") {
+        const delay = options.retryDelayMs({ message, error, now });
+        assertPositiveInteger("retryDelayMs", delay);
+        return delay;
+    }
+    if (options.retryDelayMs !== undefined) {
+        assertPositiveInteger("retryDelayMs", options.retryDelayMs);
+        return options.retryDelayMs;
+    }
+    return Math.min(60_000, 1000 * 2 ** Math.max(0, message.attempts - 1));
+}
+async function deliverOutboxMessage(options, message) {
+    if (message.kind === "event") {
+        if (!options.eventBus) {
+            throw new OutboxRegistryError(`Cannot deliver event "${message.name}" without an event bus.`);
+        }
+        const event = options.registry.events.get(message.name);
+        if (!event) {
+            throw new OutboxRegistryError(`Outbox registry does not include event "${message.name}".`);
+        }
+        const payload = await parseEventPayload(event, message.payload);
+        await options.eventBus.publish(event, payload);
+        return;
+    }
+    if (!options.jobs) {
+        throw new OutboxRegistryError(`Cannot deliver job "${message.name}" without a job dispatcher.`);
+    }
+    const job = options.registry.jobs.get(message.name);
+    if (!job) {
+        throw new OutboxRegistryError(`Outbox registry does not include job "${message.name}".`);
+    }
+    const payload = await parseJobPayload(job, message.payload);
+    await options.jobs.dispatch(job, payload);
+}
+/**
+ * Claim and deliver one batch of outbox messages.
+ *
+ * This does not loop forever; production workers should call it on their own
+ * polling cadence. Event and job messages require matching registry entries.
+ * Failed messages are retried with backoff until `maxAttempts`, then
+ * dead-lettered.
+ */
+export async function drainOutbox(options) {
+    const batchSize = options.batchSize ?? 100;
+    assertPositiveInteger("batchSize", batchSize);
+    const now = options.now ?? new Date();
+    const messages = await options.outbox.claimBatch({
+        limit: batchSize,
+        now,
+        leaseMs: options.leaseMs,
+    });
+    const result = {
+        claimed: messages.length,
+        delivered: 0,
+        retried: 0,
+        deadLettered: 0,
+    };
+    for (const message of messages) {
+        try {
+            await deliverOutboxMessage(options, message);
+            await options.outbox.markDelivered({
+                id: message.id,
+                claimToken: message.claimToken,
+                now,
+            });
+            result.delivered += 1;
+        }
+        catch (error) {
+            try {
+                await options.onError?.(error, message);
+            }
+            catch {
+                // Preserve the delivery failure path so the message is retried or
+                // dead-lettered even if the observer fails.
+            }
+            const deadLetter = message.attempts >= message.maxAttempts;
+            const retryDelayMs = deadLetter
+                ? 0
+                : resolveRetryDelayMs(options, message, error, now);
+            await options.outbox.markFailed({
+                id: message.id,
+                claimToken: message.claimToken,
+                error,
+                deadLetter,
+                now,
+                retryAt: deadLetter
+                    ? undefined
+                    : new Date(now.getTime() + retryDelayMs),
+            });
+            if (deadLetter) {
+                result.deadLettered += 1;
+            }
+            else {
+                result.retried += 1;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/outbox/index.js.map

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

package/dist/pagination/index.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Sort direction for list queries.
+ */
+export type SortDirection = "asc" | "desc";
+/**
+ * Sort option for a whitelisted field.
+ */
+export type SortOption<Field extends string = string> = {
+    /**
+     * Field to sort by.
+     */
+    field: Field;
+    /**
+     * Sort direction.
+     */
+    direction: SortDirection;
+};
+/**
+ * Normalized offset pagination request.
+ */
+export interface OffsetPage {
+    /**
+     * Pagination mode.
+     */
+    readonly kind: "offset";
+    /**
+     * Page size after defaulting and max-limit clamping.
+     */
+    readonly limit: number;
+    /**
+     * Zero-based item offset.
+     */
+    readonly offset: number;
+}
+/**
+ * Normalized cursor pagination request.
+ */
+export interface CursorPage {
+    /**
+     * Pagination mode.
+     */
+    readonly kind: "cursor";
+    /**
+     * Page size after defaulting and max-limit clamping.
+     */
+    readonly limit: number;
+    /**
+     * Cursor for the current page, or null for the first page.
+     */
+    readonly cursor: string | null;
+}
+/**
+ * Normalized pagination request.
+ */
+export type Page = OffsetPage | CursorPage;
+/**
+ * Offset pagination response metadata.
+ */
+export type OffsetPageInfo = OffsetPage & {
+    /**
+     * Total item count.
+     */
+    readonly total: number;
+    /**
+     * Whether another page exists.
+     */
+    readonly hasMore: boolean;
+};
+/**
+ * Cursor pagination response metadata.
+ */
+export type CursorPageInfo = CursorPage & {
+    /**
+     * Cursor for the next page, or null when there is no next page.
+     */
+    readonly nextCursor: string | null;
+    /**
+     * Whether another page exists.
+     */
+    readonly hasMore: boolean;
+};
+/**
+ * Pagination response metadata.
+ */
+export type PageInfo = OffsetPageInfo | CursorPageInfo;
+/**
+ * Paginated list result.
+ */
+export interface PageResult<TItem, TPage extends PageInfo = PageInfo> {
+    /**
+     * Page items. Result helpers clone the input array.
+     */
+    readonly items: TItem[];
+    /**
+     * Page metadata.
+     */
+    readonly page: TPage;
+}
+/**
+ * Options for normalizing pagination input.
+ */
+export interface NormalizePageOptions {
+    /**
+     * Limit used when the caller does not provide one.
+     */
+    readonly defaultLimit: number;
+    /**
+     * Maximum allowed limit. Larger caller values are clamped.
+     */
+    readonly maxLimit: number;
+}
+/**
+ * Raw offset pagination input.
+ */
+export interface OffsetPageInput {
+    /**
+     * Requested page size.
+     */
+    readonly limit?: number | null;
+    /**
+     * Requested zero-based offset.
+     */
+    readonly offset?: number | null;
+}
+/**
+ * Raw cursor pagination input.
+ */
+export interface CursorPageInput {
+    /**
+     * Requested page size.
+     */
+    readonly limit?: number | null;
+    /**
+     * Requested cursor.
+     */
+    readonly cursor?: string | null;
+}
+/**
+ * Error thrown when pagination input is invalid.
+ */
+export declare class PaginationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Normalize offset pagination input.
+ *
+ * The limit is defaulted and clamped to `maxLimit`; offset must be a
+ * non-negative integer.
+ */
+export declare function normalizeOffsetPage(input: OffsetPageInput, options: NormalizePageOptions): OffsetPage;
+/**
+ * Normalize cursor pagination input.
+ *
+ * The limit is defaulted and clamped to `maxLimit`; cursor must be a string or
+ * null.
+ */
+export declare function normalizeCursorPage(input: CursorPageInput, options: NormalizePageOptions): CursorPage;
+/**
+ * Create an offset page result and derive `hasMore`.
+ */
+export declare function offsetPageResult<TItem>(items: readonly TItem[], page: OffsetPage, total: number): PageResult<TItem, OffsetPageInfo>;
+/**
+ * Create a cursor page result and derive `hasMore` from `nextCursor`.
+ */
+export declare function cursorPageResult<TItem>(items: readonly TItem[], page: CursorPage, nextCursor: string | null): PageResult<TItem, CursorPageInfo>;
+//# sourceMappingURL=index.d.ts.map

package/dist/pagination/index.d.ts.map

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