flowx-control 1.0.0

package/dist/fallback.js

@@ -0,0 +1,43 @@
+'use strict';
+
+// src/fallback.ts
+async function withFallback(fn, fallback, options) {
+  try {
+    return await fn();
+  } catch (error) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    if (options?.shouldFallback && !options.shouldFallback(err)) {
+      throw err;
+    }
+    options?.onFallback?.(err, 0);
+    if (typeof fallback === "function") {
+      return await fallback();
+    }
+    return fallback;
+  }
+}
+async function fallbackChain(fns, options) {
+  if (fns.length === 0) {
+    throw new Error("fallbackChain requires at least one function");
+  }
+  let lastError;
+  for (let i = 0; i < fns.length; i++) {
+    try {
+      return await fns[i]();
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+      if (options?.shouldFallback && !options.shouldFallback(lastError)) {
+        throw lastError;
+      }
+      if (i < fns.length - 1) {
+        options?.onFallback?.(lastError, i + 1);
+      }
+    }
+  }
+  throw lastError;
+}
+
+exports.fallbackChain = fallbackChain;
+exports.withFallback = withFallback;
+//# sourceMappingURL=fallback.js.map
+//# sourceMappingURL=fallback.js.map

package/dist/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fallback.ts"],"names":[],"mappings":";;;AAsBA,eAAsB,YAAA,CACpB,EAAA,EACA,QAAA,EACA,OAAA,EACY;AACZ,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,EAAA,EAAG;AAAA,EAClB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,GAAA,GAAM,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AAEpE,IAAA,IAAI,SAAS,cAAA,IAAkB,CAAC,OAAA,CAAQ,cAAA,CAAe,GAAG,CAAA,EAAG;AAC3D,MAAA,MAAM,GAAA;AAAA,IACR;AAEA,IAAA,OAAA,EAAS,UAAA,GAAa,KAAK,CAAC,CAAA;AAE5B,IAAA,IAAI,OAAO,aAAa,UAAA,EAAY;AAClC,MAAA,OAAO,MAAO,QAAA,EAAkC;AAAA,IAClD;AACA,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AAcA,eAAsB,aAAA,CACpB,KACA,OAAA,EACY;AACZ,EAAA,IAAI,GAAA,CAAI,WAAW,CAAA,EAAG;AACpB,IAAA,MAAM,IAAI,MAAM,8CAA8C,CAAA;AAAA,EAChE;AAEA,EAAA,IAAI,SAAA;AAEJ,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACnC,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,GAAA,CAAI,CAAC,CAAA,EAAE;AAAA,IACtB,SAAS,KAAA,EAAO;AACd,MAAA,SAAA,GAAY,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AAEpE,MAAA,IAAI,SAAS,cAAA,IAAkB,CAAC,OAAA,CAAQ,cAAA,CAAe,SAAS,CAAA,EAAG;AACjE,QAAA,MAAM,SAAA;AAAA,MACR;AAEA,MAAA,IAAI,CAAA,GAAI,GAAA,CAAI,MAAA,GAAS,CAAA,EAAG;AACtB,QAAA,OAAA,EAAS,UAAA,GAAa,SAAA,EAAW,CAAA,GAAI,CAAC,CAAA;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AAEA,EAAA,MAAM,SAAA;AACR","file":"fallback.js","sourcesContent":["// ============================================================================\n// FlowX — Fallback Chain\n// ============================================================================\n\nexport interface FallbackOptions {\n  /** Predicate to determine if the error warrants a fallback */\n  shouldFallback?: (error: Error) => boolean;\n  /** Callback fired when the primary function fails and fallback is used */\n  onFallback?: (error: Error, fallbackIndex: number) => void;\n}\n\n/**\n * Execute a function with a fallback value or function if it fails.\n *\n * @example\n * ```ts\n * const data = await withFallback(\n *   () => fetch('/primary-api'),\n *   'default-value',\n * );\n * ```\n */\nexport async function withFallback<T>(\n  fn: () => T | Promise<T>,\n  fallback: T | (() => T | Promise<T>),\n  options?: FallbackOptions,\n): Promise<T> {\n  try {\n    return await fn();\n  } catch (error) {\n    const err = error instanceof Error ? error : new Error(String(error));\n\n    if (options?.shouldFallback && !options.shouldFallback(err)) {\n      throw err;\n    }\n\n    options?.onFallback?.(err, 0);\n\n    if (typeof fallback === 'function') {\n      return await (fallback as () => T | Promise<T>)();\n    }\n    return fallback;\n  }\n}\n\n/**\n * Execute the first successful function from a chain of fallbacks.\n *\n * @example\n * ```ts\n * const data = await fallbackChain([\n *   () => fetch('/primary'),\n *   () => fetch('/secondary'),\n *   () => fetch('/tertiary'),\n * ]);\n * ```\n */\nexport async function fallbackChain<T>(\n  fns: Array<() => T | Promise<T>>,\n  options?: FallbackOptions,\n): Promise<T> {\n  if (fns.length === 0) {\n    throw new Error('fallbackChain requires at least one function');\n  }\n\n  let lastError: Error | undefined;\n\n  for (let i = 0; i < fns.length; i++) {\n    try {\n      return await fns[i]();\n    } catch (error) {\n      lastError = error instanceof Error ? error : new Error(String(error));\n\n      if (options?.shouldFallback && !options.shouldFallback(lastError)) {\n        throw lastError;\n      }\n\n      if (i < fns.length - 1) {\n        options?.onFallback?.(lastError, i + 1);\n      }\n    }\n  }\n\n  throw lastError!;\n}\n"]}

