@ix-xs/node-comfort 1.2.0 → 2.1.0

package/types/src/Arr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Arr.d.ts","sourceRoot":"","sources":["../../src/Arr.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Arr.d.ts","sourceRoot":"","sources":["../../src/Arr.js"],"names":[],"mappings":"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"}

package/types/src/Async.d.ts

@@ -0,0 +1,372 @@
+/**
+ * Options for `map()`, `forEach()` and `filter()`.
+ */
+export type MapOptions = {
+    /**
+     * How many run at the same time. No limit by default.
+     */
+    concurrency?: number | undefined;
+    /**
+     * Stop at the first error. With `false`, everything runs and you get an `AggregateError` of all failures. Defaults to `true`.
+     */
+    stopOnError?: boolean | undefined;
+    /**
+     * Stops starting new work and rejects with an `AbortError`.
+     */
+    signal?: AbortSignal | undefined;
+};
+/**
+ * A rate limiter from `rateLimit()`. Call it with a function to run it as
+ * soon as the rate allows.
+ */
+export type RateLimiter = (<T>(fn: () => T | PromiseLike<T>) => Promise<Awaited<T>>) & {
+    readonly pendingCount: number;
+};
+/**
+ * A limiter from `limit()`. Call it with a function to run it when there's room.
+ */
+export type Limiter = (<T>(fn: () => T | PromiseLike<T>) => Promise<Awaited<T>>) & {
+    readonly activeCount: number;
+    readonly pendingCount: number;
+    concurrency: number;
+    clearQueue(): void;
+    onIdle(): Promise<void>;
+};
+/**
+ * Options for `queue()`.
+ */
+export type QueueOptions = {
+    /**
+     * How many tasks run at the same time. Defaults to `1`.
+     */
+    concurrency?: number | undefined;
+    /**
+     * Start right away. Defaults to `true`.
+     */
+    autoStart?: boolean | undefined;
+    /**
+     * Time limit per task, like `"30s"`. A slower task rejects with a `TimeoutError`.
+     */
+    timeout?: string | number | undefined;
+};
+/**
+ * Options for `queue.add()`.
+ */
+export type QueueAddOptions = {
+    /**
+     * Higher goes first; equal priorities keep their order. Defaults to `0`.
+     */
+    priority?: number | undefined;
+};
+/**
+ * A queue from `queue()`.
+ */
+export type Queue = {
+    /**
+     * Adds a task; resolves with its result.
+     */
+    add: <T>(task: () => T | PromiseLike<T>, options?: QueueAddOptions) => Promise<Awaited<T>>;
+    /**
+     * Adds several tasks; resolves with all results.
+     */
+    addAll: <T>(tasks: Array<() => T | PromiseLike<T>>, options?: QueueAddOptions) => Promise<Array<Awaited<T>>>;
+    /**
+     * Stops starting tasks. Running ones finish.
+     */
+    pause: () => Queue;
+    /**
+     * Starts again.
+     */
+    start: () => Queue;
+    /**
+     * Drops the tasks that haven't started. Their promises never settle.
+     */
+    clear: () => void;
+    /**
+     * Resolves when nothing is waiting or running.
+     */
+    onIdle: () => Promise<void>;
+    /**
+     * Resolves when nothing is waiting.
+     */
+    onEmpty: () => Promise<void>;
+    /**
+     * Tasks waiting.
+     */
+    size: number;
+    /**
+     * Tasks running.
+     */
+    pending: number;
+    isPaused: boolean;
+    /**
+     * Can be changed on the fly.
+     */
+    concurrency: number;
+};
+/**
+ * A promise with its `resolve` and `reject`.
+ */
+export type Deferred<T> = {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: unknown) => void;
+    /**
+     * Whether it's already resolved or rejected.
+     */
+    settled: boolean;
+};
+/**
+ * What `settle()` returns.
+ */
+export type Settled<T> = {
+    /**
+     * Successful values, in order.
+     */
+    fulfilled: T[];
+    /**
+     * Errors, in order.
+     */
+    rejected: unknown[];
+    /**
+     * Everything, like `Promise.allSettled`.
+     */
+    results: Array<PromiseSettledResult<T>>;
+};
+/**
+ * Options for `poll()`.
+ */
+export type PollOptions = {
+    /**
+     * Time between tries. Defaults to 100 ms.
+     */
+    interval?: string | number | undefined;
+    /**
+     * Give up with a `TimeoutError` after this long.
+     */
+    timeout?: string | number | undefined;
+    /**
+     * Stops with an `AbortError`.
+     */
+    signal?: AbortSignal | undefined;
+};
+/**
+ * A mutex from `mutex()`.
+ */
+export type Mutex = {
+    /**
+     * Runs `fn` once no other `run` is in progress.
+     */
+    run: <T>(fn: () => T | PromiseLike<T>) => Promise<Awaited<T>>;
+    /**
+     * Waits for the lock and gives you the function that releases it.
+     */
+    lock: () => Promise<() => void>;
+    isLocked: boolean;
+};
+/**
+ * Waits for a while. Same as `nc.wait()`.
+ *
+ * @example
+ * await async.sleep("250ms");
+ *
+ * @param {number | string} duration
+ * @param {{ signal?: AbortSignal }} [options]
+ * @returns {Promise<void>}
+ */
+export function sleep(duration: number | string, options?: {
+    signal?: AbortSignal;
+}): Promise<void>;
+/**
+ * Maps items through an async function, with at most `concurrency` calls
+ * at once. Results stay in order. Items are taken from the source as slots
+ * free up, so a stream is never read faster than it's processed.
+ *
+ * @example
+ * const users = await async.map(ids, (id) => api.getUser(id), { concurrency: 10 });
+ * await async.forEach(readline.createInterface({ input }), importLine, { concurrency: 20 });
+ *
+ * @template T
+ * @template R
+ * @param {Iterable<T> | AsyncIterable<T>} items
+ * @param {(item: T, index: number) => R | PromiseLike<R>} fn
+ * @param {MapOptions} [options]
+ * @returns {Promise<Array<Awaited<R>>>}
+ * @throws The first error, an `AggregateError` with `stopOnError: false`, or an `AbortError`.
+ */
+export function map<T, R>(items: Iterable<T> | AsyncIterable<T>, fn: (item: T, index: number) => R | PromiseLike<R>, options?: MapOptions): Promise<Array<Awaited<R>>>;
+/**
+ * Runs an async function for every item, with a concurrency limit.
+ *
+ * @example
+ * await async.forEach(images, (image) => optimize(image), { concurrency: 4 });
+ *
+ * @template T
+ * @param {Iterable<T> | AsyncIterable<T>} items
+ * @param {(item: T, index: number) => unknown} fn
+ * @param {MapOptions} [options]
+ * @returns {Promise<void>}
+ */
+export function forEach<T>(items: Iterable<T> | AsyncIterable<T>, fn: (item: T, index: number) => unknown, options?: MapOptions): Promise<void>;
+/**
+ * Keeps the items that pass an async test, with a concurrency limit.
+ * Order is preserved.
+ *
+ * @example
+ * const alive = await async.filter(hosts, (host) => ping(host), { concurrency: 20 });
+ *
+ * @template T
+ * @param {Iterable<T> | AsyncIterable<T>} items
+ * @param {(item: T, index: number) => unknown} predicate
+ * @param {MapOptions} [options]
+ * @returns {Promise<T[]>}
+ */
+export function filter<T>(items: Iterable<T> | AsyncIterable<T>, predicate: (item: T, index: number) => unknown, options?: MapOptions): Promise<T[]>;
+/**
+ * Runs async functions one after the other and returns their results.
+ *
+ * @example
+ * await async.series([() => migrateUsers(), () => migrateOrders()]);
+ *
+ * @template T
+ * @param {Iterable<() => T | PromiseLike<T>>} tasks
+ * @returns {Promise<Array<Awaited<T>>>}
+ */
+export function series<T>(tasks: Iterable<() => T | PromiseLike<T>>): Promise<Array<Awaited<T>>>;
+/**
+ * Runs async functions at the same time, or a few at once with
+ * `concurrency`, and returns their results in order.
+ *
+ * @example
+ * const [users, posts] = await async.parallel([() => loadUsers(), () => loadPosts()]);
+ * await async.parallel(jobs, { concurrency: 4 });
+ *
+ * @template T
+ * @param {Iterable<() => T | PromiseLike<T>>} tasks
+ * @param {MapOptions} [options]
+ * @returns {Promise<Array<Awaited<T>>>}
+ */
+export function parallel<T>(tasks: Iterable<() => T | PromiseLike<T>>, options?: MapOptions): Promise<Array<Awaited<T>>>;
+/**
+ * A limiter: wrap calls with it, and at most `concurrency` run at once
+ * while the rest wait their turn. Like `p-limit`.
+ *
+ * @example
+ * const limit = async.limit(3);
+ * const results = await Promise.all(urls.map((url) => limit(() => fetch(url))));
+ *
+ * @param {number} concurrency
+ * @returns {Limiter}
+ */
+export function limit(concurrency: number): Limiter;
+/**
+ * A rate limiter: at most `max` calls start within any `interval`. Made
+ * for APIs that allow, say, 10 requests per second.
+ *
+ * @example
+ * const throttled = async.rateLimit(10, "1s");
+ * const pages = await Promise.all(ids.map((id) => throttled(() => api.get(`items/${id}`))));
+ *
+ * @param {number} max How many calls may start per interval.
+ * @param {number | string} interval The window, in ms or like `"1s"`.
+ * @returns {RateLimiter}
+ */
+export function rateLimit(max: number, interval: number | string): RateLimiter;
+/**
+ * A task queue with a concurrency limit, priorities, pause and per-task
+ * timeouts.
+ *
+ * @example
+ * const jobs = async.queue({ concurrency: 2, timeout: "30s" });
+ * jobs.add(() => sendEmail(a));
+ * jobs.add(() => sendEmail(vip), { priority: 10 }); // jumps the line
+ * await jobs.onIdle();
+ *
+ * @param {QueueOptions} [options]
+ * @returns {Queue}
+ */
+export function queue(options?: QueueOptions): Queue;
+/**
+ * A mutex: tasks given to `run()` never overlap. Put it around
+ * read-modify-write steps, like updating a file or refreshing a token.
+ *
+ * @example
+ * const lock = async.mutex();
+ * await lock.run(async () => {
+ *   const data = nc.readJSON("./counter.json", { n: 0 });
+ *   nc.writeJSON("./counter.json", { n: data.n + 1 });
+ * });
+ *
+ * @returns {Mutex}
+ */
+export function mutex(): Mutex;
+/**
+ * A promise along with its `resolve` and `reject`. Handy to connect
+ * callbacks or events to `await`.
+ *
+ * @example
+ * const ready = async.deferred();
+ * socket.once("open", () => ready.resolve());
+ * await ready.promise;
+ *
+ * @template [T=void]
+ * @returns {Deferred<T>}
+ */
+export function deferred<T = void>(): Deferred<T>;
+/**
+ * Waits for every promise and sorts successes from failures.
+ *
+ * @example
+ * const { fulfilled, rejected } = await async.settle(emails.map(send));
+ * nc.info(`${fulfilled.length} sent, ${rejected.length} failed`);
+ *
+ * @template T
+ * @param {Iterable<T | PromiseLike<T>>} promises
+ * @returns {Promise<Settled<Awaited<T>>>}
+ */
+export function settle<T>(promises: Iterable<T | PromiseLike<T>>): Promise<Settled<Awaited<T>>>;
+/**
+ * Like `Promise.all`, for an object of promises.
+ *
+ * @example
+ * const { user, orders } = await async.props({ user: getUser(id), orders: getOrders(id) });
+ *
+ * @template {Record<string, unknown>} T
+ * @param {T} object
+ * @returns {Promise<{ [K in keyof T]: Awaited<T[K]> }>}
+ */
+export function props<T extends Record<string, unknown>>(object: T): Promise<{ [K in keyof T]: Awaited<T[K]>; }>;
+/**
+ * Calls `fn` until it returns something truthy, and resolves with it.
+ * Errors count as "not yet".
+ *
+ * @example
+ * await async.poll(() => fetch(healthUrl).then((res) => res.ok), { interval: "500ms", timeout: "30s" });
+ *
+ * @template T
+ * @param {() => T | PromiseLike<T>} fn
+ * @param {PollOptions} [options]
+ * @returns {Promise<NonNullable<Awaited<T>>>}
+ * @throws {TimeoutError}
+ * @throws {AbortError}
+ */
+export function poll<T>(fn: () => T | PromiseLike<T>, options?: PollOptions): Promise<NonNullable<Awaited<T>>>;
+/**
+ * Makes any promise give up when a signal fires. The work behind it keeps
+ * running unless it listens to the signal too.
+ *
+ * @example
+ * const controller = new AbortController();
+ * const rows = await async.abortable(slowQuery(), controller.signal);
+ *
+ * @template T
+ * @param {T | PromiseLike<T>} promise
+ * @param {AbortSignal} [signal]
+ * @returns {Promise<Awaited<T>>}
+ * @throws {AbortError} When the signal fires first.
+ */
+export function abortable<T>(promise: T | PromiseLike<T>, signal?: AbortSignal): Promise<Awaited<T>>;
+import { retry } from "./Func.js";
+import { timeout } from "./Func.js";
+export { retry, timeout };
+//# sourceMappingURL=Async.d.ts.map

