@relkit/providers-local 0.0.0

package/dist/events/delivery-types.d.ts

@@ -0,0 +1,74 @@
+import type { UnknownEventEnvelope } from "@relkit/events";
+import type { RetryPolicy } from "@relkit/jobs";
+import type { JobFailureMetadata, JobQueueCounts } from "../jobs/queue-utils.js";
+import type { JobStoreBoundary } from "../jobs/store.js";
+import type { EventDeliveryRecord } from "./router-records.js";
+export declare const EVENT_DELIVERY_CAPABILITIES: Readonly<{
+    readonly persistence: "restart-recovery";
+    readonly restartRecovery: true;
+    readonly atLeastOnce: true;
+    readonly exactlyOnce: false;
+    readonly ordering: "unsupported";
+    readonly orderedByKey: false;
+}>;
+export type EventDeliveryCapabilities = typeof EVENT_DELIVERY_CAPABILITIES;
+export type EventDeliveryBoundary = JobStoreBoundary | "handler-success-before-ack";
+export interface EventDeliveryBinding {
+    readonly id: string;
+    readonly invoke: (envelope: UnknownEventEnvelope) => Promise<unknown>;
+    readonly profile?: string;
+    readonly retry?: RetryPolicy;
+    readonly concurrency?: number;
+}
+export interface EventDeliveryOptions {
+    readonly now?: () => number;
+    readonly random?: () => number;
+    readonly ownerToken?: string;
+    readonly leaseDurationMs?: number;
+    readonly retry?: RetryPolicy;
+    readonly concurrency?: number;
+    readonly onBoundary?: (boundary: EventDeliveryBoundary) => void | Promise<void>;
+}
+export interface EventDeliveryResult {
+    readonly deliveryId: string;
+    readonly triggerId: string;
+    readonly eventInstanceId: string;
+    readonly accepted: boolean;
+    readonly persisted: boolean;
+    readonly status: "queued" | "completed" | "failed";
+    readonly state: "available" | "leased" | "delayed" | "completed" | "dead-lettered";
+    readonly attempt: number;
+    readonly duplicate: boolean;
+    readonly value?: unknown;
+    readonly error?: unknown;
+    readonly failure?: JobFailureMetadata;
+}
+export interface EventDeliveryLedgerRecord extends EventDeliveryRecord {
+    readonly cursor: number;
+    readonly state: EventDeliveryResult["state"];
+    readonly attempt: number;
+    readonly duplicate: boolean;
+    readonly leaseOwner?: string;
+    readonly leaseExpiresAt?: number;
+    readonly failure?: JobFailureMetadata;
+}
+export interface EventDeliverySnapshot {
+    readonly cursor: number;
+    readonly records: readonly EventDeliveryRecord[];
+    readonly ledger: readonly EventDeliveryLedgerRecord[];
+    readonly counts: JobQueueCounts;
+    readonly capabilities: typeof EVENT_DELIVERY_CAPABILITIES;
+}
+export interface EventDelivery {
+    readonly triggerId: string;
+    readonly capabilities: EventDeliveryCapabilities;
+    readonly accept: (envelope: UnknownEventEnvelope) => Promise<EventDeliveryResult>;
+    readonly deliver: (envelope: UnknownEventEnvelope) => Promise<EventDeliveryResult>;
+    readonly runNext: (deliveryId?: string) => Promise<EventDeliveryResult | undefined>;
+    readonly retry: (deliveryId: string) => Promise<EventDeliveryResult>;
+    readonly drain: () => Promise<readonly EventDeliveryResult[]>;
+    readonly recover: (now?: number) => Promise<readonly EventDeliveryLedgerRecord[]>;
+    readonly snapshot: () => EventDeliverySnapshot;
+    readonly close: () => Promise<void>;
+}
+//# sourceMappingURL=delivery-types.d.ts.map