package/dist/fallback.mjs

@@ -0,0 +1,40 @@
+// src/fallback.ts
+async function withFallback(fn, fallback, options) {
+  try {
+    return await fn();
+  } catch (error) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    if (options?.shouldFallback && !options.shouldFallback(err)) {
+      throw err;
+    }
+    options?.onFallback?.(err, 0);
+    if (typeof fallback === "function") {
+      return await fallback();
+    }
+    return fallback;
+  }
+}
+async function fallbackChain(fns, options) {
+  if (fns.length === 0) {
+    throw new Error("fallbackChain requires at least one function");
+  }
+  let lastError;
+  for (let i = 0; i < fns.length; i++) {
+    try {
+      return await fns[i]();
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+      if (options?.shouldFallback && !options.shouldFallback(lastError)) {
+        throw lastError;
+      }
+      if (i < fns.length - 1) {
+        options?.onFallback?.(lastError, i + 1);
+      }
+    }
+  }
+  throw lastError;
+}
+
+export { fallbackChain, withFallback };
+//# sourceMappingURL=fallback.mjs.map
+//# sourceMappingURL=fallback.mjs.map

package/dist/fallback.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fallback.ts"],"names":[],"mappings":";AAsBA,eAAsB,YAAA,CACpB,EAAA,EACA,QAAA,EACA,OAAA,EACY;AACZ,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,EAAA,EAAG;AAAA,EAClB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,GAAA,GAAM,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AAEpE,IAAA,IAAI,SAAS,cAAA,IAAkB,CAAC,OAAA,CAAQ,cAAA,CAAe,GAAG,CAAA,EAAG;AAC3D,MAAA,MAAM,GAAA;AAAA,IACR;AAEA,IAAA,OAAA,EAAS,UAAA,GAAa,KAAK,CAAC,CAAA;AAE5B,IAAA,IAAI,OAAO,aAAa,UAAA,EAAY;AAClC,MAAA,OAAO,MAAO,QAAA,EAAkC;AAAA,IAClD;AACA,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AAcA,eAAsB,aAAA,CACpB,KACA,OAAA,EACY;AACZ,EAAA,IAAI,GAAA,CAAI,WAAW,CAAA,EAAG;AACpB,IAAA,MAAM,IAAI,MAAM,8CAA8C,CAAA;AAAA,EAChE;AAEA,EAAA,IAAI,SAAA;AAEJ,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACnC,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,GAAA,CAAI,CAAC,CAAA,EAAE;AAAA,IACtB,SAAS,KAAA,EAAO;AACd,MAAA,SAAA,GAAY,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AAEpE,MAAA,IAAI,SAAS,cAAA,IAAkB,CAAC,OAAA,CAAQ,cAAA,CAAe,SAAS,CAAA,EAAG;AACjE,QAAA,MAAM,SAAA;AAAA,MACR;AAEA,MAAA,IAAI,CAAA,GAAI,GAAA,CAAI,MAAA,GAAS,CAAA,EAAG;AACtB,QAAA,OAAA,EAAS,UAAA,GAAa,SAAA,EAAW,CAAA,GAAI,CAAC,CAAA;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AAEA,EAAA,MAAM,SAAA;AACR","file":"fallback.mjs","sourcesContent":["// ============================================================================\n// FlowX — Fallback Chain\n// ============================================================================\n\nexport interface FallbackOptions {\n  /** Predicate to determine if the error warrants a fallback */\n  shouldFallback?: (error: Error) => boolean;\n  /** Callback fired when the primary function fails and fallback is used */\n  onFallback?: (error: Error, fallbackIndex: number) => void;\n}\n\n/**\n * Execute a function with a fallback value or function if it fails.\n *\n * @example\n * ```ts\n * const data = await withFallback(\n *   () => fetch('/primary-api'),\n *   'default-value',\n * );\n * ```\n */\nexport async function withFallback<T>(\n  fn: () => T | Promise<T>,\n  fallback: T | (() => T | Promise<T>),\n  options?: FallbackOptions,\n): Promise<T> {\n  try {\n    return await fn();\n  } catch (error) {\n    const err = error instanceof Error ? error : new Error(String(error));\n\n    if (options?.shouldFallback && !options.shouldFallback(err)) {\n      throw err;\n    }\n\n    options?.onFallback?.(err, 0);\n\n    if (typeof fallback === 'function') {\n      return await (fallback as () => T | Promise<T>)();\n    }\n    return fallback;\n  }\n}\n\n/**\n * Execute the first successful function from a chain of fallbacks.\n *\n * @example\n * ```ts\n * const data = await fallbackChain([\n *   () => fetch('/primary'),\n *   () => fetch('/secondary'),\n *   () => fetch('/tertiary'),\n * ]);\n * ```\n */\nexport async function fallbackChain<T>(\n  fns: Array<() => T | Promise<T>>,\n  options?: FallbackOptions,\n): Promise<T> {\n  if (fns.length === 0) {\n    throw new Error('fallbackChain requires at least one function');\n  }\n\n  let lastError: Error | undefined;\n\n  for (let i = 0; i < fns.length; i++) {\n    try {\n      return await fns[i]();\n    } catch (error) {\n      lastError = error instanceof Error ? error : new Error(String(error));\n\n      if (options?.shouldFallback && !options.shouldFallback(lastError)) {\n        throw lastError;\n      }\n\n      if (i < fns.length - 1) {\n        options?.onFallback?.(lastError, i + 1);\n      }\n    }\n  }\n\n  throw lastError!;\n}\n"]}

