awaitly 1.34.0 → 2.0.0

package/dist/match-entry-DjI2bLpD.d.ts

@@ -1,209 +0,0 @@
-/**
- * awaitly/match
- *
- * Exhaustive pattern matching for discriminated unions.
- * Extends the TaggedError.match pattern to work with any tagged union.
- *
- * @example
- * ```typescript
- * type Event =
- *   | { _tag: 'UserCreated'; user: User }
- *   | { _tag: 'UserUpdated'; userId: string }
- *   | { _tag: 'UserDeleted'; userId: string }
- *
- * const message = Match.value(event)
- *   .pipe(Match.tag("UserCreated", e => `Created: ${e.user.name}`))
- *   .pipe(Match.tag("UserUpdated", e => `Updated: ${e.userId}`))
- *   .pipe(Match.tag("UserDeleted", e => `Deleted: ${e.userId}`))
- *   .pipe(Match.exhaustive)
- * ```
- */
-/**
- * Any object with a _tag discriminator.
- */
-type Tagged<Tag extends string = string> = {
-    readonly _tag: Tag;
-};
-/**
- * Extract the tag from a tagged union member.
- */
-type TagOf<T extends Tagged> = T["_tag"];
-/**
- * Extract union members that match a specific tag.
- */
-type MatchTag<T extends Tagged, Tag extends string> = Extract<T, {
-    _tag: Tag;
-}>;
-/**
- * A matcher that is accumulating handlers for a tagged union.
- *
- * @typeParam Input - The full union type being matched
- * @typeParam Remaining - Union members that haven't been handled yet
- * @typeParam Output - The output type (union of all handler return types)
- */
-interface Matcher<Input extends Tagged, Remaining extends Tagged, Output> {
-    readonly _tag: "Matcher";
-    readonly value: Input;
-    readonly handlers: Map<string, (value: Tagged) => unknown>;
-    readonly _remaining: Remaining;
-    readonly _output: Output;
-}
-/**
- * Add a handler for a specific tag.
- *
- * @example
- * ```typescript
- * Match.value(event)
- *   .pipe(Match.tag("UserCreated", e => e.user.name))
- * ```
- */
-declare function tag<Input extends Tagged, Remaining extends Tagged, Output, Tag extends TagOf<Remaining>, NewOutput>(tagValue: Tag, handler: (value: MatchTag<Remaining, Tag>) => NewOutput): (matcher: Matcher<Input, Remaining, Output>) => Matcher<Input, Exclude<Remaining, {
-    _tag: Tag;
-}>, Output | NewOutput>;
-/**
- * Add handlers for multiple tags at once.
- *
- * @example
- * ```typescript
- * Match.value(event)
- *   .pipe(Match.tags({
- *     UserCreated: e => e.user.name,
- *     UserUpdated: e => e.userId,
- *   }))
- * ```
- */
-declare function tags<Input extends Tagged, Remaining extends Tagged, Output, Handlers extends {
-    [K in TagOf<Remaining>]?: (value: MatchTag<Remaining, K>) => unknown;
-}>(handlers: Handlers): (matcher: Matcher<Input, Remaining, Output>) => Matcher<Input, Exclude<Remaining, {
-    _tag: keyof Handlers;
-}>, Output | ReturnType<NonNullable<Handlers[keyof Handlers]>>>;
-/**
- * Complete the match, requiring all cases to be handled.
- * This is a compile-time check - if any cases are missing, TypeScript will error.
- *
- * @example
- * ```typescript
- * // TypeScript error if any tag is not handled
- * const result = Match.value(event)
- *   .pipe(Match.tag("UserCreated", e => e.user))
- *   .pipe(Match.tag("UserUpdated", e => e.userId))
- *   .pipe(Match.tag("UserDeleted", e => e.userId))
- *   .pipe(Match.exhaustive)
- * ```
- */
-declare function exhaustive<Input extends Tagged, Output>(matcher: Matcher<Input, never, Output>): Output;
-/**
- * Complete the match with a default handler for any remaining cases.
- *
- * @example
- * ```typescript
- * const result = Match.value(event)
- *   .pipe(Match.tag("UserCreated", e => `Created: ${e.user.name}`))
- *   .pipe(Match.orElse(e => `Other event: ${e._tag}`))
- * ```
- */
-declare function orElse<Input extends Tagged, Remaining extends Tagged, Output, DefaultOutput>(handler: (value: Remaining) => DefaultOutput): (matcher: Matcher<Input, Remaining, Output>) => Output | DefaultOutput;
-/**
- * Complete the match with a default value for any remaining cases.
- *
- * @example
- * ```typescript
- * const result = Match.value(event)
- *   .pipe(Match.tag("UserCreated", e => e.user.name))
- *   .pipe(Match.orElseValue("Unknown event"))
- * ```
- */
-declare function orElseValue<Input extends Tagged, Remaining extends Tagged, Output, DefaultOutput>(defaultValue: DefaultOutput): (matcher: Matcher<Input, Remaining, Output>) => Output | DefaultOutput;
-/**
- * Add a handler with an additional predicate.
- * The handler only runs if both the tag matches AND the predicate returns true.
- *
- * @example
- * ```typescript
- * Match.value(event)
- *   .pipe(Match.when(
- *     "UserCreated",
- *     e => e.user.isAdmin,
- *     e => `Admin created: ${e.user.name}`
- *   ))
- * ```
- */
-declare function when<Input extends Tagged, Remaining extends Tagged, Output, Tag extends TagOf<Input>, NewOutput>(tagValue: Tag, predicate: (value: MatchTag<Input, Tag>) => boolean, handler: (value: MatchTag<Input, Tag>) => NewOutput): (matcher: Matcher<Input, Remaining, Output>) => Matcher<Input, Remaining, Output | NewOutput>;
-/**
- * Check if a tagged value has a specific tag.
- * Type guard that narrows the type.
- *
- * @example
- * ```typescript
- * if (Match.is("UserCreated")(event)) {
- *   // event is narrowed to { _tag: 'UserCreated'; user: User }
- *   console.log(event.user.name);
- * }
- * ```
- */
-declare function is<T extends Tagged, Tag extends string>(tagValue: Tag): (value: T) => value is Extract<T, {
-    _tag: Tag;
-}>;
-/**
- * Check if a tagged value has one of several tags.
- *
- * @example
- * ```typescript
- * if (Match.isOneOf("UserCreated", "UserUpdated")(event)) {
- *   // event is narrowed to UserCreated | UserUpdated
- * }
- * ```
- */
-declare function isOneOf<T extends Tagged, Tags extends TagOf<T>[]>(...tags: Tags): (value: T) => value is Extract<T, {
-    _tag: Tags[number];
-}>;
-type PipedMatcher<Input extends Tagged, Remaining extends Tagged, Output> = Matcher<Input, Remaining, Output> & {
-    pipe: <NewRemaining extends Tagged, NewOutput>(fn: (self: Matcher<Input, Remaining, Output>) => Matcher<Input, NewRemaining, NewOutput>) => PipedMatcher<Input, NewRemaining, NewOutput>;
-} & {
-    pipe: <R>(fn: (self: Matcher<Input, Remaining, Output>) => R) => R;
-};
-/**
- * Start matching on a value (with pipe support).
- *
- * @example
- * ```typescript
- * const result = Match.value(event)
- *   .pipe(Match.tag("Created", e => e.id))
- *   .pipe(Match.exhaustive)
- * ```
- */
-declare function matchValue<T extends Tagged>(input: T): PipedMatcher<T, T, never>;
-/**
- * Match namespace for exhaustive pattern matching.
- *
- * @example
- * ```typescript
- * import { Match } from "awaitly";
- *
- * type Event =
- *   | { _tag: 'Created'; id: string }
- *   | { _tag: 'Updated'; id: string; data: unknown }
- *   | { _tag: 'Deleted'; id: string }
- *
- * function handle(event: Event): string {
- *   return Match.value(event)
- *     .pipe(Match.tag("Created", e => `Created: ${e.id}`))
- *     .pipe(Match.tag("Updated", e => `Updated: ${e.id}`))
- *     .pipe(Match.tag("Deleted", e => `Deleted: ${e.id}`))
- *     .pipe(Match.exhaustive)
- * }
- * ```
- */
-declare const Match: {
-    readonly value: typeof matchValue;
-    readonly tag: typeof tag;
-    readonly tags: typeof tags;
-    readonly when: typeof when;
-    readonly exhaustive: typeof exhaustive;
-    readonly orElse: typeof orElse;
-    readonly orElseValue: typeof orElseValue;
-    readonly is: typeof is;
-    readonly isOneOf: typeof isOneOf;
-};
-
-export { Match as M, type Tagged as T, type MatchTag as a, type Matcher as b, is as c, tags as d, exhaustive as e, orElseValue as f, isOneOf as i, matchValue as m, orElse as o, tag as t, when as w };

package/dist/match.cjs