package/dist/events/delivery-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-types.d.ts","sourceRoot":"","sources":["../../src/events/delivery-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,eAAO,MAAM,2BAA2B;;;;;;;EAO7B,CAAC;AACZ,MAAM,MAAM,yBAAyB,GAAG,OAAO,2BAA2B,CAAC;AAE3E,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,4BAA4B,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,CAAC;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;CACvC;AAED,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,OAAO,2BAA2B,CAAC;CAC3D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClF,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnF,QAAQ,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IACpF,QAAQ,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,yBAAyB,EAAE,CAAC,CAAC;IAClF,QAAQ,CAAC,QAAQ,EAAE,MAAM,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC"}

package/dist/events/delivery-types.js

@@ -0,0 +1,9 @@
+export const EVENT_DELIVERY_CAPABILITIES = Object.freeze({
+    persistence: "restart-recovery",
+    restartRecovery: true,
+    atLeastOnce: true,
+    exactlyOnce: false,
+    ordering: "unsupported",
+    orderedByKey: false,
+});
+//# sourceMappingURL=delivery-types.js.map

package/dist/events/delivery-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-types.js","sourceRoot":"","sources":["../../src/events/delivery-types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,CAAC;IACvD,WAAW,EAAE,kBAAkB;IAC/B,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,KAAK;IAClB,QAAQ,EAAE,aAAa;IACvB,YAAY,EAAE,KAAK;CACX,CAAC,CAAC"}

package/dist/events/delivery-utils.d.ts

@@ -0,0 +1,17 @@
+import { type JsonValue } from "@relkit/contracts";
+import type { RetryPolicy } from "@relkit/jobs";
+import type { JobStore, JobRecord } from "../jobs/store.js";
+import type { JobQueue, JobQueueEntry } from "../jobs/queue-utils.js";
+import { type EventDeliveryRecord } from "./router-records.js";
+import type { EventDeliveryLedgerRecord, EventDeliveryResult } from "./delivery-types.js";
+export declare const DEFAULT_RETRY: RetryPolicy;
+export declare function resultFrom(entry: JobQueueEntry, triggerId: string, duplicate: boolean, status: EventDeliveryResult["status"], error?: unknown, failure?: EventDeliveryResult["failure"], value?: unknown): EventDeliveryResult;
+export declare function retryDelivery(queue: JobQueue, triggerId: string, deliveryId: string, now: () => number): Promise<EventDeliveryResult>;
+export declare function promoteDue(queue: JobQueue, now: () => number): Promise<void>;
+export declare function records(raw: readonly JobRecord[], triggerId: string, queue: JobQueue): EventDeliveryRecord[];
+export declare function ledger(store: Pick<JobStore, "snapshot">, triggerId: string, queue: JobQueue): readonly EventDeliveryLedgerRecord[];
+export declare function validateStoredData(value: JsonValue): void;
+export declare function normalizeRetry(value: RetryPolicy | undefined): RetryPolicy;
+export declare function positive(value: number, name: string): number;
+export declare function json(value: unknown): JsonValue;
+//# sourceMappingURL=delivery-utils.d.ts.map

package/dist/events/delivery-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-utils.d.ts","sourceRoot":"","sources":["../../src/events/delivery-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1F,eAAO,MAAM,aAAa,EAAE,WAM1B,CAAC;AAEH,wBAAgB,UAAU,CACxB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EACrC,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,EACxC,KAAK,CAAC,EAAE,OAAO,GACd,mBAAmB,CAerB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAK9B;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlF;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,SAAS,SAAS,EAAE,EACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,QAAQ,GACd,mBAAmB,EAAE,CAcvB;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,QAAQ,GACd,SAAS,yBAAyB,EAAE,CA4BtC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAkBzD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,CAU1E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAE9C"}

package/dist/events/delivery-utils.js