package/dist/hedge.d.mts

@@ -0,0 +1,18 @@
+interface HedgeOptions {
+    /** Delay in ms before launching the hedge request (default: 500) */
+    delay?: number;
+    /** Maximum number of parallel hedged calls (default: 1) */
+    maxHedges?: number;
+}
+/**
+ * Execute a function with hedged requests — if the primary doesn't respond
+ * quickly enough, fire parallel redundant calls and return whichever resolves first.
+ *
+ * @example
+ * ```ts
+ * const data = await hedge(() => fetch('/api'), { delay: 200 });
+ * ```
+ */
+declare function hedge<T>(fn: () => Promise<T>, options?: HedgeOptions): Promise<T>;
+
+export { type HedgeOptions, hedge };

package/dist/hedge.d.ts

@@ -0,0 +1,18 @@
+interface HedgeOptions {
+    /** Delay in ms before launching the hedge request (default: 500) */
+    delay?: number;
+    /** Maximum number of parallel hedged calls (default: 1) */
+    maxHedges?: number;
+}
+/**
+ * Execute a function with hedged requests — if the primary doesn't respond
+ * quickly enough, fire parallel redundant calls and return whichever resolves first.
+ *
+ * @example
+ * ```ts
+ * const data = await hedge(() => fetch('/api'), { delay: 200 });
+ * ```
+ */
+declare function hedge<T>(fn: () => Promise<T>, options?: HedgeOptions): Promise<T>;
+
+export { type HedgeOptions, hedge };

