@onrails/result 0.1.0

package/dist/mcp.js

@@ -0,0 +1,284 @@
+// src/result.ts
+var ok = (value) => ({
+  _tag: "Ok",
+  value
+});
+var err = (error) => ({
+  _tag: "Err",
+  error
+});
+var isOk = (result) => result._tag === "Ok";
+var isErr = (result) => result._tag === "Err";
+var mapImpl = (result, fn) => isOk(result) ? ok(fn(result.value)) : err(result.error);
+function map(...args) {
+  if (args.length === 2) return mapImpl(args[0], args[1]);
+  const fn = args[0];
+  return (result) => mapImpl(result, fn);
+}
+var mapErrImpl = (result, fn) => isErr(result) ? err(fn(result.error)) : ok(result.value);
+function mapErr(...args) {
+  if (args.length === 2) return mapErrImpl(args[0], args[1]);
+  const fn = args[0];
+  return (result) => mapErrImpl(result, fn);
+}
+
+// src/types.ts
+var UnexpectedError = class extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "UnexpectedError";
+  }
+  cause;
+};
+
+// src/async.ts
+var liftPromiseResult = async (promise, onDefect) => {
+  try {
+    const result = await promise;
+    if (isErr(result)) {
+      return result;
+    }
+    const inner = result.value;
+    if (inner && typeof inner === "object" && "_tag" in inner) {
+      if (inner._tag === "Ok" || inner._tag === "Err") {
+        return inner;
+      }
+    }
+    return result;
+  } catch (error) {
+    return err(onDefect(error));
+  }
+};
+var ResultAsync = class _ResultAsync {
+  constructor(run) {
+    this.run = run;
+  }
+  run;
+  static fromResult(result) {
+    return new _ResultAsync(async () => result);
+  }
+  static fromPromise(promise, onReject) {
+    return new _ResultAsync(async () => {
+      try {
+        return ok(await promise);
+      } catch (error) {
+        return err(onReject(error));
+      }
+    });
+  }
+  static fromSafePromise(promise) {
+    return new _ResultAsync(async () => ok(await promise));
+  }
+  /**
+   * Defers work until {@link resolve}. Unlike {@link fromPromise}, nothing runs
+   * until the `ResultAsync` is resolved (e.g. by `combineTuple` / `combineTupleParallel`).
+   */
+  static defer(fn) {
+    return new _ResultAsync(fn);
+  }
+  static ok(value) {
+    return new _ResultAsync(async () => ok(value));
+  }
+  static err(error) {
+    return new _ResultAsync(async () => err(error));
+  }
+  /** @see {@link fromAsync} from `@onrails/result/interop` */
+  static fromResultPromise(promise, onDefect) {
+    const mapDefect = onDefect ?? ((error) => new UnexpectedError("Unexpected async defect", error));
+    return new _ResultAsync(() => liftPromiseResult(promise, mapDefect));
+  }
+  static combine(results) {
+    return new _ResultAsync(async () => {
+      const values = [];
+      for (const ra of results) {
+        const result = await ra.resolve();
+        if (isErr(result)) {
+          return err(result.error);
+        }
+        values.push(result.value);
+      }
+      return ok(values);
+    });
+  }
+  static combineTuple(results) {
+    return new _ResultAsync(async () => {
+      const values = [];
+      for (const ra of results) {
+        const result = await ra.resolve();
+        if (isErr(result)) {
+          return err(result.error);
+        }
+        values.push(result.value);
+      }
+      return ok(values);
+    });
+  }
+  /**
+   * Like {@link combineTuple}, but starts every branch before awaiting (wall-clock
+   * parallel for independent IO). On failure, returns the first `Err` in input order.
+   */
+  static combineTupleParallel(results) {
+    return new _ResultAsync(async () => {
+      const settled = await Promise.all(results.map((ra) => ra.resolve()));
+      const values = [];
+      for (const result of settled) {
+        if (isErr(result)) {
+          return err(result.error);
+        }
+        values.push(result.value);
+      }
+      return ok(values);
+    });
+  }
+  map(fn) {
+    return new _ResultAsync(async () => map(await this.run(), fn));
+  }
+  mapErr(fn) {
+    return new _ResultAsync(async () => mapErr(await this.run(), fn));
+  }
+  flatMap(fn) {
+    return new _ResultAsync(async () => {
+      const first = await this.run();
+      if (isErr(first)) {
+        return err(first.error);
+      }
+      const next = fn(first.value);
+      if (next instanceof _ResultAsync) {
+        return next.resolve();
+      }
+      if (isResultLike(next)) {
+        return next;
+      }
+      if (isCompatLike(next)) {
+        return next.inner;
+      }
+      return next;
+    });
+  }
+  andThen(fn) {
+    return this.flatMap(fn);
+  }
+  chain(fn) {
+    return this.flatMap(fn);
+  }
+  recover(fn) {
+    return new _ResultAsync(async () => {
+      const first = await this.run();
+      if (!isErr(first)) {
+        return first;
+      }
+      const next = fn(first.error);
+      if (next instanceof _ResultAsync) {
+        return next.resolve();
+      }
+      return next;
+    });
+  }
+  orElse(fn) {
+    return this.recover(fn);
+  }
+  tap(fn) {
+    return new _ResultAsync(async () => {
+      const result = await this.run();
+      if (!isErr(result)) {
+        fn(result.value);
+      }
+      return result;
+    });
+  }
+  tapErr(fn) {
+    return new _ResultAsync(async () => {
+      const result = await this.run();
+      if (isErr(result)) {
+        fn(result.error);
+      }
+      return result;
+    });
+  }
+  unwrapOr(defaultValue) {
+    return this.run().then((result) => isErr(result) ? defaultValue : result.value);
+  }
+  isOk() {
+    return this.run().then((result) => !isErr(result));
+  }
+  isErr() {
+    return this.run().then((result) => isErr(result));
+  }
+  match(onOk, onErr) {
+    return this.run().then(
+      (result) => isErr(result) ? onErr(result.error) : onOk(result.value)
+    );
+  }
+  resolve() {
+    return this.run();
+  }
+  /**
+   * Thenable shim — `await ra` resolves to a bare tagged-union `Result<T, E>`.
+   * Narrow with `isOk(r)` / `isErr(r)` to read `.value` / `.error`.
+   */
+  // biome-ignore lint/suspicious/noThenProperty: makes ResultAsync awaitable
+  then(onfulfilled, onrejected) {
+    return this.run().then(
+      (r) => onfulfilled ? onfulfilled(r) : r,
+      onrejected ?? void 0
+    );
+  }
+};
+function isResultLike(v) {
+  return typeof v === "object" && v !== null && "_tag" in v && (v._tag === "Ok" || v._tag === "Err");
+}
+function isCompatLike(v) {
+  return typeof v === "object" && v !== null && "inner" in v && isResultLike(v.inner);
+}
+
+// src/interop.ts
+function fromAsync(fn, onDefect) {
+  return (...args) => ResultAsync.fromResultPromise(fn(...args), onDefect);
+}
+
+// src/mcp.ts
+var unwrapFetchResult = (result, toError) => {
+  if (result.error !== void 0 || result.data === void 0) {
+    return err(toError({ error: result.error, response: result.response }));
+  }
+  return ok(result.data);
+};
+var extractFetchErrorDetail = (error, response) => {
+  if (error === void 0 || error === null) {
+    return response.statusText || "unknown error";
+  }
+  const raw = typeof error === "object" ? JSON.stringify(error) : String(error);
+  const lower = raw.toLowerCase();
+  if (lower.includes("<!doctype") || lower.includes("<html")) {
+    const statusHint = response.status === 403 ? "request blocked by CDN/WAF" : `unexpected HTML response (${response.status})`;
+    return `${statusHint} \u2014 retry after a short delay`;
+  }
+  return raw;
+};
+var unwrapFetchResultAsync = (promise, toError, onDefect) => fromAsync(() => promise.then((r) => unwrapFetchResult(r, toError)), onDefect)();
+var toToolResponse = (result) => {
+  if (isOk(result)) {
+    return {
+      structuredContent: result.value,
+      content: [{ type: "text", text: JSON.stringify(result.value, null, 2) }]
+    };
+  }
+  return {
+    content: [{ type: "text", text: result.error.message }],
+    isError: true
+  };
+};
+var toToolResponseAsync = async (resultAsync) => toToolResponse(await resultAsync.resolve());
+var toolOk = (data) => ({
+  structuredContent: data,
+  content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+});
+var toolError = (text) => ({
+  content: [{ type: "text", text }],
+  isError: true
+});
+
+export { extractFetchErrorDetail, toToolResponse, toToolResponseAsync, toolError, toolOk, unwrapFetchResult, unwrapFetchResultAsync };
+//# sourceMappingURL=mcp.js.map
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/result.ts","../src/types.ts","../src/async.ts","../src/interop.ts","../src/mcp.ts"],"names":[],"mappings":"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","file":"mcp.js","sourcesContent":["import type { Err, Ok, Result } from \"./types.js\";\n\nexport type { Err, Ok, Result } from \"./types.js\";\n\n/**\n * Lifts a value into the success track.\n *\n * @example\n * ```ts\n * const r = ok(42);                          // Result<number, never>\n * const typed: Result<number, \"parse\"> = ok(1);\n * ```\n */\nexport const ok = <T, E = never>(value: T): Result<T, E> => ({\n  _tag: \"Ok\",\n  value,\n});\n\n/**\n * Lifts a value into the error track.\n *\n * @example\n * ```ts\n * const r = err({ kind: \"parse\", message: \"bad json\" });\n * // Result<never, { kind: \"parse\"; message: string }>\n * ```\n */\nexport const err = <T = never, E = unknown>(error: E): Result<T, E> => ({\n  _tag: \"Err\",\n  error,\n});\n\n/**\n * Type-narrowing predicate: returns `true` when the result is `Ok`.\n *\n * @example\n * ```ts\n * if (isOk(r)) {\n *   console.log(r.value);    // narrowed to Ok branch\n * }\n * ```\n */\nexport const isOk = <T, E>(result: Result<T, E>): result is Ok<T, E> => result._tag === \"Ok\";\n\n/**\n * Type-narrowing predicate: returns `true` when the result is `Err`.\n *\n * @example\n * ```ts\n * if (isErr(r)) {\n *   metrics.inc(\"error\", { kind: r.error.kind });\n * }\n * ```\n */\nexport const isErr = <T, E>(result: Result<T, E>): result is Err<T, E> => result._tag === \"Err\";\n\n/** Fantasy Land `of` — alias of {@link ok}. */\nexport const of = ok;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Dual-form helpers — each export accepts either shape:\n//   data-first: `map(result, fn)`\n//   curried:    `map(fn)(result)`\n// Arity at the call site selects the overload.\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst mapImpl = <T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E> =>\n  isOk(result) ? ok(fn(result.value)) : err(result.error);\n\n/**\n * Transform the `Ok` value, passing `Err` through unchanged. Dual-form:\n * call data-first or curried (for use with {@link pipe}).\n *\n * @example\n * ```ts\n * map(ok(2), (n) => n * 3);          // Ok 6 — data-first\n * pipe(ok(\"x\"), map((s) => s.length));// Ok 1 — curried\n * ```\n */\nexport function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;\nexport function map<T, U>(fn: (value: T) => U): <E>(result: Result<T, E>) => Result<U, E>;\nexport function map(\n  ...args: [Result<unknown, unknown>, (value: unknown) => unknown] | [(value: unknown) => unknown]\n): unknown {\n  if (args.length === 2) return mapImpl(args[0], args[1]);\n  const fn = args[0];\n  return (result: Result<unknown, unknown>) => mapImpl(result, fn);\n}\n\nconst mapErrImpl = <T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F> =>\n  isErr(result) ? err(fn(result.error)) : ok(result.value);\n\n/**\n * Transform the `Err` value, passing `Ok` through unchanged. Useful for\n * unifying heterogeneous failure types into one app-level union.\n *\n * @example\n * ```ts\n * type AppError = { kind: \"http\"; status: number } | { kind: \"parse\" };\n * pipe(\n *   fetchSync(url),                                     // Result<Body, { status: number }>\n *   mapErr((e): AppError => ({ kind: \"http\", status: e.status })),\n * );\n * ```\n */\nexport function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;\nexport function mapErr<E, F>(fn: (error: E) => F): <T>(result: Result<T, E>) => Result<T, F>;\nexport function mapErr(\n  ...args: [Result<unknown, unknown>, (error: unknown) => unknown] | [(error: unknown) => unknown]\n): unknown {\n  if (args.length === 2) return mapErrImpl(args[0], args[1]);\n  const fn = args[0];\n  return (result: Result<unknown, unknown>) => mapErrImpl(result, fn);\n}\n\nconst bimapImpl = <T, U, E, F>(\n  result: Result<T, E>,\n  onOk: (value: T) => U,\n  onErr: (error: E) => F,\n): Result<U, F> => (isOk(result) ? ok(onOk(result.value)) : err(onErr(result.error)));\n\n/**\n * Transform both tracks at once — `Ok` via `onOk`, `Err` via `onErr`.\n * Equivalent to `mapErr(onErr)(map(onOk)(result))` but in one pass.\n *\n * @example\n * ```ts\n * bimap(parsed, (cfg) => cfg.name, (e) => ({ kind: \"input\", cause: e }));\n * ```\n */\nexport function bimap<T, U, E, F>(\n  result: Result<T, E>,\n  onOk: (value: T) => U,\n  onErr: (error: E) => F,\n): Result<U, F>;\nexport function bimap<T, U, E, F>(\n  onOk: (value: T) => U,\n  onErr: (error: E) => F,\n): (result: Result<T, E>) => Result<U, F>;\nexport function bimap(\n  ...args:\n    | [Result<unknown, unknown>, (value: unknown) => unknown, (error: unknown) => unknown]\n    | [(value: unknown) => unknown, (error: unknown) => unknown]\n): unknown {\n  if (args.length === 3) return bimapImpl(args[0], args[1], args[2]);\n  const [onOk, onErr] = args;\n  return (result: Result<unknown, unknown>) => bimapImpl(result, onOk, onErr);\n}\n\nconst flatMapImpl = <T, U, E, F>(\n  result: Result<T, E>,\n  fn: (value: T) => Result<U, F>,\n): Result<U, E | F> => (isOk(result) ? fn(result.value) : err(result.error));\n\n/**\n * Canonical bind (Fantasy Land `chain`). Chains a Result-returning step,\n * widening the error union to `E | F`. Short-circuits on `Err`.\n *\n * @example\n * ```ts\n * flatMap(parseInput(raw), (data) =>\n *   data.id != null ? ok(data) : err({ kind: \"missing_id\" as const }),\n * );\n * // Result<Data, ParseError | { kind: \"missing_id\" }>\n * ```\n */\nexport function flatMap<T, U, E, F>(\n  result: Result<T, E>,\n  fn: (value: T) => Result<U, F>,\n): Result<U, E | F>;\nexport function flatMap<T, U, F>(\n  fn: (value: T) => Result<U, F>,\n): <E>(result: Result<T, E>) => Result<U, E | F>;\nexport function flatMap(\n  ...args:\n    | [Result<unknown, unknown>, (value: unknown) => Result<unknown, unknown>]\n    | [(value: unknown) => Result<unknown, unknown>]\n): unknown {\n  if (args.length === 2) return flatMapImpl(args[0], args[1]);\n  const fn = args[0];\n  return (result: Result<unknown, unknown>) => flatMapImpl(result, fn);\n}\n\nconst recoverImpl = <T, E, F>(\n  result: Result<T, E>,\n  fn: (error: E) => Result<T, F>,\n): Result<T, F> => (isErr(result) ? fn(result.error) : ok(result.value));\n\n/**\n * Error-track bind — runs `fn` only when the result is `Err`, allowing\n * a failed workflow to recover to `Ok` or remap the failure. Mirror of\n * {@link flatMap} on the error channel.\n *\n * @example\n * ```ts\n * recover(networkResult, (e) =>\n *   e.kind === \"rate_limit\" ? ok(cachedBody) : err(e),\n * );\n * ```\n */\nexport function recover<T, E, F>(\n  result: Result<T, E>,\n  fn: (error: E) => Result<T, F>,\n): Result<T, F>;\nexport function recover<T, E, F>(\n  fn: (error: E) => Result<T, F>,\n): (result: Result<T, E>) => Result<T, F>;\nexport function recover(\n  ...args:\n    | [Result<unknown, unknown>, (error: unknown) => Result<unknown, unknown>]\n    | [(error: unknown) => Result<unknown, unknown>]\n): unknown {\n  if (args.length === 2) return recoverImpl(args[0], args[1]);\n  const fn = args[0];\n  return (result: Result<unknown, unknown>) => recoverImpl(result, fn);\n}\n\nconst tapImpl = <T, E>(result: Result<T, E>, fn: (value: T) => void): Result<T, E> => {\n  if (isOk(result)) fn(result.value);\n  return result;\n};\n\n/**\n * Observe the `Ok` value for side effects (logging, metrics) without\n * changing the carried value. Passes `Err` through untouched.\n *\n * @example\n * ```ts\n * pipe(\n *   parseConfig(raw),\n *   tap((cfg) => log.info({ msg: \"parsed\", name: cfg.name })),\n *   flatMap(validate),\n * );\n * ```\n */\nexport function tap<T, E>(result: Result<T, E>, fn: (value: T) => void): Result<T, E>;\nexport function tap<T>(fn: (value: T) => void): <E>(result: Result<T, E>) => Result<T, E>;\nexport function tap(\n  ...args: [Result<unknown, unknown>, (value: unknown) => void] | [(value: unknown) => void]\n): unknown {\n  if (args.length === 2) return tapImpl(args[0], args[1]);\n  const fn = args[0];\n  return (result: Result<unknown, unknown>) => tapImpl(result, fn);\n}\n\nconst tapErrImpl = <T, E>(result: Result<T, E>, fn: (error: E) => void): Result<T, E> => {\n  if (isErr(result)) fn(result.error);\n  return result;\n};\n\n/**\n * Observe the `Err` value for side effects (logging, metrics) without\n * changing the carried error. Passes `Ok` through untouched.\n *\n * @example\n * ```ts\n * pipe(\n *   loadUser(id),\n *   tapErr((e) => metrics.inc(\"user.load.fail\", { kind: e.kind })),\n * );\n * ```\n */\nexport function tapErr<T, E>(result: Result<T, E>, fn: (error: E) => void): Result<T, E>;\nexport function tapErr<E>(fn: (error: E) => void): <T>(result: Result<T, E>) => Result<T, E>;\nexport function tapErr(\n  ...args: [Result<unknown, unknown>, (error: unknown) => void] | [(error: unknown) => void]\n): unknown {\n  if (args.length === 2) return tapErrImpl(args[0], args[1]);\n  const fn = args[0];\n  return (result: Result<unknown, unknown>) => tapErrImpl(result, fn);\n}\n\nconst matchImpl = <T, E, U>(\n  result: Result<T, E>,\n  onOk: (value: T) => U,\n  onErr: (error: E) => U,\n): U => (isOk(result) ? onOk(result.value) : onErr(result.error));\n\n/**\n * Terminal collapse — fold both tracks into a single value. Dual-form:\n * 3-args data-first, 2-args curried for {@link pipe}. Returns whatever\n * the handlers return.\n *\n * For files that also import `match` from `ts-pattern`, the\n * collision-free alias {@link matchResult} is identical.\n *\n * @example\n * ```ts\n * const html = match(parsed, (cfg) => render(cfg), (e) => renderError(e));\n * ```\n */\nexport function match<T, E, U>(\n  result: Result<T, E>,\n  onOk: (value: T) => U,\n  onErr: (error: E) => U,\n): U;\nexport function match<T, E, U>(\n  onOk: (value: T) => U,\n  onErr: (error: E) => U,\n): (result: Result<T, E>) => U;\nexport function match(\n  ...args:\n    | [Result<unknown, unknown>, (value: unknown) => unknown, (error: unknown) => unknown]\n    | [(value: unknown) => unknown, (error: unknown) => unknown]\n): unknown {\n  if (args.length === 3) return matchImpl(args[0], args[1], args[2]);\n  const [onOk, onErr] = args;\n  return (result: Result<unknown, unknown>) => matchImpl(result, onOk, onErr);\n}\n\n/** Collision-free alias for files that also import `match` from ts-pattern. */\nexport const matchResult = match;\n\n/**\n * Curried collapse with named slots — escape valve when positional `match`\n * order is unclear at the call site (e.g. when both handlers return the same\n * type and a transposed `match(r, onErr, onOk)` would silently compile).\n */\nexport const fold =\n  <T, E, U>(handlers: { readonly ok: (value: T) => U; readonly err: (error: E) => U }) =>\n  (result: Result<T, E>): U =>\n    matchImpl(result, handlers.ok, handlers.err);\n\n/**\n * Returns the `Ok` value, or `defaultValue` when the result is `Err`.\n *\n * @example\n * ```ts\n * unwrapOr(parsedSetting, \"default-value\");\n * ```\n */\nexport const unwrapOr = <T, E>(result: Result<T, E>, defaultValue: T): T =>\n  isOk(result) ? result.value : defaultValue;\n\n/** Test/assert helper — throws the original Err value when called on Err. */\nexport function unwrapOk<T, E>(result: Result<T, E>): T {\n  if (isErr(result)) throw result.error;\n  return result.value;\n}\n\n/** Test/assert helper — throws TypeError when called on Ok. */\nexport function unwrapErr<T, E>(result: Result<T, E>): E {\n  if (isOk(result)) throw new TypeError(\"unwrapErr called on Ok\");\n  return result.error;\n}\n\n/** Wrap a throwing sync function — neverthrow `Result.fromThrowable` */\nexport function trySync<A extends readonly unknown[], T, E>(\n  fn: (...args: A) => T,\n  onThrow: (error: unknown) => E,\n): (...args: A) => Result<T, E>;\nexport function trySync<F extends (...args: never) => unknown, E>(\n  fn: F,\n  onThrow: (error: unknown) => E,\n): (...args: Parameters<F>) => Result<ReturnType<F>, E>;\nexport function trySync(\n  fn: (...args: never) => unknown,\n  onThrow: (error: unknown) => unknown,\n): (...args: never) => Result<unknown, unknown> {\n  return (...args: never) => {\n    try {\n      return ok(fn(...args));\n    } catch (error) {\n      return err(onThrow(error));\n    }\n  };\n}\n\n/** First failure wins; otherwise collects values in order */\nexport const combine = <T, E>(results: readonly Result<T, E>[]): Result<T[], E> => {\n  const values: T[] = [];\n  for (const result of results) {\n    if (isErr(result)) return err(result.error);\n    values.push(result.value);\n  }\n  return ok(values);\n};\n\n/** Tuple-preserving combine (neverthrow-style) */\nexport const combineTuple = <const R extends readonly Result<unknown, unknown>[]>(\n  results: R,\n): CombineTuple<R> => {\n  const values: unknown[] = [];\n  for (const result of results) {\n    if (isErr(result)) return err(result.error) as CombineTuple<R>;\n    values.push(result.value);\n  }\n  return ok(values) as CombineTuple<R>;\n};\n\ntype _OkValue<R> = R extends { _tag: \"Ok\"; readonly value: infer T } ? T : never;\ntype _ErrValue<R> = R extends { _tag: \"Err\"; readonly error: infer E } ? E : never;\n\ntype CombineTuple<R extends readonly Result<unknown, unknown>[]> = Result<\n  { [K in keyof R]: _OkValue<R[K]> },\n  { [K in keyof R]: _ErrValue<R[K]> }[number]\n>;\n\n/**\n * Variadic value-first pipe — threads `value` through up to nine unary fns.\n *\n * ```ts\n * pipe(\n *   parseConfig(raw),\n *   map((cfg) => cfg.name),\n *   flatMap((name) => name ? ok(name) : err({ kind: \"empty\" })),\n *   tap(log),\n * );\n * ```\n */\nexport function pipe<A>(value: A): A;\nexport function pipe<A, B>(value: A, ab: (a: A) => B): B;\nexport function pipe<A, B, C>(value: A, ab: (a: A) => B, bc: (b: B) => C): C;\nexport function pipe<A, B, C, D>(value: A, ab: (a: A) => B, bc: (b: B) => C, cd: (c: C) => D): D;\nexport function pipe<A, B, C, D, E>(\n  value: A,\n  ab: (a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n): E;\nexport function pipe<A, B, C, D, E, F>(\n  value: A,\n  ab: (a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n): F;\nexport function pipe<A, B, C, D, E, F, G>(\n  value: A,\n  ab: (a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n  fg: (f: F) => G,\n): G;\nexport function pipe<A, B, C, D, E, F, G, H>(\n  value: A,\n  ab: (a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n  fg: (f: F) => G,\n  gh: (g: G) => H,\n): H;\nexport function pipe<A, B, C, D, E, F, G, H, I>(\n  value: A,\n  ab: (a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n  fg: (f: F) => G,\n  gh: (g: G) => H,\n  hi: (h: H) => I,\n): I;\nexport function pipe(value: unknown, ...fns: ReadonlyArray<(x: unknown) => unknown>): unknown {\n  let acc = value;\n  for (const fn of fns) {\n    acc = fn(acc);\n  }\n  return acc;\n}\n","/** Tagged success/failure — no classes, tree-shake friendly. */\nexport type Result<T, E> =\n  | { readonly _tag: \"Ok\"; readonly value: T }\n  | { readonly _tag: \"Err\"; readonly error: E };\n\nexport type Ok<T, E = never> = Extract<Result<T, E>, { _tag: \"Ok\" }>;\nexport type Err<T, E> = Extract<Result<T, E>, { _tag: \"Err\" }>;\n\n/** Thrown defect mapped when {@link fromAsync} has no `onDefect` */\nexport class UnexpectedError extends Error {\n  constructor(\n    message: string,\n    override readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = \"UnexpectedError\";\n  }\n}\n","import { err, isErr, map, mapErr, ok } from \"./result.js\";\nimport type { Result } from \"./types.js\";\nimport { UnexpectedError } from \"./types.js\";\n\ntype PromiseFactory<T, E> = () => Promise<Result<T, E>>;\ntype AsyncOk<R> = R extends ResultAsync<infer T, unknown> ? T : never;\ntype AsyncErr<R> = R extends ResultAsync<unknown, infer E> ? E : never;\ntype CombineTupleAsync<R extends readonly ResultAsync<unknown, unknown>[]> = ResultAsync<\n  { [K in keyof R]: AsyncOk<R[K]> },\n  { [K in keyof R]: AsyncErr<R[K]> }[number]\n>;\n\nconst liftPromiseResult = async <T, E>(\n  promise: Promise<Result<T, E>>,\n  onDefect: (error: unknown) => E | UnexpectedError,\n): Promise<Result<T, E | UnexpectedError>> => {\n  try {\n    const result = await promise;\n    if (isErr(result)) {\n      return result;\n    }\n    const inner = result.value;\n    if (inner && typeof inner === \"object\" && \"_tag\" in inner) {\n      if (inner._tag === \"Ok\" || inner._tag === \"Err\") {\n        return inner as unknown as Result<T, E | UnexpectedError>;\n      }\n    }\n    return result;\n  } catch (error) {\n    return err(onDefect(error));\n  }\n};\n\n/**\n * Async result — public API never exposes `Promise<Result<…>>` directly;\n * await via `.resolve()` or `.match()`.\n */\nexport class ResultAsync<T, E> {\n  protected constructor(protected readonly run: PromiseFactory<T, E>) {}\n\n  static fromResult<T, E>(result: Result<T, E>): ResultAsync<T, E> {\n    return new ResultAsync(async () => result);\n  }\n\n  static fromPromise<T, E>(\n    promise: PromiseLike<T>,\n    onReject: (error: unknown) => E,\n  ): ResultAsync<T, E> {\n    return new ResultAsync(async () => {\n      try {\n        return ok(await promise);\n      } catch (error) {\n        return err(onReject(error));\n      }\n    });\n  }\n\n  static fromSafePromise<T, E = never>(promise: PromiseLike<T>): ResultAsync<T, E> {\n    return new ResultAsync(async () => ok(await promise));\n  }\n\n  /**\n   * Defers work until {@link resolve}. Unlike {@link fromPromise}, nothing runs\n   * until the `ResultAsync` is resolved (e.g. by `combineTuple` / `combineTupleParallel`).\n   */\n  static defer<T, E>(fn: () => Promise<Result<T, E>>): ResultAsync<T, E> {\n    return new ResultAsync(fn);\n  }\n\n  static ok<T>(value: T): ResultAsync<T, never>;\n  static ok<T, E>(value: T): ResultAsync<T, E>;\n  static ok<T, E = never>(value: T): ResultAsync<T, E> {\n    return new ResultAsync(async () => ok(value));\n  }\n\n  static err<T = never, E = unknown>(error: E): ResultAsync<T, E> {\n    return new ResultAsync(async () => err(error));\n  }\n\n  /** @see {@link fromAsync} from `@onrails/result/interop` */\n  static fromResultPromise<T, E>(\n    promise: Promise<Result<T, E>>,\n    onDefect?: (error: unknown) => E | UnexpectedError,\n  ): ResultAsync<T, E | UnexpectedError> {\n    const mapDefect =\n      onDefect ?? ((error: unknown) => new UnexpectedError(\"Unexpected async defect\", error));\n    return new ResultAsync(() => liftPromiseResult(promise, mapDefect));\n  }\n\n  static combine<T, E>(results: readonly ResultAsync<T, E>[]): ResultAsync<T[], E> {\n    return new ResultAsync(async () => {\n      const values: T[] = [];\n      for (const ra of results) {\n        const result = await ra.resolve();\n        if (isErr(result)) {\n          return err(result.error);\n        }\n        values.push(result.value);\n      }\n      return ok(values);\n    });\n  }\n\n  static combineTuple<const R extends readonly ResultAsync<unknown, unknown>[]>(\n    results: R,\n  ): CombineTupleAsync<R> {\n    return new ResultAsync(async () => {\n      const values: unknown[] = [];\n      for (const ra of results) {\n        const result = await ra.resolve();\n        if (isErr(result)) {\n          return err(result.error) as Result<\n            { [K in keyof R]: AsyncOk<R[K]> },\n            { [K in keyof R]: AsyncErr<R[K]> }[number]\n          >;\n        }\n        values.push(result.value);\n      }\n      return ok(values) as Result<\n        { [K in keyof R]: AsyncOk<R[K]> },\n        { [K in keyof R]: AsyncErr<R[K]> }[number]\n      >;\n    }) as CombineTupleAsync<R>;\n  }\n\n  /**\n   * Like {@link combineTuple}, but starts every branch before awaiting (wall-clock\n   * parallel for independent IO). On failure, returns the first `Err` in input order.\n   */\n  static combineTupleParallel<const R extends readonly ResultAsync<unknown, unknown>[]>(\n    results: R,\n  ): CombineTupleAsync<R> {\n    return new ResultAsync(async () => {\n      const settled = await Promise.all(results.map((ra) => ra.resolve()));\n      const values: unknown[] = [];\n      for (const result of settled) {\n        if (isErr(result)) {\n          return err(result.error) as Result<\n            { [K in keyof R]: AsyncOk<R[K]> },\n            { [K in keyof R]: AsyncErr<R[K]> }[number]\n          >;\n        }\n        values.push(result.value);\n      }\n      return ok(values) as Result<\n        { [K in keyof R]: AsyncOk<R[K]> },\n        { [K in keyof R]: AsyncErr<R[K]> }[number]\n      >;\n    }) as CombineTupleAsync<R>;\n  }\n\n  map<U>(fn: (value: T) => U): ResultAsync<U, E> {\n    return new ResultAsync(async () => map(await this.run(), fn));\n  }\n\n  mapErr<F>(fn: (error: E) => F): ResultAsync<T, F> {\n    return new ResultAsync(async () => mapErr(await this.run(), fn));\n  }\n\n  flatMap<U, F = E>(\n    fn: (value: T) => ResultAsync<U, F> | Result<U, F> | { inner: Result<U, F> },\n  ): ResultAsync<U, E | F> {\n    return new ResultAsync(async () => {\n      const first = await this.run();\n      if (isErr(first)) {\n        return err(first.error) as Result<U, E | F>;\n      }\n      const next = fn(first.value);\n      if (next instanceof ResultAsync) {\n        return next.resolve() as Promise<Result<U, E | F>>;\n      }\n      if (isResultLike(next)) {\n        return next as Result<U, E | F>;\n      }\n      if (isCompatLike(next)) {\n        return next.inner as Result<U, E | F>;\n      }\n      return next as Result<U, E | F>;\n    });\n  }\n\n  andThen<U, F = E>(\n    fn: (value: T) => ResultAsync<U, F> | Result<U, F> | { inner: Result<U, F> },\n  ): ResultAsync<U, E | F> {\n    return this.flatMap(fn);\n  }\n\n  chain<U, F = E>(\n    fn: (value: T) => ResultAsync<U, F> | Result<U, F> | { inner: Result<U, F> },\n  ): ResultAsync<U, E | F> {\n    return this.flatMap(fn);\n  }\n\n  recover<F>(fn: (error: E) => ResultAsync<T, F> | Result<T, F>): ResultAsync<T, F> {\n    return new ResultAsync(async () => {\n      const first = await this.run();\n      if (!isErr(first)) {\n        return first as Result<T, F>;\n      }\n      const next = fn(first.error);\n      if (next instanceof ResultAsync) {\n        return next.resolve();\n      }\n      return next;\n    });\n  }\n\n  orElse<F>(fn: (error: E) => ResultAsync<T, F> | Result<T, F>): ResultAsync<T, F> {\n    return this.recover(fn);\n  }\n\n  tap(fn: (value: T) => void): ResultAsync<T, E> {\n    return new ResultAsync(async () => {\n      const result = await this.run();\n      if (!isErr(result)) {\n        fn(result.value);\n      }\n      return result;\n    });\n  }\n\n  tapErr(fn: (error: E) => void): ResultAsync<T, E> {\n    return new ResultAsync(async () => {\n      const result = await this.run();\n      if (isErr(result)) {\n        fn(result.error);\n      }\n      return result;\n    });\n  }\n\n  unwrapOr<U>(defaultValue: U): Promise<T | U> {\n    return this.run().then((result) => (isErr(result) ? defaultValue : result.value));\n  }\n\n  isOk(): Promise<boolean> {\n    return this.run().then((result) => !isErr(result));\n  }\n\n  isErr(): Promise<boolean> {\n    return this.run().then((result) => isErr(result));\n  }\n\n  match<U1, U2 = U1>(onOk: (value: T) => U1, onErr: (error: E) => U2): Promise<U1 | U2> {\n    return this.run().then((result) =>\n      isErr(result) ? onErr(result.error) : onOk(result.value),\n    ) as Promise<U1 | U2>;\n  }\n\n  resolve(): Promise<Result<T, E>> {\n    return this.run();\n  }\n\n  /**\n   * Thenable shim — `await ra` resolves to a bare tagged-union `Result<T, E>`.\n   * Narrow with `isOk(r)` / `isErr(r)` to read `.value` / `.error`.\n   */\n  // biome-ignore lint/suspicious/noThenProperty: makes ResultAsync awaitable\n  then<R1 = Result<T, E>, R2 = never>(\n    onfulfilled?: ((value: Result<T, E>) => R1 | PromiseLike<R1>) | undefined | null,\n    onrejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | undefined | null,\n  ): Promise<R1 | R2> {\n    return this.run().then(\n      (r) => (onfulfilled ? onfulfilled(r) : (r as unknown as R1)),\n      onrejected ?? undefined,\n    );\n  }\n}\n\nfunction isResultLike<U, F>(v: unknown): v is Result<U, F> {\n  return (\n    typeof v === \"object\" &&\n    v !== null &&\n    \"_tag\" in v &&\n    ((v as { _tag: unknown })._tag === \"Ok\" || (v as { _tag: unknown })._tag === \"Err\")\n  );\n}\n\nfunction isCompatLike<U, F>(v: unknown): v is { inner: Result<U, F> } {\n  return (\n    typeof v === \"object\" &&\n    v !== null &&\n    \"inner\" in v &&\n    isResultLike((v as { inner: unknown }).inner)\n  );\n}\n\n/**\n * Lifts a value into an `Ok` async result.\n *\n * @example\n * ```ts\n * const r = okAsync(42);                  // ResultAsync<number, never>\n * ```\n */\nexport const okAsync = ResultAsync.ok;\n\n/**\n * Lifts a value into an `Err` async result.\n *\n * @example\n * ```ts\n * const r = errAsync({ kind: \"not_found\" as const });\n * ```\n */\nexport const errAsync = ResultAsync.err;\n\n/**\n * Wraps a `PromiseLike<T>` into a {@link ResultAsync}. Reject reasons go\n * through `onReject` to become typed `Err`s; success becomes `Ok<T>`.\n *\n * @example\n * ```ts\n * const body = fromPromise(\n *   fetch(url).then((r) => r.text()),\n *   (e): NetworkError => ({ kind: \"network\", cause: String(e) }),\n * );\n * ```\n */\nexport const fromPromise = ResultAsync.fromPromise;\n\n/**\n * Wraps a `PromiseLike<T>` that **never rejects** into {@link ResultAsync}.\n * Skips the `onReject` mapper. Use only when the promise is provably safe.\n */\nexport const fromSafePromise = ResultAsync.fromSafePromise;\n\n/**\n * Heterogeneous async tuple combine — left-to-right, short-circuit on\n * first `Err` in input order. Preserves tuple positions so destructuring\n * stays type-safe.\n *\n * @example\n * ```ts\n * const combined = sequenceTupleAsync([loadCfg(), loadCatalog()] as const);\n * // ResultAsync<readonly [Cfg, Catalog], CfgError | CatalogError>\n * ```\n */\nexport const sequenceTupleAsync = ResultAsync.combineTuple;\n\n/**\n * Heterogeneous async tuple combine — branches overlap in wall-clock time.\n * Returns the first `Err` in **input** order (not completion order).\n *\n * @example\n * ```ts\n * const combined = parallelTupleAsync([\n *   loadProfile(id),\n *   loadMetrics(id),\n *   loadFlags(id),\n * ] as const);\n * // ResultAsync<readonly [Profile, Metrics, Flags], …>\n * ```\n */\nexport const parallelTupleAsync = ResultAsync.combineTupleParallel;\n\nconst toError = (error: unknown): Error =>\n  error instanceof Error ? error : new Error(String(error));\n\n/**\n * Convenience wrapper over {@link fromPromise} with default `Error`\n * normalization. Call without `onReject` to get `ResultAsync<T, Error>`,\n * or pass a custom mapper for a typed error.\n *\n * @example\n * ```ts\n * // Default: rejection → Err(Error)\n * const a = tryAsync(db.users.insert(row));\n *\n * // Custom: typed error\n * const b = tryAsync(db.users.insert(row), (e): DbError => ({\n *   kind: \"db\",\n *   cause: e,\n * }));\n * ```\n */\nexport function tryAsync<T>(promise: PromiseLike<T>): ResultAsync<T, Error>;\nexport function tryAsync<T, E>(\n  promise: PromiseLike<T>,\n  onReject: (error: unknown) => E,\n): ResultAsync<T, E>;\nexport function tryAsync<T, E>(\n  promise: PromiseLike<T>,\n  onReject?: (error: unknown) => E,\n): ResultAsync<T, E | Error> {\n  if (onReject) {\n    return ResultAsync.fromPromise(promise, onReject);\n  }\n  return ResultAsync.fromPromise(promise, toError);\n}\n","import { ResultAsync } from \"./async.js\";\nimport type { Result, UnexpectedError } from \"./types.js\";\n\n/** Success type of a {@link Result} or {@link ResultAsync} */\nexport type InferOk<R> = R extends { _tag: \"Ok\"; readonly value: infer T }\n  ? T\n  : R extends ResultAsync<infer T, unknown>\n    ? T\n    : never;\n\n/** Error type of a {@link Result} or {@link ResultAsync} */\nexport type InferErr<R> = R extends { _tag: \"Err\"; readonly error: infer E }\n  ? E\n  : R extends ResultAsync<unknown, infer E>\n    ? E\n    : never;\n\ntype AnyResult = Result<unknown, unknown>;\n\n/** Lift an already-known sync {@link Result} into {@link ResultAsync}. */\nexport const fromResult = <T, E>(result: Result<T, E>): ResultAsync<T, E> =>\n  ResultAsync.fromResult(result);\n\n/** Bind a sync {@link Result} into an async step without widening defects. */\nexport const asyncAfter = <T, U, E, F>(\n  result: Result<T, E>,\n  fn: (value: T) => ResultAsync<U, F>,\n): ResultAsync<U, E | F> => fromResult(result).flatMap(fn);\n\n/**\n * Lift `(...args) => Promise<Result<T, E>>` to `(...args) => ResultAsync<T, E>`.\n * Catches unexpected promise rejections (defects) via `onDefect` or {@link UnexpectedError}.\n */\nexport function fromAsync<A extends readonly unknown[], R extends AnyResult>(\n  fn: (...args: A) => Promise<R>,\n  onDefect?: (error: unknown) => InferErr<R> | UnexpectedError,\n): (...args: A) => ResultAsync<InferOk<R>, InferErr<R> | UnexpectedError> {\n  return (...args: A) =>\n    ResultAsync.fromResultPromise(fn(...args), onDefect) as ResultAsync<\n      InferOk<R>,\n      InferErr<R> | UnexpectedError\n    >;\n}\n","import type { ResultAsync } from \"./async.js\";\nimport { fromAsync } from \"./interop.js\";\nimport { err, isOk, ok } from \"./result.js\";\nimport type { Result } from \"./types.js\";\n\n/** openapi-fetch style response before unwrapping */\nexport type FetchResult<T> = {\n  data?: T;\n  error?: unknown;\n  response: Response;\n};\n\n/** Error with a `message` field for MCP tool boundaries */\nexport type ErrorWithMessage = { message: string };\n\n/** MCP tool success / error shape (structured content + text) */\nexport type ToolResponse<T> =\n  | { structuredContent: T; content: { type: \"text\"; text: string }[] }\n  | { content: { type: \"text\"; text: string }[]; isError: true };\n\n/**\n * Map an openapi-fetch (or similar) response to a {@link Result}.\n * Supply `toError` to build your domain error (e.g. `PrintrApiError`).\n */\nexport const unwrapFetchResult = <T, E>(\n  result: FetchResult<T>,\n  toError: (detail: { error: unknown; response: Response }) => E,\n): Result<T, E> => {\n  if (result.error !== undefined || result.data === undefined) {\n    return err(toError({ error: result.error, response: result.response }));\n  }\n  return ok(result.data);\n};\n\n/** Default detail extractor — sanitises HTML / empty bodies */\nexport const extractFetchErrorDetail = (error: unknown, response: Response): string => {\n  if (error === undefined || error === null) {\n    return response.statusText || \"unknown error\";\n  }\n  const raw = typeof error === \"object\" ? JSON.stringify(error) : String(error);\n  const lower = raw.toLowerCase();\n  if (lower.includes(\"<!doctype\") || lower.includes(\"<html\")) {\n    const statusHint =\n      response.status === 403\n        ? \"request blocked by CDN/WAF\"\n        : `unexpected HTML response (${response.status})`;\n    return `${statusHint} — retry after a short delay`;\n  }\n  return raw;\n};\n\n/** Lift `client.GET(...)` promise to {@link ResultAsync} */\nexport const unwrapFetchResultAsync = <T, E>(\n  promise: Promise<FetchResult<T>>,\n  toError: (detail: { error: unknown; response: Response }) => E,\n  onDefect?: (error: unknown) => E,\n): ResultAsync<T, E> =>\n  fromAsync(() => promise.then((r) => unwrapFetchResult(r, toError)), onDefect)() as ResultAsync<\n    T,\n    E\n  >;\n\n/** Format a sync {@link Result} as an MCP tool response */\nexport const toToolResponse = <T, E extends ErrorWithMessage>(\n  result: Result<T, E>,\n): ToolResponse<T> => {\n  if (isOk(result)) {\n    return {\n      structuredContent: result.value,\n      content: [{ type: \"text\" as const, text: JSON.stringify(result.value, null, 2) }],\n    };\n  }\n  return {\n    content: [{ type: \"text\" as const, text: result.error.message }],\n    isError: true as const,\n  };\n};\n\n/** Terminate a {@link ResultAsync} pipeline at an MCP tool handler */\nexport const toToolResponseAsync = async <T, E extends ErrorWithMessage>(\n  resultAsync: ResultAsync<T, E>,\n): Promise<ToolResponse<T>> => toToolResponse(await resultAsync.resolve());\n\nexport const toolOk = (data: Record<string, unknown>) => ({\n  structuredContent: data,\n  content: [{ type: \"text\" as const, text: JSON.stringify(data, null, 2) }],\n});\n\nexport const toolError = (text: string) => ({\n  content: [{ type: \"text\" as const, text }],\n  isError: true as const,\n});\n"]}

