@nifrajs/core 2.14.1 → 3.2.0

package/dist/durable-approval.d.ts

@@ -0,0 +1,56 @@
+import type { CapabilityApprovalGate } from "./internal/capability-runtime.js";
+import type { ApprovalConsumeResult, ApprovalRecord, ApprovalStore } from "./internal/durable-types.js";
+export declare class ApprovalRequiredError extends Error {
+    readonly approvalId: string;
+    readonly effectId: string;
+    readonly resumeToken: string;
+    readonly expiresAt: number;
+    constructor(approvalId: string, effectId: string, resumeToken: string, expiresAt: number);
+}
+export declare class ApprovalTokenInvalidError extends Error {
+    constructor();
+}
+export declare class ApprovalTokenExpiredError extends Error {
+    constructor();
+}
+export declare class ApprovalTokenReplayError extends Error {
+    constructor();
+}
+export declare class ApprovalBindingError extends Error {
+    constructor();
+}
+export declare class ApprovalPendingError extends Error {
+    constructor();
+}
+export declare class ApprovalDeniedError extends Error {
+    constructor();
+}
+export interface ApprovalCoordinator extends CapabilityApprovalGate {
+    decide(input: {
+        readonly approvalId: string;
+        readonly tenantId: string;
+        readonly decision: "approved" | "denied";
+        readonly decidedBy: string;
+    }): Promise<void>;
+    get(approvalId: string): Promise<ApprovalRecord | undefined>;
+}
+export interface ApprovalCoordinatorOptions {
+    readonly store: ApprovalStore;
+    /** At least 32 random bytes, kept separately from the approval store. */
+    readonly secret: Uint8Array;
+    readonly ttlMs?: number;
+    readonly now?: () => number;
+    /** Tests/local development only. Production approval records require a durable store. */
+    readonly allowMemoryStore?: boolean;
+}
+export declare function createApprovalCoordinator(options: ApprovalCoordinatorOptions): ApprovalCoordinator;
+export declare class MemoryApprovalStore implements ApprovalStore {
+    readonly durability: "memory";
+    private readonly records;
+    create(record: ApprovalRecord): boolean;
+    get(approvalId: string): ApprovalRecord | undefined;
+    decide(input: Parameters<ApprovalStore["decide"]>[0]): boolean;
+    consume(input: Parameters<ApprovalStore["consume"]>[0]): ApprovalConsumeResult;
+    list(): readonly ApprovalRecord[];
+}
+//# sourceMappingURL=durable-approval.d.ts.map

package/dist/durable-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-approval.d.ts","sourceRoot":"","sources":["../src/durable-approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAY9E,OAAO,KAAK,EACV,qBAAqB,EACrB,cAAc,EACd,aAAa,EACd,MAAM,6BAA6B,CAAA;AAoBpC,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAG,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;gBAEd,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAazF;AAED,qBAAa,yBAA0B,SAAQ,KAAK;;CAKnD;AACD,qBAAa,yBAA0B,SAAQ,KAAK;;CAKnD;AACD,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD;AACD,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AACD,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AACD,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AASD,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,MAAM,CAAC,KAAK,EAAE;QACZ,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,QAAQ,CAAA;QACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAA;CAC7D;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CACpC;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,mBAAmB,CAyHrB;AAED,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,CAAC,UAAU,EAAG,QAAQ,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAE5D,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAKvC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInD,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;IAO9D,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,qBAAqB;IAO9E,IAAI,IAAI,SAAS,cAAc,EAAE;CAKlC"}

package/dist/durable-approval.js

