awaitly 1.34.0 → 2.0.0

package/dist/singleflight.cjs

@@ -1,2 +0,0 @@
-"use strict";var g=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var h=(t,e)=>{for(var r in e)g(t,r,{get:e[r],enumerable:!0})},A=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of y(e))!p.call(t,s)&&s!==r&&g(t,s,{get:()=>e[s],enumerable:!(n=f(e,s))||n.enumerable});return t};var C=t=>A(g({},"__esModule",{value:!0}),t);var E={};h(E,{createSingleflightGroup:()=>a,singleflight:()=>o});module.exports=C(E);function o(t,e){let r=new Map,n=e.ttl?new Map:null;return async(...s)=>{let i=e.key(...s);if(n){let l=n.get(i);if(l&&l.expiresAt>Date.now())return l.result;l&&n.delete(i)}let c=r.get(i);if(c)return c;let u=t(...s).then(l=>(n&&e.ttl&&l.ok&&n.set(i,{result:l,expiresAt:Date.now()+e.ttl}),l)).finally(()=>{r.delete(i)});return r.set(i,u),u}}function a(){let t=new Map;return{execute:async(e,r)=>{let n=t.get(e);if(n)return n;let s=r().then(i=>i).finally(()=>{t.delete(e)});return t.set(e,s),s},isInflight:e=>t.has(e),size:()=>t.size,clear:()=>t.clear()}}0&&(module.exports={createSingleflightGroup,singleflight});
-//# sourceMappingURL=singleflight.cjs.map

package/dist/singleflight.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/singleflight-entry.ts","../src/singleflight.ts"],"sourcesContent":["/**\n * awaitly/singleflight\n *\n * Request coalescing - dedupe concurrent identical requests.\n * Multiple concurrent calls with the same key share one in-flight request.\n *\n * @example\n * ```typescript\n * import { singleflight } from 'awaitly/singleflight';\n * import { ok, type AsyncResult } from 'awaitly';\n *\n * const fetchUser = async (id: string): AsyncResult<User, 'NOT_FOUND'> =>\n *   id !== '0' ? ok({ id, name: `User ${id}` }) : err('NOT_FOUND');\n *\n * const fetchUserOnce = singleflight(fetchUser, {\n *   key: (id) => `user:${id}`,\n * });\n *\n * // All concurrent calls share one request\n * const [user1, user2] = await Promise.all([\n *   fetchUserOnce('1'),\n *   fetchUserOnce('1'),  // Same key - shares request\n * ]);\n * ```\n */\n\nexport {\n  singleflight,\n  createSingleflightGroup,\n  type SingleflightOptions,\n} from \"./singleflight\";\n","/**\n * awaitly/singleflight\n *\n * Request coalescing - dedupe concurrent identical requests.\n * Multiple concurrent calls with the same key share one in-flight request.\n *\n * @example\n * ```typescript\n * import { singleflight } from 'awaitly/singleflight';\n *\n * const fetchUserOnce = singleflight(\n *   (id: string) => fetchUser(id),\n *   { key: (id) => `user:${id}` }\n * );\n *\n * // All concurrent calls share one request\n * const [user1, user2] = await Promise.all([\n *   fetchUserOnce('1'),\n *   fetchUserOnce('1'),  // Same key - shares request\n * ]);\n * ```\n */\n\nimport { type Result, type AsyncResult } from \"./core\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Options for the singleflight wrapper.\n */\nexport type SingleflightOptions<Args extends unknown[]> = {\n  /**\n   * Extract cache key from arguments.\n   * Calls with the same key will share one in-flight request.\n   */\n  key: (...args: Args) => string;\n\n  /**\n   * Optional TTL in milliseconds to cache successful results.\n   * After TTL expires, next call will trigger a fresh request.\n   * @default 0 (no caching after completion - only dedupes in-flight requests)\n   */\n  ttl?: number;\n};\n\n/**\n * Internal cache entry for TTL-based caching.\n */\ninterface CacheEntry<T, E, C> {\n  result: Result<T, E, C>;\n  expiresAt: number;\n}\n\n// =============================================================================\n// Implementation\n// =============================================================================\n\n/**\n * Create a singleflight-wrapped function.\n * Concurrent calls with the same key share one in-flight request.\n *\n * ## How It Works\n *\n * 1. First caller with a key starts the operation\n * 2. Subsequent callers with the same key get the same Promise\n * 3. When operation completes, all callers receive the same Result\n * 4. Key is removed from in-flight tracking (unless TTL is set)\n *\n * ## Use Cases\n *\n * - **Prevent thundering herd**: Multiple requests for the same user\n * - **API deduplication**: Avoid duplicate network calls\n * - **Expensive operations**: Share computation across callers\n *\n * @param operation - The async operation that returns an AsyncResult\n * @param options - Configuration with key extraction function\n * @returns A wrapped function that deduplicates concurrent calls\n *\n * @example\n * ```typescript\n * import { singleflight } from 'awaitly/singleflight';\n * import { ok, err, type AsyncResult } from 'awaitly';\n *\n * const fetchUser = async (id: string): AsyncResult<User, 'NOT_FOUND'> =>\n *   id !== '0' ? ok({ id, name: `User ${id}` }) : err('NOT_FOUND');\n *\n * const fetchUserOnce = singleflight(fetchUser, {\n *   key: (id) => `user:${id}`,\n * });\n *\n * // Concurrent calls share one request\n * const [a, b, c] = await Promise.all([\n *   fetchUserOnce('1'),  // Triggers fetch\n *   fetchUserOnce('1'),  // Joins existing fetch\n *   fetchUserOnce('2'),  // Different key - new fetch\n * ]);\n * ```\n *\n * @example\n * ```typescript\n * // With TTL for result caching\n * const fetchUserCached = singleflight(fetchUser, {\n *   key: (id) => `user:${id}`,\n *   ttl: 5000,  // Cache successful results for 5 seconds\n * });\n *\n * const user1 = await fetchUserCached('1');  // Fetches\n * const user2 = await fetchUserCached('1');  // Returns cached (within TTL)\n * // After 5 seconds...\n * const user3 = await fetchUserCached('1');  // Fetches again\n * ```\n */\nexport function singleflight<Args extends unknown[], T, E, C = unknown>(\n  operation: (...args: Args) => AsyncResult<T, E, C>,\n  options: SingleflightOptions<Args>\n): (...args: Args) => AsyncResult<T, E, C> {\n  // In-flight requests by key\n  const inflight = new Map<string, Promise<Result<T, E, C>>>();\n\n  // Cached results by key (only if TTL is set)\n  const cache = options.ttl ? new Map<string, CacheEntry<T, E, C>>() : null;\n\n  return async (...args: Args): AsyncResult<T, E, C> => {\n    const key = options.key(...args);\n\n    // Check TTL cache first (if enabled)\n    if (cache) {\n      const cached = cache.get(key);\n      if (cached && cached.expiresAt > Date.now()) {\n        return cached.result;\n      }\n      // Expired - remove from cache\n      if (cached) {\n        cache.delete(key);\n      }\n    }\n\n    // Check for existing in-flight request\n    const existing = inflight.get(key);\n    if (existing) {\n      return existing;\n    }\n\n    // Start new request\n    // Use .finally() to ensure cleanup happens even if operation throws\n    const promise = operation(...args)\n      .then((result) => {\n        // Cache successful results if TTL is set\n        if (cache && options.ttl && result.ok) {\n          cache.set(key, {\n            result,\n            expiresAt: Date.now() + options.ttl,\n          });\n        }\n        return result;\n      })\n      .finally(() => {\n        // Always remove from in-flight tracking, success or failure\n        inflight.delete(key);\n      });\n\n    inflight.set(key, promise);\n    return promise;\n  };\n}\n\n/**\n * Create a singleflight group with manual key management.\n * More flexible but lower-level API than the `singleflight` wrapper.\n *\n * @returns A group object with execute, isInflight, and clear methods\n *\n * @example\n * ```typescript\n * import { createSingleflightGroup } from 'awaitly/singleflight';\n *\n * const group = createSingleflightGroup<User, 'NOT_FOUND'>();\n *\n * // Execute with manual key\n * const user1 = await group.execute('user:1', () => fetchUser('1'));\n * const user2 = await group.execute('user:1', () => fetchUser('1')); // Shares request\n *\n * // Check if request is in-flight\n * if (group.isInflight('user:1')) {\n *   console.log('Request pending');\n * }\n *\n * // Clear all in-flight requests\n * group.clear();\n * ```\n */\nexport function createSingleflightGroup<T, E, C = unknown>(): {\n  /**\n   * Execute or join an in-flight request for the given key.\n   */\n  execute: (\n    key: string,\n    operation: () => AsyncResult<T, E, C>\n  ) => AsyncResult<T, E, C>;\n\n  /**\n   * Check if a request is currently in-flight for the key.\n   */\n  isInflight: (key: string) => boolean;\n\n  /**\n   * Get the number of in-flight requests.\n   */\n  size: () => number;\n\n  /**\n   * Clear all in-flight tracking (does not cancel operations).\n   */\n  clear: () => void;\n} {\n  const inflight = new Map<string, Promise<Result<T, E, C>>>();\n\n  return {\n    execute: async (\n      key: string,\n      operation: () => AsyncResult<T, E, C>\n    ): AsyncResult<T, E, C> => {\n      // Return existing in-flight promise if present\n      const existing = inflight.get(key);\n      if (existing) {\n        return existing;\n      }\n\n      // Start new request\n      // Use .finally() to ensure cleanup happens even if operation throws\n      const promise = operation()\n        .then((result) => result)\n        .finally(() => {\n          inflight.delete(key);\n        });\n\n      inflight.set(key, promise);\n      return promise;\n    },\n\n    isInflight: (key: string) => inflight.has(key),\n\n    size: () => inflight.size,\n\n    clear: () => inflight.clear(),\n  };\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,6BAAAE,EAAA,iBAAAC,IAAA,eAAAC,EAAAJ,GCkHO,SAASK,EACdC,EACAC,EACyC,CAEzC,IAAMC,EAAW,IAAI,IAGfC,EAAQF,EAAQ,IAAM,IAAI,IAAqC,KAErE,MAAO,UAAUG,IAAqC,CACpD,IAAMC,EAAMJ,EAAQ,IAAI,GAAGG,CAAI,EAG/B,GAAID,EAAO,CACT,IAAMG,EAASH,EAAM,IAAIE,CAAG,EAC5B,GAAIC,GAAUA,EAAO,UAAY,KAAK,IAAI,EACxC,OAAOA,EAAO,OAGZA,GACFH,EAAM,OAAOE,CAAG,CAEpB,CAGA,IAAME,EAAWL,EAAS,IAAIG,CAAG,EACjC,GAAIE,EACF,OAAOA,EAKT,IAAMC,EAAUR,EAAU,GAAGI,CAAI,EAC9B,KAAMK,IAEDN,GAASF,EAAQ,KAAOQ,EAAO,IACjCN,EAAM,IAAIE,EAAK,CACb,OAAAI,EACA,UAAW,KAAK,IAAI,EAAIR,EAAQ,GAClC,CAAC,EAEIQ,EACR,EACA,QAAQ,IAAM,CAEbP,EAAS,OAAOG,CAAG,CACrB,CAAC,EAEH,OAAAH,EAAS,IAAIG,EAAKG,CAAO,EAClBA,CACT,CACF,CA2BO,SAASE,GAuBd,CACA,IAAMR,EAAW,IAAI,IAErB,MAAO,CACL,QAAS,MACPG,EACAL,IACyB,CAEzB,IAAMO,EAAWL,EAAS,IAAIG,CAAG,EACjC,GAAIE,EACF,OAAOA,EAKT,IAAMC,EAAUR,EAAU,EACvB,KAAMS,GAAWA,CAAM,EACvB,QAAQ,IAAM,CACbP,EAAS,OAAOG,CAAG,CACrB,CAAC,EAEH,OAAAH,EAAS,IAAIG,EAAKG,CAAO,EAClBA,CACT,EAEA,WAAaH,GAAgBH,EAAS,IAAIG,CAAG,EAE7C,KAAM,IAAMH,EAAS,KAErB,MAAO,IAAMA,EAAS,MAAM,CAC9B,CACF","names":["singleflight_entry_exports","__export","createSingleflightGroup","singleflight","__toCommonJS","singleflight","operation","options","inflight","cache","args","key","cached","existing","promise","result","createSingleflightGroup"]}