package/dist/pipe.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+// src/pipe.ts
+function flow(first, ...rest) {
+  return (...args) => {
+    let acc = first(...args);
+    for (const fn of rest) {
+      acc = fn(acc);
+    }
+    return acc;
+  };
+}
+
+exports.flow = flow;
+//# sourceMappingURL=pipe.cjs.map
+//# sourceMappingURL=pipe.cjs.map

package/dist/pipe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pipe.ts"],"names":[],"mappings":";;;AAkEO,SAAS,IAAA,CACd,UACG,IAAA,EAC8B;AACjC,EAAA,OAAO,IAAI,IAAA,KAAoB;AAC7B,IAAA,IAAI,GAAA,GAAM,KAAA,CAAM,GAAG,IAAI,CAAA;AACvB,IAAA,KAAA,MAAW,MAAM,IAAA,EAAM;AACrB,MAAA,GAAA,GAAM,GAAG,GAAG,CAAA;AAAA,IACd;AACA,IAAA,OAAO,GAAA;AAAA,EACT,CAAA;AACF","file":"pipe.cjs","sourcesContent":["/**\n * Variadic point-free composition — left-to-right.\n *\n * ```ts\n * const parseUserName = flow(\n *   (raw: string) => parseConfig(raw),\n *   map((cfg) => cfg.user),\n *   flatMap((u) => u.name ? ok(u.name) : err({ kind: \"missing\" })),\n * );\n *\n * parseUserName(raw); // Result<string, ParseError | { kind: \"missing\" }>\n * ```\n *\n * Use {@link pipe} from `@onrails/result` when you have a starting value;\n * use {@link flow} when you want to define a reusable composed function.\n */\nexport function flow<A extends readonly unknown[], B>(ab: (...a: A) => B): (...a: A) => B;\nexport function flow<A extends readonly unknown[], B, C>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n): (...a: A) => C;\nexport function flow<A extends readonly unknown[], B, C, D>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n): (...a: A) => D;\nexport function flow<A extends readonly unknown[], B, C, D, E>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n): (...a: A) => E;\nexport function flow<A extends readonly unknown[], B, C, D, E, F>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n): (...a: A) => F;\nexport function flow<A extends readonly unknown[], B, C, D, E, F, G>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n  fg: (f: F) => G,\n): (...a: A) => G;\nexport function flow<A extends readonly unknown[], B, C, D, E, F, G, H>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n  fg: (f: F) => G,\n  gh: (g: G) => H,\n): (...a: A) => H;\nexport function flow<A extends readonly unknown[], B, C, D, E, F, G, H, I>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n  fg: (f: F) => G,\n  gh: (g: G) => H,\n  hi: (h: H) => I,\n): (...a: A) => I;\nexport function flow(\n  first: (...args: unknown[]) => unknown,\n  ...rest: ReadonlyArray<(x: unknown) => unknown>\n): (...args: unknown[]) => unknown {\n  return (...args: unknown[]) => {\n    let acc = first(...args);\n    for (const fn of rest) {\n      acc = fn(acc);\n    }\n    return acc;\n  };\n}\n"]}

