@ix-xs/node-comfort 2.0.0 → 2.1.0

package/types/src/Http.d.ts

@@ -1,5 +1,5 @@
 declare namespace _exports {
-    export { HttpBody, HttpMethod, QueryParams, HttpRetryOptions, HttpRequestConfig, HttpHooks, HttpOptions, HttpResponse, HttpClient };
+    export { HttpBody, HttpMethod, QueryParams, HttpHeaders, HttpRetryOptions, HttpRequestConfig, HttpHooks, HttpOptions, HttpResponse, ResponseSchema, HttpOptionsOf, HttpClient };
 }
 declare namespace _exports {
     export { request };
@@ -23,21 +23,25 @@ type HttpBody = string | Buffer | Uint8Array | ArrayBuffer | URLSearchParams | F
  */
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | (string & {});
 /**
- * Query string values. `null` and `undefined` are skipped, arrays repeat the key.
+ * Query string values. `null` and `undefined` are skipped, arrays repeat the key, dates are sent in ISO format.
  */
-type QueryParams = Record<string, string | number | boolean | null | undefined | Array<string | number | boolean>>;
+type QueryParams = Record<string, string | number | boolean | Date | null | undefined | Array<string | number | boolean | Date>>;
+/**
+ * Request headers: an object, a `Headers` instance or a list of pairs.
+ */
+type HttpHeaders = Record<string, string | undefined> | Headers | Array<[string, string]>;
 /**
  * Retry settings.
  */
 type HttpRetryOptions = {
     /**
-     * Total attempts, the first included. Defaults to `3` for methods that are safe to repeat, `1` for the others.
+     * Total attempts, the first included. Defaults to `3` for methods that are safe to repeat, `1` for the others. A number you give applies to every method, POST included.
      */
     attempts?: number | undefined;
     /**
-     * Wait before the first retry, in ms. Defaults to `300`.
+     * Wait before the first retry, in ms or like `"1s"`. Defaults to `300`.
      */
-    delay?: number | undefined;
+    delay?: string | number | undefined;
     /**
      * Multiplies the wait after each attempt. Defaults to `2`.
      */
@@ -45,13 +49,17 @@ type HttpRetryOptions = {
     /**
      * Longest wait, `Retry-After` included. Defaults to 30 seconds.
      */
-    maxDelay?: number | undefined;
+    maxDelay?: string | number | undefined;
+    /**
+     * Shorten each wait by a random amount, up to half of it, so many clients don't all come back at the same instant.
+     */
+    jitter?: boolean | undefined;
     /**
      * Statuses worth retrying. Defaults to 408, 413, 429, 500, 502, 503 and 504.
      */
     statuses?: number[] | undefined;
     /**
-     * Methods allowed to retry. POST and PATCH aren't, by default, so nothing gets created twice.
+     * Methods retried when you give no number of attempts. POST and PATCH aren't, by default, so nothing gets created twice.
      */
     methods?: HttpMethod[] | undefined;
 };
@@ -106,9 +114,13 @@ type HttpOptions = {
     /**
      * Set a header to `undefined` to remove a default one.
      */
-    headers?: Record<string, string | undefined> | undefined;
+    headers?: HttpHeaders | undefined;
     /**
-     * Added to the URL's own query string.
+     * Values for the `:name` parts of the URL: `"users/:id"` with `{ id: 42 }` gives `users/42`. They're encoded for you.
+     */
+    params?: Record<string, string | number | boolean> | undefined;
+    /**
+     * Added to the URL's own query string, and to the client's default query.
      */
     query?: URLSearchParams | QueryParams | undefined;
     /**
@@ -133,17 +145,23 @@ type HttpOptions = {
         password: string;
     } | undefined;
     /**
-     * Time limit per attempt, like `"10s"`. `false` turns it off. Defaults to 30 seconds.
+     * Time limit per attempt, like `"10s"`. `false` turns it off. Defaults to 30 seconds. With `responseType: "stream"`, it only covers the wait for the response headers.
      */
     timeout?: string | number | false | undefined;
     /**
-     * Number of attempts, `false`, or retry settings.
+     * Number of attempts, `false`, or retry settings. A request whose body is a stream is never retried.
      */
     retry?: number | false | HttpRetryOptions | undefined;
     /**
      * How to read the body. `"auto"` reads JSON or text based on the content type, a Buffer otherwise.
      */
     responseType?: "auto" | "json" | "buffer" | "text" | "stream" | undefined;
+    /**
+     * Checks the body of a 2xx response, and replaces it with the result: pass a `nc.schema` and bad data from an API stops at the door, with a `ValidationError`. `data` takes the type the schema describes.
+     */
+    schema?: {
+        parse(data: unknown): unknown;
+    } | undefined;
     /**
      * Throw an `HttpError` when the status isn't 2xx. Defaults to `true`.
      */
@@ -180,6 +198,10 @@ type HttpResponse<T = any> = {
      * Lower-cased names.
      */
     headers: Record<string, string>;
+    /**
+     * The `Set-Cookie` headers, one per cookie. `headers` can only hold one of them.
+     */
+    cookies: string[];
     /**
      * The body, already read (see `responseType`).
      */
@@ -197,6 +219,19 @@ type HttpResponse<T = any> = {
      */
     attempts: number;
 };
+/**
+ * What the `schema` option takes: a `nc.schema`, or anything else with a
+ * `parse()` method that returns the checked value or throws.
+ */
+type ResponseSchema = {
+    parse(data: unknown): unknown;
+};
+/**
+ * Request options, where `schema` gives `response.data` its type.
+ */
+type HttpOptionsOf<S extends ResponseSchema> = Omit<HttpOptions, "schema"> & {
+    schema?: S;
+};
 /**
  * A client with its own defaults, from `create()`.
  */
@@ -204,11 +239,15 @@ type HttpClient = {
     /**
      * Sends a request.
      */
-    request: <T = any>(url: string | URL, options?: HttpOptions) => Promise<HttpResponse<T>>;
+    request: <T = any, S extends ResponseSchema = {
+        parse(data: unknown): T;
+    }>(url: string | URL, options?: HttpOptionsOf<S>) => Promise<HttpResponse<ReturnType<S["parse"]>>>;
     /**
      * Sends a GET request.
      */
-    get: <T = any>(url: string | URL, options?: HttpOptions) => Promise<HttpResponse<T>>;
+    get: <T = any, S extends ResponseSchema = {
+        parse(data: unknown): T;
+    }>(url: string | URL, options?: HttpOptionsOf<S>) => Promise<HttpResponse<ReturnType<S["parse"]>>>;
     /**
      * Sends a HEAD request.
      */
@@ -216,19 +255,27 @@ type HttpClient = {
     /**
      * Sends a DELETE request.
      */
-    delete: <T = any>(url: string | URL, options?: HttpOptions) => Promise<HttpResponse<T>>;
+    delete: <T = any, S extends ResponseSchema = {
+        parse(data: unknown): T;
+    }>(url: string | URL, options?: HttpOptionsOf<S>) => Promise<HttpResponse<ReturnType<S["parse"]>>>;
     /**
      * Sends a POST request. Objects and arrays go as JSON.
      */
-    post: <T = any>(url: string | URL, data?: unknown, options?: HttpOptions) => Promise<HttpResponse<T>>;
+    post: <T = any, S extends ResponseSchema = {
+        parse(data: unknown): T;
+    }>(url: string | URL, data?: unknown, options?: HttpOptionsOf<S>) => Promise<HttpResponse<ReturnType<S["parse"]>>>;
     /**
      * Sends a PUT request. Objects and arrays go as JSON.
      */
-    put: <T = any>(url: string | URL, data?: unknown, options?: HttpOptions) => Promise<HttpResponse<T>>;
+    put: <T = any, S extends ResponseSchema = {
+        parse(data: unknown): T;
+    }>(url: string | URL, data?: unknown, options?: HttpOptionsOf<S>) => Promise<HttpResponse<ReturnType<S["parse"]>>>;
     /**
      * Sends a PATCH request. Objects and arrays go as JSON.
      */
-    patch: <T = any>(url: string | URL, data?: unknown, options?: HttpOptions) => Promise<HttpResponse<T>>;
+    patch: <T = any, S extends ResponseSchema = {
+        parse(data: unknown): T;
+    }>(url: string | URL, data?: unknown, options?: HttpOptionsOf<S>) => Promise<HttpResponse<ReturnType<S["parse"]>>>;
     /**
      * Saves a response to a file.
      */
@@ -256,25 +303,31 @@ type HttpClient = {
  * });
  * res.data; // parsed JSON
  *
- * @template [T=any]
+ * @template [T=any] The type of `data`, when no `schema` says it.
+ * @template {ResponseSchema} [S={ parse(data: unknown): T }]
  * @param {string | URL} url An absolute URL, or a path when `baseURL` is set.
- * @param {HttpOptions} [options]
- * @returns {Promise<HttpResponse<T>>}
+ * @param {HttpOptionsOf<S>} [options]
+ * @returns {Promise<HttpResponse<ReturnType<S["parse"]>>>}
  * @throws {HttpError | TimeoutError | AbortError}
  */
-declare function request<T = any>(url: string | URL, options?: HttpOptions): Promise<HttpResponse<T>>;
+declare function request<T = any, S extends ResponseSchema = {
+    parse(data: unknown): T;
+}>(url: string | URL, options?: HttpOptionsOf<S>): Promise<HttpResponse<ReturnType<S["parse"]>>>;
 /**
  * Sends a GET request.
  *
  * @example
  * const { data } = await http.get("https://api.example.com/users", { query: { page: 2, tags: ["a", "b"] } });
  *
- * @template [T=any]
+ * @template [T=any] The type of `data`, when no `schema` says it.
+ * @template {ResponseSchema} [S={ parse(data: unknown): T }]
  * @param {string | URL} url
- * @param {HttpOptions} [options]
- * @returns {Promise<HttpResponse<T>>}
+ * @param {HttpOptionsOf<S>} [options]
+ * @returns {Promise<HttpResponse<ReturnType<S["parse"]>>>}
  */
-declare function get<T = any>(url: string | URL, options?: HttpOptions): Promise<HttpResponse<T>>;
+declare function get<T = any, S extends ResponseSchema = {
+    parse(data: unknown): T;
+}>(url: string | URL, options?: HttpOptionsOf<S>): Promise<HttpResponse<ReturnType<S["parse"]>>>;
 /**
  * Sends a HEAD request: headers only, no body.
  *
@@ -296,48 +349,65 @@ declare function head<T = undefined>(url: string | URL, options?: HttpOptions):
  * const { data: user } = await http.post("https://api.example.com/users", { name: "Ada" });
  * await http.post(uploadUrl, formData);
  *
- * @template [T=any]
+ * @template [T=any] The type of `data`, when no `schema` says it.
+ * @template {ResponseSchema} [S={ parse(data: unknown): T }]
  * @param {string | URL} url
  * @param {unknown} [data]
- * @param {HttpOptions} [options]
- * @returns {Promise<HttpResponse<T>>}
+ * @param {HttpOptionsOf<S>} [options]
+ * @returns {Promise<HttpResponse<ReturnType<S["parse"]>>>}
  */
-declare function post<T = any>(url: string | URL, data?: unknown, options?: HttpOptions): Promise<HttpResponse<T>>;
+declare function post<T = any, S extends ResponseSchema = {
+    parse(data: unknown): T;
+}>(url: string | URL, data?: unknown, options?: HttpOptionsOf<S>): Promise<HttpResponse<ReturnType<S["parse"]>>>;
 /**
  * Sends a PUT request. The body works like in `post()`.
  *
- * @template [T=any]
+ * @template [T=any] The type of `data`, when no `schema` says it.
+ * @template {ResponseSchema} [S={ parse(data: unknown): T }]
  * @param {string | URL} url
  * @param {unknown} [data]
- * @param {HttpOptions} [options]
- * @returns {Promise<HttpResponse<T>>}
+ * @param {HttpOptionsOf<S>} [options]
+ * @returns {Promise<HttpResponse<ReturnType<S["parse"]>>>}
  */
-declare function put<T = any>(url: string | URL, data?: unknown, options?: HttpOptions): Promise<HttpResponse<T>>;
+declare function put<T = any, S extends ResponseSchema = {
+    parse(data: unknown): T;
+}>(url: string | URL, data?: unknown, options?: HttpOptionsOf<S>): Promise<HttpResponse<ReturnType<S["parse"]>>>;
 /**
  * Sends a PATCH request. The body works like in `post()`.
  *
- * @template [T=any]
+ * @template [T=any] The type of `data`, when no `schema` says it.
+ * @template {ResponseSchema} [S={ parse(data: unknown): T }]
  * @param {string | URL} url
  * @param {unknown} [data]
- * @param {HttpOptions} [options]
- * @returns {Promise<HttpResponse<T>>}
+ * @param {HttpOptionsOf<S>} [options]
+ * @returns {Promise<HttpResponse<ReturnType<S["parse"]>>>}
  */
-declare function patch<T = any>(url: string | URL, data?: unknown, options?: HttpOptions): Promise<HttpResponse<T>>;
+declare function patch<T = any, S extends ResponseSchema = {
+    parse(data: unknown): T;
+}>(url: string | URL, data?: unknown, options?: HttpOptionsOf<S>): Promise<HttpResponse<ReturnType<S["parse"]>>>;
 /**
  * Sends a DELETE request.
  *
  * @example
  * await http.delete(`https://api.example.com/users/${id}`);
  *
- * @template [T=any]
+ * @template [T=any] The type of `data`, when no `schema` says it.
+ * @template {ResponseSchema} [S={ parse(data: unknown): T }]
  * @param {string | URL} url
- * @param {HttpOptions} [options]
- * @returns {Promise<HttpResponse<T>>}
+ * @param {HttpOptionsOf<S>} [options]
+ * @returns {Promise<HttpResponse<ReturnType<S["parse"]>>>}
  */
-declare function del<T = any>(url: string | URL, options?: HttpOptions): Promise<HttpResponse<T>>;
+declare function del<T = any, S extends ResponseSchema = {
+    parse(data: unknown): T;
+}>(url: string | URL, options?: HttpOptionsOf<S>): Promise<HttpResponse<ReturnType<S["parse"]>>>;
 /**
  * Downloads to a file as a stream, so memory stays flat whatever the size.
- * Folders are created, and a partial file is removed if it fails.
+ * Folders are created. The data goes to a temporary file that takes the
+ * final name once complete, so a failed or interrupted download never
+ * leaves half a file where you expect a whole one.
+ *
+ * `timeout` is how long the server gets to start answering; the transfer
+ * itself can take as long as it needs. Use `signal` to put a limit on it.
  *
  * @example
  * await http.download("https://example.com/video.mp4", "./downloads/video.mp4", {

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

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

package/types/src/Id.d.ts

@@ -2,6 +2,11 @@
  * Encodings for `token()`.
  */
 export type TokenEncoding = "hex" | "base64" | "base64url" | "base58" | "base32";
+/**
+ * A namespace for `uuidv5()`: one of the four standard ones, or any UUID of
+ * your own.
+ */
+export type UUIDNamespace = "dns" | "url" | "oid" | "x500" | (string & {});
 /**
  * Options for `snowflake()` and `parseSnowflake()`.
  */
@@ -47,11 +52,26 @@ export type ParsedSnowflake = {
  * @returns {string}
  */
 export function uuid(): string;
+/**
+ * A UUID v5: the same name in the same namespace always gives the same id.
+ * Use it to derive a stable id from something you already have, like a URL
+ * or an email, without storing a mapping.
+ *
+ * @example
+ * id.uuidv5("example.com", "dns");          // "cfbff0d1-9375-5685-968c-48ce8b15ae17", every time
+ * id.uuidv5("https://example.com/a", "url");
+ * id.uuidv5("ada@example.com", MY_APP_NAMESPACE); // any UUID works as a namespace
+ *
+ * @param {string | Buffer | Uint8Array} name
+ * @param {UUIDNamespace} namespace `"dns"`, `"url"`, `"oid"`, `"x500"` or a UUID.
+ * @returns {string}
+ */
+export function uuidv5(name: string | Buffer | Uint8Array, namespace: UUIDNamespace): string;
 /**
  * A UUID v7: it starts with a timestamp, so ids sort by creation time.
  * That keeps database indexes compact, which makes them great primary
  * keys. Ids from the same process always increase, even within a
- * millisecond.
+ * millisecond, and even if the system clock steps back.
  *
  * @example
  * id.uuidv7();               // "0190a5c4-7c1e-7b2a-9f3e-1c2d3e4f5a6b"
@@ -65,13 +85,28 @@ export function uuidv7(): string;
  * the same millisecond still increase.
  *
  * @example
- * id.ulid();                       // "01HQ3Z8K9V3N5W7Y2XJ4T6R8PB"
- * id.ulid(Date.UTC(2024, 0, 1));   // for a given time
+ * id.ulid();                     // "01HQ3Z8K9V3N5W7Y2XJ4T6R8PB"
+ * id.ulid(Date.UTC(2024, 0, 1)); // for a given time
+ *
+ * @param {number | Date} [time] The moment to encode. Defaults to now.
+ * @returns {string}
+ * @throws {RangeError} If the time is not a valid timestamp.
+ */
+export function ulid(time?: number | Date): string;
+/**
+ * A MongoDB-style ObjectId: 24 hex characters that start with the time, in
+ * seconds, and increase within the process.
+ *
+ * @example
+ * id.objectId();                           // "65f2a9c47b1e4d0c9a3f2b10"
+ * id.timestamp(id.objectId());             // when it was created, to the second
+ * id.objectId(new Date("2024-01-01"));     // for a given time
  *
- * @param {number} [time] Timestamp to encode, in ms. Defaults to now.
+ * @param {number | Date} [time] The moment to encode. Defaults to now.
  * @returns {string}
+ * @throws {RangeError} If the time is not a valid timestamp.
  */
-export function ulid(time?: number): string;
+export function objectId(time?: number | Date): string;
 /**
  * A short, URL-safe random id, like `nanoid`. At 21 characters, collisions
  * are as unlikely as with a UUID.
@@ -98,6 +133,20 @@ export function nano(size?: number, alphabet?: string): string;
  * @returns {(size?: number) => string}
  */
 export function customAlphabet(alphabet: string, size?: number): (size?: number) => string;
+/**
+ * A random id with a prefix that says what it identifies, like Stripe's
+ * `cus_...` and `sub_...`. A glance at a log line or a support ticket tells
+ * you what kind of thing the id points to.
+ *
+ * @example
+ * id.prefixed("user");      // "user_7Hq2mXc0LrT9aZ4bWk1PdE8s"
+ * id.prefixed("inv", 12);   // "inv_Q0f8ZrT1bK4m"
+ *
+ * @param {string} prefix
+ * @param {number} [size=24] How many random characters come after the prefix (letters and digits).
+ * @returns {string}
+ */
+export function prefixed(prefix: string, size?: number): string;
 /**
  * A random token for API keys, session ids, reset links...
  *
@@ -133,6 +182,7 @@ export function code(length?: number, alphabet?: string): string;
  *
  * @param {SnowflakeOptions} [options]
  * @returns {string}
+ * @throws {RangeError} If the epoch is in the future.
  */
 export function snowflake(options?: SnowflakeOptions): string;
 /**
@@ -144,14 +194,16 @@ export function snowflake(options?: SnowflakeOptions): string;
  * @param {string | bigint} id
  * @param {SnowflakeOptions} [options] Use the epoch it was created with.
  * @returns {ParsedSnowflake}
+ * @throws {TypeError} If the id is not a string of digits or a bigint.
  */
 export function parseSnowflake(id: string | bigint, options?: SnowflakeOptions): ParsedSnowflake;
 /**
- * When a ULID or a UUID v7 was created.
+ * When a UUID v7, a ULID or an ObjectId was created.
  *
  * @example
- * id.timestamp(id.ulid()); // now
- * id.timestamp(id.uuid()); // undefined, v4 has no time in it
+ * id.timestamp(id.ulid());     // now
+ * id.timestamp(id.objectId()); // now, to the second
+ * id.timestamp(id.uuid());     // undefined, v4 has no time in it
  *
  * @param {string} value
  * @returns {Date | undefined}

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

@@ -1 +1 @@
-{"version":3,"file":"Id.d.ts","sourceRoot":"","sources":["../../src/Id.js"],"names":[],"mappings":";;;4BAqBa,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;UAcnD,IAAI;;;;eACJ,MAAM;cACN,MAAM;eACN,MAAM;;;;eACN,MAAM;;AA8EpB;;;;;;;GAOG;AACH,wBAFa,MAAM,CAIlB;AAKD;;;;;;;;;;;GAWG;AACH,0BAFa,MAAM,CAsBlB;AAMD;;;;;;;;;;GAUG;AACH,4BAHW,MAAM,GACJ,MAAM,CA0BlB;AAED;;;;;;;;;;;;GAYG;AACH,4BAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAIlB;AAED;;;;;;;;;;GAUG;AACH,yCAJW,MAAM,SACN,MAAM,GACJ,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAKrC;AAED;;;;;;;;;;;GAWG;AACH,8BAJW,MAAM,aACN,aAAa,GACX,MAAM,CAOlB;AAED;;;;;;;;;;;GAWG;AACH,8BAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAIlB;AAKD;;;;;;;;;GASG;AACH,oCAHW,gBAAgB,GACd,MAAM,CAgBlB;AAED;;;;;;;;;GASG;AACH,mCAJW,MAAM,GAAG,MAAM,YACf,gBAAgB,GACd,eAAe,CAY3B;AAED;;;;;;;;;GASG;AACH,iCAHW,MAAM,GACJ,IAAI,GAAG,SAAS,CAa5B;AAED;;;;;;;;;;GAUG;AACH,6BAHW,MAAM,GACJ,MAAM,CAKlB;AAED;;;;;;;GAOG;AACH,4BAJW,MAAM,GAAG,MAAM,GAAG,UAAU,YAC5B,OAAO,UAAU,EAAE,WAAW,GAC5B,MAAM,CAIlB;AAED;;;;;;;;GAQG;AACH,4BALW,MAAM,GAAG,MAAM,GAAG,UAAU,UAC5B,MAAM,GAAG,MAAM,GAAG,UAAU,YAC5B,OAAO,UAAU,EAAE,WAAW,GAC5B,MAAM,CAIlB;AAED;;;;;;;GAOG;AACH,6BAJW,MAAM,GAAG,MAAM,GAAG,UAAU,KAC5B,MAAM,GAAG,MAAM,GAAG,UAAU,GAC1B,OAAO,CAInB"}
+{"version":3,"file":"Id.d.ts","sourceRoot":"","sources":["../../src/Id.js"],"names":[],"mappings":";;;4BAqBa,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ;;;;;4BAMpD,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;UAc7C,IAAI;;;;eACJ,MAAM;cACN,MAAM;eACN,MAAM;;;;eACN,MAAM;;AA4JpB;;;;;;;GAOG;AACH,wBAFa,MAAM,CAIlB;AAED;;;;;;;;;;;;;GAaG;AACH,6BAJW,MAAM,GAAG,MAAM,GAAG,UAAU,aAC5B,aAAa,GACX,MAAM,CAYlB;AAMD;;;;;;;;;;;GAWG;AACH,0BAFa,MAAM,CAmBlB;AAoBD;;;;;;;;;;;GAWG;AACH,4BAJW,MAAM,GAAG,IAAI,GACX,MAAM,CA6BlB;AAKD;;;;;;;;;;;;GAYG;AACH,gCAJW,MAAM,GAAG,IAAI,GACX,MAAM,CAalB;AAED;;;;;;;;;;;;GAYG;AACH,4BAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAIlB;AAED;;;;;;;;;;GAUG;AACH,yCAJW,MAAM,SACN,MAAM,GACJ,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAKrC;AAED;;;;;;;;;;;;GAYG;AACH,iCAJW,MAAM,SACN,MAAM,GACJ,MAAM,CAKlB;AAED;;;;;;;;;;;GAWG;AACH,8BAJW,MAAM,aACN,aAAa,GACX,MAAM,CASlB;AAED;;;;;;;;;;;GAWG;AACH,8BAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAIlB;AAKD;;;;;;;;;;GAUG;AACH,oCAJW,gBAAgB,GACd,MAAM,CAiBlB;AAED;;;;;;;;;;GAUG;AACH,mCALW,MAAM,GAAG,MAAM,YACf,gBAAgB,GACd,eAAe,CAkB3B;AAED;;;;;;;;;;GAUG;AACH,iCAHW,MAAM,GACJ,IAAI,GAAG,SAAS,CAU5B;AAKD;;;;;;;;;;GAUG;AACH,6BAHW,MAAM,GACJ,MAAM,CAMlB;AAED;;;;;;;GAOG;AACH,4BAJW,MAAM,GAAG,MAAM,GAAG,UAAU,YAC5B,OAAO,UAAU,EAAE,WAAW,GAC5B,MAAM,CAIlB;AAED;;;;;;;;GAQG;AACH,4BALW,MAAM,GAAG,MAAM,GAAG,UAAU,UAC5B,MAAM,GAAG,MAAM,GAAG,UAAU,YAC5B,OAAO,UAAU,EAAE,WAAW,GAC5B,MAAM,CAIlB;AAED;;;;;;;GAOG;AACH,6BAJW,MAAM,GAAG,MAAM,GAAG,UAAU,KAC5B,MAAM,GAAG,MAAM,GAAG,UAAU,GAC1B,OAAO,CAInB"}

package/types/src/Logger.d.ts

@@ -26,6 +26,26 @@ export type LogFileOptions = {
      */
     maxFiles?: number | undefined;
 };
+/**
+ * A message as `onLog` receives it.
+ */
+export type LogEntry = {
+    time: Date;
+    level: LogLevel;
+    /**
+     * The method that was called.
+     */
+    kind: "log" | "trace" | "debug" | "info" | "success" | "warn" | "error" | "fatal";
+    scope: string | undefined;
+    /**
+     * The line as written, without colors or timestamp.
+     */
+    message: string;
+    /**
+     * What was passed to the method, untouched.
+     */
+    args: unknown[];
+};
 /**
  * Options for `createLogger()` and `configure()`.
  */
@@ -73,6 +93,14 @@ export type LoggerOptions = {
      * Added to every JSON record, like a service name.
      */
     fields?: Record<string, unknown> | undefined;
+    /**
+     * Keys whose values are replaced by `"[redacted]"` wherever they appear in logged objects, like `["password", "authorization"]`. Case doesn't matter.
+     */
+    redact?: string[] | undefined;
+    /**
+     * Called for every message that passes the level, to send logs somewhere else. It isn't awaited, and an error it throws (or a promise it rejects) is ignored: logging never breaks the program.
+     */
+    onLog?: ((entry: LogEntry) => void | Promise<void>) | undefined;
 };
 /**
  * A logger from `createLogger()`. Every method returns the logger, so calls chain.
@@ -159,12 +187,35 @@ export type Logger = {
      */
     configure: (options: LoggerOptions) => Logger;
 };
+/**
+ * A log file: where it is, how big it may get, how big it is now.
+ */
+export type _LogFile = {
+    target: string;
+    limit: number | undefined;
+    keep: number;
+    size: number;
+    ready: boolean;
+};
+/**
+ * What a message looks like on one output: its colors, and the parts that
+ * are the same on every line, styled once.
+ */
+export type _Face = {
+    palette: import("./Color").ColorModule;
+    colors: boolean;
+    labels: Record<string, string>;
+    scope: string;
+    stamp: string;
+    stampAt: number;
+    stampWidth: number;
+};
 /**
  * Prints a message without a badge. Strings support markup, objects are
  * pretty-printed, and several arguments are joined with spaces.
  *
  * @example
- * nc.log("<% green ✔ Saved %> in <% bold 12ms %>");
+ * nc.log("<% green ✔ Saved%> in <% bold 12ms%>");
  * nc.log("user:", { id: 1, roles: ["admin"] });
  *
  * @param {...unknown} args
@@ -259,7 +310,7 @@ export function groupEnd(): typeof import("./Logger");
  * @example
  * nc.timeStart("import");
  * await importProducts();
- * nc.timeEnd("import"); // "import: 1.24s"
+ * nc.timeEnd("import"); // "import: 1s 240ms"
  *
  * @param {string} [label="default"]
  * @returns {typeof import("./Logger")}

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

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