package/dist/singleflight.d.cts

@@ -1,145 +0,0 @@
-import { c as AsyncResult } from './run-entry-D2MmJFj9.cjs';
-import './errors.cjs';
-import './tagged-error.cjs';
-import './slugs.cjs';
-
-/**
- * awaitly/singleflight
- *
- * Request coalescing - dedupe concurrent identical requests.
- * Multiple concurrent calls with the same key share one in-flight request.
- *
- * @example
- * ```typescript
- * import { singleflight } from 'awaitly/singleflight';
- *
- * const fetchUserOnce = singleflight(
- *   (id: string) => fetchUser(id),
- *   { key: (id) => `user:${id}` }
- * );
- *
- * // All concurrent calls share one request
- * const [user1, user2] = await Promise.all([
- *   fetchUserOnce('1'),
- *   fetchUserOnce('1'),  // Same key - shares request
- * ]);
- * ```
- */
-
-/**
- * Options for the singleflight wrapper.
- */
-type SingleflightOptions<Args extends unknown[]> = {
-    /**
-     * Extract cache key from arguments.
-     * Calls with the same key will share one in-flight request.
-     */
-    key: (...args: Args) => string;
-    /**
-     * Optional TTL in milliseconds to cache successful results.
-     * After TTL expires, next call will trigger a fresh request.
-     * @default 0 (no caching after completion - only dedupes in-flight requests)
-     */
-    ttl?: number;
-};
-/**
- * Create a singleflight-wrapped function.
- * Concurrent calls with the same key share one in-flight request.
- *
- * ## How It Works
- *
- * 1. First caller with a key starts the operation
- * 2. Subsequent callers with the same key get the same Promise
- * 3. When operation completes, all callers receive the same Result
- * 4. Key is removed from in-flight tracking (unless TTL is set)
- *
- * ## Use Cases
- *
- * - **Prevent thundering herd**: Multiple requests for the same user
- * - **API deduplication**: Avoid duplicate network calls
- * - **Expensive operations**: Share computation across callers
- *
- * @param operation - The async operation that returns an AsyncResult
- * @param options - Configuration with key extraction function
- * @returns A wrapped function that deduplicates concurrent calls
- *
- * @example
- * ```typescript
- * import { singleflight } from 'awaitly/singleflight';
- * import { ok, err, type AsyncResult } from 'awaitly';
- *
- * const fetchUser = async (id: string): AsyncResult<User, 'NOT_FOUND'> =>
- *   id !== '0' ? ok({ id, name: `User ${id}` }) : err('NOT_FOUND');
- *
- * const fetchUserOnce = singleflight(fetchUser, {
- *   key: (id) => `user:${id}`,
- * });
- *
- * // Concurrent calls share one request
- * const [a, b, c] = await Promise.all([
- *   fetchUserOnce('1'),  // Triggers fetch
- *   fetchUserOnce('1'),  // Joins existing fetch
- *   fetchUserOnce('2'),  // Different key - new fetch
- * ]);
- * ```
- *
- * @example
- * ```typescript
- * // With TTL for result caching
- * const fetchUserCached = singleflight(fetchUser, {
- *   key: (id) => `user:${id}`,
- *   ttl: 5000,  // Cache successful results for 5 seconds
- * });
- *
- * const user1 = await fetchUserCached('1');  // Fetches
- * const user2 = await fetchUserCached('1');  // Returns cached (within TTL)
- * // After 5 seconds...
- * const user3 = await fetchUserCached('1');  // Fetches again
- * ```
- */
-declare function singleflight<Args extends unknown[], T, E, C = unknown>(operation: (...args: Args) => AsyncResult<T, E, C>, options: SingleflightOptions<Args>): (...args: Args) => AsyncResult<T, E, C>;
-/**
- * Create a singleflight group with manual key management.
- * More flexible but lower-level API than the `singleflight` wrapper.
- *
- * @returns A group object with execute, isInflight, and clear methods
- *
- * @example
- * ```typescript
- * import { createSingleflightGroup } from 'awaitly/singleflight';
- *
- * const group = createSingleflightGroup<User, 'NOT_FOUND'>();
- *
- * // Execute with manual key
- * const user1 = await group.execute('user:1', () => fetchUser('1'));
- * const user2 = await group.execute('user:1', () => fetchUser('1')); // Shares request
- *
- * // Check if request is in-flight
- * if (group.isInflight('user:1')) {
- *   console.log('Request pending');
- * }
- *
- * // Clear all in-flight requests
- * group.clear();
- * ```
- */
-declare function createSingleflightGroup<T, E, C = unknown>(): {
-    /**
-     * Execute or join an in-flight request for the given key.
-     */
-    execute: (key: string, operation: () => AsyncResult<T, E, C>) => AsyncResult<T, E, C>;
-    /**
-     * Check if a request is currently in-flight for the key.
-     */
-    isInflight: (key: string) => boolean;
-    /**
-     * Get the number of in-flight requests.
-     */
-    size: () => number;
-    /**
-     * Clear all in-flight tracking (does not cancel operations).
-     */
-    clear: () => void;
-};
-
-export { type SingleflightOptions, createSingleflightGroup, singleflight };