package/dist/hedge.js

@@ -0,0 +1,47 @@
+'use strict';
+
+// src/hedge.ts
+function hedge(fn, options) {
+  const { delay = 500, maxHedges = 1 } = options ?? {};
+  if (delay < 0) throw new RangeError("delay must be >= 0");
+  if (maxHedges < 1) throw new RangeError("maxHedges must be >= 1");
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    let completedCount = 0;
+    const totalAttempts = 1 + maxHedges;
+    const errors = [];
+    const timers = [];
+    function onResult(value) {
+      if (settled) return;
+      settled = true;
+      for (const t of timers) clearTimeout(t);
+      resolve(value);
+    }
+    function onError(error) {
+      errors.push(error);
+      completedCount++;
+      if (completedCount >= totalAttempts && !settled) {
+        settled = true;
+        reject(errors[0]);
+      }
+    }
+    fn().then(onResult, (err) => onError(err instanceof Error ? err : new Error(String(err))));
+    for (let i = 0; i < maxHedges; i++) {
+      const timer = setTimeout(
+        () => {
+          if (settled) return;
+          fn().then(
+            onResult,
+            (err) => onError(err instanceof Error ? err : new Error(String(err)))
+          );
+        },
+        delay * (i + 1)
+      );
+      timers.push(timer);
+    }
+  });
+}
+
+exports.hedge = hedge;
+//# sourceMappingURL=hedge.js.map
+//# sourceMappingURL=hedge.js.map

package/dist/hedge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hedge.ts"],"names":[],"mappings":";;;AAoBO,SAAS,KAAA,CAAS,IAAsB,OAAA,EAAoC;AACjF,EAAA,MAAM,EAAE,KAAA,GAAQ,GAAA,EAAK,YAAY,CAAA,EAAE,GAAI,WAAW,EAAC;AAEnD,EAAA,IAAI,KAAA,GAAQ,CAAA,EAAG,MAAM,IAAI,WAAW,oBAAoB,CAAA;AACxD,EAAA,IAAI,SAAA,GAAY,CAAA,EAAG,MAAM,IAAI,WAAW,wBAAwB,CAAA;AAEhE,EAAA,OAAO,IAAI,OAAA,CAAW,CAAC,OAAA,EAAS,MAAA,KAAW;AACzC,IAAA,IAAI,OAAA,GAAU,KAAA;AACd,IAAA,IAAI,cAAA,GAAiB,CAAA;AACrB,IAAA,MAAM,gBAAgB,CAAA,GAAI,SAAA;AAC1B,IAAA,MAAM,SAAkB,EAAC;AACzB,IAAA,MAAM,SAA0C,EAAC;AAEjD,IAAA,SAAS,SAAS,KAAA,EAAgB;AAChC,MAAA,IAAI,OAAA,EAAS;AACb,MAAA,OAAA,GAAU,IAAA;AAEV,MAAA,KAAA,MAAW,CAAA,IAAK,MAAA,EAAQ,YAAA,CAAa,CAAC,CAAA;AACtC,MAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,IACf;AAEA,IAAA,SAAS,QAAQ,KAAA,EAAoB;AACnC,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AACjB,MAAA,cAAA,EAAA;AACA,MAAA,IAAI,cAAA,IAAkB,aAAA,IAAiB,CAAC,OAAA,EAAS;AAC/C,QAAA,OAAA,GAAU,IAAA;AACV,QAAA,MAAA,CAAO,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,MAClB;AAAA,IACF;AAGA,IAAA,EAAA,EAAG,CAAE,IAAA,CAAK,QAAA,EAAU,CAAC,QAAQ,OAAA,CAAQ,GAAA,YAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAC,CAAA;AAGzF,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,SAAA,EAAW,CAAA,EAAA,EAAK;AAClC,MAAA,MAAM,KAAA,GAAQ,UAAA;AAAA,QACZ,MAAM;AAEJ,UAAA,IAAI,OAAA,EAAS;AACb,UAAA,EAAA,EAAG,CAAE,IAAA;AAAA,YAAK,QAAA;AAAA,YAAU,CAAC,GAAA,KACnB,OAAA,CAAQ,GAAA,YAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAC;AAAA,WAC7D;AAAA,QACF,CAAA;AAAA,QACA,SAAS,CAAA,GAAI,CAAA;AAAA,OACf;AACA,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,IACnB;AAAA,EACF,CAAC,CAAA;AACH","file":"hedge.js","sourcesContent":["// ============================================================================\n// FlowX — Hedged Requests\n// ============================================================================\n\nexport interface HedgeOptions {\n  /** Delay in ms before launching the hedge request (default: 500) */\n  delay?: number;\n  /** Maximum number of parallel hedged calls (default: 1) */\n  maxHedges?: number;\n}\n\n/**\n * Execute a function with hedged requests — if the primary doesn't respond\n * quickly enough, fire parallel redundant calls and return whichever resolves first.\n *\n * @example\n * ```ts\n * const data = await hedge(() => fetch('/api'), { delay: 200 });\n * ```\n */\nexport function hedge<T>(fn: () => Promise<T>, options?: HedgeOptions): Promise<T> {\n  const { delay = 500, maxHedges = 1 } = options ?? {};\n\n  if (delay < 0) throw new RangeError('delay must be >= 0');\n  if (maxHedges < 1) throw new RangeError('maxHedges must be >= 1');\n\n  return new Promise<T>((resolve, reject) => {\n    let settled = false;\n    let completedCount = 0;\n    const totalAttempts = 1 + maxHedges;\n    const errors: Error[] = [];\n    const timers: ReturnType<typeof setTimeout>[] = [];\n\n    function onResult(value: T): void {\n      if (settled) return;\n      settled = true;\n      // Clear pending hedge timers\n      for (const t of timers) clearTimeout(t);\n      resolve(value);\n    }\n\n    function onError(error: Error): void {\n      errors.push(error);\n      completedCount++;\n      if (completedCount >= totalAttempts && !settled) {\n        settled = true;\n        reject(errors[0]);\n      }\n    }\n\n    // Launch primary request immediately\n    fn().then(onResult, (err) => onError(err instanceof Error ? err : new Error(String(err))));\n\n    // Launch hedged requests after delay\n    for (let i = 0; i < maxHedges; i++) {\n      const timer = setTimeout(\n        () => {\n          /* istanbul ignore if -- timer is always cleared by onResult before firing */\n          if (settled) return;\n          fn().then(onResult, (err) =>\n            onError(err instanceof Error ? err : new Error(String(err))),\n          );\n        },\n        delay * (i + 1),\n      );\n      timers.push(timer);\n    }\n  });\n}\n"]}

