flowx-control 1.0.0

package/dist/throttle.mjs

@@ -0,0 +1,95 @@
+// src/throttle.ts
+function throttle(fn, wait, options) {
+  const { leading = true, trailing = true } = options ?? {};
+  if (wait < 0) throw new RangeError("wait must be >= 0");
+  let lastCallTime = null;
+  let timer = null;
+  let lastArgs = null;
+  let isPending = false;
+  const trailingResolvers = [];
+  async function invokeTrailing() {
+    const args = lastArgs;
+    const resolvers = trailingResolvers.splice(0);
+    lastArgs = null;
+    isPending = false;
+    timer = null;
+    if (!args) {
+      for (const r of resolvers) r.resolve(void 0);
+      return;
+    }
+    try {
+      const result = await fn(...args);
+      for (const r of resolvers) r.resolve(result);
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      for (const r of resolvers) r.reject(err);
+    }
+  }
+  function throttled(...args) {
+    const now = Date.now();
+    lastArgs = args;
+    const timeSinceLastCall = lastCallTime === null ? wait : now - lastCallTime;
+    const shouldCallLeading = leading && timeSinceLastCall >= wait;
+    if (shouldCallLeading) {
+      lastCallTime = now;
+      lastArgs = null;
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+      const prevResolvers = trailingResolvers.splice(0);
+      const resultPromise = (async () => {
+        try {
+          const result = await fn(...args);
+          for (const r of prevResolvers) r.resolve(result);
+          return result;
+        } catch (error) {
+          const err = error instanceof Error ? error : new Error(String(error));
+          for (const r of prevResolvers) r.reject(err);
+          throw err;
+        }
+      })();
+      if (trailing) {
+        timer = setTimeout(() => {
+          lastCallTime = Date.now();
+          invokeTrailing();
+        }, wait);
+      }
+      return resultPromise;
+    }
+    isPending = true;
+    return new Promise((resolve, reject) => {
+      trailingResolvers.push({ resolve, reject });
+      if (!timer && trailing) {
+        const remaining = wait - timeSinceLastCall;
+        timer = setTimeout(() => {
+          lastCallTime = Date.now();
+          invokeTrailing();
+        }, remaining);
+      }
+    });
+  }
+  throttled.cancel = () => {
+    if (timer) {
+      clearTimeout(timer);
+      timer = null;
+    }
+    lastArgs = null;
+    lastCallTime = null;
+    isPending = false;
+    const resolvers = trailingResolvers.splice(0);
+    for (const r of resolvers) {
+      r.reject(new Error("Throttled call cancelled"));
+    }
+  };
+  Object.defineProperty(throttled, "pending", {
+    get() {
+      return isPending;
+    }
+  });
+  return throttled;
+}
+
+export { throttle };
+//# sourceMappingURL=throttle.mjs.map
+//# sourceMappingURL=throttle.mjs.map