@@ -0,0 +1,233 @@
+import { durableApprovalProtocol } from "./internal/durable-approval-protocol.js";
+import { addDuration, assertPositiveMs, assertToken, bytesToBase64Url, cloneValue, encoder, readClock, sha256, } from "./internal/durable-shared.js";
+const decoder = new TextDecoder();
+function base64UrlToBytes(value) {
+    if (!/^[A-Za-z0-9_-]+$/u.test(value))
+        throw new ApprovalTokenInvalidError();
+    const padded = value
+        .replaceAll("-", "+")
+        .replaceAll("_", "/")
+        .padEnd(Math.ceil(value.length / 4) * 4, "=");
+    let binary;
+    try {
+        binary = atob(padded);
+    }
+    catch {
+        throw new ApprovalTokenInvalidError();
+    }
+    return Uint8Array.from(binary, (character) => character.charCodeAt(0));
+}
+// Durable human approval with signed, single-use resume tokens
+export class ApprovalRequiredError extends Error {
+    approvalId;
+    effectId;
+    resumeToken;
+    expiresAt;
+    constructor(approvalId, effectId, resumeToken, expiresAt) {
+        super("capability approval is required");
+        this.approvalId = approvalId;
+        this.effectId = effectId;
+        this.expiresAt = expiresAt;
+        Object.defineProperty(this, "resumeToken", {
+            value: resumeToken,
+            enumerable: false,
+            configurable: false,
+            writable: false,
+        });
+        this.name = "ApprovalRequiredError";
+    }
+}
+export class ApprovalTokenInvalidError extends Error {
+    constructor() {
+        super("approval resume token is invalid");
+        this.name = "ApprovalTokenInvalidError";
+    }
+}
+export class ApprovalTokenExpiredError extends Error {
+    constructor() {
+        super("approval resume token has expired");
+        this.name = "ApprovalTokenExpiredError";
+    }
+}
+export class ApprovalTokenReplayError extends Error {
+    constructor() {
+        super("approval resume token has already been consumed");
+        this.name = "ApprovalTokenReplayError";
+    }
+}
+export class ApprovalBindingError extends Error {
+    constructor() {
+        super("approval resume token is bound to another tenant or principal");
+        this.name = "ApprovalBindingError";
+    }
+}
+export class ApprovalPendingError extends Error {
+    constructor() {
+        super("capability approval is still pending");
+        this.name = "ApprovalPendingError";
+    }
+}
+export class ApprovalDeniedError extends Error {
+    constructor() {
+        super("capability approval was denied");
+        this.name = "ApprovalDeniedError";
+    }
+}
+export function createApprovalCoordinator(options) {
+    if (options.store.durability !== "durable" && options.allowMemoryStore !== true) {
+        throw new TypeError('approval coordinator requires store.durability === "durable"');
+    }
+    if (!(options.secret instanceof Uint8Array) || options.secret.byteLength < 32) {
+        throw new TypeError("approval secret must contain at least 32 random bytes");
+    }
+    const secret = new Uint8Array(options.secret);
+    const ttlMs = options.ttlMs ?? 15 * 60_000;
+    assertPositiveMs(ttlMs, "approval ttlMs");
+    const clock = options.now ?? Date.now;
+    const now = () => readClock(clock, "approval clock");
+    const key = crypto.subtle.importKey("raw", secret, { name: "HMAC", hash: "SHA-256" }, false, [
+        "sign",
+        "verify",
+    ]);
+    const sign = async (claims) => {
+        const payload = bytesToBase64Url(encoder.encode(JSON.stringify(claims)));
+        const signature = new Uint8Array(await crypto.subtle.sign("HMAC", await key, encoder.encode(payload)));
+        return `v1.${payload}.${bytesToBase64Url(signature)}`;
+    };
+    const verify = async (token) => {
+        if (typeof token !== "string" || token.length > 2048)
+            throw new ApprovalTokenInvalidError();
+        const parts = token.split(".");
+        if (parts.length !== 3 || parts[0] !== "v1")
+            throw new ApprovalTokenInvalidError();
+        const payload = parts[1];
+        const valid = await crypto.subtle.verify("HMAC", await key, base64UrlToBytes(parts[2]).buffer, encoder.encode(payload));
+        if (!valid)
+            throw new ApprovalTokenInvalidError();
+        let claims;
+        try {
+            claims = JSON.parse(decoder.decode(base64UrlToBytes(payload)));
+        }
+        catch {
+            throw new ApprovalTokenInvalidError();
+        }
+        if (typeof claims !== "object" || claims === null)
+            throw new ApprovalTokenInvalidError();
+        const candidate = claims;
+        if (candidate.v !== 1 ||
+            typeof candidate.id !== "string" ||
+            typeof candidate.nonce !== "string" ||
+            !Number.isSafeInteger(candidate.exp)) {
+            throw new ApprovalTokenInvalidError();
+        }
+        assertToken(candidate.id, "approval id", 128);
+        assertToken(candidate.nonce, "approval nonce", 128);
+        if (candidate.exp <= now())
+            throw new ApprovalTokenExpiredError();
+        return candidate;
+    };
+    const coordinator = {
+        async authorize(input) {
+            if (input.signal.aborted)
+                throw input.signal.reason;
+            assertToken(input.identity.tenantId, "approval tenantId");
+            assertToken(input.identity.principalId, "approval principalId");
+            if (input.resumeToken === undefined) {
+                const approvalId = crypto.randomUUID();
+                const nonce = bytesToBase64Url(crypto.getRandomValues(new Uint8Array(18)));
+                const issuedAt = now();
+                const expiresAt = addDuration(issuedAt, ttlMs, "approval expiry");
+                const resumeToken = await sign({ v: 1, id: approvalId, nonce, exp: expiresAt });
+                const accepted = await options.store.create(Object.freeze({
+                    approvalId,
+                    effectId: input.effectId,
+                    capability: input.capability,
+                    ...(input.target === undefined ? {} : { target: input.target }),
+                    ...(input.digest === undefined ? {} : { digest: input.digest }),
+                    tenantId: input.identity.tenantId,
+                    principalId: input.identity.principalId,
+                    tokenHash: await sha256(resumeToken),
+                    state: "pending",
+                    createdAt: issuedAt,
+                    expiresAt,
+                    updatedAt: issuedAt,
+                    version: 1,
+                }));
+                if (!accepted)
+                    throw new Error("approval store rejected a unique approval id");
+                throw new ApprovalRequiredError(approvalId, input.effectId, resumeToken, expiresAt);
+            }
+            const claims = await verify(input.resumeToken);
+            const consumed = await options.store.consume({
+                approvalId: claims.id,
+                tenantId: input.identity.tenantId,
+                principalId: input.identity.principalId,
+                capability: input.capability,
+                ...(input.target === undefined ? {} : { target: input.target }),
+                ...(input.digest === undefined ? {} : { digest: input.digest }),
+                tokenHash: await sha256(input.resumeToken),
+                now: now(),
+            });
+            if (consumed.state === "consumed")
+                return;
+            if (consumed.state === "replay")
+                throw new ApprovalTokenReplayError();
+            if (consumed.state === "binding")
+                throw new ApprovalBindingError();
+            if (consumed.state === "expired")
+                throw new ApprovalTokenExpiredError();
+            if (consumed.state === "pending")
+                throw new ApprovalPendingError();
+            if (consumed.state === "denied")
+                throw new ApprovalDeniedError();
+            throw new ApprovalTokenInvalidError();
+        },
+        async decide(input) {
+            assertToken(input.approvalId, "approval id", 128);
+            assertToken(input.tenantId, "approval tenantId");
+            assertToken(input.decidedBy, "approval decidedBy");
+            const accepted = await options.store.decide({ ...input, now: now() });
+            if (!accepted)
+                throw new Error("approval decision rejected");
+        },
+        async get(approvalId) {
+            assertToken(approvalId, "approval id", 128);
+            return await options.store.get(approvalId);
+        },
+    };
+    return Object.freeze(coordinator);
+}
+export class MemoryApprovalStore {
+    durability = "memory";
+    records = new Map();
+    create(record) {
+        if (this.records.has(record.approvalId))
+            return false;
+        this.records.set(record.approvalId, Object.freeze(cloneValue(record)));
+        return true;
+    }
+    get(approvalId) {
+        const record = this.records.get(approvalId);
+        return record === undefined ? undefined : Object.freeze(cloneValue(record));
+    }
+    decide(input) {
+        const record = this.records.get(input.approvalId);
+        const next = durableApprovalProtocol.decide(record, input);
+        if (next === undefined)
+            return false;
+        this.records.set(input.approvalId, Object.freeze(next));
+        return true;
+    }
+    consume(input) {
+        const record = this.records.get(input.approvalId);
+        const transition = durableApprovalProtocol.consume(record, input);
+        if (transition.next !== undefined)
+            this.records.set(input.approvalId, Object.freeze(transition.next));
+        return transition.result;
+    }
+    list() {
+        return Object.freeze([...this.records.values()].map((record) => Object.freeze(cloneValue(record))));
+    }
+}
+// -------------------------------------------------------------------------------------------------
+//# sourceMappingURL=durable-approval.js.map