package/dist/hedge.mjs

@@ -0,0 +1,45 @@
+// src/hedge.ts
+function hedge(fn, options) {
+  const { delay = 500, maxHedges = 1 } = options ?? {};
+  if (delay < 0) throw new RangeError("delay must be >= 0");
+  if (maxHedges < 1) throw new RangeError("maxHedges must be >= 1");
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    let completedCount = 0;
+    const totalAttempts = 1 + maxHedges;
+    const errors = [];
+    const timers = [];
+    function onResult(value) {
+      if (settled) return;
+      settled = true;
+      for (const t of timers) clearTimeout(t);
+      resolve(value);
+    }
+    function onError(error) {
+      errors.push(error);
+      completedCount++;
+      if (completedCount >= totalAttempts && !settled) {
+        settled = true;
+        reject(errors[0]);
+      }
+    }
+    fn().then(onResult, (err) => onError(err instanceof Error ? err : new Error(String(err))));
+    for (let i = 0; i < maxHedges; i++) {
+      const timer = setTimeout(
+        () => {
+          if (settled) return;
+          fn().then(
+            onResult,
+            (err) => onError(err instanceof Error ? err : new Error(String(err)))
+          );
+        },
+        delay * (i + 1)
+      );
+      timers.push(timer);
+    }
+  });
+}
+
+export { hedge };
+//# sourceMappingURL=hedge.mjs.map
+//# sourceMappingURL=hedge.mjs.map