package/dist/singleflight.d.ts

@@ -1,145 +0,0 @@
-import { c as AsyncResult } from './run-entry-Dduz-is2.js';
-import './errors.js';
-import './tagged-error.js';
-import './slugs.js';
-
-/**
- * awaitly/singleflight
- *
- * Request coalescing - dedupe concurrent identical requests.
- * Multiple concurrent calls with the same key share one in-flight request.
- *
- * @example
- * ```typescript
- * import { singleflight } from 'awaitly/singleflight';
- *
- * const fetchUserOnce = singleflight(
- *   (id: string) => fetchUser(id),
- *   { key: (id) => `user:${id}` }
- * );
- *
- * // All concurrent calls share one request
- * const [user1, user2] = await Promise.all([
- *   fetchUserOnce('1'),
- *   fetchUserOnce('1'),  // Same key - shares request
- * ]);
- * ```
- */
-
-/**
- * Options for the singleflight wrapper.
- */
-type SingleflightOptions<Args extends unknown[]> = {
-    /**
-     * Extract cache key from arguments.
-     * Calls with the same key will share one in-flight request.
-     */
-    key: (...args: Args) => string;
-    /**
-     * Optional TTL in milliseconds to cache successful results.
-     * After TTL expires, next call will trigger a fresh request.
-     * @default 0 (no caching after completion - only dedupes in-flight requests)
-     */
-    ttl?: number;
-};
-/**
- * Create a singleflight-wrapped function.
- * Concurrent calls with the same key share one in-flight request.
- *
- * ## How It Works
- *
- * 1. First caller with a key starts the operation
- * 2. Subsequent callers with the same key get the same Promise
- * 3. When operation completes, all callers receive the same Result
- * 4. Key is removed from in-flight tracking (unless TTL is set)
- *
- * ## Use Cases
- *
- * - **Prevent thundering herd**: Multiple requests for the same user
- * - **API deduplication**: Avoid duplicate network calls
- * - **Expensive operations**: Share computation across callers
- *
- * @param operation - The async operation that returns an AsyncResult
- * @param options - Configuration with key extraction function
- * @returns A wrapped function that deduplicates concurrent calls
- *
- * @example
- * ```typescript
- * import { singleflight } from 'awaitly/singleflight';
- * import { ok, err, type AsyncResult } from 'awaitly';
- *
- * const fetchUser = async (id: string): AsyncResult<User, 'NOT_FOUND'> =>
- *   id !== '0' ? ok({ id, name: `User ${id}` }) : err('NOT_FOUND');
- *
- * const fetchUserOnce = singleflight(fetchUser, {
- *   key: (id) => `user:${id}`,
- * });
- *
- * // Concurrent calls share one request
- * const [a, b, c] = await Promise.all([
- *   fetchUserOnce('1'),  // Triggers fetch
- *   fetchUserOnce('1'),  // Joins existing fetch
- *   fetchUserOnce('2'),  // Different key - new fetch
- * ]);
- * ```
- *
- * @example
- * ```typescript
- * // With TTL for result caching
- * const fetchUserCached = singleflight(fetchUser, {
- *   key: (id) => `user:${id}`,
- *   ttl: 5000,  // Cache successful results for 5 seconds
- * });
- *
- * const user1 = await fetchUserCached('1');  // Fetches
- * const user2 = await fetchUserCached('1');  // Returns cached (within TTL)
- * // After 5 seconds...
- * const user3 = await fetchUserCached('1');  // Fetches again
- * ```
- */
-declare function singleflight<Args extends unknown[], T, E, C = unknown>(operation: (...args: Args) => AsyncResult<T, E, C>, options: SingleflightOptions<Args>): (...args: Args) => AsyncResult<T, E, C>;
-/**
- * Create a singleflight group with manual key management.
- * More flexible but lower-level API than the `singleflight` wrapper.
- *
- * @returns A group object with execute, isInflight, and clear methods
- *
- * @example
- * ```typescript
- * import { createSingleflightGroup } from 'awaitly/singleflight';
- *
- * const group = createSingleflightGroup<User, 'NOT_FOUND'>();
- *
- * // Execute with manual key
- * const user1 = await group.execute('user:1', () => fetchUser('1'));
- * const user2 = await group.execute('user:1', () => fetchUser('1')); // Shares request
- *
- * // Check if request is in-flight
- * if (group.isInflight('user:1')) {
- *   console.log('Request pending');
- * }
- *
- * // Clear all in-flight requests
- * group.clear();
- * ```
- */
-declare function createSingleflightGroup<T, E, C = unknown>(): {
-    /**
-     * Execute or join an in-flight request for the given key.
-     */
-    execute: (key: string, operation: () => AsyncResult<T, E, C>) => AsyncResult<T, E, C>;
-    /**
-     * Check if a request is currently in-flight for the key.
-     */
-    isInflight: (key: string) => boolean;
-    /**
-     * Get the number of in-flight requests.
-     */
-    size: () => number;
-    /**
-     * Clear all in-flight tracking (does not cancel operations).
-     */
-    clear: () => void;
-};
-
-export { type SingleflightOptions, createSingleflightGroup, singleflight };