package/dist/throttle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/throttle.ts"],"names":[],"mappings":"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","file":"throttle.mjs","sourcesContent":["// ============================================================================\n// FlowX — Async-Aware Throttle\n// ============================================================================\n\nexport interface ThrottleOptions {\n  /** Invoke on the leading edge (default: true) */\n  leading?: boolean;\n  /** Invoke on the trailing edge (default: true) */\n  trailing?: boolean;\n}\n\nexport interface ThrottledFunction<TArgs extends any[], TReturn> {\n  (...args: TArgs): Promise<TReturn>;\n  /** Cancel any pending trailing invocation */\n  cancel: () => void;\n  /** Whether there is a pending trailing invocation */\n  readonly pending: boolean;\n}\n\n/**\n * Create a throttled version of an async function.\n *\n * @example\n * ```ts\n * const throttledSave = throttle(saveData, 1000);\n * await throttledSave(data);\n * ```\n */\nexport function throttle<TArgs extends any[], TReturn>(\n  fn: (...args: TArgs) => TReturn | Promise<TReturn>,\n  wait: number,\n  options?: ThrottleOptions,\n): ThrottledFunction<TArgs, TReturn> {\n  const { leading = true, trailing = true } = options ?? {};\n\n  if (wait < 0) throw new RangeError('wait must be >= 0');\n\n  let lastCallTime: number | null = null;\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  let lastArgs: TArgs | null = null;\n  let isPending = false;\n  const trailingResolvers: Array<{\n    resolve: (value: TReturn) => void;\n    reject: (error: Error) => void;\n  }> = [];\n\n  async function invokeTrailing(): Promise<void> {\n    const args = lastArgs;\n    const resolvers = trailingResolvers.splice(0);\n    lastArgs = null;\n    isPending = false;\n    timer = null;\n\n    if (!args) {\n      /* istanbul ignore next -- resolvers is always empty here; lastArgs cleared before trailing fires */\n      for (const r of resolvers) r.resolve(undefined as TReturn);\n      return;\n    }\n\n    try {\n      const result = await fn(...args);\n      for (const r of resolvers) r.resolve(result);\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error(String(error));\n      for (const r of resolvers) r.reject(err);\n    }\n  }\n\n  function throttled(...args: TArgs): Promise<TReturn> {\n    const now = Date.now();\n    lastArgs = args;\n\n    const timeSinceLastCall = lastCallTime === null ? wait : now - lastCallTime;\n    const shouldCallLeading = leading && timeSinceLastCall >= wait;\n\n    if (shouldCallLeading) {\n      lastCallTime = now;\n      lastArgs = null;\n\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n\n      // Resolve any pending trailing resolvers with this call's result\n      const prevResolvers = trailingResolvers.splice(0);\n\n      const resultPromise = (async () => {\n        try {\n          const result = await fn(...args);\n          for (const r of prevResolvers) r.resolve(result);\n          return result;\n        } catch (error) {\n          const err = error instanceof Error ? error : new Error(String(error));\n          /* istanbul ignore next -- prevResolvers is always empty on leading calls in normal flow */\n          for (const r of prevResolvers) r.reject(err);\n          throw err;\n        }\n      })();\n\n      if (trailing) {\n        timer = setTimeout(() => {\n          lastCallTime = Date.now();\n          invokeTrailing();\n        }, wait);\n      }\n\n      return resultPromise;\n    }\n\n    // Schedule trailing call\n    isPending = true;\n\n    return new Promise<TReturn>((resolve, reject) => {\n      trailingResolvers.push({ resolve, reject });\n\n      if (!timer && trailing) {\n        const remaining = wait - timeSinceLastCall;\n        timer = setTimeout(() => {\n          lastCallTime = Date.now();\n          invokeTrailing();\n        }, remaining);\n      }\n    });\n  }\n\n  throttled.cancel = (): void => {\n    if (timer) {\n      clearTimeout(timer);\n      timer = null;\n    }\n    lastArgs = null;\n    lastCallTime = null;\n    isPending = false;\n    const resolvers = trailingResolvers.splice(0);\n    for (const r of resolvers) {\n      r.reject(new Error('Throttled call cancelled'));\n    }\n  };\n\n  Object.defineProperty(throttled, 'pending', {\n    get() {\n      return isPending;\n    },\n  });\n\n  return throttled as ThrottledFunction<TArgs, TReturn>;\n}\n"]}

package/dist/timeout.d.mts

@@ -0,0 +1,19 @@
+interface TimeoutOptions<T = unknown> {
+    /** Fallback value or factory when timeout occurs */
+    fallback?: T | (() => T | Promise<T>);
+    /** AbortSignal for external cancellation */
+    signal?: AbortSignal;
+    /** Custom error message */
+    message?: string;
+}
+/**
+ * Wrap an async operation with a timeout.
+ *
+ * @example
+ * ```ts
+ * const result = await withTimeout(() => fetch('/slow-api'), 5000);
+ * ```
+ */
+declare function withTimeout<T>(fn: () => T | Promise<T>, ms: number, options?: TimeoutOptions<T>): Promise<T>;
+
+export { type TimeoutOptions, withTimeout };

package/dist/timeout.d.ts

