awaitly 1.35.0 → 2.0.0

package/dist/result.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/slugs.ts","../src/tagged-error.ts","../src/errors.ts","../src/result/index.ts"],"sourcesContent":["/**\n * awaitly/slugs\n *\n * Source-of-truth slug namespace. Every concept that surfaces as a runtime\n * error, lint rule, static-analyzer diagnostic, visualizer event, or skill rule\n * has exactly one canonical kebab-case slug here.\n *\n * Slugs are public API. Renames are a major version bump. Adds are non-breaking.\n *\n * Categories:\n * - step-*       step() discipline\n * - workflow-*   createWorkflow / run / runWithState shape\n * - result-*     Result usage\n * - error-*      Boundary handling\n * - concurrency-* step.all/map/race vs Promise.*\n * - runtime-*    Failures only observable at runtime\n */\n\nexport const AWAITLY_SLUGS = {\n  // --- step-* ---\n  \"step-require-id\": \"step-require-id\",\n  \"step-no-immediate-execution\": \"step-no-immediate-execution\",\n  \"step-require-thunk-for-key\": \"step-require-thunk-for-key\",\n  \"step-no-bare-await\": \"step-no-bare-await\",\n  \"step-no-try-catch-wrap\": \"step-no-try-catch-wrap\",\n  \"step-stable-cache-keys\": \"step-stable-cache-keys\",\n\n  // --- workflow-* ---\n  \"workflow-no-floating\": \"workflow-no-floating\",\n  \"workflow-options-position\": \"workflow-options-position\",\n  \"workflow-callback-shape\": \"workflow-callback-shape\",\n  \"workflow-no-callable-form\": \"workflow-no-callable-form\",\n  \"workflow-no-dynamic-import\": \"workflow-no-dynamic-import\",\n\n  // --- result-* ---\n  \"result-no-floating\": \"result-no-floating\",\n  \"result-require-handling\": \"result-require-handling\",\n  \"result-no-double-wrap\": \"result-no-double-wrap\",\n  \"result-no-manual-propagation\": \"result-no-manual-propagation\",\n  \"result-no-direct-ok-err\": \"result-no-direct-ok-err\",\n\n  // --- error-* ---\n  \"error-check-unexpected-first\": \"error-check-unexpected-first\",\n  \"error-access-cause\": \"error-access-cause\",\n  \"error-normalize\": \"error-normalize\",\n  \"error-no-throw-in-deps\": \"error-no-throw-in-deps\",\n\n  // --- concurrency-* ---\n  \"concurrency-no-promise-all\": \"concurrency-no-promise-all\",\n  \"concurrency-no-promise-race\": \"concurrency-no-promise-race\",\n  \"concurrency-no-promise-allsettled\": \"concurrency-no-promise-allsettled\",\n\n  // --- runtime-* ---\n  \"runtime-step-timeout\": \"runtime-step-timeout\",\n  \"runtime-step-aborted\": \"runtime-step-aborted\",\n  \"runtime-retry-exhausted\": \"runtime-retry-exhausted\",\n  \"runtime-rate-limit\": \"runtime-rate-limit\",\n  \"runtime-circuit-open\": \"runtime-circuit-open\",\n  \"runtime-unexpected\": \"runtime-unexpected\",\n  \"runtime-resolver-not-found\": \"runtime-resolver-not-found\",\n  \"runtime-saga-compensation\": \"runtime-saga-compensation\",\n} as const;\n\n/** All canonical awaitly slugs as a string-literal union. */\nexport type AwaitlySlug = keyof typeof AWAITLY_SLUGS;\n\n/** Categories derived from slug prefixes. */\nexport type AwaitlySlugCategory =\n  | \"step\"\n  | \"workflow\"\n  | \"result\"\n  | \"error\"\n  | \"concurrency\"\n  | \"runtime\";\n\n/** Returns the category (prefix) of a slug. */\nexport function slugCategory(slug: AwaitlySlug): AwaitlySlugCategory {\n  return slug.split(\"-\")[0] as AwaitlySlugCategory;\n}\n\n/**\n * Returns the canonical docs URL for a slug. Resolves to the matching\n * anchored section on the consolidated rule index page.\n */\nexport function slugDocsUrl(slug: AwaitlySlug): string {\n  return `https://jagreehal.github.io/awaitly/rules/#${slug}`;\n}\n\n/** Type guard: is a string a known awaitly slug? */\nexport function isAwaitlySlug(value: string): value is AwaitlySlug {\n  return Object.prototype.hasOwnProperty.call(AWAITLY_SLUGS, value);\n}\n\n/** All slugs as an array. */\n// Object.keys returns string[] — cast is safe because AWAITLY_SLUGS is `as const`\n// and the module's keys are never mutated.\nexport const ALL_SLUGS: readonly AwaitlySlug[] = Object.keys(\n  AWAITLY_SLUGS\n) as AwaitlySlug[];\n","/**\n * awaitly/tagged-error\n *\n * Factory for creating tagged error types with exhaustive pattern matching.\n * Enables TypeScript to enforce that all error variants are handled.\n *\n * @example\n * ```typescript\n * // Define error types (Props via generic)\n * class NotFoundError extends TaggedError(\"NotFoundError\")<{\n *   id: string;\n *   resource: string;\n * }> {}\n *\n * // Define with type-safe message (Props inferred from callback annotation)\n * class ValidationError extends TaggedError(\"ValidationError\", {\n *   message: (p: { field: string; reason: string }) => `Invalid ${p.field}: ${p.reason}`,\n * }) {}\n *\n * // Create instances\n * const error = new NotFoundError({ id: \"123\", resource: \"User\" });\n *\n * // Runtime type check: instanceof TaggedError works!\n * console.log(error instanceof TaggedError); // true\n *\n * // Exhaustive matching\n * type AppError = NotFoundError | ValidationError;\n * const message = TaggedError.match(error as AppError, {\n *   NotFoundError: (e) => `Missing: ${e.resource} ${e.id}`,\n *   ValidationError: (e) => `Invalid ${e.field}: ${e.reason}`,\n * });\n * ```\n */\n\nimport { type AwaitlySlug, slugDocsUrl } from \"./slugs\";\n\n/**\n * Options for Error constructor (compatible with ES2022 ErrorOptions).\n */\nexport interface TaggedErrorOptions {\n  cause?: unknown;\n}\n\n/**\n * Options for TaggedError factory with type-safe message callback.\n */\nexport interface TaggedErrorCreateOptions<Props extends Record<string, unknown>> {\n  /** Custom message generator from props. Annotate parameter for type safety. */\n  message: (props: Props) => string;\n  /**\n   * Canonical awaitly slug for this error class. When set, instances carry\n   * `code`, `hint`, and `docsUrl` populated from the slugs namespace.\n   * Required together with `hint` for awaitly-system errors.\n   */\n  slug?: AwaitlySlug;\n  /**\n   * One-line \"do X instead\" guidance shown alongside the error.\n   * Required when `slug` is set.\n   */\n  hint?: string;\n}\n\n/**\n * Base interface for all tagged errors.\n */\nexport interface TaggedErrorBase extends Error {\n  readonly _tag: string;\n  /** Canonical slug for awaitly-system errors. Undefined for user errors that opt out. */\n  readonly code?: AwaitlySlug;\n  /** One-line guidance. Undefined when no slug is set. */\n  readonly hint?: string;\n  /** Canonical docs URL. Undefined when no slug is set. */\n  readonly docsUrl?: string;\n}\n\n/**\n * Internal base class for instanceof checks.\n * All TaggedError-created classes extend this.\n * @internal\n */\nclass InternalTaggedErrorBase extends Error implements TaggedErrorBase {\n  readonly _tag!: string;\n}\n\n/**\n * Instance type for factory-created TaggedErrors.\n */\ntype TaggedErrorInstance<Tag extends string, Props> = TaggedErrorBase & {\n  readonly _tag: Tag;\n} & Readonly<Props>;\n\n/**\n * Constructor args type - conditionally optional based on whether Props has required fields.\n * - If Props is empty or all properties are optional: props argument is optional\n * - If Props has any required properties: props argument is required\n * @internal\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\ntype ConstructorArgs<Props extends Record<string, unknown>> = {} extends Props\n  ? [props?: Props | void, options?: TaggedErrorOptions]\n  : [props: Props, options?: TaggedErrorOptions];\n\n/**\n * Constructor type returned by TaggedError factory.\n */\nexport interface TaggedErrorConstructor<\n  Tag extends string,\n  Props extends Record<string, unknown>,\n> {\n  new (...args: ConstructorArgs<Props>): TaggedErrorInstance<Tag, Props>;\n  readonly prototype: TaggedErrorInstance<Tag, Props>;\n}\n\n/**\n * Generic class factory type that allows `<Props>` parameterization.\n * This enables the Effect.js-style syntax: `class X extends TaggedError(\"X\")<Props> {}`\n * @internal\n */\nexport interface TaggedErrorClassFactory<Tag extends string> {\n  new <Props extends Record<string, unknown> = Record<string, never>>(\n    ...args: ConstructorArgs<Props>\n  ): TaggedErrorInstance<Tag, Props>;\n}\n\n/**\n * Helper type to extract return type from a function type.\n * @internal\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype FnReturnType<T> = T extends (...args: any[]) => infer R ? R : never;\n\n/**\n * Helper type to get union of return types from all handlers.\n * @internal\n */\ntype HandlersReturnType<H> = { [K in keyof H]: FnReturnType<H[K]> }[keyof H];\n\n/**\n * Helper type to extract keys whose values are definitely functions (not undefined).\n * Only excludes a tag from the fallback type if its handler is guaranteed to be\n * a function. Keys where the value type includes undefined are NOT excluded,\n * ensuring type safety with dynamic/conditional handlers.\n * @internal\n */\ntype DefinitelyHandledKeys<H> = {\n  [K in keyof H]-?: undefined extends H[K] ? never : K;\n}[keyof H];\n\n/**\n * Factory function to create tagged error classes.\n *\n * Two usage patterns:\n *\n * 1. **Props via generic** (default message is tag name):\n *    ```typescript\n *    class NotFoundError extends TaggedError(\"NotFoundError\")<{ id: string }> {}\n *    ```\n *\n * 2. **Props inferred from message callback** (type-safe message):\n *    ```typescript\n *    class NotFoundError extends TaggedError(\"NotFoundError\", {\n *      message: (p: { id: string }) => `Not found: ${p.id}`,\n *    }) {}\n *    ```\n *\n * Both support `instanceof TaggedError` checks at runtime.\n *\n * @param tag - The unique tag string for this error type\n * @param options - Optional configuration with message generator (annotate param for type safety)\n * @returns A class constructor that can be extended\n */\n\n// Overload 1: No options - use <Props> generic syntax, default message is tag\nfunction TaggedError<Tag extends string>(\n  tag: Tag\n): TaggedErrorClassFactory<Tag>;\n\n// Overload 2: With message option - Props inferred from callback parameter annotation\nfunction TaggedError<Tag extends string, Props extends Record<string, unknown>>(\n  tag: Tag,\n  options: TaggedErrorCreateOptions<Props>\n): TaggedErrorConstructor<Tag, Props>;\n\n// Implementation\nfunction TaggedError<Tag extends string, Props extends Record<string, unknown>>(\n  tag: Tag,\n  options?: TaggedErrorCreateOptions<Props>\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): any {\n  return class extends InternalTaggedErrorBase {\n    override readonly _tag: Tag = tag;\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    constructor(props?: any, errorOptions?: TaggedErrorOptions) {\n      // Generate message: call callback if provided (even for prop-less errors), else use tag\n      const message = options?.message ? options.message(props ?? {}) : tag;\n\n      super(message);\n      this.name = tag;\n\n      // Spine fields: populate when factory was given a slug\n      if (options?.slug !== undefined) {\n        if (!options.hint) {\n          throw new TypeError(\n            `TaggedError: 'hint' is required when 'slug' is set (slug: \"${options.slug}\")`\n          );\n        }\n        Object.defineProperty(this, \"code\", {\n          value: options.slug,\n          enumerable: true,\n          writable: false,\n          configurable: false,\n        });\n        Object.defineProperty(this, \"hint\", {\n          value: options.hint,\n          enumerable: true,\n          writable: false,\n          configurable: false,\n        });\n        Object.defineProperty(this, \"docsUrl\", {\n          value: slugDocsUrl(options.slug),\n          enumerable: true,\n          writable: false,\n          configurable: false,\n        });\n      }\n\n      // Maintains proper prototype chain for instanceof checks\n      Object.setPrototypeOf(this, new.target.prototype);\n\n      // Assign props to instance, stripping reserved keys:\n      // - _tag: discriminant for pattern matching (cannot be forged)\n      // - name, message, stack: Error internals (preserve for logging/debugging)\n      // - code, hint, docsUrl: spine fields stripped when slug is set, to prevent\n      //   Object.assign from clobbering the non-configurable/non-writable own props\n      // Note: 'cause' is allowed as a user prop (common for domain errors)\n      if (props && typeof props === \"object\") {\n        let safeProps: Record<string, unknown>;\n        if (options?.slug !== undefined) {\n          const {\n            _tag: _,\n            name: _n,\n            message: _m,\n            stack: _s,\n            code: _c,\n            hint: _h,\n            docsUrl: _d,\n            ...rest\n          } = props;\n          safeProps = rest;\n        } else {\n          const {\n            _tag: _,\n            name: _n,\n            message: _m,\n            stack: _s,\n            ...rest\n          } = props;\n          safeProps = rest;\n        }\n\n        const hasUserCause = Object.prototype.hasOwnProperty.call(\n          safeProps,\n          \"cause\"\n        );\n        const userCause = hasUserCause\n          ? (safeProps as { cause?: unknown }).cause\n          : undefined;\n        if (hasUserCause) {\n          delete (safeProps as { cause?: unknown }).cause;\n        }\n\n        const hasOptionsCause = errorOptions?.cause !== undefined;\n        if (hasUserCause && hasOptionsCause) {\n          throw new TypeError(\n            \"TaggedError: cannot provide 'cause' in props when also setting ErrorOptions.cause\"\n          );\n        }\n\n        Object.assign(this, safeProps);\n\n        if (hasUserCause) {\n          (this as { cause?: unknown }).cause = userCause;\n        }\n        if (hasOptionsCause) {\n          (this as { cause?: unknown }).cause = errorOptions?.cause;\n        }\n      } else if (errorOptions?.cause !== undefined) {\n        (this as { cause?: unknown }).cause = errorOptions.cause;\n      }\n    }\n  };\n}\n\n// Add Symbol.hasInstance so `instanceof TaggedError` works\nObject.defineProperty(TaggedError, Symbol.hasInstance, {\n  value: (instance: unknown): boolean => instance instanceof InternalTaggedErrorBase,\n});\n\n/**\n * Namespace for static methods on TaggedError.\n */\n// eslint-disable-next-line @typescript-eslint/no-namespace\nnamespace TaggedError {\n  /**\n   * Type guard to check if a value is an Error instance.\n   */\n  export function isError(value: unknown): value is Error {\n    return value instanceof Error;\n  }\n\n  /**\n   * Type guard to check if a value is a TaggedError instance.\n   * Uses the same check as `instanceof TaggedError` - only genuine\n   * TaggedError instances (created via the factory) pass this guard.\n   */\n  export function isTaggedError(value: unknown): value is TaggedErrorBase {\n    return value instanceof InternalTaggedErrorBase;\n  }\n\n  /**\n   * Exhaustively matches on a tagged error, requiring handlers for all variants.\n   *\n   * TypeScript will error if any variant in the error union is not handled.\n   *\n   * @remarks When to use: You want compile-time enforcement that every tagged variant is handled.\n   *\n   * @param error - The tagged error to match\n   * @param handlers - Object mapping _tag values to handler functions\n   * @returns The return value of the matched handler\n   *\n   * @example\n   * ```typescript\n   * type AppError = NotFoundError | ValidationError;\n   *\n   * const message = TaggedError.match(error, {\n   *   NotFoundError: (e) => `Not found: ${e.id}`,\n   *   ValidationError: (e) => `Invalid: ${e.field}`,\n   * });\n   * ```\n   */\n  export function match<\n    E extends TaggedErrorBase,\n    H extends { [K in E[\"_tag\"]]: (e: Extract<E, { _tag: K }>) => unknown },\n  >(error: E, handlers: H): HandlersReturnType<H> {\n    const tag = error._tag as E[\"_tag\"];\n    const handler = handlers[tag];\n    return handler(\n      error as Extract<E, { _tag: typeof tag }>\n    ) as HandlersReturnType<H>;\n  }\n\n  /**\n   * Partially matches on a tagged error with a fallback for unhandled variants.\n   *\n   * The fallback receives variants that are NOT definitely handled. A tag is\n   * considered \"definitely handled\" only if its handler is a function (not\n   * `undefined`). This ensures type safety even with dynamic/conditional handlers:\n   *\n   * ```typescript\n   * const maybeHandle = featureFlag ? (e) => e.id : undefined;\n   * TaggedError.matchPartial(\n   *   error,\n   *   { NotFoundError: maybeHandle },  // maybeHandle might be undefined\n   *   (e) => e._tag  // e correctly includes NotFoundError\n   * );\n   * ```\n   *\n   * @param error - The tagged error to match\n   * @param handlers - Partial object mapping _tag values to handler functions\n   * @param otherwise - Fallback handler for unmatched variants\n   * @returns The return value of the matched handler or fallback\n   *\n   * @example\n   * ```typescript\n   * const message = TaggedError.matchPartial(\n   *   error,\n   *   { NotFoundError: (e) => `Not found: ${e.id}` },\n   *   (e) => `Other error: ${e.message}`\n   * );\n   * ```\n   */\n  export function matchPartial<\n    E extends TaggedErrorBase,\n    H extends Partial<{\n      [K in E[\"_tag\"]]: (e: Extract<E, { _tag: K }>) => unknown;\n    }>,\n    T,\n  >(\n    error: E,\n    handlers: H,\n    otherwise: (e: Exclude<E, { _tag: DefinitelyHandledKeys<H> }>) => T\n  ): HandlersReturnType<H> | T {\n    const tag = error._tag as E[\"_tag\"];\n    const handler = handlers[tag];\n    if (handler) {\n      return handler(\n        error as Extract<E, { _tag: typeof tag }>\n      ) as HandlersReturnType<H>;\n    }\n    return otherwise(error as Exclude<E, { _tag: DefinitelyHandledKeys<H> }>);\n  }\n}\n\nexport { TaggedError };\n\n/**\n * Helper type to extract the _tag literal type from a TaggedError.\n *\n * @example\n * ```typescript\n * class MyError extends TaggedError(\"MyError\")<{ id: string }> {}\n * type Tag = TagOf<MyError>; // \"MyError\"\n * ```\n */\nexport type TagOf<E extends TaggedErrorBase> = E[\"_tag\"];\n\n/**\n * Helper type to extract a specific variant from a TaggedError union by tag.\n *\n * @example\n * ```typescript\n * type AppError = NotFoundError | ValidationError;\n * type NotFound = ErrorByTag<AppError, \"NotFoundError\">; // NotFoundError\n * ```\n */\nexport type ErrorByTag<\n  E extends TaggedErrorBase,\n  Tag extends E[\"_tag\"],\n> = Extract<E, { _tag: Tag }>;\n\n/**\n * Reserved keys that are stripped from user props at runtime.\n * These keys cannot be used as user-defined properties:\n * - _tag: discriminant for pattern matching\n * - name, message, stack: Error internals (preserved for logging/debugging)\n * - code, hint, docsUrl: spine fields (non-configurable own properties when slug is set)\n *\n * Note: 'cause' is NOT reserved - it can be used as a user prop.\n */\ntype ReservedErrorKeys = \"_tag\" | \"name\" | \"message\" | \"stack\" | \"code\" | \"hint\" | \"docsUrl\";\n\n/**\n * Helper type to extract props from a TaggedError.\n * Excludes reserved keys that are stripped at runtime.\n *\n * @example\n * ```typescript\n * class MyError extends TaggedError(\"MyError\")<{ id: string }> {}\n * type Props = PropsOf<MyError>; // { id: string }\n *\n * // 'cause' is allowed as a user prop\n * class DomainError extends TaggedError(\"DomainError\")<{ cause: { field: string } }> {}\n * type DomainProps = PropsOf<DomainError>; // { cause: { field: string } }\n * ```\n */\nexport type PropsOf<E extends TaggedErrorBase> = Omit<E, ReservedErrorKeys>;\n","/**\n * awaitly/errors\n *\n * Pre-built error types for common failure scenarios.\n * Uses TaggedError for type-safe exhaustive matching.\n *\n * @example\n * ```typescript\n * import { TimeoutError, RetryExhaustedError, RateLimitError, CircuitBreakerOpenError } from 'awaitly/errors';\n *\n * // Create errors\n * const timeout = new TimeoutError({ operation: 'fetchUser', ms: 5000 });\n * const retryFailed = new RetryExhaustedError({ operation: 'sendEmail', attempts: 3 });\n *\n * // Pattern match\n * TaggedError.match(error, {\n *   TimeoutError: (e) => `${e.operation} timed out after ${e.ms}ms`,\n *   RetryExhaustedError: (e) => `${e.operation} failed after ${e.attempts} attempts`,\n *   RateLimitError: (e) => `Rate limit exceeded, retry after ${e.retryAfterMs}ms`,\n *   CircuitBreakerOpenError: (e) => `Circuit ${e.circuitName} is open`,\n * });\n * ```\n */\n\n/**\n * Spine policy:\n *\n * Awaitly-system errors (raised by awaitly internals on workflow execution\n * failure modes) carry a `slug` + `hint` so they participate in the\n * AI-DX spine: TimeoutError, RetryExhaustedError, RateLimitError,\n * CircuitBreakerOpenError, CompensationError, UnexpectedError.\n *\n * Convenience domain errors (ValidationError, NotFoundError,\n * UnauthorizedError, NetworkError) are deliberately NOT slugged — they\n * represent USER domain failures and would force user code into the\n * awaitly slug namespace. Users can opt in by adding `slug` + `hint`\n * to their own TaggedError subclasses.\n */\n\nimport { TaggedError } from \"./tagged-error\";\n\n// =============================================================================\n// Error Factory\n// =============================================================================\n\n/**\n * Factory function to create tagged error classes with default values.\n *\n * This is a convenience wrapper around TaggedError that allows specifying\n * default property values for error types.\n *\n * @example\n * ```typescript\n * const NetworkError = makeError('NetworkError', {\n *   defaults: { retryable: true },\n *   message: (p) => `Network error: ${p.reason}`,\n * });\n *\n * class MyNetworkError extends NetworkError<{ reason: string; code?: number }> {}\n * ```\n */\nexport function makeError<Tag extends string>(\n  tag: Tag,\n  options?: {\n    message?: (props: Record<string, unknown>) => string;\n    defaults?: Record<string, unknown>;\n  }\n) {\n  const messageGenerator = options?.message ?? (() => tag);\n  const defaults = options?.defaults ?? {};\n\n  const BaseClass = TaggedError(tag, {\n    message: (props: Record<string, unknown>) =>\n      messageGenerator({ ...defaults, ...props }),\n  });\n\n  return class extends BaseClass {\n    constructor(props?: Record<string, unknown>) {\n      super({ ...defaults, ...props } as Record<string, unknown>);\n      Object.assign(this, { ...defaults, ...props });\n    }\n  };\n}\n\n// =============================================================================\n// Pre-built Error Types\n// =============================================================================\n\n/**\n * Error thrown when an operation times out.\n *\n * @example\n * ```typescript\n * const error = new TimeoutError({\n *   operation: 'fetchUser',\n *   ms: 5000,\n * });\n * console.log(error.message); // \"TimeoutError: fetchUser timed out after 5000ms\"\n * ```\n */\nexport class TimeoutError extends TaggedError(\"TimeoutError\", {\n  slug: \"runtime-step-timeout\",\n  hint: \"Increase the step's timeout option, or check why the upstream operation is slow.\",\n  message: (p: {\n    /** Name of the operation that timed out */\n    operation?: string;\n    /** Timeout duration in milliseconds */\n    ms: number;\n  }) =>\n    p.operation\n      ? `TimeoutError: ${p.operation} timed out after ${p.ms}ms`\n      : `TimeoutError: Operation timed out after ${p.ms}ms`,\n}) {}\n\n/**\n * Error thrown when all retry attempts are exhausted.\n *\n * @example\n * ```typescript\n * const error = new RetryExhaustedError({\n *   operation: 'sendEmail',\n *   attempts: 3,\n *   lastError: originalError,\n * });\n * console.log(error.message); // \"RetryExhaustedError: sendEmail failed after 3 attempts\"\n * ```\n */\nexport class RetryExhaustedError extends TaggedError(\"RetryExhaustedError\", {\n  slug: \"runtime-retry-exhausted\",\n  hint: \"All retry attempts failed. Inspect lastError and decide whether to surface it or compensate.\",\n  message: (p: {\n    /** Name of the operation that failed */\n    operation?: string;\n    /** Total number of retry attempts made */\n    attempts: number;\n    /** The last error encountered before giving up */\n    lastError?: unknown;\n  }) =>\n    p.operation\n      ? `RetryExhaustedError: ${p.operation} failed after ${p.attempts} attempts`\n      : `RetryExhaustedError: Operation failed after ${p.attempts} attempts`,\n}) {}\n\n/**\n * Error thrown when a rate limit is exceeded.\n *\n * @example\n * ```typescript\n * const error = new RateLimitError({\n *   limiterName: 'api-calls',\n *   retryAfterMs: 1000,\n * });\n * console.log(error.message); // \"RateLimitError: Rate limit exceeded for api-calls\"\n * ```\n */\nexport class RateLimitError extends TaggedError(\"RateLimitError\", {\n  slug: \"runtime-rate-limit\",\n  hint: \"Wait retryAfterMs before retrying, or apply step.cache to deduplicate calls.\",\n  message: (p: {\n    /** Name of the rate limiter that was exceeded */\n    limiterName?: string;\n    /** Time in milliseconds until the rate limit resets */\n    retryAfterMs?: number;\n  }) =>\n    p.limiterName\n      ? `RateLimitError: Rate limit exceeded for ${p.limiterName}${p.retryAfterMs ? `, retry after ${p.retryAfterMs}ms` : \"\"}`\n      : `RateLimitError: Rate limit exceeded${p.retryAfterMs ? `, retry after ${p.retryAfterMs}ms` : \"\"}`,\n}) {}\n\n/**\n * Error thrown when a circuit breaker is open.\n *\n * @example\n * ```typescript\n * const error = new CircuitBreakerOpenError({\n *   circuitName: 'payment-api',\n *   state: 'OPEN',\n *   retryAfterMs: 30000,\n * });\n * console.log(error.message); // \"CircuitBreakerOpenError: Circuit payment-api is OPEN\"\n * ```\n */\nexport class CircuitBreakerOpenError extends TaggedError(\n  \"CircuitBreakerOpenError\",\n  {\n    slug: \"runtime-circuit-open\",\n    hint: \"The circuit is open. Wait for it to half-open or fall back to a degraded path.\",\n    message: (p: {\n      /** Name of the circuit breaker */\n      circuitName: string;\n      /** Current state of the circuit */\n      state?: \"OPEN\" | \"HALF_OPEN\";\n      /** Time in milliseconds until the circuit may close */\n      retryAfterMs?: number;\n    }) =>\n      `CircuitBreakerOpenError: Circuit ${p.circuitName} is ${p.state ?? \"OPEN\"}${p.retryAfterMs ? `, retry after ${Math.ceil(p.retryAfterMs / 1000)}s` : \"\"}`,\n  }\n) {}\n\n/**\n * Error thrown when validation fails.\n *\n * @example\n * ```typescript\n * const error = new ValidationError({\n *   field: 'email',\n *   reason: 'Invalid email format',\n * });\n * console.log(error.message); // \"ValidationError: Invalid email - Invalid email format\"\n * ```\n */\nexport class ValidationError extends TaggedError(\"ValidationError\", {\n  message: (p: {\n    /** Field that failed validation */\n    field: string;\n    /** Reason for validation failure */\n    reason: string;\n    /** Raw value that failed validation */\n    value?: unknown;\n  }) => `ValidationError: Invalid ${p.field} - ${p.reason}`,\n}) {}\n\n/**\n * Error thrown when a resource is not found.\n *\n * @example\n * ```typescript\n * const error = new NotFoundError({\n *   resource: 'User',\n *   id: '123',\n * });\n * console.log(error.message); // \"NotFoundError: User with id 123 not found\"\n * ```\n */\nexport class NotFoundError extends TaggedError(\"NotFoundError\", {\n  message: (p: {\n    /** Type of resource that was not found */\n    resource: string;\n    /** Identifier of the missing resource */\n    id?: string;\n  }) =>\n    p.id\n      ? `NotFoundError: ${p.resource} with id ${p.id} not found`\n      : `NotFoundError: ${p.resource} not found`,\n}) {}\n\n/**\n * Error thrown when access is denied.\n *\n * @example\n * ```typescript\n * const error = new UnauthorizedError({\n *   action: 'delete',\n *   resource: 'User',\n * });\n * console.log(error.message); // \"UnauthorizedError: Not authorized to delete User\"\n * ```\n */\nexport class UnauthorizedError extends TaggedError(\"UnauthorizedError\", {\n  message: (p: {\n    /** Action that was attempted */\n    action?: string;\n    /** Resource that was being accessed */\n    resource?: string;\n    /** Reason for denial */\n    reason?: string;\n  }) =>\n    p.reason\n      ? `UnauthorizedError: ${p.reason}`\n      : p.action && p.resource\n        ? `UnauthorizedError: Not authorized to ${p.action} ${p.resource}`\n        : \"UnauthorizedError: Access denied\",\n}) {}\n\n/**\n * Error thrown for network-related failures.\n *\n * @example\n * ```typescript\n * const error = new NetworkError({\n *   url: 'https://api.example.com/users',\n *   reason: 'Connection refused',\n *   retryable: true,\n * });\n * ```\n */\nexport class NetworkError extends TaggedError(\"NetworkError\", {\n  message: (p: {\n    /** URL that was being accessed */\n    url?: string;\n    /** Reason for the network failure */\n    reason: string;\n    /** Whether this error is retryable */\n    retryable?: boolean;\n    /** HTTP status code if applicable */\n    statusCode?: number;\n  }) =>\n    p.url\n      ? `NetworkError: ${p.reason} (${p.url})`\n      : `NetworkError: ${p.reason}`,\n}) {}\n\n/**\n * Error thrown when a saga compensation fails.\n *\n * @example\n * ```typescript\n * const error = new CompensationError({\n *   step: 'chargeCard',\n *   originalError: paymentError,\n *   compensationError: refundError,\n * });\n * ```\n */\nexport class CompensationError extends TaggedError(\"CompensationError\", {\n  slug: \"runtime-saga-compensation\",\n  hint: \"A saga compensation step failed. Inspect compensationError and ensure compensation is idempotent.\",\n  message: (p: {\n    /** Step that triggered compensation */\n    step: string;\n    /** The original error that caused compensation */\n    originalError?: unknown;\n    /** Error that occurred during compensation */\n    compensationError?: unknown;\n  }) => `CompensationError: Failed to compensate step ${p.step}`,\n}) {}\n\n// =============================================================================\n// Unexpected Error\n// =============================================================================\n\n/**\n * Default error type for uncaught exceptions and cancellation in workflows.\n * This is the default `U` type when `catchUnexpected` is not provided.\n *\n * @example\n * ```typescript\n * // Automatically used as the default — no need to pass catchUnexpected:\n * const workflow = createWorkflow(\"checkout\", { chargeCard, sendEmail });\n *\n * // Equivalent to:\n * const workflow = createWorkflow(\"checkout\", { chargeCard, sendEmail }, {\n *   catchUnexpected: (cause) => new UnexpectedError({ cause }),\n * });\n * ```\n */\nexport class UnexpectedError extends TaggedError(\"UnexpectedError\", {\n  slug: \"runtime-unexpected\",\n  hint: \"An unexpected exception escaped a step. Inspect cause; consider returning a typed Result instead of throwing.\",\n  message: (p: {\n    /** The original thrown value or cancellation error */\n    cause?: unknown;\n  }) => `UnexpectedError: ${p.cause instanceof Error ? p.cause.message : String(p.cause ?? \"unknown\")}`,\n}) {}\n\n// =============================================================================\n// Union Type for Common Errors\n// =============================================================================\n\n/**\n * Union of all pre-built error types.\n * Useful for exhaustive pattern matching.\n *\n * @example\n * ```typescript\n * function handleError(error: AwaitlyError): string {\n *   return TaggedError.match(error, {\n *     TimeoutError: (e) => `Timeout: ${e.ms}ms`,\n *     RetryExhaustedError: (e) => `Retries: ${e.attempts}`,\n *     RateLimitError: (e) => `Rate limited`,\n *     CircuitBreakerOpenError: (e) => `Circuit open: ${e.circuitName}`,\n *     ValidationError: (e) => `Invalid: ${e.field}`,\n *     NotFoundError: (e) => `Not found: ${e.resource}`,\n *     UnauthorizedError: (e) => `Unauthorized`,\n *     NetworkError: (e) => `Network: ${e.reason}`,\n *     CompensationError: (e) => `Compensation failed: ${e.step}`,\n *     UnexpectedError: (e) => e.message,\n *   });\n * }\n * ```\n */\nexport type AwaitlyError =\n  | TimeoutError\n  | RetryExhaustedError\n  | RateLimitError\n  | CircuitBreakerOpenError\n  | ValidationError\n  | NotFoundError\n  | UnauthorizedError\n  | NetworkError\n  | CompensationError\n  | UnexpectedError;\n\n/**\n * The six awaitly-system errors that carry slug + hint + docsUrl spine fields.\n *\n * Distinguishes spine-bearing errors from user-domain convenience errors\n * (ValidationError, NotFoundError, UnauthorizedError, NetworkError) so that\n * downstream tooling (lint, analyzer, docs generator) can target the spine\n * roster without duplicating the class list.\n */\nexport type AwaitlySystemError =\n  | TimeoutError\n  | RetryExhaustedError\n  | RateLimitError\n  | CircuitBreakerOpenError\n  | CompensationError\n  | UnexpectedError;\n\n/**\n * Roster of awaitly-system error classes that participate in the slug spine.\n *\n * Adding a new system error means adding it to `AwaitlySystemError`, this\n * roster, and `slugs.ts`. The integrity test in `spine-integrity.test.ts`\n * iterates this roster, so a missing entry there is caught at CI time.\n *\n * @internal Tooling integration point (docs generator, integrity tests). Not\n *   a stable user-facing API — application code should not depend on this\n *   array's identity or order.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const AWAITLY_SYSTEM_ERROR_CLASSES: ReadonlyArray<new (...args: any[]) => AwaitlySystemError> = [\n  TimeoutError,\n  RetryExhaustedError,\n  RateLimitError,\n  CircuitBreakerOpenError,\n  CompensationError,\n  UnexpectedError,\n];\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Check if an error is a TimeoutError.\n */\nexport function isTimeoutError(error: unknown): error is TimeoutError {\n  return TaggedError.isTaggedError(error) && error._tag === \"TimeoutError\";\n}\n\n/**\n * Check if an error is a RetryExhaustedError.\n */\nexport function isRetryExhaustedError(\n  error: unknown\n): error is RetryExhaustedError {\n  return (\n    TaggedError.isTaggedError(error) && error._tag === \"RetryExhaustedError\"\n  );\n}\n\n/**\n * Check if an error is a RateLimitError.\n */\nexport function isRateLimitError(error: unknown): error is RateLimitError {\n  return TaggedError.isTaggedError(error) && error._tag === \"RateLimitError\";\n}\n\n/**\n * Check if an error is a CircuitBreakerOpenError.\n */\nexport function isCircuitBreakerOpenError(\n  error: unknown\n): error is CircuitBreakerOpenError {\n  return (\n    TaggedError.isTaggedError(error) && error._tag === \"CircuitBreakerOpenError\"\n  );\n}\n\n/**\n * Check if an error is a ValidationError.\n */\nexport function isValidationError(error: unknown): error is ValidationError {\n  return TaggedError.isTaggedError(error) && error._tag === \"ValidationError\";\n}\n\n/**\n * Check if an error is a NotFoundError.\n */\nexport function isNotFoundError(error: unknown): error is NotFoundError {\n  return TaggedError.isTaggedError(error) && error._tag === \"NotFoundError\";\n}\n\n/**\n * Check if an error is an UnauthorizedError.\n */\nexport function isUnauthorizedError(\n  error: unknown\n): error is UnauthorizedError {\n  return TaggedError.isTaggedError(error) && error._tag === \"UnauthorizedError\";\n}\n\n/**\n * Check if an error is a NetworkError.\n */\nexport function isNetworkError(error: unknown): error is NetworkError {\n  return TaggedError.isTaggedError(error) && error._tag === \"NetworkError\";\n}\n\n/**\n * Check if an error is a CompensationError.\n */\nexport function isCompensationError(\n  error: unknown\n): error is CompensationError {\n  return TaggedError.isTaggedError(error) && error._tag === \"CompensationError\";\n}\n\n/**\n * Check if an error is any AwaitlyError.\n */\nexport function isAwaitlyError(error: unknown): error is AwaitlyError {\n  if (!TaggedError.isTaggedError(error)) return false;\n  const tag = error._tag;\n  return [\n    \"TimeoutError\",\n    \"RetryExhaustedError\",\n    \"RateLimitError\",\n    \"CircuitBreakerOpenError\",\n    \"ValidationError\",\n    \"NotFoundError\",\n    \"UnauthorizedError\",\n    \"NetworkError\",\n    \"CompensationError\",\n    \"UnexpectedError\",\n  ].includes(tag);\n}\n","/**\n * awaitly/result (internal)\n *\n * Core Result primitives - minimal bundle for typed error handling.\n * This file is intentionally kept small for optimal tree-shaking.\n * The full orchestration (run, step, etc.) lives in core.ts.\n */\n\n// =============================================================================\n// Core Result Types\n// =============================================================================\n\n/**\n * Represents a successful result.\n * Use `ok(value)` to create instances.\n */\nexport type Ok<T> = {\n  ok: true;\n  value: T;\n};\n\n/**\n * Represents a failed result.\n * Use `err(error)` to create instances.\n */\nexport type Err<E, C = unknown> = {\n  ok: false;\n  error: E;\n  cause?: C;\n};\n\n/**\n * Represents a successful computation or a failed one.\n */\nexport type Result<T, E = unknown, C = unknown> = Ok<T> | Err<E, C>;\n\n/**\n * A Promise that resolves to a Result.\n */\nexport type AsyncResult<T, E = unknown, C = unknown> = Promise<Result<T, E, C>>;\n\n/** Discriminant for PromiseRejectedError type - use in switch statements */\nexport const PROMISE_REJECTED = \"PROMISE_REJECTED\" as const;\n\n// =============================================================================\n// Named Error Constants (for static analysis)\n// =============================================================================\n\n/**\n * Named error constant for unexpected/unhandled errors.\n * Used by the analyzer when a step doesn't declare errors.\n */\nexport const AWAITLY_UNEXPECTED = \"AWAITLY_UNEXPECTED\" as const;\n\n/**\n * Named error constant for cancelled operations.\n */\nexport const AWAITLY_CANCELLED = \"AWAITLY_CANCELLED\" as const;\n\n/**\n * Named error constant for timed-out operations.\n */\nexport const AWAITLY_TIMEOUT = \"AWAITLY_TIMEOUT\" as const;\n\n// =============================================================================\n// Static Analysis Helpers\n// =============================================================================\n\n/**\n * Helper to create a tuple of string literal tags with preserved literal types.\n * Use this when you need to store error tags in a variable while keeping\n * TypeScript's literal type inference (avoiding widening to string[]).\n *\n * @param t - The string literal tags\n * @returns The same array with preserved literal types\n *\n * @example\n * ```typescript\n * // Without tags() - type widens to string[]\n * const errs = ['CART_NOT_FOUND', 'CART_EMPTY'];  // string[]\n *\n * // With tags() - literal types preserved\n * const errs = tags('CART_NOT_FOUND', 'CART_EMPTY');  // readonly ['CART_NOT_FOUND', 'CART_EMPTY']\n *\n * await step('getCart', () => getCart(id), {\n *   errors: errs,  // Analyzer can extract literal types\n *   out: 'cart',\n * });\n * ```\n */\nexport const tags = <const T extends readonly string[]>(...t: T): T => t;\n\nimport { UnexpectedError } from \"../errors\";\nexport { UnexpectedError };\nexport type PromiseRejectedError = { type: typeof PROMISE_REJECTED; cause: unknown };\n/** Cause type for promise rejections in async batch helpers */\nexport type PromiseRejectionCause = { type: \"PROMISE_REJECTION\"; reason: unknown };\nexport type EmptyInputError = { type: \"EMPTY_INPUT\"; message: string };\nexport type MaybeAsyncResult<T, E, C = unknown> = Result<T, E, C> | Promise<Result<T, E, C>>;\n\n// =============================================================================\n// Result Constructors\n// =============================================================================\n\n/**\n * Creates a successful Result.\n *\n * @remarks When to use: Wrap a successful value in a Result for consistent return types.\n */\nexport function ok(): Ok<void>;\nexport function ok<T>(value: T): Ok<T>;\nexport function ok<T>(value?: T): Ok<T | void> {\n  return { ok: true as const, value: value as T | void };\n}\n\n/**\n * Creates a failed Result.\n *\n * @remarks When to use: Return a typed failure without throwing so callers can handle it explicitly.\n */\nexport function err<E, C = unknown>(error: E, options?: { cause?: C }): Err<E, C> {\n  const cause = options?.cause;\n  return { ok: false as const, error, ...(cause !== undefined ? { cause } : {}) } as Err<E, C>;\n}\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Checks if a Result is successful.\n *\n * @remarks When to use: Prefer functional-style checks or array filtering over `result.ok`.\n */\nexport const isOk = <T, E, C>(r: Result<T, E, C>): r is Ok<T> => r.ok;\n\n/**\n * Checks if a Result is a failure.\n *\n * @remarks When to use: Prefer functional-style checks or array filtering over `result.ok`.\n */\nexport const isErr = <T, E, C>(r: Result<T, E, C>): r is Err<E, C> => !r.ok;\n\n/**\n * Checks if an error is an UnexpectedError.\n *\n * @remarks When to use: Distinguish unexpected failures from your typed error union.\n */\nexport const isUnexpectedError = (e: unknown): e is UnexpectedError =>\n  e instanceof UnexpectedError ||\n  (typeof e === \"object\" &&\n    e !== null &&\n    \"_tag\" in e &&\n    (e as { _tag: string })._tag === \"UnexpectedError\");\n\n/**\n * Checks if an error is a PromiseRejectedError.\n */\nexport const isPromiseRejectedError = (e: unknown): e is PromiseRejectedError =>\n  typeof e === \"object\" &&\n  e !== null &&\n  \"type\" in e &&\n  e.type === PROMISE_REJECTED;\n\n// =============================================================================\n// Error Matching\n// =============================================================================\n\nexport type MatchErrorHandlers<E extends string, R> = {\n  [K in Exclude<E, \"UnexpectedError\">]: (error: K) => R;\n} & {\n  UnexpectedError: (error: UnexpectedError) => R;\n};\n\n/**\n * Match on string error types with exhaustive checking.\n * Takes an error value (not a Result) and handlers for each error type.\n */\nexport function matchError<E extends string, R>(\n  handlers: MatchErrorHandlers<E, R>\n): (error: E | UnexpectedError) => R;\nexport function matchError<E extends string, R>(\n  error: E | UnexpectedError,\n  handlers: MatchErrorHandlers<E, R>\n): R;\nexport function matchError<E extends string, R>(\n  errorOrHandlers: E | UnexpectedError | MatchErrorHandlers<E, R>,\n  handlers?: MatchErrorHandlers<E, R>\n): R | ((error: E | UnexpectedError) => R) {\n  if (handlers === undefined) {\n    const h = errorOrHandlers as MatchErrorHandlers<E, R>;\n    return (e: E | UnexpectedError) => matchError(e, h);\n  }\n  const error = errorOrHandlers as E | UnexpectedError;\n  // Handle UnexpectedError instances\n  if (isUnexpectedError(error)) {\n    return handlers.UnexpectedError(error as UnexpectedError);\n  }\n  // Handle string literal errors\n  type StringErrors = Exclude<E, \"UnexpectedError\">;\n  return (handlers as unknown as Record<string, (e: string) => R>)[error as StringErrors](error as StringErrors);\n}\n\n// =============================================================================\n// Type Utilities\n// =============================================================================\n\ntype AnyFunction = (...args: never[]) => unknown;\n\n/**\n * Helper to extract the error type from Result or AsyncResult return values.\n * Works even when a function is declared to return a union of both forms.\n * Plain (non-Result) return types contribute `never` — without the [never]\n * guard they would infer `unknown` and poison error unions built from\n * mixed deps.\n */\ntype ErrorOfReturn<R> = [Extract<Awaited<R>, { ok: false }>] extends [never]\n  ? never\n  : Extract<Awaited<R>, { ok: false }> extends { error: infer E }\n    ? E\n    : never;\n\n/**\n * Extract error type from a single function's return type\n */\nexport type ErrorOf<T extends AnyFunction> = ErrorOfReturn<ReturnType<T>>;\n\n/**\n * Extract union of error types from multiple functions (tuple form)\n */\nexport type Errors<T extends AnyFunction[]> = {\n  [K in keyof T]: ErrorOf<T[K]>;\n}[number];\n\n/**\n * Extract union of error types from a deps object.\n *\n * @example\n * ```typescript\n * const deps = { getUser, createOrder, sendEmail };\n * type E = ErrorsOf<typeof deps>;\n * // = \"NOT_FOUND\" | \"ORDER_FAILED\" | \"EMAIL_ERROR\"\n * ```\n */\nexport type ErrorsOf<Deps extends Record<string, AnyFunction>> = {\n  [K in keyof Deps]: ErrorOf<Deps[K]>;\n}[keyof Deps];\n\n/**\n * Extract value type from Result\n */\nexport type ExtractValue<T> = T extends { ok: true; value: infer U }\n  ? U\n  : never;\n\n/**\n * Extract error type from Result\n */\nexport type ExtractError<T> = T extends { ok: false; error: infer E }\n  ? E\n  : never;\n\n/**\n * Extract cause type from Result\n */\nexport type ExtractCause<T> = T extends { ok: false; cause?: infer C }\n  ? C\n  : never;\n\n/**\n * Helper to extract the cause type from Result or AsyncResult return values.\n * Works even when a function is declared to return a union of both forms.\n */\ntype CauseOfReturn<R> = Extract<Awaited<R>, { ok: false }> extends { cause?: infer C }\n  ? C\n  : never;\n\n/**\n * Extract cause type from a function's return type\n */\nexport type CauseOf<T extends AnyFunction> = CauseOfReturn<ReturnType<T>>;\n\n// =============================================================================\n// Unwrap Utilities\n// =============================================================================\n\n/**\n * Error thrown when attempting to unwrap an Err result.\n */\nexport class UnwrapError extends Error {\n  public readonly error: unknown;\n  public readonly cause?: unknown;\n\n  constructor(result: Err<unknown, unknown>) {\n    const errorStr =\n      typeof result.error === \"string\"\n        ? result.error\n        : JSON.stringify(result.error);\n    super(`Attempted to unwrap an Err: ${errorStr}`);\n    this.name = \"UnwrapError\";\n    this.error = result.error;\n    this.cause = result.cause;\n  }\n}\n\n/**\n * Extracts the value from an Ok result, or throws UnwrapError if it's an Err.\n *\n * @remarks When to use: Only at boundaries or tests where a failure should be fatal.\n */\nexport const unwrap = <T, E, C>(r: Result<T, E, C>): T => {\n  if (r.ok) return r.value;\n  throw new UnwrapError(r);\n};\n\n/**\n * Extracts the value from an Ok result, or returns a default value if it's an Err.\n *\n * @remarks When to use: Provide a safe fallback without branching.\n */\nexport const unwrapOr = <T, E, C>(r: Result<T, E, C>, defaultValue: T): T =>\n  r.ok ? r.value : defaultValue;\n\n/**\n * Extracts the value from an Ok result, or calls a function to get a default value if it's an Err.\n *\n * @remarks When to use: Compute a fallback from the error (logging, metrics, or derived defaults).\n */\nexport const unwrapOrElse = <T, E, C>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => T\n): T => (r.ok ? r.value : fn(r.error, r.cause));\n\n/**\n * Alias for `unwrap`. Returns the success value or throws.\n *\n * The Result is already computed; use when you want the value or throw (e.g. at boundaries or in tests).\n *\n * @param r - The Result to unwrap\n * @returns The success value if the Result is successful\n * @throws {UnwrapError} If the Result is an error (includes the error and cause)\n */\nexport const runOrThrow = <T, E, C>(r: Result<T, E, C>): T => unwrap(r);\n\n/**\n * Awaits a Promise of a Result, then returns the success value or rejects.\n *\n * The returned promise **resolves with T** on success and **rejects with UnwrapError** on failure.\n * UnwrapError extends Error and carries the original `error` and `cause` from the Err.\n *\n * @param ar - A Promise or thenable that resolves to a Result\n * @returns A Promise that resolves with the success value or rejects with UnwrapError\n */\nexport const runOrThrowAsync = <T, E, C>(\n  ar: PromiseLike<Result<T, E, C>>\n): Promise<T> => Promise.resolve(ar).then(unwrap);\n\n/**\n * Convenience alias for `unwrapOr(r, null)`. Returns the success value or null.\n *\n * @param r - The Result to unwrap\n * @returns The success value if successful, otherwise null\n */\nexport const runOrNull = <T, E, C>(r: Result<T, E, C>): T | null =>\n  r.ok ? r.value : null;\n\n/**\n * Convenience alias for `unwrapOr(r, undefined)`. Returns the success value or undefined.\n *\n * @param r - The Result to unwrap\n * @returns The success value if successful, otherwise undefined\n */\nexport const runOrUndefined = <T, E, C>(r: Result<T, E, C>): T | undefined =>\n  r.ok ? r.value : undefined;\n\n// =============================================================================\n// Wrapping Functions\n// =============================================================================\n\n/**\n * Wraps a synchronous function that might throw into a Result.\n *\n * @remarks When to use: Wrap sync code that might throw so exceptions become Err values.\n */\nexport function from<T>(fn: () => T): Ok<T> | Err<unknown, unknown>;\nexport function from<T, E>(fn: () => T, onError: (cause: unknown) => E): Ok<T> | Err<E, unknown>;\nexport function from<T, E>(fn: () => T, onError?: (cause: unknown) => E) {\n  try {\n    return ok(fn());\n  } catch (cause) {\n    return onError ? err(onError(cause), { cause }) : err(cause);\n  }\n}\n\n/**\n * Wraps a Promise into a Result.\n *\n * @remarks When to use: Wrap a Promise and keep the raw rejection as Err; use tryAsync to map errors.\n */\nexport function fromPromise<T>(promise: Promise<T>): Promise<Ok<T> | Err<unknown, unknown>>;\nexport function fromPromise<T, E>(\n  promise: Promise<T>,\n  onError: (cause: unknown) => E\n): Promise<Ok<T> | Err<E, unknown>>;\nexport async function fromPromise<T, E>(\n  promise: Promise<T>,\n  onError?: (cause: unknown) => E\n): Promise<Ok<T> | Err<E | unknown, unknown>> {\n  try {\n    return ok(await promise);\n  } catch (cause) {\n    return onError ? err(onError(cause), { cause }) : err(cause);\n  }\n}\n\n/**\n * Wraps an async function that might throw into an AsyncResult.\n *\n * @remarks When to use: Wrap async work and map thrown/rejected values into your typed error union.\n */\nexport function tryAsync<T>(fn: () => Promise<T>): AsyncResult<T, unknown>;\nexport function tryAsync<T, E>(\n  fn: () => Promise<T>,\n  onError: (cause: unknown) => E\n): AsyncResult<T, E>;\nexport async function tryAsync<T, E>(\n  fn: () => Promise<T>,\n  onError?: (cause: unknown) => E\n): AsyncResult<T, E | unknown> {\n  try {\n    return ok(await fn());\n  } catch (cause) {\n    return onError ? err(onError(cause), { cause }) : err(cause);\n  }\n}\n\n/**\n * Converts a nullable value into a Result.\n *\n * @remarks When to use: Turn null/undefined into a typed error before continuing.\n */\nexport function fromNullable<T, E>(\n  value: T | null | undefined,\n  onNull: () => E\n): Result<T, E> {\n  return value != null ? ok(value) : err(onNull());\n}\n\n// =============================================================================\n// Transformers\n// =============================================================================\n\n/**\n * Transforms the value inside an Ok result.\n *\n * @remarks When to use: Transform only the Ok value while leaving Err untouched.\n */\nexport function map<T, U>(r: Ok<T>, fn: (value: T) => U): Ok<U>;\nexport function map<T, U, E, C>(r: Err<E, C>, fn: (value: T) => U): Err<E, C>;\nexport function map<T, U, E, C>(r: Result<T, E, C>, fn: (value: T) => U): Result<U, E, C>;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function map(r: any, fn: any): any {\n  return r.ok ? ok(fn(r.value)) : r;\n}\n\n/**\n * Transforms the error inside an Err result.\n *\n * @remarks When to use: Retype or normalize errors while leaving Ok values unchanged.\n */\nexport function mapError<T, E, F, C>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => F\n): Result<T, F, C> {\n  return r.ok ? r : err(fn(r.error, r.cause), { cause: r.cause });\n}\n\n/**\n * Pattern match on a Result.\n *\n * @remarks When to use: Handle both Ok and Err in a single expression that returns a value.\n */\nexport function match<T, E, C, R>(handlers: { ok: (value: T) => R; err: (error: E, cause?: C) => R }): (r: Result<T, E, C>) => R;\nexport function match<T, E, C, R>(r: Ok<T>, handlers: { ok: (value: T) => R; err: (error: E, cause?: C) => R }): R;\nexport function match<T, E, C, R>(r: Err<E, C>, handlers: { ok: (value: T) => R; err: (error: E, cause?: C) => R }): R;\nexport function match<T, E, C, R>(r: Result<T, E, C>, handlers: { ok: (value: T) => R; err: (error: E, cause?: C) => R }): R;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function match(r: any, handlers?: any): any {\n  if (handlers === undefined) {\n    const h = r;\n    return (result: Result<unknown, unknown, unknown>) => match(result, h);\n  }\n  return r.ok ? handlers.ok(r.value) : handlers.err(r.error, r.cause);\n}\n\n/**\n * Chain Result-returning functions.\n *\n * @remarks When to use: Chain dependent operations that return Result without nested branching.\n */\nexport function andThen<T, U>(r: Ok<T>, fn: (value: T) => Ok<U>): Ok<U>;\nexport function andThen<T, F, C2>(r: Ok<T>, fn: (value: T) => Err<F, C2>): Err<F, C2>;\nexport function andThen<T, U, F, C2>(r: Ok<T>, fn: (value: T) => Result<U, F, C2>): Result<U, F, C2>;\nexport function andThen<T, U, E, F, C1, C2>(r: Err<E, C1>, fn: (value: T) => Result<U, F, C2>): Err<E, C1>;\nexport function andThen<T, U, E, F, C1, C2>(r: Result<T, E, C1>, fn: (value: T) => Result<U, F, C2>): Result<U, E | F, C1 | C2>;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function andThen(r: any, fn: any): any {\n  return r.ok ? fn(r.value) : r;\n}\n\n/**\n * Execute a side effect on Ok values.\n *\n * @remarks When to use: Add side effects (logging, metrics) on Ok without changing the Result.\n */\nexport function tap<T, E, C>(\n  r: Result<T, E, C>,\n  fn: (value: T) => void\n): Result<T, E, C> {\n  if (r.ok) fn(r.value);\n  return r;\n}\n\n/**\n * Execute a side effect on Err values.\n *\n * @remarks When to use: Add side effects (logging, metrics) on Err without changing the Result.\n */\nexport function tapError<T, E, C>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => void\n): Result<T, E, C> {\n  if (!r.ok) fn(r.error, r.cause);\n  return r;\n}\n\n/**\n * Transform value with a function that might throw.\n *\n * @remarks When to use: Transform Ok values with a function that might throw and capture the failure.\n */\nexport function mapTry<T, U, E, F, C>(\n  r: Result<T, E, C>,\n  fn: (value: T) => U,\n  onError: (thrown: unknown) => F\n): Result<U, E | F, C | unknown> {\n  if (!r.ok) return r;\n  try {\n    return ok(fn(r.value));\n  } catch (error) {\n    return err(onError(error), { cause: error });\n  }\n}\n\n/**\n * Transform error with a function that might throw.\n *\n * @remarks When to use: Transform errors when the mapping might throw and you want that captured.\n */\nexport function mapErrorTry<T, E, F, G, C>(\n  r: Result<T, E, C>,\n  fn: (error: E) => F,\n  onError: (thrown: unknown) => G\n): Result<T, F | G, C | unknown> {\n  if (r.ok) return r;\n  try {\n    return err(fn(r.error), { cause: r.cause });\n  } catch (error) {\n    return err(onError(error), { cause: error });\n  }\n}\n\n/**\n * Transform both value and error.\n */\nexport function bimap<T, U, E, F, C>(\n  r: Result<T, E, C>,\n  onOk: (value: T) => U,\n  onErr: (error: E, cause?: C) => F\n): Result<U, F, C> {\n  return r.ok ? ok(onOk(r.value)) : err(onErr(r.error, r.cause), { cause: r.cause });\n}\n\n/**\n * Provide an alternative Result if the first is an Err.\n *\n * @remarks When to use: Recover from Err by returning a fallback Result or retyping the error.\n */\nexport function orElse<T, E, E2, C, C2>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => Result<T, E2, C2>\n): Result<T, E2, C | C2> {\n  return r.ok ? r : fn(r.error, r.cause);\n}\n\n/**\n * Async version of orElse.\n */\nexport async function orElseAsync<T, E, E2, C, C2>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => Promise<Result<T, E2, C2>>\n): Promise<Result<T, E2, C | C2>> {\n  return r.ok ? r : fn(r.error, r.cause);\n}\n\n/**\n * Recover from errors - always returns Ok<T>.\n */\nexport function recover<T, E, C>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => T\n): Ok<T> {\n  return r.ok ? ok(r.value) : ok(fn(r.error, r.cause));\n}\n\n/**\n * Async version of recover - always returns Promise<Ok<T>>.\n */\nexport async function recoverAsync<T, E, C>(\n  r: Result<T, E, C> | Promise<Result<T, E, C>>,\n  fn: (error: E, cause?: C) => T | Promise<T>\n): Promise<Ok<T>> {\n  const resolved = await r;\n  if (resolved.ok) return ok(resolved.value);\n  return ok(await fn(resolved.error, resolved.cause));\n}\n\n// =============================================================================\n// Result Hydration (Serialization)\n// =============================================================================\n\n/**\n * Hydrate a serialized Result back into a proper Result object.\n */\nexport function hydrate<T, E, C = unknown>(value: unknown): Result<T, E, C> | null {\n  if (typeof value !== \"object\" || value === null) return null;\n  if (!(\"ok\" in value)) return null;\n\n  const obj = value as Record<string, unknown>;\n  if (obj.ok === true && \"value\" in obj) {\n    return ok(obj.value as T);\n  }\n  if (obj.ok === false && \"error\" in obj) {\n    return err(obj.error as E, { cause: obj.cause as C });\n  }\n  return null;\n}\n\n/**\n * Type guard to check if a value is a serialized Result.\n */\nexport function isSerializedResult(\n  value: unknown\n): value is { ok: boolean; value?: unknown; error?: unknown; cause?: unknown } {\n  if (typeof value !== \"object\" || value === null) return false;\n  if (!(\"ok\" in value)) return false;\n  const obj = value as Record<string, unknown>;\n  return (\n    (obj.ok === true && \"value\" in obj) ||\n    (obj.ok === false && \"error\" in obj)\n  );\n}\n\n// =============================================================================\n// Batch Operations\n// =============================================================================\n\ntype AllValues<T extends readonly Result<unknown, unknown, unknown>[]> = {\n  [K in keyof T]: T[K] extends Ok<infer V>\n    ? V\n    : T[K] extends Err<unknown, unknown>\n      ? never\n      : T[K] extends Result<infer V, unknown, unknown>\n        ? V\n        : never;\n};\ntype AllErrors<T extends readonly Result<unknown, unknown, unknown>[]> = {\n  [K in keyof T]: T[K] extends Ok<unknown>\n    ? never\n    : T[K] extends Err<infer E, unknown>\n      ? E\n      : T[K] extends Result<unknown, infer E, unknown>\n        ? E\n        : never;\n}[number];\ntype AllCauses<T extends readonly Result<unknown, unknown, unknown>[]> = {\n  [K in keyof T]: T[K] extends Ok<unknown>\n    ? never\n    : T[K] extends Err<unknown, infer C>\n      ? C\n      : T[K] extends Result<unknown, unknown, infer C>\n        ? C\n        : never;\n}[number];\n\n// Conditional type: returns Ok<...> when there are no errors, Result<...> otherwise\n// Note: We only check AllErrors, not AllCauses - causes only matter when there are errors\ntype AllResult<T extends readonly Result<unknown, unknown, unknown>[]> =\n  [AllErrors<T>] extends [never]\n    ? Ok<AllValues<T>>\n    : Result<AllValues<T>, AllErrors<T>, AllCauses<T>>;\n\n/**\n * Combines multiple Results into a single Result containing an array of values.\n * Returns the first Err encountered, or Ok with all values.\n */\nexport function all<const T extends readonly Result<unknown, unknown, unknown>[]>(\n  results: T\n): AllResult<T> {\n  const values: unknown[] = [];\n  for (const result of results) {\n    if (!result.ok) {\n      return result as unknown as AllResult<T>;\n    }\n    values.push(result.value);\n  }\n  return ok(values) as AllResult<T>;\n}\n\n/**\n * Async version of all - works with Promises of Results.\n */\nexport async function allAsync<\n  const T extends readonly (Result<unknown, unknown, unknown> | Promise<Result<unknown, unknown, unknown>>)[]\n>(\n  results: T\n): Promise<\n  Result<\n    { [K in keyof T]: T[K] extends Result<infer V, unknown, unknown> | Promise<Result<infer V, unknown, unknown>> ? V : never },\n    | { [K in keyof T]: T[K] extends Result<unknown, infer E, unknown> | Promise<Result<unknown, infer E, unknown>> ? E : never }[number]\n    | PromiseRejectedError,\n    | { [K in keyof T]: T[K] extends Result<unknown, unknown, infer C> | Promise<Result<unknown, unknown, infer C>> ? C : never }[number]\n    | PromiseRejectionCause\n  >\n> {\n  const values: unknown[] = [];\n  for (const resultOrPromise of results) {\n    try {\n      const r = await resultOrPromise;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      if (!r.ok) return r as any;\n      values.push(r.value);\n    } catch (reason) {\n      return err(\n        { type: PROMISE_REJECTED, cause: reason } as PromiseRejectedError,\n        { cause: { type: \"PROMISE_REJECTION\", reason } as PromiseRejectionCause }\n      );\n    }\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return ok(values) as any;\n}\n\nexport type SettledError<E, C = unknown> = { error: E; cause?: C };\n\n// Conditional type: returns Ok<...> when there are no errors, Result<...> otherwise\ntype AllSettledResult<T extends readonly Result<unknown, unknown, unknown>[]> =\n  [AllErrors<T>] extends [never]\n    ? Ok<AllValues<T>>\n    : Result<AllValues<T>, SettledError<AllErrors<T>, AllCauses<T>>[]>;\n\n/**\n * Collects all Results, returning Ok with values if all succeed,\n * or Err with array of errors if any fail.\n */\nexport function allSettled<const T extends readonly Result<unknown, unknown, unknown>[]>(\n  results: T\n): AllSettledResult<T> {\n  const values: unknown[] = [];\n  const errors: SettledError<unknown>[] = [];\n\n  for (const result of results) {\n    if (result.ok) {\n      values.push(result.value);\n    } else {\n      errors.push({ error: result.error, cause: result.cause });\n    }\n  }\n\n  if (errors.length > 0) {\n    return err(errors) as unknown as AllSettledResult<T>;\n  }\n\n  return ok(values) as unknown as AllSettledResult<T>;\n}\n\n/**\n * Async version of allSettled.\n */\nexport async function allSettledAsync<\n  const T extends readonly (Result<unknown, unknown, unknown> | Promise<Result<unknown, unknown, unknown>>)[]\n>(\n  results: T\n): Promise<\n  Result<\n    { [K in keyof T]: T[K] extends Result<infer V, unknown, unknown> | Promise<Result<infer V, unknown, unknown>> ? V : never },\n    SettledError<\n      | { [K in keyof T]: T[K] extends Result<unknown, infer E, unknown> | Promise<Result<unknown, infer E, unknown>> ? E : never }[number]\n      | PromiseRejectedError,\n      | { [K in keyof T]: T[K] extends Result<unknown, unknown, infer C> | Promise<Result<unknown, unknown, infer C>> ? C : never }[number]\n      | PromiseRejectionCause\n    >[]\n  >\n> {\n  const settled = await Promise.all(\n    results.map((item) =>\n      Promise.resolve(item)\n        .then((result) => ({ status: \"result\" as const, result }))\n        .catch((reason) => ({\n          status: \"rejected\" as const,\n          error: { type: PROMISE_REJECTED, cause: reason } as PromiseRejectedError,\n          cause: { type: \"PROMISE_REJECTION\", reason } as PromiseRejectionCause,\n        }))\n    )\n  );\n\n  const values: unknown[] = [];\n  const errors: SettledError<unknown, unknown>[] = [];\n\n  for (const item of settled) {\n    if (item.status === \"rejected\") {\n      errors.push({ error: item.error, cause: item.cause });\n    } else if (item.result.ok) {\n      values.push(item.result.value);\n    } else {\n      errors.push({ error: item.result.error, cause: item.result.cause });\n    }\n  }\n\n  if (errors.length > 0) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return err(errors) as any;\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return ok(values) as any;\n}\n\n/**\n * Partitions Results into { values, errors }.\n */\nexport function partition<T, E, C>(\n  results: readonly Result<T, E, C>[]\n): { values: T[]; errors: E[] } {\n  const values: T[] = [];\n  const errors: E[] = [];\n  for (const r of results) {\n    if (r.ok) values.push(r.value);\n    else errors.push(r.error);\n  }\n  return { values, errors };\n}\n\n/**\n * Returns the first Ok result, or an EmptyInputError/first Err if all fail.\n */\nexport function any<const T extends readonly Result<unknown, unknown, unknown>[]>(\n  results: T\n): T extends readonly []\n  ? Err<EmptyInputError, unknown>\n  : Result<\n      { [K in keyof T]: T[K] extends Result<infer V, unknown, unknown> ? V : never }[number],\n      AllErrors<T> | EmptyInputError,\n      AllCauses<T>\n    >;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function any(results: any): any {\n  if (results.length === 0) {\n    return err({ type: \"EMPTY_INPUT\", message: \"any() requires at least one Result\" });\n  }\n  let firstErr: Err<unknown, unknown> | undefined;\n  for (const r of results) {\n    if (r.ok) return r;\n    if (!firstErr) firstErr = r;\n  }\n  return firstErr;\n}\n\n/**\n * Async version of any - races promises and returns first success.\n */\nexport async function anyAsync<\n  const T extends readonly (Result<unknown, unknown, unknown> | Promise<Result<unknown, unknown, unknown>>)[]\n>(\n  results: T\n): Promise<\n  T extends readonly []\n    ? Err<EmptyInputError, unknown>\n    : Result<\n        { [K in keyof T]: T[K] extends Result<infer V, unknown, unknown> | Promise<Result<infer V, unknown, unknown>> ? V : never }[number],\n        | { [K in keyof T]: T[K] extends Result<unknown, infer E, unknown> | Promise<Result<unknown, infer E, unknown>> ? E : never }[number]\n        | EmptyInputError\n        | PromiseRejectedError,\n        | { [K in keyof T]: T[K] extends Result<unknown, unknown, infer C> | Promise<Result<unknown, unknown, infer C>> ? C : never }[number]\n        | PromiseRejectionCause\n      >\n> {\n  if (results.length === 0) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return err({ type: \"EMPTY_INPUT\", message: \"anyAsync() requires at least one Result\" }) as any;\n  }\n\n  return new Promise((resolve) => {\n    let settled = false;\n    let pendingCount = results.length;\n    let firstError: Err<unknown, unknown> | null = null;\n\n    for (const item of results) {\n      Promise.resolve(item)\n        .catch((reason) =>\n          err(\n            { type: PROMISE_REJECTED, cause: reason } as PromiseRejectedError,\n            { cause: { type: \"PROMISE_REJECTION\", reason } as PromiseRejectionCause }\n          )\n        )\n        .then((result) => {\n          if (settled) return;\n\n          if (result.ok) {\n            settled = true;\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            resolve(result as any);\n            return;\n          }\n\n          if (!firstError) firstError = result;\n          pendingCount--;\n\n          if (pendingCount === 0) {\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            resolve(firstError as any);\n          }\n        });\n    }\n  });\n}\n\n/**\n * Combines exactly two Results into a tuple.\n */\nexport function zip<A, EA, CA, B, EB, CB>(\n  a: Result<A, EA, CA>,\n  b: Result<B, EB, CB>\n): Result<[A, B], EA | EB, CA | CB> {\n  if (!a.ok) return a;\n  if (!b.ok) return b;\n  return ok([a.value, b.value]);\n}\n\n/**\n * Async version of zip.\n */\nexport async function zipAsync<A, EA, CA, B, EB, CB>(\n  a: Result<A, EA, CA> | Promise<Result<A, EA, CA>>,\n  b: Result<B, EB, CB> | Promise<Result<B, EB, CB>>\n): Promise<Result<[A, B], EA | EB | PromiseRejectedError, CA | CB | PromiseRejectionCause>> {\n  // Wrap rejections into PromiseRejectedError (consistent with allAsync)\n  const wrapRejection = <T, E, C>(\n    p: Result<T, E, C> | Promise<Result<T, E, C>>\n  ): Promise<Result<T, E | PromiseRejectedError, C | PromiseRejectionCause>> =>\n    Promise.resolve(p).catch((reason) =>\n      err(\n        { type: PROMISE_REJECTED, cause: reason } as PromiseRejectedError,\n        { cause: { type: \"PROMISE_REJECTION\", reason } as PromiseRejectionCause }\n      )\n    );\n\n  const [ra, rb] = await Promise.all([wrapRejection(a), wrapRejection(b)]);\n  return zip(ra, rb);\n}\n\n// =============================================================================\n// Flatten\n// =============================================================================\n\n/**\n * Flattens a nested Result into a single Result.\n *\n * @remarks When to use: Unwrap a Result<Result<T, E1>, E2> into Result<T, E1 | E2> after an operation that returns nested Results.\n */\nexport function flatten<T, E1, C1, E2, C2>(\n  result: Result<Result<T, E1, C1>, E2, C2>\n): Result<T, E1 | E2, C1 | C2> {\n  if (!result.ok) return result as Err<E2, C2>;\n  return result.value;\n}\n\n// =============================================================================\n// Deserialization (improved hydrate)\n// =============================================================================\n\n/** Discriminant for deserialization errors */\nexport const DESERIALIZATION_ERROR = \"DESERIALIZATION_ERROR\" as const;\n\n/** Error type returned when deserialize() receives invalid input */\nexport type DeserializationError = { type: typeof DESERIALIZATION_ERROR; value: unknown };\n\n/**\n * Deserialize a value back into a Result.\n * Returns a typed DeserializationError on invalid input instead of null.\n *\n * @remarks When to use: Rehydrate Results from JSON, RPC, or server actions with type-safe error handling.\n */\nexport function deserialize<T, E, C = unknown>(\n  value: unknown\n): Result<T, E | DeserializationError, C> {\n  if (typeof value !== \"object\" || value === null) {\n    return err({ type: DESERIALIZATION_ERROR, value } as DeserializationError);\n  }\n  if (!(\"ok\" in value)) {\n    return err({ type: DESERIALIZATION_ERROR, value } as DeserializationError);\n  }\n\n  const obj = value as Record<string, unknown>;\n  if (obj.ok === true && \"value\" in obj) {\n    return ok(obj.value as T);\n  }\n  if (obj.ok === false && \"error\" in obj) {\n    return err(obj.error as E, { cause: obj.cause as C });\n  }\n  return err({ type: DESERIALIZATION_ERROR, value } as DeserializationError);\n}\n\n// =============================================================================\n// Serialization\n// =============================================================================\n\n/** A plain serialized form of a Result, safe to JSON.stringify. */\nexport type SerializedResult<T, E> = { ok: true; value: T } | { ok: false; error: E };\n\n/**\n * Serialize a Result to a plain object (inverse of `deserialize`).\n * Strips cause — safe for JSON.stringify, RPC, and server actions.\n *\n * @remarks When to use: Sending Results over the wire or storing them in JSON.\n */\nexport function serialize<T, E>(result: Result<T, E>): SerializedResult<T, E> {\n  return result.ok\n    ? { ok: true, value: result.value }\n    : { ok: false, error: result.error };\n}\n\n// =============================================================================\n// Partial error matching\n// =============================================================================\n\n/**\n * Non-exhaustive error match — handle the errors you care about; let the rest fall through to fallback.\n *\n * @example\n * ```typescript\n * const message = matchErrorPartial(\n *   error,\n *   { NOT_FOUND: () => 'Resource not found' },\n *   (e) => `Unexpected: ${e}`\n * );\n * ```\n */\nexport function matchErrorPartial<E extends string, R>(\n  error: E | UnexpectedError,\n  handlers: Partial<MatchErrorHandlers<E, R>>,\n  fallback: (error: E | UnexpectedError) => R\n): R {\n  if (isUnexpectedError(error)) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const h = (handlers as any).UnexpectedError as ((e: UnexpectedError) => R) | undefined;\n    return h ? h(error) : fallback(error);\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const h = (handlers as any)[error as string] as ((e: E) => R) | undefined;\n  return h ? h(error as E) : fallback(error);\n}\n\n// Retry helper is intentionally NOT re-exported here.\n// Import from the dedicated subpath to keep awaitly/result minimal:\n//   import { tryAsyncRetry } from 'awaitly/result/retry';\n"],"mappings":"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","names":["AWAITLY_SLUGS","slugDocsUrl","slug","ALL_SLUGS","AWAITLY_SLUGS","InternalTaggedErrorBase","TaggedError","tag","options","props","errorOptions","message","slugDocsUrl","safeProps","_","_n","_m","_s","_c","_h","_d","rest","hasUserCause","userCause","hasOptionsCause","instance","isError","value","isTaggedError","match","error","handlers","handler","matchPartial","otherwise","TimeoutError","TaggedError","p","RetryExhaustedError","RateLimitError","CircuitBreakerOpenError","ValidationError","NotFoundError","UnauthorizedError","NetworkError","CompensationError","UnexpectedError","PROMISE_REJECTED","AWAITLY_UNEXPECTED","AWAITLY_CANCELLED","AWAITLY_TIMEOUT","tags","t","ok","value","err","error","options","cause","isOk","r","isErr","isUnexpectedError","UnexpectedError","isPromiseRejectedError","PROMISE_REJECTED","matchError","errorOrHandlers","handlers","h","e","UnwrapError","result","errorStr","unwrap","unwrapOr","defaultValue","unwrapOrElse","fn","runOrThrow","runOrThrowAsync","ar","runOrNull","runOrUndefined","from","onError","fromPromise","promise","tryAsync","fromNullable","onNull","map","mapError","match","andThen","tap","tapError","mapTry","mapErrorTry","bimap","onOk","onErr","orElse","orElseAsync","recover","recoverAsync","resolved","hydrate","obj","isSerializedResult","all","results","values","allAsync","resultOrPromise","reason","allSettled","errors","allSettledAsync","settled","item","partition","any","firstErr","anyAsync","resolve","pendingCount","firstError","zip","a","b","zipAsync","wrapRejection","p","ra","rb","flatten","DESERIALIZATION_ERROR","deserialize","serialize","matchErrorPartial","fallback"]}
+{"version":3,"sources":["../src/slugs.ts","../src/tagged-error.ts","../src/errors.ts","../src/result/index.ts"],"sourcesContent":["/**\n * awaitly/slugs\n *\n * Source-of-truth slug namespace. Every concept that surfaces as a runtime\n * error, lint rule, static-analyzer diagnostic, visualizer event, or skill rule\n * has exactly one canonical kebab-case slug here.\n *\n * Slugs are public API. Renames are a major version bump. Adds are non-breaking.\n *\n * Categories:\n * - step-*       step() discipline\n * - workflow-*   createWorkflow / run / runWithState shape\n * - result-*     Result usage\n * - error-*      Boundary handling\n * - concurrency-* step.all/map/race vs Promise.*\n * - runtime-*    Failures only observable at runtime\n */\n\nexport const AWAITLY_SLUGS = {\n  // --- step-* ---\n  \"step-require-id\": \"step-require-id\",\n  \"step-no-immediate-execution\": \"step-no-immediate-execution\",\n  \"step-require-thunk-for-key\": \"step-require-thunk-for-key\",\n  \"step-no-bare-await\": \"step-no-bare-await\",\n  \"step-no-try-catch-wrap\": \"step-no-try-catch-wrap\",\n  \"step-stable-cache-keys\": \"step-stable-cache-keys\",\n\n  // --- workflow-* ---\n  \"workflow-no-floating\": \"workflow-no-floating\",\n  \"workflow-options-position\": \"workflow-options-position\",\n  \"workflow-callback-shape\": \"workflow-callback-shape\",\n  \"workflow-no-callable-form\": \"workflow-no-callable-form\",\n  \"workflow-no-dynamic-import\": \"workflow-no-dynamic-import\",\n  \"workflow-prefer-step-if\": \"workflow-prefer-step-if\",\n  \"workflow-prefer-step-foreach\": \"workflow-prefer-step-foreach\",\n\n  // --- result-* ---\n  \"result-no-floating\": \"result-no-floating\",\n  \"result-require-handling\": \"result-require-handling\",\n  \"result-no-double-wrap\": \"result-no-double-wrap\",\n  \"result-no-manual-propagation\": \"result-no-manual-propagation\",\n  \"result-no-direct-ok-err\": \"result-no-direct-ok-err\",\n\n  // --- error-* ---\n  \"error-check-unexpected-first\": \"error-check-unexpected-first\",\n  \"error-access-cause\": \"error-access-cause\",\n  \"error-normalize\": \"error-normalize\",\n  \"error-no-throw-in-deps\": \"error-no-throw-in-deps\",\n\n  // --- concurrency-* ---\n  \"concurrency-no-promise-all\": \"concurrency-no-promise-all\",\n  \"concurrency-no-promise-race\": \"concurrency-no-promise-race\",\n  \"concurrency-no-promise-allsettled\": \"concurrency-no-promise-allsettled\",\n\n  // --- runtime-* ---\n  \"runtime-step-timeout\": \"runtime-step-timeout\",\n  \"runtime-step-aborted\": \"runtime-step-aborted\",\n  \"runtime-retry-exhausted\": \"runtime-retry-exhausted\",\n  \"runtime-rate-limit\": \"runtime-rate-limit\",\n  \"runtime-circuit-open\": \"runtime-circuit-open\",\n  \"runtime-unexpected\": \"runtime-unexpected\",\n  \"runtime-resolver-not-found\": \"runtime-resolver-not-found\",\n  \"runtime-saga-compensation\": \"runtime-saga-compensation\",\n} as const;\n\n/** All canonical awaitly slugs as a string-literal union. */\nexport type AwaitlySlug = keyof typeof AWAITLY_SLUGS;\n\n/** Categories derived from slug prefixes. */\nexport type AwaitlySlugCategory =\n  | \"step\"\n  | \"workflow\"\n  | \"result\"\n  | \"error\"\n  | \"concurrency\"\n  | \"runtime\";\n\n/** Returns the category (prefix) of a slug. */\nexport function slugCategory(slug: AwaitlySlug): AwaitlySlugCategory {\n  return slug.split(\"-\")[0] as AwaitlySlugCategory;\n}\n\n/**\n * Returns the canonical docs URL for a slug. Resolves to the matching\n * anchored section on the consolidated rule index page.\n */\nexport function slugDocsUrl(slug: AwaitlySlug): string {\n  return `https://jagreehal.github.io/awaitly/rules/#${slug}`;\n}\n\n/** Type guard: is a string a known awaitly slug? */\nexport function isAwaitlySlug(value: string): value is AwaitlySlug {\n  return Object.prototype.hasOwnProperty.call(AWAITLY_SLUGS, value);\n}\n\n/** All slugs as an array. */\n// Object.keys returns string[] — cast is safe because AWAITLY_SLUGS is `as const`\n// and the module's keys are never mutated.\nexport const ALL_SLUGS: readonly AwaitlySlug[] = Object.keys(\n  AWAITLY_SLUGS\n) as AwaitlySlug[];\n","/**\n * awaitly/tagged-error\n *\n * Factory for creating tagged error types with exhaustive pattern matching.\n * Enables TypeScript to enforce that all error variants are handled.\n *\n * @example\n * ```typescript\n * // Define error types (Props via generic)\n * class NotFoundError extends TaggedError(\"NotFoundError\")<{\n *   id: string;\n *   resource: string;\n * }> {}\n *\n * // Define with type-safe message (Props inferred from callback annotation)\n * class ValidationError extends TaggedError(\"ValidationError\", {\n *   message: (p: { field: string; reason: string }) => `Invalid ${p.field}: ${p.reason}`,\n * }) {}\n *\n * // Create instances\n * const error = new NotFoundError({ id: \"123\", resource: \"User\" });\n *\n * // Runtime type check: instanceof TaggedError works!\n * console.log(error instanceof TaggedError); // true\n *\n * // Exhaustive matching\n * type AppError = NotFoundError | ValidationError;\n * const message = TaggedError.match(error as AppError, {\n *   NotFoundError: (e) => `Missing: ${e.resource} ${e.id}`,\n *   ValidationError: (e) => `Invalid ${e.field}: ${e.reason}`,\n * });\n * ```\n */\n\nimport { type AwaitlySlug, slugDocsUrl } from \"./slugs\";\n\n/**\n * Options for Error constructor (compatible with ES2022 ErrorOptions).\n */\nexport interface TaggedErrorOptions {\n  cause?: unknown;\n}\n\n/**\n * Options for TaggedError factory with type-safe message callback.\n */\nexport interface TaggedErrorCreateOptions<Props extends Record<string, unknown>> {\n  /** Custom message generator from props. Annotate parameter for type safety. */\n  message: (props: Props) => string;\n  /**\n   * Canonical awaitly slug for this error class. When set, instances carry\n   * `code`, `hint`, and `docsUrl` populated from the slugs namespace.\n   * Required together with `hint` for awaitly-system errors.\n   */\n  slug?: AwaitlySlug;\n  /**\n   * One-line \"do X instead\" guidance shown alongside the error.\n   * Required when `slug` is set.\n   */\n  hint?: string;\n}\n\n/**\n * Base interface for all tagged errors.\n *\n * `type` is the canonical discriminant (the same key plain tagged-object\n * errors use, so one `match` works across shapes). `_tag` is a deprecated\n * alias kept through the migration window.\n */\nexport interface TaggedErrorBase extends Error {\n  /** Canonical discriminant — matches the tag passed to TaggedError(tag). */\n  readonly type: string;\n  /** @deprecated Use `type`. Effect-style alias retained for migration. */\n  readonly _tag: string;\n  /** Canonical slug for awaitly-system errors. Undefined for user errors that opt out. */\n  readonly code?: AwaitlySlug;\n  /** One-line guidance. Undefined when no slug is set. */\n  readonly hint?: string;\n  /** Canonical docs URL. Undefined when no slug is set. */\n  readonly docsUrl?: string;\n}\n\n/**\n * Internal base class for instanceof checks.\n * All TaggedError-created classes extend this.\n * @internal\n */\nclass InternalTaggedErrorBase extends Error implements TaggedErrorBase {\n  readonly type!: string;\n  /** @deprecated Use `type`. */\n  readonly _tag!: string;\n}\n\n/**\n * Instance type for factory-created TaggedErrors.\n */\ntype TaggedErrorInstance<Tag extends string, Props> = TaggedErrorBase & {\n  readonly type: Tag;\n  /** @deprecated Use `type`. */\n  readonly _tag: Tag;\n} & Readonly<Props>;\n\n/**\n * Constructor args type - conditionally optional based on whether Props has required fields.\n * - If Props is empty or all properties are optional: props argument is optional\n * - If Props has any required properties: props argument is required\n * @internal\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\ntype ConstructorArgs<Props extends Record<string, unknown>> = {} extends Props\n  ? [props?: Props | void, options?: TaggedErrorOptions]\n  : [props: Props, options?: TaggedErrorOptions];\n\n/**\n * Constructor type returned by TaggedError factory.\n */\nexport interface TaggedErrorConstructor<\n  Tag extends string,\n  Props extends Record<string, unknown>,\n> {\n  new (...args: ConstructorArgs<Props>): TaggedErrorInstance<Tag, Props>;\n  readonly prototype: TaggedErrorInstance<Tag, Props>;\n}\n\n/**\n * Generic class factory type that allows `<Props>` parameterization.\n * This enables the Effect.js-style syntax: `class X extends TaggedError(\"X\")<Props> {}`\n * @internal\n */\nexport interface TaggedErrorClassFactory<Tag extends string> {\n  new <Props extends Record<string, unknown> = Record<string, never>>(\n    ...args: ConstructorArgs<Props>\n  ): TaggedErrorInstance<Tag, Props>;\n}\n\n/**\n * Helper type to extract return type from a function type.\n * @internal\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype FnReturnType<T> = T extends (...args: any[]) => infer R ? R : never;\n\n/**\n * Helper type to get union of return types from all handlers.\n * @internal\n */\ntype HandlersReturnType<H> = { [K in keyof H]: FnReturnType<H[K]> }[keyof H];\n\n/**\n * Helper type to extract keys whose values are definitely functions (not undefined).\n * Only excludes a tag from the fallback type if its handler is guaranteed to be\n * a function. Keys where the value type includes undefined are NOT excluded,\n * ensuring type safety with dynamic/conditional handlers.\n * @internal\n */\ntype DefinitelyHandledKeys<H> = {\n  [K in keyof H]-?: undefined extends H[K] ? never : K;\n}[keyof H];\n\n/**\n * Factory function to create tagged error classes.\n *\n * Two usage patterns:\n *\n * 1. **Props via generic** (default message is tag name):\n *    ```typescript\n *    class NotFoundError extends TaggedError(\"NotFoundError\")<{ id: string }> {}\n *    ```\n *\n * 2. **Props inferred from message callback** (type-safe message):\n *    ```typescript\n *    class NotFoundError extends TaggedError(\"NotFoundError\", {\n *      message: (p: { id: string }) => `Not found: ${p.id}`,\n *    }) {}\n *    ```\n *\n * Both support `instanceof TaggedError` checks at runtime.\n *\n * @param tag - The unique tag string for this error type\n * @param options - Optional configuration with message generator (annotate param for type safety)\n * @returns A class constructor that can be extended\n */\n\n// Overload 1: No options - use <Props> generic syntax, default message is tag\nfunction TaggedError<Tag extends string>(\n  tag: Tag\n): TaggedErrorClassFactory<Tag>;\n\n// Overload 2: With message option - Props inferred from callback parameter annotation\nfunction TaggedError<Tag extends string, Props extends Record<string, unknown>>(\n  tag: Tag,\n  options: TaggedErrorCreateOptions<Props>\n): TaggedErrorConstructor<Tag, Props>;\n\n// Implementation\nfunction TaggedError<Tag extends string, Props extends Record<string, unknown>>(\n  tag: Tag,\n  options?: TaggedErrorCreateOptions<Props>\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): any {\n  return class extends InternalTaggedErrorBase {\n    override readonly type: Tag = tag;\n    /** @deprecated Use `type`. */\n    override readonly _tag: Tag = tag;\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    constructor(props?: any, errorOptions?: TaggedErrorOptions) {\n      // Generate message: call callback if provided (even for prop-less errors), else use tag\n      const message = options?.message ? options.message(props ?? {}) : tag;\n\n      super(message);\n      this.name = tag;\n\n      // Spine fields: populate when factory was given a slug\n      if (options?.slug !== undefined) {\n        if (!options.hint) {\n          throw new TypeError(\n            `TaggedError: 'hint' is required when 'slug' is set (slug: \"${options.slug}\")`\n          );\n        }\n        Object.defineProperty(this, \"code\", {\n          value: options.slug,\n          enumerable: true,\n          writable: false,\n          configurable: false,\n        });\n        Object.defineProperty(this, \"hint\", {\n          value: options.hint,\n          enumerable: true,\n          writable: false,\n          configurable: false,\n        });\n        Object.defineProperty(this, \"docsUrl\", {\n          value: slugDocsUrl(options.slug),\n          enumerable: true,\n          writable: false,\n          configurable: false,\n        });\n      }\n\n      // Maintains proper prototype chain for instanceof checks\n      Object.setPrototypeOf(this, new.target.prototype);\n\n      // Assign props to instance, stripping reserved keys:\n      // - type/_tag: discriminants for pattern matching (cannot be forged)\n      // - name, message, stack: Error internals (preserve for logging/debugging)\n      // - code, hint, docsUrl: spine fields stripped when slug is set, to prevent\n      //   Object.assign from clobbering the non-configurable/non-writable own props\n      // Note: 'cause' is allowed as a user prop (common for domain errors)\n      if (props && typeof props === \"object\") {\n        let safeProps: Record<string, unknown>;\n        if (options?.slug !== undefined) {\n          const {\n            _tag: _,\n            type: _t,\n            name: _n,\n            message: _m,\n            stack: _s,\n            code: _c,\n            hint: _h,\n            docsUrl: _d,\n            ...rest\n          } = props;\n          safeProps = rest;\n        } else {\n          const {\n            _tag: _,\n            type: _t,\n            name: _n,\n            message: _m,\n            stack: _s,\n            ...rest\n          } = props;\n          safeProps = rest;\n        }\n\n        const hasUserCause = Object.prototype.hasOwnProperty.call(\n          safeProps,\n          \"cause\"\n        );\n        const userCause = hasUserCause\n          ? (safeProps as { cause?: unknown }).cause\n          : undefined;\n        if (hasUserCause) {\n          delete (safeProps as { cause?: unknown }).cause;\n        }\n\n        const hasOptionsCause = errorOptions?.cause !== undefined;\n        if (hasUserCause && hasOptionsCause) {\n          throw new TypeError(\n            \"TaggedError: cannot provide 'cause' in props when also setting ErrorOptions.cause\"\n          );\n        }\n\n        Object.assign(this, safeProps);\n\n        if (hasUserCause) {\n          (this as { cause?: unknown }).cause = userCause;\n        }\n        if (hasOptionsCause) {\n          (this as { cause?: unknown }).cause = errorOptions?.cause;\n        }\n      } else if (errorOptions?.cause !== undefined) {\n        (this as { cause?: unknown }).cause = errorOptions.cause;\n      }\n    }\n  };\n}\n\n// Add Symbol.hasInstance so `instanceof TaggedError` works\nObject.defineProperty(TaggedError, Symbol.hasInstance, {\n  value: (instance: unknown): boolean => instance instanceof InternalTaggedErrorBase,\n});\n\n/**\n * Namespace for static methods on TaggedError.\n */\n// eslint-disable-next-line @typescript-eslint/no-namespace\nnamespace TaggedError {\n  /**\n   * Type guard to check if a value is an Error instance.\n   */\n  export function isError(value: unknown): value is Error {\n    return value instanceof Error;\n  }\n\n  /**\n   * Type guard to check if a value is a TaggedError instance.\n   * Uses the same check as `instanceof TaggedError` - only genuine\n   * TaggedError instances (created via the factory) pass this guard.\n   */\n  export function isTaggedError(value: unknown): value is TaggedErrorBase {\n    return value instanceof InternalTaggedErrorBase;\n  }\n\n  /**\n   * Exhaustively matches on a tagged error, requiring handlers for all variants.\n   *\n   * TypeScript will error if any variant in the error union is not handled.\n   *\n   * @remarks When to use: You want compile-time enforcement that every tagged variant is handled.\n   *\n   * @param error - The tagged error to match\n   * @param handlers - Object mapping _tag values to handler functions\n   * @returns The return value of the matched handler\n   *\n   * @example\n   * ```typescript\n   * type AppError = NotFoundError | ValidationError;\n   *\n   * const message = TaggedError.match(error, {\n   *   NotFoundError: (e) => `Not found: ${e.id}`,\n   *   ValidationError: (e) => `Invalid: ${e.field}`,\n   * });\n   * ```\n   */\n  export function match<\n    E extends TaggedErrorBase,\n    H extends { [K in E[\"_tag\"]]: (e: Extract<E, { _tag: K }>) => unknown },\n  >(error: E, handlers: H): HandlersReturnType<H> {\n    const tag = error._tag as E[\"_tag\"];\n    const handler = handlers[tag];\n    return handler(\n      error as Extract<E, { _tag: typeof tag }>\n    ) as HandlersReturnType<H>;\n  }\n\n  /**\n   * Partially matches on a tagged error with a fallback for unhandled variants.\n   *\n   * The fallback receives variants that are NOT definitely handled. A tag is\n   * considered \"definitely handled\" only if its handler is a function (not\n   * `undefined`). This ensures type safety even with dynamic/conditional handlers:\n   *\n   * ```typescript\n   * const maybeHandle = featureFlag ? (e) => e.id : undefined;\n   * TaggedError.matchPartial(\n   *   error,\n   *   { NotFoundError: maybeHandle },  // maybeHandle might be undefined\n   *   (e) => e._tag  // e correctly includes NotFoundError\n   * );\n   * ```\n   *\n   * @param error - The tagged error to match\n   * @param handlers - Partial object mapping _tag values to handler functions\n   * @param otherwise - Fallback handler for unmatched variants\n   * @returns The return value of the matched handler or fallback\n   *\n   * @example\n   * ```typescript\n   * const message = TaggedError.matchPartial(\n   *   error,\n   *   { NotFoundError: (e) => `Not found: ${e.id}` },\n   *   (e) => `Other error: ${e.message}`\n   * );\n   * ```\n   */\n  export function matchPartial<\n    E extends TaggedErrorBase,\n    H extends Partial<{\n      [K in E[\"_tag\"]]: (e: Extract<E, { _tag: K }>) => unknown;\n    }>,\n    T,\n  >(\n    error: E,\n    handlers: H,\n    otherwise: (e: Exclude<E, { _tag: DefinitelyHandledKeys<H> }>) => T\n  ): HandlersReturnType<H> | T {\n    const tag = error._tag as E[\"_tag\"];\n    const handler = handlers[tag];\n    if (handler) {\n      return handler(\n        error as Extract<E, { _tag: typeof tag }>\n      ) as HandlersReturnType<H>;\n    }\n    return otherwise(error as Exclude<E, { _tag: DefinitelyHandledKeys<H> }>);\n  }\n}\n\nexport { TaggedError };\n\n/**\n * Helper type to extract the _tag literal type from a TaggedError.\n *\n * @example\n * ```typescript\n * class MyError extends TaggedError(\"MyError\")<{ id: string }> {}\n * type Tag = TagOf<MyError>; // \"MyError\"\n * ```\n */\nexport type TagOf<E extends TaggedErrorBase> = E[\"_tag\"];\n\n/**\n * Helper type to extract a specific variant from a TaggedError union by tag.\n *\n * @example\n * ```typescript\n * type AppError = NotFoundError | ValidationError;\n * type NotFound = ErrorByTag<AppError, \"NotFoundError\">; // NotFoundError\n * ```\n */\nexport type ErrorByTag<\n  E extends TaggedErrorBase,\n  Tag extends E[\"_tag\"],\n> = Extract<E, { _tag: Tag }>;\n\n/**\n * Reserved keys that are stripped from user props at runtime.\n * These keys cannot be used as user-defined properties:\n * - _tag: discriminant for pattern matching\n * - name, message, stack: Error internals (preserved for logging/debugging)\n * - code, hint, docsUrl: spine fields (non-configurable own properties when slug is set)\n *\n * Note: 'cause' is NOT reserved - it can be used as a user prop.\n */\ntype ReservedErrorKeys = \"_tag\" | \"name\" | \"message\" | \"stack\" | \"code\" | \"hint\" | \"docsUrl\";\n\n/**\n * Helper type to extract props from a TaggedError.\n * Excludes reserved keys that are stripped at runtime.\n *\n * @example\n * ```typescript\n * class MyError extends TaggedError(\"MyError\")<{ id: string }> {}\n * type Props = PropsOf<MyError>; // { id: string }\n *\n * // 'cause' is allowed as a user prop\n * class DomainError extends TaggedError(\"DomainError\")<{ cause: { field: string } }> {}\n * type DomainProps = PropsOf<DomainError>; // { cause: { field: string } }\n * ```\n */\nexport type PropsOf<E extends TaggedErrorBase> = Omit<E, ReservedErrorKeys>;\n","/**\n * awaitly/errors\n *\n * Pre-built error types for common failure scenarios.\n * Uses TaggedError for type-safe exhaustive matching.\n *\n * @example\n * ```typescript\n * import { TimeoutError, RetryExhaustedError, RateLimitError, CircuitBreakerOpenError } from 'awaitly';\n *\n * // Create errors\n * const timeout = new TimeoutError({ operation: 'fetchUser', ms: 5000 });\n * const retryFailed = new RetryExhaustedError({ operation: 'sendEmail', attempts: 3 });\n *\n * // Pattern match\n * TaggedError.match(error, {\n *   TimeoutError: (e) => `${e.operation} timed out after ${e.ms}ms`,\n *   RetryExhaustedError: (e) => `${e.operation} failed after ${e.attempts} attempts`,\n *   RateLimitError: (e) => `Rate limit exceeded, retry after ${e.retryAfterMs}ms`,\n *   CircuitBreakerOpenError: (e) => `Circuit ${e.circuitName} is open`,\n * });\n * ```\n */\n\n/**\n * Spine policy:\n *\n * Awaitly-system errors (raised by awaitly internals on workflow execution\n * failure modes) carry a `slug` + `hint` so they participate in the\n * AI-DX spine: TimeoutError, RetryExhaustedError, RateLimitError,\n * CircuitBreakerOpenError, CompensationError, UnexpectedError.\n *\n * Convenience domain errors (ValidationError, NotFoundError,\n * UnauthorizedError, NetworkError) are deliberately NOT slugged — they\n * represent USER domain failures and would force user code into the\n * awaitly slug namespace. Users can opt in by adding `slug` + `hint`\n * to their own TaggedError subclasses.\n */\n\nimport { TaggedError } from \"./tagged-error\";\n\n// =============================================================================\n// Error Factory\n// =============================================================================\n\n/**\n * Factory function to create tagged error classes with default values.\n *\n * This is a convenience wrapper around TaggedError that allows specifying\n * default property values for error types.\n *\n * @example\n * ```typescript\n * const NetworkError = makeError('NetworkError', {\n *   defaults: { retryable: true },\n *   message: (p) => `Network error: ${p.reason}`,\n * });\n *\n * class MyNetworkError extends NetworkError<{ reason: string; code?: number }> {}\n * ```\n */\nexport function makeError<Tag extends string>(\n  tag: Tag,\n  options?: {\n    message?: (props: Record<string, unknown>) => string;\n    defaults?: Record<string, unknown>;\n  }\n) {\n  const messageGenerator = options?.message ?? (() => tag);\n  const defaults = options?.defaults ?? {};\n\n  const BaseClass = TaggedError(tag, {\n    message: (props: Record<string, unknown>) =>\n      messageGenerator({ ...defaults, ...props }),\n  });\n\n  return class extends BaseClass {\n    constructor(props?: Record<string, unknown>) {\n      super({ ...defaults, ...props } as Record<string, unknown>);\n      Object.assign(this, { ...defaults, ...props });\n    }\n  };\n}\n\n// =============================================================================\n// Pre-built Error Types\n// =============================================================================\n\n/**\n * Error thrown when an operation times out.\n *\n * @example\n * ```typescript\n * const error = new TimeoutError({\n *   operation: 'fetchUser',\n *   ms: 5000,\n * });\n * console.log(error.message); // \"TimeoutError: fetchUser timed out after 5000ms\"\n * ```\n */\nexport class TimeoutError extends /* @__PURE__ */ TaggedError(\"TimeoutError\", {\n  slug: \"runtime-step-timeout\",\n  hint: \"Increase the step's timeout option, or check why the upstream operation is slow.\",\n  message: (p: {\n    /** Name of the operation that timed out */\n    operation?: string;\n    /** Timeout duration in milliseconds */\n    ms: number;\n  }) =>\n    p.operation\n      ? `TimeoutError: ${p.operation} timed out after ${p.ms}ms`\n      : `TimeoutError: Operation timed out after ${p.ms}ms`,\n}) {}\n\n/**\n * Error thrown when all retry attempts are exhausted.\n *\n * @example\n * ```typescript\n * const error = new RetryExhaustedError({\n *   operation: 'sendEmail',\n *   attempts: 3,\n *   lastError: originalError,\n * });\n * console.log(error.message); // \"RetryExhaustedError: sendEmail failed after 3 attempts\"\n * ```\n */\nexport class RetryExhaustedError extends /* @__PURE__ */ TaggedError(\"RetryExhaustedError\", {\n  slug: \"runtime-retry-exhausted\",\n  hint: \"All retry attempts failed. Inspect lastError and decide whether to surface it or compensate.\",\n  message: (p: {\n    /** Name of the operation that failed */\n    operation?: string;\n    /** Total number of retry attempts made */\n    attempts: number;\n    /** The last error encountered before giving up */\n    lastError?: unknown;\n  }) =>\n    p.operation\n      ? `RetryExhaustedError: ${p.operation} failed after ${p.attempts} attempts`\n      : `RetryExhaustedError: Operation failed after ${p.attempts} attempts`,\n}) {}\n\n/**\n * Error thrown when a rate limit is exceeded.\n *\n * @example\n * ```typescript\n * const error = new RateLimitError({\n *   limiterName: 'api-calls',\n *   retryAfterMs: 1000,\n * });\n * console.log(error.message); // \"RateLimitError: Rate limit exceeded for api-calls\"\n * ```\n */\nexport class RateLimitError extends /* @__PURE__ */ TaggedError(\"RateLimitError\", {\n  slug: \"runtime-rate-limit\",\n  hint: \"Wait retryAfterMs before retrying, or apply step.cache to deduplicate calls.\",\n  message: (p: {\n    /** Name of the rate limiter that was exceeded */\n    limiterName?: string;\n    /** Time in milliseconds until the rate limit resets */\n    retryAfterMs?: number;\n  }) =>\n    p.limiterName\n      ? `RateLimitError: Rate limit exceeded for ${p.limiterName}${p.retryAfterMs ? `, retry after ${p.retryAfterMs}ms` : \"\"}`\n      : `RateLimitError: Rate limit exceeded${p.retryAfterMs ? `, retry after ${p.retryAfterMs}ms` : \"\"}`,\n}) {}\n\n/**\n * Error thrown when a circuit breaker is open.\n *\n * @example\n * ```typescript\n * const error = new CircuitBreakerOpenError({\n *   circuitName: 'payment-api',\n *   state: 'OPEN',\n *   retryAfterMs: 30000,\n * });\n * console.log(error.message); // \"CircuitBreakerOpenError: Circuit payment-api is OPEN\"\n * ```\n */\nexport class CircuitBreakerOpenError extends /* @__PURE__ */ TaggedError(\n  \"CircuitBreakerOpenError\",\n  {\n    slug: \"runtime-circuit-open\",\n    hint: \"The circuit is open. Wait for it to half-open or fall back to a degraded path.\",\n    message: (p: {\n      /** Name of the circuit breaker */\n      circuitName: string;\n      /** Current state of the circuit */\n      state?: \"OPEN\" | \"HALF_OPEN\";\n      /** Time in milliseconds until the circuit may close */\n      retryAfterMs?: number;\n    }) =>\n      `CircuitBreakerOpenError: Circuit ${p.circuitName} is ${p.state ?? \"OPEN\"}${p.retryAfterMs ? `, retry after ${Math.ceil(p.retryAfterMs / 1000)}s` : \"\"}`,\n  }\n) {}\n\n/**\n * Error thrown when validation fails.\n *\n * @example\n * ```typescript\n * const error = new ValidationError({\n *   field: 'email',\n *   reason: 'Invalid email format',\n * });\n * console.log(error.message); // \"ValidationError: Invalid email - Invalid email format\"\n * ```\n */\nexport class ValidationError extends /* @__PURE__ */ TaggedError(\"ValidationError\", {\n  message: (p: {\n    /** Field that failed validation */\n    field: string;\n    /** Reason for validation failure */\n    reason: string;\n    /** Raw value that failed validation */\n    value?: unknown;\n  }) => `ValidationError: Invalid ${p.field} - ${p.reason}`,\n}) {}\n\n/**\n * Error thrown when a resource is not found.\n *\n * @example\n * ```typescript\n * const error = new NotFoundError({\n *   resource: 'User',\n *   id: '123',\n * });\n * console.log(error.message); // \"NotFoundError: User with id 123 not found\"\n * ```\n */\nexport class NotFoundError extends /* @__PURE__ */ TaggedError(\"NotFoundError\", {\n  message: (p: {\n    /** Type of resource that was not found */\n    resource: string;\n    /** Identifier of the missing resource */\n    id?: string;\n  }) =>\n    p.id\n      ? `NotFoundError: ${p.resource} with id ${p.id} not found`\n      : `NotFoundError: ${p.resource} not found`,\n}) {}\n\n/**\n * Error thrown when access is denied.\n *\n * @example\n * ```typescript\n * const error = new UnauthorizedError({\n *   action: 'delete',\n *   resource: 'User',\n * });\n * console.log(error.message); // \"UnauthorizedError: Not authorized to delete User\"\n * ```\n */\nexport class UnauthorizedError extends /* @__PURE__ */ TaggedError(\"UnauthorizedError\", {\n  message: (p: {\n    /** Action that was attempted */\n    action?: string;\n    /** Resource that was being accessed */\n    resource?: string;\n    /** Reason for denial */\n    reason?: string;\n  }) =>\n    p.reason\n      ? `UnauthorizedError: ${p.reason}`\n      : p.action && p.resource\n        ? `UnauthorizedError: Not authorized to ${p.action} ${p.resource}`\n        : \"UnauthorizedError: Access denied\",\n}) {}\n\n/**\n * Error thrown for network-related failures.\n *\n * @example\n * ```typescript\n * const error = new NetworkError({\n *   url: 'https://api.example.com/users',\n *   reason: 'Connection refused',\n *   retryable: true,\n * });\n * ```\n */\nexport class NetworkError extends /* @__PURE__ */ TaggedError(\"NetworkError\", {\n  message: (p: {\n    /** URL that was being accessed */\n    url?: string;\n    /** Reason for the network failure */\n    reason: string;\n    /** Whether this error is retryable */\n    retryable?: boolean;\n    /** HTTP status code if applicable */\n    statusCode?: number;\n  }) =>\n    p.url\n      ? `NetworkError: ${p.reason} (${p.url})`\n      : `NetworkError: ${p.reason}`,\n}) {}\n\n/**\n * Error thrown when a saga compensation fails.\n *\n * @example\n * ```typescript\n * const error = new CompensationError({\n *   step: 'chargeCard',\n *   originalError: paymentError,\n *   compensationError: refundError,\n * });\n * ```\n */\nexport class CompensationError extends /* @__PURE__ */ TaggedError(\"CompensationError\", {\n  slug: \"runtime-saga-compensation\",\n  hint: \"A saga compensation step failed. Inspect compensationError and ensure compensation is idempotent.\",\n  message: (p: {\n    /** Step that triggered compensation */\n    step: string;\n    /** The original error that caused compensation */\n    originalError?: unknown;\n    /** Error that occurred during compensation */\n    compensationError?: unknown;\n  }) => `CompensationError: Failed to compensate step ${p.step}`,\n}) {}\n\n// =============================================================================\n// Unexpected Error\n// =============================================================================\n\n/**\n * Default error type for uncaught exceptions and cancellation in workflows.\n * This is the default `U` type when `catchUnexpected` is not provided.\n *\n * @example\n * ```typescript\n * // Automatically used as the default — no need to pass catchUnexpected:\n * const workflow = createWorkflow(\"checkout\", { chargeCard, sendEmail });\n *\n * // Equivalent to:\n * const workflow = createWorkflow(\"checkout\", { chargeCard, sendEmail }, {\n *   catchUnexpected: (cause) => new UnexpectedError({ cause }),\n * });\n * ```\n */\nexport class UnexpectedError extends /* @__PURE__ */ TaggedError(\"UnexpectedError\", {\n  slug: \"runtime-unexpected\",\n  hint: \"An unexpected exception escaped a step. Inspect cause; consider returning a typed Result instead of throwing.\",\n  message: (p: {\n    /** The original thrown value or cancellation error */\n    cause?: unknown;\n  }) => `UnexpectedError: ${p.cause instanceof Error ? p.cause.message : String(p.cause ?? \"unknown\")}`,\n}) {}\n\n// =============================================================================\n// Union Type for Common Errors\n// =============================================================================\n\n/**\n * Union of all pre-built error types.\n * Useful for exhaustive pattern matching.\n *\n * @example\n * ```typescript\n * function handleError(error: AwaitlyError): string {\n *   return TaggedError.match(error, {\n *     TimeoutError: (e) => `Timeout: ${e.ms}ms`,\n *     RetryExhaustedError: (e) => `Retries: ${e.attempts}`,\n *     RateLimitError: (e) => `Rate limited`,\n *     CircuitBreakerOpenError: (e) => `Circuit open: ${e.circuitName}`,\n *     ValidationError: (e) => `Invalid: ${e.field}`,\n *     NotFoundError: (e) => `Not found: ${e.resource}`,\n *     UnauthorizedError: (e) => `Unauthorized`,\n *     NetworkError: (e) => `Network: ${e.reason}`,\n *     CompensationError: (e) => `Compensation failed: ${e.step}`,\n *     UnexpectedError: (e) => e.message,\n *   });\n * }\n * ```\n */\nexport type AwaitlyError =\n  | TimeoutError\n  | RetryExhaustedError\n  | RateLimitError\n  | CircuitBreakerOpenError\n  | ValidationError\n  | NotFoundError\n  | UnauthorizedError\n  | NetworkError\n  | CompensationError\n  | UnexpectedError;\n\n/**\n * The six awaitly-system errors that carry slug + hint + docsUrl spine fields.\n *\n * Distinguishes spine-bearing errors from user-domain convenience errors\n * (ValidationError, NotFoundError, UnauthorizedError, NetworkError) so that\n * downstream tooling (lint, analyzer, docs generator) can target the spine\n * roster without duplicating the class list.\n */\nexport type AwaitlySystemError =\n  | TimeoutError\n  | RetryExhaustedError\n  | RateLimitError\n  | CircuitBreakerOpenError\n  | CompensationError\n  | UnexpectedError;\n\n/**\n * Roster of awaitly-system error classes that participate in the slug spine.\n *\n * Adding a new system error means adding it to `AwaitlySystemError`, this\n * roster, and `slugs.ts`. The integrity test in `spine-integrity.test.ts`\n * iterates this roster, so a missing entry there is caught at CI time.\n *\n * @internal Tooling integration point (docs generator, integrity tests). Not\n *   a stable user-facing API — application code should not depend on this\n *   array's identity or order.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const AWAITLY_SYSTEM_ERROR_CLASSES: ReadonlyArray<new (...args: any[]) => AwaitlySystemError> = [\n  TimeoutError,\n  RetryExhaustedError,\n  RateLimitError,\n  CircuitBreakerOpenError,\n  CompensationError,\n  UnexpectedError,\n];\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Check if an error is a TimeoutError.\n */\nexport function isTimeoutError(error: unknown): error is TimeoutError {\n  return TaggedError.isTaggedError(error) && error._tag === \"TimeoutError\";\n}\n\n/**\n * Check if an error is a RetryExhaustedError.\n */\nexport function isRetryExhaustedError(\n  error: unknown\n): error is RetryExhaustedError {\n  return (\n    TaggedError.isTaggedError(error) && error._tag === \"RetryExhaustedError\"\n  );\n}\n\n/**\n * Check if an error is a RateLimitError.\n */\nexport function isRateLimitError(error: unknown): error is RateLimitError {\n  return TaggedError.isTaggedError(error) && error._tag === \"RateLimitError\";\n}\n\n/**\n * Check if an error is a CircuitBreakerOpenError.\n */\nexport function isCircuitBreakerOpenError(\n  error: unknown\n): error is CircuitBreakerOpenError {\n  return (\n    TaggedError.isTaggedError(error) && error._tag === \"CircuitBreakerOpenError\"\n  );\n}\n\n/**\n * Check if an error is a ValidationError.\n */\nexport function isValidationError(error: unknown): error is ValidationError {\n  return TaggedError.isTaggedError(error) && error._tag === \"ValidationError\";\n}\n\n/**\n * Check if an error is a NotFoundError.\n */\nexport function isNotFoundError(error: unknown): error is NotFoundError {\n  return TaggedError.isTaggedError(error) && error._tag === \"NotFoundError\";\n}\n\n/**\n * Check if an error is an UnauthorizedError.\n */\nexport function isUnauthorizedError(\n  error: unknown\n): error is UnauthorizedError {\n  return TaggedError.isTaggedError(error) && error._tag === \"UnauthorizedError\";\n}\n\n/**\n * Check if an error is a NetworkError.\n */\nexport function isNetworkError(error: unknown): error is NetworkError {\n  return TaggedError.isTaggedError(error) && error._tag === \"NetworkError\";\n}\n\n/**\n * Check if an error is a CompensationError.\n */\nexport function isCompensationError(\n  error: unknown\n): error is CompensationError {\n  return TaggedError.isTaggedError(error) && error._tag === \"CompensationError\";\n}\n\n/**\n * Check if an error is any AwaitlyError.\n */\nexport function isAwaitlyError(error: unknown): error is AwaitlyError {\n  if (!TaggedError.isTaggedError(error)) return false;\n  const tag = error._tag;\n  return [\n    \"TimeoutError\",\n    \"RetryExhaustedError\",\n    \"RateLimitError\",\n    \"CircuitBreakerOpenError\",\n    \"ValidationError\",\n    \"NotFoundError\",\n    \"UnauthorizedError\",\n    \"NetworkError\",\n    \"CompensationError\",\n    \"UnexpectedError\",\n  ].includes(tag);\n}\n","/**\n * awaitly/result (internal)\n *\n * Core Result primitives - minimal bundle for typed error handling.\n * This file is intentionally kept small for optimal tree-shaking.\n * The full orchestration (run, step, etc.) lives in core.ts.\n */\n\n// =============================================================================\n// Core Result Types\n// =============================================================================\n\n/**\n * Represents a successful result.\n * Use `ok(value)` to create instances.\n */\nexport type Ok<T> = {\n  ok: true;\n  value: T;\n};\n\n/**\n * Represents a failed result.\n * Use `err(error)` to create instances.\n */\nexport type Err<E, C = unknown> = {\n  ok: false;\n  error: E;\n  cause?: C;\n};\n\n/**\n * Represents a successful computation or a failed one.\n */\nexport type Result<T, E = unknown, C = unknown> = Ok<T> | Err<E, C>;\n\n/**\n * A Promise that resolves to a Result.\n */\nexport type AsyncResult<T, E = unknown, C = unknown> = Promise<Result<T, E, C>>;\n\n/** Discriminant for PromiseRejectedError type - use in switch statements */\nexport const PROMISE_REJECTED = \"PROMISE_REJECTED\" as const;\n\n// =============================================================================\n// Named Error Constants (for static analysis)\n// =============================================================================\n\n/**\n * Named error constant for unexpected/unhandled errors.\n * Used by the analyzer when a step doesn't declare errors.\n */\nexport const AWAITLY_UNEXPECTED = \"AWAITLY_UNEXPECTED\" as const;\n\n/**\n * Named error constant for cancelled operations.\n */\nexport const AWAITLY_CANCELLED = \"AWAITLY_CANCELLED\" as const;\n\n/**\n * Named error constant for timed-out operations.\n */\nexport const AWAITLY_TIMEOUT = \"AWAITLY_TIMEOUT\" as const;\n\n// =============================================================================\n// Static Analysis Helpers\n// =============================================================================\n\n/**\n * Helper to create a tuple of string literal tags with preserved literal types.\n * Use this when you need to store error tags in a variable while keeping\n * TypeScript's literal type inference (avoiding widening to string[]).\n *\n * @param t - The string literal tags\n * @returns The same array with preserved literal types\n *\n * @example\n * ```typescript\n * // Without tags() - type widens to string[]\n * const errs = ['CART_NOT_FOUND', 'CART_EMPTY'];  // string[]\n *\n * // With tags() - literal types preserved\n * const errs = tags('CART_NOT_FOUND', 'CART_EMPTY');  // readonly ['CART_NOT_FOUND', 'CART_EMPTY']\n *\n * await step('getCart', () => getCart(id), {\n *   errors: errs,  // Analyzer can extract literal types\n *   out: 'cart',\n * });\n * ```\n */\nexport const tags = <const T extends readonly string[]>(...t: T): T => t;\n\nimport { UnexpectedError } from \"../errors\";\nexport { UnexpectedError };\nexport type PromiseRejectedError = { type: typeof PROMISE_REJECTED; cause: unknown };\n/** Cause type for promise rejections in async batch helpers */\nexport type PromiseRejectionCause = { type: \"PROMISE_REJECTION\"; reason: unknown };\nexport type EmptyInputError = { type: \"EMPTY_INPUT\"; message: string };\nexport type MaybeAsyncResult<T, E, C = unknown> = Result<T, E, C> | Promise<Result<T, E, C>>;\n\n// =============================================================================\n// Result Constructors\n// =============================================================================\n\n/**\n * Creates a successful Result.\n *\n * @remarks When to use: Wrap a successful value in a Result for consistent return types.\n */\nexport function ok(): Ok<void>;\nexport function ok<T>(value: T): Ok<T>;\nexport function ok<T>(value?: T): Ok<T | void> {\n  return { ok: true as const, value: value as T | void };\n}\n\n/**\n * Creates a failed Result.\n *\n * @remarks When to use: Return a typed failure without throwing so callers can handle it explicitly.\n */\nexport function err<E, C = unknown>(error: E, options?: { cause?: C }): Err<E, C> {\n  const cause = options?.cause;\n  return { ok: false as const, error, ...(cause !== undefined ? { cause } : {}) } as Err<E, C>;\n}\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Checks if a Result is successful.\n *\n * @remarks When to use: Prefer functional-style checks or array filtering over `result.ok`.\n */\nexport const isOk = <T, E, C>(r: Result<T, E, C>): r is Ok<T> => r.ok;\n\n/**\n * Checks if a Result is a failure.\n *\n * @remarks When to use: Prefer functional-style checks or array filtering over `result.ok`.\n */\nexport const isErr = <T, E, C>(r: Result<T, E, C>): r is Err<E, C> => !r.ok;\n\n/**\n * Checks if an error is an UnexpectedError.\n *\n * @remarks When to use: Distinguish unexpected failures from your typed error union.\n */\nexport const isUnexpectedError = (e: unknown): e is UnexpectedError =>\n  e instanceof UnexpectedError ||\n  (typeof e === \"object\" &&\n    e !== null &&\n    \"_tag\" in e &&\n    (e as { _tag: string })._tag === \"UnexpectedError\");\n\n/**\n * Checks if an error is a PromiseRejectedError.\n */\nexport const isPromiseRejectedError = (e: unknown): e is PromiseRejectedError =>\n  typeof e === \"object\" &&\n  e !== null &&\n  \"type\" in e &&\n  e.type === PROMISE_REJECTED;\n\n// =============================================================================\n// Error Matching\n// =============================================================================\n\nexport type MatchErrorHandlers<E extends string, R> = {\n  [K in Exclude<E, \"UnexpectedError\">]: (error: K) => R;\n} & {\n  UnexpectedError: (error: UnexpectedError) => R;\n};\n\n/**\n * Match on string error types with exhaustive checking.\n * Takes an error value (not a Result) and handlers for each error type.\n */\nexport function matchError<E extends string, R>(\n  handlers: MatchErrorHandlers<E, R>\n): (error: E | UnexpectedError) => R;\nexport function matchError<E extends string, R>(\n  error: E | UnexpectedError,\n  handlers: MatchErrorHandlers<E, R>\n): R;\nexport function matchError<E extends string, R>(\n  errorOrHandlers: E | UnexpectedError | MatchErrorHandlers<E, R>,\n  handlers?: MatchErrorHandlers<E, R>\n): R | ((error: E | UnexpectedError) => R) {\n  if (handlers === undefined) {\n    const h = errorOrHandlers as MatchErrorHandlers<E, R>;\n    return (e: E | UnexpectedError) => matchError(e, h);\n  }\n  const error = errorOrHandlers as E | UnexpectedError;\n  // Handle UnexpectedError instances\n  if (isUnexpectedError(error)) {\n    return handlers.UnexpectedError(error as UnexpectedError);\n  }\n  // Handle string literal errors\n  type StringErrors = Exclude<E, \"UnexpectedError\">;\n  return (handlers as unknown as Record<string, (e: string) => R>)[error as StringErrors](error as StringErrors);\n}\n\n// =============================================================================\n// Type Utilities\n// =============================================================================\n\ntype AnyFunction = (...args: never[]) => unknown;\n\n/**\n * Helper to extract the error type from Result or AsyncResult return values.\n * Works even when a function is declared to return a union of both forms.\n * Plain (non-Result) return types contribute `never` — without the [never]\n * guard they would infer `unknown` and poison error unions built from\n * mixed deps.\n */\ntype ErrorOfReturn<R> = [Extract<Awaited<R>, { ok: false }>] extends [never]\n  ? never\n  : Extract<Awaited<R>, { ok: false }> extends { error: infer E }\n    ? E\n    : never;\n\n/**\n * Extract error type from a single function's return type\n */\nexport type ErrorOf<T extends AnyFunction> = ErrorOfReturn<ReturnType<T>>;\n\n/**\n * Extract union of error types from multiple functions (tuple form)\n */\nexport type Errors<T extends AnyFunction[]> = {\n  [K in keyof T]: ErrorOf<T[K]>;\n}[number];\n\n/**\n * Extract union of error types from a deps object.\n *\n * @example\n * ```typescript\n * const deps = { getUser, createOrder, sendEmail };\n * type E = ErrorsOf<typeof deps>;\n * // = \"NOT_FOUND\" | \"ORDER_FAILED\" | \"EMAIL_ERROR\"\n * ```\n */\nexport type ErrorsOf<Deps extends Record<string, AnyFunction>> = {\n  [K in keyof Deps]: ErrorOf<Deps[K]>;\n}[keyof Deps];\n\n/**\n * Extract value type from Result\n */\nexport type ExtractValue<T> = T extends { ok: true; value: infer U }\n  ? U\n  : never;\n\n/**\n * Extract error type from Result\n */\nexport type ExtractError<T> = T extends { ok: false; error: infer E }\n  ? E\n  : never;\n\n/**\n * Extract cause type from Result\n */\nexport type ExtractCause<T> = T extends { ok: false; cause?: infer C }\n  ? C\n  : never;\n\n/**\n * Helper to extract the cause type from Result or AsyncResult return values.\n * Works even when a function is declared to return a union of both forms.\n */\ntype CauseOfReturn<R> = Extract<Awaited<R>, { ok: false }> extends { cause?: infer C }\n  ? C\n  : never;\n\n/**\n * Extract cause type from a function's return type\n */\nexport type CauseOf<T extends AnyFunction> = CauseOfReturn<ReturnType<T>>;\n\n// =============================================================================\n// Unwrap Utilities\n// =============================================================================\n\n/**\n * Error thrown when attempting to unwrap an Err result.\n */\nexport class UnwrapError extends Error {\n  public readonly error: unknown;\n  public readonly cause?: unknown;\n\n  constructor(result: Err<unknown, unknown>) {\n    const errorStr =\n      typeof result.error === \"string\"\n        ? result.error\n        : JSON.stringify(result.error);\n    super(`Attempted to unwrap an Err: ${errorStr}`);\n    this.name = \"UnwrapError\";\n    this.error = result.error;\n    this.cause = result.cause;\n  }\n}\n\n/**\n * Extracts the value from an Ok result, or throws UnwrapError if it's an Err.\n *\n * @remarks When to use: Only at boundaries or tests where a failure should be fatal.\n */\nexport const unwrap = <T, E, C>(r: Result<T, E, C>): T => {\n  if (r.ok) return r.value;\n  throw new UnwrapError(r);\n};\n\n/**\n * Extracts the value from an Ok result, or returns a default value if it's an Err.\n *\n * @remarks When to use: Provide a safe fallback without branching.\n */\nexport const unwrapOr = <T, E, C>(r: Result<T, E, C>, defaultValue: T): T =>\n  r.ok ? r.value : defaultValue;\n\n/**\n * Extracts the value from an Ok result, or calls a function to get a default value if it's an Err.\n *\n * @remarks When to use: Compute a fallback from the error (logging, metrics, or derived defaults).\n */\nexport const unwrapOrElse = <T, E, C>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => T\n): T => (r.ok ? r.value : fn(r.error, r.cause));\n\n/**\n * Alias for `unwrap`. Returns the success value or throws.\n *\n * The Result is already computed; use when you want the value or throw (e.g. at boundaries or in tests).\n *\n * @param r - The Result to unwrap\n * @returns The success value if the Result is successful\n * @throws {UnwrapError} If the Result is an error (includes the error and cause)\n */\nexport const runOrThrow = <T, E, C>(r: Result<T, E, C>): T => unwrap(r);\n\n/**\n * Awaits a Promise of a Result, then returns the success value or rejects.\n *\n * The returned promise **resolves with T** on success and **rejects with UnwrapError** on failure.\n * UnwrapError extends Error and carries the original `error` and `cause` from the Err.\n *\n * @param ar - A Promise or thenable that resolves to a Result\n * @returns A Promise that resolves with the success value or rejects with UnwrapError\n */\nexport const runOrThrowAsync = <T, E, C>(\n  ar: PromiseLike<Result<T, E, C>>\n): Promise<T> => Promise.resolve(ar).then(unwrap);\n\n/**\n * Convenience alias for `unwrapOr(r, null)`. Returns the success value or null.\n *\n * @param r - The Result to unwrap\n * @returns The success value if successful, otherwise null\n */\nexport const runOrNull = <T, E, C>(r: Result<T, E, C>): T | null =>\n  r.ok ? r.value : null;\n\n/**\n * Convenience alias for `unwrapOr(r, undefined)`. Returns the success value or undefined.\n *\n * @param r - The Result to unwrap\n * @returns The success value if successful, otherwise undefined\n */\nexport const runOrUndefined = <T, E, C>(r: Result<T, E, C>): T | undefined =>\n  r.ok ? r.value : undefined;\n\n// =============================================================================\n// Wrapping Functions\n// =============================================================================\n\n/**\n * Wraps a synchronous function that might throw into a Result.\n *\n * @remarks When to use: Wrap sync code that might throw so exceptions become Err values.\n */\nexport function from<T>(fn: () => T): Ok<T> | Err<unknown, unknown>;\nexport function from<T, E>(fn: () => T, onError: (cause: unknown) => E): Ok<T> | Err<E, unknown>;\nexport function from<T, E>(fn: () => T, onError?: (cause: unknown) => E) {\n  try {\n    return ok(fn());\n  } catch (cause) {\n    return onError ? err(onError(cause), { cause }) : err(cause);\n  }\n}\n\n/**\n * Wraps a Promise into a Result.\n *\n * @remarks When to use: Wrap a Promise and keep the raw rejection as Err; use tryAsync to map errors.\n */\nexport function fromPromise<T>(promise: Promise<T>): Promise<Ok<T> | Err<unknown, unknown>>;\nexport function fromPromise<T, E>(\n  promise: Promise<T>,\n  onError: (cause: unknown) => E\n): Promise<Ok<T> | Err<E, unknown>>;\nexport async function fromPromise<T, E>(\n  promise: Promise<T>,\n  onError?: (cause: unknown) => E\n): Promise<Ok<T> | Err<E | unknown, unknown>> {\n  try {\n    return ok(await promise);\n  } catch (cause) {\n    return onError ? err(onError(cause), { cause }) : err(cause);\n  }\n}\n\n/**\n * Wraps an async function that might throw into an AsyncResult.\n *\n * @remarks When to use: Wrap async work and map thrown/rejected values into your typed error union.\n */\nexport function tryAsync<T>(fn: () => Promise<T>): AsyncResult<T, unknown>;\nexport function tryAsync<T, E>(\n  fn: () => Promise<T>,\n  onError: (cause: unknown) => E\n): AsyncResult<T, E>;\nexport async function tryAsync<T, E>(\n  fn: () => Promise<T>,\n  onError?: (cause: unknown) => E\n): AsyncResult<T, E | unknown> {\n  try {\n    return ok(await fn());\n  } catch (cause) {\n    return onError ? err(onError(cause), { cause }) : err(cause);\n  }\n}\n\n/**\n * Converts a nullable value into a Result.\n *\n * @remarks When to use: Turn null/undefined into a typed error before continuing.\n */\nexport function fromNullable<T, E>(\n  value: T | null | undefined,\n  onNull: () => E\n): Result<T, E> {\n  return value != null ? ok(value) : err(onNull());\n}\n\n// =============================================================================\n// Transformers\n// =============================================================================\n\n/**\n * Transforms the value inside an Ok result.\n *\n * @remarks When to use: Transform only the Ok value while leaving Err untouched.\n */\nexport function map<T, U>(r: Ok<T>, fn: (value: T) => U): Ok<U>;\nexport function map<T, U, E, C>(r: Err<E, C>, fn: (value: T) => U): Err<E, C>;\nexport function map<T, U, E, C>(r: Result<T, E, C>, fn: (value: T) => U): Result<U, E, C>;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function map(r: any, fn: any): any {\n  return r.ok ? ok(fn(r.value)) : r;\n}\n\n/**\n * Transforms the error inside an Err result.\n *\n * @remarks When to use: Retype or normalize errors while leaving Ok values unchanged.\n */\nexport function mapError<T, E, F, C>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => F\n): Result<T, F, C> {\n  return r.ok ? r : err(fn(r.error, r.cause), { cause: r.cause });\n}\n\n/**\n * Pattern match on a Result.\n *\n * @remarks When to use: Handle both Ok and Err in a single expression that returns a value.\n */\n/**\n * The discriminant of an error value: the string itself for string-literal\n * errors, or the `type` field for tagged objects and TaggedError instances\n * (`_tag` accepted as a deprecated alias during migration).\n */\nexport type ErrorTypeOf<E> = E extends string\n  ? E\n  : E extends { type: infer K extends string }\n    ? K\n    : E extends { _tag: infer K extends string }\n      ? K\n      : never;\n\n/** Narrow an error union to the member(s) identified by a type string. */\nexport type ErrorByType<E, K extends string> = Extract<\n  E,\n  K | { type: K } | { _tag: K }\n>;\n\n/**\n * Exhaustive per-type match arms: one handler per member of the error\n * union, keyed by its type string, plus the `ok` arm. Each handler\n * receives the full narrowed error (string, tagged object, or TaggedError).\n */\nexport type MatchTypeHandlers<T, E, C, R> = { ok: (value: T) => R } & {\n  [K in ErrorTypeOf<E>]: (error: ErrorByType<E, K>, cause?: C) => R;\n};\n\n// Two-arm form (ok/err catch-all), curried and direct\nexport function match<T, E, C, R>(handlers: { ok: (value: T) => R; err: (error: E, cause?: C) => R }): (r: Result<T, E, C>) => R;\nexport function match<T, E, C, R>(r: Ok<T>, handlers: { ok: (value: T) => R; err: (error: E, cause?: C) => R }): R;\nexport function match<T, E, C, R>(r: Err<E, C>, handlers: { ok: (value: T) => R; err: (error: E, cause?: C) => R }): R;\nexport function match<T, E, C, R>(r: Result<T, E, C>, handlers: { ok: (value: T) => R; err: (error: E, cause?: C) => R }): R;\n// Exhaustive per-type form: match(result, { ok, USER_NOT_FOUND, CHARGE_DECLINED, ... })\nexport function match<T, E, C, R>(r: Result<T, E, C>, handlers: MatchTypeHandlers<T, E, C, R>): R;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function match(r: any, handlers?: any): any {\n  if (handlers === undefined) {\n    const h = r;\n    return (result: Result<unknown, unknown, unknown>) => match(result, h);\n  }\n  if (r.ok) return handlers.ok(r.value);\n  // Catch-all arm wins when present (the simple two-arm form)\n  if (typeof handlers.err === \"function\") return handlers.err(r.error, r.cause);\n  // Per-type dispatch: string errors match themselves; tagged errors match\n  // their `type` (or legacy `_tag`)\n  const e = r.error;\n  const key = typeof e === \"string\" ? e : (e?.type ?? e?._tag);\n  const handler = key === undefined ? undefined : handlers[key];\n  if (typeof handler === \"function\") return handler(e, r.cause);\n  throw new TypeError(\n    `match: no handler for error type \"${String(key)}\". ` +\n      `Add a handler for it, or use the { ok, err } form for a catch-all.`\n  );\n}\n\n/**\n * Chain Result-returning functions.\n *\n * @remarks When to use: Chain dependent operations that return Result without nested branching.\n */\nexport function andThen<T, U>(r: Ok<T>, fn: (value: T) => Ok<U>): Ok<U>;\nexport function andThen<T, F, C2>(r: Ok<T>, fn: (value: T) => Err<F, C2>): Err<F, C2>;\nexport function andThen<T, U, F, C2>(r: Ok<T>, fn: (value: T) => Result<U, F, C2>): Result<U, F, C2>;\nexport function andThen<T, U, E, F, C1, C2>(r: Err<E, C1>, fn: (value: T) => Result<U, F, C2>): Err<E, C1>;\nexport function andThen<T, U, E, F, C1, C2>(r: Result<T, E, C1>, fn: (value: T) => Result<U, F, C2>): Result<U, E | F, C1 | C2>;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function andThen(r: any, fn: any): any {\n  return r.ok ? fn(r.value) : r;\n}\n\n/**\n * Execute a side effect on Ok values.\n *\n * @remarks When to use: Add side effects (logging, metrics) on Ok without changing the Result.\n */\nexport function tap<T, E, C>(\n  r: Result<T, E, C>,\n  fn: (value: T) => void\n): Result<T, E, C> {\n  if (r.ok) fn(r.value);\n  return r;\n}\n\n/**\n * Execute a side effect on Err values.\n *\n * @remarks When to use: Add side effects (logging, metrics) on Err without changing the Result.\n */\nexport function tapError<T, E, C>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => void\n): Result<T, E, C> {\n  if (!r.ok) fn(r.error, r.cause);\n  return r;\n}\n\n/**\n * Transform value with a function that might throw.\n *\n * @remarks When to use: Transform Ok values with a function that might throw and capture the failure.\n */\nexport function mapTry<T, U, E, F, C>(\n  r: Result<T, E, C>,\n  fn: (value: T) => U,\n  onError: (thrown: unknown) => F\n): Result<U, E | F, C | unknown> {\n  if (!r.ok) return r;\n  try {\n    return ok(fn(r.value));\n  } catch (error) {\n    return err(onError(error), { cause: error });\n  }\n}\n\n/**\n * Transform error with a function that might throw.\n *\n * @remarks When to use: Transform errors when the mapping might throw and you want that captured.\n */\nexport function mapErrorTry<T, E, F, G, C>(\n  r: Result<T, E, C>,\n  fn: (error: E) => F,\n  onError: (thrown: unknown) => G\n): Result<T, F | G, C | unknown> {\n  if (r.ok) return r;\n  try {\n    return err(fn(r.error), { cause: r.cause });\n  } catch (error) {\n    return err(onError(error), { cause: error });\n  }\n}\n\n/**\n * Transform both value and error.\n */\nexport function bimap<T, U, E, F, C>(\n  r: Result<T, E, C>,\n  onOk: (value: T) => U,\n  onErr: (error: E, cause?: C) => F\n): Result<U, F, C> {\n  return r.ok ? ok(onOk(r.value)) : err(onErr(r.error, r.cause), { cause: r.cause });\n}\n\n/**\n * Provide an alternative Result if the first is an Err.\n *\n * @remarks When to use: Recover from Err by returning a fallback Result or retyping the error.\n */\nexport function orElse<T, E, E2, C, C2>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => Result<T, E2, C2>\n): Result<T, E2, C | C2> {\n  return r.ok ? r : fn(r.error, r.cause);\n}\n\n/**\n * Async version of orElse.\n */\nexport async function orElseAsync<T, E, E2, C, C2>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => Promise<Result<T, E2, C2>>\n): Promise<Result<T, E2, C | C2>> {\n  return r.ok ? r : fn(r.error, r.cause);\n}\n\n/**\n * Recover from errors - always returns Ok<T>.\n */\nexport function recover<T, E, C>(\n  r: Result<T, E, C>,\n  fn: (error: E, cause?: C) => T\n): Ok<T> {\n  return r.ok ? ok(r.value) : ok(fn(r.error, r.cause));\n}\n\n/**\n * Async version of recover - always returns Promise<Ok<T>>.\n */\nexport async function recoverAsync<T, E, C>(\n  r: Result<T, E, C> | Promise<Result<T, E, C>>,\n  fn: (error: E, cause?: C) => T | Promise<T>\n): Promise<Ok<T>> {\n  const resolved = await r;\n  if (resolved.ok) return ok(resolved.value);\n  return ok(await fn(resolved.error, resolved.cause));\n}\n\n// =============================================================================\n// Result Hydration (Serialization)\n// =============================================================================\n\n/**\n * Hydrate a serialized Result back into a proper Result object.\n */\nexport function hydrate<T, E, C = unknown>(value: unknown): Result<T, E, C> | null {\n  if (typeof value !== \"object\" || value === null) return null;\n  if (!(\"ok\" in value)) return null;\n\n  const obj = value as Record<string, unknown>;\n  if (obj.ok === true && \"value\" in obj) {\n    return ok(obj.value as T);\n  }\n  if (obj.ok === false && \"error\" in obj) {\n    return err(obj.error as E, { cause: obj.cause as C });\n  }\n  return null;\n}\n\n/**\n * Type guard to check if a value is a serialized Result.\n */\nexport function isSerializedResult(\n  value: unknown\n): value is { ok: boolean; value?: unknown; error?: unknown; cause?: unknown } {\n  if (typeof value !== \"object\" || value === null) return false;\n  if (!(\"ok\" in value)) return false;\n  const obj = value as Record<string, unknown>;\n  return (\n    (obj.ok === true && \"value\" in obj) ||\n    (obj.ok === false && \"error\" in obj)\n  );\n}\n\n// =============================================================================\n// Batch Operations\n// =============================================================================\n\ntype AllValues<T extends readonly Result<unknown, unknown, unknown>[]> = {\n  [K in keyof T]: T[K] extends Ok<infer V>\n    ? V\n    : T[K] extends Err<unknown, unknown>\n      ? never\n      : T[K] extends Result<infer V, unknown, unknown>\n        ? V\n        : never;\n};\ntype AllErrors<T extends readonly Result<unknown, unknown, unknown>[]> = {\n  [K in keyof T]: T[K] extends Ok<unknown>\n    ? never\n    : T[K] extends Err<infer E, unknown>\n      ? E\n      : T[K] extends Result<unknown, infer E, unknown>\n        ? E\n        : never;\n}[number];\ntype AllCauses<T extends readonly Result<unknown, unknown, unknown>[]> = {\n  [K in keyof T]: T[K] extends Ok<unknown>\n    ? never\n    : T[K] extends Err<unknown, infer C>\n      ? C\n      : T[K] extends Result<unknown, unknown, infer C>\n        ? C\n        : never;\n}[number];\n\n// Conditional type: returns Ok<...> when there are no errors, Result<...> otherwise\n// Note: We only check AllErrors, not AllCauses - causes only matter when there are errors\ntype AllResult<T extends readonly Result<unknown, unknown, unknown>[]> =\n  [AllErrors<T>] extends [never]\n    ? Ok<AllValues<T>>\n    : Result<AllValues<T>, AllErrors<T>, AllCauses<T>>;\n\n/**\n * Combines multiple Results into a single Result containing an array of values.\n * Returns the first Err encountered, or Ok with all values.\n */\nexport function all<const T extends readonly Result<unknown, unknown, unknown>[]>(\n  results: T\n): AllResult<T> {\n  const values: unknown[] = [];\n  for (const result of results) {\n    if (!result.ok) {\n      return result as unknown as AllResult<T>;\n    }\n    values.push(result.value);\n  }\n  return ok(values) as AllResult<T>;\n}\n\n/**\n * Async version of all - works with Promises of Results.\n */\nexport async function allAsync<\n  const T extends readonly (Result<unknown, unknown, unknown> | Promise<Result<unknown, unknown, unknown>>)[]\n>(\n  results: T\n): Promise<\n  Result<\n    { [K in keyof T]: T[K] extends Result<infer V, unknown, unknown> | Promise<Result<infer V, unknown, unknown>> ? V : never },\n    | { [K in keyof T]: T[K] extends Result<unknown, infer E, unknown> | Promise<Result<unknown, infer E, unknown>> ? E : never }[number]\n    | PromiseRejectedError,\n    | { [K in keyof T]: T[K] extends Result<unknown, unknown, infer C> | Promise<Result<unknown, unknown, infer C>> ? C : never }[number]\n    | PromiseRejectionCause\n  >\n> {\n  const values: unknown[] = [];\n  for (const resultOrPromise of results) {\n    try {\n      const r = await resultOrPromise;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      if (!r.ok) return r as any;\n      values.push(r.value);\n    } catch (reason) {\n      return err(\n        { type: PROMISE_REJECTED, cause: reason } as PromiseRejectedError,\n        { cause: { type: \"PROMISE_REJECTION\", reason } as PromiseRejectionCause }\n      );\n    }\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return ok(values) as any;\n}\n\nexport type SettledError<E, C = unknown> = { error: E; cause?: C };\n\n// Conditional type: returns Ok<...> when there are no errors, Result<...> otherwise\ntype AllSettledResult<T extends readonly Result<unknown, unknown, unknown>[]> =\n  [AllErrors<T>] extends [never]\n    ? Ok<AllValues<T>>\n    : Result<AllValues<T>, SettledError<AllErrors<T>, AllCauses<T>>[]>;\n\n/**\n * Collects all Results, returning Ok with values if all succeed,\n * or Err with array of errors if any fail.\n */\nexport function allSettled<const T extends readonly Result<unknown, unknown, unknown>[]>(\n  results: T\n): AllSettledResult<T> {\n  const values: unknown[] = [];\n  const errors: SettledError<unknown>[] = [];\n\n  for (const result of results) {\n    if (result.ok) {\n      values.push(result.value);\n    } else {\n      errors.push({ error: result.error, cause: result.cause });\n    }\n  }\n\n  if (errors.length > 0) {\n    return err(errors) as unknown as AllSettledResult<T>;\n  }\n\n  return ok(values) as unknown as AllSettledResult<T>;\n}\n\n/**\n * Async version of allSettled.\n */\nexport async function allSettledAsync<\n  const T extends readonly (Result<unknown, unknown, unknown> | Promise<Result<unknown, unknown, unknown>>)[]\n>(\n  results: T\n): Promise<\n  Result<\n    { [K in keyof T]: T[K] extends Result<infer V, unknown, unknown> | Promise<Result<infer V, unknown, unknown>> ? V : never },\n    SettledError<\n      | { [K in keyof T]: T[K] extends Result<unknown, infer E, unknown> | Promise<Result<unknown, infer E, unknown>> ? E : never }[number]\n      | PromiseRejectedError,\n      | { [K in keyof T]: T[K] extends Result<unknown, unknown, infer C> | Promise<Result<unknown, unknown, infer C>> ? C : never }[number]\n      | PromiseRejectionCause\n    >[]\n  >\n> {\n  const settled = await Promise.all(\n    results.map((item) =>\n      Promise.resolve(item)\n        .then((result) => ({ status: \"result\" as const, result }))\n        .catch((reason) => ({\n          status: \"rejected\" as const,\n          error: { type: PROMISE_REJECTED, cause: reason } as PromiseRejectedError,\n          cause: { type: \"PROMISE_REJECTION\", reason } as PromiseRejectionCause,\n        }))\n    )\n  );\n\n  const values: unknown[] = [];\n  const errors: SettledError<unknown, unknown>[] = [];\n\n  for (const item of settled) {\n    if (item.status === \"rejected\") {\n      errors.push({ error: item.error, cause: item.cause });\n    } else if (item.result.ok) {\n      values.push(item.result.value);\n    } else {\n      errors.push({ error: item.result.error, cause: item.result.cause });\n    }\n  }\n\n  if (errors.length > 0) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return err(errors) as any;\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return ok(values) as any;\n}\n\n/**\n * Partitions Results into { values, errors }.\n */\nexport function partition<T, E, C>(\n  results: readonly Result<T, E, C>[]\n): { values: T[]; errors: E[] } {\n  const values: T[] = [];\n  const errors: E[] = [];\n  for (const r of results) {\n    if (r.ok) values.push(r.value);\n    else errors.push(r.error);\n  }\n  return { values, errors };\n}\n\n/**\n * Returns the first Ok result, or an EmptyInputError/first Err if all fail.\n */\nexport function any<const T extends readonly Result<unknown, unknown, unknown>[]>(\n  results: T\n): T extends readonly []\n  ? Err<EmptyInputError, unknown>\n  : Result<\n      { [K in keyof T]: T[K] extends Result<infer V, unknown, unknown> ? V : never }[number],\n      AllErrors<T> | EmptyInputError,\n      AllCauses<T>\n    >;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function any(results: any): any {\n  if (results.length === 0) {\n    return err({ type: \"EMPTY_INPUT\", message: \"any() requires at least one Result\" });\n  }\n  let firstErr: Err<unknown, unknown> | undefined;\n  for (const r of results) {\n    if (r.ok) return r;\n    if (!firstErr) firstErr = r;\n  }\n  return firstErr;\n}\n\n/**\n * Async version of any - races promises and returns first success.\n */\nexport async function anyAsync<\n  const T extends readonly (Result<unknown, unknown, unknown> | Promise<Result<unknown, unknown, unknown>>)[]\n>(\n  results: T\n): Promise<\n  T extends readonly []\n    ? Err<EmptyInputError, unknown>\n    : Result<\n        { [K in keyof T]: T[K] extends Result<infer V, unknown, unknown> | Promise<Result<infer V, unknown, unknown>> ? V : never }[number],\n        | { [K in keyof T]: T[K] extends Result<unknown, infer E, unknown> | Promise<Result<unknown, infer E, unknown>> ? E : never }[number]\n        | EmptyInputError\n        | PromiseRejectedError,\n        | { [K in keyof T]: T[K] extends Result<unknown, unknown, infer C> | Promise<Result<unknown, unknown, infer C>> ? C : never }[number]\n        | PromiseRejectionCause\n      >\n> {\n  if (results.length === 0) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return err({ type: \"EMPTY_INPUT\", message: \"anyAsync() requires at least one Result\" }) as any;\n  }\n\n  return new Promise((resolve) => {\n    let settled = false;\n    let pendingCount = results.length;\n    let firstError: Err<unknown, unknown> | null = null;\n\n    for (const item of results) {\n      Promise.resolve(item)\n        .catch((reason) =>\n          err(\n            { type: PROMISE_REJECTED, cause: reason } as PromiseRejectedError,\n            { cause: { type: \"PROMISE_REJECTION\", reason } as PromiseRejectionCause }\n          )\n        )\n        .then((result) => {\n          if (settled) return;\n\n          if (result.ok) {\n            settled = true;\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            resolve(result as any);\n            return;\n          }\n\n          if (!firstError) firstError = result;\n          pendingCount--;\n\n          if (pendingCount === 0) {\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            resolve(firstError as any);\n          }\n        });\n    }\n  });\n}\n\n/**\n * Combines exactly two Results into a tuple.\n */\nexport function zip<A, EA, CA, B, EB, CB>(\n  a: Result<A, EA, CA>,\n  b: Result<B, EB, CB>\n): Result<[A, B], EA | EB, CA | CB> {\n  if (!a.ok) return a;\n  if (!b.ok) return b;\n  return ok([a.value, b.value]);\n}\n\n/**\n * Async version of zip.\n */\nexport async function zipAsync<A, EA, CA, B, EB, CB>(\n  a: Result<A, EA, CA> | Promise<Result<A, EA, CA>>,\n  b: Result<B, EB, CB> | Promise<Result<B, EB, CB>>\n): Promise<Result<[A, B], EA | EB | PromiseRejectedError, CA | CB | PromiseRejectionCause>> {\n  // Wrap rejections into PromiseRejectedError (consistent with allAsync)\n  const wrapRejection = <T, E, C>(\n    p: Result<T, E, C> | Promise<Result<T, E, C>>\n  ): Promise<Result<T, E | PromiseRejectedError, C | PromiseRejectionCause>> =>\n    Promise.resolve(p).catch((reason) =>\n      err(\n        { type: PROMISE_REJECTED, cause: reason } as PromiseRejectedError,\n        { cause: { type: \"PROMISE_REJECTION\", reason } as PromiseRejectionCause }\n      )\n    );\n\n  const [ra, rb] = await Promise.all([wrapRejection(a), wrapRejection(b)]);\n  return zip(ra, rb);\n}\n\n// =============================================================================\n// Flatten\n// =============================================================================\n\n/**\n * Flattens a nested Result into a single Result.\n *\n * @remarks When to use: Unwrap a Result<Result<T, E1>, E2> into Result<T, E1 | E2> after an operation that returns nested Results.\n */\nexport function flatten<T, E1, C1, E2, C2>(\n  result: Result<Result<T, E1, C1>, E2, C2>\n): Result<T, E1 | E2, C1 | C2> {\n  if (!result.ok) return result as Err<E2, C2>;\n  return result.value;\n}\n\n// =============================================================================\n// Deserialization (improved hydrate)\n// =============================================================================\n\n/** Discriminant for deserialization errors */\nexport const DESERIALIZATION_ERROR = \"DESERIALIZATION_ERROR\" as const;\n\n/** Error type returned when deserialize() receives invalid input */\nexport type DeserializationError = { type: typeof DESERIALIZATION_ERROR; value: unknown };\n\n/**\n * Deserialize a value back into a Result.\n * Returns a typed DeserializationError on invalid input instead of null.\n *\n * @remarks When to use: Rehydrate Results from JSON, RPC, or server actions with type-safe error handling.\n */\nexport function deserialize<T, E, C = unknown>(\n  value: unknown\n): Result<T, E | DeserializationError, C> {\n  if (typeof value !== \"object\" || value === null) {\n    return err({ type: DESERIALIZATION_ERROR, value } as DeserializationError);\n  }\n  if (!(\"ok\" in value)) {\n    return err({ type: DESERIALIZATION_ERROR, value } as DeserializationError);\n  }\n\n  const obj = value as Record<string, unknown>;\n  if (obj.ok === true && \"value\" in obj) {\n    return ok(obj.value as T);\n  }\n  if (obj.ok === false && \"error\" in obj) {\n    return err(obj.error as E, { cause: obj.cause as C });\n  }\n  return err({ type: DESERIALIZATION_ERROR, value } as DeserializationError);\n}\n\n// =============================================================================\n// Serialization\n// =============================================================================\n\n/** A plain serialized form of a Result, safe to JSON.stringify. */\nexport type SerializedResult<T, E> = { ok: true; value: T } | { ok: false; error: E };\n\n/**\n * Serialize a Result to a plain object (inverse of `deserialize`).\n * Strips cause — safe for JSON.stringify, RPC, and server actions.\n *\n * @remarks When to use: Sending Results over the wire or storing them in JSON.\n */\nexport function serialize<T, E>(result: Result<T, E>): SerializedResult<T, E> {\n  return result.ok\n    ? { ok: true, value: result.value }\n    : { ok: false, error: result.error };\n}\n\n// =============================================================================\n// Partial error matching\n// =============================================================================\n\n/**\n * Non-exhaustive error match — handle the errors you care about; let the rest fall through to fallback.\n *\n * @example\n * ```typescript\n * const message = matchErrorPartial(\n *   error,\n *   { NOT_FOUND: () => 'Resource not found' },\n *   (e) => `Unexpected: ${e}`\n * );\n * ```\n */\nexport function matchErrorPartial<E extends string, R>(\n  error: E | UnexpectedError,\n  handlers: Partial<MatchErrorHandlers<E, R>>,\n  fallback: (error: E | UnexpectedError) => R\n): R {\n  if (isUnexpectedError(error)) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const h = (handlers as any).UnexpectedError as ((e: UnexpectedError) => R) | undefined;\n    return h ? h(error) : fallback(error);\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const h = (handlers as any)[error as string] as ((e: E) => R) | undefined;\n  return h ? h(error as E) : fallback(error);\n}\n\n// Retry helpers live in ./retry as internal building blocks and are\n// intentionally NOT re-exported here (keeps awaitly/result minimal).\n// The public retry surface is the `retry` policy on the root `awaitly` entry.\n"],"mappings":"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","names":["TaggedError","match","h"]}