package/dist/singleflight.js

@@ -1,2 +0,0 @@
-function u(t,e){let i=new Map,n=e.ttl?new Map:null;return async(...l)=>{let s=e.key(...l);if(n){let r=n.get(s);if(r&&r.expiresAt>Date.now())return r.result;r&&n.delete(s)}let g=i.get(s);if(g)return g;let c=t(...l).then(r=>(n&&e.ttl&&r.ok&&n.set(s,{result:r,expiresAt:Date.now()+e.ttl}),r)).finally(()=>{i.delete(s)});return i.set(s,c),c}}function o(){let t=new Map;return{execute:async(e,i)=>{let n=t.get(e);if(n)return n;let l=i().then(s=>s).finally(()=>{t.delete(e)});return t.set(e,l),l},isInflight:e=>t.has(e),size:()=>t.size,clear:()=>t.clear()}}export{o as createSingleflightGroup,u as singleflight};
-//# sourceMappingURL=singleflight.js.map

package/dist/singleflight.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/singleflight.ts"],"sourcesContent":["/**\n * awaitly/singleflight\n *\n * Request coalescing - dedupe concurrent identical requests.\n * Multiple concurrent calls with the same key share one in-flight request.\n *\n * @example\n * ```typescript\n * import { singleflight } from 'awaitly/singleflight';\n *\n * const fetchUserOnce = singleflight(\n *   (id: string) => fetchUser(id),\n *   { key: (id) => `user:${id}` }\n * );\n *\n * // All concurrent calls share one request\n * const [user1, user2] = await Promise.all([\n *   fetchUserOnce('1'),\n *   fetchUserOnce('1'),  // Same key - shares request\n * ]);\n * ```\n */\n\nimport { type Result, type AsyncResult } from \"./core\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Options for the singleflight wrapper.\n */\nexport type SingleflightOptions<Args extends unknown[]> = {\n  /**\n   * Extract cache key from arguments.\n   * Calls with the same key will share one in-flight request.\n   */\n  key: (...args: Args) => string;\n\n  /**\n   * Optional TTL in milliseconds to cache successful results.\n   * After TTL expires, next call will trigger a fresh request.\n   * @default 0 (no caching after completion - only dedupes in-flight requests)\n   */\n  ttl?: number;\n};\n\n/**\n * Internal cache entry for TTL-based caching.\n */\ninterface CacheEntry<T, E, C> {\n  result: Result<T, E, C>;\n  expiresAt: number;\n}\n\n// =============================================================================\n// Implementation\n// =============================================================================\n\n/**\n * Create a singleflight-wrapped function.\n * Concurrent calls with the same key share one in-flight request.\n *\n * ## How It Works\n *\n * 1. First caller with a key starts the operation\n * 2. Subsequent callers with the same key get the same Promise\n * 3. When operation completes, all callers receive the same Result\n * 4. Key is removed from in-flight tracking (unless TTL is set)\n *\n * ## Use Cases\n *\n * - **Prevent thundering herd**: Multiple requests for the same user\n * - **API deduplication**: Avoid duplicate network calls\n * - **Expensive operations**: Share computation across callers\n *\n * @param operation - The async operation that returns an AsyncResult\n * @param options - Configuration with key extraction function\n * @returns A wrapped function that deduplicates concurrent calls\n *\n * @example\n * ```typescript\n * import { singleflight } from 'awaitly/singleflight';\n * import { ok, err, type AsyncResult } from 'awaitly';\n *\n * const fetchUser = async (id: string): AsyncResult<User, 'NOT_FOUND'> =>\n *   id !== '0' ? ok({ id, name: `User ${id}` }) : err('NOT_FOUND');\n *\n * const fetchUserOnce = singleflight(fetchUser, {\n *   key: (id) => `user:${id}`,\n * });\n *\n * // Concurrent calls share one request\n * const [a, b, c] = await Promise.all([\n *   fetchUserOnce('1'),  // Triggers fetch\n *   fetchUserOnce('1'),  // Joins existing fetch\n *   fetchUserOnce('2'),  // Different key - new fetch\n * ]);\n * ```\n *\n * @example\n * ```typescript\n * // With TTL for result caching\n * const fetchUserCached = singleflight(fetchUser, {\n *   key: (id) => `user:${id}`,\n *   ttl: 5000,  // Cache successful results for 5 seconds\n * });\n *\n * const user1 = await fetchUserCached('1');  // Fetches\n * const user2 = await fetchUserCached('1');  // Returns cached (within TTL)\n * // After 5 seconds...\n * const user3 = await fetchUserCached('1');  // Fetches again\n * ```\n */\nexport function singleflight<Args extends unknown[], T, E, C = unknown>(\n  operation: (...args: Args) => AsyncResult<T, E, C>,\n  options: SingleflightOptions<Args>\n): (...args: Args) => AsyncResult<T, E, C> {\n  // In-flight requests by key\n  const inflight = new Map<string, Promise<Result<T, E, C>>>();\n\n  // Cached results by key (only if TTL is set)\n  const cache = options.ttl ? new Map<string, CacheEntry<T, E, C>>() : null;\n\n  return async (...args: Args): AsyncResult<T, E, C> => {\n    const key = options.key(...args);\n\n    // Check TTL cache first (if enabled)\n    if (cache) {\n      const cached = cache.get(key);\n      if (cached && cached.expiresAt > Date.now()) {\n        return cached.result;\n      }\n      // Expired - remove from cache\n      if (cached) {\n        cache.delete(key);\n      }\n    }\n\n    // Check for existing in-flight request\n    const existing = inflight.get(key);\n    if (existing) {\n      return existing;\n    }\n\n    // Start new request\n    // Use .finally() to ensure cleanup happens even if operation throws\n    const promise = operation(...args)\n      .then((result) => {\n        // Cache successful results if TTL is set\n        if (cache && options.ttl && result.ok) {\n          cache.set(key, {\n            result,\n            expiresAt: Date.now() + options.ttl,\n          });\n        }\n        return result;\n      })\n      .finally(() => {\n        // Always remove from in-flight tracking, success or failure\n        inflight.delete(key);\n      });\n\n    inflight.set(key, promise);\n    return promise;\n  };\n}\n\n/**\n * Create a singleflight group with manual key management.\n * More flexible but lower-level API than the `singleflight` wrapper.\n *\n * @returns A group object with execute, isInflight, and clear methods\n *\n * @example\n * ```typescript\n * import { createSingleflightGroup } from 'awaitly/singleflight';\n *\n * const group = createSingleflightGroup<User, 'NOT_FOUND'>();\n *\n * // Execute with manual key\n * const user1 = await group.execute('user:1', () => fetchUser('1'));\n * const user2 = await group.execute('user:1', () => fetchUser('1')); // Shares request\n *\n * // Check if request is in-flight\n * if (group.isInflight('user:1')) {\n *   console.log('Request pending');\n * }\n *\n * // Clear all in-flight requests\n * group.clear();\n * ```\n */\nexport function createSingleflightGroup<T, E, C = unknown>(): {\n  /**\n   * Execute or join an in-flight request for the given key.\n   */\n  execute: (\n    key: string,\n    operation: () => AsyncResult<T, E, C>\n  ) => AsyncResult<T, E, C>;\n\n  /**\n   * Check if a request is currently in-flight for the key.\n   */\n  isInflight: (key: string) => boolean;\n\n  /**\n   * Get the number of in-flight requests.\n   */\n  size: () => number;\n\n  /**\n   * Clear all in-flight tracking (does not cancel operations).\n   */\n  clear: () => void;\n} {\n  const inflight = new Map<string, Promise<Result<T, E, C>>>();\n\n  return {\n    execute: async (\n      key: string,\n      operation: () => AsyncResult<T, E, C>\n    ): AsyncResult<T, E, C> => {\n      // Return existing in-flight promise if present\n      const existing = inflight.get(key);\n      if (existing) {\n        return existing;\n      }\n\n      // Start new request\n      // Use .finally() to ensure cleanup happens even if operation throws\n      const promise = operation()\n        .then((result) => result)\n        .finally(() => {\n          inflight.delete(key);\n        });\n\n      inflight.set(key, promise);\n      return promise;\n    },\n\n    isInflight: (key: string) => inflight.has(key),\n\n    size: () => inflight.size,\n\n    clear: () => inflight.clear(),\n  };\n}\n"],"mappings":"AAkHO,SAASA,EACdC,EACAC,EACyC,CAEzC,IAAMC,EAAW,IAAI,IAGfC,EAAQF,EAAQ,IAAM,IAAI,IAAqC,KAErE,MAAO,UAAUG,IAAqC,CACpD,IAAMC,EAAMJ,EAAQ,IAAI,GAAGG,CAAI,EAG/B,GAAID,EAAO,CACT,IAAMG,EAASH,EAAM,IAAIE,CAAG,EAC5B,GAAIC,GAAUA,EAAO,UAAY,KAAK,IAAI,EACxC,OAAOA,EAAO,OAGZA,GACFH,EAAM,OAAOE,CAAG,CAEpB,CAGA,IAAME,EAAWL,EAAS,IAAIG,CAAG,EACjC,GAAIE,EACF,OAAOA,EAKT,IAAMC,EAAUR,EAAU,GAAGI,CAAI,EAC9B,KAAMK,IAEDN,GAASF,EAAQ,KAAOQ,EAAO,IACjCN,EAAM,IAAIE,EAAK,CACb,OAAAI,EACA,UAAW,KAAK,IAAI,EAAIR,EAAQ,GAClC,CAAC,EAEIQ,EACR,EACA,QAAQ,IAAM,CAEbP,EAAS,OAAOG,CAAG,CACrB,CAAC,EAEH,OAAAH,EAAS,IAAIG,EAAKG,CAAO,EAClBA,CACT,CACF,CA2BO,SAASE,GAuBd,CACA,IAAMR,EAAW,IAAI,IAErB,MAAO,CACL,QAAS,MACPG,EACAL,IACyB,CAEzB,IAAMO,EAAWL,EAAS,IAAIG,CAAG,EACjC,GAAIE,EACF,OAAOA,EAKT,IAAMC,EAAUR,EAAU,EACvB,KAAMS,GAAWA,CAAM,EACvB,QAAQ,IAAM,CACbP,EAAS,OAAOG,CAAG,CACrB,CAAC,EAEH,OAAAH,EAAS,IAAIG,EAAKG,CAAO,EAClBA,CACT,EAEA,WAAaH,GAAgBH,EAAS,IAAIG,CAAG,EAE7C,KAAM,IAAMH,EAAS,KAErB,MAAO,IAAMA,EAAS,MAAM,CAC9B,CACF","names":["singleflight","operation","options","inflight","cache","args","key","cached","existing","promise","result","createSingleflightGroup"]}

