@mrjacket/ahko 0.4.0 → 0.6.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors/ahko.error.ts","../src/errors/configuration.error.ts","../src/models/strategy.model.ts","../src/errors/timeout.error.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/scheduler/signal.ts"],"sourcesContent":["/**\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","import { AhkoError } from \"./ahko.error.js\";\n\n/**\n * Options for constructing an AhkoTimeoutError.\n */\nexport interface IAhkoTimeoutErrorOptions extends ErrorOptions {\n  /**\n   * The timeout threshold in milliseconds that was exceeded.\n   */\n  timeoutMs?: number;\n}\n\n/**\n * Thrown when a task exceeds its allotted timeout duration.\n */\nexport class AhkoTimeoutError extends AhkoError {\n  /**\n   * The timeout threshold in milliseconds that was exceeded, if configured.\n   */\n  public readonly timeoutMs?: number;\n\n  /**\n   * Creates a new AhkoTimeoutError.\n   *\n   * @param message - Explanation of timeout expiry.\n   * @param options - Standard Error options including optional timeoutMs and cause.\n   */\n  constructor(\n    message = \"Task execution timed out\",\n    options?: IAhkoTimeoutErrorOptions\n  ) {\n    super(message, options);\n    this.name = \"AhkoTimeoutError\";\n    this.timeoutMs = options?.timeoutMs;\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","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 { AhkoTimeoutError } from \"../errors/timeout.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?.timeoutMs !== undefined) {\n      if (\n        typeof options.timeoutMs !== \"number\" ||\n        Number.isNaN(options.timeoutMs) ||\n        !Number.isFinite(options.timeoutMs) ||\n        options.timeoutMs <= 0\n      ) {\n        throw new AhkoConfigurationError(\n          `Invalid timeoutMs \"${options.timeoutMs}\". timeoutMs must be a positive finite number greater than 0.`\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 || error instanceof AhkoTimeoutError) {\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 { AhkoTimeoutError } from \"../errors/timeout.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, timeout enforcement, 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 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  public readonly externalSignal?: AbortSignal;\n\n  /** Maximum execution duration allowed in milliseconds */\n  public readonly timeoutMs?: number;\n\n  /** Active timeout timer identifier */\n  private timeoutTimerId?: ReturnType<typeof setTimeout>;\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  /** Current execution attempt count (1-indexed) */\n  public attempt = 1;\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   * @param timeoutMs - Optional maximum execution time in milliseconds.\n   */\n  constructor(task: ITask<T>, externalSignal?: AbortSignal, timeoutMs?: number) {\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.timeoutMs = timeoutMs;\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.abortController.abort(cancelError);\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.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 or timeout.\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.externalSignal?.aborted ?? false)) {\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    this.abortController = new AbortController();\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/timeout.\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    let abortListener: (() => void) | undefined;\n\n    const abortPromise = new Promise<never>((_, reject) => {\n      abortListener = () => {\n        if (this._state === ETaskState.TIMED_OUT) {\n          reject(\n            new AhkoTimeoutError(\n              `Task execution timed out after ${this.timeoutMs}ms`,\n              { timeoutMs: this.timeoutMs }\n            )\n          );\n        } else {\n          const reason = this.abortController.signal.reason;\n          reject(\n            new AhkoCancellationError(\"Task was cancelled during execution\", {\n              cause: reason instanceof Error ? reason : undefined,\n            })\n          );\n        }\n      };\n      this.abortController.signal.addEventListener(\"abort\", abortListener, { once: true });\n    });\n\n    let timeoutPromise: Promise<never> | undefined;\n    if (this.timeoutMs !== undefined) {\n      timeoutPromise = new Promise<never>((_, reject) => {\n        this.timeoutTimerId = setTimeout(() => {\n          if (this._state !== ETaskState.RUNNING) {\n            return;\n          }\n          this._state = ETaskState.TIMED_OUT;\n          const timeoutError = new AhkoTimeoutError(\n            `Task execution timed out after ${this.timeoutMs}ms`,\n            { timeoutMs: this.timeoutMs }\n          );\n          this.abortController.abort(timeoutError);\n          reject(timeoutError);\n        }, this.timeoutMs);\n      });\n    }\n\n    let taskExecutionPromise: Promise<T>;\n    try {\n      taskExecutionPromise = Promise.resolve(this.task(context));\n    } catch (syncError) {\n      taskExecutionPromise = Promise.reject(syncError);\n    }\n\n    // Suppress unhandled rejection in background if task finishes or fails after timeout/cancellation\n    taskExecutionPromise.catch(() => {});\n\n    const racePromises: Array<Promise<T | never>> = [\n      taskExecutionPromise,\n      abortPromise,\n    ];\n    if (timeoutPromise) {\n      racePromises.push(timeoutPromise);\n    }\n\n    try {\n      const result = await Promise.race(racePromises);\n      this.clearTimeoutTimer();\n      if (abortListener) {\n        this.abortController.signal.removeEventListener(\"abort\", abortListener);\n      }\n\n      if ((this._state as ETaskState) === ETaskState.TIMED_OUT) {\n        throw new AhkoTimeoutError(\n          `Task execution timed out after ${this.timeoutMs}ms`,\n          { timeoutMs: this.timeoutMs }\n        );\n      }\n\n      if ((this._state as ETaskState) === ETaskState.CANCELLED) {\n        throw new AhkoCancellationError(\"Task was cancelled during execution\");\n      }\n\n      this._state = ETaskState.COMPLETED;\n      return result;\n    } catch (error) {\n      this.clearTimeoutTimer();\n      if (abortListener) {\n        this.abortController.signal.removeEventListener(\"abort\", abortListener);\n      }\n\n      if ((this._state as ETaskState) === ETaskState.TIMED_OUT || error instanceof AhkoTimeoutError) {\n        this._state = ETaskState.TIMED_OUT;\n        if (error instanceof AhkoTimeoutError) {\n          throw error;\n        }\n        throw new AhkoTimeoutError(\n          `Task execution timed out after ${this.timeoutMs}ms`,\n          {\n            timeoutMs: this.timeoutMs,\n            cause: error instanceof Error ? error : undefined,\n          }\n        );\n      }\n\n      const isCancelled =\n        (this._state as ETaskState) === ETaskState.CANCELLED ||\n        this.abortController.signal.aborted ||\n        (this.externalSignal?.aborted ?? false);\n\n      if (isCancelled) {\n        this._state = ETaskState.CANCELLED;\n        if (error instanceof AhkoCancellationError) {\n          throw error;\n        }\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   * Clears the active timeout timer.\n   */\n  private clearTimeoutTimer(): void {\n    if (this.timeoutTimerId !== undefined) {\n      clearTimeout(this.timeoutTimerId);\n      this.timeoutTimerId = undefined;\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.clearTimeoutTimer();\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    this.clearTimeoutTimer();\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, options?.timeoutMs);\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.4.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","/**\n * Result of combining multiple AbortSignals.\n */\nexport interface ICombinedSignal {\n  /**\n   * The unified AbortSignal that aborts when any source signal aborts.\n   */\n  readonly signal: AbortSignal;\n\n  /**\n   * Detaches all registered event listeners from source signals to prevent memory leaks.\n   */\n  cleanup: () => void;\n}\n\n/**\n * Combines multiple AbortSignals into a single coordinated AbortSignal with deterministic cleanup.\n *\n * @param signals - Array of source AbortSignals (undefined entries are ignored).\n * @returns A unified signal interface with explicit cleanup callback.\n */\nexport function combineSignals(\n  signals: ReadonlyArray<AbortSignal | undefined>\n): ICombinedSignal {\n  const activeSignals = signals.filter(\n    (signal): signal is AbortSignal => signal !== undefined\n  );\n\n  if (activeSignals.length === 0) {\n    const controller = new AbortController();\n    return {\n      signal: controller.signal,\n      cleanup: () => {},\n    };\n  }\n\n  // Check if any source signal is already aborted\n  const alreadyAborted = activeSignals.find((s) => s.aborted);\n  if (alreadyAborted) {\n    const controller = new AbortController();\n    controller.abort(alreadyAborted.reason);\n    return {\n      signal: controller.signal,\n      cleanup: () => {},\n    };\n  }\n\n  if (activeSignals.length === 1) {\n    return {\n      signal: activeSignals[0],\n      cleanup: () => {},\n    };\n  }\n\n  const controller = new AbortController();\n  const cleanupFns: Array<() => void> = [];\n\n  const onAbort = (event: Event): void => {\n    const target = event.target as AbortSignal;\n    cleanup();\n    controller.abort(target.reason);\n  };\n\n  for (const sig of activeSignals) {\n    sig.addEventListener(\"abort\", onAbort, { once: true });\n    cleanupFns.push(() => {\n      sig.removeEventListener(\"abort\", onAbort);\n    });\n  }\n\n  const cleanup = (): void => {\n    for (const fn of cleanupFns) {\n      fn();\n    }\n    cleanupFns.length = 0;\n  };\n\n  return {\n    signal: controller.signal,\n    cleanup,\n  };\n}\n"],"mappings":"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","names":["EScheduleStrategy","ETaskState","controller"]}
+{"version":3,"sources":["../src/errors/ahko.error.ts","../src/errors/configuration.error.ts","../src/models/strategy.model.ts","../src/errors/timeout.error.ts","../src/models/state.model.ts","../src/retry/backoff.ts","../src/errors/cancellation.error.ts","../src/scheduler/debounce-coordinator.ts","../src/scheduler/idle-scheduler.ts","../src/scheduler/throttle-coordinator.ts","../src/events/event-emitter.ts","../src/scheduler/task-queue.ts","../src/scheduler/task-runner.ts","../src/ahko.ts","../src/version.ts","../src/errors/queue.error.ts","../src/scheduler/signal.ts"],"sourcesContent":["/**\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  /** Enforce maximum execution frequency for tasks sharing the same key */\n  THROTTLE = \"throttle\",\n  /** Delay execution until calls sharing the same key stop arriving */\n  DEBOUNCE = \"debounce\",\n}\n\n/**\n * Union type representing valid scheduling strategy identifiers.\n */\nexport type TScheduleStrategy =\n  | EScheduleStrategy\n  | \"immediate\"\n  | \"delay\"\n  | \"idle\"\n  | \"throttle\"\n  | \"debounce\";\n","import { AhkoError } from \"./ahko.error.js\";\n\n/**\n * Options for constructing an AhkoTimeoutError.\n */\nexport interface IAhkoTimeoutErrorOptions extends ErrorOptions {\n  /**\n   * The timeout threshold in milliseconds that was exceeded.\n   */\n  timeoutMs?: number;\n}\n\n/**\n * Thrown when a task exceeds its allotted timeout duration.\n */\nexport class AhkoTimeoutError extends AhkoError {\n  /**\n   * The timeout threshold in milliseconds that was exceeded, if configured.\n   */\n  public readonly timeoutMs?: number;\n\n  /**\n   * Creates a new AhkoTimeoutError.\n   *\n   * @param message - Explanation of timeout expiry.\n   * @param options - Standard Error options including optional timeoutMs and cause.\n   */\n  constructor(\n    message = \"Task execution timed out\",\n    options?: IAhkoTimeoutErrorOptions\n  ) {\n    super(message, options);\n    this.name = \"AhkoTimeoutError\";\n    this.timeoutMs = options?.timeoutMs;\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","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","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 { IScheduleOptions } from \"../models/options.model.js\";\nimport type { ITask } from \"../models/task.model.js\";\n\n/**\n * Internal tracking entry for a coalesced debounced task.\n */\ninterface IDebounceEntry<T = unknown> {\n  readonly key: string | symbol;\n  task: ITask<T>;\n  options?: IScheduleOptions;\n  timerId: ReturnType<typeof setTimeout>;\n  resolve: (value: T) => void;\n  reject: (reason: unknown) => void;\n  readonly promise: Promise<T>;\n  abortListener?: () => void;\n}\n\n/**\n * Coordinates debounce execution with Promise coalescing by explicit key.\n *\n * Incoming calls with the same key extend the quiet window and share the\n * eventual execution Promise, guaranteeing that all callers receive the final result.\n */\nexport class DebounceCoordinator {\n  private readonly entries = new Map<string | symbol, IDebounceEntry<unknown>>();\n\n  /**\n   * Schedules a task under the debounce strategy.\n   *\n   * @param key - Explicit identity key.\n   * @param task - Work to execute once calls stop arriving.\n   * @param waitMs - Quiet window duration in milliseconds.\n   * @param options - Scheduling options.\n   * @param dispatchFn - Callback invoked when the debounce window expires to dispatch the task to the queue.\n   * @returns Shared promise that resolves/rejects with the final execution outcome.\n   */\n  public schedule<T>(\n    key: string | symbol,\n    task: ITask<T>,\n    waitMs: number,\n    options: IScheduleOptions | undefined,\n    dispatchFn: (task: ITask<T>, options?: IScheduleOptions) => Promise<T>\n  ): Promise<T> {\n    const existing = this.entries.get(key) as IDebounceEntry<T> | undefined;\n\n    if (existing) {\n      clearTimeout(existing.timerId);\n      if (existing.options?.signal && existing.abortListener) {\n        existing.options.signal.removeEventListener(\"abort\", existing.abortListener);\n      }\n\n      existing.task = task;\n      existing.options = options;\n\n      if (options?.signal?.aborted) {\n        this.entries.delete(key);\n        const err = new AhkoCancellationError(\n          typeof options.signal.reason === \"string\"\n            ? options.signal.reason\n            : \"Debounced task was cancelled prior to execution\",\n          { cause: options.signal.reason instanceof Error ? options.signal.reason : undefined }\n        );\n        existing.reject(err);\n        return existing.promise;\n      }\n\n      if (options?.signal) {\n        const listener = () => {\n          this.cancel(key, options.signal?.reason);\n        };\n        existing.abortListener = listener;\n        options.signal.addEventListener(\"abort\", listener, { once: true });\n      }\n\n      existing.timerId = setTimeout(() => {\n        void this.flush(key, dispatchFn);\n      }, waitMs);\n\n      return existing.promise;\n    }\n\n    let resolvePromise!: (value: T) => void;\n    let rejectPromise!: (reason: unknown) => void;\n\n    const promise = new Promise<T>((resolve, reject) => {\n      resolvePromise = resolve;\n      rejectPromise = reject;\n    });\n\n    if (options?.signal?.aborted) {\n      const err = new AhkoCancellationError(\n        typeof options.signal.reason === \"string\"\n          ? options.signal.reason\n          : \"Debounced task was cancelled prior to execution\",\n        { cause: options.signal.reason instanceof Error ? options.signal.reason : undefined }\n      );\n      rejectPromise(err);\n      return promise;\n    }\n\n    let abortListener: (() => void) | undefined;\n    if (options?.signal) {\n      abortListener = () => {\n        this.cancel(key, options.signal?.reason);\n      };\n      options.signal.addEventListener(\"abort\", abortListener, { once: true });\n    }\n\n    const timerId = setTimeout(() => {\n      void this.flush(key, dispatchFn);\n    }, waitMs);\n\n    const entry: IDebounceEntry<T> = {\n      key,\n      task,\n      options,\n      timerId,\n      resolve: resolvePromise,\n      reject: rejectPromise,\n      promise,\n      abortListener,\n    };\n\n    this.entries.set(key, entry as IDebounceEntry<unknown>);\n    return promise;\n  }\n\n  /**\n   * Dispatches the coalesced task when the quiet window expires.\n   */\n  private async flush<T>(\n    key: string | symbol,\n    dispatchFn: (task: ITask<T>, options?: IScheduleOptions) => Promise<T>\n  ): Promise<void> {\n    const entry = this.entries.get(key) as IDebounceEntry<T> | undefined;\n    if (!entry) {\n      return;\n    }\n\n    this.entries.delete(key);\n    if (entry.options?.signal && entry.abortListener) {\n      entry.options.signal.removeEventListener(\"abort\", entry.abortListener);\n    }\n\n    try {\n      const result = await dispatchFn(entry.task, entry.options);\n      entry.resolve(result);\n    } catch (error) {\n      entry.reject(error);\n    }\n  }\n\n  /**\n   * Cancels a pending debounced task by key.\n   *\n   * @param key - Identity key to cancel.\n   * @param reason - Optional cancellation reason.\n   */\n  public cancel(key: string | symbol, reason?: unknown): void {\n    const entry = this.entries.get(key);\n    if (!entry) {\n      return;\n    }\n\n    clearTimeout(entry.timerId);\n    this.entries.delete(key);\n\n    if (entry.options?.signal && entry.abortListener) {\n      entry.options.signal.removeEventListener(\"abort\", entry.abortListener);\n    }\n\n    const cancelError = new AhkoCancellationError(\n      typeof reason === \"string\" ? reason : \"Debounced task was cancelled prior to execution\",\n      { cause: reason instanceof Error ? reason : undefined }\n    );\n    entry.reject(cancelError);\n  }\n\n  /**\n   * Number of pending debounced tasks waiting for quiet window expiry.\n   */\n  public get size(): number {\n    return this.entries.size;\n  }\n\n  /**\n   * Cancels all pending debounced entries and clears the map.\n   */\n  public clear(): void {\n    for (const entry of this.entries.values()) {\n      clearTimeout(entry.timerId);\n      if (entry.options?.signal && entry.abortListener) {\n        entry.options.signal.removeEventListener(\"abort\", entry.abortListener);\n      }\n      entry.reject(new AhkoCancellationError(\"Debounced tasks cleared\"));\n    }\n    this.entries.clear();\n  }\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 { AhkoCancellationError } from \"../errors/cancellation.error.js\";\nimport type { IScheduleOptions } from \"../models/options.model.js\";\nimport type { ITask } from \"../models/task.model.js\";\n\n/**\n * Internal tracking entry for throttled executions.\n */\ninterface IThrottleEntry<T = unknown> {\n  readonly key: string | symbol;\n  windowTimerId?: ReturnType<typeof setTimeout>;\n  trailingTask?: ITask<T>;\n  trailingOptions?: IScheduleOptions;\n  trailingResolve?: (value: T) => void;\n  trailingReject?: (reason: unknown) => void;\n  trailingPromise?: Promise<T>;\n  abortListener?: () => void;\n}\n\n/**\n * Coordinates throttle execution with leading execution, trailing execution,\n * and Promise coalescing by explicit key.\n *\n * Incoming calls with the same key within the throttle period coalesce into a\n * single shared trailing execution, preventing overload while ensuring callers\n * receive the final result.\n */\nexport class ThrottleCoordinator {\n  private readonly entries = new Map<string | symbol, IThrottleEntry<unknown>>();\n\n  /**\n   * Schedules a task under the throttle strategy.\n   *\n   * @param key - Explicit identity key.\n   * @param task - Work to execute.\n   * @param waitMs - Throttle interval duration in milliseconds.\n   * @param options - Scheduling options.\n   * @param dispatchFn - Callback invoked to dispatch task execution into the queue.\n   * @returns Promise resolving with the leading execution or coalesced trailing result.\n   */\n  public schedule<T>(\n    key: string | symbol,\n    task: ITask<T>,\n    waitMs: number,\n    options: IScheduleOptions | undefined,\n    dispatchFn: (task: ITask<T>, options?: IScheduleOptions) => Promise<T>\n  ): Promise<T> {\n    const existing = this.entries.get(key) as IThrottleEntry<T> | undefined;\n\n    if (!existing) {\n      // Leading execution: runs immediately\n      const entry: IThrottleEntry<T> = {\n        key,\n      };\n\n      entry.windowTimerId = setTimeout(() => {\n        void this.onWindowExpire(key, waitMs, dispatchFn);\n      }, waitMs);\n\n      this.entries.set(key, entry as IThrottleEntry<unknown>);\n\n      return dispatchFn(task, options);\n    }\n\n    // Trailing call within active window: coalesce with latest work\n    existing.trailingTask = task;\n    existing.trailingOptions = options;\n\n    if (existing.trailingPromise) {\n      return existing.trailingPromise;\n    }\n\n    let resolvePromise!: (value: T) => void;\n    let rejectPromise!: (reason: unknown) => void;\n\n    existing.trailingPromise = new Promise<T>((resolve, reject) => {\n      resolvePromise = resolve;\n      rejectPromise = reject;\n    });\n    existing.trailingResolve = resolvePromise;\n    existing.trailingReject = rejectPromise;\n\n    if (options?.signal) {\n      const listener = () => {\n        if (existing.trailingReject) {\n          existing.trailingReject(\n            new AhkoCancellationError(\"Throttled trailing task was cancelled\", {\n              cause: options.signal?.reason instanceof Error ? options.signal.reason : undefined,\n            })\n          );\n          existing.trailingTask = undefined;\n          existing.trailingOptions = undefined;\n          existing.trailingPromise = undefined;\n          existing.trailingResolve = undefined;\n          existing.trailingReject = undefined;\n        }\n      };\n      existing.abortListener = listener;\n      options.signal.addEventListener(\"abort\", listener, { once: true });\n    }\n\n    return existing.trailingPromise;\n  }\n\n  /**\n   * Invoked when the throttle interval window timer expires.\n   */\n  private async onWindowExpire<T>(\n    key: string | symbol,\n    waitMs: number,\n    dispatchFn: (task: ITask<T>, options?: IScheduleOptions) => Promise<T>\n  ): Promise<void> {\n    const entry = this.entries.get(key) as IThrottleEntry<T> | undefined;\n    if (!entry) {\n      return;\n    }\n\n    if (entry.trailingTask) {\n      const task = entry.trailingTask;\n      const options = entry.trailingOptions;\n      const resolve = entry.trailingResolve;\n      const reject = entry.trailingReject;\n\n      // Reset trailing slots for subsequent calls\n      entry.trailingTask = undefined;\n      entry.trailingOptions = undefined;\n      entry.trailingPromise = undefined;\n      entry.trailingResolve = undefined;\n      entry.trailingReject = undefined;\n\n      // Re-arm window timer for the trailing run\n      entry.windowTimerId = setTimeout(() => {\n        void this.onWindowExpire(key, waitMs, dispatchFn);\n      }, waitMs);\n\n      try {\n        const result = await dispatchFn(task, options);\n        resolve?.(result);\n      } catch (error) {\n        reject?.(error);\n      }\n      return;\n    }\n\n    // No trailing task arrived during the window: settle and delete key\n    this.entries.delete(key);\n  }\n\n  /**\n   * Cancels any pending trailing throttled task for a given key.\n   *\n   * @param key - Identity key to cancel.\n   * @param reason - Optional cancellation reason.\n   */\n  public cancel(key: string | symbol, reason?: unknown): void {\n    const entry = this.entries.get(key);\n    if (!entry) {\n      return;\n    }\n\n    if (entry.windowTimerId !== undefined) {\n      clearTimeout(entry.windowTimerId);\n    }\n    this.entries.delete(key);\n\n    if (entry.trailingReject) {\n      const cancelError = new AhkoCancellationError(\n        typeof reason === \"string\" ? reason : \"Throttled task was cancelled\",\n        { cause: reason instanceof Error ? reason : undefined }\n      );\n      entry.trailingReject(cancelError);\n    }\n  }\n\n  /**\n   * Number of keys currently actively throttled.\n   */\n  public get size(): number {\n    return this.entries.size;\n  }\n\n  /**\n   * Clears all throttled entries and timers.\n   */\n  public clear(): void {\n    for (const entry of this.entries.values()) {\n      if (entry.windowTimerId !== undefined) {\n        clearTimeout(entry.windowTimerId);\n      }\n      if (entry.trailingReject) {\n        entry.trailingReject(new AhkoCancellationError(\"Throttled tasks cleared\"));\n      }\n    }\n    this.entries.clear();\n  }\n}\n","import type {\n  IAhkoEventMap,\n  TAhkoEventHandler,\n  TAhkoEventName,\n  TAhkoUnsubscribe,\n} from \"../models/events.model.js\";\n\n/**\n * Lightweight, zero-dependency typed event emitter with safe error containment.\n */\nexport class AhkoEventEmitter {\n  private readonly listeners = new Map<\n    TAhkoEventName,\n    Set<TAhkoEventHandler<any>>\n  >();\n\n  /**\n   * Subscribes a listener to a specific Ahko lifecycle event.\n   *\n   * @param event - The event name to subscribe to.\n   * @param handler - The callback function to invoke when the event is emitted.\n   * @returns An unsubscribe function to remove the listener.\n   */\n  public on<K extends TAhkoEventName>(\n    event: K,\n    handler: TAhkoEventHandler<K>\n  ): TAhkoUnsubscribe {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n\n    set.add(handler);\n\n    return () => {\n      this.off(event, handler);\n    };\n  }\n\n  /**\n   * Unsubscribes a listener from a specific Ahko lifecycle event.\n   *\n   * @param event - The event name.\n   * @param handler - The callback function to remove.\n   */\n  public off<K extends TAhkoEventName>(\n    event: K,\n    handler: TAhkoEventHandler<K>\n  ): void {\n    const set = this.listeners.get(event);\n    if (set) {\n      set.delete(handler);\n      if (set.size === 0) {\n        this.listeners.delete(event);\n      }\n    }\n  }\n\n  /**\n   * Emits an event with the corresponding typed payload to all subscribed listeners.\n   * Listener invocations are safely isolated in try/catch to protect scheduler integrity.\n   *\n   * @param event - The event name to emit.\n   * @param payload - The event-specific payload data.\n   */\n  public emit<K extends TAhkoEventName>(\n    event: K,\n    payload: IAhkoEventMap[K]\n  ): void {\n    const set = this.listeners.get(event);\n    if (!set || set.size === 0) {\n      return;\n    }\n\n    // Iterate over shallow copy to tolerate in-flight unsubscriptions\n    const handlers = Array.from(set);\n    for (const handler of handlers) {\n      try {\n        const result = handler(payload);\n        if (result && typeof (result as Promise<void>).catch === \"function\") {\n          (result as Promise<void>).catch(() => {});\n        }\n      } catch {\n        // Error containment: listener exceptions do not disrupt scheduler operation\n      }\n    }\n  }\n\n  /**\n   * Removes all registered event listeners.\n   */\n  public clear(): void {\n    this.listeners.clear();\n  }\n}\n","import { AhkoConfigurationError } from \"../errors/configuration.error.js\";\nimport { AhkoTimeoutError } from \"../errors/timeout.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 { DebounceCoordinator } from \"./debounce-coordinator.js\";\nimport { IdleScheduler, type IIdleHandle } from \"./idle-scheduler.js\";\nimport { TaskRunner } from \"./task-runner.js\";\nimport { ThrottleCoordinator } from \"./throttle-coordinator.js\";\nimport { AhkoEventEmitter } from \"../events/event-emitter.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  /** Minimum interval in milliseconds between consecutive task starts */\n  public readonly minIntervalMs: number;\n\n  /** Timestamp of the most recent task start */\n  private lastTaskStartTime = 0;\n\n  /** Active rate limit timer for pacing consecutive tasks */\n  private rateLimitTimer?: ReturnType<typeof setTimeout>;\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  /** Coordinator for debounced tasks with key coalescing */\n  public readonly debounceCoordinator = new DebounceCoordinator();\n\n  /** Coordinator for throttled tasks with leading/trailing coalescing */\n  public readonly throttleCoordinator = new ThrottleCoordinator();\n\n  /** Lifecycle event emitter for task and scheduler events */\n  public readonly emitter = new AhkoEventEmitter();\n\n  /** Set of pending resolvers awaiting scheduler idle transition */\n  private readonly idleResolvers = new Set<() => void>();\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  /** Cumulative count of retry attempts triggered */\n  private retriedTasks = 0;\n\n  /** Cumulative count of tasks dispatched to concurrency slots */\n  private totalDispatched = 0;\n\n  /**\n   * Creates a new TaskQueue.\n   *\n   * @param concurrency - Maximum concurrent tasks (defaults to Infinity).\n   * @param minIntervalMs - Minimum interval in milliseconds between task dispatches.\n   * @throws {AhkoConfigurationError} If concurrency is less than 1 or minIntervalMs is invalid.\n   */\n  constructor(concurrency = Infinity, minIntervalMs = 0) {\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    if (\n      typeof minIntervalMs !== \"number\" ||\n      Number.isNaN(minIntervalMs) ||\n      !Number.isFinite(minIntervalMs) ||\n      minIntervalMs < 0\n    ) {\n      throw new AhkoConfigurationError(\n        `Invalid minIntervalMs \"${minIntervalMs}\". minIntervalMs must be a non-negative finite number.`\n      );\n    }\n    this.concurrency = concurrency;\n    this.minIntervalMs = minIntervalMs;\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      strategy !== EScheduleStrategy.THROTTLE &&\n      strategy !== EScheduleStrategy.DEBOUNCE\n    ) {\n      throw new AhkoConfigurationError(\n        `Unsupported schedule strategy \"${String(strategy)}\". Supported strategies: \"immediate\", \"delay\", \"idle\", \"throttle\", \"debounce\".`\n      );\n    }\n\n    if (strategy === EScheduleStrategy.THROTTLE || strategy === EScheduleStrategy.DEBOUNCE) {\n      if (!options?.key || (typeof options.key !== \"string\" && typeof options.key !== \"symbol\")) {\n        throw new AhkoConfigurationError(\n          `Strategy \"${strategy}\" requires a valid \"key\" of type string or symbol.`\n        );\n      }\n      const waitMs = options.waitMs ?? options.delay;\n      if (typeof waitMs !== \"number\" || Number.isNaN(waitMs) || !Number.isFinite(waitMs) || waitMs < 0) {\n        throw new AhkoConfigurationError(\n          `Strategy \"${strategy}\" requires a non-negative finite \"waitMs\" or \"delay\" in milliseconds.`\n        );\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?.timeoutMs !== undefined) {\n      if (\n        typeof options.timeoutMs !== \"number\" ||\n        Number.isNaN(options.timeoutMs) ||\n        !Number.isFinite(options.timeoutMs) ||\n        options.timeoutMs <= 0\n      ) {\n        throw new AhkoConfigurationError(\n          `Invalid timeoutMs \"${options.timeoutMs}\". timeoutMs must be a positive finite number greater than 0.`\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        this.emitter.emit(\"task:cancel\", {\n          taskId: runner.taskId,\n          reason: \"Task cancelled while queued\",\n        });\n        this.checkIdle();\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            this.emitter.emit(\"task:cancel\", {\n              taskId: runner.taskId,\n              reason: \"Task cancelled while queued\",\n            });\n            this.checkIdle();\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        this.emitter.emit(\"task:cancel\", {\n          taskId: runner.taskId,\n          reason: \"Task cancelled while waiting in delay\",\n        });\n        this.checkIdle();\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          this.emitter.emit(\"task:cancel\", {\n            taskId: runner.taskId,\n            reason: \"Task cancelled while queued\",\n          });\n          this.checkIdle();\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        this.emitter.emit(\"task:cancel\", {\n          taskId: runner.taskId,\n          reason: \"Task cancelled while waiting for idle\",\n        });\n        this.checkIdle();\n      }\n    };\n  }\n\n  /**\n   * Pumps the queue by picking pending tasks and executing them\n   * as long as concurrency capacity is available and minIntervalMs is respected.\n   */\n  private pump(): void {\n    if (this.queue.length === 0 || this.activeRunners.size >= this.concurrency) {\n      return;\n    }\n\n    if (this.minIntervalMs > 0 && this.lastTaskStartTime > 0) {\n      const now = Date.now();\n      const elapsed = now - this.lastTaskStartTime;\n      if (elapsed < this.minIntervalMs) {\n        if (this.rateLimitTimer === undefined) {\n          const delay = this.minIntervalMs - elapsed;\n          this.rateLimitTimer = setTimeout(() => {\n            this.rateLimitTimer = undefined;\n            this.pump();\n          }, delay);\n        }\n        return;\n      }\n    }\n\n    while (this.activeRunners.size < this.concurrency && this.queue.length > 0) {\n      if (this.minIntervalMs > 0 && this.lastTaskStartTime > 0) {\n        const now = Date.now();\n        const elapsed = now - this.lastTaskStartTime;\n        if (elapsed < this.minIntervalMs) {\n          if (this.rateLimitTimer === undefined) {\n            const delay = this.minIntervalMs - elapsed;\n            this.rateLimitTimer = setTimeout(() => {\n              this.rateLimitTimer = undefined;\n              this.pump();\n            }, delay);\n          }\n          break;\n        }\n      }\n\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      this.lastTaskStartTime = Date.now();\n\n      // Execute runner without unhandled rejection risk\n      void this.executeRunner(runner);\n\n      if (this.minIntervalMs > 0) {\n        if (this.queue.length > 0 && this.activeRunners.size < this.concurrency) {\n          if (this.rateLimitTimer === undefined) {\n            this.rateLimitTimer = setTimeout(() => {\n              this.rateLimitTimer = undefined;\n              this.pump();\n            }, this.minIntervalMs);\n          }\n        }\n        break;\n      }\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    this.totalDispatched++;\n    this.emitter.emit(\"task:start\", {\n      taskId: runner.taskId,\n      attempt: runner.attempt,\n    });\n\n    try {\n      const result = await runner.run();\n      this.completedTasks++;\n      this.activeRunners.delete(runner);\n      this.runnerOptions.delete(runner);\n      this.emitter.emit(\"task:complete\", {\n        taskId: runner.taskId,\n        attempt: runner.attempt,\n        durationMs: runner.lastDurationMs,\n        result,\n      });\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        this.emitter.emit(\"task:cancel\", {\n          taskId: runner.taskId,\n          reason: error,\n        });\n        runner.reject(error);\n        return;\n      }\n\n      const shouldRetry = await runner.canRetry(error, options?.retry);\n      if (shouldRetry) {\n        this.retriedTasks++;\n        // Free concurrency slot immediately during backoff\n        this.activeRunners.delete(runner);\n        this.emitter.emit(\"task:fail\", {\n          taskId: runner.taskId,\n          attempt: runner.attempt - 1,\n          error,\n          willRetry: true,\n        });\n        this.scheduleRetry(runner, options);\n        return;\n      }\n\n      if (runner.state === ETaskState.TIMED_OUT || error instanceof AhkoTimeoutError) {\n        this.timedOutTasks++;\n        this.emitter.emit(\"task:timeout\", {\n          taskId: runner.taskId,\n          timeoutMs: runner.timeoutMs,\n        });\n      } else {\n        this.failedTasks++;\n      }\n      this.activeRunners.delete(runner);\n      this.runnerOptions.delete(runner);\n      this.emitter.emit(\"task:fail\", {\n        taskId: runner.taskId,\n        attempt: runner.attempt,\n        error,\n        willRetry: false,\n      });\n      runner.reject(error);\n    } finally {\n      this.pump();\n      this.checkIdle();\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          this.emitter.emit(\"task:cancel\", {\n            taskId: runner.taskId,\n            reason: \"Task cancelled while queued\",\n          });\n          this.checkIdle();\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            this.emitter.emit(\"task:cancel\", {\n              taskId: runner.taskId,\n              reason: \"Task cancelled while queued\",\n            });\n            this.checkIdle();\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        this.emitter.emit(\"task:cancel\", {\n          taskId: runner.taskId,\n          reason: \"Task cancelled during retry backoff\",\n        });\n        this.checkIdle();\n      }\n    };\n  }\n\n  /**\n   * Checks whether the scheduler has transitioned to idle and notifies listeners/resolvers.\n   */\n  public checkIdle(): void {\n    if (this.isIdle()) {\n      if (this.idleResolvers.size > 0) {\n        for (const resolve of this.idleResolvers) {\n          resolve();\n        }\n        this.idleResolvers.clear();\n      }\n      this.emitter.emit(\"idle\", { timestamp: Date.now() });\n    }\n  }\n\n  /**\n   * Checks whether the scheduler is currently idle (no active runners and no pending tasks).\n   *\n   * @returns True if completely idle, false otherwise.\n   */\n  public isIdle(): boolean {\n    return (\n      this.activeRunners.size === 0 &&\n      this.queue.length === 0 &&\n      this.delayedEntries.size === 0 &&\n      this.idleEntries.size === 0 &&\n      this.retryEntries.size === 0 &&\n      this.debounceCoordinator.size === 0 &&\n      this.throttleCoordinator.size === 0\n    );\n  }\n\n  /**\n   * Returns a promise that resolves once the scheduler has processed all tasks and is idle.\n   *\n   * @returns Promise resolving when idle.\n   */\n  public onIdle(): Promise<void> {\n    if (this.isIdle()) {\n      return Promise.resolve();\n    }\n    return new Promise<void>((resolve) => {\n      this.idleResolvers.add(resolve);\n    });\n  }\n\n  /**\n   * Clears all pending and waiting tasks from the scheduler, cancelling their runners.\n   * Active tasks currently in flight will continue to run to completion or abort via signal.\n   */\n  public clear(): void {\n    while (this.queue.length > 0) {\n      const runner = this.queue.shift();\n      if (runner && runner.state !== ETaskState.CANCELLED) {\n        runner.cancel(\"Scheduler cleared\");\n        this.cancelledTasks++;\n        this.emitter.emit(\"task:cancel\", { taskId: runner.taskId, reason: \"Scheduler cleared\" });\n      }\n    }\n\n    for (const entry of this.delayedEntries.values()) {\n      clearTimeout(entry.timerId);\n      entry.runner.cancel(\"Scheduler cleared\");\n      this.cancelledTasks++;\n      this.emitter.emit(\"task:cancel\", { taskId: entry.runner.taskId, reason: \"Scheduler cleared\" });\n    }\n    this.delayedEntries.clear();\n\n    for (const entry of this.idleEntries.values()) {\n      entry.handle.cancel();\n      entry.runner.cancel(\"Scheduler cleared\");\n      this.cancelledTasks++;\n      this.emitter.emit(\"task:cancel\", { taskId: entry.runner.taskId, reason: \"Scheduler cleared\" });\n    }\n    this.idleEntries.clear();\n\n    for (const entry of this.retryEntries.values()) {\n      clearTimeout(entry.timerId);\n      entry.runner.cancel(\"Scheduler cleared\");\n      this.cancelledTasks++;\n      this.emitter.emit(\"task:cancel\", { taskId: entry.runner.taskId, reason: \"Scheduler cleared\" });\n    }\n    this.retryEntries.clear();\n\n    this.debounceCoordinator.clear();\n    this.throttleCoordinator.clear();\n\n    if (this.rateLimitTimer !== undefined) {\n      clearTimeout(this.rateLimitTimer);\n      this.rateLimitTimer = undefined;\n    }\n\n    this.checkIdle();\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        this.debounceCoordinator.size +\n        this.throttleCoordinator.size,\n      completedTasks: this.completedTasks,\n      failedTasks: this.failedTasks,\n      cancelledTasks: this.cancelledTasks,\n      timedOutTasks: this.timedOutTasks,\n      retriedTasks: this.retriedTasks,\n      totalDispatched: this.totalDispatched,\n      capacity: this.concurrency,\n    });\n  }\n}\n","import { AhkoCancellationError } from \"../errors/cancellation.error.js\";\nimport { AhkoTimeoutError } from \"../errors/timeout.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, timeout enforcement, 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 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  public readonly externalSignal?: AbortSignal;\n\n  /** Maximum execution duration allowed in milliseconds */\n  public readonly timeoutMs?: number;\n\n  /** Active timeout timer identifier */\n  private timeoutTimerId?: ReturnType<typeof setTimeout>;\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  /** Current execution attempt count (1-indexed) */\n  public attempt = 1;\n\n  /** Duration of the most recent execution attempt in milliseconds */\n  public lastDurationMs = 0;\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   * @param timeoutMs - Optional maximum execution time in milliseconds.\n   */\n  constructor(task: ITask<T>, externalSignal?: AbortSignal, timeoutMs?: number) {\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.timeoutMs = timeoutMs;\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.abortController.abort(cancelError);\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.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 or timeout.\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.externalSignal?.aborted ?? false)) {\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    this.abortController = new AbortController();\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/timeout.\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    let abortListener: (() => void) | undefined;\n\n    const abortPromise = new Promise<never>((_, reject) => {\n      abortListener = () => {\n        if (this._state === ETaskState.TIMED_OUT) {\n          reject(\n            new AhkoTimeoutError(\n              `Task execution timed out after ${this.timeoutMs}ms`,\n              { timeoutMs: this.timeoutMs }\n            )\n          );\n        } else {\n          const reason = this.abortController.signal.reason;\n          reject(\n            new AhkoCancellationError(\"Task was cancelled during execution\", {\n              cause: reason instanceof Error ? reason : undefined,\n            })\n          );\n        }\n      };\n      this.abortController.signal.addEventListener(\"abort\", abortListener, { once: true });\n    });\n\n    let timeoutPromise: Promise<never> | undefined;\n    if (this.timeoutMs !== undefined) {\n      timeoutPromise = new Promise<never>((_, reject) => {\n        this.timeoutTimerId = setTimeout(() => {\n          if (this._state !== ETaskState.RUNNING) {\n            return;\n          }\n          this._state = ETaskState.TIMED_OUT;\n          const timeoutError = new AhkoTimeoutError(\n            `Task execution timed out after ${this.timeoutMs}ms`,\n            { timeoutMs: this.timeoutMs }\n          );\n          this.abortController.abort(timeoutError);\n          reject(timeoutError);\n        }, this.timeoutMs);\n      });\n    }\n\n    let taskExecutionPromise: Promise<T>;\n    try {\n      taskExecutionPromise = Promise.resolve(this.task(context));\n    } catch (syncError) {\n      taskExecutionPromise = Promise.reject(syncError);\n    }\n\n    // Suppress unhandled rejection in background if task finishes or fails after timeout/cancellation\n    taskExecutionPromise.catch(() => {});\n\n    const racePromises: Array<Promise<T | never>> = [\n      taskExecutionPromise,\n      abortPromise,\n    ];\n    if (timeoutPromise) {\n      racePromises.push(timeoutPromise);\n    }\n\n    const startTime = Date.now();\n\n    try {\n      const result = await Promise.race(racePromises);\n      this.clearTimeoutTimer();\n      this.lastDurationMs = Math.max(0, Date.now() - startTime);\n      if (abortListener) {\n        this.abortController.signal.removeEventListener(\"abort\", abortListener);\n      }\n\n      if ((this._state as ETaskState) === ETaskState.TIMED_OUT) {\n        throw new AhkoTimeoutError(\n          `Task execution timed out after ${this.timeoutMs}ms`,\n          { timeoutMs: this.timeoutMs }\n        );\n      }\n\n      if ((this._state as ETaskState) === ETaskState.CANCELLED) {\n        throw new AhkoCancellationError(\"Task was cancelled during execution\");\n      }\n\n      this._state = ETaskState.COMPLETED;\n      return result;\n    } catch (error) {\n      this.clearTimeoutTimer();\n      this.lastDurationMs = Math.max(0, Date.now() - startTime);\n      if (abortListener) {\n        this.abortController.signal.removeEventListener(\"abort\", abortListener);\n      }\n\n      if ((this._state as ETaskState) === ETaskState.TIMED_OUT || error instanceof AhkoTimeoutError) {\n        this._state = ETaskState.TIMED_OUT;\n        if (error instanceof AhkoTimeoutError) {\n          throw error;\n        }\n        throw new AhkoTimeoutError(\n          `Task execution timed out after ${this.timeoutMs}ms`,\n          {\n            timeoutMs: this.timeoutMs,\n            cause: error instanceof Error ? error : undefined,\n          }\n        );\n      }\n\n      const isCancelled =\n        (this._state as ETaskState) === ETaskState.CANCELLED ||\n        this.abortController.signal.aborted ||\n        (this.externalSignal?.aborted ?? false);\n\n      if (isCancelled) {\n        this._state = ETaskState.CANCELLED;\n        if (error instanceof AhkoCancellationError) {\n          throw error;\n        }\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   * Clears the active timeout timer.\n   */\n  private clearTimeoutTimer(): void {\n    if (this.timeoutTimerId !== undefined) {\n      clearTimeout(this.timeoutTimerId);\n      this.timeoutTimerId = undefined;\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.clearTimeoutTimer();\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    this.clearTimeoutTimer();\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 { TAhkoEventName, TAhkoEventHandler, TAhkoUnsubscribe } from \"./models/events.model.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, options?.minIntervalMs);\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   * @throws {AhkoTimeoutError} If task execution exceeds timeoutMs.\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 strategy = options?.strategy ?? EScheduleStrategy.IMMEDIATE;\n\n    if (strategy === EScheduleStrategy.DEBOUNCE) {\n      if (!options?.key || (typeof options.key !== \"string\" && typeof options.key !== \"symbol\")) {\n        throw new AhkoConfigurationError(\n          `Strategy \"debounce\" requires a valid \"key\" of type string or symbol.`\n        );\n      }\n      const waitMs = options.waitMs ?? options.delay;\n      if (typeof waitMs !== \"number\" || Number.isNaN(waitMs) || !Number.isFinite(waitMs) || waitMs < 0) {\n        throw new AhkoConfigurationError(\n          `Strategy \"debounce\" requires a non-negative finite \"waitMs\" or \"delay\" in milliseconds.`\n        );\n      }\n      return this.queue.debounceCoordinator.schedule(\n        options.key,\n        task,\n        waitMs,\n        options,\n        (t, opts) => this.schedule(t, { ...opts, strategy: EScheduleStrategy.IMMEDIATE })\n      );\n    }\n\n    if (strategy === EScheduleStrategy.THROTTLE) {\n      if (!options?.key || (typeof options.key !== \"string\" && typeof options.key !== \"symbol\")) {\n        throw new AhkoConfigurationError(\n          `Strategy \"throttle\" requires a valid \"key\" of type string or symbol.`\n        );\n      }\n      const waitMs = options.waitMs ?? options.delay;\n      if (typeof waitMs !== \"number\" || Number.isNaN(waitMs) || !Number.isFinite(waitMs) || waitMs < 0) {\n        throw new AhkoConfigurationError(\n          `Strategy \"throttle\" requires a non-negative finite \"waitMs\" or \"delay\" in milliseconds.`\n        );\n      }\n      return this.queue.throttleCoordinator.schedule(\n        options.key,\n        task,\n        waitMs,\n        options,\n        (t, opts) => this.schedule(t, { ...opts, strategy: EScheduleStrategy.IMMEDIATE })\n      );\n    }\n\n    const runner = new TaskRunner<T>(task, options?.signal, options?.timeoutMs);\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  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   * Convenience method to schedule a debounced task with key-based Promise coalescing.\n   *\n   * @template T - Inferred return type of the task.\n   * @param key - Explicit identity key.\n   * @param task - Work to execute once calls stop arriving.\n   * @param waitMs - Quiet window duration in milliseconds.\n   * @param options - Additional schedule options.\n   * @returns Shared promise resolving with the final execution outcome.\n   */\n  public debounce<T>(\n    key: string | symbol,\n    task: ITask<T>,\n    waitMs: number,\n    options?: Omit<IScheduleOptions, \"strategy\" | \"key\" | \"waitMs\">\n  ): Promise<T> {\n    return this.schedule(task, {\n      ...options,\n      strategy: EScheduleStrategy.DEBOUNCE,\n      key,\n      waitMs,\n    });\n  }\n\n  /**\n   * Convenience method to schedule a throttled task with leading execution and coalesced trailing run.\n   *\n   * @template T - Inferred return type of the task.\n   * @param key - Explicit identity key.\n   * @param task - Work to execute.\n   * @param waitMs - Throttle interval duration in milliseconds.\n   * @param options - Additional schedule options.\n   * @returns Promise resolving with the leading or coalesced trailing result.\n   */\n  public throttle<T>(\n    key: string | symbol,\n    task: ITask<T>,\n    waitMs: number,\n    options?: Omit<IScheduleOptions, \"strategy\" | \"key\" | \"waitMs\">\n  ): Promise<T> {\n    return this.schedule(task, {\n      ...options,\n      strategy: EScheduleStrategy.THROTTLE,\n      key,\n      waitMs,\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   * Subscribes to a scheduler lifecycle event.\n   *\n   * @param event - Event name to listen for.\n   * @param handler - Callback function invoked when the event is emitted.\n   * @returns Unsubscribe function to remove the listener.\n   *\n   * @example\n   * ```typescript\n   * const unsubscribe = ahko.on(\"task:start\", ({ taskId, attempt }) => {\n   *   console.log(`Task ${taskId} started attempt ${attempt}`);\n   * });\n   * ```\n   */\n  public on<K extends TAhkoEventName>(event: K, handler: TAhkoEventHandler<K>): TAhkoUnsubscribe {\n    return this.queue.emitter.on(event, handler);\n  }\n\n  /**\n   * Unsubscribes an event listener from a scheduler lifecycle event.\n   *\n   * @param event - Event name.\n   * @param handler - The exact listener callback to remove.\n   */\n  public off<K extends TAhkoEventName>(event: K, handler: TAhkoEventHandler<K>): void {\n    this.queue.emitter.off(event, handler);\n  }\n\n  /**\n   * Checks whether the scheduler is currently idle (no active runners and no pending tasks).\n   *\n   * @returns True if completely idle, false otherwise.\n   */\n  public isIdle(): boolean {\n    return this.queue.isIdle();\n  }\n\n  /**\n   * Returns a promise that resolves once the scheduler has completed all tasks and is idle.\n   *\n   * @returns Promise resolving when the scheduler is idle.\n   *\n   * @example\n   * ```typescript\n   * ahko.schedule(doWork);\n   * await ahko.onIdle();\n   * console.log(\"All work finished!\");\n   * ```\n   */\n  public onIdle(): Promise<void> {\n    return this.queue.onIdle();\n  }\n\n  /**\n   * Clears all pending, delayed, and throttled/debounced tasks from the scheduler.\n   * In-flight active tasks will continue executing to completion or abort via signal.\n   */\n  public clear(): void {\n    this.queue.clear();\n  }\n\n  /**\n   * Returns the delightful Ahko mascot battery telemetry status.\n   *\n   * Low energy, completely chill.\n   */\n  public battery(): { level: number; chill: boolean; status: string; quote: string } {\n    return {\n      level: 3,\n      chill: true,\n      status: \"low-energy\",\n      quote: \"Mwee... my battery is low, but all your tasks are handled completely chill.\",\n    };\n  }\n\n  /**\n   * Delightful alias for `onIdle()`: wait for all tasks to settle chill and relaxed.\n   *\n   * @returns Promise resolving when all tasks have finished.\n   */\n  public chill(): Promise<void> {\n    return this.onIdle();\n  }\n}\n","/**\n * Current version of @mrjacket/ahko package.\n */\nexport const VERSION = \"0.6.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","/**\n * Result of combining multiple AbortSignals.\n */\nexport interface ICombinedSignal {\n  /**\n   * The unified AbortSignal that aborts when any source signal aborts.\n   */\n  readonly signal: AbortSignal;\n\n  /**\n   * Detaches all registered event listeners from source signals to prevent memory leaks.\n   */\n  cleanup: () => void;\n}\n\n/**\n * Combines multiple AbortSignals into a single coordinated AbortSignal with deterministic cleanup.\n *\n * @param signals - Array of source AbortSignals (undefined entries are ignored).\n * @returns A unified signal interface with explicit cleanup callback.\n */\nexport function combineSignals(\n  signals: ReadonlyArray<AbortSignal | undefined>\n): ICombinedSignal {\n  const activeSignals = signals.filter(\n    (signal): signal is AbortSignal => signal !== undefined\n  );\n\n  if (activeSignals.length === 0) {\n    const controller = new AbortController();\n    return {\n      signal: controller.signal,\n      cleanup: () => {},\n    };\n  }\n\n  // Check if any source signal is already aborted\n  const alreadyAborted = activeSignals.find((s) => s.aborted);\n  if (alreadyAborted) {\n    const controller = new AbortController();\n    controller.abort(alreadyAborted.reason);\n    return {\n      signal: controller.signal,\n      cleanup: () => {},\n    };\n  }\n\n  if (activeSignals.length === 1) {\n    return {\n      signal: activeSignals[0],\n      cleanup: () => {},\n    };\n  }\n\n  const controller = new AbortController();\n  const cleanupFns: Array<() => void> = [];\n\n  const onAbort = (event: Event): void => {\n    const target = event.target as AbortSignal;\n    cleanup();\n    controller.abort(target.reason);\n  };\n\n  for (const sig of activeSignals) {\n    sig.addEventListener(\"abort\", onAbort, { once: true });\n    cleanupFns.push(() => {\n      sig.removeEventListener(\"abort\", onAbort);\n    });\n  }\n\n  const cleanup = (): void => {\n    for (const fn of cleanupFns) {\n      fn();\n    }\n    cleanupFns.length = 0;\n  };\n\n  return {\n    signal: controller.signal,\n    cleanup,\n  };\n}\n"],"mappings":"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","names":["EScheduleStrategy","ETaskState","controller"]}