package/dist/durable-approval.js.map

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

package/dist/durable-effect.d.ts

@@ -0,0 +1,42 @@
+import { type EffectLifecycleObserver } from "./effect-lifecycle.js";
+import type { CapabilityExecutionJournal } from "./internal/capability-runtime.js";
+import type { DurableEffectRecord, DurableEffectState, DurableEffectStore, ReconciliationPage, ReconciliationScanOptions, ReconciliationScanPage } from "./internal/durable-types.js";
+export declare class DurableEffectTransitionError extends Error {
+    readonly effectId: string;
+    readonly transition: string;
+    constructor(effectId: string, transition: string);
+}
+export interface DurableEffectJournalOptions {
+    readonly store: DurableEffectStore;
+    readonly now?: () => number;
+    /** Tests/local development only. Production journals require `store.durability === "durable"`. */
+    readonly allowMemoryStore?: boolean;
+}
+export declare function createDurableEffectJournal(options: DurableEffectJournalOptions): CapabilityExecutionJournal;
+export declare class MemoryDurableEffectStore implements DurableEffectStore {
+    readonly durability: "memory";
+    private readonly records;
+    private readonly byState;
+    create(record: DurableEffectRecord): boolean;
+    get(effectId: string): DurableEffectRecord | undefined;
+    transition(input: Parameters<DurableEffectStore["transition"]>[0]): boolean;
+    list(): readonly DurableEffectRecord[];
+    scan(input: ReconciliationScanOptions<DurableEffectState>): ReconciliationScanPage<DurableEffectRecord>;
+}
+export interface EffectReconciliationFinding {
+    readonly effectId: string;
+    readonly capability: string;
+    readonly state: "incomplete" | "ambiguous";
+    readonly updatedAt: number;
+}
+export declare function reconcileEffectsPage(store: DurableEffectStore, options: {
+    readonly staleBefore: number;
+    readonly observer?: EffectLifecycleObserver;
+    readonly cursor?: string;
+    readonly limit?: number;
+}): Promise<ReconciliationPage<EffectReconciliationFinding>>;
+export declare function reconcileEffects(store: DurableEffectStore, options: {
+    readonly staleBefore: number;
+    readonly observer?: EffectLifecycleObserver;
+}): Promise<readonly EffectReconciliationFinding[]>;
+//# sourceMappingURL=durable-effect.d.ts.map

