@nicolastoulemont/std 0.8.2 → 0.9.0

package/README.md

@@ -426,7 +426,7 @@ const badgeLabel = (state: OrderState) =>
 ### Data
 
 Data creates immutable structural value objects with stable equality and hashing semantics.
-Use it when you want value semantics for tuples, arrays, tagged records, or custom error types.
+Use it when you want value semantics for tuples, arrays, tagged records, custom error types, or schema-backed entities.
 
 #### Abstract Example
 
@@ -439,6 +439,8 @@ const b = Data.struct({ env: "prod", retries: 3 })
 const same = a.equals(b) // true
 ```
 
+`Data.entity` is the validated counterpart to `Data.struct`: it validates through a sync Standard Schema, then wraps the validated object as a structural value.
+
 #### Real-World Example
 
 ```ts
@@ -452,6 +454,25 @@ if (previous.equals(next)) {
 }
 ```
 
+```ts
+import { Data } from "@nicolastoulemont/std"
+import { z } from "zod"
+
+const Folder = Data.entity(
+  z.object({
+    id: z.string(),
+    name: z.string(),
+    archived: z.boolean().default(false),
+  }),
+)
+
+const created = Folder({ id: "folder_1", name: "Inbox" })
+
+if (created._tag === "Ok") {
+  created.value.equals({ id: "folder_1", name: "Inbox", archived: false })
+}
+```
+
 ### Order
 
 Order provides composable comparators and immutable sorting helpers.
@@ -648,6 +669,8 @@ const readPort = Fx.gen(function* () {
 const exit = Fx.run(Provide.service(Port, 3000)(readPort))
 ```
 
+Use `Provide.layers(...)` when you want the ergonomics of `Provide.layer(Layer.merge(...))` without the extra nesting.
+
 #### Real-World Example
 
 ```ts

package/dist/adt/index.d.mts

@@ -1,2 +1,2 @@
-import { t as adt_d_exports } from "../index-C6W3_n_Q.mjs";
+import { t as adt_d_exports } from "../index-BaRJVkLo.mjs";
 export { adt_d_exports as Adt };

package/dist/adt/index.mjs

@@ -1 +1 @@
-import{t as e}from"../adt-CPG_sa8q.mjs";export{e as Adt};
+import{t as e}from"../adt-CY8wLJJI.mjs";export{e as Adt};

package/dist/adt-CY8wLJJI.mjs

@@ -0,0 +1,2 @@
+import{t as e}from"./chunk-oQKkju2G.mjs";import{a as t,i as n,n as r,r as i,t as a}from"./is-plain-object-BoFjRafL.mjs";import{i as o,t as s}from"./result-D3VY0qBG.mjs";import{r as c}from"./schema.shared-Bjyroa6b.mjs";function l(e,t){let n=t[e._tag];return n(e)}function u(e){return typeof e==`function`&&`_variant`in e&&e._variant===!0}function d(e,t,n){return c(e,t,`ADT variant "${n}"`)}function f(e){return t=>a(t)&&`_tag`in t&&t._tag===e}function p(e){let t=new Set(e);return e=>a(e)&&`_tag`in e&&typeof e._tag==`string`&&t.has(e._tag)}function m(e,t,n,r){return n!==void 0&&r!==void 0?{kind:e,message:t,cause:n,validationIssues:r}:n===void 0?r===void 0?{kind:e,message:t}:{kind:e,message:t,validationIssues:r}:{kind:e,message:t,cause:n}}function h(e){return{to:e=>JSON.stringify(e),from:e=>{try{let t=JSON.parse(e);if(typeof t==`object`&&t&&`_tag`in t){let{_tag:e,...n}=t;return n}return t}catch{return null}}}}function g(e,t,n){let r=h(e),i={json:n=>{let i=d(t,{...n,_tag:e},e);if(i._tag===`Err`)return s(m(`ValidationError`,`Cannot encode invalid data: ${i.error.issues.map(e=>e.message).join(`, `)}`,void 0,i.error.issues));try{return o(r.to(i.value))}catch(e){return s(m(`EncodingError`,`JSON encoding failed: ${e instanceof Error?e.message:String(e)}`,e))}}};if(n)for(let[r,a]of Object.entries(n))i[r]=n=>{let i=d(t,{...n,_tag:e},e);if(i._tag===`Err`)return s(m(`ValidationError`,`Cannot encode invalid data: ${i.error.issues.map(e=>e.message).join(`, `)}`,void 0,i.error.issues));try{return o(a.to(i.value))}catch(e){return s(m(`EncodingError`,`Encoding with codec '${r}' failed: ${e instanceof Error?e.message:String(e)}`,e))}};return i}function _(e,t,n){let r=h(e),i={json:n=>{let i=r.from(n);if(i===null)return s(m(`DecodingError`,`Invalid JSON format`));let a=d(t,{...i,_tag:e},e);return a._tag===`Err`?s(m(`ValidationError`,`Decoded data failed schema validation`,void 0,a.error.issues)):o({...a.value,_tag:e})}};if(n)for(let[r,a]of Object.entries(n))i[r]=n=>{let i;try{i=a.from(n)}catch(e){return s(m(`DecodingError`,`Decoding with codec '${r}' threw an error`,e))}if(i===null)return s(m(`DecodingError`,`Codec '${r}' failed to decode input`));let c=d(t,{...i,_tag:e},e);return c._tag===`Err`?s(m(`ValidationError`,`Decoded data failed schema validation`,void 0,c.error.issues)):o({...c.value,_tag:e})};return i}function v(e,r,i){let a=f(e),c=g(e,r,i),l=_(e,r,i),u=n(e),p=t(e),m=t=>{let n=d(r,{...t,_tag:e},e);return n._tag===`Err`?s(n.error):o({...n.value,_tag:e})};return m._variant=!0,m._tag=e,m.schema=r,i&&(m.codecs=i),m.is=a,m.to=c,m.from=l,m.equals=u,m.hash=p,m}function y(e,t){let n=Object.keys(t),a={};for(let[e,n]of Object.entries(t))u(n)?n._tag===e?a[e]=n:n.codecs?a[e]=v(e,n.schema,n.codecs):a[e]=v(e,n.schema):a[e]=v(e,n);return{_name:e,is:p(n),equals:r(n),hash:i(n),...a}}var b=e({match:()=>C,union:()=>x,variant:()=>S});const x=y,S=v,C=l;export{b as t};
+//# sourceMappingURL=adt-CY8wLJJI.mjs.map

package/dist/adt-CY8wLJJI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"adt-CY8wLJJI.mjs","names":["match","validateSchemaSync","variant","union","variant","unionImpl","variantImpl","matchImpl"],"sources":["../src/adt/adt.match.ts","../src/adt/adt.utils.ts","../src/adt/adt.codec.ts","../src/adt/adt.variant.ts","../src/adt/adt.union.ts","../src/adt/adt.ts"],"sourcesContent":["/**\n * Handler functions for each variant in a discriminated union.\n * Each key maps to a function that receives the variant value and returns TResult.\n *\n * @template T - The discriminated union type (must have readonly _tag)\n * @template TResult - The return type of all handlers\n */\ntype AdtMatchHandlers<T extends { readonly _tag: string }, TResult> = {\n  [K in T[\"_tag\"]]: (value: Extract<T, { readonly _tag: K }>) => TResult\n}\n\n/**\n * Exhaustive pattern matching for discriminated unions.\n *\n * TypeScript will error if any variant is missing from handlers,\n * ensuring exhaustive handling of all cases.\n *\n * @template T - The discriminated union type (must have readonly _tag)\n * @template TResult - The return type of all handlers\n * @template Handlers - The handler object type (inferred)\n * @param value - A discriminated union value with _tag\n * @param handlers - An object with a handler function for each variant\n * @returns The result of calling the matching handler\n *\n * @see {@link union} for creating discriminated unions\n * @see {@link variant} for creating individual variant types\n *\n * @example\n * ```ts\n * import { Adt } from \"@nicolastoulemont/std\"\n * import { z } from \"zod\"\n *\n * // Adt accepts any Standard Schema-compatible schema, such as zod, valibot, or arktype.\n * const Circle = Adt.variant(\"Circle\", z.object({ radius: z.number() }))\n * const Square = Adt.variant(\"Square\", z.object({ size: z.number() }))\n * const Shape = Adt.union(\"Shape\", { Circle, Square })\n * type Shape = Adt.Infer<typeof Shape>\n *\n * function describeShape(shape: Shape): string {\n *   return Adt.match(shape, {\n *     Circle: (c) => `Circle with radius ${c.radius}`,\n *     Square: (s) => `Square with size ${s.size}`,\n *   })\n * }\n * ```\n */\nexport function match<\n  T extends { readonly _tag: string },\n  TResult,\n  Handlers extends AdtMatchHandlers<T, TResult> = AdtMatchHandlers<T, TResult>,\n>(value: T, handlers: Handlers): TResult {\n  const tag = value._tag as keyof Handlers\n  const handler = handlers[tag]\n  // oxlint-disable-next-line no-explicit-any, no-unsafe-argument, no-unsafe-type-assertion -- Required for variant dispatch\n  return handler(value as any)\n}\n","import { validateSync as validateSchemaSync } from \"../schema/schema.shared\"\nimport { isPlainObject } from \"../shared/is-plain-object\"\nimport type { AdtVariant } from \"./adt.types\"\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\"\n\n/**\n * Check if a value is an AdtVariant created by variant().\n * AdtVariants are callable functions with static properties.\n */\nexport function isVariant(value: unknown): value is AdtVariant {\n  return typeof value === \"function\" && \"_variant\" in value && value[\"_variant\"] === true\n}\n\n/**\n * Validate data using a Standard Schema, enforcing sync-only validation.\n * Throws if the schema returns a Promise.\n */\nexport function validateSync<T>(schema: StandardSchemaV1<unknown, T>, data: unknown, _tag: string) {\n  return validateSchemaSync(schema, data, `ADT variant \"${_tag}\"`)\n}\n\n/**\n * Create a type guard function for a specific _tag.\n */\nexport function createIsGuard<Tag extends string, T>(\n  _tag: Tag,\n): (value: unknown) => value is T & { readonly _tag: Tag } {\n  return (value: unknown): value is T & { readonly _tag: Tag } => {\n    return isPlainObject(value) && \"_tag\" in value && value[\"_tag\"] === _tag\n  }\n}\n\n/**\n * Create a type guard function for multiple _tags (AdtUnion root guard).\n */\nexport function createIsAnyGuard<T>(_tags: readonly string[]): (value: unknown) => value is T {\n  const _tagSet = new Set(_tags)\n  return (value: unknown): value is T => {\n    return isPlainObject(value) && \"_tag\" in value && typeof value[\"_tag\"] === \"string\" && _tagSet.has(value[\"_tag\"])\n  }\n}\n","import { ok, err } from \"../result/result\"\nimport type { Result } from \"../result/result.types\"\nimport type { ValidationError } from \"../schema/schema.types\"\nimport type { Discriminator } from \"../shared/discriminator.types\"\nimport type {\n  AdtCodecConstraint,\n  AdtCodecDef,\n  AdtCodecError,\n  AdtInferInput,\n  AdtInferOutput,\n  ToMethods,\n  FromMethods,\n} from \"./adt.types\"\nimport { validateSync } from \"./adt.utils\"\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\"\n\n/**\n * Create a AdtCodecError with consistent structure.\n */\nfunction createCodecError(\n  kind: AdtCodecError[\"kind\"],\n  message: string,\n  cause?: unknown,\n  validationIssues?: ValidationError[\"issues\"],\n): AdtCodecError {\n  if (cause !== undefined && validationIssues !== undefined) {\n    return { kind, message, cause, validationIssues }\n  }\n  if (cause !== undefined) {\n    return { kind, message, cause }\n  }\n  if (validationIssues !== undefined) {\n    return { kind, message, validationIssues }\n  }\n  return { kind, message }\n}\n\n/**\n * Built-in JSON codec that works with any schema.\n * Encodes to JSON string and decodes with JSON.parse.\n */\nfunction createJsonCodec<Tag extends string, S extends StandardSchemaV1>(\n  _tag: Tag,\n): AdtCodecDef<AdtInferOutput<S> & Discriminator<Tag>, string, AdtInferInput<S>> {\n  return {\n    to: (value) => {\n      // JSON.stringify can throw for circular references, BigInt, etc.\n      // We let it throw and catch it in the wrapper\n      return JSON.stringify(value)\n    },\n    /* oxlint-disable no-unsafe-assignment, no-unsafe-type-assertion, no-unsafe-return -- Required for JSON parsing which returns unknown types */\n    from: (input: string) => {\n      try {\n        const parsed = JSON.parse(input)\n        // Return parsed object without _tag - it will be added during validation\n        if (typeof parsed === \"object\" && parsed !== null && \"_tag\" in parsed) {\n          const { _tag: _, ...rest } = parsed\n          return rest as AdtInferInput<S>\n        }\n        return parsed\n      } catch {\n        return null\n      }\n    },\n    /* oxlint-enable no-unsafe-assignment, no-unsafe-type-assertion, no-unsafe-return */\n  }\n}\n\n/**\n * Create the \"to\" methods object with JSON codec and custom codecs.\n * All methods return Result<T, AdtCodecError> for consistent error handling.\n */\nexport function createToMethods<\n  Tag extends string,\n  S extends StandardSchemaV1,\n  Codecs extends AdtCodecConstraint<Tag, S> | undefined = undefined,\n>(_tag: Tag, schema: S, customCodecs?: Codecs): ToMethods<S, Codecs> {\n  type Output = AdtInferOutput<S> & Discriminator<Tag>\n\n  const jsonCodec = createJsonCodec<Tag, S>(_tag)\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const to: Record<string, (value: AdtInferInput<S>) => Result<any, AdtCodecError>> = {\n    json: (value: AdtInferInput<S>): Result<string, AdtCodecError> => {\n      // First, create a validated variant to ensure the encoded payload is well-typed.\n      // oxlint-disable-next-line no-unsafe-type-assertion -- Required for spreading generic input into object\n      const taggedInput = { ...(value as object), _tag }\n      const result = validateSync(schema, taggedInput, _tag)\n\n      if (result._tag === \"Err\") {\n        return err(\n          createCodecError(\n            \"ValidationError\",\n            `Cannot encode invalid data: ${result.error.issues.map((i) => i.message).join(\", \")}`,\n            undefined,\n            result.error.issues,\n          ),\n        )\n      }\n\n      try {\n        // oxlint-disable-next-line no-unsafe-type-assertion -- Required for validated value cast\n        return ok(jsonCodec.to(result.value as Output))\n      } catch (e) {\n        return err(\n          createCodecError(\"EncodingError\", `JSON encoding failed: ${e instanceof Error ? e.message : String(e)}`, e),\n        )\n      }\n    },\n  }\n\n  // Add custom codecs\n  if (customCodecs) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    for (const [name, codec] of Object.entries(customCodecs) as Array<[string, AdtCodecDef<Output, any, any>]>) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      to[name] = (value: AdtInferInput<S>): Result<any, AdtCodecError> => {\n        // Validate input first\n        // oxlint-disable-next-line no-unsafe-type-assertion -- Required for spreading generic input\n        const taggedInput = { ...(value as object), _tag }\n        const result = validateSync(schema, taggedInput, _tag)\n\n        if (result._tag === \"Err\") {\n          return err(\n            createCodecError(\n              \"ValidationError\",\n              `Cannot encode invalid data: ${result.error.issues.map((i) => i.message).join(\", \")}`,\n              undefined,\n              result.error.issues,\n            ),\n          )\n        }\n\n        try {\n          // oxlint-disable-next-line no-unsafe-type-assertion -- Required for validated value cast\n          return ok(codec.to(result.value as Output))\n        } catch (e) {\n          return err(\n            createCodecError(\n              \"EncodingError\",\n              `Encoding with codec '${name}' failed: ${e instanceof Error ? e.message : String(e)}`,\n              e,\n            ),\n          )\n        }\n      }\n    }\n  }\n\n  // oxlint-disable-next-line no-unsafe-type-assertion -- Required for generic return type\n  return to as ToMethods<S, Codecs>\n}\n\n/**\n * Create the \"from\" methods object with JSON codec and custom codecs.\n * All methods return Result<T, AdtCodecError> for consistent error handling.\n */\nexport function createFromMethods<\n  Tag extends string,\n  S extends StandardSchemaV1,\n  Codecs extends AdtCodecConstraint<Tag, S> | undefined = undefined,\n>(_tag: Tag, schema: S, customCodecs?: Codecs): FromMethods<Tag, S, Codecs> {\n  type Output = AdtInferOutput<S> & Discriminator<Tag>\n\n  const jsonCodec = createJsonCodec<Tag, S>(_tag)\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const from: Record<string, (input: any) => Result<Output, AdtCodecError>> = {\n    json: (input: string): Result<Output, AdtCodecError> => {\n      // Decode\n      const decoded = jsonCodec.from(input)\n      if (decoded === null) {\n        return err(createCodecError(\"DecodingError\", \"Invalid JSON format\"))\n      }\n\n      // Validate through schema\n      // oxlint-disable-next-line no-unsafe-type-assertion -- Required for spreading decoded value\n      const taggedInput = { ...(decoded as object), _tag }\n      const result = validateSync(schema, taggedInput, _tag)\n\n      if (result._tag === \"Err\") {\n        return err(\n          createCodecError(\"ValidationError\", \"Decoded data failed schema validation\", undefined, result.error.issues),\n        )\n      }\n\n      // Ensure _tag in output\n      // oxlint-disable-next-line no-unsafe-type-assertion -- Required for output construction\n      const output = { ...(result.value as object), _tag } as Output\n      return ok(output)\n    },\n  }\n\n  // Add custom codecs\n  if (customCodecs) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    for (const [name, codec] of Object.entries(customCodecs) as Array<[string, AdtCodecDef<Output, any, any>]>) {\n      from[name] = (input: unknown): Result<Output, AdtCodecError> => {\n        // Decode\n        let decoded: unknown\n        try {\n          decoded = codec.from(input)\n        } catch (e) {\n          return err(createCodecError(\"DecodingError\", `Decoding with codec '${name}' threw an error`, e))\n        }\n\n        if (decoded === null) {\n          return err(createCodecError(\"DecodingError\", `Codec '${name}' failed to decode input`))\n        }\n\n        // Validate through schema\n        // oxlint-disable-next-line no-unsafe-type-assertion -- Required for spreading decoded value\n        const taggedInput = { ...(decoded as object), _tag }\n        const result = validateSync(schema, taggedInput, _tag)\n\n        if (result._tag === \"Err\") {\n          return err(\n            createCodecError(\n              \"ValidationError\",\n              \"Decoded data failed schema validation\",\n              undefined,\n              result.error.issues,\n            ),\n          )\n        }\n\n        // Ensure _tag in output\n        // oxlint-disable-next-line no-unsafe-type-assertion -- Required for output construction\n        const output = { ...(result.value as object), _tag } as Output\n        return ok(output)\n      }\n    }\n  }\n\n  // oxlint-disable-next-line no-unsafe-type-assertion -- Required for generic return type\n  return from as FromMethods<Tag, S, Codecs>\n}\n","import { createEqualsMethod, createHashMethod } from \"../equality/equality\"\nimport { ok, err } from \"../result/result\"\nimport type { Result } from \"../result/result.types\"\nimport type { ValidationError } from \"../schema/schema.types\"\nimport type { Discriminator } from \"../shared/discriminator.types\"\nimport { createToMethods, createFromMethods } from \"./adt.codec\"\nimport type { AdtCodecConstraint, AdtInferInput, AdtInferOutput, AdtVariant } from \"./adt.types\"\nimport { createIsGuard, validateSync } from \"./adt.utils\"\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\"\n\n/**\n * Create a standalone tagged variant from a Standard Schema with optional codecs.\n *\n * Variants can be used independently or composed into an AdtUnion via union().\n * All defaults should be defined at the schema level (e.g., Zod's .default()).\n *\n * @template Tag - The string literal type for the _tag discriminator\n * @template S - The Standard Schema type for validation\n * @template Codecs - Optional codec definitions for custom serialization formats\n * @param _tag - The _tag discriminator value\n * @param schema - A Standard Schema compliant validator\n * @param codecs - Optional codec definitions for custom serialization formats\n * @returns A callable AdtVariant with is(), to, and from methods\n *\n * @see {@link union} for composing variants into discriminated unions\n * @see {@link tagged} for unvalidated tagged value constructors\n *\n * @example\n * ```ts\n * const CircleSchema = z.object({\n *   radius: z.number().positive(),\n *   color: z.string().default('blue')\n * })\n *\n * // Basic variant with JSON codec (always included)\n * const Circle = variant('Circle', CircleSchema)\n *\n * const result = Circle({ radius: 10 })\n * // { _tag: \"Ok\", value: { _tag: \"Circle\", radius: 10, color: \"blue\" } }\n *\n * Circle.is(someValue) // type guard\n *\n * const json = Circle.to.json({ radius: 10 }) // JSON string\n * const result2 = Circle.from.json(json) // Result<Circle, AdtCodecError>\n *\n * // Variant with custom codec\n * const Circle2 = variant('Circle', CircleSchema, {\n *   graphic: {\n *     to: (circle) => `(${circle.radius})`,\n *     from: (input: string) => {\n *       const match = input.match(/^\\((\\d+)\\)$/)\n *       return match ? { radius: parseInt(match[1]!) } : null\n *     }\n *   }\n * })\n *\n * const graphic = Circle2.to.graphic({ radius: 10 }) // \"(10)\"\n * const result3 = Circle2.from.graphic(\"(10)\") // Result<Circle, AdtCodecError>\n * ```\n */\n// Overload: with codecs\nexport function variant<Tag extends string, S extends StandardSchemaV1, Codecs extends AdtCodecConstraint<Tag, S>>(\n  _tag: Tag,\n  schema: S,\n  codecs: Codecs,\n): AdtVariant<Tag, S, Codecs>\n\n// Overload: without codecs\nexport function variant<Tag extends string, S extends StandardSchemaV1>(_tag: Tag, schema: S): AdtVariant<Tag, S>\n\n// Implementation\nexport function variant<\n  Tag extends string,\n  S extends StandardSchemaV1,\n  Codecs extends AdtCodecConstraint<Tag, S> | undefined,\n>(_tag: Tag, schema: S, codecs?: Codecs): AdtVariant<Tag, S, Codecs> {\n  type Output = AdtInferOutput<S> & Discriminator<Tag>\n\n  const isGuard = createIsGuard<Tag, Output>(_tag)\n  const to = createToMethods(_tag, schema, codecs)\n  const from = createFromMethods(_tag, schema, codecs)\n  const equals = createEqualsMethod<Tag, AdtInferOutput<S>>(_tag)\n  const hash = createHashMethod<Tag, AdtInferOutput<S>>(_tag)\n\n  // Constructor function\n  const constructor = (input: AdtInferInput<S>): Result<Output, ValidationError> => {\n    // Add _tag to the input before validation\n    // oxlint-disable-next-line no-unsafe-type-assertion -- Required for spreading generic input\n    const taggedInput = { ...(input as object), _tag }\n\n    // Validate using the schema\n    const result = validateSync(schema, taggedInput, _tag)\n\n    if (result._tag === \"Err\") {\n      return err(result.error)\n    }\n\n    // Ensure _tag is in the output (schema might strip unknown keys)\n    // oxlint-disable-next-line no-unsafe-type-assertion -- Required for output construction\n    const output = { ...(result.value as object), _tag } as Output\n    return ok(output)\n  }\n\n  // Attach static properties to constructor function\n  constructor._variant = true as const\n  constructor._tag = _tag\n  constructor.schema = schema\n  if (codecs) {\n    // oxlint-disable-next-line no-unsafe-type-assertion -- Conditional assignment of codecs\n    ;(constructor as { codecs?: Codecs }).codecs = codecs\n  }\n  constructor.is = isGuard\n  constructor.to = to\n  constructor.from = from\n  constructor.equals = equals\n  constructor.hash = hash\n\n  return constructor as AdtVariant<Tag, S, Codecs>\n}\n","import { createADTEqualsMethod, createADTHashMethod } from \"../equality/equality\"\nimport type { AdtUnion, AdtVariantDef, AdtVariant } from \"./adt.types\"\nimport { createIsAnyGuard, isVariant } from \"./adt.utils\"\nimport { variant } from \"./adt.variant\"\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\"\n\n/**\n * Compose records or schemas into a discriminated union (AdtUnion).\n *\n * Accepts either:\n * - Pre-built AdtVariants from variant() (codecs are preserved)\n * - Raw Standard Schema validators (will be wrapped internally)\n *\n * When using pre-built records, the object key overrides the original _tag.\n *\n * @template R - Record of variant names to AdtVariants or StandardSchema validators\n * @param name - The name of this AdtUnion (for identification)\n * @param records - An object mapping _tag names to AdtVariants or schemas\n * @returns An AdtUnion object with accessors for each variant\n *\n * @see {@link variant} for creating individual variant types\n * @see {@link match} for exhaustive pattern matching on AdtUnion values\n *\n * @example\n * ```ts\n * // From pre-built variants\n * const Circle = variant('Circle', CircleSchema)\n * const Square = variant('Square', SquareSchema)\n * const Shape = union('Shape', { Circle, Square })\n *\n * // From raw schemas (JSON codec is automatically included)\n * const Shape = union('Shape', {\n *   Circle: CircleSchema,\n *   Square: SquareSchema\n * })\n *\n * // JSON codec works on all variants\n * Shape.Circle.to.json({ radius: 10 })\n * Shape.Circle.from.json(jsonString)\n *\n * // Mixed\n * const Shape = union('Shape', {\n *   Circle,              // Pre-built variant\n *   Square: SquareSchema // Raw schema\n * })\n *\n * // Usage\n * Shape.Circle({ radius: 10 })\n * Shape.is(someValue)        // type guard for any variant\n * Shape.Circle.is(someValue) // type guard for Circle\n * ```\n */\nexport function union<R extends Record<string, AdtVariantDef>>(name: string, records: R): AdtUnion<R> {\n  const tags = Object.keys(records)\n  const variants: Record<string, AdtVariant> = {}\n\n  for (const [_tag, def] of Object.entries(records)) {\n    if (isVariant(def)) {\n      // Pre-built AdtVariant - key overrides original _tag\n      if (def._tag === _tag) {\n        // _tag matches key, use as-is (preserves codecs)\n        variants[_tag] = def\n        // oxlint-disable-next-line strict-boolean-expressions -- codecs can be undefined\n      } else if (def.codecs) {\n        // _tag differs from key - create new variant with key as _tag\n        // Preserve codecs\n        variants[_tag] = variant(_tag, def.schema, def.codecs)\n      } else {\n        // _tag differs from key and no codecs\n        variants[_tag] = variant(_tag, def.schema)\n      }\n    } else {\n      // Raw schema - wrap in variant\n      // Note: Even without custom codecs, this still gets JSON codec!\n      // oxlint-disable-next-line no-unsafe-type-assertion -- def is a StandardSchemaV1 in this branch\n      variants[_tag] = variant(_tag, def as StandardSchemaV1)\n    }\n  }\n\n  // Create the root type guard for any variant\n  const isAnyVariant = createIsAnyGuard(tags)\n  const equals = createADTEqualsMethod(tags)\n  const hash = createADTHashMethod(tags)\n\n  // oxlint-disable-next-line no-unsafe-type-assertion -- Required for generic AdtUnion return type\n  return {\n    _name: name,\n    is: isAnyVariant,\n    equals,\n    hash,\n    ...variants,\n  } as AdtUnion<R>\n}\n","/**\n * Tagged union builders and match helpers.\n *\n * **Mental model**\n * - `Adt` helps build discriminated unions with runtime validation.\n * - Use `union`, `variant`, and `match` to model algebraic data types.\n *\n * **Common tasks**\n * - Define variants with `Adt.variant`.\n * - Combine variants with `Adt.union`.\n * - Pattern-match with `Adt.match`.\n *\n * **Gotchas**\n * - `Adt` codec/type helpers are mostly type-level.\n * - Prefer namespace imports from `@nicolastoulemont/std`.\n *\n * **Quickstart**\n *\n * @example\n * ```ts\n * import { Adt } from \"@nicolastoulemont/std\"\n * import { z } from \"zod\"\n *\n * // Adt accepts any Standard Schema-compatible schema, such as zod, valibot, or arktype.\n * const CircleSchema = z.object({ radius: z.number() })\n *\n * const Shape = Adt.union(\"Shape\", { Circle: CircleSchema })\n * const result = Shape.Circle({ radius: 2 })\n * // => { _tag: \"Ok\", value: { _tag: \"Circle\", radius: 2 } }\n * ```\n *\n * @module\n */\nimport { match as matchImpl } from \"./adt.match\"\nimport type {\n  AdtInfer as AdtInferType,\n  AdtVariantNames as AdtVariantNamesType,\n  AdtVariantOf as AdtVariantOfType,\n} from \"./adt.types\"\nimport { union as unionImpl } from \"./adt.union\"\nimport { variant as variantImpl } from \"./adt.variant\"\n\n/**\n * Re-exported ADT inferred union helper.\n *\n * @example\n * ```ts\n * import { Adt } from \"@nicolastoulemont/std\"\n * import { z } from \"zod\"\n *\n * // Adt accepts any Standard Schema-compatible schema, such as zod, valibot, or arktype.\n * const Shape = Adt.union(\"Shape\", {\n *   Circle: z.object({ radius: z.number() }),\n * })\n * type Shape = Adt.Infer<typeof Shape>\n * ```\n */\nexport type Infer<T> = AdtInferType<T>\n\n/**\n * Re-exported union variant name helper.\n *\n * @example\n * ```ts\n * import { Adt } from \"@nicolastoulemont/std\"\n * import { z } from \"zod\"\n *\n * // Adt accepts any Standard Schema-compatible schema, such as zod, valibot, or arktype.\n * const Shape = Adt.union(\"Shape\", {\n *   Circle: z.object({ radius: z.number() }),\n * })\n * type Names = Adt.VariantNames<typeof Shape>\n * ```\n */\nexport type VariantNames<T> = AdtVariantNamesType<T>\n\n/**\n * Re-exported helper to extract a specific variant from an ADT.\n *\n * @example\n * ```ts\n * import { Adt } from \"@nicolastoulemont/std\"\n * import { z } from \"zod\"\n *\n * // Adt accepts any Standard Schema-compatible schema, such as zod, valibot, or arktype.\n * const Shape = Adt.union(\"Shape\", {\n *   Circle: z.object({ radius: z.number() }),\n * })\n * type Circle = Adt.VariantOf<typeof Shape, \"Circle\">\n * ```\n */\nexport type VariantOf<T, K extends string> = AdtVariantOfType<T, K>\n\n/**\n * Build an ADT union from named variants.\n *\n * @example\n * ```ts\n * import { Adt } from \"@nicolastoulemont/std\"\n * import { z } from \"zod\"\n *\n * // Adt accepts any Standard Schema-compatible schema, such as zod, valibot, or arktype.\n * const CircleSchema = z.object({ radius: z.number() })\n *\n * const Shape = Adt.union(\"Shape\", { Circle: CircleSchema })\n * const result = Shape.Circle({ radius: 2 })\n * // => { _tag: \"Ok\", value: { _tag: \"Circle\", radius: 2 } }\n * ```\n */\nexport const union = unionImpl\n\n/**\n * Define one ADT variant with schema-backed validation.\n *\n * @example\n * ```ts\n * import { Adt } from \"@nicolastoulemont/std\"\n * import { z } from \"zod\"\n *\n * // Adt accepts any Standard Schema-compatible schema, such as zod, valibot, or arktype.\n * const CircleSchema = z.object({ radius: z.number() })\n *\n * const Circle = Adt.variant(\"Circle\", CircleSchema)\n * const result = Circle({ radius: 2 })\n * // => { _tag: \"Ok\", value: { _tag: \"Circle\", radius: 2 } }\n * ```\n */\nexport const variant = variantImpl\n\n/**\n * Match over ADT variants by discriminator tag.\n *\n * @example\n * ```ts\n * import { Adt } from \"@nicolastoulemont/std\"\n *\n * const label = Adt.match({ _tag: \"Circle\", radius: 2 } as const, {\n *   Circle: (circle) => `r=${circle.radius}` ,\n * })\n * // => \"r=2\"\n * ```\n */\nexport const match = matchImpl\n"],"mappings":"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"}