package/dist/models/events.model.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Event payloads emitted across task and scheduler lifecycles.
+ */
+export interface IAhkoEventMap {
+    /** Emitted when a task acquires a concurrency slot and begins execution */
+    "task:start": {
+        taskId: string;
+        attempt: number;
+    };
+    /** Emitted when a task completes execution successfully */
+    "task:complete": {
+        taskId: string;
+        attempt: number;
+        durationMs: number;
+        result: unknown;
+    };
+    /** Emitted when a task execution attempt fails */
+    "task:fail": {
+        taskId: string;
+        attempt: number;
+        error: unknown;
+        willRetry: boolean;
+    };
+    /** Emitted when a task is cancelled */
+    "task:cancel": {
+        taskId: string;
+        reason?: unknown;
+    };
+    /** Emitted when a task execution exceeds its configured timeoutMs */
+    "task:timeout": {
+        taskId: string;
+        timeoutMs?: number;
+    };
+    /** Emitted when the scheduler becomes completely idle (no active or pending tasks) */
+    idle: {
+        timestamp: number;
+    };
+}
+/**
+ * Union of all valid event names emitted by the Ahko scheduler.
+ */
+export type TAhkoEventName = keyof IAhkoEventMap;
+/**
+ * Event handler callback signature for a specific Ahko event.
+ */
+export type TAhkoEventHandler<K extends TAhkoEventName> = (payload: IAhkoEventMap[K]) => void | Promise<void>;
+/**
+ * Function invoked to unsubscribe a previously registered event listener.
+ */
+export type TAhkoUnsubscribe = () => void;

