@mrjacket/ahko 0.1.0 → 0.3.0

package/dist/index.cjs

@@ -26,9 +26,12 @@ __export(src_exports, {
   AhkoError: () => AhkoError,
   AhkoQueueError: () => AhkoQueueError,
   AhkoTimeoutError: () => AhkoTimeoutError,
+  DEFAULT_BASE_DELAY: () => DEFAULT_BASE_DELAY,
+  DEFAULT_MAX_DELAY: () => DEFAULT_MAX_DELAY,
   EScheduleStrategy: () => EScheduleStrategy,
   ETaskState: () => ETaskState,
-  VERSION: () => VERSION
+  VERSION: () => VERSION,
+  calculateBackoff: () => calculateBackoff
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -62,6 +65,14 @@ var AhkoConfigurationError = class extends AhkoError {
   }
 };
 
+// src/models/strategy.model.ts
+var EScheduleStrategy = /* @__PURE__ */ ((EScheduleStrategy2) => {
+  EScheduleStrategy2["IMMEDIATE"] = "immediate";
+  EScheduleStrategy2["DELAY"] = "delay";
+  EScheduleStrategy2["IDLE"] = "idle";
+  return EScheduleStrategy2;
+})(EScheduleStrategy || {});
+
 // src/models/state.model.ts
 var ETaskState = /* @__PURE__ */ ((ETaskState2) => {
   ETaskState2["PENDING"] = "pending";
@@ -73,12 +84,69 @@ var ETaskState = /* @__PURE__ */ ((ETaskState2) => {
   return ETaskState2;
 })(ETaskState || {});
 
-// src/models/strategy.model.ts
-var EScheduleStrategy = /* @__PURE__ */ ((EScheduleStrategy2) => {
-  EScheduleStrategy2["IMMEDIATE"] = "immediate";
-  EScheduleStrategy2["DELAY"] = "delay";
-  return EScheduleStrategy2;
-})(EScheduleStrategy || {});
+// src/retry/backoff.ts
+var DEFAULT_BASE_DELAY = 250;
+var DEFAULT_MAX_DELAY = 1e4;
+function calculateBackoff(attempt, options, randomFn = Math.random) {
+  const backoff = options?.backoff ?? "exponential";
+  if (backoff === "none") {
+    return 0;
+  }
+  const baseDelay = typeof options?.baseDelay === "number" && !Number.isNaN(options.baseDelay) && options.baseDelay >= 0 ? options.baseDelay : DEFAULT_BASE_DELAY;
+  const maxDelay = typeof options?.maxDelay === "number" && !Number.isNaN(options.maxDelay) && options.maxDelay >= baseDelay ? options.maxDelay : Math.max(DEFAULT_MAX_DELAY, baseDelay);
+  let calculatedDelay;
+  if (backoff === "linear") {
+    calculatedDelay = baseDelay * Math.max(1, attempt);
+  } else {
+    const exponent = Math.max(0, attempt - 1);
+    const factor = exponent > 30 ? 2 ** 30 : 2 ** exponent;
+    calculatedDelay = baseDelay * factor;
+  }
+  const cappedDelay = Math.min(calculatedDelay, maxDelay);
+  if (options?.jitter) {
+    return Math.floor(randomFn() * (cappedDelay + 1));
+  }
+  return Math.floor(cappedDelay);
+}
+
+// src/scheduler/idle-scheduler.ts
+var IdleScheduler = class {
+  /**
+   * Schedules a callback to execute during the next idle opportunity.
+   *
+   * @param callback - Function to invoke when idle opportunity arises.
+   * @param timeout - Optional max deadline in milliseconds to wait before invoking (browser only).
+   * @param runtime - Target runtime scope providing scheduling primitives (defaults to globalThis).
+   * @returns An {@link IIdleHandle} with a `cancel()` method for cleanup.
+   */
+  static schedule(callback, timeout, runtime = globalThis) {
+    if (typeof runtime.requestIdleCallback === "function" && typeof runtime.cancelIdleCallback === "function") {
+      const requestFn = runtime.requestIdleCallback;
+      const cancelFn = runtime.cancelIdleCallback;
+      const id = requestFn(
+        () => callback(),
+        typeof timeout === "number" && !Number.isNaN(timeout) && timeout >= 0 ? { timeout } : void 0
+      );
+      return {
+        cancel: () => cancelFn(id)
+      };
+    }
+    if (typeof runtime.setImmediate === "function" && typeof runtime.clearImmediate === "function") {
+      const setImmFn = runtime.setImmediate;
+      const clearImmFn = runtime.clearImmediate;
+      const handle = setImmFn(() => callback());
+      return {
+        cancel: () => clearImmFn(handle)
+      };
+    }
+    const setTimerFn = runtime.setTimeout.bind(runtime);
+    const clearTimerFn = runtime.clearTimeout.bind(runtime);
+    const timerId = setTimerFn(() => callback(), 0);
+    return {
+      cancel: () => clearTimerFn(timerId)
+    };
+  }
+};
 
 // src/scheduler/task-queue.ts
 var TaskQueue = class {
@@ -90,6 +158,12 @@ var TaskQueue = class {
   activeRunners = /* @__PURE__ */ new Set();
   /** Set of tasks currently in delay phase */
   delayedEntries = /* @__PURE__ */ new Set();
+  /** Set of tasks currently awaiting an idle opportunity */
+  idleEntries = /* @__PURE__ */ new Set();
+  /** Set of tasks currently awaiting a retry backoff timer */
+  retryEntries = /* @__PURE__ */ new Set();
+  /** WeakMap associating task runners with their scheduling options */
+  runnerOptions = /* @__PURE__ */ new WeakMap();
   /** Cumulative completed tasks counter */
   completedTasks = 0;
   /** Cumulative failed tasks counter */
@@ -123,11 +197,31 @@ var TaskQueue = class {
    */
   enqueue(runner, options) {
     const strategy = options?.strategy ?? "immediate" /* IMMEDIATE */;
-    if (strategy !== "immediate" /* IMMEDIATE */ && strategy !== "delay" /* DELAY */) {
+    if (strategy !== "immediate" /* IMMEDIATE */ && strategy !== "delay" /* DELAY */ && strategy !== "idle" /* IDLE */) {
       throw new AhkoConfigurationError(
-        `Unsupported schedule strategy "${String(strategy)}". Supported strategies in 0.1.0: "immediate", "delay".`
+        `Unsupported schedule strategy "${String(strategy)}". Supported strategies: "immediate", "delay", "idle".`
       );
     }
+    if (options?.retry) {
+      if (typeof options.retry.attempts !== "number" || Number.isNaN(options.retry.attempts) || options.retry.attempts < 1 || !Number.isInteger(options.retry.attempts)) {
+        throw new AhkoConfigurationError(
+          `Invalid retry attempts "${options.retry.attempts}". attempts must be an integer greater than or equal to 1.`
+        );
+      }
+      if (options.retry.baseDelay !== void 0 && (typeof options.retry.baseDelay !== "number" || Number.isNaN(options.retry.baseDelay) || options.retry.baseDelay < 0)) {
+        throw new AhkoConfigurationError(
+          `Invalid retry baseDelay "${options.retry.baseDelay}". baseDelay must be a non-negative number in milliseconds.`
+        );
+      }
+      if (options.retry.maxDelay !== void 0 && (typeof options.retry.maxDelay !== "number" || Number.isNaN(options.retry.maxDelay) || options.retry.maxDelay < 0)) {
+        throw new AhkoConfigurationError(
+          `Invalid retry maxDelay "${options.retry.maxDelay}". maxDelay must be a non-negative number in milliseconds.`
+        );
+      }
+    }
+    if (options) {
+      this.runnerOptions.set(runner, options);
+    }
     if (runner.state === "cancelled" /* CANCELLED */) {
       this.cancelledTasks++;
       return runner.promise;
@@ -142,6 +236,15 @@ var TaskQueue = class {
       this.scheduleDelayed(runner, delayMs);
       return runner.promise;
     }
+    if (strategy === "idle" /* IDLE */) {
+      if (options?.idleTimeout !== void 0 && (typeof options.idleTimeout !== "number" || Number.isNaN(options.idleTimeout) || options.idleTimeout < 0)) {
+        throw new AhkoConfigurationError(
+          `Invalid idleTimeout "${options.idleTimeout}". idleTimeout must be a non-negative number in milliseconds.`
+        );
+      }
+      this.scheduleIdle(runner, options?.idleTimeout);
+      return runner.promise;
+    }
     runner.onCancel = () => {
       const index = this.queue.indexOf(runner);
       if (index !== -1) {
@@ -185,6 +288,37 @@ var TaskQueue = class {
       }
     };
   }
+  /**
+   * Schedules a task to be placed into the queue during an idle opportunity,
+   * handling early cancellation safely.
+   */
+  scheduleIdle(runner, idleTimeout) {
+    let idleEntry;
+    const handle = IdleScheduler.schedule(() => {
+      this.idleEntries.delete(idleEntry);
+      if (runner.state === "cancelled" /* CANCELLED */) {
+        return;
+      }
+      runner.onCancel = () => {
+        const index = this.queue.indexOf(runner);
+        if (index !== -1) {
+          this.queue.splice(index, 1);
+          this.cancelledTasks++;
+        }
+      };
+      this.queue.push(runner);
+      this.pump();
+    }, idleTimeout);
+    idleEntry = { runner, handle };
+    this.idleEntries.add(idleEntry);
+    runner.onCancel = () => {
+      if (this.idleEntries.has(idleEntry)) {
+        handle.cancel();
+        this.idleEntries.delete(idleEntry);
+        this.cancelledTasks++;
+      }
+    };
+  }
   /**
    * Pumps the queue by picking pending tasks and executing them
    * as long as concurrency capacity is available.
@@ -204,28 +338,86 @@ var TaskQueue = class {
   }
   /**
    * Internal execution of an active task runner.
-   * Settle caller promise strictly after stats and active status are updated.
    */
   async executeRunner(runner) {
+    const options = this.runnerOptions.get(runner);
     try {
       const result = await runner.run();
       this.completedTasks++;
       this.activeRunners.delete(runner);
+      this.runnerOptions.delete(runner);
       runner.resolve(result);
     } catch (error) {
       if (runner.state === "cancelled" /* CANCELLED */) {
         this.cancelledTasks++;
-      } else if (runner.state === "timed_out" /* TIMED_OUT */) {
+        this.activeRunners.delete(runner);
+        this.runnerOptions.delete(runner);
+        runner.reject(error);
+        return;
+      }
+      const shouldRetry = await runner.canRetry(error, options?.retry);
+      if (shouldRetry) {
+        this.activeRunners.delete(runner);
+        this.scheduleRetry(runner, options);
+        return;
+      }
+      if (runner.state === "timed_out" /* TIMED_OUT */) {
         this.timedOutTasks++;
       } else {
         this.failedTasks++;
       }
       this.activeRunners.delete(runner);
+      this.runnerOptions.delete(runner);
       runner.reject(error);
     } finally {
       this.pump();
     }
   }
+  /**
+   * Schedules a retry attempt following backoff delay,
+   * without holding a concurrency slot.
+   */
+  scheduleRetry(runner, options) {
+    const backoffDelay = calculateBackoff(runner.attempt - 1, options?.retry);
+    if (backoffDelay === 0) {
+      runner.onCancel = () => {
+        const index = this.queue.indexOf(runner);
+        if (index !== -1) {
+          this.queue.splice(index, 1);
+          this.cancelledTasks++;
+        }
+      };
+      this.queue.push(runner);
+      this.pump();
+      return;
+    }
+    const retryEntry = {
+      runner,
+      timerId: setTimeout(() => {
+        this.retryEntries.delete(retryEntry);
+        if (runner.state === "cancelled" /* CANCELLED */) {
+          return;
+        }
+        runner.onCancel = () => {
+          const index = this.queue.indexOf(runner);
+          if (index !== -1) {
+            this.queue.splice(index, 1);
+            this.cancelledTasks++;
+          }
+        };
+        this.queue.push(runner);
+        this.pump();
+      }, backoffDelay)
+    };
+    this.retryEntries.add(retryEntry);
+    runner.onCancel = () => {
+      if (this.retryEntries.has(retryEntry)) {
+        clearTimeout(retryEntry.timerId);
+        this.retryEntries.delete(retryEntry);
+        this.cancelledTasks++;
+      }
+    };
+  }
   /**
    * Returns telemetry snapshot for the scheduler.
    *
@@ -234,7 +426,7 @@ var TaskQueue = class {
   getStats() {
     return Object.freeze({
       activeTasks: this.activeRunners.size,
-      pendingTasks: this.queue.length + this.delayedEntries.size,
+      pendingTasks: this.queue.length + this.delayedEntries.size + this.idleEntries.size + this.retryEntries.size,
       completedTasks: this.completedTasks,
       failedTasks: this.failedTasks,
       cancelledTasks: this.cancelledTasks,
@@ -320,12 +512,15 @@ var TaskRunner = class {
   get state() {
     return this._state;
   }
+  /** Current execution attempt count (1-indexed) */
+  attempt = 1;
   /**
    * Resolves the deferred promise.
    *
    * @param value - Value to resolve with.
    */
   resolve(value) {
+    this.cleanup();
     this.resolvePromise(value);
   }
   /**
@@ -334,8 +529,40 @@ var TaskRunner = class {
    * @param reason - Reason to reject with.
    */
   reject(reason) {
+    this.cleanup();
     this.rejectPromise(reason);
   }
+  /**
+   * Evaluates if the task should be retried following an execution failure.
+   *
+   * @param error - The error encountered during the attempt.
+   * @param retryOptions - Configured retry policy.
+   * @returns A promise resolving to true if retry should proceed, false otherwise.
+   */
+  async canRetry(error, retryOptions) {
+    if (this._state === "cancelled" /* CANCELLED */ || this.abortController.signal.aborted) {
+      return false;
+    }
+    if (!retryOptions || typeof retryOptions.attempts !== "number") {
+      return false;
+    }
+    if (this.attempt >= retryOptions.attempts) {
+      return false;
+    }
+    if (typeof retryOptions.shouldRetry === "function") {
+      try {
+        const allowed = await retryOptions.shouldRetry(error, this.attempt);
+        if (!allowed) {
+          return false;
+        }
+      } catch {
+        return false;
+      }
+    }
+    this.attempt++;
+    this._state = "pending" /* PENDING */;
+    return true;
+  }
   /**
    * Executes the task within an allocated concurrency slot.
    *
@@ -353,10 +580,8 @@ var TaskRunner = class {
     try {
       const result = await this.task(context);
       this._state = "completed" /* COMPLETED */;
-      this.cleanup();
       return result;
     } catch (error) {
-      this.cleanup();
       const isCancelled = this._state === "cancelled" /* CANCELLED */ || this.abortController.signal.aborted;
       if (isCancelled) {
         this._state = "cancelled" /* CANCELLED */;
@@ -454,6 +679,35 @@ var Ahko = class {
     const runner = new TaskRunner(task, options?.signal);
     return this.queue.enqueue(runner, options);
   }
+  /**
+   * Convenience method to schedule a task during platform idle opportunities.
+   *
+   * Equivalent to calling `schedule(task, { ...options, strategy: "idle" })`.
+   * In browsers, uses `requestIdleCallback` when available.
+   * In Node.js, uses `setImmediate`.
+   * Falls back to `setTimeout(..., 0)` if neither is available.
+   *
+   * @template T - Inferred return type of the task.
+   * @param task - Task function to run when idle.
+   * @param options - Scheduling options (excluding strategy).
+   * @returns A promise resolving to the task's return value.
+   *
+   * @throws {AhkoConfigurationError} If the task is not a function or options are invalid.
+   * @throws {AhkoCancellationError} If the task is cancelled prior to or during execution.
+   *
+   * @example
+   * ```typescript
+   * const result = await ahko.idle(async ({ signal }) => {
+   *   return computeAnalytics();
+   * });
+   * ```
+   */
+  idle(task, options) {
+    return this.schedule(task, {
+      ...options,
+      strategy: "idle" /* IDLE */
+    });
+  }
   /**
    * Retrieves real-time telemetry metrics from the scheduler.
    *
@@ -471,7 +725,7 @@ var Ahko = class {
 };
 
 // src/version.ts
-var VERSION = "0.1.0";
+var VERSION = "0.3.0";
 
 // src/errors/queue.error.ts
 var AhkoQueueError = class extends AhkoError {
@@ -510,8 +764,11 @@ var AhkoTimeoutError = class extends AhkoError {
   AhkoError,
   AhkoQueueError,
   AhkoTimeoutError,
+  DEFAULT_BASE_DELAY,
+  DEFAULT_MAX_DELAY,
   EScheduleStrategy,
   ETaskState,
-  VERSION
+  VERSION,
+  calculateBackoff
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors/ahko.error.ts","../src/errors/configuration.error.ts","../src/models/state.model.ts","../src/models/strategy.model.ts","../src/scheduler/task-queue.ts","../src/errors/cancellation.error.ts","../src/scheduler/task-runner.ts","../src/ahko.ts","../src/version.ts","../src/errors/queue.error.ts","../src/errors/timeout.error.ts"],"sourcesContent":["export { Ahko } from \"./ahko.js\";\nexport { VERSION } from \"./version.js\";\n\n// Errors\nexport {\n  AhkoError,\n  AhkoCancellationError,\n  AhkoConfigurationError,\n  AhkoQueueError,\n  AhkoTimeoutError,\n} from \"./errors/index.js\";\n\n// Models and interfaces\nexport {\n  ETaskState,\n  EScheduleStrategy,\n} from \"./models/index.js\";\n\nexport type {\n  ITask,\n  ITaskContext,\n  IScheduleOptions,\n  IAhkoOptions,\n  IAhkoStats,\n  TScheduleStrategy,\n} from \"./models/index.js\";\n","/**\n * Base error class for all errors originating from the Ahko scheduler.\n */\nexport class AhkoError extends Error {\n  /**\n   * Creates a new AhkoError instance.\n   *\n   * @param message - Descriptive error message.\n   * @param options - Standard Error options including cause.\n   */\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AhkoError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { AhkoError } from \"./ahko.error.js\";\n\n/**\n * Thrown when invalid configuration or scheduling options are provided.\n */\nexport class AhkoConfigurationError extends AhkoError {\n  /**\n   * Creates a new AhkoConfigurationError.\n   *\n   * @param message - Explanation of the invalid configuration parameter.\n   * @param options - Standard Error options including cause.\n   */\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AhkoConfigurationError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","/**\n * Represents the discrete lifecycle states of an Ahko task.\n */\nexport enum ETaskState {\n  /** Task has been scheduled and is awaiting execution in queue or timer */\n  PENDING = \"pending\",\n  /** Task is currently executing within an allocated concurrency slot */\n  RUNNING = \"running\",\n  /** Task successfully finished execution */\n  COMPLETED = \"completed\",\n  /** Task execution threw an error or rejected */\n  FAILED = \"failed\",\n  /** Task was cancelled via AbortSignal before or during execution */\n  CANCELLED = \"cancelled\",\n  /** Task was terminated because its execution exceeded the timeout */\n  TIMED_OUT = \"timed_out\",\n}\n","/**\n * Fundamental scheduling strategies supported by the Ahko scheduler.\n */\nexport enum EScheduleStrategy {\n  /** Execute as soon as a concurrency slot is available */\n  IMMEDIATE = \"immediate\",\n  /** Delay execution for a designated duration before queuing */\n  DELAY = \"delay\",\n}\n\n/**\n * Union type representing valid scheduling strategy identifiers.\n */\nexport type TScheduleStrategy = EScheduleStrategy | \"immediate\" | \"delay\";\n","import { AhkoConfigurationError } from \"../errors/configuration.error.js\";\nimport type { IScheduleOptions } from \"../models/options.model.js\";\nimport type { IAhkoStats } from \"../models/stats.model.js\";\nimport { ETaskState } from \"../models/state.model.js\";\nimport { EScheduleStrategy } from \"../models/strategy.model.js\";\nimport { TaskRunner } from \"./task-runner.js\";\n\n/**\n * Entry tracking delayed task timers for deterministic cancellation and memory cleanup.\n */\ninterface IDelayedEntry {\n  runner: TaskRunner<unknown>;\n  timerId: ReturnType<typeof setTimeout>;\n}\n\n/**\n * Memory-safe FIFO task queue managing concurrency allocation,\n * delayed scheduling, and task lifecycle counters.\n */\nexport class TaskQueue {\n  /** Maximum concurrent active tasks */\n  public readonly concurrency: number;\n\n  /** Queue of pending task runners waiting for a concurrency slot */\n  private readonly queue: TaskRunner<unknown>[] = [];\n\n  /** Set of task runners currently executing */\n  private readonly activeRunners = new Set<TaskRunner<unknown>>();\n\n  /** Set of tasks currently in delay phase */\n  private readonly delayedEntries = new Set<IDelayedEntry>();\n\n  /** Cumulative completed tasks counter */\n  private completedTasks = 0;\n\n  /** Cumulative failed tasks counter */\n  private failedTasks = 0;\n\n  /** Cumulative cancelled tasks counter */\n  private cancelledTasks = 0;\n\n  /** Cumulative timed out tasks counter */\n  private timedOutTasks = 0;\n\n  /**\n   * Creates a new TaskQueue.\n   *\n   * @param concurrency - Maximum concurrent tasks (defaults to Infinity).\n   * @throws {AhkoConfigurationError} If concurrency is less than 1 or not a valid number.\n   */\n  constructor(concurrency = Infinity) {\n    if (Number.isNaN(concurrency) || concurrency < 1) {\n      throw new AhkoConfigurationError(\n        `Invalid concurrency \"${concurrency}\". Must be a number greater than or equal to 1.`\n      );\n    }\n    this.concurrency = concurrency;\n  }\n\n  /**\n   * Enqueues a task runner according to the specified schedule options.\n   *\n   * @template T - The return type produced by the task.\n   * @param runner - The task runner instance.\n   * @param options - Scheduling options.\n   * @returns The deferred promise associated with the task runner.\n   * @throws {AhkoConfigurationError} If scheduling options are invalid.\n   */\n  public enqueue<T>(runner: TaskRunner<T>, options?: IScheduleOptions): Promise<T> {\n    const strategy = options?.strategy ?? EScheduleStrategy.IMMEDIATE;\n\n    if (strategy !== EScheduleStrategy.IMMEDIATE && strategy !== EScheduleStrategy.DELAY) {\n      throw new AhkoConfigurationError(\n        `Unsupported schedule strategy \"${String(strategy)}\". Supported strategies in 0.1.0: \"immediate\", \"delay\".`\n      );\n    }\n\n    if (runner.state === ETaskState.CANCELLED) {\n      this.cancelledTasks++;\n      return runner.promise;\n    }\n\n    if (strategy === EScheduleStrategy.DELAY) {\n      const delayMs = options?.delay ?? 0;\n      if (typeof delayMs !== \"number\" || Number.isNaN(delayMs) || delayMs < 0) {\n        throw new AhkoConfigurationError(\n          `Invalid delay \"${delayMs}\". Delay must be a non-negative number in milliseconds.`\n        );\n      }\n\n      this.scheduleDelayed(runner as TaskRunner<unknown>, delayMs);\n      return runner.promise;\n    }\n\n    // Attach immediate onCancel handler to dequeue without consuming concurrency\n    runner.onCancel = () => {\n      const index = this.queue.indexOf(runner as TaskRunner<unknown>);\n      if (index !== -1) {\n        this.queue.splice(index, 1);\n        this.cancelledTasks++;\n      }\n    };\n\n    // Immediate strategy: add to pending queue and pump\n    this.queue.push(runner as TaskRunner<unknown>);\n    this.pump();\n\n    return runner.promise;\n  }\n\n  /**\n   * Schedules a task to be placed into the queue after a delay,\n   * handling early cancellation safely.\n   */\n  private scheduleDelayed(runner: TaskRunner<unknown>, delayMs: number): void {\n    const delayedEntry: IDelayedEntry = {\n      runner,\n      timerId: setTimeout(() => {\n        this.delayedEntries.delete(delayedEntry);\n        if (runner.state === ETaskState.CANCELLED) {\n          return;\n        }\n\n        runner.onCancel = () => {\n          const index = this.queue.indexOf(runner);\n          if (index !== -1) {\n            this.queue.splice(index, 1);\n            this.cancelledTasks++;\n          }\n        };\n\n        this.queue.push(runner);\n        this.pump();\n      }, delayMs),\n    };\n\n    this.delayedEntries.add(delayedEntry);\n\n    runner.onCancel = () => {\n      if (this.delayedEntries.has(delayedEntry)) {\n        clearTimeout(delayedEntry.timerId);\n        this.delayedEntries.delete(delayedEntry);\n        this.cancelledTasks++;\n      }\n    };\n  }\n\n  /**\n   * Pumps the queue by picking pending tasks and executing them\n   * as long as concurrency capacity is available.\n   */\n  private pump(): void {\n    while (this.activeRunners.size < this.concurrency && this.queue.length > 0) {\n      const runner = this.queue.shift();\n      if (!runner) {\n        break;\n      }\n\n      if (runner.state === ETaskState.CANCELLED) {\n        continue;\n      }\n\n      this.activeRunners.add(runner);\n\n      // Execute runner without unhandled rejection risk\n      void this.executeRunner(runner);\n    }\n  }\n\n  /**\n   * Internal execution of an active task runner.\n   * Settle caller promise strictly after stats and active status are updated.\n   */\n  private async executeRunner(runner: TaskRunner<unknown>): Promise<void> {\n    try {\n      const result = await runner.run();\n      this.completedTasks++;\n      this.activeRunners.delete(runner);\n      runner.resolve(result);\n    } catch (error) {\n      if (runner.state === ETaskState.CANCELLED) {\n        this.cancelledTasks++;\n      } else if (runner.state === ETaskState.TIMED_OUT) {\n        this.timedOutTasks++;\n      } else {\n        this.failedTasks++;\n      }\n      this.activeRunners.delete(runner);\n      runner.reject(error);\n    } finally {\n      this.pump();\n    }\n  }\n\n  /**\n   * Returns telemetry snapshot for the scheduler.\n   *\n   * @returns Frozen snapshot of current task metrics.\n   */\n  public getStats(): IAhkoStats {\n    return Object.freeze({\n      activeTasks: this.activeRunners.size,\n      pendingTasks: this.queue.length + this.delayedEntries.size,\n      completedTasks: this.completedTasks,\n      failedTasks: this.failedTasks,\n      cancelledTasks: this.cancelledTasks,\n      timedOutTasks: this.timedOutTasks,\n      capacity: this.concurrency,\n    });\n  }\n}\n","import { AhkoError } from \"./ahko.error.js\";\n\n/**\n * Thrown when a task is cancelled before or during execution.\n */\nexport class AhkoCancellationError extends AhkoError {\n  /**\n   * Creates a new AhkoCancellationError.\n   *\n   * @param message - Reason for cancellation.\n   * @param options - Standard Error options including cause.\n   */\n  constructor(message = \"Task was cancelled\", options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AhkoCancellationError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { AhkoCancellationError } from \"../errors/cancellation.error.js\";\nimport type { ITaskContext } from \"../models/context.model.js\";\nimport { ETaskState } from \"../models/state.model.js\";\nimport type { ITask } from \"../models/task.model.js\";\n\nlet taskIdCounter = 0;\n\n/**\n * Internal task lifecycle manager responsible for execution, state transitions,\n * AbortSignal coordination, and deterministic resource cleanup.\n *\n * @template T - The return type produced by the underlying task.\n */\nexport class TaskRunner<T> {\n  /** Unique task identifier */\n  public readonly taskId: string;\n\n  /** Current lifecycle state */\n  private _state: ETaskState = ETaskState.PENDING;\n\n  /** Internal AbortController whose signal is passed to the task context */\n  private readonly abortController: AbortController;\n\n  /** The user task function to execute */\n  private readonly task: ITask<T>;\n\n  /** User-supplied AbortSignal for external cancellation */\n  private readonly externalSignal?: AbortSignal;\n\n  /** Abort event listener reference for clean detachment */\n  private readonly abortListener?: () => void;\n\n  /** Promise resolve handler */\n  private resolvePromise!: (value: T | PromiseLike<T>) => void;\n\n  /** Promise reject handler */\n  private rejectPromise!: (reason?: unknown) => void;\n\n  /** Deferred promise exposed to the caller */\n  public readonly promise: Promise<T>;\n\n  /** Callback invoked when runner is cancelled while pending */\n  public onCancel?: (runner: TaskRunner<T>) => void;\n\n  /**\n   * Creates a new TaskRunner instance.\n   *\n   * @param task - The asynchronous work unit to run.\n   * @param externalSignal - Optional external AbortSignal to propagate.\n   */\n  constructor(task: ITask<T>, externalSignal?: AbortSignal) {\n    this.taskId = `task_${Date.now().toString(36)}_${(++taskIdCounter).toString(36)}_${Math.random().toString(36).slice(2, 6)}`;\n    this.task = task;\n    this.externalSignal = externalSignal;\n    this.abortController = new AbortController();\n\n    this.promise = new Promise<T>((resolve, reject) => {\n      this.resolvePromise = resolve;\n      this.rejectPromise = reject;\n    });\n\n    if (this.externalSignal) {\n      if (this.externalSignal.aborted) {\n        this._state = ETaskState.CANCELLED;\n        const reason = this.externalSignal.reason;\n        const cancelError = new AhkoCancellationError(\n          typeof reason === \"string\" ? reason : \"Task was cancelled prior to execution\",\n          { cause: reason instanceof Error ? reason : undefined }\n        );\n        this.rejectPromise(cancelError);\n      } else {\n        this.abortListener = () => {\n          this.handleExternalAbort();\n        };\n        this.externalSignal.addEventListener(\"abort\", this.abortListener, { once: true });\n      }\n    }\n  }\n\n  /**\n   * Gets the current lifecycle state of the task.\n   */\n  public get state(): ETaskState {\n    return this._state;\n  }\n\n  /**\n   * Resolves the deferred promise.\n   *\n   * @param value - Value to resolve with.\n   */\n  public resolve(value: T): void {\n    this.resolvePromise(value);\n  }\n\n  /**\n   * Rejects the deferred promise.\n   *\n   * @param reason - Reason to reject with.\n   */\n  public reject(reason: unknown): void {\n    this.rejectPromise(reason);\n  }\n\n  /**\n   * Executes the task within an allocated concurrency slot.\n   *\n   * @returns A promise resolving to the task result or rejecting on failure/cancellation.\n   */\n  public async run(): Promise<T> {\n    if (this._state === ETaskState.CANCELLED) {\n      throw new AhkoCancellationError(\"Task was cancelled prior to execution\");\n    }\n\n    this._state = ETaskState.RUNNING;\n\n    const context: ITaskContext = {\n      signal: this.abortController.signal,\n      taskId: this.taskId,\n    };\n\n    try {\n      const result = await this.task(context);\n      this._state = ETaskState.COMPLETED;\n      this.cleanup();\n      return result;\n    } catch (error) {\n      this.cleanup();\n\n      const isCancelled =\n        (this._state as ETaskState) === ETaskState.CANCELLED ||\n        this.abortController.signal.aborted;\n\n      if (isCancelled) {\n        this._state = ETaskState.CANCELLED;\n        throw new AhkoCancellationError(\"Task was cancelled during execution\", {\n          cause: error instanceof Error ? error : undefined,\n        });\n      }\n\n      this._state = ETaskState.FAILED;\n      throw error;\n    }\n  }\n\n  /**\n   * Cancels the task, aborting pending or running execution.\n   *\n   * @param reason - Optional cancellation reason.\n   */\n  public cancel(reason?: unknown): void {\n    if (\n      this._state === ETaskState.COMPLETED ||\n      this._state === ETaskState.FAILED ||\n      this._state === ETaskState.CANCELLED ||\n      this._state === ETaskState.TIMED_OUT\n    ) {\n      return;\n    }\n\n    const wasPending = this._state === ETaskState.PENDING;\n    this._state = ETaskState.CANCELLED;\n    this.abortController.abort(reason);\n    this.cleanup();\n\n    if (wasPending) {\n      const cancellationError = new AhkoCancellationError(\n        typeof reason === \"string\" ? reason : \"Task was cancelled prior to execution\",\n        { cause: reason instanceof Error ? reason : undefined }\n      );\n      this.rejectPromise(cancellationError);\n      this.onCancel?.(this);\n    }\n  }\n\n  /**\n   * Handles external AbortSignal trigger.\n   */\n  private handleExternalAbort(): void {\n    this.cancel(this.externalSignal?.reason);\n  }\n\n  /**\n   * Detaches event listeners from external signal to guarantee memory safety.\n   */\n  public cleanup(): void {\n    if (this.externalSignal && this.abortListener) {\n      this.externalSignal.removeEventListener(\"abort\", this.abortListener);\n    }\n  }\n}\n","import { AhkoConfigurationError } from \"./errors/configuration.error.js\";\nimport type { IAhkoOptions, IScheduleOptions } from \"./models/options.model.js\";\nimport type { IAhkoStats } from \"./models/stats.model.js\";\nimport type { ITask } from \"./models/task.model.js\";\nimport { TaskQueue } from \"./scheduler/task-queue.js\";\nimport { TaskRunner } from \"./scheduler/task-runner.js\";\n\n/**\n * Ahko — Low-energy, production-grade asynchronous task scheduler.\n *\n * Coordinates execution timing, enforces concurrency limits, and cooperates\n * natively with AbortSignal cancellation.\n *\n * @example\n * ```typescript\n * import { Ahko } from \"@mrjacket/ahko\";\n *\n * const ahko = new Ahko({ concurrency: 2 });\n *\n * const result = await ahko.schedule(async ({ signal, taskId }) => {\n *   const res = await fetch(\"https://api.example.com\", { signal });\n *   return res.json();\n * });\n * ```\n */\nexport class Ahko {\n  /** Internal queue and concurrency manager */\n  private readonly queue: TaskQueue;\n\n  /**\n   * Initializes a new Ahko scheduler instance.\n   *\n   * @param options - Optional scheduler configuration.\n   * @throws {AhkoConfigurationError} If concurrency is invalid (less than 1 or NaN).\n   *\n   * @example\n   * ```typescript\n   * const ahko = new Ahko({ concurrency: 4 });\n   * ```\n   */\n  constructor(options?: IAhkoOptions) {\n    this.queue = new TaskQueue(options?.concurrency);\n  }\n\n  /**\n   * Schedules a task for execution with full return type inference.\n   *\n   * @template T - Inferred return type of the task.\n   * @param task - Asynchronous or synchronous task function accepting an {@link ITaskContext}.\n   * @param options - Task-specific scheduling options such as strategy, delay, and cancellation signal.\n   * @returns A promise that resolves with the task's return value.\n   *\n   * @throws {AhkoConfigurationError} If the task is not a function or options are invalid.\n   * @throws {AhkoCancellationError} If the task is cancelled prior to or during execution.\n   *\n   * @example\n   * ```typescript\n   * // Immediate execution (subject to concurrency)\n   * const count = await ahko.schedule(async () => 42);\n   *\n   * // Delayed execution\n   * await ahko.schedule(\n   *   async ({ signal }) => doWork({ signal }),\n   *   { strategy: \"delay\", delay: 1000 }\n   * );\n   * ```\n   */\n  public schedule<T>(task: ITask<T>, options?: IScheduleOptions): Promise<T> {\n    if (typeof task !== \"function\") {\n      throw new AhkoConfigurationError(\"Task must be a valid function.\");\n    }\n\n    const runner = new TaskRunner<T>(task, options?.signal);\n    return this.queue.enqueue(runner, options);\n  }\n\n  /**\n   * Retrieves real-time telemetry metrics from the scheduler.\n   *\n   * @returns An {@link IAhkoStats} snapshot of active, pending, completed, failed, cancelled, and timed out tasks.\n   *\n   * @example\n   * ```typescript\n   * const stats = ahko.stats();\n   * console.log(`Active: ${stats.activeTasks}, Pending: ${stats.pendingTasks}`);\n   * ```\n   */\n  public stats(): IAhkoStats {\n    return this.queue.getStats();\n  }\n}\n","/**\n * Current version of @mrjacket/ahko package.\n */\nexport const VERSION = \"0.1.0\";\n","import { AhkoError } from \"./ahko.error.js\";\n\n/**\n * Thrown when an internal queue invariant is violated or queue limits are breached.\n */\nexport class AhkoQueueError extends AhkoError {\n  /**\n   * Creates a new AhkoQueueError.\n   *\n   * @param message - Explanation of the queue failure.\n   * @param options - Standard Error options including cause.\n   */\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AhkoQueueError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { AhkoError } from \"./ahko.error.js\";\n\n/**\n * Thrown when a task exceeds its allotted timeout duration.\n */\nexport class AhkoTimeoutError extends AhkoError {\n  /**\n   * Creates a new AhkoTimeoutError.\n   *\n   * @param message - Explanation of timeout expiry.\n   * @param options - Standard Error options including cause.\n   */\n  constructor(message = \"Task execution timed out\", options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AhkoTimeoutError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n"],"mappings":"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","names":["ETaskState","EScheduleStrategy"]}
+{"version":3,"sources":["../src/index.ts","../src/errors/ahko.error.ts","../src/errors/configuration.error.ts","../src/models/strategy.model.ts","../src/models/state.model.ts","../src/retry/backoff.ts","../src/scheduler/idle-scheduler.ts","../src/scheduler/task-queue.ts","../src/errors/cancellation.error.ts","../src/scheduler/task-runner.ts","../src/ahko.ts","../src/version.ts","../src/errors/queue.error.ts","../src/errors/timeout.error.ts"],"sourcesContent":["export { Ahko } from \"./ahko.js\";\nexport { VERSION } from \"./version.js\";\n\n// Errors\nexport {\n  AhkoError,\n  AhkoCancellationError,\n  AhkoConfigurationError,\n  AhkoQueueError,\n  AhkoTimeoutError,\n} from \"./errors/index.js\";\n\n// Models and interfaces\nexport {\n  ETaskState,\n  EScheduleStrategy,\n} from \"./models/index.js\";\n\nexport type {\n  ITask,\n  ITaskContext,\n  IScheduleOptions,\n  IAhkoOptions,\n  IAhkoStats,\n  TScheduleStrategy,\n  IRetryOptions,\n  TRetryBackoff,\n  TRetryPredicate,\n} from \"./models/index.js\";\n\n// Retry utilities\nexport {\n  calculateBackoff,\n  DEFAULT_BASE_DELAY,\n  DEFAULT_MAX_DELAY,\n} from \"./retry/index.js\";\n","/**\n * Base error class for all errors originating from the Ahko scheduler.\n */\nexport class AhkoError extends Error {\n  /**\n   * Creates a new AhkoError instance.\n   *\n   * @param message - Descriptive error message.\n   * @param options - Standard Error options including cause.\n   */\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AhkoError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { AhkoError } from \"./ahko.error.js\";\n\n/**\n * Thrown when invalid configuration or scheduling options are provided.\n */\nexport class AhkoConfigurationError extends AhkoError {\n  /**\n   * Creates a new AhkoConfigurationError.\n   *\n   * @param message - Explanation of the invalid configuration parameter.\n   * @param options - Standard Error options including cause.\n   */\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AhkoConfigurationError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","/**\n * Fundamental scheduling strategies supported by the Ahko scheduler.\n */\nexport enum EScheduleStrategy {\n  /** Execute as soon as a concurrency slot is available */\n  IMMEDIATE = \"immediate\",\n  /** Delay execution for a designated duration before queuing */\n  DELAY = \"delay\",\n  /** Execute during platform idle opportunities (requestIdleCallback in browser, setImmediate in Node.js) */\n  IDLE = \"idle\",\n}\n\n/**\n * Union type representing valid scheduling strategy identifiers.\n */\nexport type TScheduleStrategy = EScheduleStrategy | \"immediate\" | \"delay\" | \"idle\";\n","/**\n * Represents the discrete lifecycle states of an Ahko task.\n */\nexport enum ETaskState {\n  /** Task has been scheduled and is awaiting execution in queue or timer */\n  PENDING = \"pending\",\n  /** Task is currently executing within an allocated concurrency slot */\n  RUNNING = \"running\",\n  /** Task successfully finished execution */\n  COMPLETED = \"completed\",\n  /** Task execution threw an error or rejected */\n  FAILED = \"failed\",\n  /** Task was cancelled via AbortSignal before or during execution */\n  CANCELLED = \"cancelled\",\n  /** Task was terminated because its execution exceeded the timeout */\n  TIMED_OUT = \"timed_out\",\n}\n","import type { IRetryOptions } from \"../models/retry.model.js\";\n\n/**\n * Default base delay for backoff calculations in milliseconds.\n */\nexport const DEFAULT_BASE_DELAY = 250;\n\n/**\n * Default maximum delay ceiling for backoff calculations in milliseconds.\n */\nexport const DEFAULT_MAX_DELAY = 10_000;\n\n/**\n * Computes backoff delay in milliseconds for a retry attempt based on configured policy.\n *\n * @param attempt - 1-based index of the attempt that failed (1 for first failure, 2 for second, etc.).\n * @param options - Retry configuration options.\n * @param randomFn - Injectable random generator function (defaults to Math.random) for deterministic testing.\n * @returns Delay duration in milliseconds before next attempt.\n */\nexport function calculateBackoff(\n  attempt: number,\n  options?: IRetryOptions,\n  randomFn: () => number = Math.random\n): number {\n  const backoff = options?.backoff ?? \"exponential\";\n\n  if (backoff === \"none\") {\n    return 0;\n  }\n\n  const baseDelay =\n    typeof options?.baseDelay === \"number\" && !Number.isNaN(options.baseDelay) && options.baseDelay >= 0\n      ? options.baseDelay\n      : DEFAULT_BASE_DELAY;\n\n  const maxDelay =\n    typeof options?.maxDelay === \"number\" && !Number.isNaN(options.maxDelay) && options.maxDelay >= baseDelay\n      ? options.maxDelay\n      : Math.max(DEFAULT_MAX_DELAY, baseDelay);\n\n  let calculatedDelay: number;\n\n  if (backoff === \"linear\") {\n    calculatedDelay = baseDelay * Math.max(1, attempt);\n  } else {\n    // exponential: baseDelay * 2^(attempt - 1)\n    const exponent = Math.max(0, attempt - 1);\n    // Prevent 2^exponent overflow\n    const factor = exponent > 30 ? 2 ** 30 : 2 ** exponent;\n    calculatedDelay = baseDelay * factor;\n  }\n\n  const cappedDelay = Math.min(calculatedDelay, maxDelay);\n\n  if (options?.jitter) {\n    // Full jitter: uniformly random between 0 and cappedDelay\n    return Math.floor(randomFn() * (cappedDelay + 1));\n  }\n\n  return Math.floor(cappedDelay);\n}\n","/**\n * Handle returned by the IdleScheduler allowing cancellation of an idle request.\n */\nexport interface IIdleHandle {\n  /**\n   * Cancels the scheduled idle callback and cleans up platform resources.\n   */\n  cancel(): void;\n}\n\n/**\n * Platform-agnostic scheduler for opportunistic idle task execution.\n *\n * Automatically detects and selects platform capabilities:\n * 1. Browser: `requestIdleCallback` / `cancelIdleCallback` (with optional timeout)\n * 2. Node.js: `setImmediate` / `clearImmediate` as low-priority primitive\n * 3. Fallback: `setTimeout(..., 0)` / `clearTimeout`\n */\nexport class IdleScheduler {\n  /**\n   * Schedules a callback to execute during the next idle opportunity.\n   *\n   * @param callback - Function to invoke when idle opportunity arises.\n   * @param timeout - Optional max deadline in milliseconds to wait before invoking (browser only).\n   * @param runtime - Target runtime scope providing scheduling primitives (defaults to globalThis).\n   * @returns An {@link IIdleHandle} with a `cancel()` method for cleanup.\n   */\n  public static schedule(\n    callback: () => void,\n    timeout?: number,\n    runtime: typeof globalThis = globalThis\n  ): IIdleHandle {\n    // 1. Browser requestIdleCallback\n    if (\n      typeof (runtime as Record<string, unknown>).requestIdleCallback === \"function\" &&\n      typeof (runtime as Record<string, unknown>).cancelIdleCallback === \"function\"\n    ) {\n      const requestFn = (runtime as Record<string, unknown>).requestIdleCallback as (\n        cb: (deadline?: unknown) => void,\n        opts?: { timeout?: number }\n      ) => number;\n\n      const cancelFn = (runtime as Record<string, unknown>).cancelIdleCallback as (\n        handle: number\n      ) => void;\n\n      const id = requestFn(\n        () => callback(),\n        typeof timeout === \"number\" && !Number.isNaN(timeout) && timeout >= 0\n          ? { timeout }\n          : undefined\n      );\n\n      return {\n        cancel: () => cancelFn(id),\n      };\n    }\n\n    // 2. Node.js setImmediate\n    if (\n      typeof (runtime as Record<string, unknown>).setImmediate === \"function\" &&\n      typeof (runtime as Record<string, unknown>).clearImmediate === \"function\"\n    ) {\n      const setImmFn = (runtime as Record<string, unknown>).setImmediate as (\n        cb: () => void\n      ) => ReturnType<typeof setImmediate>;\n\n      const clearImmFn = (runtime as Record<string, unknown>).clearImmediate as (\n        handle: ReturnType<typeof setImmediate>\n      ) => void;\n\n      const handle = setImmFn(() => callback());\n\n      return {\n        cancel: () => clearImmFn(handle),\n      };\n    }\n\n    // 3. Universal fallback setTimeout(0)\n    const setTimerFn = runtime.setTimeout.bind(runtime);\n    const clearTimerFn = runtime.clearTimeout.bind(runtime);\n\n    const timerId = setTimerFn(() => callback(), 0);\n\n    return {\n      cancel: () => clearTimerFn(timerId),\n    };\n  }\n}\n","import { AhkoConfigurationError } from \"../errors/configuration.error.js\";\nimport type { IScheduleOptions } from \"../models/options.model.js\";\nimport type { IAhkoStats } from \"../models/stats.model.js\";\nimport { ETaskState } from \"../models/state.model.js\";\nimport { EScheduleStrategy } from \"../models/strategy.model.js\";\nimport { calculateBackoff } from \"../retry/backoff.js\";\nimport { IdleScheduler, type IIdleHandle } from \"./idle-scheduler.js\";\nimport { TaskRunner } from \"./task-runner.js\";\n\n/**\n * Entry tracking delayed task timers for deterministic cancellation and memory cleanup.\n */\ninterface IDelayedEntry {\n  runner: TaskRunner<unknown>;\n  timerId: ReturnType<typeof setTimeout>;\n}\n\n/**\n * Entry tracking idle callback handles for deterministic cancellation and cleanup.\n */\ninterface IIdleEntry {\n  runner: TaskRunner<unknown>;\n  handle: IIdleHandle;\n}\n\n/**\n * Entry tracking backoff delay timers for retry attempts.\n */\ninterface IRetryEntry {\n  runner: TaskRunner<unknown>;\n  timerId: ReturnType<typeof setTimeout>;\n}\n\n/**\n * Memory-safe FIFO task queue managing concurrency allocation,\n * delayed scheduling, and task lifecycle counters.\n */\nexport class TaskQueue {\n  /** Maximum concurrent active tasks */\n  public readonly concurrency: number;\n\n  /** Queue of pending task runners waiting for a concurrency slot */\n  private readonly queue: TaskRunner<unknown>[] = [];\n\n  /** Set of task runners currently executing */\n  private readonly activeRunners = new Set<TaskRunner<unknown>>();\n\n  /** Set of tasks currently in delay phase */\n  private readonly delayedEntries = new Set<IDelayedEntry>();\n\n  /** Set of tasks currently awaiting an idle opportunity */\n  private readonly idleEntries = new Set<IIdleEntry>();\n\n  /** Set of tasks currently awaiting a retry backoff timer */\n  private readonly retryEntries = new Set<IRetryEntry>();\n\n  /** WeakMap associating task runners with their scheduling options */\n  private readonly runnerOptions = new WeakMap<TaskRunner<unknown>, IScheduleOptions>();\n\n  /** Cumulative completed tasks counter */\n  private completedTasks = 0;\n\n  /** Cumulative failed tasks counter */\n  private failedTasks = 0;\n\n  /** Cumulative cancelled tasks counter */\n  private cancelledTasks = 0;\n\n  /** Cumulative timed out tasks counter */\n  private timedOutTasks = 0;\n\n  /**\n   * Creates a new TaskQueue.\n   *\n   * @param concurrency - Maximum concurrent tasks (defaults to Infinity).\n   * @throws {AhkoConfigurationError} If concurrency is less than 1 or not a valid number.\n   */\n  constructor(concurrency = Infinity) {\n    if (Number.isNaN(concurrency) || concurrency < 1) {\n      throw new AhkoConfigurationError(\n        `Invalid concurrency \"${concurrency}\". Must be a number greater than or equal to 1.`\n      );\n    }\n    this.concurrency = concurrency;\n  }\n\n  /**\n   * Enqueues a task runner according to the specified schedule options.\n   *\n   * @template T - The return type produced by the task.\n   * @param runner - The task runner instance.\n   * @param options - Scheduling options.\n   * @returns The deferred promise associated with the task runner.\n   * @throws {AhkoConfigurationError} If scheduling options are invalid.\n   */\n  public enqueue<T>(runner: TaskRunner<T>, options?: IScheduleOptions): Promise<T> {\n    const strategy = options?.strategy ?? EScheduleStrategy.IMMEDIATE;\n\n    if (\n      strategy !== EScheduleStrategy.IMMEDIATE &&\n      strategy !== EScheduleStrategy.DELAY &&\n      strategy !== EScheduleStrategy.IDLE\n    ) {\n      throw new AhkoConfigurationError(\n        `Unsupported schedule strategy \"${String(strategy)}\". Supported strategies: \"immediate\", \"delay\", \"idle\".`\n      );\n    }\n\n    if (options?.retry) {\n      if (\n        typeof options.retry.attempts !== \"number\" ||\n        Number.isNaN(options.retry.attempts) ||\n        options.retry.attempts < 1 ||\n        !Number.isInteger(options.retry.attempts)\n      ) {\n        throw new AhkoConfigurationError(\n          `Invalid retry attempts \"${options.retry.attempts}\". attempts must be an integer greater than or equal to 1.`\n        );\n      }\n\n      if (\n        options.retry.baseDelay !== undefined &&\n        (typeof options.retry.baseDelay !== \"number\" ||\n          Number.isNaN(options.retry.baseDelay) ||\n          options.retry.baseDelay < 0)\n      ) {\n        throw new AhkoConfigurationError(\n          `Invalid retry baseDelay \"${options.retry.baseDelay}\". baseDelay must be a non-negative number in milliseconds.`\n        );\n      }\n\n      if (\n        options.retry.maxDelay !== undefined &&\n        (typeof options.retry.maxDelay !== \"number\" ||\n          Number.isNaN(options.retry.maxDelay) ||\n          options.retry.maxDelay < 0)\n      ) {\n        throw new AhkoConfigurationError(\n          `Invalid retry maxDelay \"${options.retry.maxDelay}\". maxDelay must be a non-negative number in milliseconds.`\n        );\n      }\n    }\n\n    if (options) {\n      this.runnerOptions.set(runner as TaskRunner<unknown>, options);\n    }\n\n    if (runner.state === ETaskState.CANCELLED) {\n      this.cancelledTasks++;\n      return runner.promise;\n    }\n\n    if (strategy === EScheduleStrategy.DELAY) {\n      const delayMs = options?.delay ?? 0;\n      if (typeof delayMs !== \"number\" || Number.isNaN(delayMs) || delayMs < 0) {\n        throw new AhkoConfigurationError(\n          `Invalid delay \"${delayMs}\". Delay must be a non-negative number in milliseconds.`\n        );\n      }\n\n      this.scheduleDelayed(runner as TaskRunner<unknown>, delayMs);\n      return runner.promise;\n    }\n\n    if (strategy === EScheduleStrategy.IDLE) {\n      if (\n        options?.idleTimeout !== undefined &&\n        (typeof options.idleTimeout !== \"number\" ||\n          Number.isNaN(options.idleTimeout) ||\n          options.idleTimeout < 0)\n      ) {\n        throw new AhkoConfigurationError(\n          `Invalid idleTimeout \"${options.idleTimeout}\". idleTimeout must be a non-negative number in milliseconds.`\n        );\n      }\n\n      this.scheduleIdle(runner as TaskRunner<unknown>, options?.idleTimeout);\n      return runner.promise;\n    }\n\n    // Attach immediate onCancel handler to dequeue without consuming concurrency\n    runner.onCancel = () => {\n      const index = this.queue.indexOf(runner as TaskRunner<unknown>);\n      if (index !== -1) {\n        this.queue.splice(index, 1);\n        this.cancelledTasks++;\n      }\n    };\n\n    // Immediate strategy: add to pending queue and pump\n    this.queue.push(runner as TaskRunner<unknown>);\n    this.pump();\n\n    return runner.promise;\n  }\n\n  /**\n   * Schedules a task to be placed into the queue after a delay,\n   * handling early cancellation safely.\n   */\n  private scheduleDelayed(runner: TaskRunner<unknown>, delayMs: number): void {\n    const delayedEntry: IDelayedEntry = {\n      runner,\n      timerId: setTimeout(() => {\n        this.delayedEntries.delete(delayedEntry);\n        if (runner.state === ETaskState.CANCELLED) {\n          return;\n        }\n\n        runner.onCancel = () => {\n          const index = this.queue.indexOf(runner);\n          if (index !== -1) {\n            this.queue.splice(index, 1);\n            this.cancelledTasks++;\n          }\n        };\n\n        this.queue.push(runner);\n        this.pump();\n      }, delayMs),\n    };\n\n    this.delayedEntries.add(delayedEntry);\n\n    runner.onCancel = () => {\n      if (this.delayedEntries.has(delayedEntry)) {\n        clearTimeout(delayedEntry.timerId);\n        this.delayedEntries.delete(delayedEntry);\n        this.cancelledTasks++;\n      }\n    };\n  }\n\n  /**\n   * Schedules a task to be placed into the queue during an idle opportunity,\n   * handling early cancellation safely.\n   */\n  private scheduleIdle(runner: TaskRunner<unknown>, idleTimeout?: number): void {\n    let idleEntry!: IIdleEntry;\n\n    const handle = IdleScheduler.schedule(() => {\n      this.idleEntries.delete(idleEntry);\n      if (runner.state === ETaskState.CANCELLED) {\n        return;\n      }\n\n      runner.onCancel = () => {\n        const index = this.queue.indexOf(runner);\n        if (index !== -1) {\n          this.queue.splice(index, 1);\n          this.cancelledTasks++;\n        }\n      };\n\n      this.queue.push(runner);\n      this.pump();\n    }, idleTimeout);\n\n    idleEntry = { runner, handle };\n    this.idleEntries.add(idleEntry);\n\n    runner.onCancel = () => {\n      if (this.idleEntries.has(idleEntry)) {\n        handle.cancel();\n        this.idleEntries.delete(idleEntry);\n        this.cancelledTasks++;\n      }\n    };\n  }\n\n  /**\n   * Pumps the queue by picking pending tasks and executing them\n   * as long as concurrency capacity is available.\n   */\n  private pump(): void {\n    while (this.activeRunners.size < this.concurrency && this.queue.length > 0) {\n      const runner = this.queue.shift();\n      if (!runner) {\n        break;\n      }\n\n      if (runner.state === ETaskState.CANCELLED) {\n        continue;\n      }\n\n      this.activeRunners.add(runner);\n\n      // Execute runner without unhandled rejection risk\n      void this.executeRunner(runner);\n    }\n  }\n\n  /**\n   * Internal execution of an active task runner.\n   */\n  private async executeRunner(runner: TaskRunner<unknown>): Promise<void> {\n    const options = this.runnerOptions.get(runner);\n\n    try {\n      const result = await runner.run();\n      this.completedTasks++;\n      this.activeRunners.delete(runner);\n      this.runnerOptions.delete(runner);\n      runner.resolve(result);\n    } catch (error) {\n      if (runner.state === ETaskState.CANCELLED) {\n        this.cancelledTasks++;\n        this.activeRunners.delete(runner);\n        this.runnerOptions.delete(runner);\n        runner.reject(error);\n        return;\n      }\n\n      const shouldRetry = await runner.canRetry(error, options?.retry);\n      if (shouldRetry) {\n        // Free concurrency slot immediately during backoff\n        this.activeRunners.delete(runner);\n        this.scheduleRetry(runner, options);\n        return;\n      }\n\n      if (runner.state === ETaskState.TIMED_OUT) {\n        this.timedOutTasks++;\n      } else {\n        this.failedTasks++;\n      }\n      this.activeRunners.delete(runner);\n      this.runnerOptions.delete(runner);\n      runner.reject(error);\n    } finally {\n      this.pump();\n    }\n  }\n\n  /**\n   * Schedules a retry attempt following backoff delay,\n   * without holding a concurrency slot.\n   */\n  private scheduleRetry(runner: TaskRunner<unknown>, options?: IScheduleOptions): void {\n    const backoffDelay = calculateBackoff(runner.attempt - 1, options?.retry);\n\n    if (backoffDelay === 0) {\n      runner.onCancel = () => {\n        const index = this.queue.indexOf(runner);\n        if (index !== -1) {\n          this.queue.splice(index, 1);\n          this.cancelledTasks++;\n        }\n      };\n      this.queue.push(runner);\n      this.pump();\n      return;\n    }\n\n    const retryEntry: IRetryEntry = {\n      runner,\n      timerId: setTimeout(() => {\n        this.retryEntries.delete(retryEntry);\n        if (runner.state === ETaskState.CANCELLED) {\n          return;\n        }\n\n        runner.onCancel = () => {\n          const index = this.queue.indexOf(runner);\n          if (index !== -1) {\n            this.queue.splice(index, 1);\n            this.cancelledTasks++;\n          }\n        };\n\n        this.queue.push(runner);\n        this.pump();\n      }, backoffDelay),\n    };\n\n    this.retryEntries.add(retryEntry);\n\n    runner.onCancel = () => {\n      if (this.retryEntries.has(retryEntry)) {\n        clearTimeout(retryEntry.timerId);\n        this.retryEntries.delete(retryEntry);\n        this.cancelledTasks++;\n      }\n    };\n  }\n\n  /**\n   * Returns telemetry snapshot for the scheduler.\n   *\n   * @returns Frozen snapshot of current task metrics.\n   */\n  public getStats(): IAhkoStats {\n    return Object.freeze({\n      activeTasks: this.activeRunners.size,\n      pendingTasks:\n        this.queue.length +\n        this.delayedEntries.size +\n        this.idleEntries.size +\n        this.retryEntries.size,\n      completedTasks: this.completedTasks,\n      failedTasks: this.failedTasks,\n      cancelledTasks: this.cancelledTasks,\n      timedOutTasks: this.timedOutTasks,\n      capacity: this.concurrency,\n    });\n  }\n}\n","import { AhkoError } from \"./ahko.error.js\";\n\n/**\n * Thrown when a task is cancelled before or during execution.\n */\nexport class AhkoCancellationError extends AhkoError {\n  /**\n   * Creates a new AhkoCancellationError.\n   *\n   * @param message - Reason for cancellation.\n   * @param options - Standard Error options including cause.\n   */\n  constructor(message = \"Task was cancelled\", options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AhkoCancellationError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { AhkoCancellationError } from \"../errors/cancellation.error.js\";\nimport type { ITaskContext } from \"../models/context.model.js\";\nimport type { IRetryOptions } from \"../models/retry.model.js\";\nimport { ETaskState } from \"../models/state.model.js\";\nimport type { ITask } from \"../models/task.model.js\";\n\nlet taskIdCounter = 0;\n\n/**\n * Internal task lifecycle manager responsible for execution, state transitions,\n * AbortSignal coordination, and deterministic resource cleanup.\n *\n * @template T - The return type produced by the underlying task.\n */\nexport class TaskRunner<T> {\n  /** Unique task identifier */\n  public readonly taskId: string;\n\n  /** Current lifecycle state */\n  private _state: ETaskState = ETaskState.PENDING;\n\n  /** Internal AbortController whose signal is passed to the task context */\n  private readonly abortController: AbortController;\n\n  /** The user task function to execute */\n  private readonly task: ITask<T>;\n\n  /** User-supplied AbortSignal for external cancellation */\n  private readonly externalSignal?: AbortSignal;\n\n  /** Abort event listener reference for clean detachment */\n  private readonly abortListener?: () => void;\n\n  /** Promise resolve handler */\n  private resolvePromise!: (value: T | PromiseLike<T>) => void;\n\n  /** Promise reject handler */\n  private rejectPromise!: (reason?: unknown) => void;\n\n  /** Deferred promise exposed to the caller */\n  public readonly promise: Promise<T>;\n\n  /** Callback invoked when runner is cancelled while pending */\n  public onCancel?: (runner: TaskRunner<T>) => void;\n\n  /**\n   * Creates a new TaskRunner instance.\n   *\n   * @param task - The asynchronous work unit to run.\n   * @param externalSignal - Optional external AbortSignal to propagate.\n   */\n  constructor(task: ITask<T>, externalSignal?: AbortSignal) {\n    this.taskId = `task_${Date.now().toString(36)}_${(++taskIdCounter).toString(36)}_${Math.random().toString(36).slice(2, 6)}`;\n    this.task = task;\n    this.externalSignal = externalSignal;\n    this.abortController = new AbortController();\n\n    this.promise = new Promise<T>((resolve, reject) => {\n      this.resolvePromise = resolve;\n      this.rejectPromise = reject;\n    });\n\n    if (this.externalSignal) {\n      if (this.externalSignal.aborted) {\n        this._state = ETaskState.CANCELLED;\n        const reason = this.externalSignal.reason;\n        const cancelError = new AhkoCancellationError(\n          typeof reason === \"string\" ? reason : \"Task was cancelled prior to execution\",\n          { cause: reason instanceof Error ? reason : undefined }\n        );\n        this.rejectPromise(cancelError);\n      } else {\n        this.abortListener = () => {\n          this.handleExternalAbort();\n        };\n        this.externalSignal.addEventListener(\"abort\", this.abortListener, { once: true });\n      }\n    }\n  }\n\n  /**\n   * Gets the current lifecycle state of the task.\n   */\n  public get state(): ETaskState {\n    return this._state;\n  }\n\n  /** Current execution attempt count (1-indexed) */\n  public attempt = 1;\n\n  /**\n   * Resolves the deferred promise.\n   *\n   * @param value - Value to resolve with.\n   */\n  public resolve(value: T): void {\n    this.cleanup();\n    this.resolvePromise(value);\n  }\n\n  /**\n   * Rejects the deferred promise.\n   *\n   * @param reason - Reason to reject with.\n   */\n  public reject(reason: unknown): void {\n    this.cleanup();\n    this.rejectPromise(reason);\n  }\n\n  /**\n   * Evaluates if the task should be retried following an execution failure.\n   *\n   * @param error - The error encountered during the attempt.\n   * @param retryOptions - Configured retry policy.\n   * @returns A promise resolving to true if retry should proceed, false otherwise.\n   */\n  public async canRetry(error: unknown, retryOptions?: IRetryOptions): Promise<boolean> {\n    if (this._state === ETaskState.CANCELLED || this.abortController.signal.aborted) {\n      return false;\n    }\n\n    if (!retryOptions || typeof retryOptions.attempts !== \"number\") {\n      return false;\n    }\n\n    if (this.attempt >= retryOptions.attempts) {\n      return false;\n    }\n\n    if (typeof retryOptions.shouldRetry === \"function\") {\n      try {\n        const allowed = await retryOptions.shouldRetry(error, this.attempt);\n        if (!allowed) {\n          return false;\n        }\n      } catch {\n        return false;\n      }\n    }\n\n    this.attempt++;\n    this._state = ETaskState.PENDING;\n    return true;\n  }\n\n  /**\n   * Executes the task within an allocated concurrency slot.\n   *\n   * @returns A promise resolving to the task result or rejecting on failure/cancellation.\n   */\n  public async run(): Promise<T> {\n    if (this._state === ETaskState.CANCELLED) {\n      throw new AhkoCancellationError(\"Task was cancelled prior to execution\");\n    }\n\n    this._state = ETaskState.RUNNING;\n\n    const context: ITaskContext = {\n      signal: this.abortController.signal,\n      taskId: this.taskId,\n    };\n\n    try {\n      const result = await this.task(context);\n      this._state = ETaskState.COMPLETED;\n      return result;\n    } catch (error) {\n      const isCancelled =\n        (this._state as ETaskState) === ETaskState.CANCELLED ||\n        this.abortController.signal.aborted;\n\n      if (isCancelled) {\n        this._state = ETaskState.CANCELLED;\n        throw new AhkoCancellationError(\"Task was cancelled during execution\", {\n          cause: error instanceof Error ? error : undefined,\n        });\n      }\n\n      this._state = ETaskState.FAILED;\n      throw error;\n    }\n  }\n\n  /**\n   * Cancels the task, aborting pending or running execution.\n   *\n   * @param reason - Optional cancellation reason.\n   */\n  public cancel(reason?: unknown): void {\n    if (\n      this._state === ETaskState.COMPLETED ||\n      this._state === ETaskState.FAILED ||\n      this._state === ETaskState.CANCELLED ||\n      this._state === ETaskState.TIMED_OUT\n    ) {\n      return;\n    }\n\n    const wasPending = this._state === ETaskState.PENDING;\n    this._state = ETaskState.CANCELLED;\n    this.abortController.abort(reason);\n    this.cleanup();\n\n    if (wasPending) {\n      const cancellationError = new AhkoCancellationError(\n        typeof reason === \"string\" ? reason : \"Task was cancelled prior to execution\",\n        { cause: reason instanceof Error ? reason : undefined }\n      );\n      this.rejectPromise(cancellationError);\n      this.onCancel?.(this);\n    }\n  }\n\n  /**\n   * Handles external AbortSignal trigger.\n   */\n  private handleExternalAbort(): void {\n    this.cancel(this.externalSignal?.reason);\n  }\n\n  /**\n   * Detaches event listeners from external signal to guarantee memory safety.\n   */\n  public cleanup(): void {\n    if (this.externalSignal && this.abortListener) {\n      this.externalSignal.removeEventListener(\"abort\", this.abortListener);\n    }\n  }\n}\n","import { AhkoConfigurationError } from \"./errors/configuration.error.js\";\nimport type { IAhkoOptions, IScheduleOptions } from \"./models/options.model.js\";\nimport type { IAhkoStats } from \"./models/stats.model.js\";\nimport { EScheduleStrategy } from \"./models/strategy.model.js\";\nimport type { ITask } from \"./models/task.model.js\";\nimport { TaskQueue } from \"./scheduler/task-queue.js\";\nimport { TaskRunner } from \"./scheduler/task-runner.js\";\n\n/**\n * Ahko — Low-energy asynchronous task scheduler.\n *\n * Coordinates execution timing, enforces concurrency limits, and cooperates\n * natively with AbortSignal cancellation.\n *\n * @example\n * ```typescript\n * import { Ahko } from \"@mrjacket/ahko\";\n *\n * const ahko = new Ahko({ concurrency: 2 });\n *\n * const result = await ahko.schedule(async ({ signal, taskId }) => {\n *   const res = await fetch(\"https://api.example.com\", { signal });\n *   return res.json();\n * });\n * ```\n */\nexport class Ahko {\n  /** Internal queue and concurrency manager */\n  private readonly queue: TaskQueue;\n\n  /**\n   * Initializes a new Ahko scheduler instance.\n   *\n   * @param options - Optional scheduler configuration.\n   * @throws {AhkoConfigurationError} If concurrency is invalid (less than 1 or NaN).\n   *\n   * @example\n   * ```typescript\n   * const ahko = new Ahko({ concurrency: 4 });\n   * ```\n   */\n  constructor(options?: IAhkoOptions) {\n    this.queue = new TaskQueue(options?.concurrency);\n  }\n\n  /**\n   * Schedules a task for execution with full return type inference.\n   *\n   * @template T - Inferred return type of the task.\n   * @param task - Asynchronous or synchronous task function accepting an {@link ITaskContext}.\n   * @param options - Task-specific scheduling options such as strategy, delay, and cancellation signal.\n   * @returns A promise that resolves with the task's return value.\n   *\n   * @throws {AhkoConfigurationError} If the task is not a function or options are invalid.\n   * @throws {AhkoCancellationError} If the task is cancelled prior to or during execution.\n   *\n   * @example\n   * ```typescript\n   * // Immediate execution (subject to concurrency)\n   * const count = await ahko.schedule(async () => 42);\n   *\n   * // Delayed execution\n   * await ahko.schedule(\n   *   async ({ signal }) => doWork({ signal }),\n   *   { strategy: \"delay\", delay: 1000 }\n   * );\n   * ```\n   */\n  public schedule<T>(task: ITask<T>, options?: IScheduleOptions): Promise<T> {\n    if (typeof task !== \"function\") {\n      throw new AhkoConfigurationError(\"Task must be a valid function.\");\n    }\n\n    const runner = new TaskRunner<T>(task, options?.signal);\n    return this.queue.enqueue(runner, options);\n  }\n\n  /**\n   * Convenience method to schedule a task during platform idle opportunities.\n   *\n   * Equivalent to calling `schedule(task, { ...options, strategy: \"idle\" })`.\n   * In browsers, uses `requestIdleCallback` when available.\n   * In Node.js, uses `setImmediate`.\n   * Falls back to `setTimeout(..., 0)` if neither is available.\n   *\n   * @template T - Inferred return type of the task.\n   * @param task - Task function to run when idle.\n   * @param options - Scheduling options (excluding strategy).\n   * @returns A promise resolving to the task's return value.\n   *\n   * @throws {AhkoConfigurationError} If the task is not a function or options are invalid.\n   * @throws {AhkoCancellationError} If the task is cancelled prior to or during execution.\n   *\n   * @example\n   * ```typescript\n   * const result = await ahko.idle(async ({ signal }) => {\n   *   return computeAnalytics();\n   * });\n   * ```\n   */\n  public idle<T>(\n    task: ITask<T>,\n    options?: Omit<IScheduleOptions, \"strategy\">\n  ): Promise<T> {\n    return this.schedule(task, {\n      ...options,\n      strategy: EScheduleStrategy.IDLE,\n    });\n  }\n\n  /**\n   * Retrieves real-time telemetry metrics from the scheduler.\n   *\n   * @returns An {@link IAhkoStats} snapshot of active, pending, completed, failed, cancelled, and timed out tasks.\n   *\n   * @example\n   * ```typescript\n   * const stats = ahko.stats();\n   * console.log(`Active: ${stats.activeTasks}, Pending: ${stats.pendingTasks}`);\n   * ```\n   */\n  public stats(): IAhkoStats {\n    return this.queue.getStats();\n  }\n}\n","/**\n * Current version of @mrjacket/ahko package.\n */\nexport const VERSION = \"0.3.0\";\n","import { AhkoError } from \"./ahko.error.js\";\n\n/**\n * Thrown when an internal queue invariant is violated or queue limits are breached.\n */\nexport class AhkoQueueError extends AhkoError {\n  /**\n   * Creates a new AhkoQueueError.\n   *\n   * @param message - Explanation of the queue failure.\n   * @param options - Standard Error options including cause.\n   */\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AhkoQueueError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { AhkoError } from \"./ahko.error.js\";\n\n/**\n * Thrown when a task exceeds its allotted timeout duration.\n */\nexport class AhkoTimeoutError extends AhkoError {\n  /**\n   * Creates a new AhkoTimeoutError.\n   *\n   * @param message - Explanation of timeout expiry.\n   * @param options - Standard Error options including cause.\n   */\n  constructor(message = \"Task execution timed out\", options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AhkoTimeoutError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAM,YAAN,cAAwB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnC,YAAY,SAAiB,SAAwB;AACnD,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;;;ACVO,IAAM,yBAAN,cAAqC,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpD,YAAY,SAAiB,SAAwB;AACnD,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;;;ACdO,IAAK,oBAAL,kBAAKA,uBAAL;AAEL,EAAAA,mBAAA,eAAY;AAEZ,EAAAA,mBAAA,WAAQ;AAER,EAAAA,mBAAA,UAAO;AANG,SAAAA;AAAA,GAAA;;;ACAL,IAAK,aAAL,kBAAKC,gBAAL;AAEL,EAAAA,YAAA,aAAU;AAEV,EAAAA,YAAA,aAAU;AAEV,EAAAA,YAAA,eAAY;AAEZ,EAAAA,YAAA,YAAS;AAET,EAAAA,YAAA,eAAY;AAEZ,EAAAA,YAAA,eAAY;AAZF,SAAAA;AAAA,GAAA;;;ACEL,IAAM,qBAAqB;AAK3B,IAAM,oBAAoB;AAU1B,SAAS,iBACd,SACA,SACA,WAAyB,KAAK,QACtB;AACR,QAAM,UAAU,SAAS,WAAW;AAEpC,MAAI,YAAY,QAAQ;AACtB,WAAO;AAAA,EACT;AAEA,QAAM,YACJ,OAAO,SAAS,cAAc,YAAY,CAAC,OAAO,MAAM,QAAQ,SAAS,KAAK,QAAQ,aAAa,IAC/F,QAAQ,YACR;AAEN,QAAM,WACJ,OAAO,SAAS,aAAa,YAAY,CAAC,OAAO,MAAM,QAAQ,QAAQ,KAAK,QAAQ,YAAY,YAC5F,QAAQ,WACR,KAAK,IAAI,mBAAmB,SAAS;AAE3C,MAAI;AAEJ,MAAI,YAAY,UAAU;AACxB,sBAAkB,YAAY,KAAK,IAAI,GAAG,OAAO;AAAA,EACnD,OAAO;AAEL,UAAM,WAAW,KAAK,IAAI,GAAG,UAAU,CAAC;AAExC,UAAM,SAAS,WAAW,KAAK,KAAK,KAAK,KAAK;AAC9C,sBAAkB,YAAY;AAAA,EAChC;AAEA,QAAM,cAAc,KAAK,IAAI,iBAAiB,QAAQ;AAEtD,MAAI,SAAS,QAAQ;AAEnB,WAAO,KAAK,MAAM,SAAS,KAAK,cAAc,EAAE;AAAA,EAClD;AAEA,SAAO,KAAK,MAAM,WAAW;AAC/B;;;AC3CO,IAAM,gBAAN,MAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASzB,OAAc,SACZ,UACA,SACA,UAA6B,YAChB;AAEb,QACE,OAAQ,QAAoC,wBAAwB,cACpE,OAAQ,QAAoC,uBAAuB,YACnE;AACA,YAAM,YAAa,QAAoC;AAKvD,YAAM,WAAY,QAAoC;AAItD,YAAM,KAAK;AAAA,QACT,MAAM,SAAS;AAAA,QACf,OAAO,YAAY,YAAY,CAAC,OAAO,MAAM,OAAO,KAAK,WAAW,IAChE,EAAE,QAAQ,IACV;AAAA,MACN;AAEA,aAAO;AAAA,QACL,QAAQ,MAAM,SAAS,EAAE;AAAA,MAC3B;AAAA,IACF;AAGA,QACE,OAAQ,QAAoC,iBAAiB,cAC7D,OAAQ,QAAoC,mBAAmB,YAC/D;AACA,YAAM,WAAY,QAAoC;AAItD,YAAM,aAAc,QAAoC;AAIxD,YAAM,SAAS,SAAS,MAAM,SAAS,CAAC;AAExC,aAAO;AAAA,QACL,QAAQ,MAAM,WAAW,MAAM;AAAA,MACjC;AAAA,IACF;AAGA,UAAM,aAAa,QAAQ,WAAW,KAAK,OAAO;AAClD,UAAM,eAAe,QAAQ,aAAa,KAAK,OAAO;AAEtD,UAAM,UAAU,WAAW,MAAM,SAAS,GAAG,CAAC;AAE9C,WAAO;AAAA,MACL,QAAQ,MAAM,aAAa,OAAO;AAAA,IACpC;AAAA,EACF;AACF;;;ACnDO,IAAM,YAAN,MAAgB;AAAA;AAAA,EAEL;AAAA;AAAA,EAGC,QAA+B,CAAC;AAAA;AAAA,EAGhC,gBAAgB,oBAAI,IAAyB;AAAA;AAAA,EAG7C,iBAAiB,oBAAI,IAAmB;AAAA;AAAA,EAGxC,cAAc,oBAAI,IAAgB;AAAA;AAAA,EAGlC,eAAe,oBAAI,IAAiB;AAAA;AAAA,EAGpC,gBAAgB,oBAAI,QAA+C;AAAA;AAAA,EAG5E,iBAAiB;AAAA;AAAA,EAGjB,cAAc;AAAA;AAAA,EAGd,iBAAiB;AAAA;AAAA,EAGjB,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQxB,YAAY,cAAc,UAAU;AAClC,QAAI,OAAO,MAAM,WAAW,KAAK,cAAc,GAAG;AAChD,YAAM,IAAI;AAAA,QACR,wBAAwB,WAAW;AAAA,MACrC;AAAA,IACF;AACA,SAAK,cAAc;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWO,QAAW,QAAuB,SAAwC;AAC/E,UAAM,WAAW,SAAS;AAE1B,QACE,4CACA,oCACA,gCACA;AACA,YAAM,IAAI;AAAA,QACR,kCAAkC,OAAO,QAAQ,CAAC;AAAA,MACpD;AAAA,IACF;AAEA,QAAI,SAAS,OAAO;AAClB,UACE,OAAO,QAAQ,MAAM,aAAa,YAClC,OAAO,MAAM,QAAQ,MAAM,QAAQ,KACnC,QAAQ,MAAM,WAAW,KACzB,CAAC,OAAO,UAAU,QAAQ,MAAM,QAAQ,GACxC;AACA,cAAM,IAAI;AAAA,UACR,2BAA2B,QAAQ,MAAM,QAAQ;AAAA,QACnD;AAAA,MACF;AAEA,UACE,QAAQ,MAAM,cAAc,WAC3B,OAAO,QAAQ,MAAM,cAAc,YAClC,OAAO,MAAM,QAAQ,MAAM,SAAS,KACpC,QAAQ,MAAM,YAAY,IAC5B;AACA,cAAM,IAAI;AAAA,UACR,4BAA4B,QAAQ,MAAM,SAAS;AAAA,QACrD;AAAA,MACF;AAEA,UACE,QAAQ,MAAM,aAAa,WAC1B,OAAO,QAAQ,MAAM,aAAa,YACjC,OAAO,MAAM,QAAQ,MAAM,QAAQ,KACnC,QAAQ,MAAM,WAAW,IAC3B;AACA,cAAM,IAAI;AAAA,UACR,2BAA2B,QAAQ,MAAM,QAAQ;AAAA,QACnD;AAAA,MACF;AAAA,IACF;AAEA,QAAI,SAAS;AACX,WAAK,cAAc,IAAI,QAA+B,OAAO;AAAA,IAC/D;AAEA,QAAI,OAAO,uCAAgC;AACzC,WAAK;AACL,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,kCAAsC;AACxC,YAAM,UAAU,SAAS,SAAS;AAClC,UAAI,OAAO,YAAY,YAAY,OAAO,MAAM,OAAO,KAAK,UAAU,GAAG;AACvE,cAAM,IAAI;AAAA,UACR,kBAAkB,OAAO;AAAA,QAC3B;AAAA,MACF;AAEA,WAAK,gBAAgB,QAA+B,OAAO;AAC3D,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,gCAAqC;AACvC,UACE,SAAS,gBAAgB,WACxB,OAAO,QAAQ,gBAAgB,YAC9B,OAAO,MAAM,QAAQ,WAAW,KAChC,QAAQ,cAAc,IACxB;AACA,cAAM,IAAI;AAAA,UACR,wBAAwB,QAAQ,WAAW;AAAA,QAC7C;AAAA,MACF;AAEA,WAAK,aAAa,QAA+B,SAAS,WAAW;AACrE,aAAO,OAAO;AAAA,IAChB;AAGA,WAAO,WAAW,MAAM;AACtB,YAAM,QAAQ,KAAK,MAAM,QAAQ,MAA6B;AAC9D,UAAI,UAAU,IAAI;AAChB,aAAK,MAAM,OAAO,OAAO,CAAC;AAC1B,aAAK;AAAA,MACP;AAAA,IACF;AAGA,SAAK,MAAM,KAAK,MAA6B;AAC7C,SAAK,KAAK;AAEV,WAAO,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,gBAAgB,QAA6B,SAAuB;AAC1E,UAAM,eAA8B;AAAA,MAClC;AAAA,MACA,SAAS,WAAW,MAAM;AACxB,aAAK,eAAe,OAAO,YAAY;AACvC,YAAI,OAAO,uCAAgC;AACzC;AAAA,QACF;AAEA,eAAO,WAAW,MAAM;AACtB,gBAAM,QAAQ,KAAK,MAAM,QAAQ,MAAM;AACvC,cAAI,UAAU,IAAI;AAChB,iBAAK,MAAM,OAAO,OAAO,CAAC;AAC1B,iBAAK;AAAA,UACP;AAAA,QACF;AAEA,aAAK,MAAM,KAAK,MAAM;AACtB,aAAK,KAAK;AAAA,MACZ,GAAG,OAAO;AAAA,IACZ;AAEA,SAAK,eAAe,IAAI,YAAY;AAEpC,WAAO,WAAW,MAAM;AACtB,UAAI,KAAK,eAAe,IAAI,YAAY,GAAG;AACzC,qBAAa,aAAa,OAAO;AACjC,aAAK,eAAe,OAAO,YAAY;AACvC,aAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,aAAa,QAA6B,aAA4B;AAC5E,QAAI;AAEJ,UAAM,SAAS,cAAc,SAAS,MAAM;AAC1C,WAAK,YAAY,OAAO,SAAS;AACjC,UAAI,OAAO,uCAAgC;AACzC;AAAA,MACF;AAEA,aAAO,WAAW,MAAM;AACtB,cAAM,QAAQ,KAAK,MAAM,QAAQ,MAAM;AACvC,YAAI,UAAU,IAAI;AAChB,eAAK,MAAM,OAAO,OAAO,CAAC;AAC1B,eAAK;AAAA,QACP;AAAA,MACF;AAEA,WAAK,MAAM,KAAK,MAAM;AACtB,WAAK,KAAK;AAAA,IACZ,GAAG,WAAW;AAEd,gBAAY,EAAE,QAAQ,OAAO;AAC7B,SAAK,YAAY,IAAI,SAAS;AAE9B,WAAO,WAAW,MAAM;AACtB,UAAI,KAAK,YAAY,IAAI,SAAS,GAAG;AACnC,eAAO,OAAO;AACd,aAAK,YAAY,OAAO,SAAS;AACjC,aAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,OAAa;AACnB,WAAO,KAAK,cAAc,OAAO,KAAK,eAAe,KAAK,MAAM,SAAS,GAAG;AAC1E,YAAM,SAAS,KAAK,MAAM,MAAM;AAChC,UAAI,CAAC,QAAQ;AACX;AAAA,MACF;AAEA,UAAI,OAAO,uCAAgC;AACzC;AAAA,MACF;AAEA,WAAK,cAAc,IAAI,MAAM;AAG7B,WAAK,KAAK,cAAc,MAAM;AAAA,IAChC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,cAAc,QAA4C;AACtE,UAAM,UAAU,KAAK,cAAc,IAAI,MAAM;AAE7C,QAAI;AACF,YAAM,SAAS,MAAM,OAAO,IAAI;AAChC,WAAK;AACL,WAAK,cAAc,OAAO,MAAM;AAChC,WAAK,cAAc,OAAO,MAAM;AAChC,aAAO,QAAQ,MAAM;AAAA,IACvB,SAAS,OAAO;AACd,UAAI,OAAO,uCAAgC;AACzC,aAAK;AACL,aAAK,cAAc,OAAO,MAAM;AAChC,aAAK,cAAc,OAAO,MAAM;AAChC,eAAO,OAAO,KAAK;AACnB;AAAA,MACF;AAEA,YAAM,cAAc,MAAM,OAAO,SAAS,OAAO,SAAS,KAAK;AAC/D,UAAI,aAAa;AAEf,aAAK,cAAc,OAAO,MAAM;AAChC,aAAK,cAAc,QAAQ,OAAO;AAClC;AAAA,MACF;AAEA,UAAI,OAAO,uCAAgC;AACzC,aAAK;AAAA,MACP,OAAO;AACL,aAAK;AAAA,MACP;AACA,WAAK,cAAc,OAAO,MAAM;AAChC,WAAK,cAAc,OAAO,MAAM;AAChC,aAAO,OAAO,KAAK;AAAA,IACrB,UAAE;AACA,WAAK,KAAK;AAAA,IACZ;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,cAAc,QAA6B,SAAkC;AACnF,UAAM,eAAe,iBAAiB,OAAO,UAAU,GAAG,SAAS,KAAK;AAExE,QAAI,iBAAiB,GAAG;AACtB,aAAO,WAAW,MAAM;AACtB,cAAM,QAAQ,KAAK,MAAM,QAAQ,MAAM;AACvC,YAAI,UAAU,IAAI;AAChB,eAAK,MAAM,OAAO,OAAO,CAAC;AAC1B,eAAK;AAAA,QACP;AAAA,MACF;AACA,WAAK,MAAM,KAAK,MAAM;AACtB,WAAK,KAAK;AACV;AAAA,IACF;AAEA,UAAM,aAA0B;AAAA,MAC9B;AAAA,MACA,SAAS,WAAW,MAAM;AACxB,aAAK,aAAa,OAAO,UAAU;AACnC,YAAI,OAAO,uCAAgC;AACzC;AAAA,QACF;AAEA,eAAO,WAAW,MAAM;AACtB,gBAAM,QAAQ,KAAK,MAAM,QAAQ,MAAM;AACvC,cAAI,UAAU,IAAI;AAChB,iBAAK,MAAM,OAAO,OAAO,CAAC;AAC1B,iBAAK;AAAA,UACP;AAAA,QACF;AAEA,aAAK,MAAM,KAAK,MAAM;AACtB,aAAK,KAAK;AAAA,MACZ,GAAG,YAAY;AAAA,IACjB;AAEA,SAAK,aAAa,IAAI,UAAU;AAEhC,WAAO,WAAW,MAAM;AACtB,UAAI,KAAK,aAAa,IAAI,UAAU,GAAG;AACrC,qBAAa,WAAW,OAAO;AAC/B,aAAK,aAAa,OAAO,UAAU;AACnC,aAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,WAAuB;AAC5B,WAAO,OAAO,OAAO;AAAA,MACnB,aAAa,KAAK,cAAc;AAAA,MAChC,cACE,KAAK,MAAM,SACX,KAAK,eAAe,OACpB,KAAK,YAAY,OACjB,KAAK,aAAa;AAAA,MACpB,gBAAgB,KAAK;AAAA,MACrB,aAAa,KAAK;AAAA,MAClB,gBAAgB,KAAK;AAAA,MACrB,eAAe,KAAK;AAAA,MACpB,UAAU,KAAK;AAAA,IACjB,CAAC;AAAA,EACH;AACF;;;ACjZO,IAAM,wBAAN,cAAoC,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnD,YAAY,UAAU,sBAAsB,SAAwB;AAClE,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;;;ACXA,IAAI,gBAAgB;AAQb,IAAM,aAAN,MAAoB;AAAA;AAAA,EAET;AAAA;AAAA,EAGR;AAAA;AAAA,EAGS;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGT;AAAA;AAAA,EAGA;AAAA;AAAA,EAGQ;AAAA;AAAA,EAGT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQP,YAAY,MAAgB,gBAA8B;AACxD,SAAK,SAAS,QAAQ,KAAK,IAAI,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,eAAe,SAAS,EAAE,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AACzH,SAAK,OAAO;AACZ,SAAK,iBAAiB;AACtB,SAAK,kBAAkB,IAAI,gBAAgB;AAE3C,SAAK,UAAU,IAAI,QAAW,CAAC,SAAS,WAAW;AACjD,WAAK,iBAAiB;AACtB,WAAK,gBAAgB;AAAA,IACvB,CAAC;AAED,QAAI,KAAK,gBAAgB;AACvB,UAAI,KAAK,eAAe,SAAS;AAC/B,aAAK;AACL,cAAM,SAAS,KAAK,eAAe;AACnC,cAAM,cAAc,IAAI;AAAA,UACtB,OAAO,WAAW,WAAW,SAAS;AAAA,UACtC,EAAE,OAAO,kBAAkB,QAAQ,SAAS,OAAU;AAAA,QACxD;AACA,aAAK,cAAc,WAAW;AAAA,MAChC,OAAO;AACL,aAAK,gBAAgB,MAAM;AACzB,eAAK,oBAAoB;AAAA,QAC3B;AACA,aAAK,eAAe,iBAAiB,SAAS,KAAK,eAAe,EAAE,MAAM,KAAK,CAAC;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,IAAW,QAAoB;AAC7B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGO,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOV,QAAQ,OAAgB;AAC7B,SAAK,QAAQ;AACb,SAAK,eAAe,KAAK;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,OAAO,QAAuB;AACnC,SAAK,QAAQ;AACb,SAAK,cAAc,MAAM;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAa,SAAS,OAAgB,cAAgD;AACpF,QAAI,KAAK,0CAAmC,KAAK,gBAAgB,OAAO,SAAS;AAC/E,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,gBAAgB,OAAO,aAAa,aAAa,UAAU;AAC9D,aAAO;AAAA,IACT;AAEA,QAAI,KAAK,WAAW,aAAa,UAAU;AACzC,aAAO;AAAA,IACT;AAEA,QAAI,OAAO,aAAa,gBAAgB,YAAY;AAClD,UAAI;AACF,cAAM,UAAU,MAAM,aAAa,YAAY,OAAO,KAAK,OAAO;AAClE,YAAI,CAAC,SAAS;AACZ,iBAAO;AAAA,QACT;AAAA,MACF,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAEA,SAAK;AACL,SAAK;AACL,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAa,MAAkB;AAC7B,QAAI,KAAK,wCAAiC;AACxC,YAAM,IAAI,sBAAsB,uCAAuC;AAAA,IACzE;AAEA,SAAK;AAEL,UAAM,UAAwB;AAAA,MAC5B,QAAQ,KAAK,gBAAgB;AAAA,MAC7B,QAAQ,KAAK;AAAA,IACf;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,KAAK,OAAO;AACtC,WAAK;AACL,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,cACH,KAAK,0CACN,KAAK,gBAAgB,OAAO;AAE9B,UAAI,aAAa;AACf,aAAK;AACL,cAAM,IAAI,sBAAsB,uCAAuC;AAAA,UACrE,OAAO,iBAAiB,QAAQ,QAAQ;AAAA,QAC1C,CAAC;AAAA,MACH;AAEA,WAAK;AACL,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,OAAO,QAAwB;AACpC,QACE,KAAK,0CACL,KAAK,oCACL,KAAK,0CACL,KAAK,wCACL;AACA;AAAA,IACF;AAEA,UAAM,aAAa,KAAK;AACxB,SAAK;AACL,SAAK,gBAAgB,MAAM,MAAM;AACjC,SAAK,QAAQ;AAEb,QAAI,YAAY;AACd,YAAM,oBAAoB,IAAI;AAAA,QAC5B,OAAO,WAAW,WAAW,SAAS;AAAA,QACtC,EAAE,OAAO,kBAAkB,QAAQ,SAAS,OAAU;AAAA,MACxD;AACA,WAAK,cAAc,iBAAiB;AACpC,WAAK,WAAW,IAAI;AAAA,IACtB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,sBAA4B;AAClC,SAAK,OAAO,KAAK,gBAAgB,MAAM;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKO,UAAgB;AACrB,QAAI,KAAK,kBAAkB,KAAK,eAAe;AAC7C,WAAK,eAAe,oBAAoB,SAAS,KAAK,aAAa;AAAA,IACrE;AAAA,EACF;AACF;;;AC3MO,IAAM,OAAN,MAAW;AAAA;AAAA,EAEC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAajB,YAAY,SAAwB;AAClC,SAAK,QAAQ,IAAI,UAAU,SAAS,WAAW;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBO,SAAY,MAAgB,SAAwC;AACzE,QAAI,OAAO,SAAS,YAAY;AAC9B,YAAM,IAAI,uBAAuB,gCAAgC;AAAA,IACnE;AAEA,UAAM,SAAS,IAAI,WAAc,MAAM,SAAS,MAAM;AACtD,WAAO,KAAK,MAAM,QAAQ,QAAQ,OAAO;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBO,KACL,MACA,SACY;AACZ,WAAO,KAAK,SAAS,MAAM;AAAA,MACzB,GAAG;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaO,QAAoB;AACzB,WAAO,KAAK,MAAM,SAAS;AAAA,EAC7B;AACF;;;ACzHO,IAAM,UAAU;;;ACEhB,IAAM,iBAAN,cAA6B,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO5C,YAAY,SAAiB,SAAwB;AACnD,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;;;ACZO,IAAM,mBAAN,cAA+B,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO9C,YAAY,UAAU,4BAA4B,SAAwB;AACxE,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AACZ,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAClD;AACF;","names":["EScheduleStrategy","ETaskState"]}

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export { Ahko } from "./ahko.js";
 export { VERSION } from "./version.js";
 export { AhkoError, AhkoCancellationError, AhkoConfigurationError, AhkoQueueError, AhkoTimeoutError, } from "./errors/index.js";
 export { ETaskState, EScheduleStrategy, } from "./models/index.js";
-export type { ITask, ITaskContext, IScheduleOptions, IAhkoOptions, IAhkoStats, TScheduleStrategy, } from "./models/index.js";
+export type { ITask, ITaskContext, IScheduleOptions, IAhkoOptions, IAhkoStats, TScheduleStrategy, IRetryOptions, TRetryBackoff, TRetryPredicate, } from "./models/index.js";
+export { calculateBackoff, DEFAULT_BASE_DELAY, DEFAULT_MAX_DELAY, } from "./retry/index.js";