@@ -0,0 +1,133 @@
+import { canonicalJson, normalizeId } from "@relkit/contracts";
+import { readEntry } from "../jobs/queue-entry.js";
+import { normalizeEnvelope } from "./router-records.js";
+export const DEFAULT_RETRY = Object.freeze({
+    maxAttempts: 1,
+    initialDelayMs: 0,
+    maxDelayMs: 0,
+    multiplier: 1,
+    jitter: "none",
+});
+export function resultFrom(entry, triggerId, duplicate, status, error, failure, value) {
+    return Object.freeze({
+        deliveryId: entry.instanceId,
+        triggerId,
+        eventInstanceId: normalizeEnvelope(entry.input).instanceId,
+        accepted: true,
+        persisted: true,
+        status,
+        state: entry.state,
+        attempt: entry.attempt,
+        duplicate,
+        ...(error === undefined ? {} : { error }),
+        ...(failure === undefined ? {} : { failure }),
+        ...(value === undefined ? {} : { value }),
+    });
+}
+export async function retryDelivery(queue, triggerId, deliveryId, now) {
+    const normalized = normalizeId(deliveryId);
+    await queue.recover(now());
+    const entry = await queue.adminRetry(normalized, { availableAt: now() });
+    return resultFrom(entry, triggerId, false, "queued");
+}
+export async function promoteDue(queue, now) {
+    const time = now();
+    for (const entry of queue.snapshot()) {
+        if (entry.state === "delayed" && (entry.availableAt ?? Number.MAX_SAFE_INTEGER) <= time) {
+            await queue.transition(entry.instanceId, "available", {
+                expectedState: "delayed",
+                availableAt: time,
+            });
+        }
+    }
+}
+export function records(raw, triggerId, queue) {
+    return queue.snapshot().map((entry) => {
+        const record = [...raw].reverse().find((item) => item.instanceId === entry.instanceId);
+        const envelope = normalizeEnvelope(entry.input);
+        return Object.freeze({
+            version: 1,
+            sequence: record?.sequence ?? entry.order,
+            timestamp: record?.timestamp ?? entry.acceptedAt,
+            deliveryId: entry.instanceId,
+            eventInstanceId: envelope.instanceId,
+            triggerId,
+            envelope,
+        });
+    });
+}
+export function ledger(store, triggerId, queue) {
+    return Object.freeze(store
+        .snapshot()
+        .records.filter((record) => queue.get(record.instanceId) !== undefined)
+        .filter((record) => record.kind !== "event-delivery-accepted")
+        .map((record) => {
+        const entry = readEntry(record);
+        if (entry === undefined)
+            throw new Error("Event delivery ledger state is invalid");
+        const envelope = normalizeEnvelope(entry.input);
+        return Object.freeze({
+            version: 1,
+            sequence: record.sequence,
+            timestamp: record.timestamp,
+            cursor: record.sequence,
+            deliveryId: entry.instanceId,
+            eventInstanceId: envelope.instanceId,
+            triggerId,
+            envelope,
+            state: entry.state,
+            attempt: entry.attempt,
+            duplicate: entry.attempt > 1,
+            ...(entry.leaseOwner === undefined ? {} : { leaseOwner: entry.leaseOwner }),
+            ...(entry.leaseExpiresAt === undefined ? {} : { leaseExpiresAt: entry.leaseExpiresAt }),
+            ...(entry.failure === undefined ? {} : { failure: entry.failure }),
+        });
+    }));
+}
+export function validateStoredData(value) {
+    if (isRecord(value) && value.input !== undefined) {
+        readEntry({
+            version: 1,
+            sequence: 1,
+            instanceId: "delivery.validation",
+            kind: "available",
+            timestamp: 0,
+            data: value,
+        });
+        normalizeEnvelope(value.input);
+        return;
+    }
+    if (isRecord(value) && value.envelope !== undefined) {
+        normalizeEnvelope(value.envelope);
+        return;
+    }
+    normalizeEnvelope(value);
+}
+export function normalizeRetry(value) {
+    const policy = value ?? DEFAULT_RETRY;
+    positive(policy.maxAttempts, "retry.maxAttempts");
+    nonNegative(policy.initialDelayMs, "retry.initialDelayMs");
+    nonNegative(policy.maxDelayMs, "retry.maxDelayMs");
+    if (policy.maxDelayMs < policy.initialDelayMs || policy.multiplier < 1)
+        throw new TypeError("Event retry policy is invalid");
+    if (!["none", "full", "equal"].includes(policy.jitter))
+        throw new TypeError("Event retry policy jitter is invalid");
+    return Object.freeze({ ...policy });
+}
+export function positive(value, name) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new TypeError(`${name} must be positive`);
+    return value;
+}
+export function json(value) {
+    return JSON.parse(canonicalJson(value));
+}
+function nonNegative(value, name) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new TypeError(`${name} must be non-negative`);
+    return value;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=delivery-utils.js.map