package/dist/models/index.d.ts

@@ -5,3 +5,4 @@ export * from "./state.model.js";
 export * from "./stats.model.js";
 export * from "./strategy.model.js";
 export * from "./task.model.js";
+export * from "./events.model.js";

package/dist/models/options.model.d.ts

@@ -31,6 +31,16 @@ export interface IScheduleOptions {
      * Must be a positive finite number greater than 0 if provided.
      */
     timeoutMs?: number;
+    /**
+     * Explicit identity key for "debounce" and "throttle" strategies.
+     * Tasks sharing the same key coalesce into shared executions.
+     */
+    key?: string | symbol;
+    /**
+     * Duration in milliseconds for debounce quiet window or throttle period.
+     * If omitted, falls back to `delay` if specified.
+     */
+    waitMs?: number;
     /**
      * External cancellation signal.
      * If aborted before start, the task is removed from the queue without execution.
@@ -48,4 +58,11 @@ export interface IAhkoOptions {
      * @default Infinity
      */
     concurrency?: number;
+    /**
+     * Minimum interval in milliseconds that must elapse between consecutive task starts.
+     * Paces task execution to prevent burst workloads even when concurrency slots are free.
+     * Must be a non-negative finite number if provided.
+     * @default 0
+     */
+    minIntervalMs?: number;
 }