package/dist/slugs.cjs

@@ -1,2 +0,0 @@
-"use strict";var n=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var c=(e,r)=>{for(var o in r)n(e,o,{get:r[o],enumerable:!0})},p=(e,r,o,a)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of u(r))!s.call(e,t)&&t!==o&&n(e,t,{get:()=>r[t],enumerable:!(a=l(r,t))||a.enumerable});return e};var m=e=>p(n({},"__esModule",{value:!0}),e);var d={};c(d,{ALL_SLUGS:()=>f,AWAITLY_SLUGS:()=>i,isAwaitlySlug:()=>g,slugCategory:()=>w,slugDocsUrl:()=>y});module.exports=m(d);var i={"step-require-id":"step-require-id","step-no-immediate-execution":"step-no-immediate-execution","step-require-thunk-for-key":"step-require-thunk-for-key","step-no-bare-await":"step-no-bare-await","step-no-try-catch-wrap":"step-no-try-catch-wrap","step-stable-cache-keys":"step-stable-cache-keys","workflow-no-floating":"workflow-no-floating","workflow-options-position":"workflow-options-position","workflow-callback-shape":"workflow-callback-shape","workflow-no-callable-form":"workflow-no-callable-form","workflow-no-dynamic-import":"workflow-no-dynamic-import","result-no-floating":"result-no-floating","result-require-handling":"result-require-handling","result-no-double-wrap":"result-no-double-wrap","result-no-manual-propagation":"result-no-manual-propagation","result-no-direct-ok-err":"result-no-direct-ok-err","error-check-unexpected-first":"error-check-unexpected-first","error-access-cause":"error-access-cause","error-normalize":"error-normalize","error-no-throw-in-deps":"error-no-throw-in-deps","concurrency-no-promise-all":"concurrency-no-promise-all","concurrency-no-promise-race":"concurrency-no-promise-race","concurrency-no-promise-allsettled":"concurrency-no-promise-allsettled","runtime-step-timeout":"runtime-step-timeout","runtime-step-aborted":"runtime-step-aborted","runtime-retry-exhausted":"runtime-retry-exhausted","runtime-rate-limit":"runtime-rate-limit","runtime-circuit-open":"runtime-circuit-open","runtime-unexpected":"runtime-unexpected","runtime-resolver-not-found":"runtime-resolver-not-found","runtime-saga-compensation":"runtime-saga-compensation"};function w(e){return e.split("-")[0]}function y(e){return`https://jagreehal.github.io/awaitly/rules/#${e}`}function g(e){return Object.prototype.hasOwnProperty.call(i,e)}var f=Object.keys(i);0&&(module.exports={ALL_SLUGS,AWAITLY_SLUGS,isAwaitlySlug,slugCategory,slugDocsUrl});
-//# sourceMappingURL=slugs.cjs.map