@@ -1,2 +0,0 @@
-"use strict";var r=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var w=Object.prototype.hasOwnProperty;var R=(e,t)=>{for(var n in t)r(e,n,{get:t[n],enumerable:!0})},_=(e,t,n,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let u of M(t))!w.call(e,u)&&u!==n&&r(e,u,{get:()=>t[u],enumerable:!(a=m(t,u))||a.enumerable});return e};var v=e=>_(r({},"__esModule",{value:!0}),e);var k={};R(k,{Match:()=>f,exhaustive:()=>p,isOneOf:()=>o,isTag:()=>l,matchOrElse:()=>g,matchTag:()=>i,matchTags:()=>s,matchValue:()=>T,orElseValue:()=>d});module.exports=v(k);function i(e,t){return n=>{let a=new Map(n.handlers);return a.set(e,t),{_tag:"Matcher",value:n.value,handlers:a,_remaining:void 0,_output:void 0}}}function s(e){return t=>{let n=new Map(t.handlers);for(let[a,u]of Object.entries(e))u&&n.set(a,u);return{_tag:"Matcher",value:t.value,handlers:n,_remaining:void 0,_output:void 0}}}function p(e){let t=e.handlers.get(e.value._tag);if(!t)throw new Error(`No handler for tag: ${e.value._tag}`);return t(e.value)}function g(e){return t=>{let n=t.handlers.get(t.value._tag);return n?n(t.value):e(t.value)}}function d(e){return g(()=>e)}function I(e,t,n){return a=>{let u=new Map(a.handlers),c=a.handlers.get(e);return u.set(e,h=>{let O=h;if(t(O))return n(O);if(c)return c(h);throw new Error(`No handler matched for tag: ${e}`)}),{_tag:"Matcher",value:a.value,handlers:u,_remaining:a._remaining,_output:void 0}}}function l(e){return t=>t._tag===e}function o(...e){let t=new Set(e);return n=>t.has(n._tag)}function y(e){return typeof e=="object"&&e!==null&&"_tag"in e&&e._tag==="Matcher"}function x(e){return{...e,pipe(t){let n=t(e);return y(n)?x(n):n}}}function T(e){return x({_tag:"Matcher",value:e,handlers:new Map,_remaining:e,_output:void 0})}var f={value:T,tag:i,tags:s,when:I,exhaustive:p,orElse:g,orElseValue:d,is:l,isOneOf:o};0&&(module.exports={Match,exhaustive,isOneOf,isTag,matchOrElse,matchTag,matchTags,matchValue,orElseValue});
-//# sourceMappingURL=match.cjs.map