@@ -0,0 +1,19 @@
+interface TimeoutOptions<T = unknown> {
+    /** Fallback value or factory when timeout occurs */
+    fallback?: T | (() => T | Promise<T>);
+    /** AbortSignal for external cancellation */
+    signal?: AbortSignal;
+    /** Custom error message */
+    message?: string;
+}
+/**
+ * Wrap an async operation with a timeout.
+ *
+ * @example
+ * ```ts
+ * const result = await withTimeout(() => fetch('/slow-api'), 5000);
+ * ```
+ */
+declare function withTimeout<T>(fn: () => T | Promise<T>, ms: number, options?: TimeoutOptions<T>): Promise<T>;
+
+export { type TimeoutOptions, withTimeout };

package/dist/timeout.js

@@ -0,0 +1,79 @@
+'use strict';
+
+// src/types.ts
+var FlowXError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "FlowXError";
+    this.code = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var TimeoutError = class extends FlowXError {
+  constructor(message = "Operation timed out") {
+    super(message, "ERR_TIMEOUT");
+    this.name = "TimeoutError";
+  }
+};
+var AbortError = class extends FlowXError {
+  constructor(message = "Operation aborted") {
+    super(message, "ERR_ABORTED");
+    this.name = "AbortError";
+  }
+};
+
+// src/timeout.ts
+async function withTimeout(fn, ms, options) {
+  if (ms <= 0) {
+    throw new RangeError("Timeout must be > 0");
+  }
+  if (options?.signal?.aborted) {
+    throw new AbortError();
+  }
+  const fnResult = fn();
+  return Promise.race([
+    Promise.resolve(fnResult),
+    new Promise((_, reject) => {
+      const timer = setTimeout(() => {
+        if (options?.fallback !== void 0) {
+          const fb = options.fallback;
+          if (typeof fb === "function") {
+            try {
+              const result = fb();
+              Promise.resolve(result).then(
+                (v) => reject({ __resolved: true, value: v }),
+                reject
+              );
+            } catch (err) {
+              reject(err);
+            }
+          } else {
+            reject({ __resolved: true, value: fb });
+          }
+        } else {
+          reject(new TimeoutError(options?.message));
+        }
+      }, ms);
+      if (options?.signal) {
+        const onAbort = () => {
+          clearTimeout(timer);
+          reject(new AbortError());
+        };
+        options.signal.addEventListener("abort", onAbort, { once: true });
+      }
+      Promise.resolve(fnResult).then(
+        () => clearTimeout(timer),
+        () => clearTimeout(timer)
+      );
+    })
+  ]).catch((err) => {
+    if (err && typeof err === "object" && "__resolved" in err) {
+      return err.value;
+    }
+    throw err;
+  });
+}
+
+exports.withTimeout = withTimeout;
+//# sourceMappingURL=timeout.js.map
+//# sourceMappingURL=timeout.js.map