package/dist/data/index.d.mts

@@ -1,2 +1,2 @@
-import { t as data_d_exports } from "../index-B2Z7-XGR.mjs";
+import { t as data_d_exports } from "../index-D6pjHqlK.mjs";
 export { data_d_exports as Data };

package/dist/data/index.mjs

@@ -1 +1 @@
-import{n as e}from"../data-BHYPdqWZ.mjs";export{e as Data};
+import{n as e}from"../data-DqACNS_g.mjs";export{e as Data};

package/dist/data-DqACNS_g.mjs

@@ -0,0 +1,2 @@
+import{t as e}from"./chunk-oQKkju2G.mjs";import{a as t,i as n,o as r,s as i,t as a}from"./is-plain-object-BoFjRafL.mjs";import{t as o}from"./fx.types-DyQVgTS8.mjs";import{i as s,t as c}from"./result-D3VY0qBG.mjs";import{r as l}from"./schema.shared-Bjyroa6b.mjs";function u(e){let t=[...e];Object.defineProperty(t,`equals`,{value:e=>r(t,e),enumerable:!1,writable:!1,configurable:!1}),Object.defineProperty(t,`hash`,{value:()=>i(t),enumerable:!1,writable:!1,configurable:!1});let n=t.map.bind(t);Object.defineProperty(t,`map`,{value:e=>u(n(e)),enumerable:!1,writable:!1,configurable:!1});let a=t.filter.bind(t);Object.defineProperty(t,`filter`,{value:e=>u(a(e)),enumerable:!1,writable:!1,configurable:!1});let o=t.slice.bind(t);Object.defineProperty(t,`slice`,{value:(e,t)=>u(o(e,t)),enumerable:!1,writable:!1,configurable:!1});let s=t.concat.bind(t);return Object.defineProperty(t,`concat`,{value:(...e)=>u(s(...e)),enumerable:!1,writable:!1,configurable:!1}),Object.freeze(t)}function d(e){let t={...e};return Object.defineProperty(t,`equals`,{value:e=>r(t,e),enumerable:!1,writable:!1,configurable:!1}),Object.defineProperty(t,`hash`,{value:()=>i(t),enumerable:!1,writable:!1,configurable:!1}),Object.freeze(t)}function f(e){return t=>{let n=l(e,t,`Data.entity()`);return n._tag===`Err`?c(n.error):a(n.value)?s(d(n.value)):c({issues:[{message:`Data.entity() requires schemas with plain object outputs.`}]})}}function p(e){let r=t=>Object.freeze({...t,_tag:e});return r.is=t=>typeof t==`object`&&!!t&&`_tag`in t&&t._tag===e,r.equals=n(e),r.hash=t(e),r._tag=e,r}function m(e){return class extends Error{static _tag=e;_tag=e;[o]={_A:()=>void 0,_E:()=>this,_R:()=>void 0};constructor(...t){super(e),this.name=e;let n=t[0];n&&Object.assign(this,n),Object.setPrototypeOf(this,new.target.prototype)}*[Symbol.iterator](){throw yield this,Error(`Unreachable: Fx.gen should short-circuit on error`)}}}function h(...e){let t=[...e];return Object.defineProperty(t,`equals`,{value:e=>r(t,e),enumerable:!1,writable:!1,configurable:!1}),Object.defineProperty(t,`hash`,{value:()=>i(t),enumerable:!1,writable:!1,configurable:!1}),Object.freeze(t)}var g=e({TaggedError:()=>v,array:()=>S,entity:()=>y,struct:()=>b,tagged:()=>_,tuple:()=>x});const _=p,v=m,y=f,b=d,x=h,S=u;export{g as n,v as t};
+//# sourceMappingURL=data-DqACNS_g.mjs.map