package/dist/events/delivery-utils.js.map

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

package/dist/events/delivery.d.ts

@@ -0,0 +1,6 @@
+import { type EventDelivery, type EventDeliveryBinding, type EventDeliveryOptions } from "./delivery-types.js";
+export { EVENT_DELIVERY_CAPABILITIES } from "./delivery-types.js";
+export type { EventDelivery, EventDeliveryBinding, EventDeliveryBoundary, EventDeliveryLedgerRecord, EventDeliveryOptions, EventDeliveryResult, EventDeliverySnapshot, } from "./delivery-types.js";
+/** Provides durable at-least-once delivery for one compiled event trigger. */
+export declare function createEventDelivery(requestedRoot: string, binding: EventDeliveryBinding, options?: EventDeliveryOptions): Promise<EventDelivery>;
+//# sourceMappingURL=delivery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/events/delivery.ts"],"names":[],"mappings":"AAkBA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAG1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,8EAA8E;AAC9E,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CA4JxB"}

package/dist/events/delivery.js

@@ -0,0 +1,159 @@
+import { normalizeId } from "@relkit/contracts";
+import { applyRetry, safeFailureMetadata } from "../jobs/retry.js";
+import { createJobQueue } from "../jobs/queue.js";
+import { createJobStore } from "../jobs/store.js";
+import { makeDeliveryId, normalizeEnvelope } from "./router-records.js";
+import { json, ledger, normalizeRetry, positive, promoteDue, records, resultFrom, retryDelivery, validateStoredData, } from "./delivery-utils.js";
+import { EVENT_DELIVERY_CAPABILITIES, } from "./delivery-types.js";
+export { EVENT_DELIVERY_CAPABILITIES } from "./delivery-types.js";
+/** Provides durable at-least-once delivery for one compiled event trigger. */
+export async function createEventDelivery(requestedRoot, binding, options = {}) {
+    const triggerId = normalizeId(binding.id);
+    if (typeof binding.invoke !== "function")
+        throw new TypeError("Event delivery target is required");
+    const concurrency = positive(options.concurrency ?? binding.concurrency ?? 1, "concurrency");
+    const retryPolicy = normalizeRetry(options.retry ?? binding.retry);
+    const clock = options.now ?? Date.now;
+    const store = await createJobStore(requestedRoot, {
+        now: clock,
+        ...(options.onBoundary === undefined
+            ? {}
+            : { onBoundary: (boundary) => options.onBoundary(boundary) }),
+        validateData: validateStoredData,
+    });
+    const queue = createJobQueue(store, {
+        now: clock,
+        ...(options.ownerToken === undefined ? {} : { ownerToken: options.ownerToken }),
+        ...(options.leaseDurationMs === undefined ? {} : { leaseDurationMs: options.leaseDurationMs }),
+    });
+    await queue.ready();
+    let active = 0;
+    let closed = false;
+    let admissionTail = Promise.resolve();
+    const accept = async (input) => {
+        ensureOpen();
+        const accepted = await admit(normalizeEnvelope(input));
+        if (accepted.entry.state === "completed")
+            return resultFrom(accepted.entry, triggerId, true, "completed");
+        if (accepted.entry.state === "dead-lettered")
+            return resultFrom(accepted.entry, triggerId, true, "failed", undefined, accepted.entry.failure);
+        return resultFrom(accepted.entry, triggerId, accepted.duplicate, "queued");
+    };
+    const deliver = async (input) => {
+        const accepted = await accept(input);
+        const result = await runNext(accepted.deliveryId);
+        return result === undefined
+            ? accepted
+            : { ...result, duplicate: result.duplicate || accepted.duplicate };
+    };
+    const runNext = async (deliveryId) => {
+        ensureOpen();
+        if (active >= concurrency)
+            return undefined;
+        active += 1;
+        try {
+            await queue.recover(clock());
+            await promoteDue(queue, clock);
+            const candidate = deliveryId === undefined ? undefined : queue.get(deliveryId);
+            if (deliveryId !== undefined &&
+                (candidate === undefined || candidate.state !== "available")) {
+                return undefined;
+            }
+            const leased = await queue.acquire(deliveryId);
+            if (leased === undefined)
+                return undefined;
+            const duplicate = leased.attempt > 1;
+            let value;
+            try {
+                value = await binding.invoke(normalizeEnvelope(leased.input));
+            }
+            catch (error) {
+                const entry = await applyRetry(queue, leased.instanceId, retryPolicy, error, {
+                    now: clock,
+                    ...(options.random === undefined ? {} : { random: options.random }),
+                });
+                return resultFrom(entry, triggerId, duplicate, "failed", error, safeFailureMetadata(error));
+            }
+            await options.onBoundary?.("handler-success-before-ack");
+            const entry = await queue.transition(leased.instanceId, "completed", {
+                expectedState: "leased",
+            });
+            return resultFrom(entry, triggerId, duplicate, "completed", undefined, undefined, value);
+        }
+        finally {
+            active -= 1;
+        }
+    };
+    const retry = async (deliveryId) => {
+        ensureOpen();
+        return retryDelivery(queue, triggerId, deliveryId, clock);
+    };
+    const recover = async (now = clock()) => {
+        ensureOpen();
+        await queue.recover(now);
+        return ledger(store, triggerId, queue);
+    };
+    const snapshot = () => {
+        ensureOpen();
+        const current = store.snapshot();
+        return Object.freeze({
+            cursor: current.checkpoint.sequence,
+            records: Object.freeze(records(current.records, triggerId, queue)),
+            ledger: ledger(store, triggerId, queue),
+            counts: queue.counts(),
+            capabilities: EVENT_DELIVERY_CAPABILITIES,
+        });
+    };
+    const drain = async () => {
+        const results = [];
+        while (true) {
+            const result = await runNext();
+            if (result === undefined)
+                return Object.freeze(results);
+            results.push(result);
+        }
+    };
+    const close = async () => {
+        if (closed)
+            return;
+        closed = true;
+        await store.close();
+    };
+    return Object.freeze({
+        triggerId,
+        capabilities: EVENT_DELIVERY_CAPABILITIES,
+        accept,
+        deliver,
+        runNext,
+        retry,
+        drain,
+        recover,
+        snapshot,
+        close,
+    });
+    async function admit(envelope) {
+        const result = admissionTail.then(async () => {
+            const deliveryId = makeDeliveryId(envelope.instanceId, triggerId);
+            const existing = queue.get(deliveryId);
+            if (existing !== undefined)
+                return { entry: existing, duplicate: true };
+            const accepted = await queue.enqueue({
+                instanceId: deliveryId,
+                input: json(envelope),
+                profile: binding.profile ?? "default",
+            });
+            const available = await queue.transition(deliveryId, "available", {
+                expectedState: "accepted",
+                availableAt: accepted.acceptedAt,
+            });
+            return { entry: available, duplicate: false };
+        });
+        admissionTail = result.then(() => undefined, () => undefined);
+        return result;
+    }
+    function ensureOpen() {
+        if (closed)
+            throw new Error("Event delivery is closed");
+    }
+}
+//# sourceMappingURL=delivery.js.map