package/types/src/Async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Async.d.ts","sourceRoot":"","sources":["../../src/Async.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;0BA8Ba,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE;;;;sBAK9F,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,IAAI,IAAI,CAAC;IAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAoB7L,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;;;;YACrF,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;;;;WACpG,MAAM,KAAK;;;;WACX,MAAM,KAAK;;;;WACX,MAAM,IAAI;;;;YACV,MAAM,OAAO,CAAC,IAAI,CAAC;;;;aACnB,MAAM,OAAO,CAAC,IAAI,CAAC;;;;UACnB,MAAM;;;;aACN,MAAM;cACN,OAAO;;;;iBACP,MAAM;;;;;qBAKP,CAAC;aAEA,OAAO,CAAC,CAAC,CAAC;aACV,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI;YACnC,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI;;;;aAC1B,OAAO;;;;;oBAKR,CAAC;;;;eAEA,CAAC,EAAE;;;;cACH,OAAO,EAAE;;;;aACT,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;SAc9B,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;;;;UACxD,MAAM,OAAO,CAAC,MAAM,IAAI,CAAC;cACzB,OAAO;;AAuGrB;;;;;;;;;GASG;AACH,gCAJW,MAAM,GAAG,MAAM,YACf;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAIzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,oBARa,CAAC,EACD,CAAC,SACH,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,MAC9B,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,YAC9C,UAAU,GACR,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAyGtC;AAED;;;;;;;;;;;GAWG;AACH,wBANa,CAAC,SACH,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,MAC9B,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,YACnC,UAAU,GACR,OAAO,CAAC,IAAI,CAAC,CAIzB;AAED;;;;;;;;;;;;GAYG;AACH,uBANa,CAAC,SACH,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,aAC9B,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,YACnC,UAAU,GACR,OAAO,CAAC,CAAC,EAAE,CAAC,CAUxB;AAED;;;;;;;;;GASG;AACH,uBAJa,CAAC,SACH,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAOtC;AAED;;;;;;;;;;;;GAYG;AACH,yBALa,CAAC,SACH,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,YAClC,UAAU,GACR,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAItC;AAED;;;;;;;;;;GAUG;AACH,mCAHW,MAAM,GACJ,OAAO,CAgDnB;AAED;;;;;;;;;;;GAWG;AACH,+BAJW,MAAM,YACN,MAAM,GAAG,MAAM,GACb,WAAW,CAiCvB;AAED;;;;;;;;;;;;GAYG;AACH,gCAHW,YAAY,GACV,KAAK,CA+FjB;AAED;;;;;;;;;;;;GAYG;AACH,yBAFa,KAAK,CA4BjB;AAED;;;;;;;;;;;GAWG;AACH,yBAHc,CAAC,YACF,QAAQ,CAAC,CAAC,CAAC,CAwBvB;AAED;;;;;;;;;;GAUG;AACH,uBAJa,CAAC,YACH,QAAQ,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CASxC;AAED;;;;;;;;;GASG;AACH,sBAJuC,CAAC,SAA1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAE,UAC3B,CAAC,GACC,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAE,CAAC,CAMtD;AAED;;;;;;;;;;;;;GAaG;AACH,qBAPa,CAAC,MACH,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,YACxB,WAAW,GACT,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAwB5C;AAED;;;;;;;;;;;;;GAaG;AACH,0BANa,CAAC,WACH,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,WAClB,WAAW,GACT,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAa/B"}