package/dist/data-DqACNS_g.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-DqACNS_g.mjs","names":["array","struct","entity","struct","tagged","TaggedError","tuple","taggedImpl","TaggedErrorImpl","entityImpl","structImpl","tupleImpl","arrayImpl"],"sources":["../src/data/data.array.ts","../src/data/data.struct.ts","../src/data/data.entity.ts","../src/data/data.tagged.ts","../src/data/data.tagged-error.ts","../src/data/data.tuple.ts","../src/data/data.ts"],"sourcesContent":["import { deepEquals, deepHash } from \"../equality/equality\"\nimport type { ArrayValue } from \"./data.types\"\n\n/**\n * Create an array with structural equality.\n *\n * The returned array is frozen (immutable) and has non-enumerable\n * equals() and hash() methods for structural comparison.\n *\n * The map() and filter() methods are overridden to return ArrayValue,\n * enabling method chaining with preserved equality semantics.\n *\n * @template T - The element type of the array\n * @param items - The array elements\n * @returns A frozen array with equals(), hash(), map(), and filter()\n *\n * @see {@link tuple} for fixed-length typed tuples\n * @see {@link struct} for object value types\n *\n * @example\n * ```ts\n * const arr1 = array([1, 2, 3])\n * const arr2 = array([1, 2, 3])\n *\n * arr1.equals(arr2) // true\n * arr1.hash() // number\n *\n * // Chainable operations return ArrayValue\n * arr1.map(x => x * 2) // ArrayValue<number>\n * arr1.filter(x => x > 1) // ArrayValue<number>\n *\n * // Chained equality check\n * arr1.map(x => x * 2).equals(array([2, 4, 6])) // true\n *\n * // Array is frozen\n * arr1[0] = 5 // TypeError\n * arr1.push(4) // TypeError\n * ```\n */\nexport function array<T>(items: readonly T[]): ArrayValue<T> {\n  const value = [...items]\n\n  // Add equals method (non-enumerable)\n  Object.defineProperty(value, \"equals\", {\n    value: (other: readonly T[]) => deepEquals(value, other),\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  // Add hash method (non-enumerable)\n  Object.defineProperty(value, \"hash\", {\n    value: () => deepHash(value),\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  // Override map to return ArrayValue\n  const originalMap = value.map.bind(value)\n  Object.defineProperty(value, \"map\", {\n    value: <U>(fn: (item: T, index: number, arr: readonly T[]) => U): ArrayValue<U> => {\n      return array(originalMap(fn))\n    },\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  // Override filter to return ArrayValue\n  const originalFilter = value.filter.bind(value)\n  Object.defineProperty(value, \"filter\", {\n    value: (fn: (item: T, index: number, arr: readonly T[]) => boolean): ArrayValue<T> => {\n      return array(originalFilter(fn))\n    },\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  // Override slice to return ArrayValue\n  const originalSlice = value.slice.bind(value)\n  Object.defineProperty(value, \"slice\", {\n    value: (start?: number, end?: number): ArrayValue<T> => {\n      return array(originalSlice(start, end))\n    },\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  // Override concat to return ArrayValue\n  const originalConcat = value.concat.bind(value)\n  Object.defineProperty(value, \"concat\", {\n    value: (...args: readonly (T | readonly T[])[]): ArrayValue<T> => {\n      // oxlint-disable-next-line no-unsafe-type-assertion -- Required for concat argument spread\n      return array(originalConcat(...(args as T[][])))\n    },\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  // oxlint-disable-next-line no-unsafe-type-assertion -- Required for generic array return type\n  return Object.freeze(value) as unknown as ArrayValue<T>\n}\n","import { deepEquals, deepHash } from \"../equality/equality\"\nimport type { StructValue } from \"./data.types\"\n\n/**\n * Create a frozen value object with structural equality.\n *\n * Unlike tagged(), struct() does not add a _tag discriminator.\n * Use this for simple value objects that don't need discrimination.\n *\n * The returned object is frozen (immutable) and has non-enumerable\n * equals() and hash() methods for structural comparison.\n *\n * @template T - The object shape type\n * @param input - The object to wrap\n * @returns A frozen object with equals() and hash() methods\n *\n * @see {@link tagged} for discriminated value objects with _tag\n * @see {@link array} for array value types\n *\n * @example\n * ```ts\n * const point = struct({ x: 10, y: 20 })\n * const point2 = struct({ x: 10, y: 20 })\n *\n * point.equals(point2) // true\n * point.hash() // number\n *\n * // Object is frozen\n * point.x = 5 // TypeError\n *\n * // equals/hash are non-enumerable\n * Object.keys(point) // [\"x\", \"y\"]\n * ```\n */\nexport function struct<T extends Record<string, unknown>>(input: T): StructValue<T> {\n  const value = { ...input }\n\n  // Add equals method (non-enumerable)\n  Object.defineProperty(value, \"equals\", {\n    value: (other: T) => deepEquals(value, other),\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  // Add hash method (non-enumerable)\n  Object.defineProperty(value, \"hash\", {\n    value: () => deepHash(value),\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  // oxlint-disable-next-line no-unsafe-type-assertion -- Required for generic struct return type\n  return Object.freeze(value) as StructValue<T>\n}\n","import { err, ok } from \"../result/result\"\nimport type { Result } from \"../result/result.types\"\nimport { validateSync } from \"../schema/schema.shared\"\nimport type { Input, Output, SyncSchema, ValidationError } from \"../schema/schema.types\"\nimport { isPlainObject } from \"../shared/is-plain-object\"\nimport { struct } from \"./data.struct\"\nimport type { StructValue } from \"./data.types\"\n\ntype EntitySchema<TInput = unknown, TOutput extends Record<string, unknown> = Record<string, unknown>> = SyncSchema<\n  TInput,\n  TOutput\n>\n\ntype EntityConstructor<S extends EntitySchema> = (input: Input<S>) => Result<StructValue<Output<S>>, ValidationError>\n\n/**\n * Create a sync schema-backed constructor for untagged entity objects.\n *\n * The constructor validates through the provided schema, then wraps the\n * validated object with `Data.struct()` so the result is frozen and gains\n * structural `equals()` and `hash()` behavior.\n *\n * Defaults and output shaping should be defined at the schema level.\n *\n * @example\n * ```ts\n * import { Data } from \"@nicolastoulemont/std\"\n * import { z } from \"zod\"\n *\n * const User = Data.entity(\n *   z.object({\n *     id: z.string(),\n *     role: z.string().default(\"member\"),\n *   }),\n * )\n *\n * const user = User({ id: \"u1\" })\n * // => { _tag: \"Ok\", value: { id: \"u1\", role: \"member\" } }\n * ```\n */\nexport function entity<S extends EntitySchema>(schema: S): EntityConstructor<S> {\n  return (input: Input<S>) => {\n    const result = validateSync(schema, input, \"Data.entity()\")\n\n    if (result._tag === \"Err\") {\n      return err(result.error)\n    }\n\n    if (!isPlainObject(result.value)) {\n      return err({\n        issues: [{ message: \"Data.entity() requires schemas with plain object outputs.\" }],\n      })\n    }\n\n    return ok(struct(result.value))\n  }\n}\n","import { createEqualsMethod, createHashMethod } from \"../equality/equality\"\nimport type { Discriminator } from \"../shared/discriminator.types\"\nimport type { TaggedConstructor, TaggedValue } from \"./data.types\"\n\n/**\n * Create a tagged value constructor without schema validation.\n *\n * Unlike variant(), this creates values directly without validation.\n * Values are frozen and have structural equality via equals() and hash() methods.\n *\n * @template T - The data shape type (excluding _tag)\n * @param tag - The _tag discriminator value\n * @returns A constructor function with is(), equals(), and hash() methods\n *\n * @see {@link variant} for validated variant with schema support\n * @see {@link struct} for untagged value objects\n *\n * @example\n * ```ts\n * const Person = tagged<{ name: string; age: number }>(\"Person\")\n *\n * const alice = Person({ name: \"Alice\", age: 30 })\n * // => { _tag: \"Person\", name: \"Alice\", age: 30 }\n *\n * Person.equals(alice, Person({ name: \"Alice\", age: 30 })) // true\n * Person.is(alice) // true\n *\n * // Type guard usage\n * if (Person.is(unknownValue)) {\n *   console.log(unknownValue.name) // TypeScript knows it's a Person\n * }\n *\n * // Values are frozen (immutable)\n * alice.name = \"Bob\" // TypeError\n * ```\n */\nexport function tagged<T extends Record<string, unknown>>(tag: string): TaggedConstructor<typeof tag, T> {\n  type Output = TaggedValue<typeof tag, T>\n\n  // Constructor function\n  const constructor = (input: T): Output => {\n    return Object.freeze({ ...input, _tag: tag }) as Output\n  }\n\n  // Type guard\n  constructor.is = (value: unknown): value is Output => {\n    return (\n      typeof value === \"object\" &&\n      value !== null &&\n      \"_tag\" in value &&\n      // oxlint-disable-next-line no-unsafe-type-assertion -- Already checked with 'in' operator\n      (value as Discriminator)._tag === tag\n    )\n  }\n\n  // Equality (static method on constructor)\n  constructor.equals = createEqualsMethod<typeof tag, T>(tag)\n\n  // Hashing (static method on constructor)\n  constructor.hash = createHashMethod<typeof tag, T>(tag)\n\n  // Store tag for reflection\n  constructor._tag = tag\n\n  return constructor as TaggedConstructor<typeof tag, T>\n}\n","import { FxTypeId } from \"../fx/fx.types\"\nimport type { TaggedErrorFactory } from \"./data.tagged-error.types\"\n\n/* oxlint-disable no-unsafe-type-assertion -- Tagged error factories intentionally cast to preserve ergonomic constructor signatures and Fx marker channels. */\n\n/**\n * Create a class-based tagged error type (Effect-style syntax).\n * Returns a class that can be extended to create custom error types.\n * Errors are native Error objects with proper stack traces and instanceof support.\n * Implements Yieldable protocol so errors can be directly yielded in Fx.gen computations.\n *\n * @template Tag - The error tag (discriminator string)\n * @param tag - The error tag\n * @returns A class that can be extended with custom data\n *\n * @example\n * ```ts\n * // Error with data\n * class NotFoundError extends TaggedError(\"NotFoundError\")<{ id: string }> {}\n * const err = new NotFoundError({ id: \"123\" })\n * err.id // \"123\"\n * err._tag // \"NotFoundError\"\n * err.stack // Error stack trace\n *\n * // Error without data\n * class UnauthorizedError extends TaggedError(\"UnauthorizedError\") {}\n * const err2 = new UnauthorizedError()\n *\n * // Direct yielding in Fx.gen computation\n * const program = Fx.gen(function* () {\n *   yield* new NotFoundError({ id: \"123\" })  // Short-circuits with error\n * })\n *\n * // instanceof checks work\n * if (err instanceof NotFoundError) {\n *   console.log(err.id)\n * }\n * ```\n */\nexport function TaggedError<Tag extends string>(tag: Tag): TaggedErrorFactory<Tag> {\n  return class TaggedErrorImpl<Data extends object = object> extends Error {\n    static readonly _tag: Tag = tag\n    readonly _tag: Tag = tag\n\n    readonly [FxTypeId] = {\n      _A: () => undefined as never,\n      _E: () => this as TaggedErrorImpl<Data>,\n      _R: () => undefined as never,\n    }\n\n    constructor(...args: keyof Data extends never ? [] : [data: Data]) {\n      super(tag)\n      this.name = tag\n      const data = args[0]\n      if (data) Object.assign(this, data)\n      Object.setPrototypeOf(this, new.target.prototype)\n    }\n\n    *[Symbol.iterator](): Generator<this, never, unknown> {\n      yield this\n      throw new Error(\"Unreachable: Fx.gen should short-circuit on error\")\n    }\n  } as unknown as TaggedErrorFactory<Tag>\n}\n\n/* oxlint-enable no-unsafe-type-assertion */\n","import { deepEquals, deepHash } from \"../equality/equality\"\nimport type { TupleValue } from \"./data.types\"\n\n/**\n * Create a tuple with structural equality.\n *\n * The returned tuple is frozen (immutable) and has non-enumerable\n * equals() and hash() methods for structural comparison.\n *\n * @template T - The tuple type as a readonly array of element types\n * @param args - The tuple elements\n * @returns A frozen tuple-like array with equals() and hash() methods\n *\n * @see {@link array} for variable-length arrays with equality\n * @see {@link struct} for object value types\n *\n * @example\n * ```ts\n * const t1 = tuple(1, \"hello\", true)\n * const t2 = tuple(1, \"hello\", true)\n *\n * t1.equals(t2) // true\n * t1.hash() // number\n *\n * // Access elements (typed)\n * t1[0] // number\n * t1[1] // string\n * t1[2] // boolean\n *\n * // Tuple is frozen\n * t1[0] = 5 // TypeError\n * ```\n */\nexport function tuple<T extends readonly unknown[]>(...args: T): TupleValue<T> {\n  const value = [...args]\n\n  // Add equals method (non-enumerable)\n  Object.defineProperty(value, \"equals\", {\n    value: (other: readonly unknown[]) => deepEquals(value, other),\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  // Add hash method (non-enumerable)\n  Object.defineProperty(value, \"hash\", {\n    value: () => deepHash(value),\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  })\n\n  // oxlint-disable-next-line no-unsafe-type-assertion -- Required for generic tuple return type\n  return Object.freeze(value) as unknown as TupleValue<T>\n}\n","/**\n * Structural data constructors for tagged objects, tuples, arrays, records, and\n * validated entity values.\n *\n * **Mental model**\n * - `Data` helpers create immutable-friendly values with structural equality semantics.\n * - `Data.entity` bridges Standard Schema validation into `Data.struct` values.\n * - Use `tagged` and `TaggedError` to model domain objects and errors.\n *\n * **Common tasks**\n * - Build tagged records via `Data.tagged`.\n * - Build validated entity constructors via `Data.entity`.\n * - Define typed tagged errors with `Data.TaggedError`.\n * - Create structural containers with `Data.struct`, `Data.tuple`, and `Data.array`.\n *\n * **Gotchas**\n * - Most `Data` helpers are value-level utilities, not validation schemas.\n * - `Data.entity` is the exception: it validates through a sync Standard Schema\n *   before producing a structural value.\n * - Prefer explicit tagged names for debugging and pattern matching.\n *\n * **Quickstart**\n *\n * @example\n * ```ts\n * import { Data } from \"@nicolastoulemont/std\"\n *\n * const User = Data.tagged<{ id: string }>(\"User\")\n * const user = User({ id: \"u1\" })\n * // => { _tag: \"User\", id: \"u1\" }\n * ```\n *\n * @module\n */\nimport { array as arrayImpl } from \"./data.array\"\nimport { entity as entityImpl } from \"./data.entity\"\nimport { struct as structImpl } from \"./data.struct\"\nimport { tagged as taggedImpl } from \"./data.tagged\"\nimport { TaggedError as TaggedErrorImpl } from \"./data.tagged-error\"\nexport type {\n  TaggedErrorClass,\n  TaggedErrorCore,\n  TaggedErrorFactory,\n  TaggedErrorInstance,\n} from \"./data.tagged-error.types\"\nexport type { ArrayValue, StructValue, TaggedConstructor, TaggedValue, TupleValue } from \"./data.types\"\nimport { tuple as tupleImpl } from \"./data.tuple\"\n\n/**\n * Construct tagged data objects.\n *\n * @example\n * ```ts\n * import { Data } from \"@nicolastoulemont/std\"\n *\n * const User = Data.tagged<{ id: string }>(\"User\")\n * const user = User({ id: \"u1\" })\n * // => { _tag: \"User\", id: \"u1\" }\n * ```\n */\nexport const tagged = taggedImpl\n\n/**\n * Construct tagged error classes.\n *\n * @example\n * ```ts\n * import { Data } from \"@nicolastoulemont/std\"\n *\n * class NotFoundError extends Data.TaggedError(\"NotFoundError\")<{ id: string }> {}\n * const error = new NotFoundError({ id: \"u1\" })\n * // => { _tag: \"NotFoundError\", id: \"u1\" }\n * ```\n */\nexport const TaggedError = TaggedErrorImpl\n\n/**\n * Construct sync schema-backed entities with structural value semantics.\n *\n * @example\n * ```ts\n * import { Data } from \"@nicolastoulemont/std\"\n * import { z } from \"zod\"\n *\n * const User = Data.entity(z.object({ id: z.string() }))\n * const result = User({ id: \"u1\" })\n * // => { _tag: \"Ok\", value: { id: \"u1\" } }\n * ```\n */\nexport const entity = entityImpl\n\n/**\n * Construct immutable-like structs with stable structural behavior.\n *\n * @example\n * ```ts\n * import { Data } from \"@nicolastoulemont/std\"\n *\n * const point = Data.struct({ x: 1, y: 2 })\n * const same = point.equals({ x: 1, y: 2 })\n * // => true\n * ```\n */\nexport const struct = structImpl\n\n/**\n * Construct immutable-like tuples with stable structural behavior.\n *\n * @example\n * ```ts\n * import { Data } from \"@nicolastoulemont/std\"\n *\n * const pair = Data.tuple(\"left\", 1)\n * const first = pair[0]\n * // => \"left\"\n * ```\n */\nexport const tuple = tupleImpl\n\n/**\n * Construct immutable-like arrays with stable structural behavior.\n *\n * @example\n * ```ts\n * import { Data } from \"@nicolastoulemont/std\"\n *\n * const ids = Data.array([\"a\", \"b\"])\n * const upper = ids.map((id) => id.toUpperCase())\n * // => [\"A\", \"B\"]\n * ```\n */\nexport const array = arrayImpl\n"],"mappings":"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"}

package/dist/duration/index.d.mts

@@ -1,2 +1,2 @@
-import { r as duration_d_exports } from "../index-DCUGtEcj.mjs";
+import { r as duration_d_exports } from "../index-DfAqfnY0.mjs";
 export { duration_d_exports as Duration };

package/dist/duration/index.mjs

@@ -1 +1 @@
-import{t as e}from"../duration-CYoDHcOR.mjs";export{e as Duration};
+import{t as e}from"../duration-Bas3mi1N.mjs";export{e as Duration};

package/dist/{duration-CYoDHcOR.mjs → duration-Bas3mi1N.mjs}

@@ -1,2 +1,2 @@
-import{t as e}from"./chunk-oQKkju2G.mjs";import{i as t,t as n}from"./result-D3VY0qBG.mjs";import{n as r}from"./brand-DZgGDrAe.mjs";import{t as i}from"./data-BHYPdqWZ.mjs";var a=e({DurationInvalidInputError:()=>c,DurationInvalidValueError:()=>s,DurationParseError:()=>o,days:()=>v,from:()=>C,hours:()=>_,millis:()=>m,minutes:()=>g,parse:()=>S,seconds:()=>h,toMillis:()=>b,weeks:()=>y}),o=class extends i(`DurationParseError`){},s=class extends i(`DurationInvalidValueError`){},c=class extends i(`DurationInvalidInputError`){};const l=/^\s*(-?\d+(?:\.\d+)?)\s+(milli|millis|second|seconds|minute|minutes|hour|hours|day|days|week|weeks)\s*$/i,u=e=>`Duration value must be a finite number, received: ${String(e)}`,d=e=>`Invalid duration input: ${String(e)}`,f=e=>`Invalid duration string: ${e}. Expected "{number} {milli|millis|second|seconds|minute|minutes|hour|hours|day|days|week|weeks}".`,p=e=>{if(!Number.isFinite(e))throw new s({input:e,message:u(e)});return r(e)},m=e=>p(e),h=e=>m(e*1e3),g=e=>m(e*6e4),_=e=>m(e*36e5),v=e=>m(e*864e5),y=e=>m(e*6048e5),b=e=>e,x=(e,t,n)=>{switch(n.toLowerCase()){case`milli`:case`millis`:return m(t);case`second`:case`seconds`:return h(t);case`minute`:case`minutes`:return g(t);case`hour`:case`hours`:return _(t);case`day`:case`days`:return v(t);case`week`:case`weeks`:return y(t);default:throw new o({input:e,message:f(e)})}},S=e=>{let r=l.exec(e);if(!r)return n(new o({input:e,message:f(e)}));let i=Number(r[1]),a=r[2];try{return t(x(e,i,a))}catch(t){if(t instanceof s||t instanceof o)return n(new o({input:e,message:f(e)}));throw t}},C=e=>{if(typeof e==`number`)try{return t(m(e))}catch(e){if(e instanceof s)return n(e);throw e}return typeof e==`string`?S(e):n(new c({input:e,message:d(e)}))};export{C as n,b as r,a as t};
-//# sourceMappingURL=duration-CYoDHcOR.mjs.map
+import{t as e}from"./chunk-oQKkju2G.mjs";import{i as t,t as n}from"./result-D3VY0qBG.mjs";import{n as r}from"./brand-DZgGDrAe.mjs";import{t as i}from"./data-DqACNS_g.mjs";var a=e({DurationInvalidInputError:()=>c,DurationInvalidValueError:()=>s,DurationParseError:()=>o,days:()=>v,from:()=>C,hours:()=>_,millis:()=>m,minutes:()=>g,parse:()=>S,seconds:()=>h,toMillis:()=>b,weeks:()=>y}),o=class extends i(`DurationParseError`){},s=class extends i(`DurationInvalidValueError`){},c=class extends i(`DurationInvalidInputError`){};const l=/^\s*(-?\d+(?:\.\d+)?)\s+(milli|millis|second|seconds|minute|minutes|hour|hours|day|days|week|weeks)\s*$/i,u=e=>`Duration value must be a finite number, received: ${String(e)}`,d=e=>`Invalid duration input: ${String(e)}`,f=e=>`Invalid duration string: ${e}. Expected "{number} {milli|millis|second|seconds|minute|minutes|hour|hours|day|days|week|weeks}".`,p=e=>{if(!Number.isFinite(e))throw new s({input:e,message:u(e)});return r(e)},m=e=>p(e),h=e=>m(e*1e3),g=e=>m(e*6e4),_=e=>m(e*36e5),v=e=>m(e*864e5),y=e=>m(e*6048e5),b=e=>e,x=(e,t,n)=>{switch(n.toLowerCase()){case`milli`:case`millis`:return m(t);case`second`:case`seconds`:return h(t);case`minute`:case`minutes`:return g(t);case`hour`:case`hours`:return _(t);case`day`:case`days`:return v(t);case`week`:case`weeks`:return y(t);default:throw new o({input:e,message:f(e)})}},S=e=>{let r=l.exec(e);if(!r)return n(new o({input:e,message:f(e)}));let i=Number(r[1]),a=r[2];try{return t(x(e,i,a))}catch(t){if(t instanceof s||t instanceof o)return n(new o({input:e,message:f(e)}));throw t}},C=e=>{if(typeof e==`number`)try{return t(m(e))}catch(e){if(e instanceof s)return n(e);throw e}return typeof e==`string`?S(e):n(new c({input:e,message:d(e)}))};export{C as n,b as r,a as t};
+//# sourceMappingURL=duration-Bas3mi1N.mjs.map