package/dist/events/delivery.js.map

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

package/dist/events/ephemeral.d.ts

@@ -0,0 +1,36 @@
+import type { UnknownEventEnvelope } from "@relkit/events";
+export declare const DEFAULT_EPHEMERAL_CAPACITY = 100;
+export declare const EPHEMERAL_DELIVERY_CAPABILITIES: Readonly<{
+    readonly persistence: "none";
+    readonly restartRecovery: false;
+    readonly dropPolicy: "drop-newest";
+}>;
+export interface EphemeralDeliveryResult {
+    readonly accepted: boolean;
+    readonly persisted: false;
+    readonly status: "completed" | "failed" | "dropped";
+    readonly capacity: number;
+    readonly dropPolicy: "drop-newest";
+    readonly restartRecovery: false;
+    readonly value?: unknown;
+    readonly error?: unknown;
+    readonly dropReason?: "capacity";
+}
+export interface EphemeralDeliverySnapshot {
+    readonly capacity: number;
+    readonly inFlight: number;
+    readonly admitted: number;
+    readonly completed: number;
+    readonly failed: number;
+    readonly dropped: number;
+    readonly persistence: "none";
+    readonly restartRecovery: false;
+    readonly dropPolicy: "drop-newest";
+}
+export interface EphemeralDelivery {
+    readonly deliver: (envelope: UnknownEventEnvelope) => Promise<EphemeralDeliveryResult>;
+    readonly snapshot: () => EphemeralDeliverySnapshot;
+}
+/** Delivers transient events while bounding simultaneous in-process work. */
+export declare function createEphemeralDelivery(invoke: (envelope: UnknownEventEnvelope) => Promise<unknown>, requestedCapacity?: number): EphemeralDelivery;
+//# sourceMappingURL=ephemeral.d.ts.map

