@sejinjja/promise-pool-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sejinjja
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# @sejinjja/promise-pool-kit
+
+Lightweight TypeScript utilities for async workloads:
+
+- retry with exponential backoff and jitter
+- task-level timeout
+- concurrency-limited promise pool
+- abort signal support
+
+## Installation
+
+```bash
+npm i @sejinjja/promise-pool-kit
+```
+
+## Quick Start
+
+```ts
+import { runPool } from "@sejinjja/promise-pool-kit";
+
+const urls = [
+  "https://api.example.com/a",
+  "https://api.example.com/b",
+  "https://api.example.com/c"
+];
+
+const result = await runPool(
+  urls,
+  async (url, { signal }) => {
+    const response = await fetch(url, { signal });
+    if (!response.ok) throw new Error(`Request failed: ${response.status}`);
+    return response.json();
+  },
+  {
+    concurrency: 4,
+    timeoutMs: 5000,
+    retry: {
+      retries: 2,
+      minDelayMs: 200,
+      maxDelayMs: 2000,
+      jitter: "full"
+    }
+  }
+);
+
+if (result.hasErrors) {
+  console.error(result.rejected);
+} else {
+  console.log(result.fulfilled.map((item) => item.value));
+}
+```
+
+## API
+
+### `retry(operation, options?)`
+
+Retry a single async operation.
+
+```ts
+import { retry } from "@sejinjja/promise-pool-kit";
+
+const token = await retry(
+  async (attempt) => {
+    const response = await fetch("https://example.com/token");
+    if (!response.ok) throw new Error(`Failed attempt ${attempt}`);
+    return response.text();
+  },
+  {
+    retries: 3,
+    minDelayMs: 100,
+    maxDelayMs: 2000,
+    jitter: "full",
+    timeoutMs: 3000
+  }
+);
+```
+
+### `runPool(inputs, worker, options?)`
+
+Run tasks with controlled concurrency.
+
+- `concurrency` default: `5`
+- `stopOnError` default: `false`
+- `timeoutMs` applies per task attempt
+- `retry` applies per task
+- `onProgress` receives current summary and last settled task
+
+### `assertPoolSuccess(result)`
+
+Throw `AggregateError` when `runPool` contains rejected tasks.
+
+## Error Types
+
+- `PoolAbortedError`
+- `TaskTimeoutError`
+
+## Local Development
+
+```bash
+npm install
+npm run check
+```
+
+## Open Source Workflow
+
+1. Open an issue or discussion.
+2. Create a branch and add tests for behavior changes.
+3. Submit a pull request using the template.
+
+## Publishing
+
+```bash
+npm run check
+npm publish --access public
+```
+
+If the package is scoped and first publish fails, verify your npm scope ownership:
+
+```bash
+npm whoami
+npm access ls-packages <your-npm-id>
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,424 @@
+'use strict';
+
+// src/index.ts
+var PoolAbortedError = class extends Error {
+  constructor(message = "Operation aborted.") {
+    super(message);
+    this.name = "PoolAbortedError";
+  }
+};
+var TaskTimeoutError = class extends Error {
+  constructor(taskIndex, timeoutMs) {
+    super(
+      taskIndex >= 0 ? `Task ${taskIndex} timed out after ${timeoutMs}ms.` : `Operation timed out after ${timeoutMs}ms.`
+    );
+    this.name = "TaskTimeoutError";
+    this.taskIndex = taskIndex;
+    this.timeoutMs = timeoutMs;
+  }
+};
+var DEFAULT_RETRY = {
+  retries: 0,
+  minDelayMs: 100,
+  maxDelayMs: 5e3,
+  factor: 2,
+  jitter: "none",
+  shouldRetry: (error) => !(error instanceof PoolAbortedError)
+};
+function toAbortError(reason, fallbackMessage) {
+  if (reason instanceof Error) {
+    return reason;
+  }
+  if (typeof reason === "string" && reason.trim().length > 0) {
+    return new PoolAbortedError(reason);
+  }
+  return new PoolAbortedError(fallbackMessage);
+}
+function asNonNegativeInteger(value, name, fallback) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+    throw new TypeError(`${name} must be a non-negative integer.`);
+  }
+  return value;
+}
+function asPositiveInteger(value, name, fallback) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {
+    throw new TypeError(`${name} must be a positive integer.`);
+  }
+  return value;
+}
+function asPositiveNumber(value, name, fallback) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (!Number.isFinite(value) || value <= 0) {
+    throw new TypeError(`${name} must be a positive number.`);
+  }
+  return value;
+}
+function asOptionalPositiveInteger(value, name) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {
+    throw new TypeError(`${name} must be a positive integer.`);
+  }
+  return value;
+}
+function normalizeRetryOptions(options) {
+  const retries = asNonNegativeInteger(options?.retries, "retries", DEFAULT_RETRY.retries);
+  const minDelayMs = asPositiveInteger(options?.minDelayMs, "minDelayMs", DEFAULT_RETRY.minDelayMs);
+  const maxDelayMs = asPositiveInteger(options?.maxDelayMs, "maxDelayMs", DEFAULT_RETRY.maxDelayMs);
+  const factor = asPositiveNumber(options?.factor, "factor", DEFAULT_RETRY.factor);
+  const jitter = options?.jitter ?? DEFAULT_RETRY.jitter;
+  if (jitter !== "none" && jitter !== "full") {
+    throw new TypeError("jitter must be either 'none' or 'full'.");
+  }
+  if (minDelayMs > maxDelayMs) {
+    throw new TypeError("minDelayMs cannot be larger than maxDelayMs.");
+  }
+  return {
+    retries,
+    minDelayMs,
+    maxDelayMs,
+    factor,
+    jitter,
+    shouldRetry: options?.shouldRetry ?? DEFAULT_RETRY.shouldRetry
+  };
+}
+function computeDelayMs(options, retryAttempt) {
+  const exponential = options.minDelayMs * options.factor ** Math.max(retryAttempt - 1, 0);
+  const bounded = Math.min(exponential, options.maxDelayMs);
+  if (options.jitter === "full") {
+    return Math.floor(Math.random() * (bounded + 1));
+  }
+  return Math.floor(bounded);
+}
+function createLinkedAbortController(signals, fallbackMessage) {
+  const controller = new AbortController();
+  const listeners = [];
+  for (const signal of signals) {
+    if (!signal) {
+      continue;
+    }
+    if (signal.aborted) {
+      controller.abort(toAbortError(signal.reason, fallbackMessage));
+      break;
+    }
+    const listener = () => {
+      if (!controller.signal.aborted) {
+        controller.abort(toAbortError(signal.reason, fallbackMessage));
+      }
+    };
+    signal.addEventListener("abort", listener, { once: true });
+    listeners.push({ signal, listener });
+  }
+  const cleanup = () => {
+    for (const { signal, listener } of listeners) {
+      signal.removeEventListener("abort", listener);
+    }
+  };
+  return { controller, cleanup };
+}
+function createAbortPromise(signal, fallbackMessage) {
+  let listener;
+  const promise = new Promise((_, reject) => {
+    listener = () => reject(toAbortError(signal.reason, fallbackMessage));
+    if (signal.aborted) {
+      listener();
+      return;
+    }
+    signal.addEventListener("abort", listener, { once: true });
+  });
+  return {
+    promise,
+    cleanup: () => {
+      if (listener) {
+        signal.removeEventListener("abort", listener);
+      }
+    }
+  };
+}
+async function sleep(delayMs, signal, abortMessage) {
+  if (delayMs <= 0) {
+    return;
+  }
+  await new Promise((resolve, reject) => {
+    if (signal.aborted) {
+      reject(toAbortError(signal.reason, abortMessage));
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, delayMs);
+    const onAbort = () => {
+      clearTimeout(timer);
+      signal.removeEventListener("abort", onAbort);
+      reject(toAbortError(signal.reason, abortMessage));
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function runWithAttemptTimeout(operation, options) {
+  const { controller, cleanup } = createLinkedAbortController([options.signal], options.abortMessage);
+  let timeoutHandle;
+  let timeoutPromise;
+  const operationPromise = Promise.resolve().then(() => operation(controller.signal));
+  const { promise: abortPromise, cleanup: cleanupAbortPromise } = createAbortPromise(
+    controller.signal,
+    options.abortMessage
+  );
+  if (typeof options.timeoutMs === "number") {
+    timeoutPromise = new Promise((_, reject) => {
+      timeoutHandle = setTimeout(() => {
+        const timeoutError = options.timeoutErrorFactory();
+        if (!controller.signal.aborted) {
+          controller.abort(timeoutError);
+        }
+        reject(timeoutError);
+      }, options.timeoutMs);
+    });
+  }
+  try {
+    const contenders = [operationPromise, abortPromise];
+    if (timeoutPromise) {
+      contenders.push(timeoutPromise);
+    }
+    return await Promise.race(contenders);
+  } finally {
+    cleanupAbortPromise();
+    cleanup();
+    if (timeoutHandle) {
+      clearTimeout(timeoutHandle);
+    }
+  }
+}
+async function retry(operation, options = {}) {
+  const normalized = normalizeRetryOptions(options);
+  const timeoutMs = asOptionalPositiveInteger(options.timeoutMs, "timeoutMs");
+  const { controller, cleanup } = createLinkedAbortController([options.signal], "Retry operation aborted.");
+  const maxAttempts = normalized.retries + 1;
+  try {
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+      try {
+        return await runWithAttemptTimeout(
+          (signal) => operation(attempt, signal),
+          {
+            signal: controller.signal,
+            timeoutMs,
+            timeoutErrorFactory: () => new TaskTimeoutError(-1, timeoutMs ?? 0),
+            abortMessage: "Retry operation aborted."
+          }
+        );
+      } catch (error) {
+        if (attempt >= maxAttempts) {
+          throw error;
+        }
+        const shouldRetry = await normalized.shouldRetry(error, attempt);
+        if (!shouldRetry) {
+          throw error;
+        }
+        const delayMs = computeDelayMs(normalized, attempt);
+        options.onRetry?.({
+          attempt,
+          nextAttempt: attempt + 1,
+          delayMs,
+          error
+        });
+        await sleep(delayMs, controller.signal, "Retry wait aborted.");
+      }
+    }
+  } finally {
+    cleanup();
+  }
+  throw new Error("Unreachable retry state.");
+}
+function toPoolResultError(reason) {
+  if (reason instanceof Error) {
+    return reason;
+  }
+  if (typeof reason === "string" && reason.trim().length > 0) {
+    return new Error(reason);
+  }
+  return reason;
+}
+function isRejected(result) {
+  return result.status === "rejected";
+}
+function isFulfilled(result) {
+  return result.status === "fulfilled";
+}
+async function runPool(inputs, worker, options = {}) {
+  const items = Array.isArray(inputs) ? inputs.slice() : Array.from(inputs);
+  const total = items.length;
+  if (total === 0) {
+    return {
+      total: 0,
+      completed: 0,
+      succeeded: 0,
+      failed: 0,
+      hasErrors: false,
+      results: [],
+      fulfilled: [],
+      rejected: []
+    };
+  }
+  const retryOptions = normalizeRetryOptions(options.retry);
+  const timeoutMs = asOptionalPositiveInteger(options.timeoutMs, "timeoutMs");
+  const stopOnError = options.stopOnError ?? false;
+  const concurrency = Math.min(asPositiveInteger(options.concurrency, "concurrency", 5), total);
+  const { controller: poolController, cleanup } = createLinkedAbortController(
+    [options.signal],
+    "Pool execution aborted."
+  );
+  const results = new Array(total);
+  let nextIndex = 0;
+  let running = 0;
+  let completed = 0;
+  let succeeded = 0;
+  let failed = 0;
+  const emitProgress = (lastResult) => {
+    options.onProgress?.({
+      total,
+      completed,
+      succeeded,
+      failed,
+      running,
+      pending: Math.max(total - completed - running, 0),
+      percentage: Math.round(completed / total * 100),
+      lastResult
+    });
+  };
+  const runSingle = async (index) => {
+    const input = items[index];
+    const startedAt = Date.now();
+    let attempts = 0;
+    let settled;
+    running += 1;
+    try {
+      const value = await retry(
+        async (attempt, signal) => {
+          attempts = attempt;
+          return worker(input, { index, attempt, signal });
+        },
+        {
+          ...retryOptions,
+          signal: poolController.signal,
+          timeoutMs
+        }
+      );
+      settled = {
+        status: "fulfilled",
+        index,
+        input,
+        value,
+        attempts,
+        durationMs: Date.now() - startedAt
+      };
+      succeeded += 1;
+      completed += 1;
+      results[index] = settled;
+    } catch (error) {
+      settled = {
+        status: "rejected",
+        index,
+        input,
+        reason: toPoolResultError(error),
+        attempts,
+        durationMs: Date.now() - startedAt
+      };
+      failed += 1;
+      completed += 1;
+      results[index] = settled;
+      if (stopOnError && !poolController.signal.aborted) {
+        poolController.abort(new PoolAbortedError(`Pool aborted because task ${index} failed.`));
+      }
+    } finally {
+      running -= 1;
+      if (settled) {
+        emitProgress(settled);
+      }
+    }
+  };
+  const runner = async () => {
+    while (!poolController.signal.aborted) {
+      const index = nextIndex;
+      if (index >= total) {
+        return;
+      }
+      nextIndex += 1;
+      await runSingle(index);
+    }
+  };
+  try {
+    await Promise.all(Array.from({ length: concurrency }, () => runner()));
+  } finally {
+    cleanup();
+  }
+  if (poolController.signal.aborted) {
+    const abortError = toAbortError(poolController.signal.reason, "Pool execution aborted.");
+    for (let index = 0; index < total; index += 1) {
+      if (results[index]) {
+        continue;
+      }
+      const settled = {
+        status: "rejected",
+        index,
+        input: items[index],
+        reason: abortError,
+        attempts: 0,
+        durationMs: 0
+      };
+      results[index] = settled;
+      failed += 1;
+      completed += 1;
+      emitProgress(settled);
+    }
+  }
+  const settledResults = results.map((result, index) => {
+    if (result) {
+      return result;
+    }
+    return {
+      status: "rejected",
+      index,
+      input: items[index],
+      reason: new PoolAbortedError("Task did not execute."),
+      attempts: 0,
+      durationMs: 0
+    };
+  });
+  const fulfilled = settledResults.filter(isFulfilled);
+  const rejected = settledResults.filter(isRejected);
+  return {
+    total,
+    completed: settledResults.length,
+    succeeded: fulfilled.length,
+    failed: rejected.length,
+    hasErrors: rejected.length > 0,
+    results: settledResults,
+    fulfilled,
+    rejected
+  };
+}
+function assertPoolSuccess(result) {
+  if (!result.hasErrors) {
+    return;
+  }
+  const reasons = result.rejected.map((entry) => entry.reason);
+  throw new AggregateError(reasons, `${result.failed} task(s) failed in runPool.`);
+}
+
+exports.PoolAbortedError = PoolAbortedError;
+exports.TaskTimeoutError = TaskTimeoutError;
+exports.assertPoolSuccess = assertPoolSuccess;
+exports.retry = retry;
+exports.runPool = runPool;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export type RetryJitter = \"none\" | \"full\";\n\nexport interface BaseRetryOptions {\n  retries?: number;\n  minDelayMs?: number;\n  maxDelayMs?: number;\n  factor?: number;\n  jitter?: RetryJitter;\n  shouldRetry?: (error: unknown, attempt: number) => boolean | Promise<boolean>;\n}\n\nexport interface RetryOptions extends BaseRetryOptions {\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  onRetry?: (event: RetryEvent) => void;\n}\n\nexport interface RetryEvent {\n  attempt: number;\n  nextAttempt: number;\n  delayMs: number;\n  error: unknown;\n}\n\nexport interface PoolWorkerContext {\n  index: number;\n  attempt: number;\n  signal: AbortSignal;\n}\n\nexport interface PoolOptions<TInput, TResult> {\n  concurrency?: number;\n  retry?: BaseRetryOptions;\n  timeoutMs?: number;\n  signal?: AbortSignal;\n  stopOnError?: boolean;\n  onProgress?: (progress: PoolProgress<TInput, TResult>) => void;\n}\n\ninterface NormalizedRetryOptions {\n  retries: number;\n  minDelayMs: number;\n  maxDelayMs: number;\n  factor: number;\n  jitter: RetryJitter;\n  shouldRetry: (error: unknown, attempt: number) => boolean | Promise<boolean>;\n}\n\nexport interface PoolBaseResult<TInput> {\n  status: \"fulfilled\" | \"rejected\";\n  index: number;\n  input: TInput;\n  attempts: number;\n  durationMs: number;\n}\n\nexport interface PoolFulfilledResult<TInput, TResult> extends PoolBaseResult<TInput> {\n  status: \"fulfilled\";\n  value: TResult;\n}\n\nexport interface PoolRejectedResult<TInput> extends PoolBaseResult<TInput> {\n  status: \"rejected\";\n  reason: unknown;\n}\n\nexport type PoolSettledResult<TInput, TResult> =\n  | PoolFulfilledResult<TInput, TResult>\n  | PoolRejectedResult<TInput>;\n\nexport interface PoolProgress<TInput, TResult> {\n  total: number;\n  completed: number;\n  succeeded: number;\n  failed: number;\n  running: number;\n  pending: number;\n  percentage: number;\n  lastResult?: PoolSettledResult<TInput, TResult>;\n}\n\nexport interface PoolRunResult<TInput, TResult> {\n  total: number;\n  completed: number;\n  succeeded: number;\n  failed: number;\n  hasErrors: boolean;\n  results: Array<PoolSettledResult<TInput, TResult>>;\n  fulfilled: Array<PoolFulfilledResult<TInput, TResult>>;\n  rejected: Array<PoolRejectedResult<TInput>>;\n}\n\nexport class PoolAbortedError extends Error {\n  constructor(message = \"Operation aborted.\") {\n    super(message);\n    this.name = \"PoolAbortedError\";\n  }\n}\n\nexport class TaskTimeoutError extends Error {\n  readonly taskIndex: number;\n  readonly timeoutMs: number;\n\n  constructor(taskIndex: number, timeoutMs: number) {\n    super(\n      taskIndex >= 0\n        ? `Task ${taskIndex} timed out after ${timeoutMs}ms.`\n        : `Operation timed out after ${timeoutMs}ms.`\n    );\n    this.name = \"TaskTimeoutError\";\n    this.taskIndex = taskIndex;\n    this.timeoutMs = timeoutMs;\n  }\n}\n\nconst DEFAULT_RETRY: NormalizedRetryOptions = {\n  retries: 0,\n  minDelayMs: 100,\n  maxDelayMs: 5000,\n  factor: 2,\n  jitter: \"none\",\n  shouldRetry: (error: unknown) => !(error instanceof PoolAbortedError)\n};\n\nfunction toAbortError(reason: unknown, fallbackMessage: string): Error {\n  if (reason instanceof Error) {\n    return reason;\n  }\n  if (typeof reason === \"string\" && reason.trim().length > 0) {\n    return new PoolAbortedError(reason);\n  }\n  return new PoolAbortedError(fallbackMessage);\n}\n\nfunction asNonNegativeInteger(value: number | undefined, name: string, fallback: number): number {\n  if (value === undefined) {\n    return fallback;\n  }\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {\n    throw new TypeError(`${name} must be a non-negative integer.`);\n  }\n  return value;\n}\n\nfunction asPositiveInteger(value: number | undefined, name: string, fallback: number): number {\n  if (value === undefined) {\n    return fallback;\n  }\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {\n    throw new TypeError(`${name} must be a positive integer.`);\n  }\n  return value;\n}\n\nfunction asPositiveNumber(value: number | undefined, name: string, fallback: number): number {\n  if (value === undefined) {\n    return fallback;\n  }\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new TypeError(`${name} must be a positive number.`);\n  }\n  return value;\n}\n\nfunction asOptionalPositiveInteger(value: number | undefined, name: string): number | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {\n    throw new TypeError(`${name} must be a positive integer.`);\n  }\n  return value;\n}\n\nfunction normalizeRetryOptions(options: BaseRetryOptions | undefined): NormalizedRetryOptions {\n  const retries = asNonNegativeInteger(options?.retries, \"retries\", DEFAULT_RETRY.retries);\n  const minDelayMs = asPositiveInteger(options?.minDelayMs, \"minDelayMs\", DEFAULT_RETRY.minDelayMs);\n  const maxDelayMs = asPositiveInteger(options?.maxDelayMs, \"maxDelayMs\", DEFAULT_RETRY.maxDelayMs);\n  const factor = asPositiveNumber(options?.factor, \"factor\", DEFAULT_RETRY.factor);\n  const jitter = options?.jitter ?? DEFAULT_RETRY.jitter;\n\n  if (jitter !== \"none\" && jitter !== \"full\") {\n    throw new TypeError(\"jitter must be either 'none' or 'full'.\");\n  }\n  if (minDelayMs > maxDelayMs) {\n    throw new TypeError(\"minDelayMs cannot be larger than maxDelayMs.\");\n  }\n\n  return {\n    retries,\n    minDelayMs,\n    maxDelayMs,\n    factor,\n    jitter,\n    shouldRetry: options?.shouldRetry ?? DEFAULT_RETRY.shouldRetry\n  };\n}\n\nfunction computeDelayMs(options: NormalizedRetryOptions, retryAttempt: number): number {\n  const exponential = options.minDelayMs * options.factor ** Math.max(retryAttempt - 1, 0);\n  const bounded = Math.min(exponential, options.maxDelayMs);\n  if (options.jitter === \"full\") {\n    return Math.floor(Math.random() * (bounded + 1));\n  }\n  return Math.floor(bounded);\n}\n\nfunction createLinkedAbortController(\n  signals: Array<AbortSignal | undefined>,\n  fallbackMessage: string\n): { controller: AbortController; cleanup: () => void } {\n  const controller = new AbortController();\n  const listeners: Array<{ signal: AbortSignal; listener: () => void }> = [];\n\n  for (const signal of signals) {\n    if (!signal) {\n      continue;\n    }\n    if (signal.aborted) {\n      controller.abort(toAbortError(signal.reason, fallbackMessage));\n      break;\n    }\n    const listener = (): void => {\n      if (!controller.signal.aborted) {\n        controller.abort(toAbortError(signal.reason, fallbackMessage));\n      }\n    };\n    signal.addEventListener(\"abort\", listener, { once: true });\n    listeners.push({ signal, listener });\n  }\n\n  const cleanup = (): void => {\n    for (const { signal, listener } of listeners) {\n      signal.removeEventListener(\"abort\", listener);\n    }\n  };\n\n  return { controller, cleanup };\n}\n\nfunction createAbortPromise(\n  signal: AbortSignal,\n  fallbackMessage: string\n): { promise: Promise<never>; cleanup: () => void } {\n  let listener: (() => void) | undefined;\n  const promise = new Promise<never>((_, reject) => {\n    listener = (): void => reject(toAbortError(signal.reason, fallbackMessage));\n    if (signal.aborted) {\n      listener();\n      return;\n    }\n    signal.addEventListener(\"abort\", listener, { once: true });\n  });\n\n  return {\n    promise,\n    cleanup: (): void => {\n      if (listener) {\n        signal.removeEventListener(\"abort\", listener);\n      }\n    }\n  };\n}\n\nasync function sleep(delayMs: number, signal: AbortSignal, abortMessage: string): Promise<void> {\n  if (delayMs <= 0) {\n    return;\n  }\n  await new Promise<void>((resolve, reject) => {\n    if (signal.aborted) {\n      reject(toAbortError(signal.reason, abortMessage));\n      return;\n    }\n\n    const timer = setTimeout(() => {\n      signal.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, delayMs);\n\n    const onAbort = (): void => {\n      clearTimeout(timer);\n      signal.removeEventListener(\"abort\", onAbort);\n      reject(toAbortError(signal.reason, abortMessage));\n    };\n\n    signal.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n\nasync function runWithAttemptTimeout<T>(\n  operation: (signal: AbortSignal) => Promise<T>,\n  options: {\n    signal: AbortSignal;\n    timeoutMs?: number;\n    timeoutErrorFactory: () => Error;\n    abortMessage: string;\n  }\n): Promise<T> {\n  const { controller, cleanup } = createLinkedAbortController([options.signal], options.abortMessage);\n  let timeoutHandle: NodeJS.Timeout | undefined;\n  let timeoutPromise: Promise<never> | undefined;\n  const operationPromise = Promise.resolve().then(() => operation(controller.signal));\n  const { promise: abortPromise, cleanup: cleanupAbortPromise } = createAbortPromise(\n    controller.signal,\n    options.abortMessage\n  );\n\n  if (typeof options.timeoutMs === \"number\") {\n    timeoutPromise = new Promise<never>((_, reject) => {\n      timeoutHandle = setTimeout(() => {\n        const timeoutError = options.timeoutErrorFactory();\n        if (!controller.signal.aborted) {\n          controller.abort(timeoutError);\n        }\n        reject(timeoutError);\n      }, options.timeoutMs);\n    });\n  }\n\n  try {\n    const contenders: Array<Promise<T>> = [operationPromise, abortPromise as Promise<T>];\n    if (timeoutPromise) {\n      contenders.push(timeoutPromise as Promise<T>);\n    }\n    return await Promise.race(contenders);\n  } finally {\n    cleanupAbortPromise();\n    cleanup();\n    if (timeoutHandle) {\n      clearTimeout(timeoutHandle);\n    }\n  }\n}\n\nexport async function retry<T>(\n  operation: (attempt: number, signal: AbortSignal) => Promise<T>,\n  options: RetryOptions = {}\n): Promise<T> {\n  const normalized = normalizeRetryOptions(options);\n  const timeoutMs = asOptionalPositiveInteger(options.timeoutMs, \"timeoutMs\");\n  const { controller, cleanup } = createLinkedAbortController([options.signal], \"Retry operation aborted.\");\n  const maxAttempts = normalized.retries + 1;\n\n  try {\n    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {\n      try {\n        return await runWithAttemptTimeout(\n          (signal) => operation(attempt, signal),\n          {\n            signal: controller.signal,\n            timeoutMs,\n            timeoutErrorFactory: () => new TaskTimeoutError(-1, timeoutMs ?? 0),\n            abortMessage: \"Retry operation aborted.\"\n          }\n        );\n      } catch (error) {\n        if (attempt >= maxAttempts) {\n          throw error;\n        }\n        const shouldRetry = await normalized.shouldRetry(error, attempt);\n        if (!shouldRetry) {\n          throw error;\n        }\n        const delayMs = computeDelayMs(normalized, attempt);\n        options.onRetry?.({\n          attempt,\n          nextAttempt: attempt + 1,\n          delayMs,\n          error\n        });\n        await sleep(delayMs, controller.signal, \"Retry wait aborted.\");\n      }\n    }\n  } finally {\n    cleanup();\n  }\n\n  throw new Error(\"Unreachable retry state.\");\n}\n\nfunction toPoolResultError(reason: unknown): unknown {\n  if (reason instanceof Error) {\n    return reason;\n  }\n  if (typeof reason === \"string\" && reason.trim().length > 0) {\n    return new Error(reason);\n  }\n  return reason;\n}\n\nfunction isRejected<TInput, TResult>(\n  result: PoolSettledResult<TInput, TResult>\n): result is PoolRejectedResult<TInput> {\n  return result.status === \"rejected\";\n}\n\nfunction isFulfilled<TInput, TResult>(\n  result: PoolSettledResult<TInput, TResult>\n): result is PoolFulfilledResult<TInput, TResult> {\n  return result.status === \"fulfilled\";\n}\n\nexport async function runPool<TInput, TResult>(\n  inputs: Iterable<TInput>,\n  worker: (input: TInput, context: PoolWorkerContext) => Promise<TResult>,\n  options: PoolOptions<TInput, TResult> = {}\n): Promise<PoolRunResult<TInput, TResult>> {\n  const items = Array.isArray(inputs) ? inputs.slice() : Array.from(inputs);\n  const total = items.length;\n\n  if (total === 0) {\n    return {\n      total: 0,\n      completed: 0,\n      succeeded: 0,\n      failed: 0,\n      hasErrors: false,\n      results: [],\n      fulfilled: [],\n      rejected: []\n    };\n  }\n\n  const retryOptions = normalizeRetryOptions(options.retry);\n  const timeoutMs = asOptionalPositiveInteger(options.timeoutMs, \"timeoutMs\");\n  const stopOnError = options.stopOnError ?? false;\n  const concurrency = Math.min(asPositiveInteger(options.concurrency, \"concurrency\", 5), total);\n  const { controller: poolController, cleanup } = createLinkedAbortController(\n    [options.signal],\n    \"Pool execution aborted.\"\n  );\n\n  const results = new Array<PoolSettledResult<TInput, TResult> | undefined>(total);\n  let nextIndex = 0;\n  let running = 0;\n  let completed = 0;\n  let succeeded = 0;\n  let failed = 0;\n\n  const emitProgress = (lastResult?: PoolSettledResult<TInput, TResult>): void => {\n    options.onProgress?.({\n      total,\n      completed,\n      succeeded,\n      failed,\n      running,\n      pending: Math.max(total - completed - running, 0),\n      percentage: Math.round((completed / total) * 100),\n      lastResult\n    });\n  };\n\n  const runSingle = async (index: number): Promise<void> => {\n    const input = items[index];\n    const startedAt = Date.now();\n    let attempts = 0;\n    let settled: PoolSettledResult<TInput, TResult> | undefined;\n    running += 1;\n\n    try {\n      const value = await retry(\n        async (attempt, signal) => {\n          attempts = attempt;\n          return worker(input, { index, attempt, signal });\n        },\n        {\n          ...retryOptions,\n          signal: poolController.signal,\n          timeoutMs\n        }\n      );\n\n      settled = {\n        status: \"fulfilled\",\n        index,\n        input,\n        value,\n        attempts,\n        durationMs: Date.now() - startedAt\n      };\n      succeeded += 1;\n      completed += 1;\n      results[index] = settled;\n    } catch (error) {\n      settled = {\n        status: \"rejected\",\n        index,\n        input,\n        reason: toPoolResultError(error),\n        attempts,\n        durationMs: Date.now() - startedAt\n      };\n      failed += 1;\n      completed += 1;\n      results[index] = settled;\n\n      if (stopOnError && !poolController.signal.aborted) {\n        poolController.abort(new PoolAbortedError(`Pool aborted because task ${index} failed.`));\n      }\n    } finally {\n      running -= 1;\n      if (settled) {\n        emitProgress(settled);\n      }\n    }\n  };\n\n  const runner = async (): Promise<void> => {\n    while (!poolController.signal.aborted) {\n      const index = nextIndex;\n      if (index >= total) {\n        return;\n      }\n      nextIndex += 1;\n      await runSingle(index);\n    }\n  };\n\n  try {\n    await Promise.all(Array.from({ length: concurrency }, () => runner()));\n  } finally {\n    cleanup();\n  }\n\n  if (poolController.signal.aborted) {\n    const abortError = toAbortError(poolController.signal.reason, \"Pool execution aborted.\");\n    for (let index = 0; index < total; index += 1) {\n      if (results[index]) {\n        continue;\n      }\n      const settled: PoolRejectedResult<TInput> = {\n        status: \"rejected\",\n        index,\n        input: items[index],\n        reason: abortError,\n        attempts: 0,\n        durationMs: 0\n      };\n      results[index] = settled;\n      failed += 1;\n      completed += 1;\n      emitProgress(settled);\n    }\n  }\n\n  const settledResults = results.map((result, index) => {\n    if (result) {\n      return result;\n    }\n    return {\n      status: \"rejected\",\n      index,\n      input: items[index],\n      reason: new PoolAbortedError(\"Task did not execute.\"),\n      attempts: 0,\n      durationMs: 0\n    } satisfies PoolRejectedResult<TInput>;\n  });\n\n  const fulfilled = settledResults.filter(isFulfilled);\n  const rejected = settledResults.filter(isRejected);\n\n  return {\n    total,\n    completed: settledResults.length,\n    succeeded: fulfilled.length,\n    failed: rejected.length,\n    hasErrors: rejected.length > 0,\n    results: settledResults,\n    fulfilled,\n    rejected\n  };\n}\n\nexport function assertPoolSuccess<TInput, TResult>(result: PoolRunResult<TInput, TResult>): void {\n  if (!result.hasErrors) {\n    return;\n  }\n  const reasons = result.rejected.map((entry) => entry.reason);\n  throw new AggregateError(reasons, `${result.failed} task(s) failed in runPool.`);\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,82 @@
+type RetryJitter = "none" | "full";
+interface BaseRetryOptions {
+    retries?: number;
+    minDelayMs?: number;
+    maxDelayMs?: number;
+    factor?: number;
+    jitter?: RetryJitter;
+    shouldRetry?: (error: unknown, attempt: number) => boolean | Promise<boolean>;
+}
+interface RetryOptions extends BaseRetryOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    onRetry?: (event: RetryEvent) => void;
+}
+interface RetryEvent {
+    attempt: number;
+    nextAttempt: number;
+    delayMs: number;
+    error: unknown;
+}
+interface PoolWorkerContext {
+    index: number;
+    attempt: number;
+    signal: AbortSignal;
+}
+interface PoolOptions<TInput, TResult> {
+    concurrency?: number;
+    retry?: BaseRetryOptions;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    stopOnError?: boolean;
+    onProgress?: (progress: PoolProgress<TInput, TResult>) => void;
+}
+interface PoolBaseResult<TInput> {
+    status: "fulfilled" | "rejected";
+    index: number;
+    input: TInput;
+    attempts: number;
+    durationMs: number;
+}
+interface PoolFulfilledResult<TInput, TResult> extends PoolBaseResult<TInput> {
+    status: "fulfilled";
+    value: TResult;
+}
+interface PoolRejectedResult<TInput> extends PoolBaseResult<TInput> {
+    status: "rejected";
+    reason: unknown;
+}
+type PoolSettledResult<TInput, TResult> = PoolFulfilledResult<TInput, TResult> | PoolRejectedResult<TInput>;
+interface PoolProgress<TInput, TResult> {
+    total: number;
+    completed: number;
+    succeeded: number;
+    failed: number;
+    running: number;
+    pending: number;
+    percentage: number;
+    lastResult?: PoolSettledResult<TInput, TResult>;
+}
+interface PoolRunResult<TInput, TResult> {
+    total: number;
+    completed: number;
+    succeeded: number;
+    failed: number;
+    hasErrors: boolean;
+    results: Array<PoolSettledResult<TInput, TResult>>;
+    fulfilled: Array<PoolFulfilledResult<TInput, TResult>>;
+    rejected: Array<PoolRejectedResult<TInput>>;
+}
+declare class PoolAbortedError extends Error {
+    constructor(message?: string);
+}
+declare class TaskTimeoutError extends Error {
+    readonly taskIndex: number;
+    readonly timeoutMs: number;
+    constructor(taskIndex: number, timeoutMs: number);
+}
+declare function retry<T>(operation: (attempt: number, signal: AbortSignal) => Promise<T>, options?: RetryOptions): Promise<T>;
+declare function runPool<TInput, TResult>(inputs: Iterable<TInput>, worker: (input: TInput, context: PoolWorkerContext) => Promise<TResult>, options?: PoolOptions<TInput, TResult>): Promise<PoolRunResult<TInput, TResult>>;
+declare function assertPoolSuccess<TInput, TResult>(result: PoolRunResult<TInput, TResult>): void;
+
+export { type BaseRetryOptions, PoolAbortedError, type PoolBaseResult, type PoolFulfilledResult, type PoolOptions, type PoolProgress, type PoolRejectedResult, type PoolRunResult, type PoolSettledResult, type PoolWorkerContext, type RetryEvent, type RetryJitter, type RetryOptions, TaskTimeoutError, assertPoolSuccess, retry, runPool };

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+type RetryJitter = "none" | "full";
+interface BaseRetryOptions {
+    retries?: number;
+    minDelayMs?: number;
+    maxDelayMs?: number;
+    factor?: number;
+    jitter?: RetryJitter;
+    shouldRetry?: (error: unknown, attempt: number) => boolean | Promise<boolean>;
+}
+interface RetryOptions extends BaseRetryOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    onRetry?: (event: RetryEvent) => void;
+}
+interface RetryEvent {
+    attempt: number;
+    nextAttempt: number;
+    delayMs: number;
+    error: unknown;
+}
+interface PoolWorkerContext {
+    index: number;
+    attempt: number;
+    signal: AbortSignal;
+}
+interface PoolOptions<TInput, TResult> {
+    concurrency?: number;
+    retry?: BaseRetryOptions;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    stopOnError?: boolean;
+    onProgress?: (progress: PoolProgress<TInput, TResult>) => void;
+}
+interface PoolBaseResult<TInput> {
+    status: "fulfilled" | "rejected";
+    index: number;
+    input: TInput;
+    attempts: number;
+    durationMs: number;
+}
+interface PoolFulfilledResult<TInput, TResult> extends PoolBaseResult<TInput> {
+    status: "fulfilled";
+    value: TResult;
+}
+interface PoolRejectedResult<TInput> extends PoolBaseResult<TInput> {
+    status: "rejected";
+    reason: unknown;
+}
+type PoolSettledResult<TInput, TResult> = PoolFulfilledResult<TInput, TResult> | PoolRejectedResult<TInput>;
+interface PoolProgress<TInput, TResult> {
+    total: number;
+    completed: number;
+    succeeded: number;
+    failed: number;
+    running: number;
+    pending: number;
+    percentage: number;
+    lastResult?: PoolSettledResult<TInput, TResult>;
+}
+interface PoolRunResult<TInput, TResult> {
+    total: number;
+    completed: number;
+    succeeded: number;
+    failed: number;
+    hasErrors: boolean;
+    results: Array<PoolSettledResult<TInput, TResult>>;
+    fulfilled: Array<PoolFulfilledResult<TInput, TResult>>;
+    rejected: Array<PoolRejectedResult<TInput>>;
+}
+declare class PoolAbortedError extends Error {
+    constructor(message?: string);
+}
+declare class TaskTimeoutError extends Error {
+    readonly taskIndex: number;
+    readonly timeoutMs: number;
+    constructor(taskIndex: number, timeoutMs: number);
+}
+declare function retry<T>(operation: (attempt: number, signal: AbortSignal) => Promise<T>, options?: RetryOptions): Promise<T>;
+declare function runPool<TInput, TResult>(inputs: Iterable<TInput>, worker: (input: TInput, context: PoolWorkerContext) => Promise<TResult>, options?: PoolOptions<TInput, TResult>): Promise<PoolRunResult<TInput, TResult>>;
+declare function assertPoolSuccess<TInput, TResult>(result: PoolRunResult<TInput, TResult>): void;
+
+export { type BaseRetryOptions, PoolAbortedError, type PoolBaseResult, type PoolFulfilledResult, type PoolOptions, type PoolProgress, type PoolRejectedResult, type PoolRunResult, type PoolSettledResult, type PoolWorkerContext, type RetryEvent, type RetryJitter, type RetryOptions, TaskTimeoutError, assertPoolSuccess, retry, runPool };

package/dist/index.js

@@ -0,0 +1,418 @@
+// src/index.ts
+var PoolAbortedError = class extends Error {
+  constructor(message = "Operation aborted.") {
+    super(message);
+    this.name = "PoolAbortedError";
+  }
+};
+var TaskTimeoutError = class extends Error {
+  constructor(taskIndex, timeoutMs) {
+    super(
+      taskIndex >= 0 ? `Task ${taskIndex} timed out after ${timeoutMs}ms.` : `Operation timed out after ${timeoutMs}ms.`
+    );
+    this.name = "TaskTimeoutError";
+    this.taskIndex = taskIndex;
+    this.timeoutMs = timeoutMs;
+  }
+};
+var DEFAULT_RETRY = {
+  retries: 0,
+  minDelayMs: 100,
+  maxDelayMs: 5e3,
+  factor: 2,
+  jitter: "none",
+  shouldRetry: (error) => !(error instanceof PoolAbortedError)
+};
+function toAbortError(reason, fallbackMessage) {
+  if (reason instanceof Error) {
+    return reason;
+  }
+  if (typeof reason === "string" && reason.trim().length > 0) {
+    return new PoolAbortedError(reason);
+  }
+  return new PoolAbortedError(fallbackMessage);
+}
+function asNonNegativeInteger(value, name, fallback) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+    throw new TypeError(`${name} must be a non-negative integer.`);
+  }
+  return value;
+}
+function asPositiveInteger(value, name, fallback) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {
+    throw new TypeError(`${name} must be a positive integer.`);
+  }
+  return value;
+}
+function asPositiveNumber(value, name, fallback) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (!Number.isFinite(value) || value <= 0) {
+    throw new TypeError(`${name} must be a positive number.`);
+  }
+  return value;
+}
+function asOptionalPositiveInteger(value, name) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {
+    throw new TypeError(`${name} must be a positive integer.`);
+  }
+  return value;
+}
+function normalizeRetryOptions(options) {
+  const retries = asNonNegativeInteger(options?.retries, "retries", DEFAULT_RETRY.retries);
+  const minDelayMs = asPositiveInteger(options?.minDelayMs, "minDelayMs", DEFAULT_RETRY.minDelayMs);
+  const maxDelayMs = asPositiveInteger(options?.maxDelayMs, "maxDelayMs", DEFAULT_RETRY.maxDelayMs);
+  const factor = asPositiveNumber(options?.factor, "factor", DEFAULT_RETRY.factor);
+  const jitter = options?.jitter ?? DEFAULT_RETRY.jitter;
+  if (jitter !== "none" && jitter !== "full") {
+    throw new TypeError("jitter must be either 'none' or 'full'.");
+  }
+  if (minDelayMs > maxDelayMs) {
+    throw new TypeError("minDelayMs cannot be larger than maxDelayMs.");
+  }
+  return {
+    retries,
+    minDelayMs,
+    maxDelayMs,
+    factor,
+    jitter,
+    shouldRetry: options?.shouldRetry ?? DEFAULT_RETRY.shouldRetry
+  };
+}
+function computeDelayMs(options, retryAttempt) {
+  const exponential = options.minDelayMs * options.factor ** Math.max(retryAttempt - 1, 0);
+  const bounded = Math.min(exponential, options.maxDelayMs);
+  if (options.jitter === "full") {
+    return Math.floor(Math.random() * (bounded + 1));
+  }
+  return Math.floor(bounded);
+}
+function createLinkedAbortController(signals, fallbackMessage) {
+  const controller = new AbortController();
+  const listeners = [];
+  for (const signal of signals) {
+    if (!signal) {
+      continue;
+    }
+    if (signal.aborted) {
+      controller.abort(toAbortError(signal.reason, fallbackMessage));
+      break;
+    }
+    const listener = () => {
+      if (!controller.signal.aborted) {
+        controller.abort(toAbortError(signal.reason, fallbackMessage));
+      }
+    };
+    signal.addEventListener("abort", listener, { once: true });
+    listeners.push({ signal, listener });
+  }
+  const cleanup = () => {
+    for (const { signal, listener } of listeners) {
+      signal.removeEventListener("abort", listener);
+    }
+  };
+  return { controller, cleanup };
+}
+function createAbortPromise(signal, fallbackMessage) {
+  let listener;
+  const promise = new Promise((_, reject) => {
+    listener = () => reject(toAbortError(signal.reason, fallbackMessage));
+    if (signal.aborted) {
+      listener();
+      return;
+    }
+    signal.addEventListener("abort", listener, { once: true });
+  });
+  return {
+    promise,
+    cleanup: () => {
+      if (listener) {
+        signal.removeEventListener("abort", listener);
+      }
+    }
+  };
+}
+async function sleep(delayMs, signal, abortMessage) {
+  if (delayMs <= 0) {
+    return;
+  }
+  await new Promise((resolve, reject) => {
+    if (signal.aborted) {
+      reject(toAbortError(signal.reason, abortMessage));
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, delayMs);
+    const onAbort = () => {
+      clearTimeout(timer);
+      signal.removeEventListener("abort", onAbort);
+      reject(toAbortError(signal.reason, abortMessage));
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function runWithAttemptTimeout(operation, options) {
+  const { controller, cleanup } = createLinkedAbortController([options.signal], options.abortMessage);
+  let timeoutHandle;
+  let timeoutPromise;
+  const operationPromise = Promise.resolve().then(() => operation(controller.signal));
+  const { promise: abortPromise, cleanup: cleanupAbortPromise } = createAbortPromise(
+    controller.signal,
+    options.abortMessage
+  );
+  if (typeof options.timeoutMs === "number") {
+    timeoutPromise = new Promise((_, reject) => {
+      timeoutHandle = setTimeout(() => {
+        const timeoutError = options.timeoutErrorFactory();
+        if (!controller.signal.aborted) {
+          controller.abort(timeoutError);
+        }
+        reject(timeoutError);
+      }, options.timeoutMs);
+    });
+  }
+  try {
+    const contenders = [operationPromise, abortPromise];
+    if (timeoutPromise) {
+      contenders.push(timeoutPromise);
+    }
+    return await Promise.race(contenders);
+  } finally {
+    cleanupAbortPromise();
+    cleanup();
+    if (timeoutHandle) {
+      clearTimeout(timeoutHandle);
+    }
+  }
+}
+async function retry(operation, options = {}) {
+  const normalized = normalizeRetryOptions(options);
+  const timeoutMs = asOptionalPositiveInteger(options.timeoutMs, "timeoutMs");
+  const { controller, cleanup } = createLinkedAbortController([options.signal], "Retry operation aborted.");
+  const maxAttempts = normalized.retries + 1;
+  try {
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+      try {
+        return await runWithAttemptTimeout(
+          (signal) => operation(attempt, signal),
+          {
+            signal: controller.signal,
+            timeoutMs,
+            timeoutErrorFactory: () => new TaskTimeoutError(-1, timeoutMs ?? 0),
+            abortMessage: "Retry operation aborted."
+          }
+        );
+      } catch (error) {
+        if (attempt >= maxAttempts) {
+          throw error;
+        }
+        const shouldRetry = await normalized.shouldRetry(error, attempt);
+        if (!shouldRetry) {
+          throw error;
+        }
+        const delayMs = computeDelayMs(normalized, attempt);
+        options.onRetry?.({
+          attempt,
+          nextAttempt: attempt + 1,
+          delayMs,
+          error
+        });
+        await sleep(delayMs, controller.signal, "Retry wait aborted.");
+      }
+    }
+  } finally {
+    cleanup();
+  }
+  throw new Error("Unreachable retry state.");
+}
+function toPoolResultError(reason) {
+  if (reason instanceof Error) {
+    return reason;
+  }
+  if (typeof reason === "string" && reason.trim().length > 0) {
+    return new Error(reason);
+  }
+  return reason;
+}
+function isRejected(result) {
+  return result.status === "rejected";
+}
+function isFulfilled(result) {
+  return result.status === "fulfilled";
+}
+async function runPool(inputs, worker, options = {}) {
+  const items = Array.isArray(inputs) ? inputs.slice() : Array.from(inputs);
+  const total = items.length;
+  if (total === 0) {
+    return {
+      total: 0,
+      completed: 0,
+      succeeded: 0,
+      failed: 0,
+      hasErrors: false,
+      results: [],
+      fulfilled: [],
+      rejected: []
+    };
+  }
+  const retryOptions = normalizeRetryOptions(options.retry);
+  const timeoutMs = asOptionalPositiveInteger(options.timeoutMs, "timeoutMs");
+  const stopOnError = options.stopOnError ?? false;
+  const concurrency = Math.min(asPositiveInteger(options.concurrency, "concurrency", 5), total);
+  const { controller: poolController, cleanup } = createLinkedAbortController(
+    [options.signal],
+    "Pool execution aborted."
+  );
+  const results = new Array(total);
+  let nextIndex = 0;
+  let running = 0;
+  let completed = 0;
+  let succeeded = 0;
+  let failed = 0;
+  const emitProgress = (lastResult) => {
+    options.onProgress?.({
+      total,
+      completed,
+      succeeded,
+      failed,
+      running,
+      pending: Math.max(total - completed - running, 0),
+      percentage: Math.round(completed / total * 100),
+      lastResult
+    });
+  };
+  const runSingle = async (index) => {
+    const input = items[index];
+    const startedAt = Date.now();
+    let attempts = 0;
+    let settled;
+    running += 1;
+    try {
+      const value = await retry(
+        async (attempt, signal) => {
+          attempts = attempt;
+          return worker(input, { index, attempt, signal });
+        },
+        {
+          ...retryOptions,
+          signal: poolController.signal,
+          timeoutMs
+        }
+      );
+      settled = {
+        status: "fulfilled",
+        index,
+        input,
+        value,
+        attempts,
+        durationMs: Date.now() - startedAt
+      };
+      succeeded += 1;
+      completed += 1;
+      results[index] = settled;
+    } catch (error) {
+      settled = {
+        status: "rejected",
+        index,
+        input,
+        reason: toPoolResultError(error),
+        attempts,
+        durationMs: Date.now() - startedAt
+      };
+      failed += 1;
+      completed += 1;
+      results[index] = settled;
+      if (stopOnError && !poolController.signal.aborted) {
+        poolController.abort(new PoolAbortedError(`Pool aborted because task ${index} failed.`));
+      }
+    } finally {
+      running -= 1;
+      if (settled) {
+        emitProgress(settled);
+      }
+    }
+  };
+  const runner = async () => {
+    while (!poolController.signal.aborted) {
+      const index = nextIndex;
+      if (index >= total) {
+        return;
+      }
+      nextIndex += 1;
+      await runSingle(index);
+    }
+  };
+  try {
+    await Promise.all(Array.from({ length: concurrency }, () => runner()));
+  } finally {
+    cleanup();
+  }
+  if (poolController.signal.aborted) {
+    const abortError = toAbortError(poolController.signal.reason, "Pool execution aborted.");
+    for (let index = 0; index < total; index += 1) {
+      if (results[index]) {
+        continue;
+      }
+      const settled = {
+        status: "rejected",
+        index,
+        input: items[index],
+        reason: abortError,
+        attempts: 0,
+        durationMs: 0
+      };
+      results[index] = settled;
+      failed += 1;
+      completed += 1;
+      emitProgress(settled);
+    }
+  }
+  const settledResults = results.map((result, index) => {
+    if (result) {
+      return result;
+    }
+    return {
+      status: "rejected",
+      index,
+      input: items[index],
+      reason: new PoolAbortedError("Task did not execute."),
+      attempts: 0,
+      durationMs: 0
+    };
+  });
+  const fulfilled = settledResults.filter(isFulfilled);
+  const rejected = settledResults.filter(isRejected);
+  return {
+    total,
+    completed: settledResults.length,
+    succeeded: fulfilled.length,
+    failed: rejected.length,
+    hasErrors: rejected.length > 0,
+    results: settledResults,
+    fulfilled,
+    rejected
+  };
+}
+function assertPoolSuccess(result) {
+  if (!result.hasErrors) {
+    return;
+  }
+  const reasons = result.rejected.map((entry) => entry.reason);
+  throw new AggregateError(reasons, `${result.failed} task(s) failed in runPool.`);
+}
+
+export { PoolAbortedError, TaskTimeoutError, assertPoolSuccess, retry, runPool };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export type RetryJitter = \"none\" | \"full\";\n\nexport interface BaseRetryOptions {\n  retries?: number;\n  minDelayMs?: number;\n  maxDelayMs?: number;\n  factor?: number;\n  jitter?: RetryJitter;\n  shouldRetry?: (error: unknown, attempt: number) => boolean | Promise<boolean>;\n}\n\nexport interface RetryOptions extends BaseRetryOptions {\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  onRetry?: (event: RetryEvent) => void;\n}\n\nexport interface RetryEvent {\n  attempt: number;\n  nextAttempt: number;\n  delayMs: number;\n  error: unknown;\n}\n\nexport interface PoolWorkerContext {\n  index: number;\n  attempt: number;\n  signal: AbortSignal;\n}\n\nexport interface PoolOptions<TInput, TResult> {\n  concurrency?: number;\n  retry?: BaseRetryOptions;\n  timeoutMs?: number;\n  signal?: AbortSignal;\n  stopOnError?: boolean;\n  onProgress?: (progress: PoolProgress<TInput, TResult>) => void;\n}\n\ninterface NormalizedRetryOptions {\n  retries: number;\n  minDelayMs: number;\n  maxDelayMs: number;\n  factor: number;\n  jitter: RetryJitter;\n  shouldRetry: (error: unknown, attempt: number) => boolean | Promise<boolean>;\n}\n\nexport interface PoolBaseResult<TInput> {\n  status: \"fulfilled\" | \"rejected\";\n  index: number;\n  input: TInput;\n  attempts: number;\n  durationMs: number;\n}\n\nexport interface PoolFulfilledResult<TInput, TResult> extends PoolBaseResult<TInput> {\n  status: \"fulfilled\";\n  value: TResult;\n}\n\nexport interface PoolRejectedResult<TInput> extends PoolBaseResult<TInput> {\n  status: \"rejected\";\n  reason: unknown;\n}\n\nexport type PoolSettledResult<TInput, TResult> =\n  | PoolFulfilledResult<TInput, TResult>\n  | PoolRejectedResult<TInput>;\n\nexport interface PoolProgress<TInput, TResult> {\n  total: number;\n  completed: number;\n  succeeded: number;\n  failed: number;\n  running: number;\n  pending: number;\n  percentage: number;\n  lastResult?: PoolSettledResult<TInput, TResult>;\n}\n\nexport interface PoolRunResult<TInput, TResult> {\n  total: number;\n  completed: number;\n  succeeded: number;\n  failed: number;\n  hasErrors: boolean;\n  results: Array<PoolSettledResult<TInput, TResult>>;\n  fulfilled: Array<PoolFulfilledResult<TInput, TResult>>;\n  rejected: Array<PoolRejectedResult<TInput>>;\n}\n\nexport class PoolAbortedError extends Error {\n  constructor(message = \"Operation aborted.\") {\n    super(message);\n    this.name = \"PoolAbortedError\";\n  }\n}\n\nexport class TaskTimeoutError extends Error {\n  readonly taskIndex: number;\n  readonly timeoutMs: number;\n\n  constructor(taskIndex: number, timeoutMs: number) {\n    super(\n      taskIndex >= 0\n        ? `Task ${taskIndex} timed out after ${timeoutMs}ms.`\n        : `Operation timed out after ${timeoutMs}ms.`\n    );\n    this.name = \"TaskTimeoutError\";\n    this.taskIndex = taskIndex;\n    this.timeoutMs = timeoutMs;\n  }\n}\n\nconst DEFAULT_RETRY: NormalizedRetryOptions = {\n  retries: 0,\n  minDelayMs: 100,\n  maxDelayMs: 5000,\n  factor: 2,\n  jitter: \"none\",\n  shouldRetry: (error: unknown) => !(error instanceof PoolAbortedError)\n};\n\nfunction toAbortError(reason: unknown, fallbackMessage: string): Error {\n  if (reason instanceof Error) {\n    return reason;\n  }\n  if (typeof reason === \"string\" && reason.trim().length > 0) {\n    return new PoolAbortedError(reason);\n  }\n  return new PoolAbortedError(fallbackMessage);\n}\n\nfunction asNonNegativeInteger(value: number | undefined, name: string, fallback: number): number {\n  if (value === undefined) {\n    return fallback;\n  }\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {\n    throw new TypeError(`${name} must be a non-negative integer.`);\n  }\n  return value;\n}\n\nfunction asPositiveInteger(value: number | undefined, name: string, fallback: number): number {\n  if (value === undefined) {\n    return fallback;\n  }\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {\n    throw new TypeError(`${name} must be a positive integer.`);\n  }\n  return value;\n}\n\nfunction asPositiveNumber(value: number | undefined, name: string, fallback: number): number {\n  if (value === undefined) {\n    return fallback;\n  }\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new TypeError(`${name} must be a positive number.`);\n  }\n  return value;\n}\n\nfunction asOptionalPositiveInteger(value: number | undefined, name: string): number | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {\n    throw new TypeError(`${name} must be a positive integer.`);\n  }\n  return value;\n}\n\nfunction normalizeRetryOptions(options: BaseRetryOptions | undefined): NormalizedRetryOptions {\n  const retries = asNonNegativeInteger(options?.retries, \"retries\", DEFAULT_RETRY.retries);\n  const minDelayMs = asPositiveInteger(options?.minDelayMs, \"minDelayMs\", DEFAULT_RETRY.minDelayMs);\n  const maxDelayMs = asPositiveInteger(options?.maxDelayMs, \"maxDelayMs\", DEFAULT_RETRY.maxDelayMs);\n  const factor = asPositiveNumber(options?.factor, \"factor\", DEFAULT_RETRY.factor);\n  const jitter = options?.jitter ?? DEFAULT_RETRY.jitter;\n\n  if (jitter !== \"none\" && jitter !== \"full\") {\n    throw new TypeError(\"jitter must be either 'none' or 'full'.\");\n  }\n  if (minDelayMs > maxDelayMs) {\n    throw new TypeError(\"minDelayMs cannot be larger than maxDelayMs.\");\n  }\n\n  return {\n    retries,\n    minDelayMs,\n    maxDelayMs,\n    factor,\n    jitter,\n    shouldRetry: options?.shouldRetry ?? DEFAULT_RETRY.shouldRetry\n  };\n}\n\nfunction computeDelayMs(options: NormalizedRetryOptions, retryAttempt: number): number {\n  const exponential = options.minDelayMs * options.factor ** Math.max(retryAttempt - 1, 0);\n  const bounded = Math.min(exponential, options.maxDelayMs);\n  if (options.jitter === \"full\") {\n    return Math.floor(Math.random() * (bounded + 1));\n  }\n  return Math.floor(bounded);\n}\n\nfunction createLinkedAbortController(\n  signals: Array<AbortSignal | undefined>,\n  fallbackMessage: string\n): { controller: AbortController; cleanup: () => void } {\n  const controller = new AbortController();\n  const listeners: Array<{ signal: AbortSignal; listener: () => void }> = [];\n\n  for (const signal of signals) {\n    if (!signal) {\n      continue;\n    }\n    if (signal.aborted) {\n      controller.abort(toAbortError(signal.reason, fallbackMessage));\n      break;\n    }\n    const listener = (): void => {\n      if (!controller.signal.aborted) {\n        controller.abort(toAbortError(signal.reason, fallbackMessage));\n      }\n    };\n    signal.addEventListener(\"abort\", listener, { once: true });\n    listeners.push({ signal, listener });\n  }\n\n  const cleanup = (): void => {\n    for (const { signal, listener } of listeners) {\n      signal.removeEventListener(\"abort\", listener);\n    }\n  };\n\n  return { controller, cleanup };\n}\n\nfunction createAbortPromise(\n  signal: AbortSignal,\n  fallbackMessage: string\n): { promise: Promise<never>; cleanup: () => void } {\n  let listener: (() => void) | undefined;\n  const promise = new Promise<never>((_, reject) => {\n    listener = (): void => reject(toAbortError(signal.reason, fallbackMessage));\n    if (signal.aborted) {\n      listener();\n      return;\n    }\n    signal.addEventListener(\"abort\", listener, { once: true });\n  });\n\n  return {\n    promise,\n    cleanup: (): void => {\n      if (listener) {\n        signal.removeEventListener(\"abort\", listener);\n      }\n    }\n  };\n}\n\nasync function sleep(delayMs: number, signal: AbortSignal, abortMessage: string): Promise<void> {\n  if (delayMs <= 0) {\n    return;\n  }\n  await new Promise<void>((resolve, reject) => {\n    if (signal.aborted) {\n      reject(toAbortError(signal.reason, abortMessage));\n      return;\n    }\n\n    const timer = setTimeout(() => {\n      signal.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, delayMs);\n\n    const onAbort = (): void => {\n      clearTimeout(timer);\n      signal.removeEventListener(\"abort\", onAbort);\n      reject(toAbortError(signal.reason, abortMessage));\n    };\n\n    signal.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n\nasync function runWithAttemptTimeout<T>(\n  operation: (signal: AbortSignal) => Promise<T>,\n  options: {\n    signal: AbortSignal;\n    timeoutMs?: number;\n    timeoutErrorFactory: () => Error;\n    abortMessage: string;\n  }\n): Promise<T> {\n  const { controller, cleanup } = createLinkedAbortController([options.signal], options.abortMessage);\n  let timeoutHandle: NodeJS.Timeout | undefined;\n  let timeoutPromise: Promise<never> | undefined;\n  const operationPromise = Promise.resolve().then(() => operation(controller.signal));\n  const { promise: abortPromise, cleanup: cleanupAbortPromise } = createAbortPromise(\n    controller.signal,\n    options.abortMessage\n  );\n\n  if (typeof options.timeoutMs === \"number\") {\n    timeoutPromise = new Promise<never>((_, reject) => {\n      timeoutHandle = setTimeout(() => {\n        const timeoutError = options.timeoutErrorFactory();\n        if (!controller.signal.aborted) {\n          controller.abort(timeoutError);\n        }\n        reject(timeoutError);\n      }, options.timeoutMs);\n    });\n  }\n\n  try {\n    const contenders: Array<Promise<T>> = [operationPromise, abortPromise as Promise<T>];\n    if (timeoutPromise) {\n      contenders.push(timeoutPromise as Promise<T>);\n    }\n    return await Promise.race(contenders);\n  } finally {\n    cleanupAbortPromise();\n    cleanup();\n    if (timeoutHandle) {\n      clearTimeout(timeoutHandle);\n    }\n  }\n}\n\nexport async function retry<T>(\n  operation: (attempt: number, signal: AbortSignal) => Promise<T>,\n  options: RetryOptions = {}\n): Promise<T> {\n  const normalized = normalizeRetryOptions(options);\n  const timeoutMs = asOptionalPositiveInteger(options.timeoutMs, \"timeoutMs\");\n  const { controller, cleanup } = createLinkedAbortController([options.signal], \"Retry operation aborted.\");\n  const maxAttempts = normalized.retries + 1;\n\n  try {\n    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {\n      try {\n        return await runWithAttemptTimeout(\n          (signal) => operation(attempt, signal),\n          {\n            signal: controller.signal,\n            timeoutMs,\n            timeoutErrorFactory: () => new TaskTimeoutError(-1, timeoutMs ?? 0),\n            abortMessage: \"Retry operation aborted.\"\n          }\n        );\n      } catch (error) {\n        if (attempt >= maxAttempts) {\n          throw error;\n        }\n        const shouldRetry = await normalized.shouldRetry(error, attempt);\n        if (!shouldRetry) {\n          throw error;\n        }\n        const delayMs = computeDelayMs(normalized, attempt);\n        options.onRetry?.({\n          attempt,\n          nextAttempt: attempt + 1,\n          delayMs,\n          error\n        });\n        await sleep(delayMs, controller.signal, \"Retry wait aborted.\");\n      }\n    }\n  } finally {\n    cleanup();\n  }\n\n  throw new Error(\"Unreachable retry state.\");\n}\n\nfunction toPoolResultError(reason: unknown): unknown {\n  if (reason instanceof Error) {\n    return reason;\n  }\n  if (typeof reason === \"string\" && reason.trim().length > 0) {\n    return new Error(reason);\n  }\n  return reason;\n}\n\nfunction isRejected<TInput, TResult>(\n  result: PoolSettledResult<TInput, TResult>\n): result is PoolRejectedResult<TInput> {\n  return result.status === \"rejected\";\n}\n\nfunction isFulfilled<TInput, TResult>(\n  result: PoolSettledResult<TInput, TResult>\n): result is PoolFulfilledResult<TInput, TResult> {\n  return result.status === \"fulfilled\";\n}\n\nexport async function runPool<TInput, TResult>(\n  inputs: Iterable<TInput>,\n  worker: (input: TInput, context: PoolWorkerContext) => Promise<TResult>,\n  options: PoolOptions<TInput, TResult> = {}\n): Promise<PoolRunResult<TInput, TResult>> {\n  const items = Array.isArray(inputs) ? inputs.slice() : Array.from(inputs);\n  const total = items.length;\n\n  if (total === 0) {\n    return {\n      total: 0,\n      completed: 0,\n      succeeded: 0,\n      failed: 0,\n      hasErrors: false,\n      results: [],\n      fulfilled: [],\n      rejected: []\n    };\n  }\n\n  const retryOptions = normalizeRetryOptions(options.retry);\n  const timeoutMs = asOptionalPositiveInteger(options.timeoutMs, \"timeoutMs\");\n  const stopOnError = options.stopOnError ?? false;\n  const concurrency = Math.min(asPositiveInteger(options.concurrency, \"concurrency\", 5), total);\n  const { controller: poolController, cleanup } = createLinkedAbortController(\n    [options.signal],\n    \"Pool execution aborted.\"\n  );\n\n  const results = new Array<PoolSettledResult<TInput, TResult> | undefined>(total);\n  let nextIndex = 0;\n  let running = 0;\n  let completed = 0;\n  let succeeded = 0;\n  let failed = 0;\n\n  const emitProgress = (lastResult?: PoolSettledResult<TInput, TResult>): void => {\n    options.onProgress?.({\n      total,\n      completed,\n      succeeded,\n      failed,\n      running,\n      pending: Math.max(total - completed - running, 0),\n      percentage: Math.round((completed / total) * 100),\n      lastResult\n    });\n  };\n\n  const runSingle = async (index: number): Promise<void> => {\n    const input = items[index];\n    const startedAt = Date.now();\n    let attempts = 0;\n    let settled: PoolSettledResult<TInput, TResult> | undefined;\n    running += 1;\n\n    try {\n      const value = await retry(\n        async (attempt, signal) => {\n          attempts = attempt;\n          return worker(input, { index, attempt, signal });\n        },\n        {\n          ...retryOptions,\n          signal: poolController.signal,\n          timeoutMs\n        }\n      );\n\n      settled = {\n        status: \"fulfilled\",\n        index,\n        input,\n        value,\n        attempts,\n        durationMs: Date.now() - startedAt\n      };\n      succeeded += 1;\n      completed += 1;\n      results[index] = settled;\n    } catch (error) {\n      settled = {\n        status: \"rejected\",\n        index,\n        input,\n        reason: toPoolResultError(error),\n        attempts,\n        durationMs: Date.now() - startedAt\n      };\n      failed += 1;\n      completed += 1;\n      results[index] = settled;\n\n      if (stopOnError && !poolController.signal.aborted) {\n        poolController.abort(new PoolAbortedError(`Pool aborted because task ${index} failed.`));\n      }\n    } finally {\n      running -= 1;\n      if (settled) {\n        emitProgress(settled);\n      }\n    }\n  };\n\n  const runner = async (): Promise<void> => {\n    while (!poolController.signal.aborted) {\n      const index = nextIndex;\n      if (index >= total) {\n        return;\n      }\n      nextIndex += 1;\n      await runSingle(index);\n    }\n  };\n\n  try {\n    await Promise.all(Array.from({ length: concurrency }, () => runner()));\n  } finally {\n    cleanup();\n  }\n\n  if (poolController.signal.aborted) {\n    const abortError = toAbortError(poolController.signal.reason, \"Pool execution aborted.\");\n    for (let index = 0; index < total; index += 1) {\n      if (results[index]) {\n        continue;\n      }\n      const settled: PoolRejectedResult<TInput> = {\n        status: \"rejected\",\n        index,\n        input: items[index],\n        reason: abortError,\n        attempts: 0,\n        durationMs: 0\n      };\n      results[index] = settled;\n      failed += 1;\n      completed += 1;\n      emitProgress(settled);\n    }\n  }\n\n  const settledResults = results.map((result, index) => {\n    if (result) {\n      return result;\n    }\n    return {\n      status: \"rejected\",\n      index,\n      input: items[index],\n      reason: new PoolAbortedError(\"Task did not execute.\"),\n      attempts: 0,\n      durationMs: 0\n    } satisfies PoolRejectedResult<TInput>;\n  });\n\n  const fulfilled = settledResults.filter(isFulfilled);\n  const rejected = settledResults.filter(isRejected);\n\n  return {\n    total,\n    completed: settledResults.length,\n    succeeded: fulfilled.length,\n    failed: rejected.length,\n    hasErrors: rejected.length > 0,\n    results: settledResults,\n    fulfilled,\n    rejected\n  };\n}\n\nexport function assertPoolSuccess<TInput, TResult>(result: PoolRunResult<TInput, TResult>): void {\n  if (!result.hasErrors) {\n    return;\n  }\n  const reasons = result.rejected.map((entry) => entry.reason);\n  throw new AggregateError(reasons, `${result.failed} task(s) failed in runPool.`);\n}\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@sejinjja/promise-pool-kit",
+  "version": "0.1.0",
+  "description": "A tiny TypeScript toolkit for retry, timeout, and controlled concurrency in async workloads.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "npm run typecheck && npm run test && npm run build",
+    "prepublishOnly": "npm run check"
+  },
+  "keywords": [
+    "promise",
+    "pool",
+    "concurrency",
+    "retry",
+    "timeout",
+    "async",
+    "typescript"
+  ],
+  "author": "sejinjja",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sejinjja/promise-pool-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sejinjja/promise-pool-kit/issues"
+  },
+  "homepage": "https://github.com/sejinjja/promise-pool-kit#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.0"
+  }
+}