package/dist/match.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/match-entry.ts","../src/match.ts"],"sourcesContent":["/**\n * awaitly/match\n *\n * Exhaustive pattern matching for tagged unions: type-safe switch statements.\n *\n * @example\n * ```typescript\n * import { Match } from 'awaitly/match';\n *\n * type Event = { _tag: 'Click'; x: number } | { _tag: 'Scroll'; y: number };\n *\n * const handle = (event: Event) => Match.value(event)({\n *   Click: (e) => `Clicked at ${e.x}`,\n *   Scroll: (e) => `Scrolled to ${e.y}`,\n * });\n * ```\n */\n\nexport {\n  // Types\n  type Tagged,\n  type Matcher,\n\n  // Namespace\n  Match,\n\n  // Individual exports\n  matchValue,\n  tag as matchTag,\n  tags as matchTags,\n  exhaustive,\n  orElse as matchOrElse,\n  orElseValue,\n  is as isTag,\n  isOneOf,\n} from \"./match\";\n","/**\n * awaitly/match\n *\n * Exhaustive pattern matching for discriminated unions.\n * Extends the TaggedError.match pattern to work with any tagged union.\n *\n * @example\n * ```typescript\n * type Event =\n *   | { _tag: 'UserCreated'; user: User }\n *   | { _tag: 'UserUpdated'; userId: string }\n *   | { _tag: 'UserDeleted'; userId: string }\n *\n * const message = Match.value(event)\n *   .pipe(Match.tag(\"UserCreated\", e => `Created: ${e.user.name}`))\n *   .pipe(Match.tag(\"UserUpdated\", e => `Updated: ${e.userId}`))\n *   .pipe(Match.tag(\"UserDeleted\", e => `Deleted: ${e.userId}`))\n *   .pipe(Match.exhaustive)\n * ```\n */\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Any object with a _tag discriminator.\n */\nexport type Tagged<Tag extends string = string> = { readonly _tag: Tag };\n\n/**\n * Extract the tag from a tagged union member.\n */\nexport type TagOf<T extends Tagged> = T[\"_tag\"];\n\n/**\n * Extract union members that match a specific tag.\n */\nexport type MatchTag<T extends Tagged, Tag extends string> = Extract<T, { _tag: Tag }>;\n\n/**\n * A matcher that is accumulating handlers for a tagged union.\n *\n * @typeParam Input - The full union type being matched\n * @typeParam Remaining - Union members that haven't been handled yet\n * @typeParam Output - The output type (union of all handler return types)\n */\nexport interface Matcher<Input extends Tagged, Remaining extends Tagged, Output> {\n  readonly _tag: \"Matcher\";\n  readonly value: Input;\n  readonly handlers: Map<string, (value: Tagged) => unknown>;\n  readonly _remaining: Remaining;\n  readonly _output: Output;\n}\n\n/**\n * A completed matcher that has handled all cases.\n */\nexport interface CompletedMatcher<Output> {\n  readonly _tag: \"CompletedMatcher\";\n  readonly result: Output;\n}\n\n// =============================================================================\n// Core Functions\n// =============================================================================\n\n\n/**\n * Add a handler for a specific tag.\n *\n * @example\n * ```typescript\n * Match.value(event)\n *   .pipe(Match.tag(\"UserCreated\", e => e.user.name))\n * ```\n */\nexport function tag<\n  Input extends Tagged,\n  Remaining extends Tagged,\n  Output,\n  Tag extends TagOf<Remaining>,\n  NewOutput,\n>(\n  tagValue: Tag,\n  handler: (value: MatchTag<Remaining, Tag>) => NewOutput\n): (\n  matcher: Matcher<Input, Remaining, Output>\n) => Matcher<Input, Exclude<Remaining, { _tag: Tag }>, Output | NewOutput> {\n  return (matcher) => {\n    const newHandlers = new Map(matcher.handlers);\n    newHandlers.set(tagValue, handler as (value: Tagged) => unknown);\n\n    return {\n      _tag: \"Matcher\",\n      value: matcher.value,\n      handlers: newHandlers,\n      _remaining: undefined as unknown as Exclude<Remaining, { _tag: Tag }>,\n      _output: undefined as unknown as Output | NewOutput,\n    };\n  };\n}\n\n/**\n * Add handlers for multiple tags at once.\n *\n * @example\n * ```typescript\n * Match.value(event)\n *   .pipe(Match.tags({\n *     UserCreated: e => e.user.name,\n *     UserUpdated: e => e.userId,\n *   }))\n * ```\n */\nexport function tags<\n  Input extends Tagged,\n  Remaining extends Tagged,\n  Output,\n  Handlers extends {\n    [K in TagOf<Remaining>]?: (value: MatchTag<Remaining, K>) => unknown;\n  },\n>(\n  handlers: Handlers\n): (\n  matcher: Matcher<Input, Remaining, Output>\n) => Matcher<\n  Input,\n  Exclude<Remaining, { _tag: keyof Handlers }>,\n  Output | ReturnType<NonNullable<Handlers[keyof Handlers]>>\n> {\n  return (matcher) => {\n    const newHandlers = new Map(matcher.handlers);\n    for (const [tagValue, handler] of Object.entries(handlers)) {\n      if (handler) {\n        newHandlers.set(tagValue, handler as (value: Tagged) => unknown);\n      }\n    }\n\n    return {\n      _tag: \"Matcher\",\n      value: matcher.value,\n      handlers: newHandlers,\n      _remaining: undefined as unknown as Exclude<Remaining, { _tag: keyof Handlers }>,\n      _output: undefined as unknown as Output | ReturnType<NonNullable<Handlers[keyof Handlers]>>,\n    };\n  };\n}\n\n/**\n * Complete the match, requiring all cases to be handled.\n * This is a compile-time check - if any cases are missing, TypeScript will error.\n *\n * @example\n * ```typescript\n * // TypeScript error if any tag is not handled\n * const result = Match.value(event)\n *   .pipe(Match.tag(\"UserCreated\", e => e.user))\n *   .pipe(Match.tag(\"UserUpdated\", e => e.userId))\n *   .pipe(Match.tag(\"UserDeleted\", e => e.userId))\n *   .pipe(Match.exhaustive)\n * ```\n */\nexport function exhaustive<Input extends Tagged, Output>(\n  matcher: Matcher<Input, never, Output>\n): Output {\n  const handler = matcher.handlers.get(matcher.value._tag);\n  if (!handler) {\n    throw new Error(`No handler for tag: ${matcher.value._tag}`);\n  }\n  return handler(matcher.value) as Output;\n}\n\n/**\n * Complete the match with a default handler for any remaining cases.\n *\n * @example\n * ```typescript\n * const result = Match.value(event)\n *   .pipe(Match.tag(\"UserCreated\", e => `Created: ${e.user.name}`))\n *   .pipe(Match.orElse(e => `Other event: ${e._tag}`))\n * ```\n */\nexport function orElse<Input extends Tagged, Remaining extends Tagged, Output, DefaultOutput>(\n  handler: (value: Remaining) => DefaultOutput\n): (matcher: Matcher<Input, Remaining, Output>) => Output | DefaultOutput {\n  return (matcher) => {\n    const specificHandler = matcher.handlers.get(matcher.value._tag);\n    if (specificHandler) {\n      return specificHandler(matcher.value) as Output;\n    }\n    return handler(matcher.value as unknown as Remaining);\n  };\n}\n\n/**\n * Complete the match with a default value for any remaining cases.\n *\n * @example\n * ```typescript\n * const result = Match.value(event)\n *   .pipe(Match.tag(\"UserCreated\", e => e.user.name))\n *   .pipe(Match.orElseValue(\"Unknown event\"))\n * ```\n */\nexport function orElseValue<Input extends Tagged, Remaining extends Tagged, Output, DefaultOutput>(\n  defaultValue: DefaultOutput\n): (matcher: Matcher<Input, Remaining, Output>) => Output | DefaultOutput {\n  return orElse(() => defaultValue);\n}\n\n// =============================================================================\n// Predicates & Guards\n// =============================================================================\n\n/**\n * Add a handler with an additional predicate.\n * The handler only runs if both the tag matches AND the predicate returns true.\n *\n * @example\n * ```typescript\n * Match.value(event)\n *   .pipe(Match.when(\n *     \"UserCreated\",\n *     e => e.user.isAdmin,\n *     e => `Admin created: ${e.user.name}`\n *   ))\n * ```\n */\nexport function when<\n  Input extends Tagged,\n  Remaining extends Tagged,\n  Output,\n  Tag extends TagOf<Input>,\n  NewOutput,\n>(\n  tagValue: Tag,\n  predicate: (value: MatchTag<Input, Tag>) => boolean,\n  handler: (value: MatchTag<Input, Tag>) => NewOutput\n): (matcher: Matcher<Input, Remaining, Output>) => Matcher<Input, Remaining, Output | NewOutput> {\n  return (matcher) => {\n    const newHandlers = new Map(matcher.handlers);\n    const existingHandler = matcher.handlers.get(tagValue);\n\n    newHandlers.set(tagValue, (value: Tagged) => {\n      const typedValue = value as MatchTag<Input, Tag>;\n      if (predicate(typedValue)) {\n        return handler(typedValue);\n      }\n      if (existingHandler) {\n        return existingHandler(value);\n      }\n      throw new Error(`No handler matched for tag: ${tagValue}`);\n    });\n\n    return {\n      _tag: \"Matcher\",\n      value: matcher.value,\n      handlers: newHandlers,\n      _remaining: matcher._remaining,\n      _output: undefined as unknown as Output | NewOutput,\n    };\n  };\n}\n\n// =============================================================================\n// Type Narrowing Utilities\n// =============================================================================\n\n/**\n * Check if a tagged value has a specific tag.\n * Type guard that narrows the type.\n *\n * @example\n * ```typescript\n * if (Match.is(\"UserCreated\")(event)) {\n *   // event is narrowed to { _tag: 'UserCreated'; user: User }\n *   console.log(event.user.name);\n * }\n * ```\n */\nexport function is<T extends Tagged, Tag extends string>(\n  tagValue: Tag\n): (value: T) => value is Extract<T, { _tag: Tag }> {\n  return (value): value is Extract<T, { _tag: Tag }> => value._tag === tagValue;\n}\n\n/**\n * Check if a tagged value has one of several tags.\n *\n * @example\n * ```typescript\n * if (Match.isOneOf(\"UserCreated\", \"UserUpdated\")(event)) {\n *   // event is narrowed to UserCreated | UserUpdated\n * }\n * ```\n */\nexport function isOneOf<T extends Tagged, Tags extends TagOf<T>[]>(\n  ...tags: Tags\n): (value: T) => value is Extract<T, { _tag: Tags[number] }> {\n  const tagSet = new Set(tags);\n  return (value): value is Extract<T, { _tag: Tags[number] }> =>\n    tagSet.has(value._tag as Tags[number]);\n}\n\n// =============================================================================\n// Pipe Helper\n// =============================================================================\n\n/**\n * Type guard to check if a value is a Matcher.\n */\nfunction isMatcher(value: unknown): value is Matcher<Tagged, Tagged, unknown> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"_tag\" in value &&\n    (value as { _tag: unknown })._tag === \"Matcher\"\n  );\n}\n\ntype PipedMatcher<Input extends Tagged, Remaining extends Tagged, Output> =\n  Matcher<Input, Remaining, Output> & {\n    pipe: <NewRemaining extends Tagged, NewOutput>(\n      fn: (self: Matcher<Input, Remaining, Output>) => Matcher<Input, NewRemaining, NewOutput>\n    ) => PipedMatcher<Input, NewRemaining, NewOutput>;\n  } & {\n    pipe: <R>(fn: (self: Matcher<Input, Remaining, Output>) => R) => R;\n  };\n\nfunction addPipe<Input extends Tagged, Remaining extends Tagged, Output>(\n  matcher: Matcher<Input, Remaining, Output>\n): PipedMatcher<Input, Remaining, Output> {\n  return {\n    ...matcher,\n    pipe(fn: (self: Matcher<Input, Remaining, Output>) => unknown): unknown {\n      const result = fn(matcher);\n      // If result is a Matcher, add pipe to it too\n      if (isMatcher(result)) {\n        return addPipe(result as Matcher<Tagged, Tagged, unknown>);\n      }\n      return result;\n    },\n  } as PipedMatcher<Input, Remaining, Output>;\n}\n\n/**\n * Start matching on a value (with pipe support).\n *\n * @example\n * ```typescript\n * const result = Match.value(event)\n *   .pipe(Match.tag(\"Created\", e => e.id))\n *   .pipe(Match.exhaustive)\n * ```\n */\nexport function matchValue<T extends Tagged>(input: T): PipedMatcher<T, T, never> {\n  const matcher: Matcher<T, T, never> = {\n    _tag: \"Matcher\",\n    value: input,\n    handlers: new Map(),\n    _remaining: input as T,\n    _output: undefined as never,\n  };\n\n  return addPipe(matcher);\n}\n\n// =============================================================================\n// Namespace Export\n// =============================================================================\n\n/**\n * Match namespace for exhaustive pattern matching.\n *\n * @example\n * ```typescript\n * import { Match } from \"awaitly\";\n *\n * type Event =\n *   | { _tag: 'Created'; id: string }\n *   | { _tag: 'Updated'; id: string; data: unknown }\n *   | { _tag: 'Deleted'; id: string }\n *\n * function handle(event: Event): string {\n *   return Match.value(event)\n *     .pipe(Match.tag(\"Created\", e => `Created: ${e.id}`))\n *     .pipe(Match.tag(\"Updated\", e => `Updated: ${e.id}`))\n *     .pipe(Match.tag(\"Deleted\", e => `Deleted: ${e.id}`))\n *     .pipe(Match.exhaustive)\n * }\n * ```\n */\nexport const Match = {\n  value: matchValue,\n  tag,\n  tags,\n  when,\n  exhaustive,\n  orElse,\n  orElseValue,\n  is,\n  isOneOf,\n} as const;\n"],"mappings":"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","names":["match_entry_exports","__export","Match","exhaustive","isOneOf","is","orElse","tag","tags","matchValue","orElseValue","__toCommonJS","tag","tagValue","handler","matcher","newHandlers","tags","handlers","exhaustive","orElse","specificHandler","orElseValue","defaultValue","when","predicate","existingHandler","value","typedValue","is","isOneOf","tagSet","isMatcher","addPipe","fn","result","matchValue","input","Match"]}

package/dist/match.d.cts

@@ -1 +0,0 @@
-export { M as Match, b as Matcher, T as Tagged, e as exhaustive, i as isOneOf, c as isTag, o as matchOrElse, t as matchTag, d as matchTags, m as matchValue, f as orElseValue } from './match-entry-DjI2bLpD.cjs';

package/dist/match.d.ts

@@ -1 +0,0 @@
-export { M as Match, b as Matcher, T as Tagged, e as exhaustive, i as isOneOf, c as isTag, o as matchOrElse, t as matchTag, d as matchTags, m as matchValue, f as orElseValue } from './match-entry-DjI2bLpD.js';

package/dist/match.js

@@ -1,2 +0,0 @@
-function p(e,t){return n=>{let a=new Map(n.handlers);return a.set(e,t),{_tag:"Matcher",value:n.value,handlers:a,_remaining:void 0,_output:void 0}}}function d(e){return t=>{let n=new Map(t.handlers);for(let[a,u]of Object.entries(e))u&&n.set(a,u);return{_tag:"Matcher",value:t.value,handlers:n,_remaining:void 0,_output:void 0}}}function l(e){let t=e.handlers.get(e.value._tag);if(!t)throw new Error(`No handler for tag: ${e.value._tag}`);return t(e.value)}function g(e){return t=>{let n=t.handlers.get(t.value._tag);return n?n(t.value):e(t.value)}}function o(e){return g(()=>e)}function x(e,t,n){return a=>{let u=new Map(a.handlers),r=a.handlers.get(e);return u.set(e,i=>{let s=i;if(t(s))return n(s);if(r)return r(i);throw new Error(`No handler matched for tag: ${e}`)}),{_tag:"Matcher",value:a.value,handlers:u,_remaining:a._remaining,_output:void 0}}}function T(e){return t=>t._tag===e}function c(...e){let t=new Set(e);return n=>t.has(n._tag)}function f(e){return typeof e=="object"&&e!==null&&"_tag"in e&&e._tag==="Matcher"}function h(e){return{...e,pipe(t){let n=t(e);return f(n)?h(n):n}}}function O(e){return h({_tag:"Matcher",value:e,handlers:new Map,_remaining:e,_output:void 0})}var m={value:O,tag:p,tags:d,when:x,exhaustive:l,orElse:g,orElseValue:o,is:T,isOneOf:c};export{m as Match,l as exhaustive,c as isOneOf,T as isTag,g as matchOrElse,p as matchTag,d as matchTags,O as matchValue,o as orElseValue};
-//# sourceMappingURL=match.js.map

package/dist/match.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/match.ts"],"sourcesContent":["/**\n * awaitly/match\n *\n * Exhaustive pattern matching for discriminated unions.\n * Extends the TaggedError.match pattern to work with any tagged union.\n *\n * @example\n * ```typescript\n * type Event =\n *   | { _tag: 'UserCreated'; user: User }\n *   | { _tag: 'UserUpdated'; userId: string }\n *   | { _tag: 'UserDeleted'; userId: string }\n *\n * const message = Match.value(event)\n *   .pipe(Match.tag(\"UserCreated\", e => `Created: ${e.user.name}`))\n *   .pipe(Match.tag(\"UserUpdated\", e => `Updated: ${e.userId}`))\n *   .pipe(Match.tag(\"UserDeleted\", e => `Deleted: ${e.userId}`))\n *   .pipe(Match.exhaustive)\n * ```\n */\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Any object with a _tag discriminator.\n */\nexport type Tagged<Tag extends string = string> = { readonly _tag: Tag };\n\n/**\n * Extract the tag from a tagged union member.\n */\nexport type TagOf<T extends Tagged> = T[\"_tag\"];\n\n/**\n * Extract union members that match a specific tag.\n */\nexport type MatchTag<T extends Tagged, Tag extends string> = Extract<T, { _tag: Tag }>;\n\n/**\n * A matcher that is accumulating handlers for a tagged union.\n *\n * @typeParam Input - The full union type being matched\n * @typeParam Remaining - Union members that haven't been handled yet\n * @typeParam Output - The output type (union of all handler return types)\n */\nexport interface Matcher<Input extends Tagged, Remaining extends Tagged, Output> {\n  readonly _tag: \"Matcher\";\n  readonly value: Input;\n  readonly handlers: Map<string, (value: Tagged) => unknown>;\n  readonly _remaining: Remaining;\n  readonly _output: Output;\n}\n\n/**\n * A completed matcher that has handled all cases.\n */\nexport interface CompletedMatcher<Output> {\n  readonly _tag: \"CompletedMatcher\";\n  readonly result: Output;\n}\n\n// =============================================================================\n// Core Functions\n// =============================================================================\n\n\n/**\n * Add a handler for a specific tag.\n *\n * @example\n * ```typescript\n * Match.value(event)\n *   .pipe(Match.tag(\"UserCreated\", e => e.user.name))\n * ```\n */\nexport function tag<\n  Input extends Tagged,\n  Remaining extends Tagged,\n  Output,\n  Tag extends TagOf<Remaining>,\n  NewOutput,\n>(\n  tagValue: Tag,\n  handler: (value: MatchTag<Remaining, Tag>) => NewOutput\n): (\n  matcher: Matcher<Input, Remaining, Output>\n) => Matcher<Input, Exclude<Remaining, { _tag: Tag }>, Output | NewOutput> {\n  return (matcher) => {\n    const newHandlers = new Map(matcher.handlers);\n    newHandlers.set(tagValue, handler as (value: Tagged) => unknown);\n\n    return {\n      _tag: \"Matcher\",\n      value: matcher.value,\n      handlers: newHandlers,\n      _remaining: undefined as unknown as Exclude<Remaining, { _tag: Tag }>,\n      _output: undefined as unknown as Output | NewOutput,\n    };\n  };\n}\n\n/**\n * Add handlers for multiple tags at once.\n *\n * @example\n * ```typescript\n * Match.value(event)\n *   .pipe(Match.tags({\n *     UserCreated: e => e.user.name,\n *     UserUpdated: e => e.userId,\n *   }))\n * ```\n */\nexport function tags<\n  Input extends Tagged,\n  Remaining extends Tagged,\n  Output,\n  Handlers extends {\n    [K in TagOf<Remaining>]?: (value: MatchTag<Remaining, K>) => unknown;\n  },\n>(\n  handlers: Handlers\n): (\n  matcher: Matcher<Input, Remaining, Output>\n) => Matcher<\n  Input,\n  Exclude<Remaining, { _tag: keyof Handlers }>,\n  Output | ReturnType<NonNullable<Handlers[keyof Handlers]>>\n> {\n  return (matcher) => {\n    const newHandlers = new Map(matcher.handlers);\n    for (const [tagValue, handler] of Object.entries(handlers)) {\n      if (handler) {\n        newHandlers.set(tagValue, handler as (value: Tagged) => unknown);\n      }\n    }\n\n    return {\n      _tag: \"Matcher\",\n      value: matcher.value,\n      handlers: newHandlers,\n      _remaining: undefined as unknown as Exclude<Remaining, { _tag: keyof Handlers }>,\n      _output: undefined as unknown as Output | ReturnType<NonNullable<Handlers[keyof Handlers]>>,\n    };\n  };\n}\n\n/**\n * Complete the match, requiring all cases to be handled.\n * This is a compile-time check - if any cases are missing, TypeScript will error.\n *\n * @example\n * ```typescript\n * // TypeScript error if any tag is not handled\n * const result = Match.value(event)\n *   .pipe(Match.tag(\"UserCreated\", e => e.user))\n *   .pipe(Match.tag(\"UserUpdated\", e => e.userId))\n *   .pipe(Match.tag(\"UserDeleted\", e => e.userId))\n *   .pipe(Match.exhaustive)\n * ```\n */\nexport function exhaustive<Input extends Tagged, Output>(\n  matcher: Matcher<Input, never, Output>\n): Output {\n  const handler = matcher.handlers.get(matcher.value._tag);\n  if (!handler) {\n    throw new Error(`No handler for tag: ${matcher.value._tag}`);\n  }\n  return handler(matcher.value) as Output;\n}\n\n/**\n * Complete the match with a default handler for any remaining cases.\n *\n * @example\n * ```typescript\n * const result = Match.value(event)\n *   .pipe(Match.tag(\"UserCreated\", e => `Created: ${e.user.name}`))\n *   .pipe(Match.orElse(e => `Other event: ${e._tag}`))\n * ```\n */\nexport function orElse<Input extends Tagged, Remaining extends Tagged, Output, DefaultOutput>(\n  handler: (value: Remaining) => DefaultOutput\n): (matcher: Matcher<Input, Remaining, Output>) => Output | DefaultOutput {\n  return (matcher) => {\n    const specificHandler = matcher.handlers.get(matcher.value._tag);\n    if (specificHandler) {\n      return specificHandler(matcher.value) as Output;\n    }\n    return handler(matcher.value as unknown as Remaining);\n  };\n}\n\n/**\n * Complete the match with a default value for any remaining cases.\n *\n * @example\n * ```typescript\n * const result = Match.value(event)\n *   .pipe(Match.tag(\"UserCreated\", e => e.user.name))\n *   .pipe(Match.orElseValue(\"Unknown event\"))\n * ```\n */\nexport function orElseValue<Input extends Tagged, Remaining extends Tagged, Output, DefaultOutput>(\n  defaultValue: DefaultOutput\n): (matcher: Matcher<Input, Remaining, Output>) => Output | DefaultOutput {\n  return orElse(() => defaultValue);\n}\n\n// =============================================================================\n// Predicates & Guards\n// =============================================================================\n\n/**\n * Add a handler with an additional predicate.\n * The handler only runs if both the tag matches AND the predicate returns true.\n *\n * @example\n * ```typescript\n * Match.value(event)\n *   .pipe(Match.when(\n *     \"UserCreated\",\n *     e => e.user.isAdmin,\n *     e => `Admin created: ${e.user.name}`\n *   ))\n * ```\n */\nexport function when<\n  Input extends Tagged,\n  Remaining extends Tagged,\n  Output,\n  Tag extends TagOf<Input>,\n  NewOutput,\n>(\n  tagValue: Tag,\n  predicate: (value: MatchTag<Input, Tag>) => boolean,\n  handler: (value: MatchTag<Input, Tag>) => NewOutput\n): (matcher: Matcher<Input, Remaining, Output>) => Matcher<Input, Remaining, Output | NewOutput> {\n  return (matcher) => {\n    const newHandlers = new Map(matcher.handlers);\n    const existingHandler = matcher.handlers.get(tagValue);\n\n    newHandlers.set(tagValue, (value: Tagged) => {\n      const typedValue = value as MatchTag<Input, Tag>;\n      if (predicate(typedValue)) {\n        return handler(typedValue);\n      }\n      if (existingHandler) {\n        return existingHandler(value);\n      }\n      throw new Error(`No handler matched for tag: ${tagValue}`);\n    });\n\n    return {\n      _tag: \"Matcher\",\n      value: matcher.value,\n      handlers: newHandlers,\n      _remaining: matcher._remaining,\n      _output: undefined as unknown as Output | NewOutput,\n    };\n  };\n}\n\n// =============================================================================\n// Type Narrowing Utilities\n// =============================================================================\n\n/**\n * Check if a tagged value has a specific tag.\n * Type guard that narrows the type.\n *\n * @example\n * ```typescript\n * if (Match.is(\"UserCreated\")(event)) {\n *   // event is narrowed to { _tag: 'UserCreated'; user: User }\n *   console.log(event.user.name);\n * }\n * ```\n */\nexport function is<T extends Tagged, Tag extends string>(\n  tagValue: Tag\n): (value: T) => value is Extract<T, { _tag: Tag }> {\n  return (value): value is Extract<T, { _tag: Tag }> => value._tag === tagValue;\n}\n\n/**\n * Check if a tagged value has one of several tags.\n *\n * @example\n * ```typescript\n * if (Match.isOneOf(\"UserCreated\", \"UserUpdated\")(event)) {\n *   // event is narrowed to UserCreated | UserUpdated\n * }\n * ```\n */\nexport function isOneOf<T extends Tagged, Tags extends TagOf<T>[]>(\n  ...tags: Tags\n): (value: T) => value is Extract<T, { _tag: Tags[number] }> {\n  const tagSet = new Set(tags);\n  return (value): value is Extract<T, { _tag: Tags[number] }> =>\n    tagSet.has(value._tag as Tags[number]);\n}\n\n// =============================================================================\n// Pipe Helper\n// =============================================================================\n\n/**\n * Type guard to check if a value is a Matcher.\n */\nfunction isMatcher(value: unknown): value is Matcher<Tagged, Tagged, unknown> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"_tag\" in value &&\n    (value as { _tag: unknown })._tag === \"Matcher\"\n  );\n}\n\ntype PipedMatcher<Input extends Tagged, Remaining extends Tagged, Output> =\n  Matcher<Input, Remaining, Output> & {\n    pipe: <NewRemaining extends Tagged, NewOutput>(\n      fn: (self: Matcher<Input, Remaining, Output>) => Matcher<Input, NewRemaining, NewOutput>\n    ) => PipedMatcher<Input, NewRemaining, NewOutput>;\n  } & {\n    pipe: <R>(fn: (self: Matcher<Input, Remaining, Output>) => R) => R;\n  };\n\nfunction addPipe<Input extends Tagged, Remaining extends Tagged, Output>(\n  matcher: Matcher<Input, Remaining, Output>\n): PipedMatcher<Input, Remaining, Output> {\n  return {\n    ...matcher,\n    pipe(fn: (self: Matcher<Input, Remaining, Output>) => unknown): unknown {\n      const result = fn(matcher);\n      // If result is a Matcher, add pipe to it too\n      if (isMatcher(result)) {\n        return addPipe(result as Matcher<Tagged, Tagged, unknown>);\n      }\n      return result;\n    },\n  } as PipedMatcher<Input, Remaining, Output>;\n}\n\n/**\n * Start matching on a value (with pipe support).\n *\n * @example\n * ```typescript\n * const result = Match.value(event)\n *   .pipe(Match.tag(\"Created\", e => e.id))\n *   .pipe(Match.exhaustive)\n * ```\n */\nexport function matchValue<T extends Tagged>(input: T): PipedMatcher<T, T, never> {\n  const matcher: Matcher<T, T, never> = {\n    _tag: \"Matcher\",\n    value: input,\n    handlers: new Map(),\n    _remaining: input as T,\n    _output: undefined as never,\n  };\n\n  return addPipe(matcher);\n}\n\n// =============================================================================\n// Namespace Export\n// =============================================================================\n\n/**\n * Match namespace for exhaustive pattern matching.\n *\n * @example\n * ```typescript\n * import { Match } from \"awaitly\";\n *\n * type Event =\n *   | { _tag: 'Created'; id: string }\n *   | { _tag: 'Updated'; id: string; data: unknown }\n *   | { _tag: 'Deleted'; id: string }\n *\n * function handle(event: Event): string {\n *   return Match.value(event)\n *     .pipe(Match.tag(\"Created\", e => `Created: ${e.id}`))\n *     .pipe(Match.tag(\"Updated\", e => `Updated: ${e.id}`))\n *     .pipe(Match.tag(\"Deleted\", e => `Deleted: ${e.id}`))\n *     .pipe(Match.exhaustive)\n * }\n * ```\n */\nexport const Match = {\n  value: matchValue,\n  tag,\n  tags,\n  when,\n  exhaustive,\n  orElse,\n  orElseValue,\n  is,\n  isOneOf,\n} as const;\n"],"mappings":"AA6EO,SAASA,EAOdC,EACAC,EAGyE,CACzE,OAAQC,GAAY,CAClB,IAAMC,EAAc,IAAI,IAAID,EAAQ,QAAQ,EAC5C,OAAAC,EAAY,IAAIH,EAAUC,CAAqC,EAExD,CACL,KAAM,UACN,MAAOC,EAAQ,MACf,SAAUC,EACV,WAAY,OACZ,QAAS,MACX,CACF,CACF,CAcO,SAASC,EAQdC,EAOA,CACA,OAAQH,GAAY,CAClB,IAAMC,EAAc,IAAI,IAAID,EAAQ,QAAQ,EAC5C,OAAW,CAACF,EAAUC,CAAO,IAAK,OAAO,QAAQI,CAAQ,EACnDJ,GACFE,EAAY,IAAIH,EAAUC,CAAqC,EAInE,MAAO,CACL,KAAM,UACN,MAAOC,EAAQ,MACf,SAAUC,EACV,WAAY,OACZ,QAAS,MACX,CACF,CACF,CAgBO,SAASG,EACdJ,EACQ,CACR,IAAMD,EAAUC,EAAQ,SAAS,IAAIA,EAAQ,MAAM,IAAI,EACvD,GAAI,CAACD,EACH,MAAM,IAAI,MAAM,uBAAuBC,EAAQ,MAAM,IAAI,EAAE,EAE7D,OAAOD,EAAQC,EAAQ,KAAK,CAC9B,CAYO,SAASK,EACdN,EACwE,CACxE,OAAQC,GAAY,CAClB,IAAMM,EAAkBN,EAAQ,SAAS,IAAIA,EAAQ,MAAM,IAAI,EAC/D,OAAIM,EACKA,EAAgBN,EAAQ,KAAK,EAE/BD,EAAQC,EAAQ,KAA6B,CACtD,CACF,CAYO,SAASO,EACdC,EACwE,CACxE,OAAOH,EAAO,IAAMG,CAAY,CAClC,CAoBO,SAASC,EAOdX,EACAY,EACAX,EAC+F,CAC/F,OAAQC,GAAY,CAClB,IAAMC,EAAc,IAAI,IAAID,EAAQ,QAAQ,EACtCW,EAAkBX,EAAQ,SAAS,IAAIF,CAAQ,EAErD,OAAAG,EAAY,IAAIH,EAAWc,GAAkB,CAC3C,IAAMC,EAAaD,EACnB,GAAIF,EAAUG,CAAU,EACtB,OAAOd,EAAQc,CAAU,EAE3B,GAAIF,EACF,OAAOA,EAAgBC,CAAK,EAE9B,MAAM,IAAI,MAAM,+BAA+Bd,CAAQ,EAAE,CAC3D,CAAC,EAEM,CACL,KAAM,UACN,MAAOE,EAAQ,MACf,SAAUC,EACV,WAAYD,EAAQ,WACpB,QAAS,MACX,CACF,CACF,CAkBO,SAASc,EACdhB,EACkD,CAClD,OAAQc,GAA8CA,EAAM,OAASd,CACvE,CAYO,SAASiB,KACXb,EACwD,CAC3D,IAAMc,EAAS,IAAI,IAAId,CAAI,EAC3B,OAAQU,GACNI,EAAO,IAAIJ,EAAM,IAAoB,CACzC,CASA,SAASK,EAAUL,EAA2D,CAC5E,OACE,OAAOA,GAAU,UACjBA,IAAU,MACV,SAAUA,GACTA,EAA4B,OAAS,SAE1C,CAWA,SAASM,EACPlB,EACwC,CACxC,MAAO,CACL,GAAGA,EACH,KAAKmB,EAAmE,CACtE,IAAMC,EAASD,EAAGnB,CAAO,EAEzB,OAAIiB,EAAUG,CAAM,EACXF,EAAQE,CAA0C,EAEpDA,CACT,CACF,CACF,CAYO,SAASC,EAA6BC,EAAqC,CAShF,OAAOJ,EAR+B,CACpC,KAAM,UACN,MAAOI,EACP,SAAU,IAAI,IACd,WAAYA,EACZ,QAAS,MACX,CAEsB,CACxB,CA2BO,IAAMC,EAAQ,CACnB,MAAOF,EACP,IAAAxB,EACA,KAAAK,EACA,KAAAO,EACA,WAAAL,EACA,OAAAC,EACA,YAAAE,EACA,GAAAO,EACA,QAAAC,CACF","names":["tag","tagValue","handler","matcher","newHandlers","tags","handlers","exhaustive","orElse","specificHandler","orElseValue","defaultValue","when","predicate","existingHandler","value","typedValue","is","isOneOf","tagSet","isMatcher","addPipe","fn","result","matchValue","input","Match"]}