package/dist/events/ephemeral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral.d.ts","sourceRoot":"","sources":["../../src/events/ephemeral.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,+BAA+B;;;;EAIjC,CAAC;AAEZ,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACvF,QAAQ,CAAC,QAAQ,EAAE,MAAM,yBAAyB,CAAC;CACpD;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,EAC5D,iBAAiB,SAA6B,GAC7C,iBAAiB,CAuDnB"}

package/dist/events/ephemeral.js

@@ -0,0 +1,61 @@
+export const DEFAULT_EPHEMERAL_CAPACITY = 100;
+export const EPHEMERAL_DELIVERY_CAPABILITIES = Object.freeze({
+    persistence: "none",
+    restartRecovery: false,
+    dropPolicy: "drop-newest",
+});
+/** Delivers transient events while bounding simultaneous in-process work. */
+export function createEphemeralDelivery(invoke, requestedCapacity = DEFAULT_EPHEMERAL_CAPACITY) {
+    if (typeof invoke !== "function")
+        throw new TypeError("Ephemeral delivery requires a target");
+    if (!Number.isSafeInteger(requestedCapacity) || requestedCapacity <= 0) {
+        throw new RangeError("Ephemeral delivery capacity must be a positive integer");
+    }
+    const capacity = requestedCapacity;
+    let inFlight = 0;
+    let admitted = 0;
+    let completed = 0;
+    let failed = 0;
+    let dropped = 0;
+    const deliver = async (envelope) => {
+        // ponytail: no hidden backlog; add a bounded FIFO only if measured delivery needs it.
+        if (inFlight >= capacity) {
+            dropped += 1;
+            return outcome({ accepted: false, status: "dropped", dropReason: "capacity" });
+        }
+        inFlight += 1;
+        admitted += 1;
+        try {
+            const value = await invoke(envelope);
+            completed += 1;
+            return outcome({ accepted: true, status: "completed", value });
+        }
+        catch (error) {
+            failed += 1;
+            return outcome({ accepted: true, status: "failed", error });
+        }
+        finally {
+            inFlight -= 1;
+        }
+    };
+    const snapshot = () => Object.freeze({
+        capacity,
+        inFlight,
+        admitted,
+        completed,
+        failed,
+        dropped,
+        ...EPHEMERAL_DELIVERY_CAPABILITIES,
+    });
+    return Object.freeze({ deliver, snapshot });
+    function outcome(result) {
+        return Object.freeze({
+            ...result,
+            persisted: false,
+            capacity,
+            dropPolicy: "drop-newest",
+            restartRecovery: false,
+        });
+    }
+}
+//# sourceMappingURL=ephemeral.js.map