package/dist/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/timeout.ts"],"names":[],"mappings":"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","file":"timeout.js","sourcesContent":["// ============================================================================\n// FlowX — Types & Error Hierarchy\n// ============================================================================\n\n/** Generic async function signature */\nexport type AsyncFn<TArgs extends any[] = any[], TReturn = any> = (\n  ...args: TArgs\n) => Promise<TReturn>;\n\n/** Backoff strategy for retry/poll operations */\nexport type BackoffStrategy =\n  | 'fixed'\n  | 'linear'\n  | 'exponential'\n  | ((attempt: number, delay: number) => number);\n\n// ── Error Classes ───────────────────────────────────────────────────────────\n\n/** Base error class for all FlowX errors */\nexport class FlowXError extends Error {\n  public readonly code: string;\n  constructor(message: string, code: string) {\n    super(message);\n    this.name = 'FlowXError';\n    this.code = code;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when a promise exceeds its timeout */\nexport class TimeoutError extends FlowXError {\n  constructor(message = 'Operation timed out') {\n    super(message, 'ERR_TIMEOUT');\n    this.name = 'TimeoutError';\n  }\n}\n\n/** Thrown when a circuit breaker is open */\nexport class CircuitBreakerError extends FlowXError {\n  constructor(message = 'Circuit breaker is open') {\n    super(message, 'ERR_CIRCUIT_OPEN');\n    this.name = 'CircuitBreakerError';\n  }\n}\n\n/** Thrown when a bulkhead rejects due to capacity */\nexport class BulkheadError extends FlowXError {\n  constructor(message = 'Bulkhead capacity exceeded') {\n    super(message, 'ERR_BULKHEAD_FULL');\n    this.name = 'BulkheadError';\n  }\n}\n\n/** Thrown when an operation is aborted */\nexport class AbortError extends FlowXError {\n  constructor(message = 'Operation aborted') {\n    super(message, 'ERR_ABORTED');\n    this.name = 'AbortError';\n  }\n}\n\n/** Thrown when rate limit is exceeded */\nexport class RateLimitError extends FlowXError {\n  constructor(message = 'Rate limit exceeded') {\n    super(message, 'ERR_RATE_LIMIT');\n    this.name = 'RateLimitError';\n  }\n}\n\n// ── Utility Helpers ─────────────────────────────────────────────────────────\n\n/** Sleep for the specified duration, respecting AbortSignal */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new AbortError());\n      return;\n    }\n\n    let onAbort: (() => void) | undefined;\n\n    const timer = setTimeout(() => {\n      if (signal && onAbort) {\n        signal.removeEventListener('abort', onAbort);\n      }\n      resolve();\n    }, ms);\n\n    if (signal) {\n      onAbort = () => {\n        clearTimeout(timer);\n        reject(new AbortError());\n      };\n      signal.addEventListener('abort', onAbort, { once: true });\n    }\n  });\n}\n\n/** Calculate delay based on backoff strategy */\nexport function calculateDelay(\n  attempt: number,\n  baseDelay: number,\n  strategy: BackoffStrategy,\n  jitter: boolean | number = false,\n): number {\n  let delay: number;\n\n  if (typeof strategy === 'function') {\n    delay = strategy(attempt, baseDelay);\n  } else {\n    switch (strategy) {\n      case 'fixed':\n        delay = baseDelay;\n        break;\n      case 'linear':\n        delay = baseDelay * attempt;\n        break;\n      case 'exponential':\n        delay = baseDelay * Math.pow(2, attempt - 1);\n        break;\n    }\n  }\n\n  if (jitter) {\n    const factor = typeof jitter === 'number' ? jitter : 1;\n    delay = delay * (1 - factor * 0.5 + Math.random() * factor);\n  }\n\n  return Math.max(0, Math.floor(delay));\n}\n","// ============================================================================\n// FlowX — Promise Timeout with Cleanup\n// ============================================================================\nimport { AbortError, TimeoutError } from './types';\n\nexport interface TimeoutOptions<T = unknown> {\n  /** Fallback value or factory when timeout occurs */\n  fallback?: T | (() => T | Promise<T>);\n  /** AbortSignal for external cancellation */\n  signal?: AbortSignal;\n  /** Custom error message */\n  message?: string;\n}\n\n/**\n * Wrap an async operation with a timeout.\n *\n * @example\n * ```ts\n * const result = await withTimeout(() => fetch('/slow-api'), 5000);\n * ```\n */\nexport async function withTimeout<T>(\n  fn: () => T | Promise<T>,\n  ms: number,\n  options?: TimeoutOptions<T>,\n): Promise<T> {\n  if (ms <= 0) {\n    throw new RangeError('Timeout must be > 0');\n  }\n\n  if (options?.signal?.aborted) {\n    throw new AbortError();\n  }\n\n  const fnResult = fn(); // call synchronously so sync throws propagate\n\n  return Promise.race([\n    Promise.resolve(fnResult),\n    new Promise<T>((_, reject) => {\n      const timer = setTimeout(() => {\n        if (options?.fallback !== undefined) {\n          const fb = options.fallback;\n          if (typeof fb === 'function') {\n            try {\n              const result = (fb as () => T | Promise<T>)();\n              Promise.resolve(result).then(\n                (v) => reject({ __resolved: true, value: v } as any),\n                reject,\n              );\n            } catch (err) {\n              reject(err);\n            }\n          } else {\n            reject({ __resolved: true, value: fb } as any);\n          }\n        } else {\n          reject(new TimeoutError(options?.message));\n        }\n      }, ms);\n\n      // If signal aborts, reject the race\n      if (options?.signal) {\n        const onAbort = () => {\n          clearTimeout(timer);\n          reject(new AbortError());\n        };\n        options.signal.addEventListener('abort', onAbort, { once: true });\n      }\n\n      // Clean up timer when fn resolves\n      Promise.resolve(fnResult).then(\n        () => clearTimeout(timer),\n        () => clearTimeout(timer),\n      );\n    }),\n  ]).catch((err) => {\n    // Handle the fallback resolution hack\n    if (err && typeof err === 'object' && '__resolved' in err) {\n      return err.value as T;\n    }\n    throw err;\n  });\n}\n"]}