package/types/src/Cache.d.ts

@@ -0,0 +1,221 @@
+export = Cache;
+/**
+ * An in-memory cache with a size limit and expiry.
+ *
+ * @template K
+ * @template V
+ */
+declare class Cache<K, V> {
+    /**
+     * @example
+     * const cache = new nc.Cache({ max: 500, ttl: "1h", updateAgeOnGet: true });
+     *
+     * @param {CacheOptions<K, V>} [options]
+     */
+    constructor(options?: CacheOptions<K, V>);
+    /**
+     * Reads a value and marks it as recently used.
+     *
+     * @param {K} key
+     * @returns {V | undefined} `undefined` if missing or expired.
+     */
+    get(key: K): V | undefined;
+    /**
+     * Reads a value without counting it as a use or touching the stats.
+     *
+     * @param {K} key
+     * @returns {V | undefined}
+     */
+    peek(key: K): V | undefined;
+    /**
+     * Stores a value. When the cache is full, the least recently used entry
+     * goes. A value being loaded for this key by `getOrSet()` is not stored
+     * when it arrives: the one you set stays.
+     *
+     * @example
+     * cache.set("token", token, { ttl: "15m" });
+     *
+     * @param {K} key
+     * @param {V} value
+     * @param {CacheSetOptions} [options]
+     * @returns {this}
+     */
+    set(key: K, value: V, options?: CacheSetOptions): this;
+    /**
+     * Returns the cached value, or calls `loader`, stores the result and
+     * returns it. Simultaneous calls for the same key share one `loader` call,
+     * and a failed load caches nothing.
+     *
+     * With `staleWhileRevalidate`, an entry that just expired is returned at
+     * once while a new value loads in the background, so callers never wait
+     * on a refresh.
+     *
+     * @example
+     * const profile = await cache.getOrSet(`profile:${id}`, () => api.fetchProfile(id), { ttl: "10m" });
+     * const rates = await cache.getOrSet("rates", fetchRates, { ttl: "1m", staleWhileRevalidate: "10m" });
+     *
+     * @param {K} key
+     * @param {() => V | PromiseLike<V>} loader
+     * @param {CacheSetOptions} [options]
+     * @returns {Promise<V>}
+     */
+    getOrSet(key: K, loader: () => V | PromiseLike<V>, options?: CacheSetOptions): Promise<V>;
+    /**
+     * Is there a fresh entry for this key? Doesn't count as a use.
+     *
+     * @param {K} key
+     * @returns {boolean}
+     */
+    has(key: K): boolean;
+    /**
+     * Removes an entry. A value being loaded for this key by `getOrSet()` is
+     * not stored when it arrives.
+     *
+     * @param {K} key
+     * @returns {boolean} `true` if there was one.
+     */
+    delete(key: K): boolean;
+    /**
+     * Removes every entry. Stats are kept.
+     *
+     * @returns {void}
+     */
+    clear(): void;
+    /**
+     * Removes expired entries now instead of waiting for them to be read.
+     *
+     * @returns {number} How many were removed.
+     */
+    prune(): number;
+    /**
+     * Time left before an entry expires.
+     *
+     * @param {K} key
+     * @returns {number | undefined} Milliseconds, `Infinity` if it never expires, `undefined` if missing.
+     */
+    ttl(key: K): number | undefined;
+    /**
+     * Wraps a function so its results are cached here.
+     *
+     * @example
+     * const getWeather = cache.wrap((city) => api.weather(city), { key: (city) => city.toLowerCase(), ttl: "30m" });
+     * await getWeather("Paris");
+     *
+     * @template {any[]} A
+     * @param {(...args: A) => V | PromiseLike<V>} fn
+     * @param {{ key?: (...args: A) => K } & CacheSetOptions} [options] `key` builds the cache key from the arguments. By default, primitives are compared by value and plain objects by content.
+     * @returns {(...args: A) => Promise<V>}
+     */
+    wrap<A extends any[]>(fn: (...args: A) => V | PromiseLike<V>, options?: {
+        key?: (...args: A) => K;
+    } & CacheSetOptions): (...args: A) => Promise<V>;
+    /** Number of entries, including expired ones not yet removed. */
+    get size(): number;
+    /** Hit and miss counts. */
+    get stats(): CacheStats;
+    /**
+     * Puts every counter of `stats` back to zero.
+     *
+     * @returns {this}
+     */
+    resetStats(): this;
+    /**
+     * Fresh keys, least recently used first.
+     * @returns {K[]}
+     */
+    keys(): K[];
+    /**
+     * Fresh values, least recently used first.
+     * @returns {V[]}
+     */
+    values(): V[];
+    /**
+     * Fresh `[key, value]` pairs, least recently used first.
+     * @returns {Array<[K, V]>}
+     */
+    entries(): Array<[K, V]>;
+    /**
+     * Lets you write `for (const [key, value] of cache)`.
+     * @returns {IterableIterator<[K, V]>}
+     */
+    [Symbol.iterator](): IterableIterator<[K, V]>;
+    #private;
+}
+declare namespace Cache {
+    export { CacheRemovalReason, CacheOptions, CacheSetOptions, CacheStats, CacheEntry };
+}
+/**
+ * Why an entry left the cache.
+ */
+type CacheRemovalReason = "evict" | "expire" | "delete" | "set" | "clear";
+/**
+ * Options for `new Cache()`.
+ */
+type CacheOptions<K, V> = {
+    /**
+     * Maximum number of entries. When full, the least recently used goes. No limit by default.
+     */
+    max?: number | undefined;
+    /**
+     * How long entries live, in ms or like `"10m"`. `0` means forever, the default.
+     */
+    ttl?: string | number | undefined;
+    /**
+     * After an entry expires, `getOrSet()` may still return it for this long while it loads a new value in the background.
+     */
+    staleWhileRevalidate?: string | number | undefined;
+    /**
+     * Reading an entry restarts its time to live.
+     */
+    updateAgeOnGet?: boolean | undefined;
+    /**
+     * Called whenever an entry leaves the cache.
+     */
+    onRemove?: ((key: K, value: V, reason: CacheRemovalReason) => void) | undefined;
+};
+/**
+ * Options for `set()` and `getOrSet()`.
+ */
+type CacheSetOptions = {
+    /**
+     * Time to live of this entry. `0` means forever.
+     */
+    ttl?: string | number | undefined;
+    /**
+     * How long this entry can be served by `getOrSet()` after it expires, while a new value loads.
+     */
+    staleWhileRevalidate?: string | number | undefined;
+};
+/**
+ * Cache stats.
+ */
+type CacheStats = {
+    /**
+     * Reads that found a usable entry.
+     */
+    hits: number;
+    /**
+     * Reads that found nothing or an expired entry.
+     */
+    misses: number;
+    sets: number;
+    /**
+     * Entries dropped because the cache was full.
+     */
+    evictions: number;
+    /**
+     * Entries dropped because they expired.
+     */
+    expirations: number;
+    /**
+     * From 0 to 1.
+     */
+    hitRate: number;
+};
+type CacheEntry<V> = {
+    value: V;
+    expires: number;
+    ttl: number;
+    stale: number;
+};
+//# sourceMappingURL=Cache.d.ts.map