package/dist/pipe.d.cts

@@ -0,0 +1,26 @@
+/**
+ * Variadic point-free composition — left-to-right.
+ *
+ * ```ts
+ * const parseUserName = flow(
+ *   (raw: string) => parseConfig(raw),
+ *   map((cfg) => cfg.user),
+ *   flatMap((u) => u.name ? ok(u.name) : err({ kind: "missing" })),
+ * );
+ *
+ * parseUserName(raw); // Result<string, ParseError | { kind: "missing" }>
+ * ```
+ *
+ * Use {@link pipe} from `@onrails/result` when you have a starting value;
+ * use {@link flow} when you want to define a reusable composed function.
+ */
+declare function flow<A extends readonly unknown[], B>(ab: (...a: A) => B): (...a: A) => B;
+declare function flow<A extends readonly unknown[], B, C>(ab: (...a: A) => B, bc: (b: B) => C): (...a: A) => C;
+declare function flow<A extends readonly unknown[], B, C, D>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D): (...a: A) => D;
+declare function flow<A extends readonly unknown[], B, C, D, E>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E): (...a: A) => E;
+declare function flow<A extends readonly unknown[], B, C, D, E, F>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F): (...a: A) => F;
+declare function flow<A extends readonly unknown[], B, C, D, E, F, G>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G): (...a: A) => G;
+declare function flow<A extends readonly unknown[], B, C, D, E, F, G, H>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H): (...a: A) => H;
+declare function flow<A extends readonly unknown[], B, C, D, E, F, G, H, I>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I): (...a: A) => I;
+
+export { flow };