package/dist/timeout.mjs

@@ -0,0 +1,77 @@
+// src/types.ts
+var FlowXError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "FlowXError";
+    this.code = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var TimeoutError = class extends FlowXError {
+  constructor(message = "Operation timed out") {
+    super(message, "ERR_TIMEOUT");
+    this.name = "TimeoutError";
+  }
+};
+var AbortError = class extends FlowXError {
+  constructor(message = "Operation aborted") {
+    super(message, "ERR_ABORTED");
+    this.name = "AbortError";
+  }
+};
+
+// src/timeout.ts
+async function withTimeout(fn, ms, options) {
+  if (ms <= 0) {
+    throw new RangeError("Timeout must be > 0");
+  }
+  if (options?.signal?.aborted) {
+    throw new AbortError();
+  }
+  const fnResult = fn();
+  return Promise.race([
+    Promise.resolve(fnResult),
+    new Promise((_, reject) => {
+      const timer = setTimeout(() => {
+        if (options?.fallback !== void 0) {
+          const fb = options.fallback;
+          if (typeof fb === "function") {
+            try {
+              const result = fb();
+              Promise.resolve(result).then(
+                (v) => reject({ __resolved: true, value: v }),
+                reject
+              );
+            } catch (err) {
+              reject(err);
+            }
+          } else {
+            reject({ __resolved: true, value: fb });
+          }
+        } else {
+          reject(new TimeoutError(options?.message));
+        }
+      }, ms);
+      if (options?.signal) {
+        const onAbort = () => {
+          clearTimeout(timer);
+          reject(new AbortError());
+        };
+        options.signal.addEventListener("abort", onAbort, { once: true });
+      }
+      Promise.resolve(fnResult).then(
+        () => clearTimeout(timer),
+        () => clearTimeout(timer)
+      );
+    })
+  ]).catch((err) => {
+    if (err && typeof err === "object" && "__resolved" in err) {
+      return err.value;
+    }
+    throw err;
+  });
+}
+
+export { withTimeout };
+//# sourceMappingURL=timeout.mjs.map
+//# sourceMappingURL=timeout.mjs.map