package/dist/models/stats.model.d.ts

@@ -14,6 +14,10 @@ export interface IAhkoStats {
     cancelledTasks: number;
     /** Cumulative count of timed out tasks */
     timedOutTasks: number;
+    /** Cumulative count of retry attempts triggered */
+    retriedTasks: number;
+    /** Cumulative count of tasks dispatched to concurrency slots */
+    totalDispatched: number;
     /** Maximum concurrent execution capacity */
     capacity: number;
 }

package/dist/models/strategy.model.d.ts

@@ -7,9 +7,13 @@ export declare enum EScheduleStrategy {
     /** Delay execution for a designated duration before queuing */
     DELAY = "delay",
     /** Execute during platform idle opportunities (requestIdleCallback in browser, setImmediate in Node.js) */
-    IDLE = "idle"
+    IDLE = "idle",
+    /** Enforce maximum execution frequency for tasks sharing the same key */
+    THROTTLE = "throttle",
+    /** Delay execution until calls sharing the same key stop arriving */
+    DEBOUNCE = "debounce"
 }
 /**
  * Union type representing valid scheduling strategy identifiers.
  */
-export type TScheduleStrategy = EScheduleStrategy | "immediate" | "delay" | "idle";
+export type TScheduleStrategy = EScheduleStrategy | "immediate" | "delay" | "idle" | "throttle" | "debounce";