package/dist/otel.cjs

@@ -1,2 +0,0 @@
-"use strict";var w=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var A=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var T=(a,s)=>{for(var n in s)w(a,n,{get:s[n],enumerable:!0})},I=(a,s,n,e)=>{if(s&&typeof s=="object"||typeof s=="function")for(let r of A(s))!$.call(a,r)&&r!==n&&w(a,r,{get:()=>s[r],enumerable:!(e=y(s,r))||e.enumerable});return a};var M=a=>I(w({},"__esModule",{value:!0}),a);var S={};T(S,{createAutotelAdapter:()=>m,createAutotelEventHandler:()=>k,withAutotelTracing:()=>g});module.exports=M(S);function m(a={}){let{serviceName:s="workflow",createStepSpans:n=!0,recordMetrics:e=!0,defaultAttributes:r={},recordRetryEvents:u=!0,markErrorsOnSpan:f=!0}=a,i={workflows:new Map,steps:new Map},o={stepDurations:[],retryCount:0,errorCount:0,cacheHits:0,cacheMisses:0,defaultAttributes:r};function d(t,p){return t?`${s}.${t}`:p?`${s}.step.${p}`:`${s}.step`}function b(t){switch(t.type){case"workflow_start":i.workflows.set(t.workflowId,{workflowId:t.workflowId,startTime:t.ts});break;case"workflow_success":case"workflow_error":i.workflows.get(t.workflowId)&&i.workflows.delete(t.workflowId),t.type==="workflow_error"&&f&&o.errorCount++;break;case"step_start":if(n){let p=t.stepId;i.steps.set(p,{workflowId:t.workflowId,stepId:p,stepKey:t.stepKey,name:t.name,startTime:t.ts,metadata:t.metadata})}break;case"step_success":case"step_error":if(n){let p=t.stepId,c=i.steps.get(p);if(c){if(i.steps.delete(p),e){let l={...Object.keys(r).length>0?r:{}};c.metadata&&(c.metadata.domain&&(l["step.domain"]=c.metadata.domain),c.metadata.owner&&(l["step.owner"]=c.metadata.owner),c.metadata.intent&&c.metadata.intent.length<=100&&(l["step.intent"]=c.metadata.intent)),t.type==="step_error"&&t.diagnostics&&(t.diagnostics.classification?.severity&&(l["error.severity"]=t.diagnostics.classification.severity),t.diagnostics.classification?.retryable!==void 0&&(l["error.retryable"]=t.diagnostics.classification.retryable)),o.stepDurations.push({name:d(c.name,c.stepKey),durationMs:t.durationMs,success:t.type==="step_success",attributes:Object.keys(l).length>0?l:void 0})}t.type==="step_error"&&f&&o.errorCount++}}break;case"step_retry":u&&o.retryCount++;break;case"step_cache_hit":o.cacheHits++;break;case"step_cache_miss":o.cacheMisses++;break;default:break}}return{handleEvent:b,getActiveSpansCount(){return{workflows:i.workflows.size,steps:i.steps.size}},getMetrics(){return{...o,stepDurations:[...o.stepDurations]}},reset(){i.workflows.clear(),i.steps.clear(),o.stepDurations.length=0,o.retryCount=0,o.errorCount=0,o.cacheHits=0,o.cacheMisses=0}}}function k(a){let{serviceName:s="workflow",includeStepDetails:n=!0}=a??{};return e=>{if(process.env.AUTOTEL_DEBUG==="true"){let r=`[${s}]`;switch(e.type){case"workflow_start":console.log(`${r} Workflow started: ${e.workflowId}`);break;case"workflow_success":console.log(`${r} Workflow success: ${e.workflowId} (${e.durationMs}ms)`);break;case"workflow_error":console.log(`${r} Workflow error: ${e.workflowId}`,e.error);break;case"step_start":n&&console.log(`${r} Step started: ${e.name??e.stepKey??e.stepId}`);break;case"step_success":n&&console.log(`${r} Step success: ${e.name??e.stepKey??e.stepId} (${e.durationMs}ms)`);break;case"step_error":n&&console.log(`${r} Step error: ${e.name??e.stepKey??e.stepId}`,e.error);break;case"step_retry":console.log(`${r} Step retry: ${e.name??e.stepKey??e.stepId} (attempt ${e.attempt}/${e.maxAttempts})`);break}}}}function g(a,s){let{serviceName:n="workflow"}=s??{};return async(e,r,u)=>{let f=`${n}.${e}`;return a(f,async i=>{if(u)for(let[o,d]of Object.entries(u))i.setAttribute(o,d);return r()})}}0&&(module.exports={createAutotelAdapter,createAutotelEventHandler,withAutotelTracing});
-//# sourceMappingURL=otel.cjs.map