package/dist/durable-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-effect.d.ts","sourceRoot":"","sources":["../src/durable-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAuB,MAAM,uBAAuB,CAAA;AACzF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAA;AAgBlF,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,6BAA6B,CAAA;AAGpC,qBAAa,4BAA6B,SAAQ,KAAK;aAEnC,QAAQ,EAAE,MAAM;aAChB,UAAU,EAAE,MAAM;gBADlB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM;CAKrC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAC3B,kGAAkG;IAClG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CACpC;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,0BAA0B,CA+H5B;AAED,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,QAAQ,CAAC,UAAU,EAAG,QAAQ,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAGjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO;IAO5C,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAKtD,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;IAU3E,IAAI,IAAI,SAAS,mBAAmB,EAAE;IAMtC,IAAI,CACF,KAAK,EAAE,yBAAyB,CAAC,kBAAkB,CAAC,GACnD,sBAAsB,CAAC,mBAAmB,CAAC;CAG/C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CAAA;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAWD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE;IACP,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAA;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,GACA,OAAO,CAAC,kBAAkB,CAAC,2BAA2B,CAAC,CAAC,CAwC1D;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAA;CAAE,GACrF,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAWjD"}

package/dist/durable-effect.js

@@ -0,0 +1,234 @@
+import { emitEffectLifecycle } from "./effect-lifecycle.js";
+import { validCapabilityId } from "./internal/capability-runtime.js";
+import { durableEffectProtocol } from "./internal/durable-effect-protocol.js";
+import { assertTimestamp, assertToken, bucketAdd, bucketMove, cloneValue, ERROR_CODE, indexedScan, MAX_RECONCILIATION_LIMIT, memoryScan, readClock, reconciliationLimit, } from "./internal/durable-shared.js";
+// Durable effect journal + reconciliation
+export class DurableEffectTransitionError extends Error {
+    effectId;
+    transition;
+    constructor(effectId, transition) {
+        super(`durable effect ${effectId}: ${transition} transition was rejected`);
+        this.effectId = effectId;
+        this.transition = transition;
+        this.name = "DurableEffectTransitionError";
+    }
+}
+export function createDurableEffectJournal(options) {
+    if (options.store.durability !== "durable" && options.allowMemoryStore !== true) {
+        throw new TypeError('durable effect journal requires store.durability === "durable"');
+    }
+    const clock = options.now ?? Date.now;
+    const now = () => readClock(clock, "durable effect clock");
+    const current = async (effectId) => {
+        assertToken(effectId, "durable effect id", 64);
+        const record = await options.store.get(effectId);
+        if (record === undefined)
+            throw new DurableEffectTransitionError(effectId, "missing");
+        if (record.effectId !== effectId ||
+            !validCapabilityId(record.capability) ||
+            !["admission", "executing", "committed", "failed", "unknown"].includes(record.state) ||
+            !Number.isSafeInteger(record.version) ||
+            record.version < 1) {
+            throw new TypeError(`durable effect ${effectId}: store returned an invalid record`);
+        }
+        assertTimestamp(record.createdAt, "durable effect createdAt");
+        assertTimestamp(record.updatedAt, "durable effect updatedAt");
+        if (record.createdAt > record.updatedAt)
+            throw new TypeError(`durable effect ${effectId}: updatedAt precedes createdAt`);
+        if (record.target !== undefined)
+            assertToken(record.target, "stored durable effect target", 128);
+        if (record.digest !== undefined && !/^[0-9a-f]{64}$/u.test(record.digest))
+            throw new TypeError(`durable effect ${effectId}: store returned an invalid digest`);
+        if (record.tenantId !== undefined)
+            assertToken(record.tenantId, "stored durable effect tenantId");
+        if (record.principalId !== undefined)
+            assertToken(record.principalId, "stored durable effect principalId");
+        if ((record.tenantId === undefined) !== (record.principalId === undefined))
+            throw new TypeError(`durable effect ${effectId}: store returned a partial identity`);
+        if (record.errorCode !== undefined && !ERROR_CODE.test(record.errorCode))
+            throw new TypeError(`durable effect ${effectId}: store returned an invalid error code`);
+        return record;
+    };
+    const transition = async (effectId, from, to, errorCode) => {
+        const record = await current(effectId);
+        const next = durableEffectProtocol.transition(record, {
+            effectId,
+            version: record.version,
+            from,
+            to,
+            updatedAt: now(),
+            ...(errorCode === undefined ? {} : { errorCode }),
+        });
+        if (next === undefined)
+            throw new DurableEffectTransitionError(effectId, `${from}->${to}`);
+        const accepted = await options.store.transition({
+            effectId,
+            version: record.version,
+            from,
+            to,
+            updatedAt: next.updatedAt,
+            ...(errorCode === undefined ? {} : { errorCode }),
+        });
+        if (!accepted)
+            throw new DurableEffectTransitionError(effectId, `${from}->${to}`);
+    };
+    const journal = {
+        async intent(input) {
+            assertToken(input.effectId, "durable effect id", 64);
+            if (!validCapabilityId(input.capability))
+                throw new TypeError("durable effect capability is invalid");
+            if (input.target !== undefined)
+                assertToken(input.target, "durable effect target", 128);
+            if (input.digest !== undefined && !/^[0-9a-f]{64}$/u.test(input.digest))
+                throw new TypeError("durable effect digest is invalid");
+            if (input.identity !== undefined) {
+                assertToken(input.identity.tenantId, "durable effect tenantId");
+                assertToken(input.identity.principalId, "durable effect principalId");
+            }
+            const at = now();
+            const accepted = await options.store.create(Object.freeze({
+                effectId: input.effectId,
+                capability: input.capability,
+                ...(input.target === undefined ? {} : { target: input.target }),
+                ...(input.digest === undefined ? {} : { digest: input.digest }),
+                ...(input.identity === undefined
+                    ? {}
+                    : { tenantId: input.identity.tenantId, principalId: input.identity.principalId }),
+                state: "admission",
+                createdAt: at,
+                updatedAt: at,
+                version: 1,
+            }));
+            if (!accepted)
+                throw new DurableEffectTransitionError(input.effectId, "create");
+        },
+        async executing(effectId) {
+            await transition(effectId, "admission", "executing");
+        },
+        async committed(effectId) {
+            await transition(effectId, "executing", "committed");
+        },
+        async failed(effectId, input) {
+            if (!ERROR_CODE.test(input.errorCode))
+                throw new TypeError("durable effect errorCode is invalid");
+            const record = await current(effectId);
+            const to = input.began ? "unknown" : "failed";
+            const next = durableEffectProtocol.transition(record, {
+                effectId,
+                version: record.version,
+                from: record.state,
+                to,
+                updatedAt: now(),
+                errorCode: input.errorCode,
+            });
+            if (next === undefined)
+                throw new DurableEffectTransitionError(effectId, `${record.state}->${to}`);
+            const accepted = await options.store.transition({
+                effectId,
+                version: record.version,
+                from: record.state,
+                to,
+                updatedAt: next.updatedAt,
+                errorCode: input.errorCode,
+            });
+            if (!accepted)
+                throw new DurableEffectTransitionError(effectId, `${record.state}->${to}`);
+        },
+    };
+    return Object.freeze(journal);
+}
+export class MemoryDurableEffectStore {
+    durability = "memory";
+    records = new Map();
+    // Secondary index: effectIds grouped by state, so reconciliation scans only the requested (few,
+    // non-terminal) states instead of walking every retained record. See {@link indexedScan}.
+    byState = new Map();
+    create(record) {
+        if (this.records.has(record.effectId))
+            return false;
+        this.records.set(record.effectId, Object.freeze(cloneValue(record)));
+        bucketAdd(this.byState, record.state, record.effectId);
+        return true;
+    }
+    get(effectId) {
+        const record = this.records.get(effectId);
+        return record === undefined ? undefined : Object.freeze(cloneValue(record));
+    }
+    transition(input) {
+        const current = this.records.get(input.effectId);
+        const next = durableEffectProtocol.transition(current, input);
+        if (next === undefined)
+            return false;
+        if (current === undefined)
+            return false;
+        this.records.set(input.effectId, Object.freeze(next));
+        bucketMove(this.byState, current.state, input.to, input.effectId);
+        return true;
+    }
+    list() {
+        return Object.freeze([...this.records.values()].map((record) => Object.freeze(cloneValue(record))));
+    }
+    scan(input) {
+        return indexedScan(this.byState, (id) => this.records.get(id), input);
+    }
+}
+async function scanEffectRecords(store, input) {
+    if (store.scan !== undefined)
+        return await store.scan(input);
+    if (store.list === undefined)
+        throw new TypeError("effect store does not support reconciliation");
+    return memoryScan(await store.list(), input);
+}
+export async function reconcileEffectsPage(store, options) {
+    const findings = [];
+    const page = await scanEffectRecords(store, {
+        states: ["admission", "executing", "unknown"],
+        updatedBefore: options.staleBefore,
+        ...(options.cursor === undefined ? {} : { cursor: options.cursor }),
+        limit: reconciliationLimit(options.limit),
+    });
+    for (const record of page.records) {
+        if (!validCapabilityId(record.capability) || !/^[!-~]{1,64}$/u.test(record.effectId))
+            continue;
+        if (record.updatedAt > options.staleBefore)
+            continue;
+        const state = record.state === "admission"
+            ? "incomplete"
+            : record.state === "executing" || record.state === "unknown"
+                ? "ambiguous"
+                : undefined;
+        if (state === undefined)
+            continue;
+        findings.push(Object.freeze({
+            effectId: record.effectId,
+            capability: record.capability,
+            state,
+            updatedAt: record.updatedAt,
+        }));
+        if (options.observer !== undefined) {
+            emitEffectLifecycle([options.observer], {
+                effectId: record.effectId,
+                capability: record.capability,
+                stage: "reconciliation",
+                phase: state === "ambiguous" ? "ambiguous" : "failed",
+                errorCode: state === "ambiguous" ? "effect_ambiguous" : "effect_incomplete",
+            });
+        }
+    }
+    return Object.freeze({
+        findings: Object.freeze(findings),
+        ...(page.cursor === undefined ? {} : { cursor: page.cursor }),
+    });
+}
+export async function reconcileEffects(store, options) {
+    const page = await reconcileEffectsPage(store, {
+        ...options,
+        limit: MAX_RECONCILIATION_LIMIT,
+    });
+    if (page.cursor !== undefined) {
+        throw new RangeError(`effect reconciliation exceeds ${MAX_RECONCILIATION_LIMIT} records; use reconcileEffectsPage()`);
+    }
+    return page.findings;
+}
+// -------------------------------------------------------------------------------------------------
+//# sourceMappingURL=durable-effect.js.map

package/dist/durable-effect.js.map

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