package/types/src/Cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../src/Cache.js"],"names":[],"mappings":";AA8DA;;;;;GAKG;AACH,oBAHa,CAAC,EACD,CAAC;IAsBZ;;;;;OAKG;IACH,sBAFW,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAQ5B;IA8CD;;;;;OAKG;IACH,SAHW,CAAC,GACC,CAAC,GAAG,SAAS,CAgBzB;IAED;;;;;OAKG;IACH,UAHW,CAAC,GACC,CAAC,GAAG,SAAS,CAIzB;IAED;;;;;;;;;;;;OAYG;IACH,SALW,CAAC,SACD,CAAC,YACD,eAAe,GACb,IAAI,CAwBhB;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,cALW,CAAC,UACD,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,YACxB,eAAe,GACb,OAAO,CAAC,CAAC,CAAC,CAmBtB;IA8BD;;;;;OAKG;IACH,SAHW,CAAC,GACC,OAAO,CAInB;IAED;;;;;;OAMG;IACH,YAHW,CAAC,GACC,OAAO,CAQnB;IAED;;;;OAIG;IACH,SAFa,IAAI,CAKhB;IAED;;;;OAIG;IACH,SAFa,MAAM,CAYlB;IAED;;;;;OAKG;IACH,SAHW,CAAC,GACC,MAAM,GAAG,SAAS,CAM9B;IAED;;;;;;;;;;;OAWG;IACH,KALqB,CAAC,SAAR,GAAG,EAAG,MACT,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,YAClC;QAAE,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAA;KAAE,GAAG,eAAe,GAC3C,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAQtC;IAED,iEAAiE;IACjE,mBAEC;IAED,2BAA2B;IAC3B,aAEoB,UAAU,CAC7B;IAED;;;;OAIG;IACH,cAFa,IAAI,CAKhB;IAgBD;;;OAGG;IACH,QAFa,CAAC,EAAE,CAIf;IAED;;;OAGG;IACH,UAFa,CAAC,EAAE,CAIf;IAED;;;OAGG;IACH,WAFa,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAIzB;IAED;;;OAGG;IACH,qBAFa,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAIpC;;CACF;;;;;;;0BA7ZY,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO;;;;kBAK/C,CAAC,EACD,CAAC;;;;;;;;;;;;;;;;;;;;sBAMM,CAAC,SAAS,CAAC,UAAU,kBAAkB,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;UAatD,MAAM;;;;YACN,MAAM;UACN,MAAM;;;;eACN,MAAM;;;;iBACN,MAAM;;;;aACN,MAAM;;gBAIP,CAAC,IACD;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE"}