package/dist/timeout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/timeout.ts"],"names":[],"mappings":"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","file":"timeout.mjs","sourcesContent":["// ============================================================================\n// FlowX — Types & Error Hierarchy\n// ============================================================================\n\n/** Generic async function signature */\nexport type AsyncFn<TArgs extends any[] = any[], TReturn = any> = (\n  ...args: TArgs\n) => Promise<TReturn>;\n\n/** Backoff strategy for retry/poll operations */\nexport type BackoffStrategy =\n  | 'fixed'\n  | 'linear'\n  | 'exponential'\n  | ((attempt: number, delay: number) => number);\n\n// ── Error Classes ───────────────────────────────────────────────────────────\n\n/** Base error class for all FlowX errors */\nexport class FlowXError extends Error {\n  public readonly code: string;\n  constructor(message: string, code: string) {\n    super(message);\n    this.name = 'FlowXError';\n    this.code = code;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when a promise exceeds its timeout */\nexport class TimeoutError extends FlowXError {\n  constructor(message = 'Operation timed out') {\n    super(message, 'ERR_TIMEOUT');\n    this.name = 'TimeoutError';\n  }\n}\n\n/** Thrown when a circuit breaker is open */\nexport class CircuitBreakerError extends FlowXError {\n  constructor(message = 'Circuit breaker is open') {\n    super(message, 'ERR_CIRCUIT_OPEN');\n    this.name = 'CircuitBreakerError';\n  }\n}\n\n/** Thrown when a bulkhead rejects due to capacity */\nexport class BulkheadError extends FlowXError {\n  constructor(message = 'Bulkhead capacity exceeded') {\n    super(message, 'ERR_BULKHEAD_FULL');\n    this.name = 'BulkheadError';\n  }\n}\n\n/** Thrown when an operation is aborted */\nexport class AbortError extends FlowXError {\n  constructor(message = 'Operation aborted') {\n    super(message, 'ERR_ABORTED');\n    this.name = 'AbortError';\n  }\n}\n\n/** Thrown when rate limit is exceeded */\nexport class RateLimitError extends FlowXError {\n  constructor(message = 'Rate limit exceeded') {\n    super(message, 'ERR_RATE_LIMIT');\n    this.name = 'RateLimitError';\n  }\n}\n\n// ── Utility Helpers ─────────────────────────────────────────────────────────\n\n/** Sleep for the specified duration, respecting AbortSignal */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new AbortError());\n      return;\n    }\n\n    let onAbort: (() => void) | undefined;\n\n    const timer = setTimeout(() => {\n      if (signal && onAbort) {\n        signal.removeEventListener('abort', onAbort);\n      }\n      resolve();\n    }, ms);\n\n    if (signal) {\n      onAbort = () => {\n        clearTimeout(timer);\n        reject(new AbortError());\n      };\n      signal.addEventListener('abort', onAbort, { once: true });\n    }\n  });\n}\n\n/** Calculate delay based on backoff strategy */\nexport function calculateDelay(\n  attempt: number,\n  baseDelay: number,\n  strategy: BackoffStrategy,\n  jitter: boolean | number = false,\n): number {\n  let delay: number;\n\n  if (typeof strategy === 'function') {\n    delay = strategy(attempt, baseDelay);\n  } else {\n    switch (strategy) {\n      case 'fixed':\n        delay = baseDelay;\n        break;\n      case 'linear':\n        delay = baseDelay * attempt;\n        break;\n      case 'exponential':\n        delay = baseDelay * Math.pow(2, attempt - 1);\n        break;\n    }\n  }\n\n  if (jitter) {\n    const factor = typeof jitter === 'number' ? jitter : 1;\n    delay = delay * (1 - factor * 0.5 + Math.random() * factor);\n  }\n\n  return Math.max(0, Math.floor(delay));\n}\n","// ============================================================================\n// FlowX — Promise Timeout with Cleanup\n// ============================================================================\nimport { AbortError, TimeoutError } from './types';\n\nexport interface TimeoutOptions<T = unknown> {\n  /** Fallback value or factory when timeout occurs */\n  fallback?: T | (() => T | Promise<T>);\n  /** AbortSignal for external cancellation */\n  signal?: AbortSignal;\n  /** Custom error message */\n  message?: string;\n}\n\n/**\n * Wrap an async operation with a timeout.\n *\n * @example\n * ```ts\n * const result = await withTimeout(() => fetch('/slow-api'), 5000);\n * ```\n */\nexport async function withTimeout<T>(\n  fn: () => T | Promise<T>,\n  ms: number,\n  options?: TimeoutOptions<T>,\n): Promise<T> {\n  if (ms <= 0) {\n    throw new RangeError('Timeout must be > 0');\n  }\n\n  if (options?.signal?.aborted) {\n    throw new AbortError();\n  }\n\n  const fnResult = fn(); // call synchronously so sync throws propagate\n\n  return Promise.race([\n    Promise.resolve(fnResult),\n    new Promise<T>((_, reject) => {\n      const timer = setTimeout(() => {\n        if (options?.fallback !== undefined) {\n          const fb = options.fallback;\n          if (typeof fb === 'function') {\n            try {\n              const result = (fb as () => T | Promise<T>)();\n              Promise.resolve(result).then(\n                (v) => reject({ __resolved: true, value: v } as any),\n                reject,\n              );\n            } catch (err) {\n              reject(err);\n            }\n          } else {\n            reject({ __resolved: true, value: fb } as any);\n          }\n        } else {\n          reject(new TimeoutError(options?.message));\n        }\n      }, ms);\n\n      // If signal aborts, reject the race\n      if (options?.signal) {\n        const onAbort = () => {\n          clearTimeout(timer);\n          reject(new AbortError());\n        };\n        options.signal.addEventListener('abort', onAbort, { once: true });\n      }\n\n      // Clean up timer when fn resolves\n      Promise.resolve(fnResult).then(\n        () => clearTimeout(timer),\n        () => clearTimeout(timer),\n      );\n    }),\n  ]).catch((err) => {\n    // Handle the fallback resolution hack\n    if (err && typeof err === 'object' && '__resolved' in err) {\n      return err.value as T;\n    }\n    throw err;\n  });\n}\n"]}