package/dist/pipe.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Variadic point-free composition — left-to-right.
+ *
+ * ```ts
+ * const parseUserName = flow(
+ *   (raw: string) => parseConfig(raw),
+ *   map((cfg) => cfg.user),
+ *   flatMap((u) => u.name ? ok(u.name) : err({ kind: "missing" })),
+ * );
+ *
+ * parseUserName(raw); // Result<string, ParseError | { kind: "missing" }>
+ * ```
+ *
+ * Use {@link pipe} from `@onrails/result` when you have a starting value;
+ * use {@link flow} when you want to define a reusable composed function.
+ */
+declare function flow<A extends readonly unknown[], B>(ab: (...a: A) => B): (...a: A) => B;
+declare function flow<A extends readonly unknown[], B, C>(ab: (...a: A) => B, bc: (b: B) => C): (...a: A) => C;
+declare function flow<A extends readonly unknown[], B, C, D>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D): (...a: A) => D;
+declare function flow<A extends readonly unknown[], B, C, D, E>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E): (...a: A) => E;
+declare function flow<A extends readonly unknown[], B, C, D, E, F>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F): (...a: A) => F;
+declare function flow<A extends readonly unknown[], B, C, D, E, F, G>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G): (...a: A) => G;
+declare function flow<A extends readonly unknown[], B, C, D, E, F, G, H>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H): (...a: A) => H;
+declare function flow<A extends readonly unknown[], B, C, D, E, F, G, H, I>(ab: (...a: A) => B, bc: (b: B) => C, cd: (c: C) => D, de: (d: D) => E, ef: (e: E) => F, fg: (f: F) => G, gh: (g: G) => H, hi: (h: H) => I): (...a: A) => I;
+
+export { flow };

