awaitly 1.31.1 → 1.32.0

package/dist/index-CQnpmUcC.d.cts

@@ -0,0 +1,417 @@
+import { ad as WorkflowEvent, ae as RunStep, R as Result } from './run-entry-yQu63Yj9.cjs';
+import { S as SnapshotStore, d as WorkflowSnapshot, e as AnyResultFn, E as ErrorsOfDeps, f as WorkflowContext, W as WorkflowCancelledError } from './persistence-entry-jflY61az.cjs';
+import { U as UnexpectedError } from './errors-entry-CMH73Eym.cjs';
+
+/**
+ * awaitly/durable
+ *
+ * Durable execution with automatic state persistence.
+ * Workflows automatically checkpoint after each keyed step and can resume from any point.
+ */
+
+/**
+ * Error returned when workflow cannot resume due to version mismatch.
+ * Indicates the stored state was created with a different workflow version.
+ * Fail-fast contract: bump version when you change step keys, order, or outputs.
+ */
+type VersionMismatchError = {
+    type: "VERSION_MISMATCH";
+    /** Workflow execution ID */
+    workflowId: string;
+    /** Version stored in persisted state */
+    storedVersion: number;
+    /** Version requested by this run */
+    requestedVersion: number;
+    /** Guidance message with suggested actions */
+    message: string;
+    /** Use requestedVersion. */
+    currentVersion?: number;
+};
+/**
+ * Error returned when workflow execution is rejected due to concurrent run.
+ */
+type ConcurrentExecutionError = {
+    type: "CONCURRENT_EXECUTION";
+    /** The workflow ID that is already running */
+    workflowId: string;
+    /** Guidance message */
+    message: string;
+    /**
+     * Distinguishes in-process (activeWorkflows) from cross-process (lock held).
+     * Enables debuggability and branching without parsing the message.
+     */
+    reason?: "in-process" | "cross-process";
+};
+/**
+ * Error returned when a persistence store operation fails.
+ */
+type PersistenceError = {
+    type: "PERSISTENCE_ERROR";
+    /** The operation that failed */
+    operation: "load" | "save" | "delete";
+    /** The workflow ID */
+    workflowId: string;
+    /** The underlying error */
+    cause: unknown;
+    /** Guidance message */
+    message: string;
+};
+/**
+ * Type guard to check if an error is a VersionMismatchError.
+ */
+declare function isVersionMismatch(error: unknown): error is VersionMismatchError;
+/**
+ * Type guard to check if an error is a ConcurrentExecutionError.
+ */
+declare function isConcurrentExecution(error: unknown): error is ConcurrentExecutionError;
+/**
+ * Type guard to check if an error is a PersistenceError.
+ */
+declare function isPersistenceError(error: unknown): error is PersistenceError;
+/**
+ * Error returned when a workflow's lease expires mid-execution.
+ * Indicates the lock was lost and another process may have reclaimed the workflow.
+ */
+type LeaseExpiredError = {
+    type: "LEASE_EXPIRED";
+    /** The workflow ID whose lease expired */
+    workflowId: string;
+    /** Guidance message */
+    message: string;
+};
+/**
+ * Type guard to check if an error is a LeaseExpiredError.
+ */
+declare function isLeaseExpired(error: unknown): error is LeaseExpiredError;
+/**
+ * Error returned when an idempotency key is reused with different input.
+ */
+type IdempotencyConflictError = {
+    type: "IDEMPOTENCY_CONFLICT";
+    idempotencyKey: string;
+    workflowId: string;
+    message: string;
+};
+declare function isIdempotencyConflict(error: unknown): error is IdempotencyConflictError;
+/**
+ * Optional cross-process lock interface.
+ * When a store implements this, durable.run uses it to ensure only one process
+ * runs a given workflow ID at a time (when allowConcurrent is false).
+ *
+ * Uses a lease (TTL) + owner token so a crashed worker does not wedge a workflow
+ * indefinitely. Release must verify the owner token so one process never
+ * unlocks another's lease.
+ *
+ * Mid-run lock loss (e.g. lease expires during a long workflow) is handled
+ * adapter-side; core assumes the lock is held until release in finally.
+ * Adapters may implement heartbeats/renewal.
+ */
+interface WorkflowLock {
+    /**
+     * Try to acquire a lease for the workflow ID.
+     * @param id - Workflow execution ID
+     * @param options - Optional TTL for the lease (adapter default if omitted)
+     * @returns Owner token if acquired, null if already held by another
+     */
+    tryAcquire(id: string, options?: {
+        ttlMs?: number;
+    }): Promise<{
+        ownerToken: string;
+    } | null>;
+    /**
+     * Release the lease. Must verify owner token; no-op or ignore if token
+     * does not match (e.g. lease already expired or taken by another).
+     */
+    release(id: string, ownerToken: string): Promise<void>;
+    /**
+     * Extend the lease for an already-held lock.
+     * Returns true if renewed, false if lost.
+     * Optional — when not implemented, no heartbeat runs.
+     */
+    renew?(id: string, ownerToken: string, options?: {
+        ttlMs?: number;
+    }): Promise<boolean>;
+}
+/**
+ * Options for durable workflow execution.
+ */
+interface DurableOptions<C = void> {
+    /**
+     * Unique workflow execution ID.
+     * Used as the key for state persistence.
+     *
+     * @example 'order-checkout-123', 'user-onboarding-abc'
+     */
+    id: string;
+    /**
+     * Snapshot store for persistence. Optional. When omitted, an in-memory store is used (per process).
+     * Same-process resume/retry works; state is lost on restart. Override with postgres/mongo/libsql for persistence.
+     *
+     * @example
+     * ```typescript
+     * // Zero-config: uses in-memory store (per process)
+     * await durable.run(deps, fn, { id: 'my-id' });
+     *
+     * // Override: pass a store for persistence across restarts
+     * import { postgres } from 'awaitly-postgres';
+     * const store = postgres('postgresql://localhost/mydb');
+     * await durable.run(deps, fn, { id: 'my-id', store });
+     * ```
+     */
+    store?: SnapshotStore;
+    /**
+     * Workflow logic version.
+     * If stored state has a different version, workflow will reject resume with VersionMismatchError
+     * unless onVersionMismatch is used to clear or migrate.
+     *
+     * Bump when you change step keys, reorder steps, or change step outputs in a way old checkpoints can't satisfy.
+     *
+     * @default 1
+     */
+    version?: number;
+    /**
+     * When stored state version differs from requested version, either throw (default), clear state and run from scratch, or supply migrated snapshot.
+     * Use for migration or one-off clear without wrapping durable.run.
+     *
+     * @default 'throw'
+     */
+    onVersionMismatch?: (ctx: {
+        id: string;
+        storedVersion: number;
+        requestedVersion: number;
+    }) => "throw" | "clear" | {
+        migratedSnapshot: WorkflowSnapshot;
+    } | Promise<"throw" | "clear" | {
+        migratedSnapshot: WorkflowSnapshot;
+    }>;
+    /**
+     * Allow concurrent executions with the same workflow ID.
+     * When `false` (default), a second run with the same ID will be rejected while one is active.
+     *
+     * @default false
+     */
+    allowConcurrent?: boolean;
+    /**
+     * Lease TTL in milliseconds for cross-process locking.
+     * Only used when the store implements WorkflowLock and allowConcurrent is false.
+     * A crashed worker's lease expires after this duration so the workflow can be picked up again.
+     *
+     * @default 60000 (1 minute)
+     */
+    lockTtlMs?: number;
+    /**
+     * Heartbeat interval for lease renewal (ms).
+     * Only active when store implements WorkflowLock with renew().
+     * @default lockTtlMs / 3
+     */
+    heartbeatIntervalMs?: number;
+    /**
+     * Whether to abort the workflow when lease is lost mid-execution.
+     * @default true
+     */
+    abortOnLeaseLoss?: boolean;
+    /**
+     * Metadata to store alongside workflow state.
+     * Useful for debugging, auditing, or filtering workflows.
+     *
+     * @example { userId: 'user-123', source: 'api' }
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * External AbortSignal for workflow-level cancellation.
+     * Cancellation persists state up to the last completed step.
+     */
+    signal?: AbortSignal;
+    /**
+     * Create per-run context for event correlation.
+     */
+    createContext?: () => C;
+    /**
+     * Unified event stream for workflow and step lifecycle.
+     * Includes durable-specific events: `persist_success` and `persist_error`.
+     */
+    onEvent?: (event: DurableWorkflowEvent<unknown, C>, ctx: C) => void;
+    /**
+     * Handler for expected and unexpected errors.
+     */
+    onError?: (error: unknown, stepName?: string, ctx?: C) => void;
+    /**
+     * Idempotency key for deduplication.
+     * If provided and a completed workflow with this key exists in the store,
+     * the stored result is returned without re-execution.
+     * If the stored input differs, an IdempotencyConflictError is returned.
+     */
+    idempotencyKey?: string;
+    /**
+     * Workflow input for idempotency conflict detection.
+     * When idempotencyKey is set, this is compared against stored input.
+     * Must be JSON-serializable.
+     */
+    input?: unknown;
+}
+/**
+ * Extended workflow event type that includes durable-specific events.
+ * E is the deps error type - the full error type includes E | UnexpectedError.
+ */
+type DurableWorkflowEvent<E, C = void> = WorkflowEvent<E | UnexpectedError, C> | {
+    type: "persist_success";
+    workflowId: string;
+    stepKey: string;
+    ts: number;
+    context?: C;
+} | {
+    type: "persist_error";
+    workflowId: string;
+    stepKey: string;
+    error: unknown;
+    ts: number;
+    context?: C;
+};
+/**
+ * Options for bulk delete of workflow state.
+ */
+interface DeleteStatesOptions {
+    /**
+     * Max number of concurrent delete calls when store has no deleteMany.
+     * @default 10
+     */
+    concurrency?: number;
+    /**
+     * When true, collect errors and return them; when false, throw on first error.
+     * @default true
+     */
+    continueOnError?: boolean;
+}
+/**
+ * Result of bulk delete of workflow state.
+ */
+interface DeleteStatesResult {
+    /** Number of entries successfully deleted. */
+    deleted: number;
+    /** Per-id errors when continueOnError was true and some deletes failed. */
+    errors?: Array<{
+        id: string;
+        error: unknown;
+    }>;
+}
+/**
+ * Durable workflow execution namespace.
+ */
+declare const durable: {
+    /**
+     * Execute a workflow with automatic state persistence.
+     *
+     * Features:
+     * - **Automatic checkpointing**: State is saved after each keyed step
+     * - **Crash recovery**: Resume from the last completed step on restart
+     * - **Version checking**: Reject resume if workflow logic version changed
+     * - **Concurrency control**: Prevent duplicate executions of the same workflow ID
+     * - **Cancellation support**: Integrates with AbortSignal for graceful shutdown
+     *
+     * ## How It Works
+     *
+     * 1. On start: Load existing state from store (if any)
+     * 2. Check version compatibility (reject if mismatch)
+     * 3. Pre-populate cache from loaded state (skip completed steps)
+     * 4. Execute workflow, persisting state after each keyed step
+     * 5. On completion: Delete stored state (clean up)
+     * 6. On error/cancellation: State remains for future resume
+     *
+     * ## Important Notes
+     *
+     * - **Only keyed steps are durable**: Use `{ key: 'step-name' }` option
+     * - **Steps should be idempotent**: They may be retried on resume
+     * - **Serialization**: State is JSON-serialized; complex objects may lose fidelity
+     *
+     * @param deps - Workflow dependencies (Result-returning functions)
+     * @param fn - Workflow function receiving ({ step, deps, ctx })
+     * @param options - Durable execution options
+     * @returns AsyncResult with workflow result or error
+     *
+     * @example
+     * ```typescript
+     * import { durable } from 'awaitly/durable';
+     *
+     * // Zero-config: uses in-memory store (per process)
+     * const result = await durable.run(
+     *   { fetchUser, createOrder, sendEmail },
+     *   async ({ step, deps: { fetchUser, createOrder, sendEmail } }) => {
+     *     const user = await step(() => fetchUser('123'), { key: 'fetch-user' });
+     *     const order = await step(() => createOrder(user), { key: 'create-order' });
+     *     await step(() => sendEmail(order), { key: 'send-email' });
+     *     return order;
+     *   },
+     *   { id: 'checkout-123' }
+     * );
+     *
+     * // Override: pass a store for persistence across restarts
+     * import { createMemoryStatePersistence } from 'awaitly/persistence';
+     * const store = createMemoryStatePersistence();
+     * await durable.run(deps, fn, { id: 'checkout-123', store });
+     *
+     * if (result.ok) {
+     *   console.log('Order completed:', result.value);
+     * } else if (isWorkflowCancelled(result.error)) {
+     *   console.log('Workflow cancelled at:', result.error.lastStepKey);
+     * }
+     * ```
+     */
+    run<const Deps extends Readonly<Record<string, AnyResultFn>>, T, C = void>(deps: Deps, fn: (context: {
+        step: RunStep<ErrorsOfDeps<Deps>>;
+        deps: Deps;
+        ctx: WorkflowContext<C>;
+    }) => T | Promise<T>, options: DurableOptions<C>): Promise<Result<T, ErrorsOfDeps<Deps> | UnexpectedError | WorkflowCancelledError | VersionMismatchError | ConcurrentExecutionError | PersistenceError | LeaseExpiredError | IdempotencyConflictError, unknown>>;
+    /**
+     * Clear all persisted workflow state from the store.
+     * Use for admin/testing. If the store implements `clear()`, that is used;
+     * otherwise clears by listing and deleting in pages.
+     *
+     * @param store - Snapshot store
+     */
+    clearState(store: SnapshotStore): Promise<void>;
+    /**
+     * Check if a workflow ID has persisted state (can be resumed).
+     *
+     * @param store - Snapshot store
+     * @param id - Workflow execution ID
+     * @returns `true` if state exists, `false` otherwise (including on store errors)
+     */
+    hasState(store: SnapshotStore, id: string): Promise<boolean>;
+    /**
+     * Delete persisted state for a workflow (cancel resume capability).
+     * Deleting is effectively an ack/reset: the workflow can no longer resume from that state.
+     * If you delete while a run is in flight, the run continues; on success it may delete again (no-op) or save (recreating state).
+     * For multi-worker safety, prefer deleting only when the workflow is not running or when you hold the lock.
+     *
+     * @param store - Snapshot store
+     * @param id - Workflow execution ID
+     * @returns `true` on success, `false` on store errors
+     */
+    deleteState(store: SnapshotStore, id: string): Promise<boolean>;
+    /**
+     * Bulk delete persisted state for multiple workflow IDs (best-effort).
+     * Use for admin/cleanup. Deletes in a loop with optional concurrency.
+     *
+     * @param store - Snapshot store
+     * @param ids - Workflow execution IDs to delete
+     * @param options - Optional concurrency and error handling
+     * @returns Count of deleted entries and any errors when continueOnError is true
+     */
+    deleteStates(store: SnapshotStore, ids: string[], options?: DeleteStatesOptions): Promise<DeleteStatesResult>;
+    /**
+     * List workflow IDs with persisted state.
+     *
+     * @param store - Snapshot store
+     * @param options - Optional prefix and limit
+     * @returns Array of { id, updatedAt } entries
+     */
+    listPending(store: SnapshotStore, options?: {
+        prefix?: string;
+        limit?: number;
+    }): Promise<Array<{
+        id: string;
+        updatedAt: string;
+    }>>;
+};
+
+export { type ConcurrentExecutionError as C, type DeleteStatesOptions as D, type IdempotencyConflictError as I, type LeaseExpiredError as L, type PersistenceError as P, type VersionMismatchError as V, type WorkflowLock as W, type DeleteStatesResult as a, type DurableOptions as b, type DurableWorkflowEvent as c, durable as d, isIdempotencyConflict as e, isLeaseExpired as f, isPersistenceError as g, isVersionMismatch as h, isConcurrentExecution as i };

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var N=Object.defineProperty;var je=Object.getOwnPropertyDescriptor;var Ie=Object.getOwnPropertyNames;var _e=Object.prototype.hasOwnProperty;var De=(e,r)=>{for(var n in r)N(e,n,{get:r[n],enumerable:!0})},He=(e,r,n,t)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of Ie(r))!_e.call(e,o)&&o!==n&&N(e,o,{get:()=>r[o],enumerable:!(t=je(r,o))||t.enumerable});return e};var Ke=e=>He(N({},"__esModule",{value:!0}),e);var Ye={};De(Ye,{AWAITLY_CANCELLED:()=>M,AWAITLY_TIMEOUT:()=>V,AWAITLY_UNEXPECTED:()=>G,Awaitly:()=>We,DESERIALIZATION_ERROR:()=>f,PROMISE_REJECTED:()=>l,R:()=>S,TaggedError:()=>C,UNEXPECTED_ERROR:()=>d,UnwrapError:()=>R,all:()=>ye,allAsync:()=>ke,allSettled:()=>xe,allSettledAsync:()=>we,andThen:()=>ue,any:()=>me,anyAsync:()=>ge,bimap:()=>le,compose:()=>O,deserialize:()=>he,err:()=>s,flatMapAsync:()=>D,flatten:()=>ve,flow:()=>U,from:()=>Q,fromNullable:()=>ne,fromPromise:()=>ee,getOrElse:()=>A,getOrElseLazy:()=>m,hydrate:()=>Re,identity:()=>b,isErr:()=>T,isOk:()=>c,isPromiseRejectedError:()=>z,isSerializedResult:()=>de,isUnexpectedError:()=>y,map:()=>te,mapAsync:()=>B,mapError:()=>oe,mapErrorTry:()=>ie,mapTry:()=>ce,match:()=>se,matchError:()=>X,matchErrorPartial:()=>Oe,ok:()=>u,orElse:()=>Te,orElseAsync:()=>pe,partition:()=>Ae,pipe:()=>h,race:()=>I,recover:()=>Ce,recoverAsync:()=>fe,recoverWith:()=>w,runOrNull:()=>q,runOrThrow:()=>Y,runOrThrowAsync:()=>Z,runOrUndefined:()=>$,serialize:()=>Ue,tags:()=>L,tap:()=>ae,tapAsync:()=>F,tapError:()=>Ee,tapErrorAsync:()=>j,traverse:()=>_,traverseAsync:()=>H,traverseParallel:()=>K,tryAsync:()=>re,unwrap:()=>k,unwrapOr:()=>J,unwrapOrElse:()=>W,zip:()=>v,zipAsync:()=>Pe});module.exports=Ke(Ye);var be={};De(be,{AWAITLY_CANCELLED:()=>M,AWAITLY_TIMEOUT:()=>V,AWAITLY_UNEXPECTED:()=>G,DESERIALIZATION_ERROR:()=>f,PROMISE_REJECTED:()=>l,UNEXPECTED_ERROR:()=>d,UnwrapError:()=>R,all:()=>ye,allAsync:()=>ke,allSettled:()=>xe,allSettledAsync:()=>we,andThen:()=>ue,any:()=>me,anyAsync:()=>ge,bimap:()=>le,deserialize:()=>he,err:()=>s,flatten:()=>ve,from:()=>Q,fromNullable:()=>ne,fromPromise:()=>ee,hydrate:()=>Re,isErr:()=>T,isOk:()=>c,isPromiseRejectedError:()=>z,isSerializedResult:()=>de,isUnexpectedError:()=>y,map:()=>te,mapError:()=>oe,mapErrorTry:()=>ie,mapTry:()=>ce,match:()=>se,matchError:()=>X,matchErrorPartial:()=>Oe,ok:()=>u,orElse:()=>Te,orElseAsync:()=>pe,partition:()=>Ae,recover:()=>Ce,recoverAsync:()=>fe,runOrNull:()=>q,runOrThrow:()=>Y,runOrThrowAsync:()=>Z,runOrUndefined:()=>$,serialize:()=>Ue,tags:()=>L,tap:()=>ae,tapError:()=>Ee,tryAsync:()=>re,unwrap:()=>k,unwrapOr:()=>J,unwrapOrElse:()=>W,zip:()=>v,zipAsync:()=>Pe});var d="UNEXPECTED_ERROR",l="PROMISE_REJECTED",G="AWAITLY_UNEXPECTED",M="AWAITLY_CANCELLED",V="AWAITLY_TIMEOUT",L=(...e)=>e;function u(e){return{ok:!0,value:e}}function s(e,r){let n=r?.cause;return{ok:!1,error:e,...n!==void 0?{cause:n}:{}}}var c=e=>e.ok,T=e=>!e.ok,y=e=>typeof e=="object"&&e!==null&&"type"in e&&e.type===d,z=e=>typeof e=="object"&&e!==null&&"type"in e&&e.type===l;function X(e,r){if(y(e))return r.UNEXPECTED_ERROR(e);if(e==="UNEXPECTED_ERROR"){let n={type:d,cause:{type:"UNCAUGHT_EXCEPTION",thrown:e}};return r.UNEXPECTED_ERROR(n)}return r[e](e)}var R=class extends Error{error;cause;constructor(r){let n=typeof r.error=="string"?r.error:JSON.stringify(r.error);super(`Attempted to unwrap an Err: ${n}`),this.name="UnwrapError",this.error=r.error,this.cause=r.cause}},k=e=>{if(e.ok)return e.value;throw new R(e)},J=(e,r)=>e.ok?e.value:r,W=(e,r)=>e.ok?e.value:r(e.error,e.cause),Y=e=>k(e),Z=e=>Promise.resolve(e).then(k),q=e=>e.ok?e.value:null,$=e=>e.ok?e.value:void 0;function Q(e,r){try{return u(e())}catch(n){return r?s(r(n),{cause:n}):s(n)}}async function ee(e,r){try{return u(await e)}catch(n){return r?s(r(n),{cause:n}):s(n)}}async function re(e,r){try{return u(await e())}catch(n){return r?s(r(n),{cause:n}):s(n)}}function ne(e,r){return e!=null?u(e):s(r())}function te(e,r){return e.ok?u(r(e.value)):e}function oe(e,r){return e.ok?e:s(r(e.error,e.cause),{cause:e.cause})}function se(e,r){return e.ok?r.ok(e.value):r.err(e.error,e.cause)}function ue(e,r){return e.ok?r(e.value):e}function ae(e,r){return e.ok&&r(e.value),e}function Ee(e,r){return e.ok||r(e.error,e.cause),e}function ce(e,r,n){if(!e.ok)return e;try{return u(r(e.value))}catch(t){return s(n(t),{cause:t})}}function ie(e,r,n){if(e.ok)return e;try{return s(r(e.error),{cause:e.cause})}catch(t){return s(n(t),{cause:t})}}function le(e,r,n){return e.ok?u(r(e.value)):s(n(e.error,e.cause),{cause:e.cause})}function Te(e,r){return e.ok?e:r(e.error,e.cause)}async function pe(e,r){return e.ok?e:r(e.error,e.cause)}function Ce(e,r){return e.ok?u(e.value):u(r(e.error,e.cause))}async function fe(e,r){let n=await e;return n.ok?u(n.value):u(await r(n.error,n.cause))}function Re(e){if(typeof e!="object"||e===null||!("ok"in e))return null;let r=e;return r.ok===!0&&"value"in r?u(r.value):r.ok===!1&&"error"in r?s(r.error,{cause:r.cause}):null}function de(e){if(typeof e!="object"||e===null||!("ok"in e))return!1;let r=e;return r.ok===!0&&"value"in r||r.ok===!1&&"error"in r}function ye(e){let r=[];for(let n of e){if(!n.ok)return n;r.push(n.value)}return u(r)}async function ke(e){let r=[];for(let n of e)try{let t=await n;if(!t.ok)return t;r.push(t.value)}catch(t){return s({type:l,cause:t},{cause:{type:"PROMISE_REJECTION",reason:t}})}return u(r)}function xe(e){let r=[],n=[];for(let t of e)t.ok?r.push(t.value):n.push({error:t.error,cause:t.cause});return n.length>0?s(n):u(r)}async function we(e){let r=await Promise.all(e.map(o=>Promise.resolve(o).then(a=>({status:"result",result:a})).catch(a=>({status:"rejected",error:{type:l,cause:a},cause:{type:"PROMISE_REJECTION",reason:a}})))),n=[],t=[];for(let o of r)o.status==="rejected"?t.push({error:o.error,cause:o.cause}):o.result.ok?n.push(o.result.value):t.push({error:o.result.error,cause:o.result.cause});return t.length>0?s(t):u(n)}function Ae(e){let r=[],n=[];for(let t of e)t.ok?r.push(t.value):n.push(t.error);return{values:r,errors:n}}function me(e){if(e.length===0)return s({type:"EMPTY_INPUT",message:"any() requires at least one Result"});let r;for(let n of e){if(n.ok)return n;r||(r=n)}return r}async function ge(e){return e.length===0?s({type:"EMPTY_INPUT",message:"anyAsync() requires at least one Result"}):new Promise(r=>{let n=!1,t=e.length,o=null;for(let a of e)Promise.resolve(a).catch(E=>s({type:l,cause:E},{cause:{type:"PROMISE_REJECTION",reason:E}})).then(E=>{if(!n){if(E.ok){n=!0,r(E);return}o||(o=E),t--,t===0&&r(o)}})})}function v(e,r){return e.ok?r.ok?u([e.value,r.value]):r:e}async function Pe(e,r){let n=a=>Promise.resolve(a).catch(E=>s({type:l,cause:E},{cause:{type:"PROMISE_REJECTION",reason:E}})),[t,o]=await Promise.all([n(e),n(r)]);return v(t,o)}function ve(e){return e.ok?e.value:e}var f="DESERIALIZATION_ERROR";function he(e){if(typeof e!="object"||e===null)return s({type:f,value:e});if(!("ok"in e))return s({type:f,value:e});let r=e;return r.ok===!0&&"value"in r?u(r.value):r.ok===!1&&"error"in r?s(r.error,{cause:r.cause}):s({type:f,value:e})}function Ue(e){return e.ok?{ok:!0,value:e.value}:{ok:!1,error:e.error}}function Oe(e,r,n){if(y(e)){let o=r.UNEXPECTED_ERROR;return o?o(e):n(e)}let t=r[e];return t?t(e):n(e)}var x=class extends Error{_tag};function C(e,r){return class extends x{_tag=e;constructor(n,t){let o=r?.message?r.message(n??{}):e;if(super(o),this.name=e,Object.setPrototypeOf(this,new.target.prototype),n&&typeof n=="object"){let{_tag:a,name:E,message:i,stack:g,...p}=n,P=Object.prototype.hasOwnProperty.call(p,"cause"),Fe=P?p.cause:void 0;P&&delete p.cause;let Be=t?.cause!==void 0;if(P&&Be)throw new TypeError("TaggedError: cannot provide 'cause' in props when also setting ErrorOptions.cause");Object.assign(this,p),P&&(this.cause=Fe),Be&&(this.cause=t?.cause)}else t?.cause!==void 0&&(this.cause=t.cause)}}}Object.defineProperty(C,Symbol.hasInstance,{value:e=>e instanceof x});(o=>{function e(a){return a instanceof Error}o.isError=e;function r(a){return a instanceof x}o.isTaggedError=r;function n(a,E){let i=a._tag,g=E[i];return g(a)}o.match=n;function t(a,E,i){let g=a._tag,p=E[g];return p?p(a):i(a)}o.matchPartial=t})(C||={});function h(e,...r){return r.reduce((n,t)=>t(n),e)}function U(...e){return r=>e.reduce((n,t)=>t(n),r)}function O(...e){return r=>e.reduceRight((n,t)=>t(n),r)}var b=e=>e;function Se(e,r){return c(e)?u(r(e.value)):e}function Ne(e,r){return c(e)?r(e.value):e}function Ge(e,r,n){return c(e)?u(r(e.value)):s(n(e.error),{cause:e.cause})}function Me(e,r){return T(e)?s(r(e.error),{cause:e.cause}):e}function Ve(e,r){return c(e)&&r(e.value),e}function Le(e,r){return T(e)&&r(e.error),e}function ze(e,r){return c(e)?r.ok(e.value):r.err(e.error,e.cause)}function Xe(e,r){return c(e)?e.value:r(e.error)}function w(e,r){return c(e)?e:r(e.error)}function A(e,r){return c(e)?e.value:r}function m(e,r){return c(e)?e.value:r()}async function B(e,r){let n=await e;return c(n)?u(await r(n.value)):n}async function D(e,r){let n=await e;return c(n)?r(n.value):n}async function F(e,r){let n=await e;return c(n)&&await r(n.value),n}async function j(e,r){let n=await e;return T(n)&&await r(n.error),n}async function Je(e){if(e.length===0)return u([]);let r=new Array(e.length),n=0,t=!1;return new Promise(o=>{e.forEach((a,E)=>{a.then(i=>{t||(T(i)?(t=!0,o(i)):(r[E]=i.value,n++,n===e.length&&(t=!0,o(u(r)))))},i=>{t||(t=!0,o(s({type:l,cause:i},{cause:{type:"PROMISE_REJECTION",reason:i}})))})})})}async function I(e){return Promise.race(e.map(r=>r.catch(n=>s({type:l,cause:n},{cause:{type:"PROMISE_REJECTION",reason:n}}))))}function _(e,r){let n=[];for(let t=0;t<e.length;t++){let o=r(e[t],t);if(T(o))return o;n.push(o.value)}return u(n)}async function H(e,r){let n=[];for(let t=0;t<e.length;t++){let o=await r(e[t],t);if(T(o))return o;n.push(o.value)}return u(n)}async function K(e,r){return Je(e.map((n,t)=>r(n,t)))}var S={map:e=>r=>Se(r,e),flatMap:e=>r=>Ne(r,e),bimap:(e,r)=>n=>Ge(n,e,r),mapError:e=>r=>Me(r,e),tap:e=>r=>Ve(r,e),tapError:e=>r=>Le(r,e),match:e=>r=>ze(r,e),recover:e=>r=>Xe(r,e),recoverWith:e=>r=>w(r,e),getOrElse:e=>r=>A(r,e),getOrElseLazy:e=>r=>m(r,e)};var We={...be,TaggedError:C,pipe:h,flow:U,compose:O,identity:b,R:S,recoverWith:w,getOrElse:A,getOrElseLazy:m,mapAsync:B,flatMapAsync:D,tapAsync:F,tapErrorAsync:j,race:I,traverse:_,traverseAsync:H,traverseParallel:K};0&&(module.exports={AWAITLY_CANCELLED,AWAITLY_TIMEOUT,AWAITLY_UNEXPECTED,Awaitly,DESERIALIZATION_ERROR,PROMISE_REJECTED,R,TaggedError,UNEXPECTED_ERROR,UnwrapError,all,allAsync,allSettled,allSettledAsync,andThen,any,anyAsync,bimap,compose,deserialize,err,flatMapAsync,flatten,flow,from,fromNullable,fromPromise,getOrElse,getOrElseLazy,hydrate,identity,isErr,isOk,isPromiseRejectedError,isSerializedResult,isUnexpectedError,map,mapAsync,mapError,mapErrorTry,mapTry,match,matchError,matchErrorPartial,ok,orElse,orElseAsync,partition,pipe,race,recover,recoverAsync,recoverWith,runOrNull,runOrThrow,runOrThrowAsync,runOrUndefined,serialize,tags,tap,tapAsync,tapError,tapErrorAsync,traverse,traverseAsync,traverseParallel,tryAsync,unwrap,unwrapOr,unwrapOrElse,zip,zipAsync});
+"use strict";var S=Object.defineProperty;var ze=Object.getOwnPropertyDescriptor;var Le=Object.getOwnPropertyNames;var Ge=Object.prototype.hasOwnProperty;var De=(e,r)=>{for(var n in r)S(e,n,{get:r[n],enumerable:!0})},$e=(e,r,n,t)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of Le(r))!Ge.call(e,o)&&o!==n&&S(e,o,{get:()=>r[o],enumerable:!(t=ze(r,o))||t.enumerable});return e};var Je=e=>$e(S({},"__esModule",{value:!0}),e);var or={};De(or,{AWAITLY_CANCELLED:()=>V,AWAITLY_TIMEOUT:()=>z,AWAITLY_UNEXPECTED:()=>M,Awaitly:()=>tr,DESERIALIZATION_ERROR:()=>C,PROMISE_REJECTED:()=>T,R:()=>N,TaggedError:()=>i,UnexpectedError:()=>d,UnwrapError:()=>R,all:()=>ke,allAsync:()=>ye,allSettled:()=>xe,allSettledAsync:()=>me,andThen:()=>ue,any:()=>we,anyAsync:()=>Ae,bimap:()=>le,compose:()=>U,deserialize:()=>he,err:()=>s,flatMapAsync:()=>D,flatten:()=>ve,flow:()=>O,from:()=>Q,fromNullable:()=>ne,fromPromise:()=>ee,getOrElse:()=>g,getOrElseLazy:()=>w,hydrate:()=>Ce,identity:()=>b,isErr:()=>p,isOk:()=>c,isPromiseRejectedError:()=>G,isSerializedResult:()=>Re,isUnexpectedError:()=>y,map:()=>te,mapAsync:()=>B,mapError:()=>oe,mapErrorTry:()=>ce,mapTry:()=>Ee,match:()=>se,matchError:()=>$,matchErrorPartial:()=>Ue,ok:()=>u,orElse:()=>Te,orElseAsync:()=>pe,partition:()=>ge,pipe:()=>h,race:()=>_,recover:()=>fe,recoverAsync:()=>de,recoverWith:()=>m,runOrNull:()=>X,runOrThrow:()=>Y,runOrThrowAsync:()=>Z,runOrUndefined:()=>q,serialize:()=>Oe,tags:()=>L,tap:()=>ae,tapAsync:()=>F,tapError:()=>ie,tapErrorAsync:()=>j,traverse:()=>I,traverseAsync:()=>K,traverseParallel:()=>H,tryAsync:()=>re,unwrap:()=>x,unwrapOr:()=>J,unwrapOrElse:()=>W,zip:()=>v,zipAsync:()=>Pe});module.exports=Je(or);var be={};De(be,{AWAITLY_CANCELLED:()=>V,AWAITLY_TIMEOUT:()=>z,AWAITLY_UNEXPECTED:()=>M,DESERIALIZATION_ERROR:()=>C,PROMISE_REJECTED:()=>T,UnexpectedError:()=>d,UnwrapError:()=>R,all:()=>ke,allAsync:()=>ye,allSettled:()=>xe,allSettledAsync:()=>me,andThen:()=>ue,any:()=>we,anyAsync:()=>Ae,bimap:()=>le,deserialize:()=>he,err:()=>s,flatten:()=>ve,from:()=>Q,fromNullable:()=>ne,fromPromise:()=>ee,hydrate:()=>Ce,isErr:()=>p,isOk:()=>c,isPromiseRejectedError:()=>G,isSerializedResult:()=>Re,isUnexpectedError:()=>y,map:()=>te,mapError:()=>oe,mapErrorTry:()=>ce,mapTry:()=>Ee,match:()=>se,matchError:()=>$,matchErrorPartial:()=>Ue,ok:()=>u,orElse:()=>Te,orElseAsync:()=>pe,partition:()=>ge,recover:()=>fe,recoverAsync:()=>de,runOrNull:()=>X,runOrThrow:()=>Y,runOrThrowAsync:()=>Z,runOrUndefined:()=>q,serialize:()=>Oe,tags:()=>L,tap:()=>ae,tapError:()=>ie,tryAsync:()=>re,unwrap:()=>x,unwrapOr:()=>J,unwrapOrElse:()=>W,zip:()=>v,zipAsync:()=>Pe});var k=class extends Error{_tag};function i(e,r){return class extends k{_tag=e;constructor(n,t){let o=r?.message?r.message(n??{}):e;if(super(o),this.name=e,Object.setPrototypeOf(this,new.target.prototype),n&&typeof n=="object"){let{_tag:a,name:E,message:l,stack:A,...f}=n,P=Object.prototype.hasOwnProperty.call(f,"cause"),Ve=P?f.cause:void 0;P&&delete f.cause;let Be=t?.cause!==void 0;if(P&&Be)throw new TypeError("TaggedError: cannot provide 'cause' in props when also setting ErrorOptions.cause");Object.assign(this,f),P&&(this.cause=Ve),Be&&(this.cause=t?.cause)}else t?.cause!==void 0&&(this.cause=t.cause)}}}Object.defineProperty(i,Symbol.hasInstance,{value:e=>e instanceof k});(o=>{function e(a){return a instanceof Error}o.isError=e;function r(a){return a instanceof k}o.isTaggedError=r;function n(a,E){let l=a._tag,A=E[l];return A(a)}o.match=n;function t(a,E,l){let A=a._tag,f=E[A];return f?f(a):l(a)}o.matchPartial=t})(i||={});var Fe=class extends i("TimeoutError",{message:r=>r.operation?`TimeoutError: ${r.operation} timed out after ${r.ms}ms`:`TimeoutError: Operation timed out after ${r.ms}ms`}){},je=class extends i("RetryExhaustedError",{message:r=>r.operation?`RetryExhaustedError: ${r.operation} failed after ${r.attempts} attempts`:`RetryExhaustedError: Operation failed after ${r.attempts} attempts`}){},_e=class extends i("RateLimitError",{message:r=>r.limiterName?`RateLimitError: Rate limit exceeded for ${r.limiterName}${r.retryAfterMs?`, retry after ${r.retryAfterMs}ms`:""}`:`RateLimitError: Rate limit exceeded${r.retryAfterMs?`, retry after ${r.retryAfterMs}ms`:""}`}){},Ie=class extends i("CircuitBreakerOpenError",{message:r=>`CircuitBreakerOpenError: Circuit ${r.circuitName} is ${r.state??"OPEN"}${r.retryAfterMs?`, retry after ${Math.ceil(r.retryAfterMs/1e3)}s`:""}`}){},Ke=class extends i("ValidationError",{message:r=>`ValidationError: Invalid ${r.field} - ${r.reason}`}){},He=class extends i("NotFoundError",{message:r=>r.id?`NotFoundError: ${r.resource} with id ${r.id} not found`:`NotFoundError: ${r.resource} not found`}){},Ne=class extends i("UnauthorizedError",{message:r=>r.reason?`UnauthorizedError: ${r.reason}`:r.action&&r.resource?`UnauthorizedError: Not authorized to ${r.action} ${r.resource}`:"UnauthorizedError: Access denied"}){},Se=class extends i("NetworkError",{message:r=>r.url?`NetworkError: ${r.reason} (${r.url})`:`NetworkError: ${r.reason}`}){},Me=class extends i("CompensationError",{message:r=>`CompensationError: Failed to compensate step ${r.step}`}){},d=class extends i("UnexpectedError",{message:r=>`UnexpectedError: ${r.cause instanceof Error?r.cause.message:String(r.cause??"unknown")}`}){};var T="PROMISE_REJECTED",M="AWAITLY_UNEXPECTED",V="AWAITLY_CANCELLED",z="AWAITLY_TIMEOUT",L=(...e)=>e;function u(e){return{ok:!0,value:e}}function s(e,r){let n=r?.cause;return{ok:!1,error:e,...n!==void 0?{cause:n}:{}}}var c=e=>e.ok,p=e=>!e.ok,y=e=>e instanceof d||typeof e=="object"&&e!==null&&"_tag"in e&&e._tag==="UnexpectedError",G=e=>typeof e=="object"&&e!==null&&"type"in e&&e.type===T;function $(e,r){return y(e)?r.UnexpectedError(e):r[e](e)}var R=class extends Error{error;cause;constructor(r){let n=typeof r.error=="string"?r.error:JSON.stringify(r.error);super(`Attempted to unwrap an Err: ${n}`),this.name="UnwrapError",this.error=r.error,this.cause=r.cause}},x=e=>{if(e.ok)return e.value;throw new R(e)},J=(e,r)=>e.ok?e.value:r,W=(e,r)=>e.ok?e.value:r(e.error,e.cause),Y=e=>x(e),Z=e=>Promise.resolve(e).then(x),X=e=>e.ok?e.value:null,q=e=>e.ok?e.value:void 0;function Q(e,r){try{return u(e())}catch(n){return r?s(r(n),{cause:n}):s(n)}}async function ee(e,r){try{return u(await e)}catch(n){return r?s(r(n),{cause:n}):s(n)}}async function re(e,r){try{return u(await e())}catch(n){return r?s(r(n),{cause:n}):s(n)}}function ne(e,r){return e!=null?u(e):s(r())}function te(e,r){return e.ok?u(r(e.value)):e}function oe(e,r){return e.ok?e:s(r(e.error,e.cause),{cause:e.cause})}function se(e,r){return e.ok?r.ok(e.value):r.err(e.error,e.cause)}function ue(e,r){return e.ok?r(e.value):e}function ae(e,r){return e.ok&&r(e.value),e}function ie(e,r){return e.ok||r(e.error,e.cause),e}function Ee(e,r,n){if(!e.ok)return e;try{return u(r(e.value))}catch(t){return s(n(t),{cause:t})}}function ce(e,r,n){if(e.ok)return e;try{return s(r(e.error),{cause:e.cause})}catch(t){return s(n(t),{cause:t})}}function le(e,r,n){return e.ok?u(r(e.value)):s(n(e.error,e.cause),{cause:e.cause})}function Te(e,r){return e.ok?e:r(e.error,e.cause)}async function pe(e,r){return e.ok?e:r(e.error,e.cause)}function fe(e,r){return e.ok?u(e.value):u(r(e.error,e.cause))}async function de(e,r){let n=await e;return n.ok?u(n.value):u(await r(n.error,n.cause))}function Ce(e){if(typeof e!="object"||e===null||!("ok"in e))return null;let r=e;return r.ok===!0&&"value"in r?u(r.value):r.ok===!1&&"error"in r?s(r.error,{cause:r.cause}):null}function Re(e){if(typeof e!="object"||e===null||!("ok"in e))return!1;let r=e;return r.ok===!0&&"value"in r||r.ok===!1&&"error"in r}function ke(e){let r=[];for(let n of e){if(!n.ok)return n;r.push(n.value)}return u(r)}async function ye(e){let r=[];for(let n of e)try{let t=await n;if(!t.ok)return t;r.push(t.value)}catch(t){return s({type:T,cause:t},{cause:{type:"PROMISE_REJECTION",reason:t}})}return u(r)}function xe(e){let r=[],n=[];for(let t of e)t.ok?r.push(t.value):n.push({error:t.error,cause:t.cause});return n.length>0?s(n):u(r)}async function me(e){let r=await Promise.all(e.map(o=>Promise.resolve(o).then(a=>({status:"result",result:a})).catch(a=>({status:"rejected",error:{type:T,cause:a},cause:{type:"PROMISE_REJECTION",reason:a}})))),n=[],t=[];for(let o of r)o.status==="rejected"?t.push({error:o.error,cause:o.cause}):o.result.ok?n.push(o.result.value):t.push({error:o.result.error,cause:o.result.cause});return t.length>0?s(t):u(n)}function ge(e){let r=[],n=[];for(let t of e)t.ok?r.push(t.value):n.push(t.error);return{values:r,errors:n}}function we(e){if(e.length===0)return s({type:"EMPTY_INPUT",message:"any() requires at least one Result"});let r;for(let n of e){if(n.ok)return n;r||(r=n)}return r}async function Ae(e){return e.length===0?s({type:"EMPTY_INPUT",message:"anyAsync() requires at least one Result"}):new Promise(r=>{let n=!1,t=e.length,o=null;for(let a of e)Promise.resolve(a).catch(E=>s({type:T,cause:E},{cause:{type:"PROMISE_REJECTION",reason:E}})).then(E=>{if(!n){if(E.ok){n=!0,r(E);return}o||(o=E),t--,t===0&&r(o)}})})}function v(e,r){return e.ok?r.ok?u([e.value,r.value]):r:e}async function Pe(e,r){let n=a=>Promise.resolve(a).catch(E=>s({type:T,cause:E},{cause:{type:"PROMISE_REJECTION",reason:E}})),[t,o]=await Promise.all([n(e),n(r)]);return v(t,o)}function ve(e){return e.ok?e.value:e}var C="DESERIALIZATION_ERROR";function he(e){if(typeof e!="object"||e===null)return s({type:C,value:e});if(!("ok"in e))return s({type:C,value:e});let r=e;return r.ok===!0&&"value"in r?u(r.value):r.ok===!1&&"error"in r?s(r.error,{cause:r.cause}):s({type:C,value:e})}function Oe(e){return e.ok?{ok:!0,value:e.value}:{ok:!1,error:e.error}}function Ue(e,r,n){if(y(e)){let o=r.UnexpectedError;return o?o(e):n(e)}let t=r[e];return t?t(e):n(e)}function h(e,...r){return r.reduce((n,t)=>t(n),e)}function O(...e){return r=>e.reduce((n,t)=>t(n),r)}function U(...e){return r=>e.reduceRight((n,t)=>t(n),r)}var b=e=>e;function We(e,r){return c(e)?u(r(e.value)):e}function Ye(e,r){return c(e)?r(e.value):e}function Ze(e,r,n){return c(e)?u(r(e.value)):s(n(e.error),{cause:e.cause})}function Xe(e,r){return p(e)?s(r(e.error),{cause:e.cause}):e}function qe(e,r){return c(e)&&r(e.value),e}function Qe(e,r){return p(e)&&r(e.error),e}function er(e,r){return c(e)?r.ok(e.value):r.err(e.error,e.cause)}function rr(e,r){return c(e)?e.value:r(e.error)}function m(e,r){return c(e)?e:r(e.error)}function g(e,r){return c(e)?e.value:r}function w(e,r){return c(e)?e.value:r()}async function B(e,r){let n=await e;return c(n)?u(await r(n.value)):n}async function D(e,r){let n=await e;return c(n)?r(n.value):n}async function F(e,r){let n=await e;return c(n)&&await r(n.value),n}async function j(e,r){let n=await e;return p(n)&&await r(n.error),n}async function nr(e){if(e.length===0)return u([]);let r=new Array(e.length),n=0,t=!1;return new Promise(o=>{e.forEach((a,E)=>{a.then(l=>{t||(p(l)?(t=!0,o(l)):(r[E]=l.value,n++,n===e.length&&(t=!0,o(u(r)))))},l=>{t||(t=!0,o(s({type:T,cause:l},{cause:{type:"PROMISE_REJECTION",reason:l}})))})})})}async function _(e){return Promise.race(e.map(r=>r.catch(n=>s({type:T,cause:n},{cause:{type:"PROMISE_REJECTION",reason:n}}))))}function I(e,r){let n=[];for(let t=0;t<e.length;t++){let o=r(e[t],t);if(p(o))return o;n.push(o.value)}return u(n)}async function K(e,r){let n=[];for(let t=0;t<e.length;t++){let o=await r(e[t],t);if(p(o))return o;n.push(o.value)}return u(n)}async function H(e,r){return nr(e.map((n,t)=>r(n,t)))}var N={map:e=>r=>We(r,e),flatMap:e=>r=>Ye(r,e),bimap:(e,r)=>n=>Ze(n,e,r),mapError:e=>r=>Xe(r,e),tap:e=>r=>qe(r,e),tapError:e=>r=>Qe(r,e),match:e=>r=>er(r,e),recover:e=>r=>rr(r,e),recoverWith:e=>r=>m(r,e),getOrElse:e=>r=>g(r,e),getOrElseLazy:e=>r=>w(r,e)};var tr={...be,TaggedError:i,pipe:h,flow:O,compose:U,identity:b,R:N,recoverWith:m,getOrElse:g,getOrElseLazy:w,mapAsync:B,flatMapAsync:D,tapAsync:F,tapErrorAsync:j,race:_,traverse:I,traverseAsync:K,traverseParallel:H};0&&(module.exports={AWAITLY_CANCELLED,AWAITLY_TIMEOUT,AWAITLY_UNEXPECTED,Awaitly,DESERIALIZATION_ERROR,PROMISE_REJECTED,R,TaggedError,UnexpectedError,UnwrapError,all,allAsync,allSettled,allSettledAsync,andThen,any,anyAsync,bimap,compose,deserialize,err,flatMapAsync,flatten,flow,from,fromNullable,fromPromise,getOrElse,getOrElseLazy,hydrate,identity,isErr,isOk,isPromiseRejectedError,isSerializedResult,isUnexpectedError,map,mapAsync,mapError,mapErrorTry,mapTry,match,matchError,matchErrorPartial,ok,orElse,orElseAsync,partition,pipe,race,recover,recoverAsync,recoverWith,runOrNull,runOrThrow,runOrThrowAsync,runOrUndefined,serialize,tags,tap,tapAsync,tapError,tapErrorAsync,traverse,traverseAsync,traverseParallel,tryAsync,unwrap,unwrapOr,unwrapOrElse,zip,zipAsync});
 //# sourceMappingURL=index.cjs.map