package/dist/hedge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hedge.ts"],"names":[],"mappings":";AAoBO,SAAS,KAAA,CAAS,IAAsB,OAAA,EAAoC;AACjF,EAAA,MAAM,EAAE,KAAA,GAAQ,GAAA,EAAK,YAAY,CAAA,EAAE,GAAI,WAAW,EAAC;AAEnD,EAAA,IAAI,KAAA,GAAQ,CAAA,EAAG,MAAM,IAAI,WAAW,oBAAoB,CAAA;AACxD,EAAA,IAAI,SAAA,GAAY,CAAA,EAAG,MAAM,IAAI,WAAW,wBAAwB,CAAA;AAEhE,EAAA,OAAO,IAAI,OAAA,CAAW,CAAC,OAAA,EAAS,MAAA,KAAW;AACzC,IAAA,IAAI,OAAA,GAAU,KAAA;AACd,IAAA,IAAI,cAAA,GAAiB,CAAA;AACrB,IAAA,MAAM,gBAAgB,CAAA,GAAI,SAAA;AAC1B,IAAA,MAAM,SAAkB,EAAC;AACzB,IAAA,MAAM,SAA0C,EAAC;AAEjD,IAAA,SAAS,SAAS,KAAA,EAAgB;AAChC,MAAA,IAAI,OAAA,EAAS;AACb,MAAA,OAAA,GAAU,IAAA;AAEV,MAAA,KAAA,MAAW,CAAA,IAAK,MAAA,EAAQ,YAAA,CAAa,CAAC,CAAA;AACtC,MAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,IACf;AAEA,IAAA,SAAS,QAAQ,KAAA,EAAoB;AACnC,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AACjB,MAAA,cAAA,EAAA;AACA,MAAA,IAAI,cAAA,IAAkB,aAAA,IAAiB,CAAC,OAAA,EAAS;AAC/C,QAAA,OAAA,GAAU,IAAA;AACV,QAAA,MAAA,CAAO,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,MAClB;AAAA,IACF;AAGA,IAAA,EAAA,EAAG,CAAE,IAAA,CAAK,QAAA,EAAU,CAAC,QAAQ,OAAA,CAAQ,GAAA,YAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAC,CAAA;AAGzF,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,SAAA,EAAW,CAAA,EAAA,EAAK;AAClC,MAAA,MAAM,KAAA,GAAQ,UAAA;AAAA,QACZ,MAAM;AAEJ,UAAA,IAAI,OAAA,EAAS;AACb,UAAA,EAAA,EAAG,CAAE,IAAA;AAAA,YAAK,QAAA;AAAA,YAAU,CAAC,GAAA,KACnB,OAAA,CAAQ,GAAA,YAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAC;AAAA,WAC7D;AAAA,QACF,CAAA;AAAA,QACA,SAAS,CAAA,GAAI,CAAA;AAAA,OACf;AACA,MAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,IACnB;AAAA,EACF,CAAC,CAAA;AACH","file":"hedge.mjs","sourcesContent":["// ============================================================================\n// FlowX — Hedged Requests\n// ============================================================================\n\nexport interface HedgeOptions {\n  /** Delay in ms before launching the hedge request (default: 500) */\n  delay?: number;\n  /** Maximum number of parallel hedged calls (default: 1) */\n  maxHedges?: number;\n}\n\n/**\n * Execute a function with hedged requests — if the primary doesn't respond\n * quickly enough, fire parallel redundant calls and return whichever resolves first.\n *\n * @example\n * ```ts\n * const data = await hedge(() => fetch('/api'), { delay: 200 });\n * ```\n */\nexport function hedge<T>(fn: () => Promise<T>, options?: HedgeOptions): Promise<T> {\n  const { delay = 500, maxHedges = 1 } = options ?? {};\n\n  if (delay < 0) throw new RangeError('delay must be >= 0');\n  if (maxHedges < 1) throw new RangeError('maxHedges must be >= 1');\n\n  return new Promise<T>((resolve, reject) => {\n    let settled = false;\n    let completedCount = 0;\n    const totalAttempts = 1 + maxHedges;\n    const errors: Error[] = [];\n    const timers: ReturnType<typeof setTimeout>[] = [];\n\n    function onResult(value: T): void {\n      if (settled) return;\n      settled = true;\n      // Clear pending hedge timers\n      for (const t of timers) clearTimeout(t);\n      resolve(value);\n    }\n\n    function onError(error: Error): void {\n      errors.push(error);\n      completedCount++;\n      if (completedCount >= totalAttempts && !settled) {\n        settled = true;\n        reject(errors[0]);\n      }\n    }\n\n    // Launch primary request immediately\n    fn().then(onResult, (err) => onError(err instanceof Error ? err : new Error(String(err))));\n\n    // Launch hedged requests after delay\n    for (let i = 0; i < maxHedges; i++) {\n      const timer = setTimeout(\n        () => {\n          /* istanbul ignore if -- timer is always cleared by onResult before firing */\n          if (settled) return;\n          fn().then(onResult, (err) =>\n            onError(err instanceof Error ? err : new Error(String(err))),\n          );\n        },\n        delay * (i + 1),\n      );\n      timers.push(timer);\n    }\n  });\n}\n"]}