package/dist/{duration-CYoDHcOR.mjs.map → duration-Bas3mi1N.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"duration-CYoDHcOR.mjs","names":["Data.TaggedError","Brand.make","Result.err","Result.ok"],"sources":["../src/duration/duration.ts"],"sourcesContent":["/**\n * Fixed-size duration helpers backed by branded millisecond numbers.\n *\n * **Mental model**\n * - `Duration` is a finite JavaScript `number` interpreted as milliseconds.\n * - Use constructors for direct code and `parse` / `from` for ergonomic input handling.\n *\n * **Common tasks**\n * - Build durations with `Duration.seconds(5)` or `Duration.minutes(2)`.\n * - Parse config-like strings with `Duration.parse(\"5 minutes\")`.\n * - Normalize mixed inputs with `Duration.from(...)`.\n *\n * **Gotchas**\n * - Only fixed-size units are supported.\n * - Months, years, micros, and nanos are intentionally not supported.\n * - Invalid values use tagged errors instead of plain `RangeError`.\n *\n * @module\n */\n/* oxlint-disable eslint/max-classes-per-file -- TaggedError classes are part of the public API surface for this small module. */\nimport { Brand } from \"../brand\"\nimport type { Branded } from \"../brand/brand.types\"\nimport { Data } from \"../data\"\nimport { Result } from \"../result\"\n\n/**\n * Millisecond-backed branded duration type.\n */\nexport type Duration = Branded<number, \"Duration\">\n\n/**\n * Supported textual duration units.\n */\nexport type Unit =\n  | \"milli\"\n  | \"millis\"\n  | \"second\"\n  | \"seconds\"\n  | \"minute\"\n  | \"minutes\"\n  | \"hour\"\n  | \"hours\"\n  | \"day\"\n  | \"days\"\n  | \"week\"\n  | \"weeks\"\n\n/**\n * String input for durations.\n */\nexport type StringInput = `${number} ${Unit}`\n\n/**\n * Accepted duration input shapes.\n */\nexport type Input = Duration | number | StringInput\n\n/**\n * Tagged parse error for invalid duration strings.\n */\nexport class DurationParseError extends Data.TaggedError(\"DurationParseError\")<{\n  input: string\n  message: string\n}> {}\n\n/**\n * Tagged error for invalid numeric duration values.\n */\nexport class DurationInvalidValueError extends Data.TaggedError(\"DurationInvalidValueError\")<{\n  input: number\n  message: string\n}> {}\n\n/**\n * Tagged error for invalid duration input values outside supported shapes.\n */\nexport class DurationInvalidInputError extends Data.TaggedError(\"DurationInvalidInputError\")<{\n  input: Input\n  message: string\n  cause?: DurationParseError | DurationInvalidValueError\n}> {}\n\n/**\n * Re-exported parse error type.\n */\nexport type ParseError = DurationParseError\n\n/**\n * Re-exported duration input error union.\n */\nexport type InputError = DurationInvalidInputError | DurationParseError | DurationInvalidValueError\n\nconst DURATION_REGEXP =\n  /^\\s*(-?\\d+(?:\\.\\d+)?)\\s+(milli|millis|second|seconds|minute|minutes|hour|hours|day|days|week|weeks)\\s*$/i\n\nconst invalidValueMessage = (value: number) => `Duration value must be a finite number, received: ${String(value)}`\nconst invalidInputMessage = (input: Input) => `Invalid duration input: ${String(input)}`\nconst invalidStringMessage = (input: string) =>\n  `Invalid duration string: ${input}. Expected \"{number} {milli|millis|second|seconds|minute|minutes|hour|hours|day|days|week|weeks}\".`\n\nconst validateFinite = (value: number): Duration => {\n  if (!Number.isFinite(value)) {\n    throw new DurationInvalidValueError({\n      input: value,\n      message: invalidValueMessage(value),\n    })\n  }\n\n  return Brand.make<Branded<number, \"Duration\">>(value)\n}\n\n/**\n * Create a duration from milliseconds.\n */\nexport const millis = (value: number): Duration => validateFinite(value)\n\n/**\n * Create a duration from seconds.\n */\nexport const seconds = (value: number): Duration => millis(value * 1_000)\n\n/**\n * Create a duration from minutes.\n */\nexport const minutes = (value: number): Duration => millis(value * 60_000)\n\n/**\n * Create a duration from hours.\n */\nexport const hours = (value: number): Duration => millis(value * 3_600_000)\n\n/**\n * Create a duration from days.\n */\nexport const days = (value: number): Duration => millis(value * 86_400_000)\n\n/**\n * Create a duration from weeks.\n */\nexport const weeks = (value: number): Duration => millis(value * 604_800_000)\n\n/**\n * Convert a duration to raw milliseconds.\n */\nexport const toMillis = (duration: Duration): number => duration\n\nconst parseUnit = (input: string, value: number, unit: string): Duration => {\n  switch (unit.toLowerCase()) {\n    case \"milli\":\n    case \"millis\":\n      return millis(value)\n    case \"second\":\n    case \"seconds\":\n      return seconds(value)\n    case \"minute\":\n    case \"minutes\":\n      return minutes(value)\n    case \"hour\":\n    case \"hours\":\n      return hours(value)\n    case \"day\":\n    case \"days\":\n      return days(value)\n    case \"week\":\n    case \"weeks\":\n      return weeks(value)\n    default:\n      throw new DurationParseError({\n        input,\n        message: invalidStringMessage(input),\n      })\n  }\n}\n\n/**\n * Parse a duration string.\n */\nexport const parse = (input: string): Result.Result<Duration, DurationParseError> => {\n  const match = DURATION_REGEXP.exec(input)\n  if (!match) {\n    return Result.err(\n      new DurationParseError({\n        input,\n        message: invalidStringMessage(input),\n      }),\n    )\n  }\n\n  const value = Number(match[1])\n  const unit = match[2]!\n\n  try {\n    return Result.ok(parseUnit(input, value, unit))\n  } catch (error) {\n    if (error instanceof DurationInvalidValueError || error instanceof DurationParseError) {\n      return Result.err(\n        new DurationParseError({\n          input,\n          message: invalidStringMessage(input),\n        }),\n      )\n    }\n    throw error\n  }\n}\n\n/**\n * Normalize supported duration inputs to a branded duration.\n */\nexport const from = (input: Input): Result.Result<Duration, InputError> => {\n  if (typeof input === \"number\") {\n    try {\n      return Result.ok(millis(input))\n    } catch (error) {\n      if (error instanceof DurationInvalidValueError) {\n        return Result.err(error)\n      }\n      throw error\n    }\n  }\n\n  if (typeof input === \"string\") {\n    return parse(input)\n  }\n\n  return Result.err(\n    new DurationInvalidInputError({\n      input,\n      message: invalidInputMessage(input),\n    }),\n  )\n}\n"],"mappings":"iYA4Da,EAAb,cAAwCA,EAAiB,qBAAqB,AAG3E,GAKU,EAAb,cAA+CA,EAAiB,4BAA4B,AAGzF,GAKU,EAAb,cAA+CA,EAAiB,4BAA4B,AAIzF,GAYH,MAAM,EACJ,2GAEI,EAAuB,GAAkB,qDAAqD,OAAO,EAAM,GAC3G,EAAuB,GAAiB,2BAA2B,OAAO,EAAM,GAChF,EAAwB,GAC5B,4BAA4B,EAAM,oGAE9B,EAAkB,GAA4B,CAClD,GAAI,CAAC,OAAO,SAAS,EAAM,CACzB,MAAM,IAAI,EAA0B,CAClC,MAAO,EACP,QAAS,EAAoB,EAAM,CACpC,CAAC,CAGJ,OAAOC,EAAwC,EAAM,EAM1C,EAAU,GAA4B,EAAe,EAAM,CAK3D,EAAW,GAA4B,EAAO,EAAQ,IAAM,CAK5D,EAAW,GAA4B,EAAO,EAAQ,IAAO,CAK7D,EAAS,GAA4B,EAAO,EAAQ,KAAU,CAK9D,EAAQ,GAA4B,EAAO,EAAQ,MAAW,CAK9D,EAAS,GAA4B,EAAO,EAAQ,OAAY,CAKhE,EAAY,GAA+B,EAElD,GAAa,EAAe,EAAe,IAA2B,CAC1E,OAAQ,EAAK,aAAa,CAA1B,CACE,IAAK,QACL,IAAK,SACH,OAAO,EAAO,EAAM,CACtB,IAAK,SACL,IAAK,UACH,OAAO,EAAQ,EAAM,CACvB,IAAK,SACL,IAAK,UACH,OAAO,EAAQ,EAAM,CACvB,IAAK,OACL,IAAK,QACH,OAAO,EAAM,EAAM,CACrB,IAAK,MACL,IAAK,OACH,OAAO,EAAK,EAAM,CACpB,IAAK,OACL,IAAK,QACH,OAAO,EAAM,EAAM,CACrB,QACE,MAAM,IAAI,EAAmB,CAC3B,QACA,QAAS,EAAqB,EAAM,CACrC,CAAC,GAOK,EAAS,GAA+D,CACnF,IAAM,EAAQ,EAAgB,KAAK,EAAM,CACzC,GAAI,CAAC,EACH,OAAOC,EACL,IAAI,EAAmB,CACrB,QACA,QAAS,EAAqB,EAAM,CACrC,CAAC,CACH,CAGH,IAAM,EAAQ,OAAO,EAAM,GAAG,CACxB,EAAO,EAAM,GAEnB,GAAI,CACF,OAAOC,EAAU,EAAU,EAAO,EAAO,EAAK,CAAC,OACxC,EAAO,CACd,GAAI,aAAiB,GAA6B,aAAiB,EACjE,OAAOD,EACL,IAAI,EAAmB,CACrB,QACA,QAAS,EAAqB,EAAM,CACrC,CAAC,CACH,CAEH,MAAM,IAOG,EAAQ,GAAsD,CACzE,GAAI,OAAO,GAAU,SACnB,GAAI,CACF,OAAOC,EAAU,EAAO,EAAM,CAAC,OACxB,EAAO,CACd,GAAI,aAAiB,EACnB,OAAOD,EAAW,EAAM,CAE1B,MAAM,EAQV,OAJI,OAAO,GAAU,SACZ,EAAM,EAAM,CAGdA,EACL,IAAI,EAA0B,CAC5B,QACA,QAAS,EAAoB,EAAM,CACpC,CAAC,CACH"}
+{"version":3,"file":"duration-Bas3mi1N.mjs","names":["Data.TaggedError","Brand.make","Result.err","Result.ok"],"sources":["../src/duration/duration.ts"],"sourcesContent":["/**\n * Fixed-size duration helpers backed by branded millisecond numbers.\n *\n * **Mental model**\n * - `Duration` is a finite JavaScript `number` interpreted as milliseconds.\n * - Use constructors for direct code and `parse` / `from` for ergonomic input handling.\n *\n * **Common tasks**\n * - Build durations with `Duration.seconds(5)` or `Duration.minutes(2)`.\n * - Parse config-like strings with `Duration.parse(\"5 minutes\")`.\n * - Normalize mixed inputs with `Duration.from(...)`.\n *\n * **Gotchas**\n * - Only fixed-size units are supported.\n * - Months, years, micros, and nanos are intentionally not supported.\n * - Invalid values use tagged errors instead of plain `RangeError`.\n *\n * @module\n */\n/* oxlint-disable eslint/max-classes-per-file -- TaggedError classes are part of the public API surface for this small module. */\nimport { Brand } from \"../brand\"\nimport type { Branded } from \"../brand/brand.types\"\nimport { Data } from \"../data\"\nimport { Result } from \"../result\"\n\n/**\n * Millisecond-backed branded duration type.\n */\nexport type Duration = Branded<number, \"Duration\">\n\n/**\n * Supported textual duration units.\n */\nexport type Unit =\n  | \"milli\"\n  | \"millis\"\n  | \"second\"\n  | \"seconds\"\n  | \"minute\"\n  | \"minutes\"\n  | \"hour\"\n  | \"hours\"\n  | \"day\"\n  | \"days\"\n  | \"week\"\n  | \"weeks\"\n\n/**\n * String input for durations.\n */\nexport type StringInput = `${number} ${Unit}`\n\n/**\n * Accepted duration input shapes.\n */\nexport type Input = Duration | number | StringInput\n\n/**\n * Tagged parse error for invalid duration strings.\n */\nexport class DurationParseError extends Data.TaggedError(\"DurationParseError\")<{\n  input: string\n  message: string\n}> {}\n\n/**\n * Tagged error for invalid numeric duration values.\n */\nexport class DurationInvalidValueError extends Data.TaggedError(\"DurationInvalidValueError\")<{\n  input: number\n  message: string\n}> {}\n\n/**\n * Tagged error for invalid duration input values outside supported shapes.\n */\nexport class DurationInvalidInputError extends Data.TaggedError(\"DurationInvalidInputError\")<{\n  input: Input\n  message: string\n  cause?: DurationParseError | DurationInvalidValueError\n}> {}\n\n/**\n * Re-exported parse error type.\n */\nexport type ParseError = DurationParseError\n\n/**\n * Re-exported duration input error union.\n */\nexport type InputError = DurationInvalidInputError | DurationParseError | DurationInvalidValueError\n\nconst DURATION_REGEXP =\n  /^\\s*(-?\\d+(?:\\.\\d+)?)\\s+(milli|millis|second|seconds|minute|minutes|hour|hours|day|days|week|weeks)\\s*$/i\n\nconst invalidValueMessage = (value: number) => `Duration value must be a finite number, received: ${String(value)}`\nconst invalidInputMessage = (input: Input) => `Invalid duration input: ${String(input)}`\nconst invalidStringMessage = (input: string) =>\n  `Invalid duration string: ${input}. Expected \"{number} {milli|millis|second|seconds|minute|minutes|hour|hours|day|days|week|weeks}\".`\n\nconst validateFinite = (value: number): Duration => {\n  if (!Number.isFinite(value)) {\n    throw new DurationInvalidValueError({\n      input: value,\n      message: invalidValueMessage(value),\n    })\n  }\n\n  return Brand.make<Branded<number, \"Duration\">>(value)\n}\n\n/**\n * Create a duration from milliseconds.\n */\nexport const millis = (value: number): Duration => validateFinite(value)\n\n/**\n * Create a duration from seconds.\n */\nexport const seconds = (value: number): Duration => millis(value * 1_000)\n\n/**\n * Create a duration from minutes.\n */\nexport const minutes = (value: number): Duration => millis(value * 60_000)\n\n/**\n * Create a duration from hours.\n */\nexport const hours = (value: number): Duration => millis(value * 3_600_000)\n\n/**\n * Create a duration from days.\n */\nexport const days = (value: number): Duration => millis(value * 86_400_000)\n\n/**\n * Create a duration from weeks.\n */\nexport const weeks = (value: number): Duration => millis(value * 604_800_000)\n\n/**\n * Convert a duration to raw milliseconds.\n */\nexport const toMillis = (duration: Duration): number => duration\n\nconst parseUnit = (input: string, value: number, unit: string): Duration => {\n  switch (unit.toLowerCase()) {\n    case \"milli\":\n    case \"millis\":\n      return millis(value)\n    case \"second\":\n    case \"seconds\":\n      return seconds(value)\n    case \"minute\":\n    case \"minutes\":\n      return minutes(value)\n    case \"hour\":\n    case \"hours\":\n      return hours(value)\n    case \"day\":\n    case \"days\":\n      return days(value)\n    case \"week\":\n    case \"weeks\":\n      return weeks(value)\n    default:\n      throw new DurationParseError({\n        input,\n        message: invalidStringMessage(input),\n      })\n  }\n}\n\n/**\n * Parse a duration string.\n */\nexport const parse = (input: string): Result.Result<Duration, DurationParseError> => {\n  const match = DURATION_REGEXP.exec(input)\n  if (!match) {\n    return Result.err(\n      new DurationParseError({\n        input,\n        message: invalidStringMessage(input),\n      }),\n    )\n  }\n\n  const value = Number(match[1])\n  const unit = match[2]!\n\n  try {\n    return Result.ok(parseUnit(input, value, unit))\n  } catch (error) {\n    if (error instanceof DurationInvalidValueError || error instanceof DurationParseError) {\n      return Result.err(\n        new DurationParseError({\n          input,\n          message: invalidStringMessage(input),\n        }),\n      )\n    }\n    throw error\n  }\n}\n\n/**\n * Normalize supported duration inputs to a branded duration.\n */\nexport const from = (input: Input): Result.Result<Duration, InputError> => {\n  if (typeof input === \"number\") {\n    try {\n      return Result.ok(millis(input))\n    } catch (error) {\n      if (error instanceof DurationInvalidValueError) {\n        return Result.err(error)\n      }\n      throw error\n    }\n  }\n\n  if (typeof input === \"string\") {\n    return parse(input)\n  }\n\n  return Result.err(\n    new DurationInvalidInputError({\n      input,\n      message: invalidInputMessage(input),\n    }),\n  )\n}\n"],"mappings":"iYA4Da,EAAb,cAAwCA,EAAiB,qBAAqB,AAG3E,GAKU,EAAb,cAA+CA,EAAiB,4BAA4B,AAGzF,GAKU,EAAb,cAA+CA,EAAiB,4BAA4B,AAIzF,GAYH,MAAM,EACJ,2GAEI,EAAuB,GAAkB,qDAAqD,OAAO,EAAM,GAC3G,EAAuB,GAAiB,2BAA2B,OAAO,EAAM,GAChF,EAAwB,GAC5B,4BAA4B,EAAM,oGAE9B,EAAkB,GAA4B,CAClD,GAAI,CAAC,OAAO,SAAS,EAAM,CACzB,MAAM,IAAI,EAA0B,CAClC,MAAO,EACP,QAAS,EAAoB,EAAM,CACpC,CAAC,CAGJ,OAAOC,EAAwC,EAAM,EAM1C,EAAU,GAA4B,EAAe,EAAM,CAK3D,EAAW,GAA4B,EAAO,EAAQ,IAAM,CAK5D,EAAW,GAA4B,EAAO,EAAQ,IAAO,CAK7D,EAAS,GAA4B,EAAO,EAAQ,KAAU,CAK9D,EAAQ,GAA4B,EAAO,EAAQ,MAAW,CAK9D,EAAS,GAA4B,EAAO,EAAQ,OAAY,CAKhE,EAAY,GAA+B,EAElD,GAAa,EAAe,EAAe,IAA2B,CAC1E,OAAQ,EAAK,aAAa,CAA1B,CACE,IAAK,QACL,IAAK,SACH,OAAO,EAAO,EAAM,CACtB,IAAK,SACL,IAAK,UACH,OAAO,EAAQ,EAAM,CACvB,IAAK,SACL,IAAK,UACH,OAAO,EAAQ,EAAM,CACvB,IAAK,OACL,IAAK,QACH,OAAO,EAAM,EAAM,CACrB,IAAK,MACL,IAAK,OACH,OAAO,EAAK,EAAM,CACpB,IAAK,OACL,IAAK,QACH,OAAO,EAAM,EAAM,CACrB,QACE,MAAM,IAAI,EAAmB,CAC3B,QACA,QAAS,EAAqB,EAAM,CACrC,CAAC,GAOK,EAAS,GAA+D,CACnF,IAAM,EAAQ,EAAgB,KAAK,EAAM,CACzC,GAAI,CAAC,EACH,OAAOC,EACL,IAAI,EAAmB,CACrB,QACA,QAAS,EAAqB,EAAM,CACrC,CAAC,CACH,CAGH,IAAM,EAAQ,OAAO,EAAM,GAAG,CACxB,EAAO,EAAM,GAEnB,GAAI,CACF,OAAOC,EAAU,EAAU,EAAO,EAAO,EAAK,CAAC,OACxC,EAAO,CACd,GAAI,aAAiB,GAA6B,aAAiB,EACjE,OAAOD,EACL,IAAI,EAAmB,CACrB,QACA,QAAS,EAAqB,EAAM,CACrC,CAAC,CACH,CAEH,MAAM,IAOG,EAAQ,GAAsD,CACzE,GAAI,OAAO,GAAU,SACnB,GAAI,CACF,OAAOC,EAAU,EAAO,EAAM,CAAC,OACxB,EAAO,CACd,GAAI,aAAiB,EACnB,OAAOD,EAAW,EAAM,CAE1B,MAAM,EAQV,OAJI,OAAO,GAAU,SACZ,EAAM,EAAM,CAGdA,EACL,IAAI,EAA0B,CAC5B,QACA,QAAS,EAAoB,EAAM,CACpC,CAAC,CACH"}

package/dist/fx/index.d.mts

@@ -1,2 +1,2 @@
-import { t as fx_d_exports } from "../index-C4DOLLaU.mjs";
+import { t as fx_d_exports } from "../index-BD-els5J.mjs";
 export { fx_d_exports as Fx };

package/dist/fx/index.mjs

@@ -1 +1 @@
-import{t as e}from"../fx-DUXDxwsU.mjs";export{e as Fx};
+import{t as e}from"../fx-C_RTDEpv.mjs";export{e as Fx};

package/dist/{fx-DUXDxwsU.mjs → fx-C_RTDEpv.mjs}

@@ -1,2 +1,2 @@
-import{t as e}from"./chunk-oQKkju2G.mjs";import{n as t,t as n}from"./fx.types-DyQVgTS8.mjs";import{t as r}from"./dual-fN6OUwN_.mjs";import{i,n as a,t as o}from"./result-D3VY0qBG.mjs";import{t as s}from"./option.types-CbY_swma.mjs";import{t as c}from"./option-C2iCxAuJ.mjs";import{t as l}from"./service-resolution-BefYr4nR.mjs";import{i as u,n as d,r as f,t as p}from"./queue-apiEOlRD.mjs";import{n as m,r as h,t as g}from"./fx.runtime-jQxh77s3.mjs";var _=class extends Error{_tag=`TypedFailure`;constructor(e){super(`TypedFailure`),this.error=e,this.name=`TypedFailure`}};const v=e=>e instanceof _,y=e=>typeof e==`object`&&!!e&&`_tag`in e&&e._tag===`Err`&&`error`in e,b=e=>e instanceof s?e:y(e)?e.error:e,x=e=>e!=null&&typeof e[Symbol.iterator]==`function`,S=e=>new f({reason:e.reason}),C=e=>e instanceof Error?e:Error(`Fx.forEach defect was not an Error`,{cause:e}),w=()=>{throw Error(`Unreachable: Fx type marker should never execute at runtime`)},T=()=>w,E=async(e,t,n)=>{if(e._tag===`AsyncFx`){let r=e[Symbol.asyncIterator](),i=await r.next();for(;i.done!==!0;){if(t.aborted)throw S(t);let e=i.value;if(l(e)!==void 0){let a=await n(e,t);i=await r.next(a);continue}throw new _(b(e))}return i.value}let r=e[Symbol.iterator](),i=r.next();for(;i.done!==!0;){if(t.aborted)throw S(t);let e=i.value;if(l(e)!==void 0){let a=await n(e,t);i=r.next(a);continue}throw new _(b(e))}return i.value},D=r(e=>x(e[0])&&typeof e[1]==`function`,(e,t,r)=>{let i=[...e],a=r?.discard===!0;return{_tag:`AsyncFx`,[n]:{_A:T(),_E:T(),_R:T()},async*[Symbol.asyncIterator](){if(i.length===0)return a?void 0:[];let e=u({concurrency:r?.concurrency??`unbounded`}),n=a?void 0:[],o=i.length,s,c,l=!1,m=[],h=new Set,g=()=>{for(let e of h)e();h.clear()},_=()=>new Promise(e=>{h.add(e)}),y=(e,t)=>t.aborted?Promise.reject(S(t)):new Promise((n,r)=>{let i={yielded:e,signal:t,resolve:e=>{t.removeEventListener(`abort`,a),n(e)},reject:e=>{t.removeEventListener(`abort`,a),r(e)}},a=()=>{let e=m.indexOf(i);e!==-1&&m.splice(e,1),r(S(t))};t.addEventListener(`abort`,a,{once:!0}),m.push(i),g()}),b=e=>{let t=m.splice(0);for(let n of t)n.reject(e)},x=t=>{l||(l=!0,e.shutdown({mode:`abort`,reason:t}).catch(()=>{}))},w=e=>{if(v(e)){s===void 0&&c===void 0&&(s=e.error,x(e.error));return}if(!((e instanceof p||e instanceof f||e instanceof d)&&(s!==void 0||c!==void 0))&&c===void 0&&s===void 0){let t=C(e);c=t,x(t)}},T=()=>{--o,g()};for(let[r,a]of i.entries())e.enqueue(async({signal:e})=>{let i=await E(t(a,r),e,y);n!==void 0&&(n[r]=i)}).catch(w).finally(T);for(;;){if(c!==void 0)throw b(c),Error(`Fx.forEach defect`,{cause:c});if(s!==void 0)throw b(new p({reason:s})),yield s,Error(`Unreachable: Fx runtime short-circuits on first failure`);let e=m.shift();if(e!==void 0){if(e.signal.aborted){e.reject(S(e.signal));continue}try{let t=yield e.yielded;e.resolve(t)}catch(t){e.reject(C(t))}continue}if(o===0)break;await _()}return a?void 0:n}}});var O=e({Exit:()=>h,FxTypeId:()=>n,err:()=>X,fn:()=>G,forEach:()=>J,gen:()=>W,isServiceRequest:()=>t,match:()=>$,ok:()=>Y,option:()=>Z,retry:()=>q,run:()=>K,try:()=>Q});function k(e){return e._tag===`AsyncFx`?g(e):m(e)}const A=e=>new Promise(t=>{setTimeout(t,e)}),j=async e=>{e<=0||await A(e)},M=e=>{typeof e.return==`function`&&e.return(void 0)},N=async e=>{typeof e.return==`function`&&await e.return(void 0)},P=(e,t)=>({_tag:`SyncFx`,[n]:{_A:()=>void 0,_E:()=>void 0,_R:()=>void 0},*[Symbol.iterator](){let n=0;attemptLoop:for(;;){let r=e[Symbol.iterator](),i=r.next();for(;i.done!==!0;){let e=i.value;if(l(e)!==void 0){let t=yield e;i=r.next(t);continue}if(n+=1,n<=t.maxRetries){M(r);continue attemptLoop}yield e;return}return i.value}}}),F=(e,t)=>({_tag:`AsyncFx`,[n]:{_A:()=>void 0,_E:()=>void 0,_R:()=>void 0},async*[Symbol.asyncIterator](){let n=0;attemptLoop:for(;;){if(e._tag===`AsyncFx`){let r=e[Symbol.asyncIterator](),i=await r.next();for(;i.done!==!0;){let e=i.value;if(l(e)!==void 0){let t=yield e;i=await r.next(t);continue}if(n+=1,n<=t.maxRetries){await j(t.delayForAttempt(n)),await N(r);continue attemptLoop}return yield e,void 0}return i.value}let r=e[Symbol.iterator](),i=r.next();for(;i.done!==!0;){let e=i.value;if(l(e)!==void 0){let t=yield e;i=r.next(t);continue}if(n+=1,n<=t.maxRetries){await j(t.delayForAttempt(n)),await N(r);continue attemptLoop}return yield e,void 0}return i.value}}}),I=r(2,(e,t)=>e._tag===`AsyncFx`||!t._sync?F(e,t):P(e,t));function L(e){if(e.length>0)return(...t)=>L(()=>e(...t));let t=e();return Symbol.asyncIterator in t?{_tag:`AsyncFx`,[n]:{_A:()=>void 0,_E:()=>void 0,_R:()=>void 0},async*[Symbol.asyncIterator](){let t=e(),n=await t.next();for(;n.done!==!0;){let e=yield n.value;n=await t.next(e)}return n.value}}:{_tag:`SyncFx`,[n]:{_A:()=>void 0,_E:()=>void 0,_R:()=>void 0},*[Symbol.iterator](){let t=e(),n=t.next();for(;n.done!==!0;){let e=yield n.value;n=t.next(e)}return n.value}}}function R(e,t){let n=L(e);return k(t?(n._tag,t(n)):n)}const z=i,B=o,V=a,H=c,U=r(2,(e,t)=>t[e._tag](e)),W=L,G=R,K=k,q=I,J=D,Y=z,X=B,Z=H,Q=V,$=U;export{O as t};
-//# sourceMappingURL=fx-DUXDxwsU.mjs.map
+import{t as e}from"./chunk-oQKkju2G.mjs";import{n as t,t as n}from"./fx.types-DyQVgTS8.mjs";import{t as r}from"./dual-fN6OUwN_.mjs";import{i,n as a,t as o}from"./result-D3VY0qBG.mjs";import{t as s}from"./option.types-CbY_swma.mjs";import{t as c}from"./option-C2iCxAuJ.mjs";import{t as l}from"./service-resolution-BefYr4nR.mjs";import{i as u,n as d,r as f,t as p}from"./queue-GYVrD39q.mjs";import{n as m,r as h,t as g}from"./fx.runtime-jQxh77s3.mjs";var _=class extends Error{_tag=`TypedFailure`;constructor(e){super(`TypedFailure`),this.error=e,this.name=`TypedFailure`}};const v=e=>e instanceof _,y=e=>typeof e==`object`&&!!e&&`_tag`in e&&e._tag===`Err`&&`error`in e,b=e=>e instanceof s?e:y(e)?e.error:e,x=e=>e!=null&&typeof e[Symbol.iterator]==`function`,S=e=>new f({reason:e.reason}),C=e=>e instanceof Error?e:Error(`Fx.forEach defect was not an Error`,{cause:e}),w=()=>{throw Error(`Unreachable: Fx type marker should never execute at runtime`)},T=()=>w,E=async(e,t,n)=>{if(e._tag===`AsyncFx`){let r=e[Symbol.asyncIterator](),i=await r.next();for(;i.done!==!0;){if(t.aborted)throw S(t);let e=i.value;if(l(e)!==void 0){let a=await n(e,t);i=await r.next(a);continue}throw new _(b(e))}return i.value}let r=e[Symbol.iterator](),i=r.next();for(;i.done!==!0;){if(t.aborted)throw S(t);let e=i.value;if(l(e)!==void 0){let a=await n(e,t);i=r.next(a);continue}throw new _(b(e))}return i.value},D=r(e=>x(e[0])&&typeof e[1]==`function`,(e,t,r)=>{let i=[...e],a=r?.discard===!0;return{_tag:`AsyncFx`,[n]:{_A:T(),_E:T(),_R:T()},async*[Symbol.asyncIterator](){if(i.length===0)return a?void 0:[];let e=u({concurrency:r?.concurrency??`unbounded`}),n=a?void 0:[],o=i.length,s,c,l=!1,m=[],h=new Set,g=()=>{for(let e of h)e();h.clear()},_=()=>new Promise(e=>{h.add(e)}),y=(e,t)=>t.aborted?Promise.reject(S(t)):new Promise((n,r)=>{let i={yielded:e,signal:t,resolve:e=>{t.removeEventListener(`abort`,a),n(e)},reject:e=>{t.removeEventListener(`abort`,a),r(e)}},a=()=>{let e=m.indexOf(i);e!==-1&&m.splice(e,1),r(S(t))};t.addEventListener(`abort`,a,{once:!0}),m.push(i),g()}),b=e=>{let t=m.splice(0);for(let n of t)n.reject(e)},x=t=>{l||(l=!0,e.shutdown({mode:`abort`,reason:t}).catch(()=>{}))},w=e=>{if(v(e)){s===void 0&&c===void 0&&(s=e.error,x(e.error));return}if(!((e instanceof p||e instanceof f||e instanceof d)&&(s!==void 0||c!==void 0))&&c===void 0&&s===void 0){let t=C(e);c=t,x(t)}},T=()=>{--o,g()};for(let[r,a]of i.entries())e.enqueue(async({signal:e})=>{let i=await E(t(a,r),e,y);n!==void 0&&(n[r]=i)}).catch(w).finally(T);for(;;){if(c!==void 0)throw b(c),Error(`Fx.forEach defect`,{cause:c});if(s!==void 0)throw b(new p({reason:s})),yield s,Error(`Unreachable: Fx runtime short-circuits on first failure`);let e=m.shift();if(e!==void 0){if(e.signal.aborted){e.reject(S(e.signal));continue}try{let t=yield e.yielded;e.resolve(t)}catch(t){e.reject(C(t))}continue}if(o===0)break;await _()}return a?void 0:n}}});var O=e({Exit:()=>h,FxTypeId:()=>n,err:()=>X,fn:()=>G,forEach:()=>J,gen:()=>W,isServiceRequest:()=>t,match:()=>$,ok:()=>Y,option:()=>Z,retry:()=>q,run:()=>K,try:()=>Q});function k(e){return e._tag===`AsyncFx`?g(e):m(e)}const A=e=>new Promise(t=>{setTimeout(t,e)}),j=async e=>{e<=0||await A(e)},M=e=>{typeof e.return==`function`&&e.return(void 0)},N=async e=>{typeof e.return==`function`&&await e.return(void 0)},P=(e,t)=>({_tag:`SyncFx`,[n]:{_A:()=>void 0,_E:()=>void 0,_R:()=>void 0},*[Symbol.iterator](){let n=0;attemptLoop:for(;;){let r=e[Symbol.iterator](),i=r.next();for(;i.done!==!0;){let e=i.value;if(l(e)!==void 0){let t=yield e;i=r.next(t);continue}if(n+=1,n<=t.maxRetries){M(r);continue attemptLoop}yield e;return}return i.value}}}),F=(e,t)=>({_tag:`AsyncFx`,[n]:{_A:()=>void 0,_E:()=>void 0,_R:()=>void 0},async*[Symbol.asyncIterator](){let n=0;attemptLoop:for(;;){if(e._tag===`AsyncFx`){let r=e[Symbol.asyncIterator](),i=await r.next();for(;i.done!==!0;){let e=i.value;if(l(e)!==void 0){let t=yield e;i=await r.next(t);continue}if(n+=1,n<=t.maxRetries){await j(t.delayForAttempt(n)),await N(r);continue attemptLoop}return yield e,void 0}return i.value}let r=e[Symbol.iterator](),i=r.next();for(;i.done!==!0;){let e=i.value;if(l(e)!==void 0){let t=yield e;i=r.next(t);continue}if(n+=1,n<=t.maxRetries){await j(t.delayForAttempt(n)),await N(r);continue attemptLoop}return yield e,void 0}return i.value}}}),I=r(2,(e,t)=>e._tag===`AsyncFx`||!t._sync?F(e,t):P(e,t));function L(e){if(e.length>0)return(...t)=>L(()=>e(...t));let t=e();return Symbol.asyncIterator in t?{_tag:`AsyncFx`,[n]:{_A:()=>void 0,_E:()=>void 0,_R:()=>void 0},async*[Symbol.asyncIterator](){let t=e(),n=await t.next();for(;n.done!==!0;){let e=yield n.value;n=await t.next(e)}return n.value}}:{_tag:`SyncFx`,[n]:{_A:()=>void 0,_E:()=>void 0,_R:()=>void 0},*[Symbol.iterator](){let t=e(),n=t.next();for(;n.done!==!0;){let e=yield n.value;n=t.next(e)}return n.value}}}function R(e,t){let n=L(e);return k(t?(n._tag,t(n)):n)}const z=i,B=o,V=a,H=c,U=r(2,(e,t)=>t[e._tag](e)),W=L,G=R,K=k,q=I,J=D,Y=z,X=B,Z=H,Q=V,$=U;export{O as t};
+//# sourceMappingURL=fx-C_RTDEpv.mjs.map