package/dist/events/ephemeral.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ephemeral.js","sourceRoot":"","sources":["../../src/events/ephemeral.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAC9C,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3D,WAAW,EAAE,MAAM;IACnB,eAAe,EAAE,KAAK;IACtB,UAAU,EAAE,aAAa;CACjB,CAAC,CAAC;AA+BZ,6EAA6E;AAC7E,MAAM,UAAU,uBAAuB,CACrC,MAA4D,EAC5D,iBAAiB,GAAG,0BAA0B;IAE9C,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAC9F,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,IAAI,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,UAAU,CAAC,wDAAwD,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC;IACnC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,OAAO,GAAG,KAAK,EAAE,QAA8B,EAAoC,EAAE;QACzF,sFAAsF;QACtF,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,CAAC;YACb,OAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,QAAQ,IAAI,CAAC,CAAC;QACd,QAAQ,IAAI,CAAC,CAAC;QACd,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrC,SAAS,IAAI,CAAC,CAAC;YACf,OAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,CAAC;YACZ,OAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,CAAC;gBAAS,CAAC;YACT,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,GAA8B,EAAE,CAC/C,MAAM,CAAC,MAAM,CAAC;QACZ,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,MAAM;QACN,OAAO;QACP,GAAG,+BAA+B;KACnC,CAAC,CAAC;IACL,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE5C,SAAS,OAAO,CACd,MAC0E;QAE1E,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,MAAM;YACT,SAAS,EAAE,KAAK;YAChB,QAAQ;YACR,UAAU,EAAE,aAAa;YACzB,eAAe,EAAE,KAAK;SACvB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/events/log.d.ts

@@ -0,0 +1,37 @@
+import type { EventPublishResult, UnknownEventEnvelope } from "@relkit/events";
+import { type JobStoreBoundary, type JobStoreCheckpoint, type JobStoreIndex, type JobStoreOptions } from "../jobs/store.js";
+import { createJobStorePaths } from "../jobs/store-files.js";
+export declare const EVENT_LOG_VERSION: 1;
+export type EventLogBoundary = JobStoreBoundary;
+export type EventLogPaths = ReturnType<typeof createJobStorePaths>;
+export interface EventLogOptions extends Pick<JobStoreOptions, "now" | "onBoundary"> {
+}
+export interface EventLogRecord {
+    readonly version: typeof EVENT_LOG_VERSION;
+    readonly sequence: number;
+    readonly kind: "accepted";
+    readonly accepted: true;
+    readonly timestamp: number;
+    readonly envelope: UnknownEventEnvelope;
+}
+export interface EventLogSnapshot {
+    readonly records: readonly EventLogRecord[];
+    readonly index: JobStoreIndex;
+    readonly checkpoint: JobStoreCheckpoint;
+}
+export interface EventLog {
+    readonly root: string;
+    readonly paths: EventLogPaths;
+    readonly append: (envelope: EventLogInput) => Promise<EventLogRecord>;
+    readonly snapshot: () => EventLogSnapshot;
+    readonly close: () => Promise<void>;
+}
+export type EventLogInput = UnknownEventEnvelope | EventPublishResult<string, number, unknown>;
+export declare class EventLogStateError extends Error {
+    readonly code: "RELKIT_EVENT_LOG_STATE_INVALID";
+    constructor(message: string);
+}
+export declare function createEventLogPaths(root: string): EventLogPaths;
+/** Opens the durable accepted-event log and repairs invalid records on startup. */
+export declare function createEventLog(requestedRoot: string, options?: EventLogOptions): Promise<EventLog>;
+//# sourceMappingURL=log.d.ts.map

package/dist/events/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/events/log.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,eAAO,MAAM,iBAAiB,EAAG,CAAU,CAAC;AAC5C,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEnE,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,YAAY,CAAC;CAAG;AAEvF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,gBAAgB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/F,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAG,gCAAgC,CAAU;gBAE9C,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAE/D;AAED,mFAAmF;AACnF,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,QAAQ,CAAC,CAwBnB"}