package/dist/index.d.mts

@@ -0,0 +1,18 @@
+export { A as AbortError, a as AsyncFn, B as BackoffStrategy, b as BulkheadError, C as CircuitBreakerError, F as FlowXError, R as RateLimitError, T as TimeoutError, c as calculateDelay, s as sleep } from './types-BsCO2J40.mjs';
+export { RetryOptions, retry, retryable } from './retry.mjs';
+export { CircuitBreaker, CircuitBreakerOptions, CircuitState, createCircuitBreaker } from './circuit-breaker.mjs';
+export { Bulkhead, BulkheadOptions, createBulkhead } from './bulkhead.mjs';
+export { FallbackOptions, fallbackChain, withFallback } from './fallback.mjs';
+export { HedgeOptions, hedge } from './hedge.mjs';
+export { Semaphore, createSemaphore } from './semaphore.mjs';
+export { Mutex, createMutex } from './mutex.mjs';
+export { AsyncQueue, QueueAddOptions, QueueOptions, createQueue } from './queue.mjs';
+export { RateLimitOptions, RateLimiter, createRateLimiter } from './rate-limit.mjs';
+export { TimeoutOptions, withTimeout } from './timeout.mjs';
+export { DebounceOptions, DebouncedFunction, debounce } from './debounce.mjs';
+export { ThrottleOptions, ThrottledFunction, throttle } from './throttle.mjs';
+export { BatchOptions, BatchResult, batch } from './batch.mjs';
+export { PipelineStep, pipe, pipeline } from './pipeline.mjs';
+export { PollController, PollOptions, poll } from './poll.mjs';
+export { Deferred, createDeferred } from './deferred.mjs';
+export { MemoOptions, MemoizedFunction, memo } from './memo.mjs';

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { A as AbortError, a as AsyncFn, B as BackoffStrategy, b as BulkheadError, C as CircuitBreakerError, F as FlowXError, R as RateLimitError, T as TimeoutError, c as calculateDelay, s as sleep } from './types-BsCO2J40.js';
+export { RetryOptions, retry, retryable } from './retry.js';
+export { CircuitBreaker, CircuitBreakerOptions, CircuitState, createCircuitBreaker } from './circuit-breaker.js';
+export { Bulkhead, BulkheadOptions, createBulkhead } from './bulkhead.js';
+export { FallbackOptions, fallbackChain, withFallback } from './fallback.js';
+export { HedgeOptions, hedge } from './hedge.js';
+export { Semaphore, createSemaphore } from './semaphore.js';
+export { Mutex, createMutex } from './mutex.js';
+export { AsyncQueue, QueueAddOptions, QueueOptions, createQueue } from './queue.js';
+export { RateLimitOptions, RateLimiter, createRateLimiter } from './rate-limit.js';
+export { TimeoutOptions, withTimeout } from './timeout.js';
+export { DebounceOptions, DebouncedFunction, debounce } from './debounce.js';
+export { ThrottleOptions, ThrottledFunction, throttle } from './throttle.js';
+export { BatchOptions, BatchResult, batch } from './batch.js';
+export { PipelineStep, pipe, pipeline } from './pipeline.js';
+export { PollController, PollOptions, poll } from './poll.js';
+export { Deferred, createDeferred } from './deferred.js';
+export { MemoOptions, MemoizedFunction, memo } from './memo.js';