package/dist/otel.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/otel-entry.ts","../src/autotel.ts"],"sourcesContent":["/**\n * awaitly/otel\n *\n * OpenTelemetry integration: automatic tracing, metrics, and spans\n * for workflow execution with zero configuration.\n *\n * @example\n * ```typescript\n * import { createAutotelAdapter, withAutotelTracing } from 'awaitly/otel';\n * import { trace } from '@opentelemetry/api';\n *\n * const tracer = trace.getTracer('my-service');\n * const adapter = createAutotelAdapter({ tracer });\n *\n * const workflow = createWorkflow(deps, {\n *   onEvent: adapter.handleEvent,\n * });\n *\n * // Or wrap individual operations\n * const tracedFetch = withAutotelTracing(fetchUser, { tracer, name: 'fetchUser' });\n * ```\n */\n\nexport {\n  // Types\n  type AutotelAdapterConfig,\n  type AutotelMetrics,\n  type AutotelAdapter,\n  type AutotelTraceFn,\n\n  // Functions\n  createAutotelAdapter,\n  createAutotelEventHandler,\n  withAutotelTracing,\n} from \"./autotel\";\n","/**\n * Autotel Integration\n *\n * First-class OpenTelemetry spans and metrics from the workflow event stream\n * using the autotel library.\n *\n * @example\n * ```typescript\n * import { createAutotelAdapter } from 'awaitly/autotel';\n * import { init } from 'autotel';\n *\n * // Initialize autotel\n * init({ service: 'checkout-api' });\n *\n * // Create adapter\n * const otel = createAutotelAdapter({ serviceName: 'checkout' });\n *\n * // Use with workflow\n * const workflow = createWorkflow(deps, { onEvent: otel.handleEvent });\n *\n * // Automatic spans: workflow > step > retry attempts\n * // Automatic metrics: step_duration, retry_count, error_rate\n * ```\n */\n\nimport type { WorkflowEvent, StepMetadata } from \"./core\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Configuration for the autotel adapter.\n */\nexport interface AutotelAdapterConfig {\n  /**\n   * Service name for spans (used as prefix).\n   */\n  serviceName?: string;\n\n  /**\n   * Whether to create spans for each step.\n   * @default true\n   */\n  createStepSpans?: boolean;\n\n  /**\n   * Whether to record metrics for steps.\n   * @default true\n   */\n  recordMetrics?: boolean;\n\n  /**\n   * Custom attributes to add to all spans.\n   */\n  defaultAttributes?: Record<string, string | number | boolean>;\n\n  /**\n   * Whether to record retry events as span events.\n   * @default true\n   */\n  recordRetryEvents?: boolean;\n\n  /**\n   * Whether to mark workflow errors as span errors.\n   * @default true\n   */\n  markErrorsOnSpan?: boolean;\n}\n\n/**\n * Span tracking info.\n */\ninterface SpanInfo {\n  workflowId: string;\n  stepId?: string;\n  stepKey?: string;\n  name?: string;\n  startTime: number;\n  metadata?: StepMetadata;\n}\n\n/**\n * Active spans tracking.\n */\ninterface ActiveSpans {\n  workflows: Map<string, SpanInfo>;\n  steps: Map<string, SpanInfo>;\n}\n\n/**\n * Metrics collected by the adapter.\n */\nexport interface AutotelMetrics {\n  stepDurations: Array<{ \n    name: string; \n    durationMs: number; \n    success: boolean;\n    attributes?: Record<string, string | number | boolean>;\n  }>;\n  retryCount: number;\n  errorCount: number;\n  cacheHits: number;\n  cacheMisses: number;\n  /** Default attributes applied to all metrics */\n  defaultAttributes: Record<string, string | number | boolean>;\n}\n\n/**\n * Autotel adapter interface.\n */\nexport interface AutotelAdapter {\n  /**\n   * Handle workflow events (pass to onEvent option).\n   */\n  handleEvent: (event: WorkflowEvent<unknown>) => void;\n\n  /**\n   * Get current active spans count (for debugging).\n   */\n  getActiveSpansCount: () => { workflows: number; steps: number };\n\n  /**\n   * Get collected metrics.\n   */\n  getMetrics: () => AutotelMetrics;\n\n  /**\n   * Reset adapter state.\n   */\n  reset: () => void;\n}\n\n// =============================================================================\n// Implementation\n// =============================================================================\n\n/**\n * Create an autotel adapter for workflow observability.\n *\n * This adapter translates workflow events into metrics and tracking data.\n * When autotel is installed and initialized, it will also create OpenTelemetry spans.\n *\n * @param config - Adapter configuration\n * @returns An AutotelAdapter instance\n *\n * @example\n * ```typescript\n * import { createAutotelAdapter } from 'awaitly/autotel';\n *\n * const otel = createAutotelAdapter({ serviceName: 'checkout' });\n *\n * const workflow = createWorkflow(deps, {\n *   onEvent: otel.handleEvent,\n * });\n * ```\n */\nexport function createAutotelAdapter(\n  config: AutotelAdapterConfig = {}\n): AutotelAdapter {\n  const {\n    serviceName = \"workflow\",\n    createStepSpans = true,\n    recordMetrics = true,\n    defaultAttributes = {},\n    recordRetryEvents = true,\n    markErrorsOnSpan = true,\n  } = config;\n\n  // Track active spans\n  const activeSpans: ActiveSpans = {\n    workflows: new Map(),\n    steps: new Map(),\n  };\n\n  // Metrics counters\n  const metrics: AutotelMetrics = {\n    stepDurations: [],\n    retryCount: 0,\n    errorCount: 0,\n    cacheHits: 0,\n    cacheMisses: 0,\n    defaultAttributes,\n  };\n\n  /**\n   * Get span name for a step.\n   */\n  function getSpanName(name?: string, stepKey?: string): string {\n    if (name) return `${serviceName}.${name}`;\n    if (stepKey) return `${serviceName}.step.${stepKey}`;\n    return `${serviceName}.step`;\n  }\n\n  /**\n   * Handle workflow event.\n   */\n  function handleEvent(event: WorkflowEvent<unknown>): void {\n    switch (event.type) {\n      case \"workflow_start\":\n        activeSpans.workflows.set(event.workflowId, {\n          workflowId: event.workflowId,\n          startTime: event.ts,\n        });\n        break;\n\n      case \"workflow_success\":\n      case \"workflow_error\":\n        {\n          const span = activeSpans.workflows.get(event.workflowId);\n          if (span) {\n            activeSpans.workflows.delete(event.workflowId);\n          }\n\n          if (event.type === \"workflow_error\" && markErrorsOnSpan) {\n            metrics.errorCount++;\n          }\n        }\n        break;\n\n      case \"step_start\":\n        if (createStepSpans) {\n          const stepId = event.stepId;\n          activeSpans.steps.set(stepId, {\n            workflowId: event.workflowId,\n            stepId,\n            stepKey: event.stepKey,\n            name: event.name,\n            startTime: event.ts,\n            metadata: event.metadata,\n          });\n        }\n        break;\n\n      case \"step_success\":\n      case \"step_error\":\n        if (createStepSpans) {\n          const stepId = event.stepId;\n          const span = activeSpans.steps.get(stepId);\n          if (span) {\n            activeSpans.steps.delete(stepId);\n\n            if (recordMetrics) {\n              // Build attributes: default + low-cardinality metadata\n              const attrs: Record<string, string | number | boolean> = {\n                ...(Object.keys(defaultAttributes).length > 0 ? defaultAttributes : {}),\n              };\n\n              // Add low-cardinality metadata attributes (cardinality guardrails)\n              if (span.metadata) {\n                if (span.metadata.domain) attrs[\"step.domain\"] = span.metadata.domain;\n                if (span.metadata.owner) attrs[\"step.owner\"] = span.metadata.owner;\n                // step.intent only if <= 100 chars (cardinality guard)\n                if (span.metadata.intent && span.metadata.intent.length <= 100) {\n                  attrs[\"step.intent\"] = span.metadata.intent;\n                }\n                // Omit step.tags and step.calls from span attributes (high cardinality)\n              }\n\n              // Add error diagnostics attributes\n              if (event.type === \"step_error\" && event.diagnostics) {\n                if (event.diagnostics.classification?.severity) {\n                  attrs[\"error.severity\"] = event.diagnostics.classification.severity;\n                }\n                if (event.diagnostics.classification?.retryable !== undefined) {\n                  attrs[\"error.retryable\"] = event.diagnostics.classification.retryable;\n                }\n              }\n\n              metrics.stepDurations.push({\n                name: getSpanName(span.name, span.stepKey),\n                durationMs: event.durationMs,\n                success: event.type === \"step_success\",\n                attributes: Object.keys(attrs).length > 0 ? attrs : undefined,\n              });\n            }\n\n            if (event.type === \"step_error\" && markErrorsOnSpan) {\n              metrics.errorCount++;\n            }\n          }\n        }\n        break;\n\n      case \"step_retry\":\n        if (recordRetryEvents) {\n          metrics.retryCount++;\n        }\n        break;\n\n      case \"step_cache_hit\":\n        metrics.cacheHits++;\n        break;\n\n      case \"step_cache_miss\":\n        metrics.cacheMisses++;\n        break;\n\n      default:\n        // Other events (timeout, etc.) - can be extended\n        break;\n    }\n  }\n\n  return {\n    handleEvent,\n\n    getActiveSpansCount() {\n      return {\n        workflows: activeSpans.workflows.size,\n        steps: activeSpans.steps.size,\n      };\n    },\n\n    getMetrics() {\n      return { ...metrics, stepDurations: [...metrics.stepDurations] };\n    },\n\n    reset() {\n      activeSpans.workflows.clear();\n      activeSpans.steps.clear();\n      metrics.stepDurations.length = 0;\n      metrics.retryCount = 0;\n      metrics.errorCount = 0;\n      metrics.cacheHits = 0;\n      metrics.cacheMisses = 0;\n      // Note: defaultAttributes are preserved across resets\n    },\n  };\n}\n\n/**\n * Create an event handler that integrates with autotel's trace() function.\n *\n * This is a higher-level integration that creates actual OpenTelemetry spans\n * for each workflow and step when autotel is initialized.\n *\n * @param options - Configuration options\n * @returns An event handler function\n *\n * @example\n * ```typescript\n * import { createAutotelEventHandler } from 'awaitly/autotel';\n * import { init } from 'autotel';\n *\n * init({ service: 'checkout-api' });\n *\n * const handler = createAutotelEventHandler({ serviceName: 'checkout' });\n *\n * const workflow = createWorkflow(deps, {\n *   onEvent: handler,\n * });\n * ```\n */\nexport function createAutotelEventHandler(options?: {\n  serviceName?: string;\n  includeStepDetails?: boolean;\n}): (event: WorkflowEvent<unknown>) => void {\n  const { serviceName = \"workflow\", includeStepDetails = true } = options ?? {};\n\n  // This is a simple pass-through handler\n  // The actual autotel integration happens via the trace() wrapper\n  return (event: WorkflowEvent<unknown>) => {\n    // Log events for debugging when AUTOTEL_DEBUG is set\n    if (process.env.AUTOTEL_DEBUG === \"true\") {\n      const prefix = `[${serviceName}]`;\n      switch (event.type) {\n        case \"workflow_start\":\n          console.log(`${prefix} Workflow started: ${event.workflowId}`);\n          break;\n        case \"workflow_success\":\n          console.log(`${prefix} Workflow success: ${event.workflowId} (${event.durationMs}ms)`);\n          break;\n        case \"workflow_error\":\n          console.log(`${prefix} Workflow error: ${event.workflowId}`, event.error);\n          break;\n        case \"step_start\":\n          if (includeStepDetails) {\n            console.log(`${prefix} Step started: ${event.name ?? event.stepKey ?? event.stepId}`);\n          }\n          break;\n        case \"step_success\":\n          if (includeStepDetails) {\n            console.log(`${prefix} Step success: ${event.name ?? event.stepKey ?? event.stepId} (${event.durationMs}ms)`);\n          }\n          break;\n        case \"step_error\":\n          if (includeStepDetails) {\n            console.log(`${prefix} Step error: ${event.name ?? event.stepKey ?? event.stepId}`, event.error);\n          }\n          break;\n        case \"step_retry\":\n          console.log(`${prefix} Step retry: ${event.name ?? event.stepKey ?? event.stepId} (attempt ${event.attempt}/${event.maxAttempts})`);\n          break;\n      }\n    }\n  };\n}\n\n/**\n * Wrapper type for autotel trace function.\n * Use this when you want to explicitly type the autotel integration.\n */\nexport type AutotelTraceFn = <T>(\n  name: string,\n  fn: (ctx: { setAttribute: (key: string, value: unknown) => void }) => T | Promise<T>\n) => T | Promise<T>;\n\n/**\n * Create a workflow wrapper that adds autotel tracing.\n *\n * This creates a higher-order function that wraps workflow execution\n * in an autotel trace span.\n *\n * @param traceFn - The autotel trace function\n * @param options - Wrapper options\n * @returns A workflow wrapper function\n *\n * @example\n * ```typescript\n * import { trace } from 'autotel';\n * import { withAutotelTracing } from 'awaitly/autotel';\n *\n * const traced = withAutotelTracing(trace, { serviceName: 'checkout' });\n *\n * const result = await traced('process-order', async () => {\n *   return workflow(async ({ step }) => {\n *     // ... workflow logic\n *   });\n * });\n * ```\n */\nexport function withAutotelTracing(\n  traceFn: AutotelTraceFn,\n  options?: { serviceName?: string }\n): <T>(\n  name: string,\n  fn: () => T | Promise<T>,\n  attributes?: Record<string, string | number | boolean>\n) => Promise<T> {\n  const { serviceName = \"workflow\" } = options ?? {};\n\n  return async <T>(\n    name: string,\n    fn: () => T | Promise<T>,\n    attributes?: Record<string, string | number | boolean>\n  ): Promise<T> => {\n    const spanName = `${serviceName}.${name}`;\n    return traceFn(spanName, async (ctx) => {\n      if (attributes) {\n        for (const [key, value] of Object.entries(attributes)) {\n          ctx.setAttribute(key, value);\n        }\n      }\n      return fn();\n    }) as Promise<T>;\n  };\n}\n"],"mappings":"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","names":["otel_entry_exports","__export","createAutotelAdapter","createAutotelEventHandler","withAutotelTracing","__toCommonJS","createAutotelAdapter","config","serviceName","createStepSpans","recordMetrics","defaultAttributes","recordRetryEvents","markErrorsOnSpan","activeSpans","metrics","getSpanName","name","stepKey","handleEvent","event","stepId","span","attrs","createAutotelEventHandler","options","includeStepDetails","prefix","withAutotelTracing","traceFn","fn","attributes","spanName","ctx","key","value"]}

package/dist/otel.d.cts

@@ -1,188 +0,0 @@
-import { ag as WorkflowEvent } from './run-entry-D2MmJFj9.cjs';
-import './errors.cjs';
-import './tagged-error.cjs';
-import './slugs.cjs';
-
-/**
- * Autotel Integration
- *
- * First-class OpenTelemetry spans and metrics from the workflow event stream
- * using the autotel library.
- *
- * @example
- * ```typescript
- * import { createAutotelAdapter } from 'awaitly/autotel';
- * import { init } from 'autotel';
- *
- * // Initialize autotel
- * init({ service: 'checkout-api' });
- *
- * // Create adapter
- * const otel = createAutotelAdapter({ serviceName: 'checkout' });
- *
- * // Use with workflow
- * const workflow = createWorkflow(deps, { onEvent: otel.handleEvent });
- *
- * // Automatic spans: workflow > step > retry attempts
- * // Automatic metrics: step_duration, retry_count, error_rate
- * ```
- */
-
-/**
- * Configuration for the autotel adapter.
- */
-interface AutotelAdapterConfig {
-    /**
-     * Service name for spans (used as prefix).
-     */
-    serviceName?: string;
-    /**
-     * Whether to create spans for each step.
-     * @default true
-     */
-    createStepSpans?: boolean;
-    /**
-     * Whether to record metrics for steps.
-     * @default true
-     */
-    recordMetrics?: boolean;
-    /**
-     * Custom attributes to add to all spans.
-     */
-    defaultAttributes?: Record<string, string | number | boolean>;
-    /**
-     * Whether to record retry events as span events.
-     * @default true
-     */
-    recordRetryEvents?: boolean;
-    /**
-     * Whether to mark workflow errors as span errors.
-     * @default true
-     */
-    markErrorsOnSpan?: boolean;
-}
-/**
- * Metrics collected by the adapter.
- */
-interface AutotelMetrics {
-    stepDurations: Array<{
-        name: string;
-        durationMs: number;
-        success: boolean;
-        attributes?: Record<string, string | number | boolean>;
-    }>;
-    retryCount: number;
-    errorCount: number;
-    cacheHits: number;
-    cacheMisses: number;
-    /** Default attributes applied to all metrics */
-    defaultAttributes: Record<string, string | number | boolean>;
-}
-/**
- * Autotel adapter interface.
- */
-interface AutotelAdapter {
-    /**
-     * Handle workflow events (pass to onEvent option).
-     */
-    handleEvent: (event: WorkflowEvent<unknown>) => void;
-    /**
-     * Get current active spans count (for debugging).
-     */
-    getActiveSpansCount: () => {
-        workflows: number;
-        steps: number;
-    };
-    /**
-     * Get collected metrics.
-     */
-    getMetrics: () => AutotelMetrics;
-    /**
-     * Reset adapter state.
-     */
-    reset: () => void;
-}
-/**
- * Create an autotel adapter for workflow observability.
- *
- * This adapter translates workflow events into metrics and tracking data.
- * When autotel is installed and initialized, it will also create OpenTelemetry spans.
- *
- * @param config - Adapter configuration
- * @returns An AutotelAdapter instance
- *
- * @example
- * ```typescript
- * import { createAutotelAdapter } from 'awaitly/autotel';
- *
- * const otel = createAutotelAdapter({ serviceName: 'checkout' });
- *
- * const workflow = createWorkflow(deps, {
- *   onEvent: otel.handleEvent,
- * });
- * ```
- */
-declare function createAutotelAdapter(config?: AutotelAdapterConfig): AutotelAdapter;
-/**
- * Create an event handler that integrates with autotel's trace() function.
- *
- * This is a higher-level integration that creates actual OpenTelemetry spans
- * for each workflow and step when autotel is initialized.
- *
- * @param options - Configuration options
- * @returns An event handler function
- *
- * @example
- * ```typescript
- * import { createAutotelEventHandler } from 'awaitly/autotel';
- * import { init } from 'autotel';
- *
- * init({ service: 'checkout-api' });
- *
- * const handler = createAutotelEventHandler({ serviceName: 'checkout' });
- *
- * const workflow = createWorkflow(deps, {
- *   onEvent: handler,
- * });
- * ```
- */
-declare function createAutotelEventHandler(options?: {
-    serviceName?: string;
-    includeStepDetails?: boolean;
-}): (event: WorkflowEvent<unknown>) => void;
-/**
- * Wrapper type for autotel trace function.
- * Use this when you want to explicitly type the autotel integration.
- */
-type AutotelTraceFn = <T>(name: string, fn: (ctx: {
-    setAttribute: (key: string, value: unknown) => void;
-}) => T | Promise<T>) => T | Promise<T>;
-/**
- * Create a workflow wrapper that adds autotel tracing.
- *
- * This creates a higher-order function that wraps workflow execution
- * in an autotel trace span.
- *
- * @param traceFn - The autotel trace function
- * @param options - Wrapper options
- * @returns A workflow wrapper function
- *
- * @example
- * ```typescript
- * import { trace } from 'autotel';
- * import { withAutotelTracing } from 'awaitly/autotel';
- *
- * const traced = withAutotelTracing(trace, { serviceName: 'checkout' });
- *
- * const result = await traced('process-order', async () => {
- *   return workflow(async ({ step }) => {
- *     // ... workflow logic
- *   });
- * });
- * ```
- */
-declare function withAutotelTracing(traceFn: AutotelTraceFn, options?: {
-    serviceName?: string;
-}): <T>(name: string, fn: () => T | Promise<T>, attributes?: Record<string, string | number | boolean>) => Promise<T>;
-
-export { type AutotelAdapter, type AutotelAdapterConfig, type AutotelMetrics, type AutotelTraceFn, createAutotelAdapter, createAutotelEventHandler, withAutotelTracing };