package/dist/scheduler/debounce-coordinator.d.ts

@@ -0,0 +1,41 @@
+import type { IScheduleOptions } from "../models/options.model.js";
+import type { ITask } from "../models/task.model.js";
+/**
+ * Coordinates debounce execution with Promise coalescing by explicit key.
+ *
+ * Incoming calls with the same key extend the quiet window and share the
+ * eventual execution Promise, guaranteeing that all callers receive the final result.
+ */
+export declare class DebounceCoordinator {
+    private readonly entries;
+    /**
+     * Schedules a task under the debounce strategy.
+     *
+     * @param key - Explicit identity key.
+     * @param task - Work to execute once calls stop arriving.
+     * @param waitMs - Quiet window duration in milliseconds.
+     * @param options - Scheduling options.
+     * @param dispatchFn - Callback invoked when the debounce window expires to dispatch the task to the queue.
+     * @returns Shared promise that resolves/rejects with the final execution outcome.
+     */
+    schedule<T>(key: string | symbol, task: ITask<T>, waitMs: number, options: IScheduleOptions | undefined, dispatchFn: (task: ITask<T>, options?: IScheduleOptions) => Promise<T>): Promise<T>;
+    /**
+     * Dispatches the coalesced task when the quiet window expires.
+     */
+    private flush;
+    /**
+     * Cancels a pending debounced task by key.
+     *
+     * @param key - Identity key to cancel.
+     * @param reason - Optional cancellation reason.
+     */
+    cancel(key: string | symbol, reason?: unknown): void;
+    /**
+     * Number of pending debounced tasks waiting for quiet window expiry.
+     */
+    get size(): number;
+    /**
+     * Cancels all pending debounced entries and clears the map.
+     */
+    clear(): void;
+}