package/dist/pipe.js

@@ -0,0 +1,14 @@
+// src/pipe.ts
+function flow(first, ...rest) {
+  return (...args) => {
+    let acc = first(...args);
+    for (const fn of rest) {
+      acc = fn(acc);
+    }
+    return acc;
+  };
+}
+
+export { flow };
+//# sourceMappingURL=pipe.js.map
+//# sourceMappingURL=pipe.js.map

package/dist/pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pipe.ts"],"names":[],"mappings":";AAkEO,SAAS,IAAA,CACd,UACG,IAAA,EAC8B;AACjC,EAAA,OAAO,IAAI,IAAA,KAAoB;AAC7B,IAAA,IAAI,GAAA,GAAM,KAAA,CAAM,GAAG,IAAI,CAAA;AACvB,IAAA,KAAA,MAAW,MAAM,IAAA,EAAM;AACrB,MAAA,GAAA,GAAM,GAAG,GAAG,CAAA;AAAA,IACd;AACA,IAAA,OAAO,GAAA;AAAA,EACT,CAAA;AACF","file":"pipe.js","sourcesContent":["/**\n * Variadic point-free composition — left-to-right.\n *\n * ```ts\n * const parseUserName = flow(\n *   (raw: string) => parseConfig(raw),\n *   map((cfg) => cfg.user),\n *   flatMap((u) => u.name ? ok(u.name) : err({ kind: \"missing\" })),\n * );\n *\n * parseUserName(raw); // Result<string, ParseError | { kind: \"missing\" }>\n * ```\n *\n * Use {@link pipe} from `@onrails/result` when you have a starting value;\n * use {@link flow} when you want to define a reusable composed function.\n */\nexport function flow<A extends readonly unknown[], B>(ab: (...a: A) => B): (...a: A) => B;\nexport function flow<A extends readonly unknown[], B, C>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n): (...a: A) => C;\nexport function flow<A extends readonly unknown[], B, C, D>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n): (...a: A) => D;\nexport function flow<A extends readonly unknown[], B, C, D, E>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n): (...a: A) => E;\nexport function flow<A extends readonly unknown[], B, C, D, E, F>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n): (...a: A) => F;\nexport function flow<A extends readonly unknown[], B, C, D, E, F, G>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n  fg: (f: F) => G,\n): (...a: A) => G;\nexport function flow<A extends readonly unknown[], B, C, D, E, F, G, H>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n  fg: (f: F) => G,\n  gh: (g: G) => H,\n): (...a: A) => H;\nexport function flow<A extends readonly unknown[], B, C, D, E, F, G, H, I>(\n  ab: (...a: A) => B,\n  bc: (b: B) => C,\n  cd: (c: C) => D,\n  de: (d: D) => E,\n  ef: (e: E) => F,\n  fg: (f: F) => G,\n  gh: (g: G) => H,\n  hi: (h: H) => I,\n): (...a: A) => I;\nexport function flow(\n  first: (...args: unknown[]) => unknown,\n  ...rest: ReadonlyArray<(x: unknown) => unknown>\n): (...args: unknown[]) => unknown {\n  return (...args: unknown[]) => {\n    let acc = first(...args);\n    for (const fn of rest) {\n      acc = fn(acc);\n    }\n    return acc;\n  };\n}\n"]}