package/dist/{fx-DUXDxwsU.mjs.map → fx-C_RTDEpv.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"fx-DUXDxwsU.mjs","names":["gen","result","makeQueue","gen","result","resultOk","resultErr","resultTry","optionFromNullable"],"sources":["../src/fx/foreach.ts","../src/fx/fx.ts"],"sourcesContent":["import { NoSuchElementError } from \"../option/option.types\"\nimport { make as makeQueue, QueueAbortedError, QueueClosedError, QueueTaskAbortedError } from \"../queue/queue\"\nimport type { Concurrency } from \"../queue/queue.types\"\nimport { asServiceRequest } from \"../service/service-resolution\"\nimport { dual } from \"../shared/dual\"\nimport { FxTypeId } from \"./fx.types\"\nimport type { AsyncFx, FxError, FxRequirements, FxValue, FxYield, RunnableFx } from \"./fx.types\"\n\n/* oxlint-disable no-await-in-loop -- Fx.forEach coordinates child iterators and queue scheduling sequentially at specific yield points. */\n\ntype ForEachValue<Discard extends boolean, B> = Discard extends true ? void : Array<B>\n\ntype FxForEachOptions<Discard extends boolean = false> = {\n  readonly concurrency?: Concurrency\n  readonly discard?: Discard\n}\n\ntype ForEachFx<\n  F extends (a: never, i: number) => RunnableFx<unknown, unknown, unknown>,\n  Discard extends boolean,\n> = AsyncFx<ForEachValue<Discard, FxValue<ReturnType<F>>>, FxError<ReturnType<F>>, FxRequirements<ReturnType<F>>>\n\ntype FxForEach = {\n  <A, F extends (a: A, i: number) => RunnableFx<unknown, unknown, unknown>, const Discard extends boolean = false>(\n    self: Iterable<A>,\n    f: F,\n    options?: FxForEachOptions<Discard>,\n  ): ForEachFx<F, Discard>\n  <A, F extends (a: A, i: number) => RunnableFx<unknown, unknown, unknown>, const Discard extends boolean = false>(\n    f: F,\n    options?: FxForEachOptions<Discard>,\n  ): (self: Iterable<A>) => ForEachFx<F, Discard>\n}\n\ntype ServiceRequestEntry<E, R> = {\n  readonly yielded: FxYield<E, R>\n  readonly signal: AbortSignal\n  readonly resolve: (value: unknown) => void\n  readonly reject: (reason: Error) => void\n}\n\ntype ResultErrShape = {\n  readonly _tag: \"Err\"\n  readonly error: unknown\n}\n\nclass TypedFailure<E> extends Error {\n  readonly _tag = \"TypedFailure\"\n\n  constructor(readonly error: E) {\n    super(\"TypedFailure\")\n    this.name = \"TypedFailure\"\n  }\n}\n\nconst isTypedFailure = <E>(value: unknown): value is TypedFailure<E> => value instanceof TypedFailure\n\nconst isResultErr = (value: unknown): value is ResultErrShape =>\n  typeof value === \"object\" && value !== null && \"_tag\" in value && value._tag === \"Err\" && \"error\" in value\n\nconst toFailureValue = (yielded: unknown): unknown => {\n  if (yielded instanceof NoSuchElementError) {\n    return yielded\n  }\n\n  if (isResultErr(yielded)) {\n    return yielded.error\n  }\n\n  return yielded\n}\n\nconst isIterable = (value: unknown): value is Iterable<unknown> =>\n  value !== null &&\n  value !== undefined &&\n  typeof (value as { [Symbol.iterator]?: unknown })[Symbol.iterator] === \"function\"\n\nconst queueTaskAbortedError = (signal: AbortSignal): QueueTaskAbortedError =>\n  new QueueTaskAbortedError({ reason: signal.reason })\n\nconst toError = (reason: unknown): Error =>\n  reason instanceof Error ? reason : new Error(\"Fx.forEach defect was not an Error\", { cause: reason })\n\nconst unreachableType = (): never => {\n  throw new Error(\"Unreachable: Fx type marker should never execute at runtime\")\n}\n\nconst typeMarker = <A>(): (() => A) => unreachableType\n\nconst runMappedFx = async <B, E, R>(\n  fx: RunnableFx<B, E, R>,\n  signal: AbortSignal,\n  requestService: (yielded: FxYield<E, R>, signal: AbortSignal) => Promise<unknown>,\n): Promise<B> => {\n  if (fx._tag === \"AsyncFx\") {\n    const gen = fx[Symbol.asyncIterator]()\n    let result = await gen.next()\n\n    while (result.done !== true) {\n      if (signal.aborted) {\n        throw queueTaskAbortedError(signal)\n      }\n\n      const yielded = result.value\n      const serviceRequest = asServiceRequest(yielded)\n      if (serviceRequest !== undefined) {\n        const injected = await requestService(yielded, signal)\n        result = await gen.next(injected)\n        continue\n      }\n\n      // oxlint-disable-next-line typescript-eslint/no-unsafe-type-assertion -- failure channel values come from generic E at runtime.\n      throw new TypedFailure<E>(toFailureValue(yielded) as E)\n    }\n\n    return result.value\n  }\n\n  const gen = fx[Symbol.iterator]()\n  let result = gen.next()\n\n  while (result.done !== true) {\n    if (signal.aborted) {\n      throw queueTaskAbortedError(signal)\n    }\n\n    const yielded = result.value\n    const serviceRequest = asServiceRequest(yielded)\n    if (serviceRequest !== undefined) {\n      const injected = await requestService(yielded, signal)\n      result = gen.next(injected)\n      continue\n    }\n\n    // oxlint-disable-next-line typescript-eslint/no-unsafe-type-assertion -- failure channel values come from generic E at runtime.\n    throw new TypedFailure<E>(toFailureValue(yielded) as E)\n  }\n\n  return result.value\n}\n\nconst fxForEach = dual(\n  (args) => isIterable(args[0]) && typeof args[1] === \"function\",\n  <A, B, E, R>(\n    self: Iterable<A>,\n    f: (a: A, i: number) => RunnableFx<B, E, R>,\n    options?: FxForEachOptions<boolean>,\n  ): AsyncFx<Array<B> | void, E, R> => {\n    const items = [...self]\n    const discard = options?.discard === true\n\n    const program: AsyncFx<Array<B> | void, E, R> = {\n      _tag: \"AsyncFx\",\n      [FxTypeId]: {\n        _A: typeMarker<Array<B> | void>(),\n        _E: typeMarker<E>(),\n        _R: typeMarker<R>(),\n      },\n      async *[Symbol.asyncIterator](): AsyncGenerator<FxYield<E, R>, Array<B> | void, unknown> {\n        if (items.length === 0) {\n          return discard ? undefined : []\n        }\n\n        const queue = makeQueue({ concurrency: options?.concurrency ?? \"unbounded\" })\n        const results: Array<B> | undefined = discard ? undefined : []\n\n        let remaining = items.length\n        let firstFailure: E | undefined\n        let firstDefect: Error | undefined\n        let queueAborted = false\n\n        const serviceRequests: ServiceRequestEntry<E, R>[] = []\n        const eventWaiters = new Set<() => void>()\n\n        const notifyEvent = () => {\n          for (const resolve of eventWaiters) {\n            resolve()\n          }\n          eventWaiters.clear()\n        }\n\n        const waitForEvent = () =>\n          new Promise<void>((resolve) => {\n            eventWaiters.add(resolve)\n          })\n\n        const requestService = (yielded: FxYield<E, R>, signal: AbortSignal): Promise<unknown> => {\n          if (signal.aborted) {\n            return Promise.reject(queueTaskAbortedError(signal))\n          }\n\n          return new Promise<unknown>((resolve, reject) => {\n            const entry: ServiceRequestEntry<E, R> = {\n              yielded,\n              signal,\n              resolve: (value) => {\n                signal.removeEventListener(\"abort\", onAbort)\n                resolve(value)\n              },\n              reject: (reason) => {\n                signal.removeEventListener(\"abort\", onAbort)\n                reject(reason)\n              },\n            }\n\n            const onAbort = () => {\n              const index = serviceRequests.indexOf(entry)\n              if (index !== -1) {\n                serviceRequests.splice(index, 1)\n              }\n              reject(queueTaskAbortedError(signal))\n            }\n\n            signal.addEventListener(\"abort\", onAbort, { once: true })\n            serviceRequests.push(entry)\n            notifyEvent()\n          })\n        }\n\n        const rejectPendingServiceRequests = (reason: Error) => {\n          const pending = serviceRequests.splice(0)\n          for (const request of pending) {\n            request.reject(reason)\n          }\n        }\n\n        const abortQueue = (reason: unknown) => {\n          if (queueAborted) {\n            return\n          }\n\n          queueAborted = true\n          void queue.shutdown({ mode: \"abort\", reason }).catch(() => {\n            // no-op: fail-fast cleanup should never interrupt parent error handling\n          })\n        }\n\n        const onTaskFailure = (error: unknown) => {\n          if (isTypedFailure<E>(error)) {\n            if (firstFailure === undefined && firstDefect === undefined) {\n              firstFailure = error.error\n              abortQueue(error.error)\n            }\n            return\n          }\n\n          if (\n            (error instanceof QueueAbortedError ||\n              error instanceof QueueTaskAbortedError ||\n              error instanceof QueueClosedError) &&\n            (firstFailure !== undefined || firstDefect !== undefined)\n          ) {\n            return\n          }\n\n          if (firstDefect === undefined && firstFailure === undefined) {\n            const defect = toError(error)\n            firstDefect = defect\n            abortQueue(defect)\n          }\n        }\n\n        const onTaskSettled = () => {\n          remaining -= 1\n          notifyEvent()\n        }\n\n        for (const [index, item] of items.entries()) {\n          void queue\n            .enqueue(async ({ signal }) => {\n              const value = await runMappedFx(f(item, index), signal, requestService)\n              if (results !== undefined) {\n                results[index] = value\n              }\n            })\n            .catch(onTaskFailure)\n            .finally(onTaskSettled)\n        }\n\n        while (true) {\n          if (firstDefect !== undefined) {\n            rejectPendingServiceRequests(firstDefect)\n            throw new Error(\"Fx.forEach defect\", { cause: firstDefect })\n          }\n\n          if (firstFailure !== undefined) {\n            rejectPendingServiceRequests(new QueueAbortedError({ reason: firstFailure }))\n            yield firstFailure\n            throw new Error(\"Unreachable: Fx runtime short-circuits on first failure\")\n          }\n\n          const request = serviceRequests.shift()\n          if (request !== undefined) {\n            if (request.signal.aborted) {\n              request.reject(queueTaskAbortedError(request.signal))\n              continue\n            }\n\n            try {\n              const injected = yield request.yielded\n              request.resolve(injected)\n            } catch (error) {\n              request.reject(toError(error))\n            }\n            continue\n          }\n\n          if (remaining === 0) {\n            break\n          }\n\n          await waitForEvent()\n        }\n\n        return discard ? undefined : results\n      },\n    }\n\n    return program\n  },\n) as FxForEach\n\nexport { fxForEach as forEach }\n\n/* oxlint-enable no-await-in-loop */\n","/**\n * Lightweight effect runtime with typed success, error, and requirement channels.\n *\n * **Mental model**\n * - `Fx<A, E, R>` models computations that may fail and require services.\n * - Build with `Fx.gen`, run with `Fx.run`, and compose with `Layer`/`Provide`.\n *\n * **Common tasks**\n * - Create workflows with `Fx.gen`.\n * - Execute with `Fx.run` or `Fx.fn`.\n * - Retry with `Fx.retry` and match outcomes with `Fx.match`.\n *\n * **Gotchas**\n * - Dependencies (`R`) must be provided before execution.\n * - `Fx.run` returns `Exit`, not raw values.\n *\n * **Quickstart**\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const program = Fx.gen(function* () {\n *   const value = yield* Fx.ok(2)\n *   return value + 1\n * })\n * const exit = Fx.run(program)\n * // => { _tag: \"Ok\", value: 3 }\n * ```\n *\n * @module\n */\nimport { fromNullable as optionFromNullable } from \"../option/option\"\nimport { ok as resultOk, err as resultErr, fromTry as resultTry } from \"../result/result\"\nimport type { RetrySchedule, SyncRetrySchedule } from \"../schedule/schedule\"\nimport { asServiceRequest } from \"../service/service-resolution\"\nimport { dual } from \"../shared/dual\"\nimport type { Exit as ExitType } from \"./exit\"\nimport { forEach as fxForEach } from \"./foreach\"\nimport { runSync, runAsync } from \"./fx.runtime\"\nimport { FxTypeId } from \"./fx.types\"\nimport type { RunnableFx, SyncFx, AsyncFx, FxYield, Fx as FxProtocol, FxGenerator, AsyncFxGenerator } from \"./fx.types\"\nexport {\n  /**\n   * `Exit` utilities namespace for `Fx.run` outcomes.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * const exit = Fx.Exit.ok(1)\n   * // => { _tag: \"Ok\", value: 1 }\n   * ```\n   *\n   */\n  Exit,\n} from \"./exit\"\nexport {\n  /**\n   * Type guard for Fx service requests.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * const request = { _tag: \"ServiceRequest\", serviceKey: \"Logger\" } as Fx.ServiceRequest<unknown>\n   * const isRequest = Fx.isServiceRequest(request)\n   * // => true\n   * ```\n   *\n   */\n  isServiceRequest,\n} from \"./fx.types\"\nexport {\n  /**\n   * Runtime unique symbol identifying Fx values.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * const marker = { [Fx.FxTypeId]: true }\n   * // => Object.getOwnPropertySymbols(marker).includes(Fx.FxTypeId)\n   * ```\n   *\n   */\n  FxTypeId,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported core Fx protocol type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.Fx<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type Fx,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported synchronous Fx type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.SyncFx<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type SyncFx,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported asynchronous Fx type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.AsyncFx<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type AsyncFx,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported runnable Fx union type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.RunnableFx<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type RunnableFx,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported service-request protocol type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.ServiceRequest<unknown>\n   * ```\n   *\n   */\n  type ServiceRequest,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported helper extracting Fx success type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxValue<Fx.SyncFx<number>>\n   * ```\n   *\n   */\n  type FxValue,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported helper extracting Fx error type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxError<Fx.SyncFx<number, string>>\n   * ```\n   *\n   */\n  type FxError,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported helper extracting Fx requirements type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxRequirements<Fx.SyncFx<number, never, { readonly svc: unknown }>>\n   * ```\n   *\n   */\n  type FxRequirements,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported generator yield union for Fx internals.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxYield<unknown, unknown>\n   * ```\n   *\n   */\n  type FxYield,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported sync generator signature used by `Fx.gen`.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxGenerator<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type FxGenerator,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported async generator signature used by `Fx.gen`.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.AsyncFxGenerator<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type AsyncFxGenerator,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported sync Fx yieldable protocol type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxYieldable<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type FxYieldable,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported async Fx yieldable protocol type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.AsyncFxYieldable<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type AsyncFxYieldable,\n} from \"./fx.types\"\n\n/* oxlint-disable no-unsafe-type-assertion, no-unsafe-assignment, no-unsafe-call, no-unsafe-member-access, no-unsafe-return, no-unsafe-argument, no-unnecessary-type-assertion -- Fx runtime adapters intentionally traverse erased generator channels and rehydrate typed effects through controlled dynamic boundaries. */\n\n// ============================================================================\n// Fx.run - Execute computations\n// ============================================================================\n\n/**\n * Execute a sync Fx computation and return the Exit.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * Only available when R = never (all dependencies provided).\n *\n * @param fx - The sync computation to execute\n * @returns Exit<A, E>\n */\nfunction fxRun<A, E>(fx: SyncFx<A, E>): ExitType<A, E>\n\n/**\n * Execute an async Fx computation and return a Promise of the Exit.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * Only available when R = never (all dependencies provided).\n *\n * @param fx - The async computation to execute\n * @returns Promise<Exit<A, E>>\n */\nfunction fxRun<A, E>(fx: AsyncFx<A, E>): Promise<ExitType<A, E>>\n\n/**\n * Execute an Fx computation (union type).\n * Returns Exit for sync, Promise<Exit> for async.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n */\nfunction fxRun<A, E>(fx: RunnableFx<A, E>): ExitType<A, E> | Promise<ExitType<A, E>>\n\n/**\n * Implementation of Fx.run.\n * Detects sync vs async and executes appropriately.\n */\nfunction fxRun<A, E>(fx: RunnableFx<A, E>): ExitType<A, E> | Promise<ExitType<A, E>> {\n  if (fx._tag === \"AsyncFx\") {\n    return runAsync(fx)\n  }\n  return runSync(fx)\n}\n\n// ============================================================================\n// Fx.retry - Retry failed computations\n// ============================================================================\n\nconst sleep = (ms: number): Promise<void> =>\n  new Promise((resolve) => {\n    setTimeout(resolve, ms)\n  })\n\nconst sleepIfNeeded = async (ms: number): Promise<void> => {\n  if (ms <= 0) {\n    return\n  }\n  await sleep(ms)\n}\n\nconst closeSyncAttempt = (gen: Generator<unknown, unknown, unknown>) => {\n  if (typeof gen.return === \"function\") {\n    gen.return(undefined)\n  }\n}\n\nconst closeAsyncAttempt = async (\n  gen: Generator<unknown, unknown, unknown> | AsyncGenerator<unknown, unknown, unknown>,\n) => {\n  if (typeof gen.return === \"function\") {\n    await gen.return(undefined)\n  }\n}\n\nconst makeSyncRetryFx = <A, E, R>(fx: SyncFx<A, E, R>, schedule: SyncRetrySchedule): SyncFx<A, E, R> => ({\n  _tag: \"SyncFx\",\n  [FxTypeId]: {\n    _A: () => undefined as unknown as A,\n    _E: () => undefined as unknown as E,\n    _R: () => undefined as unknown as R,\n  },\n  *[Symbol.iterator](): Generator<FxYield<E, R>, A, unknown> {\n    let retryAttempt = 0\n    attemptLoop: while (true) {\n      const gen = fx[Symbol.iterator]()\n      let result = gen.next()\n\n      while (result.done !== true) {\n        const yielded = result.value\n        const serviceRequest = asServiceRequest(yielded)\n        if (serviceRequest !== undefined) {\n          const injected = yield yielded as FxYield<E, R>\n          result = gen.next(injected)\n          continue\n        }\n\n        retryAttempt += 1\n        if (retryAttempt <= schedule.maxRetries) {\n          closeSyncAttempt(gen)\n          continue attemptLoop\n        }\n\n        // Forward the terminal typed failure to the outer runtime.\n        yield yielded as FxYield<E, R>\n        return undefined as never\n      }\n\n      return result.value\n    }\n  },\n})\n\n/* oxlint-disable no-await-in-loop -- retry execution is intentionally sequential across attempts and iterator steps. */\nconst makeAsyncRetryFx = <A, E, R>(fx: RunnableFx<A, E, R>, schedule: RetrySchedule): AsyncFx<A, E, R> => ({\n  _tag: \"AsyncFx\",\n  [FxTypeId]: {\n    _A: () => undefined as unknown as A,\n    _E: () => undefined as unknown as E,\n    _R: () => undefined as unknown as R,\n  },\n  async *[Symbol.asyncIterator](): AsyncGenerator<FxYield<E, R>, A, unknown> {\n    let retryAttempt = 0\n\n    attemptLoop: while (true) {\n      if (fx._tag === \"AsyncFx\") {\n        const gen = fx[Symbol.asyncIterator]()\n        // Sequential async iterator protocol: each step depends on the previous one.\n        let result = await gen.next()\n\n        while (result.done !== true) {\n          const yielded = result.value\n          const serviceRequest = asServiceRequest(yielded)\n          if (serviceRequest !== undefined) {\n            const injected = yield yielded as FxYield<E, R>\n            // oxlint-disable-next-line no-await-in-loop\n            result = await gen.next(injected)\n            continue\n          }\n\n          retryAttempt += 1\n          if (retryAttempt <= schedule.maxRetries) {\n            const delayMs = schedule.delayForAttempt(retryAttempt)\n            await sleepIfNeeded(delayMs)\n            await closeAsyncAttempt(gen)\n            continue attemptLoop\n          }\n\n          // Forward the terminal typed failure to the outer runtime.\n          yield yielded as FxYield<E, R>\n          return undefined as never\n        }\n\n        return result.value\n      }\n\n      const gen = fx[Symbol.iterator]()\n      let result = gen.next()\n\n      while (result.done !== true) {\n        const yielded = result.value\n        const serviceRequest = asServiceRequest(yielded)\n        if (serviceRequest !== undefined) {\n          const injected = yield yielded as FxYield<E, R>\n          result = gen.next(injected)\n          continue\n        }\n\n        retryAttempt += 1\n        if (retryAttempt <= schedule.maxRetries) {\n          const delayMs = schedule.delayForAttempt(retryAttempt)\n          await sleepIfNeeded(delayMs)\n          await closeAsyncAttempt(gen)\n          continue attemptLoop\n        }\n\n        // Forward the terminal typed failure to the outer runtime.\n        yield yielded as FxYield<E, R>\n        return undefined as never\n      }\n\n      return result.value\n    }\n  },\n})\n/* oxlint-enable no-await-in-loop */\n\n/**\n * Retry a computation according to the given schedule.\n *\n * Retries only typed failures (Err channel). Defects are not retried.\n */\ntype RetryResult<Fx extends RunnableFx<unknown, unknown, unknown>, S extends RetrySchedule> =\n  Fx extends AsyncFx<infer A, infer E, infer R>\n    ? AsyncFx<A, E, R>\n    : S extends SyncRetrySchedule\n      ? Fx extends SyncFx<infer A, infer E, infer R>\n        ? SyncFx<A, E, R>\n        : never\n      : Fx extends SyncFx<infer A, infer E, infer R>\n        ? AsyncFx<A, E, R>\n        : never\n\nconst fxRetry: {\n  <Fx extends RunnableFx<unknown, unknown, unknown>, S extends RetrySchedule>(fx: Fx, schedule: S): RetryResult<Fx, S>\n  <S extends RetrySchedule>(\n    schedule: S,\n  ): <Fx extends RunnableFx<unknown, unknown, unknown>>(fx: Fx) => RetryResult<Fx, S>\n} = dual(\n  2,\n  <Fx extends RunnableFx<unknown, unknown, unknown>, S extends RetrySchedule>(\n    fx: Fx,\n    schedule: S,\n  ): RetryResult<Fx, S> => {\n    if (fx._tag === \"AsyncFx\" || !schedule._sync) {\n      return makeAsyncRetryFx(fx, schedule) as RetryResult<Fx, S>\n    }\n    return makeSyncRetryFx(fx as SyncFx<unknown, unknown, unknown>, schedule as SyncRetrySchedule) as RetryResult<Fx, S>\n  },\n)\n\n// ============================================================================\n// Fx.gen - Create composable computations\n// ============================================================================\n\ntype FxGenError<Yielded> = Yielded extends FxProtocol<unknown, infer E, unknown> ? E : Yielded\ntype FxGenRequirements<Yielded> = Yielded extends FxProtocol<unknown, unknown, infer R> ? R : never\n\n/**\n * Create a composable computation from a sync generator function.\n * Returns a SyncFx that can be stored, passed around, and executed later.\n *\n * @template Yielded - The type of values yielded by the generator\n * @template A - The success value type\n * @param generatorFn - A function that returns a sync generator\n * @returns SyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Port = Service.tag<number>(\"Port\")\n * const readPort = Fx.gen(function* () {\n *   return yield* Port\n * })\n * const exit = Fx.run(Provide.service(Port, 3000)(readPort))\n * // => { _tag: \"Ok\", value: 3000 }\n * ```\n */\nfunction fxGen<Yielded, A>(\n  generatorFn: () => Generator<Yielded, A, unknown>,\n): SyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n\n/**\n * Create a composable computation from an async generator function.\n * Returns an AsyncFx that can be stored, passed around, and executed later.\n *\n * @template Yielded - The type of values yielded by the generator\n * @template A - The success value type\n * @param generatorFn - A function that returns an async generator\n * @returns AsyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Token = Service.tag<string>(\"Token\")\n * const readToken = Fx.gen(async function* () {\n *   const token = yield* Token\n *   const suffix = await Promise.resolve(\"-ok\")\n *   return `${token}${suffix}`\n * })\n * const exit = await Fx.run(Provide.service(Token, \"abc\")(readToken))\n * // => { _tag: \"Ok\", value: \"abc-ok\" }\n * ```\n */\nfunction fxGen<Yielded, A>(\n  generatorFn: () => AsyncGenerator<Yielded, A, unknown>,\n): AsyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n\n/**\n * Create a composable computation from a sync generator function that takes parameters.\n * Returns a factory function that, when called with parameters, produces a SyncFx.\n *\n * @template P - The parameter types (must be non-empty)\n * @template Yielded - The type of values yielded by the generator\n * @template A - The success value type\n * @param generatorFn - A function that takes parameters and returns a sync generator\n * @returns A factory function that produces SyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Port = Service.tag<number>(\"Port\")\n * const describePort = Fx.gen(function* (label: string) {\n *   const port = yield* Port\n *   return `${label}:${port}`\n * })\n * const exit = Fx.run(Provide.service(Port, 3000)(describePort(\"port\")))\n * // => { _tag: \"Ok\", value: \"port:3000\" }\n * ```\n */\nfunction fxGen<P extends [unknown, ...unknown[]], Yielded, A>(\n  generatorFn: (...params: P) => Generator<Yielded, A, unknown>,\n): (...params: P) => SyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n\n/**\n * Create a composable computation from an async generator function that takes parameters.\n * Returns a factory function that, when called with parameters, produces an AsyncFx.\n *\n * @template P - The parameter types (must be non-empty)\n * @template Yielded - The type of values yielded by the generator\n * @template A - The success value type\n * @param generatorFn - A function that takes parameters and returns an async generator\n * @returns A factory function that produces AsyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Token = Service.tag<string>(\"Token\")\n * const describeToken = Fx.gen(async function* (prefix: string) {\n *   const token = yield* Token\n *   const suffix = await Promise.resolve(\"!\")\n *   return `${prefix}:${token}${suffix}`\n * })\n * const exit = await Fx.run(Provide.service(Token, \"abc\")(describeToken(\"token\")))\n * // => { _tag: \"Ok\", value: \"token:abc!\" }\n * ```\n */\nfunction fxGen<P extends [unknown, ...unknown[]], Yielded, A>(\n  generatorFn: (...params: P) => AsyncGenerator<Yielded, A, unknown>,\n): (...params: P) => AsyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n\n/**\n * Implementation of unified Fx.gen function.\n * Detects sync vs async generator and returns appropriate computation type.\n * For parameterized generators (length > 0), returns a factory function.\n */\n// oxlint-disable-next-line no-explicit-any\nfunction fxGen(generatorFn: (...args: any[]) => any): any {\n  if (generatorFn.length > 0) {\n    return (...params: unknown[]) => fxGen(() => generatorFn(...params))\n  }\n\n  // Check if we're dealing with async generator\n  const testGen = generatorFn()\n  const isAsync = Symbol.asyncIterator in testGen\n\n  if (isAsync) {\n    return {\n      _tag: \"AsyncFx\",\n      [FxTypeId]: {\n        _A: () => undefined,\n        _E: () => undefined,\n        _R: () => undefined,\n      },\n      // oxlint-disable-next-line no-explicit-any\n      async *[Symbol.asyncIterator](): AsyncGenerator<any, any, unknown> {\n        const gen = generatorFn()\n        let result = await gen.next()\n\n        while (result.done !== true) {\n          // Pass through yields (errors or services as Fx values)\n          const injected = yield result.value\n          // oxlint-disable-next-line no-await-in-loop\n          result = await gen.next(injected)\n        }\n\n        return result.value\n      },\n    }\n  }\n\n  // Sync generator\n  return {\n    _tag: \"SyncFx\",\n    [FxTypeId]: {\n      _A: () => undefined,\n      _E: () => undefined,\n      _R: () => undefined,\n    },\n    // oxlint-disable-next-line no-explicit-any\n    *[Symbol.iterator](): Generator<any, any, unknown> {\n      const gen = generatorFn()\n      let result = gen.next()\n\n      while (result.done !== true) {\n        const injected = yield result.value\n        result = gen.next(injected)\n      }\n\n      return result.value\n    },\n  }\n}\n\n// ============================================================================\n// Fx.fn - Execute computations immediately\n// ============================================================================\n\ntype FxRunResult<F extends RunnableFx<unknown, unknown, unknown>> =\n  F extends AsyncFx<infer A, infer E, unknown>\n    ? Promise<ExitType<A, E>>\n    : F extends SyncFx<infer A, infer E, unknown>\n      ? ExitType<A, E>\n      : never\n\n/**\n * Execute a sync computation immediately and return the Exit.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * For computations without service dependencies.\n *\n * @template A - The success value type\n * @template E - The error type\n * @param generatorFn - A function that returns a sync generator\n * @returns Exit<A, E>\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const exit = Fx.fn(function* () {\n *   const a = yield* Fx.ok(10)\n *   const b = yield* Fx.ok(20)\n *   return a + b\n * })\n * // => { _tag: \"Ok\", value: 30 }\n * ```\n */\nfunction fxFn<A, E>(generatorFn: () => FxGenerator<A, E, never>): ExitType<A, E>\n\n/**\n * Execute an async computation immediately and return a Promise of the Exit.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * For computations without service dependencies.\n *\n * @template A - The success value type\n * @template E - The error type\n * @param generatorFn - A function that returns an async generator\n * @returns Promise<Exit<A, E>>\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const exit = await Fx.fn(async function* () {\n *   const value = await Promise.resolve(2)\n *   return value + 1\n * })\n * // => { _tag: \"Ok\", value: 3 }\n * ```\n */\nfunction fxFn<A, E>(generatorFn: () => AsyncFxGenerator<A, E, never>): Promise<ExitType<A, E>>\n\n/**\n * Execute a sync computation with service dependencies immediately.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * The second argument is required when the computation has service requirements (R ≠ never).\n *\n * @template A - The success value type\n * @template E - The error type from the computation\n * @template R - The required services type\n * @param generatorFn - A function that returns a sync generator with service requirements\n * @param provider - A function that provides the services (e.g., Provide.layer(AppLayer))\n * @returns Exit result from running the provided Fx (sync or async depending on provider output)\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Port = Service.tag<number>(\"Port\")\n *\n * const exit = Fx.fn(function* () {\n *   const port = yield* Port\n *   return port + 1\n * }, Provide.service(Port, 3000))\n * // => { _tag: \"Ok\", value: 3001 }\n * ```\n */\nfunction fxFn<A, E, R, ProvidedFx extends RunnableFx<unknown, unknown, unknown>>(\n  generatorFn: () => FxGenerator<A, E, R>,\n  provider: (fx: SyncFx<A, E, R>) => ProvidedFx,\n): FxRunResult<ProvidedFx>\n\n/**\n * Execute an async computation with service dependencies immediately.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * The second argument is required when the computation has service requirements (R ≠ never).\n *\n * @template A - The success value type\n * @template E - The error type from the computation\n * @template R - The required services type\n * @param generatorFn - A function that returns an async generator with service requirements\n * @param provider - A function that provides the services (e.g., Provide.layer(AppLayer))\n * @returns Exit result from running the provided Fx (sync or async depending on provider output)\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Token = Service.tag<string>(\"Token\")\n *\n * const exit = await Fx.fn(async function* () {\n *   const token = yield* Token\n *   const suffix = await Promise.resolve(\"!\")\n *   return `${token}${suffix}`\n * }, Provide.service(Token, \"abc\"))\n * // => { _tag: \"Ok\", value: \"abc!\" }\n * ```\n */\nfunction fxFn<A, E, R, ProvidedFx extends RunnableFx<unknown, unknown, unknown>>(\n  generatorFn: () => AsyncFxGenerator<A, E, R>,\n  provider: (fx: AsyncFx<A, E, R>) => ProvidedFx,\n): FxRunResult<ProvidedFx>\n\n/**\n * Implementation of Fx.fn.\n * Reuses fxGen() for Fx creation and fxRun() for execution to ensure consistent behavior.\n */\nfunction fxFn<A, E, E2, R>(\n  generatorFn: () => FxGenerator<A, E, R> | AsyncFxGenerator<A, E, R>,\n  provider?: ((fx: SyncFx<A, E, R>) => RunnableFx<A, E | E2>) | ((fx: AsyncFx<A, E, R>) => RunnableFx<A, E | E2>),\n): ExitType<A, E | E2> | Promise<ExitType<A, E | E2>> {\n  // Create the Fx using fxGen (single source of truth for Fx creation)\n  // Type cast needed because fxGen infers E/R from yielded Fx values,\n  // while fxFn receives E/R as explicit type parameters\n  // oxlint-disable-next-line no-explicit-any\n  const fx = fxGen(generatorFn as any) as RunnableFx<A, E, R>\n\n  if (provider) {\n    // Apply provider and run\n    const provided =\n      fx._tag === \"AsyncFx\"\n        ? (provider as (fx: AsyncFx<A, E, R>) => RunnableFx<A, E | E2>)(fx)\n        : (provider as (fx: SyncFx<A, E, R>) => RunnableFx<A, E | E2>)(fx)\n    return fxRun(provided as RunnableFx<A, E | E2>) as ExitType<A, E | E2> | Promise<ExitType<A, E | E2>>\n  }\n\n  // No provider - run directly (R must be never at the type level)\n  return fxRun(fx as RunnableFx<A, E | E2>) as ExitType<A, E | E2> | Promise<ExitType<A, E | E2>>\n}\n\n// ============================================================================\n// Fx.ok / Fx.err / Fx.option - Convenience aliases\n// ============================================================================\n\n/**\n * Convenience alias for Result.ok.\n * Creates a successful Result that can be yielded in an Fx computation.\n *\n * @param value - The success value\n * @returns Result<T, never>\n *\n * @example\n * ```ts\n * const workflow = Fx.gen(function* () {\n *   const value = yield* Fx.ok(42)\n *   return value * 2\n * })\n * ```\n */\nconst fxOk = resultOk\n\n/**\n * Convenience alias for Result.err.\n * Creates an error Result that can be yielded in an Fx computation.\n *\n * @param error - The error value\n * @returns Result<never, E>\n *\n * @example\n * ```ts\n * const workflow = Fx.gen(function* () {\n *   const config = yield* Config\n *\n *   if (!config.dbUrl) {\n *     return yield* Fx.err(new ValidationError({ field: \"dbUrl\" }))\n *   }\n *\n *   return config.dbUrl\n * })\n * ```\n */\nconst fxErr = resultErr\n\n/**\n * Convenience alias for Result.try.\n * Creates a Result that can be yielded in an Fx computation.\n *\n * @param fn - A function that returns a value or throws an error\n * @returns Result<T, E>\n *\n * @example\n * ```ts\n * const result = Fx.try(() => {\n *   return 42\n * })\n *\n * const workflow = Fx.gen(function* () {\n *   const result = yield* Fx.try(() => {\n *     return 42\n *   })\n *   return result\n * })\n * ```\n */\nconst fxTry = resultTry\n\n/**\n * Convenience alias for Option.fromNullable.\n * Converts nullable values into an Option that can be yielded in an Fx computation.\n *\n * @param value - A possibly nullish value\n * @returns Option<NonNullable<T>>\n *\n * @example\n * ```ts\n * const workflow = Fx.gen(function* () {\n *   const apiKey = yield* Fx.option(request.headers[\"x-api-key\"])\n *   return apiKey\n * })\n * ```\n */\nconst fxOption = optionFromNullable\n\n// ============================================================================\n// Fx.match - Universal pattern matching\n// ============================================================================\n\n/**\n * Handler functions for matching on a tagged union by `_tag` discriminator.\n * Each handler receives the narrowed variant corresponding to its tag key.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * type Example = typeof Fx\n * ```\n */\nexport type TaggedMatch<T extends { readonly _tag: string }, R> = {\n  readonly [K in T[\"_tag\"]]: (variant: Extract<T, { readonly _tag: K }>) => R\n}\n\n/**\n * Generic pattern matcher for any `_tag`-based discriminated union.\n *\n * Works with Exit, tagged errors, or any type with a `readonly _tag` discriminator.\n * Each handler receives the full narrowed variant object for its tag.\n *\n * Supports both data-first and data-last (pipe) calling styles.\n *\n * @example\n * ```ts\n * // Match on Exit\n * Fx.match(exit, {\n *   Ok: (ok) => ok.value,\n *   Err: (err) =>\n *     Fx.match(err.error, {\n *       DatabaseError: (e) => e.message,\n *       NotFoundError: (e) => e.resourceId,\n *     }),\n *   Defect: (d) => String(d.defect),\n * })\n *\n * // Data-last with pipe\n * pipe(exit, Fx.match({\n *   Ok: (ok) => ok.value,\n *   Err: (err) => \"error\",\n *   Defect: (d) => \"defect\",\n * }))\n * ```\n */\nconst fxMatch: {\n  <T extends { readonly _tag: string }, R>(value: T, handlers: TaggedMatch<T, R>): R\n  <T extends { readonly _tag: string }, R>(handlers: TaggedMatch<T, R>): (value: T) => R\n} = dual(\n  2,\n  // oxlint-disable-next-line no-explicit-any\n  (value: any, handlers: any): any => handlers[value._tag](value),\n)\n\n// ============================================================================\n// Exports\n// ============================================================================\n\n/**\n * Build typed computations from generator functions.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const program = Fx.gen(function* () {\n *   const value = yield* Fx.ok(2)\n *   return value + 1\n * })\n * const exit = Fx.run(program)\n * // => { _tag: \"Ok\", value: 3 }\n * ```\n */\nexport const gen = fxGen\n\n/**\n * Run a generator function immediately and return its `Exit`.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const exit = Fx.fn(function* () {\n *   return yield* Fx.ok(2)\n * })\n * // => { _tag: \"Ok\", value: 2 }\n * ```\n */\nexport const fn = fxFn\n\n/**\n * Execute an existing `Fx` value and produce an `Exit`.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const exit = Fx.run(Fx.gen(function* () {\n *   return 1\n * }))\n * // => { _tag: \"Ok\", value: 1 }\n * ```\n */\nexport const run = fxRun\n\n/**\n * Retry failed computations according to a schedule.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * import { Schedule } from \"@nicolastoulemont/std\"\n *\n * const retried = Fx.retry(\n *   Fx.gen(function* () {\n *     return yield* Fx.err(\"boom\")\n *   }),\n *   Schedule.recurs(2),\n * )\n * const exit = Fx.run(retried)\n * // => { _tag: \"Err\", error: \"boom\" }\n * ```\n */\nexport const retry = fxRetry\n\n/**\n * Run an effectful function for each item in a collection.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const fx = Fx.forEach([1, 2, 3], (n) => Fx.gen(function* () {\n *   return n * 2\n * }))\n * // => AsyncFx<readonly number[], ...>\n * ```\n */\nexport const forEach = fxForEach\n\n/**\n * Alias for `Result.ok` in `Fx` namespace.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const value = Fx.ok(42)\n * // => { _tag: \"Ok\", value: 42 }\n * ```\n */\nexport const ok = fxOk\n\n/**\n * Alias for `Result.err` in `Fx` namespace.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const value = Fx.err(\"boom\")\n * // => { _tag: \"Err\", error: \"boom\" }\n * ```\n */\nexport const err = fxErr\n\n/**\n * Alias for `Option.fromNullable` in `Fx` namespace.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const value = Fx.option(\"token\")\n * // => { _tag: \"Some\", value: \"token\" }\n * ```\n */\nexport const option = fxOption\n\nconst try_ = fxTry\n\nexport {\n  /**\n   * Alias for `Result.fromTry` in `Fx` namespace.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * const parsed = Fx.try(() => Number.parseInt(\"42\", 10))\n   * // => { _tag: \"Ok\", value: 42 }\n   * ```\n   *\n   */\n  try_ as try,\n}\n\n/**\n * Pattern matching helper for tagged unions.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const value = Fx.match({ _tag: \"Ok\", value: 2 } as const, {\n *   Ok: (ok) => ok.value + 1,\n * })\n * // => 3\n * ```\n */\nexport const match = fxMatch\n\n/* oxlint-enable no-unsafe-type-assertion, no-unsafe-assignment, no-unsafe-call, no-unsafe-member-access, no-unsafe-return, no-unsafe-argument, no-unnecessary-type-assertion */\n"],"mappings":"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"}
+{"version":3,"file":"fx-C_RTDEpv.mjs","names":["gen","result","makeQueue","gen","result","resultOk","resultErr","resultTry","optionFromNullable"],"sources":["../src/fx/foreach.ts","../src/fx/fx.ts"],"sourcesContent":["import { NoSuchElementError } from \"../option/option.types\"\nimport { make as makeQueue, QueueAbortedError, QueueClosedError, QueueTaskAbortedError } from \"../queue/queue\"\nimport type { Concurrency } from \"../queue/queue.types\"\nimport { asServiceRequest } from \"../service/service-resolution\"\nimport { dual } from \"../shared/dual\"\nimport { FxTypeId } from \"./fx.types\"\nimport type { AsyncFx, FxError, FxRequirements, FxValue, FxYield, RunnableFx } from \"./fx.types\"\n\n/* oxlint-disable no-await-in-loop -- Fx.forEach coordinates child iterators and queue scheduling sequentially at specific yield points. */\n\ntype ForEachValue<Discard extends boolean, B> = Discard extends true ? void : Array<B>\n\ntype FxForEachOptions<Discard extends boolean = false> = {\n  readonly concurrency?: Concurrency\n  readonly discard?: Discard\n}\n\ntype ForEachFx<\n  F extends (a: never, i: number) => RunnableFx<unknown, unknown, unknown>,\n  Discard extends boolean,\n> = AsyncFx<ForEachValue<Discard, FxValue<ReturnType<F>>>, FxError<ReturnType<F>>, FxRequirements<ReturnType<F>>>\n\ntype FxForEach = {\n  <A, F extends (a: A, i: number) => RunnableFx<unknown, unknown, unknown>, const Discard extends boolean = false>(\n    self: Iterable<A>,\n    f: F,\n    options?: FxForEachOptions<Discard>,\n  ): ForEachFx<F, Discard>\n  <A, F extends (a: A, i: number) => RunnableFx<unknown, unknown, unknown>, const Discard extends boolean = false>(\n    f: F,\n    options?: FxForEachOptions<Discard>,\n  ): (self: Iterable<A>) => ForEachFx<F, Discard>\n}\n\ntype ServiceRequestEntry<E, R> = {\n  readonly yielded: FxYield<E, R>\n  readonly signal: AbortSignal\n  readonly resolve: (value: unknown) => void\n  readonly reject: (reason: Error) => void\n}\n\ntype ResultErrShape = {\n  readonly _tag: \"Err\"\n  readonly error: unknown\n}\n\nclass TypedFailure<E> extends Error {\n  readonly _tag = \"TypedFailure\"\n\n  constructor(readonly error: E) {\n    super(\"TypedFailure\")\n    this.name = \"TypedFailure\"\n  }\n}\n\nconst isTypedFailure = <E>(value: unknown): value is TypedFailure<E> => value instanceof TypedFailure\n\nconst isResultErr = (value: unknown): value is ResultErrShape =>\n  typeof value === \"object\" && value !== null && \"_tag\" in value && value._tag === \"Err\" && \"error\" in value\n\nconst toFailureValue = (yielded: unknown): unknown => {\n  if (yielded instanceof NoSuchElementError) {\n    return yielded\n  }\n\n  if (isResultErr(yielded)) {\n    return yielded.error\n  }\n\n  return yielded\n}\n\nconst isIterable = (value: unknown): value is Iterable<unknown> =>\n  value !== null &&\n  value !== undefined &&\n  typeof (value as { [Symbol.iterator]?: unknown })[Symbol.iterator] === \"function\"\n\nconst queueTaskAbortedError = (signal: AbortSignal): QueueTaskAbortedError =>\n  new QueueTaskAbortedError({ reason: signal.reason })\n\nconst toError = (reason: unknown): Error =>\n  reason instanceof Error ? reason : new Error(\"Fx.forEach defect was not an Error\", { cause: reason })\n\nconst unreachableType = (): never => {\n  throw new Error(\"Unreachable: Fx type marker should never execute at runtime\")\n}\n\nconst typeMarker = <A>(): (() => A) => unreachableType\n\nconst runMappedFx = async <B, E, R>(\n  fx: RunnableFx<B, E, R>,\n  signal: AbortSignal,\n  requestService: (yielded: FxYield<E, R>, signal: AbortSignal) => Promise<unknown>,\n): Promise<B> => {\n  if (fx._tag === \"AsyncFx\") {\n    const gen = fx[Symbol.asyncIterator]()\n    let result = await gen.next()\n\n    while (result.done !== true) {\n      if (signal.aborted) {\n        throw queueTaskAbortedError(signal)\n      }\n\n      const yielded = result.value\n      const serviceRequest = asServiceRequest(yielded)\n      if (serviceRequest !== undefined) {\n        const injected = await requestService(yielded, signal)\n        result = await gen.next(injected)\n        continue\n      }\n\n      // oxlint-disable-next-line typescript-eslint/no-unsafe-type-assertion -- failure channel values come from generic E at runtime.\n      throw new TypedFailure<E>(toFailureValue(yielded) as E)\n    }\n\n    return result.value\n  }\n\n  const gen = fx[Symbol.iterator]()\n  let result = gen.next()\n\n  while (result.done !== true) {\n    if (signal.aborted) {\n      throw queueTaskAbortedError(signal)\n    }\n\n    const yielded = result.value\n    const serviceRequest = asServiceRequest(yielded)\n    if (serviceRequest !== undefined) {\n      const injected = await requestService(yielded, signal)\n      result = gen.next(injected)\n      continue\n    }\n\n    // oxlint-disable-next-line typescript-eslint/no-unsafe-type-assertion -- failure channel values come from generic E at runtime.\n    throw new TypedFailure<E>(toFailureValue(yielded) as E)\n  }\n\n  return result.value\n}\n\nconst fxForEach = dual(\n  (args) => isIterable(args[0]) && typeof args[1] === \"function\",\n  <A, B, E, R>(\n    self: Iterable<A>,\n    f: (a: A, i: number) => RunnableFx<B, E, R>,\n    options?: FxForEachOptions<boolean>,\n  ): AsyncFx<Array<B> | void, E, R> => {\n    const items = [...self]\n    const discard = options?.discard === true\n\n    const program: AsyncFx<Array<B> | void, E, R> = {\n      _tag: \"AsyncFx\",\n      [FxTypeId]: {\n        _A: typeMarker<Array<B> | void>(),\n        _E: typeMarker<E>(),\n        _R: typeMarker<R>(),\n      },\n      async *[Symbol.asyncIterator](): AsyncGenerator<FxYield<E, R>, Array<B> | void, unknown> {\n        if (items.length === 0) {\n          return discard ? undefined : []\n        }\n\n        const queue = makeQueue({ concurrency: options?.concurrency ?? \"unbounded\" })\n        const results: Array<B> | undefined = discard ? undefined : []\n\n        let remaining = items.length\n        let firstFailure: E | undefined\n        let firstDefect: Error | undefined\n        let queueAborted = false\n\n        const serviceRequests: ServiceRequestEntry<E, R>[] = []\n        const eventWaiters = new Set<() => void>()\n\n        const notifyEvent = () => {\n          for (const resolve of eventWaiters) {\n            resolve()\n          }\n          eventWaiters.clear()\n        }\n\n        const waitForEvent = () =>\n          new Promise<void>((resolve) => {\n            eventWaiters.add(resolve)\n          })\n\n        const requestService = (yielded: FxYield<E, R>, signal: AbortSignal): Promise<unknown> => {\n          if (signal.aborted) {\n            return Promise.reject(queueTaskAbortedError(signal))\n          }\n\n          return new Promise<unknown>((resolve, reject) => {\n            const entry: ServiceRequestEntry<E, R> = {\n              yielded,\n              signal,\n              resolve: (value) => {\n                signal.removeEventListener(\"abort\", onAbort)\n                resolve(value)\n              },\n              reject: (reason) => {\n                signal.removeEventListener(\"abort\", onAbort)\n                reject(reason)\n              },\n            }\n\n            const onAbort = () => {\n              const index = serviceRequests.indexOf(entry)\n              if (index !== -1) {\n                serviceRequests.splice(index, 1)\n              }\n              reject(queueTaskAbortedError(signal))\n            }\n\n            signal.addEventListener(\"abort\", onAbort, { once: true })\n            serviceRequests.push(entry)\n            notifyEvent()\n          })\n        }\n\n        const rejectPendingServiceRequests = (reason: Error) => {\n          const pending = serviceRequests.splice(0)\n          for (const request of pending) {\n            request.reject(reason)\n          }\n        }\n\n        const abortQueue = (reason: unknown) => {\n          if (queueAborted) {\n            return\n          }\n\n          queueAborted = true\n          void queue.shutdown({ mode: \"abort\", reason }).catch(() => {\n            // no-op: fail-fast cleanup should never interrupt parent error handling\n          })\n        }\n\n        const onTaskFailure = (error: unknown) => {\n          if (isTypedFailure<E>(error)) {\n            if (firstFailure === undefined && firstDefect === undefined) {\n              firstFailure = error.error\n              abortQueue(error.error)\n            }\n            return\n          }\n\n          if (\n            (error instanceof QueueAbortedError ||\n              error instanceof QueueTaskAbortedError ||\n              error instanceof QueueClosedError) &&\n            (firstFailure !== undefined || firstDefect !== undefined)\n          ) {\n            return\n          }\n\n          if (firstDefect === undefined && firstFailure === undefined) {\n            const defect = toError(error)\n            firstDefect = defect\n            abortQueue(defect)\n          }\n        }\n\n        const onTaskSettled = () => {\n          remaining -= 1\n          notifyEvent()\n        }\n\n        for (const [index, item] of items.entries()) {\n          void queue\n            .enqueue(async ({ signal }) => {\n              const value = await runMappedFx(f(item, index), signal, requestService)\n              if (results !== undefined) {\n                results[index] = value\n              }\n            })\n            .catch(onTaskFailure)\n            .finally(onTaskSettled)\n        }\n\n        while (true) {\n          if (firstDefect !== undefined) {\n            rejectPendingServiceRequests(firstDefect)\n            throw new Error(\"Fx.forEach defect\", { cause: firstDefect })\n          }\n\n          if (firstFailure !== undefined) {\n            rejectPendingServiceRequests(new QueueAbortedError({ reason: firstFailure }))\n            yield firstFailure\n            throw new Error(\"Unreachable: Fx runtime short-circuits on first failure\")\n          }\n\n          const request = serviceRequests.shift()\n          if (request !== undefined) {\n            if (request.signal.aborted) {\n              request.reject(queueTaskAbortedError(request.signal))\n              continue\n            }\n\n            try {\n              const injected = yield request.yielded\n              request.resolve(injected)\n            } catch (error) {\n              request.reject(toError(error))\n            }\n            continue\n          }\n\n          if (remaining === 0) {\n            break\n          }\n\n          await waitForEvent()\n        }\n\n        return discard ? undefined : results\n      },\n    }\n\n    return program\n  },\n) as FxForEach\n\nexport { fxForEach as forEach }\n\n/* oxlint-enable no-await-in-loop */\n","/**\n * Lightweight effect runtime with typed success, error, and requirement channels.\n *\n * **Mental model**\n * - `Fx<A, E, R>` models computations that may fail and require services.\n * - Build with `Fx.gen`, run with `Fx.run`, and compose with `Layer`/`Provide`.\n *\n * **Common tasks**\n * - Create workflows with `Fx.gen`.\n * - Execute with `Fx.run` or `Fx.fn`.\n * - Retry with `Fx.retry` and match outcomes with `Fx.match`.\n *\n * **Gotchas**\n * - Dependencies (`R`) must be provided before execution.\n * - `Fx.run` returns `Exit`, not raw values.\n *\n * **Quickstart**\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const program = Fx.gen(function* () {\n *   const value = yield* Fx.ok(2)\n *   return value + 1\n * })\n * const exit = Fx.run(program)\n * // => { _tag: \"Ok\", value: 3 }\n * ```\n *\n * @module\n */\nimport { fromNullable as optionFromNullable } from \"../option/option\"\nimport { ok as resultOk, err as resultErr, fromTry as resultTry } from \"../result/result\"\nimport type { RetrySchedule, SyncRetrySchedule } from \"../schedule/schedule\"\nimport { asServiceRequest } from \"../service/service-resolution\"\nimport { dual } from \"../shared/dual\"\nimport type { Exit as ExitType } from \"./exit\"\nimport { forEach as fxForEach } from \"./foreach\"\nimport { runSync, runAsync } from \"./fx.runtime\"\nimport { FxTypeId } from \"./fx.types\"\nimport type { RunnableFx, SyncFx, AsyncFx, FxYield, Fx as FxProtocol, FxGenerator, AsyncFxGenerator } from \"./fx.types\"\nexport {\n  /**\n   * `Exit` utilities namespace for `Fx.run` outcomes.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * const exit = Fx.Exit.ok(1)\n   * // => { _tag: \"Ok\", value: 1 }\n   * ```\n   *\n   */\n  Exit,\n} from \"./exit\"\nexport {\n  /**\n   * Type guard for Fx service requests.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * const request = { _tag: \"ServiceRequest\", serviceKey: \"Logger\" } as Fx.ServiceRequest<unknown>\n   * const isRequest = Fx.isServiceRequest(request)\n   * // => true\n   * ```\n   *\n   */\n  isServiceRequest,\n} from \"./fx.types\"\nexport {\n  /**\n   * Runtime unique symbol identifying Fx values.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * const marker = { [Fx.FxTypeId]: true }\n   * // => Object.getOwnPropertySymbols(marker).includes(Fx.FxTypeId)\n   * ```\n   *\n   */\n  FxTypeId,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported core Fx protocol type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.Fx<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type Fx,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported synchronous Fx type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.SyncFx<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type SyncFx,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported asynchronous Fx type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.AsyncFx<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type AsyncFx,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported runnable Fx union type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.RunnableFx<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type RunnableFx,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported service-request protocol type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.ServiceRequest<unknown>\n   * ```\n   *\n   */\n  type ServiceRequest,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported helper extracting Fx success type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxValue<Fx.SyncFx<number>>\n   * ```\n   *\n   */\n  type FxValue,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported helper extracting Fx error type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxError<Fx.SyncFx<number, string>>\n   * ```\n   *\n   */\n  type FxError,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported helper extracting Fx requirements type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxRequirements<Fx.SyncFx<number, never, { readonly svc: unknown }>>\n   * ```\n   *\n   */\n  type FxRequirements,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported generator yield union for Fx internals.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxYield<unknown, unknown>\n   * ```\n   *\n   */\n  type FxYield,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported sync generator signature used by `Fx.gen`.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxGenerator<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type FxGenerator,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported async generator signature used by `Fx.gen`.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.AsyncFxGenerator<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type AsyncFxGenerator,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported sync Fx yieldable protocol type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.FxYieldable<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type FxYieldable,\n} from \"./fx.types\"\nexport {\n  /**\n   * Re-exported async Fx yieldable protocol type.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * type Example = Fx.AsyncFxYieldable<unknown, unknown, unknown>\n   * ```\n   *\n   */\n  type AsyncFxYieldable,\n} from \"./fx.types\"\n\n/* oxlint-disable no-unsafe-type-assertion, no-unsafe-assignment, no-unsafe-call, no-unsafe-member-access, no-unsafe-return, no-unsafe-argument, no-unnecessary-type-assertion -- Fx runtime adapters intentionally traverse erased generator channels and rehydrate typed effects through controlled dynamic boundaries. */\n\n// ============================================================================\n// Fx.run - Execute computations\n// ============================================================================\n\n/**\n * Execute a sync Fx computation and return the Exit.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * Only available when R = never (all dependencies provided).\n *\n * @param fx - The sync computation to execute\n * @returns Exit<A, E>\n */\nfunction fxRun<A, E>(fx: SyncFx<A, E>): ExitType<A, E>\n\n/**\n * Execute an async Fx computation and return a Promise of the Exit.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * Only available when R = never (all dependencies provided).\n *\n * @param fx - The async computation to execute\n * @returns Promise<Exit<A, E>>\n */\nfunction fxRun<A, E>(fx: AsyncFx<A, E>): Promise<ExitType<A, E>>\n\n/**\n * Execute an Fx computation (union type).\n * Returns Exit for sync, Promise<Exit> for async.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n */\nfunction fxRun<A, E>(fx: RunnableFx<A, E>): ExitType<A, E> | Promise<ExitType<A, E>>\n\n/**\n * Implementation of Fx.run.\n * Detects sync vs async and executes appropriately.\n */\nfunction fxRun<A, E>(fx: RunnableFx<A, E>): ExitType<A, E> | Promise<ExitType<A, E>> {\n  if (fx._tag === \"AsyncFx\") {\n    return runAsync(fx)\n  }\n  return runSync(fx)\n}\n\n// ============================================================================\n// Fx.retry - Retry failed computations\n// ============================================================================\n\nconst sleep = (ms: number): Promise<void> =>\n  new Promise((resolve) => {\n    setTimeout(resolve, ms)\n  })\n\nconst sleepIfNeeded = async (ms: number): Promise<void> => {\n  if (ms <= 0) {\n    return\n  }\n  await sleep(ms)\n}\n\nconst closeSyncAttempt = (gen: Generator<unknown, unknown, unknown>) => {\n  if (typeof gen.return === \"function\") {\n    gen.return(undefined)\n  }\n}\n\nconst closeAsyncAttempt = async (\n  gen: Generator<unknown, unknown, unknown> | AsyncGenerator<unknown, unknown, unknown>,\n) => {\n  if (typeof gen.return === \"function\") {\n    await gen.return(undefined)\n  }\n}\n\nconst makeSyncRetryFx = <A, E, R>(fx: SyncFx<A, E, R>, schedule: SyncRetrySchedule): SyncFx<A, E, R> => ({\n  _tag: \"SyncFx\",\n  [FxTypeId]: {\n    _A: () => undefined as unknown as A,\n    _E: () => undefined as unknown as E,\n    _R: () => undefined as unknown as R,\n  },\n  *[Symbol.iterator](): Generator<FxYield<E, R>, A, unknown> {\n    let retryAttempt = 0\n    attemptLoop: while (true) {\n      const gen = fx[Symbol.iterator]()\n      let result = gen.next()\n\n      while (result.done !== true) {\n        const yielded = result.value\n        const serviceRequest = asServiceRequest(yielded)\n        if (serviceRequest !== undefined) {\n          const injected = yield yielded as FxYield<E, R>\n          result = gen.next(injected)\n          continue\n        }\n\n        retryAttempt += 1\n        if (retryAttempt <= schedule.maxRetries) {\n          closeSyncAttempt(gen)\n          continue attemptLoop\n        }\n\n        // Forward the terminal typed failure to the outer runtime.\n        yield yielded as FxYield<E, R>\n        return undefined as never\n      }\n\n      return result.value\n    }\n  },\n})\n\n/* oxlint-disable no-await-in-loop -- retry execution is intentionally sequential across attempts and iterator steps. */\nconst makeAsyncRetryFx = <A, E, R>(fx: RunnableFx<A, E, R>, schedule: RetrySchedule): AsyncFx<A, E, R> => ({\n  _tag: \"AsyncFx\",\n  [FxTypeId]: {\n    _A: () => undefined as unknown as A,\n    _E: () => undefined as unknown as E,\n    _R: () => undefined as unknown as R,\n  },\n  async *[Symbol.asyncIterator](): AsyncGenerator<FxYield<E, R>, A, unknown> {\n    let retryAttempt = 0\n\n    attemptLoop: while (true) {\n      if (fx._tag === \"AsyncFx\") {\n        const gen = fx[Symbol.asyncIterator]()\n        // Sequential async iterator protocol: each step depends on the previous one.\n        let result = await gen.next()\n\n        while (result.done !== true) {\n          const yielded = result.value\n          const serviceRequest = asServiceRequest(yielded)\n          if (serviceRequest !== undefined) {\n            const injected = yield yielded as FxYield<E, R>\n            // oxlint-disable-next-line no-await-in-loop\n            result = await gen.next(injected)\n            continue\n          }\n\n          retryAttempt += 1\n          if (retryAttempt <= schedule.maxRetries) {\n            const delayMs = schedule.delayForAttempt(retryAttempt)\n            await sleepIfNeeded(delayMs)\n            await closeAsyncAttempt(gen)\n            continue attemptLoop\n          }\n\n          // Forward the terminal typed failure to the outer runtime.\n          yield yielded as FxYield<E, R>\n          return undefined as never\n        }\n\n        return result.value\n      }\n\n      const gen = fx[Symbol.iterator]()\n      let result = gen.next()\n\n      while (result.done !== true) {\n        const yielded = result.value\n        const serviceRequest = asServiceRequest(yielded)\n        if (serviceRequest !== undefined) {\n          const injected = yield yielded as FxYield<E, R>\n          result = gen.next(injected)\n          continue\n        }\n\n        retryAttempt += 1\n        if (retryAttempt <= schedule.maxRetries) {\n          const delayMs = schedule.delayForAttempt(retryAttempt)\n          await sleepIfNeeded(delayMs)\n          await closeAsyncAttempt(gen)\n          continue attemptLoop\n        }\n\n        // Forward the terminal typed failure to the outer runtime.\n        yield yielded as FxYield<E, R>\n        return undefined as never\n      }\n\n      return result.value\n    }\n  },\n})\n/* oxlint-enable no-await-in-loop */\n\n/**\n * Retry a computation according to the given schedule.\n *\n * Retries only typed failures (Err channel). Defects are not retried.\n */\ntype RetryResult<Fx extends RunnableFx<unknown, unknown, unknown>, S extends RetrySchedule> =\n  Fx extends AsyncFx<infer A, infer E, infer R>\n    ? AsyncFx<A, E, R>\n    : S extends SyncRetrySchedule\n      ? Fx extends SyncFx<infer A, infer E, infer R>\n        ? SyncFx<A, E, R>\n        : never\n      : Fx extends SyncFx<infer A, infer E, infer R>\n        ? AsyncFx<A, E, R>\n        : never\n\nconst fxRetry: {\n  <Fx extends RunnableFx<unknown, unknown, unknown>, S extends RetrySchedule>(fx: Fx, schedule: S): RetryResult<Fx, S>\n  <S extends RetrySchedule>(\n    schedule: S,\n  ): <Fx extends RunnableFx<unknown, unknown, unknown>>(fx: Fx) => RetryResult<Fx, S>\n} = dual(\n  2,\n  <Fx extends RunnableFx<unknown, unknown, unknown>, S extends RetrySchedule>(\n    fx: Fx,\n    schedule: S,\n  ): RetryResult<Fx, S> => {\n    if (fx._tag === \"AsyncFx\" || !schedule._sync) {\n      return makeAsyncRetryFx(fx, schedule) as RetryResult<Fx, S>\n    }\n    return makeSyncRetryFx(fx as SyncFx<unknown, unknown, unknown>, schedule as SyncRetrySchedule) as RetryResult<Fx, S>\n  },\n)\n\n// ============================================================================\n// Fx.gen - Create composable computations\n// ============================================================================\n\ntype FxGenError<Yielded> = Yielded extends FxProtocol<unknown, infer E, unknown> ? E : Yielded\ntype FxGenRequirements<Yielded> = Yielded extends FxProtocol<unknown, unknown, infer R> ? R : never\n\n/**\n * Create a composable computation from a sync generator function.\n * Returns a SyncFx that can be stored, passed around, and executed later.\n *\n * @template Yielded - The type of values yielded by the generator\n * @template A - The success value type\n * @param generatorFn - A function that returns a sync generator\n * @returns SyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Port = Service.tag<number>(\"Port\")\n * const readPort = Fx.gen(function* () {\n *   return yield* Port\n * })\n * const exit = Fx.run(Provide.service(Port, 3000)(readPort))\n * // => { _tag: \"Ok\", value: 3000 }\n * ```\n */\nfunction fxGen<Yielded, A>(\n  generatorFn: () => Generator<Yielded, A, unknown>,\n): SyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n\n/**\n * Create a composable computation from an async generator function.\n * Returns an AsyncFx that can be stored, passed around, and executed later.\n *\n * @template Yielded - The type of values yielded by the generator\n * @template A - The success value type\n * @param generatorFn - A function that returns an async generator\n * @returns AsyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Token = Service.tag<string>(\"Token\")\n * const readToken = Fx.gen(async function* () {\n *   const token = yield* Token\n *   const suffix = await Promise.resolve(\"-ok\")\n *   return `${token}${suffix}`\n * })\n * const exit = await Fx.run(Provide.service(Token, \"abc\")(readToken))\n * // => { _tag: \"Ok\", value: \"abc-ok\" }\n * ```\n */\nfunction fxGen<Yielded, A>(\n  generatorFn: () => AsyncGenerator<Yielded, A, unknown>,\n): AsyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n\n/**\n * Create a composable computation from a sync generator function that takes parameters.\n * Returns a factory function that, when called with parameters, produces a SyncFx.\n *\n * @template P - The parameter types (must be non-empty)\n * @template Yielded - The type of values yielded by the generator\n * @template A - The success value type\n * @param generatorFn - A function that takes parameters and returns a sync generator\n * @returns A factory function that produces SyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Port = Service.tag<number>(\"Port\")\n * const describePort = Fx.gen(function* (label: string) {\n *   const port = yield* Port\n *   return `${label}:${port}`\n * })\n * const exit = Fx.run(Provide.service(Port, 3000)(describePort(\"port\")))\n * // => { _tag: \"Ok\", value: \"port:3000\" }\n * ```\n */\nfunction fxGen<P extends [unknown, ...unknown[]], Yielded, A>(\n  generatorFn: (...params: P) => Generator<Yielded, A, unknown>,\n): (...params: P) => SyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n\n/**\n * Create a composable computation from an async generator function that takes parameters.\n * Returns a factory function that, when called with parameters, produces an AsyncFx.\n *\n * @template P - The parameter types (must be non-empty)\n * @template Yielded - The type of values yielded by the generator\n * @template A - The success value type\n * @param generatorFn - A function that takes parameters and returns an async generator\n * @returns A factory function that produces AsyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Token = Service.tag<string>(\"Token\")\n * const describeToken = Fx.gen(async function* (prefix: string) {\n *   const token = yield* Token\n *   const suffix = await Promise.resolve(\"!\")\n *   return `${prefix}:${token}${suffix}`\n * })\n * const exit = await Fx.run(Provide.service(Token, \"abc\")(describeToken(\"token\")))\n * // => { _tag: \"Ok\", value: \"token:abc!\" }\n * ```\n */\nfunction fxGen<P extends [unknown, ...unknown[]], Yielded, A>(\n  generatorFn: (...params: P) => AsyncGenerator<Yielded, A, unknown>,\n): (...params: P) => AsyncFx<A, FxGenError<Yielded>, FxGenRequirements<Yielded>>\n\n/**\n * Implementation of unified Fx.gen function.\n * Detects sync vs async generator and returns appropriate computation type.\n * For parameterized generators (length > 0), returns a factory function.\n */\n// oxlint-disable-next-line no-explicit-any\nfunction fxGen(generatorFn: (...args: any[]) => any): any {\n  if (generatorFn.length > 0) {\n    return (...params: unknown[]) => fxGen(() => generatorFn(...params))\n  }\n\n  // Check if we're dealing with async generator\n  const testGen = generatorFn()\n  const isAsync = Symbol.asyncIterator in testGen\n\n  if (isAsync) {\n    return {\n      _tag: \"AsyncFx\",\n      [FxTypeId]: {\n        _A: () => undefined,\n        _E: () => undefined,\n        _R: () => undefined,\n      },\n      // oxlint-disable-next-line no-explicit-any\n      async *[Symbol.asyncIterator](): AsyncGenerator<any, any, unknown> {\n        const gen = generatorFn()\n        let result = await gen.next()\n\n        while (result.done !== true) {\n          // Pass through yields (errors or services as Fx values)\n          const injected = yield result.value\n          // oxlint-disable-next-line no-await-in-loop\n          result = await gen.next(injected)\n        }\n\n        return result.value\n      },\n    }\n  }\n\n  // Sync generator\n  return {\n    _tag: \"SyncFx\",\n    [FxTypeId]: {\n      _A: () => undefined,\n      _E: () => undefined,\n      _R: () => undefined,\n    },\n    // oxlint-disable-next-line no-explicit-any\n    *[Symbol.iterator](): Generator<any, any, unknown> {\n      const gen = generatorFn()\n      let result = gen.next()\n\n      while (result.done !== true) {\n        const injected = yield result.value\n        result = gen.next(injected)\n      }\n\n      return result.value\n    },\n  }\n}\n\n// ============================================================================\n// Fx.fn - Execute computations immediately\n// ============================================================================\n\ntype FxRunResult<F extends RunnableFx<unknown, unknown, unknown>> =\n  F extends AsyncFx<infer A, infer E, unknown>\n    ? Promise<ExitType<A, E>>\n    : F extends SyncFx<infer A, infer E, unknown>\n      ? ExitType<A, E>\n      : never\n\n/**\n * Execute a sync computation immediately and return the Exit.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * For computations without service dependencies.\n *\n * @template A - The success value type\n * @template E - The error type\n * @param generatorFn - A function that returns a sync generator\n * @returns Exit<A, E>\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const exit = Fx.fn(function* () {\n *   const a = yield* Fx.ok(10)\n *   const b = yield* Fx.ok(20)\n *   return a + b\n * })\n * // => { _tag: \"Ok\", value: 30 }\n * ```\n */\nfunction fxFn<A, E>(generatorFn: () => FxGenerator<A, E, never>): ExitType<A, E>\n\n/**\n * Execute an async computation immediately and return a Promise of the Exit.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * For computations without service dependencies.\n *\n * @template A - The success value type\n * @template E - The error type\n * @param generatorFn - A function that returns an async generator\n * @returns Promise<Exit<A, E>>\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const exit = await Fx.fn(async function* () {\n *   const value = await Promise.resolve(2)\n *   return value + 1\n * })\n * // => { _tag: \"Ok\", value: 3 }\n * ```\n */\nfunction fxFn<A, E>(generatorFn: () => AsyncFxGenerator<A, E, never>): Promise<ExitType<A, E>>\n\n/**\n * Execute a sync computation with service dependencies immediately.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * The second argument is required when the computation has service requirements (R ≠ never).\n *\n * @template A - The success value type\n * @template E - The error type from the computation\n * @template R - The required services type\n * @param generatorFn - A function that returns a sync generator with service requirements\n * @param provider - A function that provides the services (e.g., Provide.layer(AppLayer))\n * @returns Exit result from running the provided Fx (sync or async depending on provider output)\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Port = Service.tag<number>(\"Port\")\n *\n * const exit = Fx.fn(function* () {\n *   const port = yield* Port\n *   return port + 1\n * }, Provide.service(Port, 3000))\n * // => { _tag: \"Ok\", value: 3001 }\n * ```\n */\nfunction fxFn<A, E, R, ProvidedFx extends RunnableFx<unknown, unknown, unknown>>(\n  generatorFn: () => FxGenerator<A, E, R>,\n  provider: (fx: SyncFx<A, E, R>) => ProvidedFx,\n): FxRunResult<ProvidedFx>\n\n/**\n * Execute an async computation with service dependencies immediately.\n * Catches unexpected thrown exceptions and wraps them as Defect.\n * The second argument is required when the computation has service requirements (R ≠ never).\n *\n * @template A - The success value type\n * @template E - The error type from the computation\n * @template R - The required services type\n * @param generatorFn - A function that returns an async generator with service requirements\n * @param provider - A function that provides the services (e.g., Provide.layer(AppLayer))\n * @returns Exit result from running the provided Fx (sync or async depending on provider output)\n *\n * @example\n * ```ts\n * import { Fx, Provide, Service } from \"@nicolastoulemont/std\"\n *\n * const Token = Service.tag<string>(\"Token\")\n *\n * const exit = await Fx.fn(async function* () {\n *   const token = yield* Token\n *   const suffix = await Promise.resolve(\"!\")\n *   return `${token}${suffix}`\n * }, Provide.service(Token, \"abc\"))\n * // => { _tag: \"Ok\", value: \"abc!\" }\n * ```\n */\nfunction fxFn<A, E, R, ProvidedFx extends RunnableFx<unknown, unknown, unknown>>(\n  generatorFn: () => AsyncFxGenerator<A, E, R>,\n  provider: (fx: AsyncFx<A, E, R>) => ProvidedFx,\n): FxRunResult<ProvidedFx>\n\n/**\n * Implementation of Fx.fn.\n * Reuses fxGen() for Fx creation and fxRun() for execution to ensure consistent behavior.\n */\nfunction fxFn<A, E, E2, R>(\n  generatorFn: () => FxGenerator<A, E, R> | AsyncFxGenerator<A, E, R>,\n  provider?: ((fx: SyncFx<A, E, R>) => RunnableFx<A, E | E2>) | ((fx: AsyncFx<A, E, R>) => RunnableFx<A, E | E2>),\n): ExitType<A, E | E2> | Promise<ExitType<A, E | E2>> {\n  // Create the Fx using fxGen (single source of truth for Fx creation)\n  // Type cast needed because fxGen infers E/R from yielded Fx values,\n  // while fxFn receives E/R as explicit type parameters\n  // oxlint-disable-next-line no-explicit-any\n  const fx = fxGen(generatorFn as any) as RunnableFx<A, E, R>\n\n  if (provider) {\n    // Apply provider and run\n    const provided =\n      fx._tag === \"AsyncFx\"\n        ? (provider as (fx: AsyncFx<A, E, R>) => RunnableFx<A, E | E2>)(fx)\n        : (provider as (fx: SyncFx<A, E, R>) => RunnableFx<A, E | E2>)(fx)\n    return fxRun(provided as RunnableFx<A, E | E2>) as ExitType<A, E | E2> | Promise<ExitType<A, E | E2>>\n  }\n\n  // No provider - run directly (R must be never at the type level)\n  return fxRun(fx as RunnableFx<A, E | E2>) as ExitType<A, E | E2> | Promise<ExitType<A, E | E2>>\n}\n\n// ============================================================================\n// Fx.ok / Fx.err / Fx.option - Convenience aliases\n// ============================================================================\n\n/**\n * Convenience alias for Result.ok.\n * Creates a successful Result that can be yielded in an Fx computation.\n *\n * @param value - The success value\n * @returns Result<T, never>\n *\n * @example\n * ```ts\n * const workflow = Fx.gen(function* () {\n *   const value = yield* Fx.ok(42)\n *   return value * 2\n * })\n * ```\n */\nconst fxOk = resultOk\n\n/**\n * Convenience alias for Result.err.\n * Creates an error Result that can be yielded in an Fx computation.\n *\n * @param error - The error value\n * @returns Result<never, E>\n *\n * @example\n * ```ts\n * const workflow = Fx.gen(function* () {\n *   const config = yield* Config\n *\n *   if (!config.dbUrl) {\n *     return yield* Fx.err(new ValidationError({ field: \"dbUrl\" }))\n *   }\n *\n *   return config.dbUrl\n * })\n * ```\n */\nconst fxErr = resultErr\n\n/**\n * Convenience alias for Result.try.\n * Creates a Result that can be yielded in an Fx computation.\n *\n * @param fn - A function that returns a value or throws an error\n * @returns Result<T, E>\n *\n * @example\n * ```ts\n * const result = Fx.try(() => {\n *   return 42\n * })\n *\n * const workflow = Fx.gen(function* () {\n *   const result = yield* Fx.try(() => {\n *     return 42\n *   })\n *   return result\n * })\n * ```\n */\nconst fxTry = resultTry\n\n/**\n * Convenience alias for Option.fromNullable.\n * Converts nullable values into an Option that can be yielded in an Fx computation.\n *\n * @param value - A possibly nullish value\n * @returns Option<NonNullable<T>>\n *\n * @example\n * ```ts\n * const workflow = Fx.gen(function* () {\n *   const apiKey = yield* Fx.option(request.headers[\"x-api-key\"])\n *   return apiKey\n * })\n * ```\n */\nconst fxOption = optionFromNullable\n\n// ============================================================================\n// Fx.match - Universal pattern matching\n// ============================================================================\n\n/**\n * Handler functions for matching on a tagged union by `_tag` discriminator.\n * Each handler receives the narrowed variant corresponding to its tag key.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * type Example = typeof Fx\n * ```\n */\nexport type TaggedMatch<T extends { readonly _tag: string }, R> = {\n  readonly [K in T[\"_tag\"]]: (variant: Extract<T, { readonly _tag: K }>) => R\n}\n\n/**\n * Generic pattern matcher for any `_tag`-based discriminated union.\n *\n * Works with Exit, tagged errors, or any type with a `readonly _tag` discriminator.\n * Each handler receives the full narrowed variant object for its tag.\n *\n * Supports both data-first and data-last (pipe) calling styles.\n *\n * @example\n * ```ts\n * // Match on Exit\n * Fx.match(exit, {\n *   Ok: (ok) => ok.value,\n *   Err: (err) =>\n *     Fx.match(err.error, {\n *       DatabaseError: (e) => e.message,\n *       NotFoundError: (e) => e.resourceId,\n *     }),\n *   Defect: (d) => String(d.defect),\n * })\n *\n * // Data-last with pipe\n * pipe(exit, Fx.match({\n *   Ok: (ok) => ok.value,\n *   Err: (err) => \"error\",\n *   Defect: (d) => \"defect\",\n * }))\n * ```\n */\nconst fxMatch: {\n  <T extends { readonly _tag: string }, R>(value: T, handlers: TaggedMatch<T, R>): R\n  <T extends { readonly _tag: string }, R>(handlers: TaggedMatch<T, R>): (value: T) => R\n} = dual(\n  2,\n  // oxlint-disable-next-line no-explicit-any\n  (value: any, handlers: any): any => handlers[value._tag](value),\n)\n\n// ============================================================================\n// Exports\n// ============================================================================\n\n/**\n * Build typed computations from generator functions.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const program = Fx.gen(function* () {\n *   const value = yield* Fx.ok(2)\n *   return value + 1\n * })\n * const exit = Fx.run(program)\n * // => { _tag: \"Ok\", value: 3 }\n * ```\n */\nexport const gen = fxGen\n\n/**\n * Run a generator function immediately and return its `Exit`.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const exit = Fx.fn(function* () {\n *   return yield* Fx.ok(2)\n * })\n * // => { _tag: \"Ok\", value: 2 }\n * ```\n */\nexport const fn = fxFn\n\n/**\n * Execute an existing `Fx` value and produce an `Exit`.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const exit = Fx.run(Fx.gen(function* () {\n *   return 1\n * }))\n * // => { _tag: \"Ok\", value: 1 }\n * ```\n */\nexport const run = fxRun\n\n/**\n * Retry failed computations according to a schedule.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * import { Schedule } from \"@nicolastoulemont/std\"\n *\n * const retried = Fx.retry(\n *   Fx.gen(function* () {\n *     return yield* Fx.err(\"boom\")\n *   }),\n *   Schedule.recurs(2),\n * )\n * const exit = Fx.run(retried)\n * // => { _tag: \"Err\", error: \"boom\" }\n * ```\n */\nexport const retry = fxRetry\n\n/**\n * Run an effectful function for each item in a collection.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const fx = Fx.forEach([1, 2, 3], (n) => Fx.gen(function* () {\n *   return n * 2\n * }))\n * // => AsyncFx<readonly number[], ...>\n * ```\n */\nexport const forEach = fxForEach\n\n/**\n * Alias for `Result.ok` in `Fx` namespace.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const value = Fx.ok(42)\n * // => { _tag: \"Ok\", value: 42 }\n * ```\n */\nexport const ok = fxOk\n\n/**\n * Alias for `Result.err` in `Fx` namespace.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const value = Fx.err(\"boom\")\n * // => { _tag: \"Err\", error: \"boom\" }\n * ```\n */\nexport const err = fxErr\n\n/**\n * Alias for `Option.fromNullable` in `Fx` namespace.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const value = Fx.option(\"token\")\n * // => { _tag: \"Some\", value: \"token\" }\n * ```\n */\nexport const option = fxOption\n\nconst try_ = fxTry\n\nexport {\n  /**\n   * Alias for `Result.fromTry` in `Fx` namespace.\n   *\n   * @example\n   * ```ts\n   * import { Fx } from \"@nicolastoulemont/std\"\n   *\n   * const parsed = Fx.try(() => Number.parseInt(\"42\", 10))\n   * // => { _tag: \"Ok\", value: 42 }\n   * ```\n   *\n   */\n  try_ as try,\n}\n\n/**\n * Pattern matching helper for tagged unions.\n *\n * @example\n * ```ts\n * import { Fx } from \"@nicolastoulemont/std\"\n *\n * const value = Fx.match({ _tag: \"Ok\", value: 2 } as const, {\n *   Ok: (ok) => ok.value + 1,\n * })\n * // => 3\n * ```\n */\nexport const match = fxMatch\n\n/* oxlint-enable no-unsafe-type-assertion, no-unsafe-assignment, no-unsafe-call, no-unsafe-member-access, no-unsafe-return, no-unsafe-argument, no-unnecessary-type-assertion */\n"],"mappings":"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"}