package/dist/types-BsCO2J40.d.mts

@@ -0,0 +1,35 @@
+/** Generic async function signature */
+type AsyncFn<TArgs extends any[] = any[], TReturn = any> = (...args: TArgs) => Promise<TReturn>;
+/** Backoff strategy for retry/poll operations */
+type BackoffStrategy = 'fixed' | 'linear' | 'exponential' | ((attempt: number, delay: number) => number);
+/** Base error class for all FlowX errors */
+declare class FlowXError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/** Thrown when a promise exceeds its timeout */
+declare class TimeoutError extends FlowXError {
+    constructor(message?: string);
+}
+/** Thrown when a circuit breaker is open */
+declare class CircuitBreakerError extends FlowXError {
+    constructor(message?: string);
+}
+/** Thrown when a bulkhead rejects due to capacity */
+declare class BulkheadError extends FlowXError {
+    constructor(message?: string);
+}
+/** Thrown when an operation is aborted */
+declare class AbortError extends FlowXError {
+    constructor(message?: string);
+}
+/** Thrown when rate limit is exceeded */
+declare class RateLimitError extends FlowXError {
+    constructor(message?: string);
+}
+/** Sleep for the specified duration, respecting AbortSignal */
+declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+/** Calculate delay based on backoff strategy */
+declare function calculateDelay(attempt: number, baseDelay: number, strategy: BackoffStrategy, jitter?: boolean | number): number;
+
+export { AbortError as A, type BackoffStrategy as B, CircuitBreakerError as C, FlowXError as F, RateLimitError as R, TimeoutError as T, type AsyncFn as a, BulkheadError as b, calculateDelay as c, sleep as s };

package/dist/types-BsCO2J40.d.ts

@@ -0,0 +1,35 @@
+/** Generic async function signature */
+type AsyncFn<TArgs extends any[] = any[], TReturn = any> = (...args: TArgs) => Promise<TReturn>;
+/** Backoff strategy for retry/poll operations */
+type BackoffStrategy = 'fixed' | 'linear' | 'exponential' | ((attempt: number, delay: number) => number);
+/** Base error class for all FlowX errors */
+declare class FlowXError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/** Thrown when a promise exceeds its timeout */
+declare class TimeoutError extends FlowXError {
+    constructor(message?: string);
+}
+/** Thrown when a circuit breaker is open */
+declare class CircuitBreakerError extends FlowXError {
+    constructor(message?: string);
+}
+/** Thrown when a bulkhead rejects due to capacity */
+declare class BulkheadError extends FlowXError {
+    constructor(message?: string);
+}
+/** Thrown when an operation is aborted */
+declare class AbortError extends FlowXError {
+    constructor(message?: string);
+}
+/** Thrown when rate limit is exceeded */
+declare class RateLimitError extends FlowXError {
+    constructor(message?: string);
+}
+/** Sleep for the specified duration, respecting AbortSignal */
+declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+/** Calculate delay based on backoff strategy */
+declare function calculateDelay(attempt: number, baseDelay: number, strategy: BackoffStrategy, jitter?: boolean | number): number;
+
+export { AbortError as A, type BackoffStrategy as B, CircuitBreakerError as C, FlowXError as F, RateLimitError as R, TimeoutError as T, type AsyncFn as a, BulkheadError as b, calculateDelay as c, sleep as s };

package/package.json