package/dist/slugs.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/slugs.ts"],"sourcesContent":["/**\n * awaitly/slugs\n *\n * Source-of-truth slug namespace. Every concept that surfaces as a runtime\n * error, lint rule, static-analyzer diagnostic, visualizer event, or skill rule\n * has exactly one canonical kebab-case slug here.\n *\n * Slugs are public API. Renames are a major version bump. Adds are non-breaking.\n *\n * Categories:\n * - step-*       step() discipline\n * - workflow-*   createWorkflow / run / runWithState shape\n * - result-*     Result usage\n * - error-*      Boundary handling\n * - concurrency-* step.all/map/race vs Promise.*\n * - runtime-*    Failures only observable at runtime\n */\n\nexport const AWAITLY_SLUGS = {\n  // --- step-* ---\n  \"step-require-id\": \"step-require-id\",\n  \"step-no-immediate-execution\": \"step-no-immediate-execution\",\n  \"step-require-thunk-for-key\": \"step-require-thunk-for-key\",\n  \"step-no-bare-await\": \"step-no-bare-await\",\n  \"step-no-try-catch-wrap\": \"step-no-try-catch-wrap\",\n  \"step-stable-cache-keys\": \"step-stable-cache-keys\",\n\n  // --- workflow-* ---\n  \"workflow-no-floating\": \"workflow-no-floating\",\n  \"workflow-options-position\": \"workflow-options-position\",\n  \"workflow-callback-shape\": \"workflow-callback-shape\",\n  \"workflow-no-callable-form\": \"workflow-no-callable-form\",\n  \"workflow-no-dynamic-import\": \"workflow-no-dynamic-import\",\n\n  // --- result-* ---\n  \"result-no-floating\": \"result-no-floating\",\n  \"result-require-handling\": \"result-require-handling\",\n  \"result-no-double-wrap\": \"result-no-double-wrap\",\n  \"result-no-manual-propagation\": \"result-no-manual-propagation\",\n  \"result-no-direct-ok-err\": \"result-no-direct-ok-err\",\n\n  // --- error-* ---\n  \"error-check-unexpected-first\": \"error-check-unexpected-first\",\n  \"error-access-cause\": \"error-access-cause\",\n  \"error-normalize\": \"error-normalize\",\n  \"error-no-throw-in-deps\": \"error-no-throw-in-deps\",\n\n  // --- concurrency-* ---\n  \"concurrency-no-promise-all\": \"concurrency-no-promise-all\",\n  \"concurrency-no-promise-race\": \"concurrency-no-promise-race\",\n  \"concurrency-no-promise-allsettled\": \"concurrency-no-promise-allsettled\",\n\n  // --- runtime-* ---\n  \"runtime-step-timeout\": \"runtime-step-timeout\",\n  \"runtime-step-aborted\": \"runtime-step-aborted\",\n  \"runtime-retry-exhausted\": \"runtime-retry-exhausted\",\n  \"runtime-rate-limit\": \"runtime-rate-limit\",\n  \"runtime-circuit-open\": \"runtime-circuit-open\",\n  \"runtime-unexpected\": \"runtime-unexpected\",\n  \"runtime-resolver-not-found\": \"runtime-resolver-not-found\",\n  \"runtime-saga-compensation\": \"runtime-saga-compensation\",\n} as const;\n\n/** All canonical awaitly slugs as a string-literal union. */\nexport type AwaitlySlug = keyof typeof AWAITLY_SLUGS;\n\n/** Categories derived from slug prefixes. */\nexport type AwaitlySlugCategory =\n  | \"step\"\n  | \"workflow\"\n  | \"result\"\n  | \"error\"\n  | \"concurrency\"\n  | \"runtime\";\n\n/** Returns the category (prefix) of a slug. */\nexport function slugCategory(slug: AwaitlySlug): AwaitlySlugCategory {\n  return slug.split(\"-\")[0] as AwaitlySlugCategory;\n}\n\n/**\n * Returns the canonical docs URL for a slug. Resolves to the matching\n * anchored section on the consolidated rule index page.\n */\nexport function slugDocsUrl(slug: AwaitlySlug): string {\n  return `https://jagreehal.github.io/awaitly/rules/#${slug}`;\n}\n\n/** Type guard: is a string a known awaitly slug? */\nexport function isAwaitlySlug(value: string): value is AwaitlySlug {\n  return Object.prototype.hasOwnProperty.call(AWAITLY_SLUGS, value);\n}\n\n/** All slugs as an array. */\n// Object.keys returns string[] — cast is safe because AWAITLY_SLUGS is `as const`\n// and the module's keys are never mutated.\nexport const ALL_SLUGS: readonly AwaitlySlug[] = Object.keys(\n  AWAITLY_SLUGS\n) as AwaitlySlug[];\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,eAAAE,EAAA,kBAAAC,EAAA,kBAAAC,EAAA,iBAAAC,EAAA,gBAAAC,IAAA,eAAAC,EAAAP,GAkBO,IAAMG,EAAgB,CAE3B,kBAAmB,kBACnB,8BAA+B,8BAC/B,6BAA8B,6BAC9B,qBAAsB,qBACtB,yBAA0B,yBAC1B,yBAA0B,yBAG1B,uBAAwB,uBACxB,4BAA6B,4BAC7B,0BAA2B,0BAC3B,4BAA6B,4BAC7B,6BAA8B,6BAG9B,qBAAsB,qBACtB,0BAA2B,0BAC3B,wBAAyB,wBACzB,+BAAgC,+BAChC,0BAA2B,0BAG3B,+BAAgC,+BAChC,qBAAsB,qBACtB,kBAAmB,kBACnB,yBAA0B,yBAG1B,6BAA8B,6BAC9B,8BAA+B,8BAC/B,oCAAqC,oCAGrC,uBAAwB,uBACxB,uBAAwB,uBACxB,0BAA2B,0BAC3B,qBAAsB,qBACtB,uBAAwB,uBACxB,qBAAsB,qBACtB,6BAA8B,6BAC9B,4BAA6B,2BAC/B,EAeO,SAASE,EAAaG,EAAwC,CACnE,OAAOA,EAAK,MAAM,GAAG,EAAE,CAAC,CAC1B,CAMO,SAASF,EAAYE,EAA2B,CACrD,MAAO,8CAA8CA,CAAI,EAC3D,CAGO,SAASJ,EAAcK,EAAqC,CACjE,OAAO,OAAO,UAAU,eAAe,KAAKN,EAAeM,CAAK,CAClE,CAKO,IAAMP,EAAoC,OAAO,KACtDC,CACF","names":["slugs_exports","__export","ALL_SLUGS","AWAITLY_SLUGS","isAwaitlySlug","slugCategory","slugDocsUrl","__toCommonJS","slug","value"]}

package/dist/slugs.d.cts

@@ -1,67 +0,0 @@
-/**
- * awaitly/slugs
- *
- * Source-of-truth slug namespace. Every concept that surfaces as a runtime
- * error, lint rule, static-analyzer diagnostic, visualizer event, or skill rule
- * has exactly one canonical kebab-case slug here.
- *
- * Slugs are public API. Renames are a major version bump. Adds are non-breaking.
- *
- * Categories:
- * - step-*       step() discipline
- * - workflow-*   createWorkflow / run / runWithState shape
- * - result-*     Result usage
- * - error-*      Boundary handling
- * - concurrency-* step.all/map/race vs Promise.*
- * - runtime-*    Failures only observable at runtime
- */
-declare const AWAITLY_SLUGS: {
-    readonly "step-require-id": "step-require-id";
-    readonly "step-no-immediate-execution": "step-no-immediate-execution";
-    readonly "step-require-thunk-for-key": "step-require-thunk-for-key";
-    readonly "step-no-bare-await": "step-no-bare-await";
-    readonly "step-no-try-catch-wrap": "step-no-try-catch-wrap";
-    readonly "step-stable-cache-keys": "step-stable-cache-keys";
-    readonly "workflow-no-floating": "workflow-no-floating";
-    readonly "workflow-options-position": "workflow-options-position";
-    readonly "workflow-callback-shape": "workflow-callback-shape";
-    readonly "workflow-no-callable-form": "workflow-no-callable-form";
-    readonly "workflow-no-dynamic-import": "workflow-no-dynamic-import";
-    readonly "result-no-floating": "result-no-floating";
-    readonly "result-require-handling": "result-require-handling";
-    readonly "result-no-double-wrap": "result-no-double-wrap";
-    readonly "result-no-manual-propagation": "result-no-manual-propagation";
-    readonly "result-no-direct-ok-err": "result-no-direct-ok-err";
-    readonly "error-check-unexpected-first": "error-check-unexpected-first";
-    readonly "error-access-cause": "error-access-cause";
-    readonly "error-normalize": "error-normalize";
-    readonly "error-no-throw-in-deps": "error-no-throw-in-deps";
-    readonly "concurrency-no-promise-all": "concurrency-no-promise-all";
-    readonly "concurrency-no-promise-race": "concurrency-no-promise-race";
-    readonly "concurrency-no-promise-allsettled": "concurrency-no-promise-allsettled";
-    readonly "runtime-step-timeout": "runtime-step-timeout";
-    readonly "runtime-step-aborted": "runtime-step-aborted";
-    readonly "runtime-retry-exhausted": "runtime-retry-exhausted";
-    readonly "runtime-rate-limit": "runtime-rate-limit";
-    readonly "runtime-circuit-open": "runtime-circuit-open";
-    readonly "runtime-unexpected": "runtime-unexpected";
-    readonly "runtime-resolver-not-found": "runtime-resolver-not-found";
-    readonly "runtime-saga-compensation": "runtime-saga-compensation";
-};
-/** All canonical awaitly slugs as a string-literal union. */
-type AwaitlySlug = keyof typeof AWAITLY_SLUGS;
-/** Categories derived from slug prefixes. */
-type AwaitlySlugCategory = "step" | "workflow" | "result" | "error" | "concurrency" | "runtime";
-/** Returns the category (prefix) of a slug. */
-declare function slugCategory(slug: AwaitlySlug): AwaitlySlugCategory;
-/**
- * Returns the canonical docs URL for a slug. Resolves to the matching
- * anchored section on the consolidated rule index page.
- */
-declare function slugDocsUrl(slug: AwaitlySlug): string;
-/** Type guard: is a string a known awaitly slug? */
-declare function isAwaitlySlug(value: string): value is AwaitlySlug;
-/** All slugs as an array. */
-declare const ALL_SLUGS: readonly AwaitlySlug[];
-
-export { ALL_SLUGS, AWAITLY_SLUGS, type AwaitlySlug, type AwaitlySlugCategory, isAwaitlySlug, slugCategory, slugDocsUrl };

package/dist/slugs.d.ts

@@ -1,67 +0,0 @@
-/**
- * awaitly/slugs
- *
- * Source-of-truth slug namespace. Every concept that surfaces as a runtime
- * error, lint rule, static-analyzer diagnostic, visualizer event, or skill rule
- * has exactly one canonical kebab-case slug here.
- *
- * Slugs are public API. Renames are a major version bump. Adds are non-breaking.
- *
- * Categories:
- * - step-*       step() discipline
- * - workflow-*   createWorkflow / run / runWithState shape
- * - result-*     Result usage
- * - error-*      Boundary handling
- * - concurrency-* step.all/map/race vs Promise.*
- * - runtime-*    Failures only observable at runtime
- */
-declare const AWAITLY_SLUGS: {
-    readonly "step-require-id": "step-require-id";
-    readonly "step-no-immediate-execution": "step-no-immediate-execution";
-    readonly "step-require-thunk-for-key": "step-require-thunk-for-key";
-    readonly "step-no-bare-await": "step-no-bare-await";
-    readonly "step-no-try-catch-wrap": "step-no-try-catch-wrap";
-    readonly "step-stable-cache-keys": "step-stable-cache-keys";
-    readonly "workflow-no-floating": "workflow-no-floating";
-    readonly "workflow-options-position": "workflow-options-position";
-    readonly "workflow-callback-shape": "workflow-callback-shape";
-    readonly "workflow-no-callable-form": "workflow-no-callable-form";
-    readonly "workflow-no-dynamic-import": "workflow-no-dynamic-import";
-    readonly "result-no-floating": "result-no-floating";
-    readonly "result-require-handling": "result-require-handling";
-    readonly "result-no-double-wrap": "result-no-double-wrap";
-    readonly "result-no-manual-propagation": "result-no-manual-propagation";
-    readonly "result-no-direct-ok-err": "result-no-direct-ok-err";
-    readonly "error-check-unexpected-first": "error-check-unexpected-first";
-    readonly "error-access-cause": "error-access-cause";
-    readonly "error-normalize": "error-normalize";
-    readonly "error-no-throw-in-deps": "error-no-throw-in-deps";
-    readonly "concurrency-no-promise-all": "concurrency-no-promise-all";
-    readonly "concurrency-no-promise-race": "concurrency-no-promise-race";
-    readonly "concurrency-no-promise-allsettled": "concurrency-no-promise-allsettled";
-    readonly "runtime-step-timeout": "runtime-step-timeout";
-    readonly "runtime-step-aborted": "runtime-step-aborted";
-    readonly "runtime-retry-exhausted": "runtime-retry-exhausted";
-    readonly "runtime-rate-limit": "runtime-rate-limit";
-    readonly "runtime-circuit-open": "runtime-circuit-open";
-    readonly "runtime-unexpected": "runtime-unexpected";
-    readonly "runtime-resolver-not-found": "runtime-resolver-not-found";
-    readonly "runtime-saga-compensation": "runtime-saga-compensation";
-};
-/** All canonical awaitly slugs as a string-literal union. */
-type AwaitlySlug = keyof typeof AWAITLY_SLUGS;
-/** Categories derived from slug prefixes. */
-type AwaitlySlugCategory = "step" | "workflow" | "result" | "error" | "concurrency" | "runtime";
-/** Returns the category (prefix) of a slug. */
-declare function slugCategory(slug: AwaitlySlug): AwaitlySlugCategory;
-/**
- * Returns the canonical docs URL for a slug. Resolves to the matching
- * anchored section on the consolidated rule index page.
- */
-declare function slugDocsUrl(slug: AwaitlySlug): string;
-/** Type guard: is a string a known awaitly slug? */
-declare function isAwaitlySlug(value: string): value is AwaitlySlug;
-/** All slugs as an array. */
-declare const ALL_SLUGS: readonly AwaitlySlug[];
-
-export { ALL_SLUGS, AWAITLY_SLUGS, type AwaitlySlug, type AwaitlySlugCategory, isAwaitlySlug, slugCategory, slugDocsUrl };

package/dist/slugs.js

@@ -1,2 +0,0 @@
-var r={"step-require-id":"step-require-id","step-no-immediate-execution":"step-no-immediate-execution","step-require-thunk-for-key":"step-require-thunk-for-key","step-no-bare-await":"step-no-bare-await","step-no-try-catch-wrap":"step-no-try-catch-wrap","step-stable-cache-keys":"step-stable-cache-keys","workflow-no-floating":"workflow-no-floating","workflow-options-position":"workflow-options-position","workflow-callback-shape":"workflow-callback-shape","workflow-no-callable-form":"workflow-no-callable-form","workflow-no-dynamic-import":"workflow-no-dynamic-import","result-no-floating":"result-no-floating","result-require-handling":"result-require-handling","result-no-double-wrap":"result-no-double-wrap","result-no-manual-propagation":"result-no-manual-propagation","result-no-direct-ok-err":"result-no-direct-ok-err","error-check-unexpected-first":"error-check-unexpected-first","error-access-cause":"error-access-cause","error-normalize":"error-normalize","error-no-throw-in-deps":"error-no-throw-in-deps","concurrency-no-promise-all":"concurrency-no-promise-all","concurrency-no-promise-race":"concurrency-no-promise-race","concurrency-no-promise-allsettled":"concurrency-no-promise-allsettled","runtime-step-timeout":"runtime-step-timeout","runtime-step-aborted":"runtime-step-aborted","runtime-retry-exhausted":"runtime-retry-exhausted","runtime-rate-limit":"runtime-rate-limit","runtime-circuit-open":"runtime-circuit-open","runtime-unexpected":"runtime-unexpected","runtime-resolver-not-found":"runtime-resolver-not-found","runtime-saga-compensation":"runtime-saga-compensation"};function t(e){return e.split("-")[0]}function o(e){return`https://jagreehal.github.io/awaitly/rules/#${e}`}function n(e){return Object.prototype.hasOwnProperty.call(r,e)}var i=Object.keys(r);export{i as ALL_SLUGS,r as AWAITLY_SLUGS,n as isAwaitlySlug,t as slugCategory,o as slugDocsUrl};
-//# sourceMappingURL=slugs.js.map

package/dist/slugs.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/slugs.ts"],"sourcesContent":["/**\n * awaitly/slugs\n *\n * Source-of-truth slug namespace. Every concept that surfaces as a runtime\n * error, lint rule, static-analyzer diagnostic, visualizer event, or skill rule\n * has exactly one canonical kebab-case slug here.\n *\n * Slugs are public API. Renames are a major version bump. Adds are non-breaking.\n *\n * Categories:\n * - step-*       step() discipline\n * - workflow-*   createWorkflow / run / runWithState shape\n * - result-*     Result usage\n * - error-*      Boundary handling\n * - concurrency-* step.all/map/race vs Promise.*\n * - runtime-*    Failures only observable at runtime\n */\n\nexport const AWAITLY_SLUGS = {\n  // --- step-* ---\n  \"step-require-id\": \"step-require-id\",\n  \"step-no-immediate-execution\": \"step-no-immediate-execution\",\n  \"step-require-thunk-for-key\": \"step-require-thunk-for-key\",\n  \"step-no-bare-await\": \"step-no-bare-await\",\n  \"step-no-try-catch-wrap\": \"step-no-try-catch-wrap\",\n  \"step-stable-cache-keys\": \"step-stable-cache-keys\",\n\n  // --- workflow-* ---\n  \"workflow-no-floating\": \"workflow-no-floating\",\n  \"workflow-options-position\": \"workflow-options-position\",\n  \"workflow-callback-shape\": \"workflow-callback-shape\",\n  \"workflow-no-callable-form\": \"workflow-no-callable-form\",\n  \"workflow-no-dynamic-import\": \"workflow-no-dynamic-import\",\n\n  // --- result-* ---\n  \"result-no-floating\": \"result-no-floating\",\n  \"result-require-handling\": \"result-require-handling\",\n  \"result-no-double-wrap\": \"result-no-double-wrap\",\n  \"result-no-manual-propagation\": \"result-no-manual-propagation\",\n  \"result-no-direct-ok-err\": \"result-no-direct-ok-err\",\n\n  // --- error-* ---\n  \"error-check-unexpected-first\": \"error-check-unexpected-first\",\n  \"error-access-cause\": \"error-access-cause\",\n  \"error-normalize\": \"error-normalize\",\n  \"error-no-throw-in-deps\": \"error-no-throw-in-deps\",\n\n  // --- concurrency-* ---\n  \"concurrency-no-promise-all\": \"concurrency-no-promise-all\",\n  \"concurrency-no-promise-race\": \"concurrency-no-promise-race\",\n  \"concurrency-no-promise-allsettled\": \"concurrency-no-promise-allsettled\",\n\n  // --- runtime-* ---\n  \"runtime-step-timeout\": \"runtime-step-timeout\",\n  \"runtime-step-aborted\": \"runtime-step-aborted\",\n  \"runtime-retry-exhausted\": \"runtime-retry-exhausted\",\n  \"runtime-rate-limit\": \"runtime-rate-limit\",\n  \"runtime-circuit-open\": \"runtime-circuit-open\",\n  \"runtime-unexpected\": \"runtime-unexpected\",\n  \"runtime-resolver-not-found\": \"runtime-resolver-not-found\",\n  \"runtime-saga-compensation\": \"runtime-saga-compensation\",\n} as const;\n\n/** All canonical awaitly slugs as a string-literal union. */\nexport type AwaitlySlug = keyof typeof AWAITLY_SLUGS;\n\n/** Categories derived from slug prefixes. */\nexport type AwaitlySlugCategory =\n  | \"step\"\n  | \"workflow\"\n  | \"result\"\n  | \"error\"\n  | \"concurrency\"\n  | \"runtime\";\n\n/** Returns the category (prefix) of a slug. */\nexport function slugCategory(slug: AwaitlySlug): AwaitlySlugCategory {\n  return slug.split(\"-\")[0] as AwaitlySlugCategory;\n}\n\n/**\n * Returns the canonical docs URL for a slug. Resolves to the matching\n * anchored section on the consolidated rule index page.\n */\nexport function slugDocsUrl(slug: AwaitlySlug): string {\n  return `https://jagreehal.github.io/awaitly/rules/#${slug}`;\n}\n\n/** Type guard: is a string a known awaitly slug? */\nexport function isAwaitlySlug(value: string): value is AwaitlySlug {\n  return Object.prototype.hasOwnProperty.call(AWAITLY_SLUGS, value);\n}\n\n/** All slugs as an array. */\n// Object.keys returns string[] — cast is safe because AWAITLY_SLUGS is `as const`\n// and the module's keys are never mutated.\nexport const ALL_SLUGS: readonly AwaitlySlug[] = Object.keys(\n  AWAITLY_SLUGS\n) as AwaitlySlug[];\n"],"mappings":"AAkBO,IAAMA,EAAgB,CAE3B,kBAAmB,kBACnB,8BAA+B,8BAC/B,6BAA8B,6BAC9B,qBAAsB,qBACtB,yBAA0B,yBAC1B,yBAA0B,yBAG1B,uBAAwB,uBACxB,4BAA6B,4BAC7B,0BAA2B,0BAC3B,4BAA6B,4BAC7B,6BAA8B,6BAG9B,qBAAsB,qBACtB,0BAA2B,0BAC3B,wBAAyB,wBACzB,+BAAgC,+BAChC,0BAA2B,0BAG3B,+BAAgC,+BAChC,qBAAsB,qBACtB,kBAAmB,kBACnB,yBAA0B,yBAG1B,6BAA8B,6BAC9B,8BAA+B,8BAC/B,oCAAqC,oCAGrC,uBAAwB,uBACxB,uBAAwB,uBACxB,0BAA2B,0BAC3B,qBAAsB,qBACtB,uBAAwB,uBACxB,qBAAsB,qBACtB,6BAA8B,6BAC9B,4BAA6B,2BAC/B,EAeO,SAASC,EAAaC,EAAwC,CACnE,OAAOA,EAAK,MAAM,GAAG,EAAE,CAAC,CAC1B,CAMO,SAASC,EAAYD,EAA2B,CACrD,MAAO,8CAA8CA,CAAI,EAC3D,CAGO,SAASE,EAAcC,EAAqC,CACjE,OAAO,OAAO,UAAU,eAAe,KAAKL,EAAeK,CAAK,CAClE,CAKO,IAAMC,EAAoC,OAAO,KACtDN,CACF","names":["AWAITLY_SLUGS","slugCategory","slug","slugDocsUrl","isAwaitlySlug","value","ALL_SLUGS"]}