@@ -0,0 +1,167 @@
+{
+  "name": "flowx-control",
+  "version": "1.0.0",
+  "description": "Production-grade, zero-dependency TypeScript resilience & async flow control library. 100% test coverage. Retry with backoff, Circuit Breaker, Bulkhead, Rate Limiter, Priority Queue, Semaphore, Mutex, Debounce, Throttle, Timeout, Hedge, Poll, Batch, Pipeline — all tree-shakable & composable.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./retry": {
+      "import": "./dist/retry.mjs",
+      "require": "./dist/retry.js",
+      "types": "./dist/retry.d.ts"
+    },
+    "./circuit-breaker": {
+      "import": "./dist/circuit-breaker.mjs",
+      "require": "./dist/circuit-breaker.js",
+      "types": "./dist/circuit-breaker.d.ts"
+    },
+    "./bulkhead": {
+      "import": "./dist/bulkhead.mjs",
+      "require": "./dist/bulkhead.js",
+      "types": "./dist/bulkhead.d.ts"
+    },
+    "./fallback": {
+      "import": "./dist/fallback.mjs",
+      "require": "./dist/fallback.js",
+      "types": "./dist/fallback.d.ts"
+    },
+    "./hedge": {
+      "import": "./dist/hedge.mjs",
+      "require": "./dist/hedge.js",
+      "types": "./dist/hedge.d.ts"
+    },
+    "./timeout": {
+      "import": "./dist/timeout.mjs",
+      "require": "./dist/timeout.js",
+      "types": "./dist/timeout.d.ts"
+    },
+    "./semaphore": {
+      "import": "./dist/semaphore.mjs",
+      "require": "./dist/semaphore.js",
+      "types": "./dist/semaphore.d.ts"
+    },
+    "./mutex": {
+      "import": "./dist/mutex.mjs",
+      "require": "./dist/mutex.js",
+      "types": "./dist/mutex.d.ts"
+    },
+    "./queue": {
+      "import": "./dist/queue.mjs",
+      "require": "./dist/queue.js",
+      "types": "./dist/queue.d.ts"
+    },
+    "./rate-limit": {
+      "import": "./dist/rate-limit.mjs",
+      "require": "./dist/rate-limit.js",
+      "types": "./dist/rate-limit.d.ts"
+    },
+    "./debounce": {
+      "import": "./dist/debounce.mjs",
+      "require": "./dist/debounce.js",
+      "types": "./dist/debounce.d.ts"
+    },
+    "./throttle": {
+      "import": "./dist/throttle.mjs",
+      "require": "./dist/throttle.js",
+      "types": "./dist/throttle.d.ts"
+    },
+    "./batch": {
+      "import": "./dist/batch.mjs",
+      "require": "./dist/batch.js",
+      "types": "./dist/batch.d.ts"
+    },
+    "./pipeline": {
+      "import": "./dist/pipeline.mjs",
+      "require": "./dist/pipeline.js",
+      "types": "./dist/pipeline.d.ts"
+    },
+    "./poll": {
+      "import": "./dist/poll.mjs",
+      "require": "./dist/poll.js",
+      "types": "./dist/poll.d.ts"
+    },
+    "./deferred": {
+      "import": "./dist/deferred.mjs",
+      "require": "./dist/deferred.js",
+      "types": "./dist/deferred.d.ts"
+    },
+    "./memo": {
+      "import": "./dist/memo.mjs",
+      "require": "./dist/memo.js",
+      "types": "./dist/memo.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "jest --coverage",
+    "test:ci": "jest --coverage",
+    "lint": "eslint src/ --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\" \"__tests__/**/*.ts\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "async",
+    "retry",
+    "circuit-breaker",
+    "bulkhead",
+    "rate-limit",
+    "queue",
+    "semaphore",
+    "mutex",
+    "throttle",
+    "debounce",
+    "resilience",
+    "fault-tolerance",
+    "backoff",
+    "timeout",
+    "pipeline",
+    "concurrency",
+    "flow-control",
+    "typescript",
+    "zero-dependency",
+    "hedge",
+    "fallback",
+    "batch",
+    "polling",
+    "memoize",
+    "deferred",
+    "promise"
+  ],
+  "author": "Avinash Velu <avinashvelu03@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Avinashvelu03/FlowX.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Avinashvelu03/FlowX/issues"
+  },
+  "homepage": "https://github.com/Avinashvelu03/FlowX#readme",
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.3.0",
+    "ts-jest": "^29.2.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "sideEffects": false
+}