@ix-xs/node-comfort 2.0.0 → 2.1.0

package/types/src/Time.d.ts

@@ -51,7 +51,7 @@ export type RelativeOptions = {
     /**
      * `"auto"` says `"yesterday"` instead of `"1 day ago"`. Defaults to `"always"`.
      */
-    numeric?: "always" | "auto" | undefined;
+    numeric?: "auto" | "always" | undefined;
     /**
      * `"short"` gives `"in 3 mo."`. Defaults to `"long"`.
      */
@@ -94,7 +94,37 @@ export type WeekOptions = {
     /**
      * First day of the week: `0` for Sunday, `1` for Monday. Defaults to `1`.
      */
-    weekStartsOn?: 0 | 2 | 1 | 3 | 4 | 5 | 6 | undefined;
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | undefined;
+    /**
+     * Zone whose calendar is used. Defaults to the global zone, then the system's.
+     */
+    timeZone?: string | undefined;
+};
+/**
+ * Options for `parse()`.
+ */
+export type ParseDateOptions = {
+    /**
+     * Language of month names in the text. Defaults to the global locale.
+     */
+    locale?: string | undefined;
+    /**
+     * Zone the text is written in, unless it carries its own offset. Defaults to the global zone, then the system's.
+     */
+    timeZone?: string | undefined;
+};
+/**
+ * Options for `range()`.
+ */
+export type DateRangeOptions = {
+    /**
+     * How many units between two dates. Defaults to `1`.
+     */
+    step?: number | undefined;
+    /**
+     * Zone whose calendar is used for days, weeks, months and years.
+     */
+    timeZone?: string | undefined;
 };
 /**
  * Time zone setting.
@@ -142,6 +172,10 @@ export type CronOptions = {
      * Start a run even if the previous one hasn't finished. By default it's skipped.
      */
     overlap?: boolean | undefined;
+    /**
+     * `cron()` only: also run once right away.
+     */
+    immediate?: boolean | undefined;
     /**
      * Called when the task fails.
      */
@@ -197,19 +231,6 @@ export type Stopwatch = {
      */
     reset: () => void;
 };
-/**
- * Parsed cron fields.
- */
-export type CronSpec = {
-    seconds: Set<number>;
-    minutes: Set<number>;
-    hours: Set<number>;
-    days: Set<number>;
-    months: Set<number>;
-    weekdays: Set<number>;
-    anyDay: boolean;
-    anyWeekday: boolean;
-};
 /**
  * Sets the default language for `relative`, `calendar`, `formatDuration`
  * and `format`.
@@ -291,12 +312,13 @@ export function parseDuration(input: string | number): number | null;
  * time.formatDuration(90_000, { long: true, locale: "fr" });    // "1 minute 30 secondes"
  * time.formatDuration(93_784_000, { units: 2 });                // "1d 2h"
  * time.formatDuration(5_405_000, { clock: true });              // "01:30:05"
+ * time.formatDuration("90m");                                   // "1h 30m"
  *
- * @param {number} ms
+ * @param {number | string} duration Milliseconds, or text like `"90m"`.
  * @param {FormatDurationOptions} [options]
  * @returns {string}
  */
-export function formatDuration(ms: number, options?: FormatDurationOptions): string;
+export function formatDuration(duration: number | string, options?: FormatDurationOptions): string;
 /**
  * Describes a date relative to now: `"3 hours ago"`, `"in 2 days"`, in
  * any language.
@@ -339,6 +361,7 @@ export function calendar(date: DateInput, options?: CalendarOptions): string;
  * | `dddd` / `ddd` | Monday / Mon | | `A` / `a` | PM / pm |
  * | `d` | weekday, 0 is Sunday | | `Z` / `ZZ` | +02:00 / +0200 |
  * | `W` / `WW` | ISO week | | `X` / `x` | Unix seconds / ms |
+ * | `Do` | 5th | | `z` | zone name, like EST or GMT+1 |
  *
  * Text in brackets stays as is: `"[Today is] dddd"`.
  *
@@ -353,6 +376,23 @@ export function calendar(date: DateInput, options?: CalendarOptions): string;
  * @returns {string} Or `"Invalid Date"`.
  */
 export function format(date: DateInput, pattern?: string, options?: FormatDateOptions): string;
+/**
+ * Reads a date written in a known format: the opposite of `format()`, with
+ * the same tokens. Parts the pattern doesn't have default to today's date
+ * and to midnight.
+ *
+ * @example
+ * time.parse("15/01/2024 14:30", "DD/MM/YYYY HH:mm");
+ * time.parse("15 janvier 2024", "D MMMM YYYY", { locale: "fr" });
+ * time.parse("2024-01-15 09:00", "YYYY-MM-DD HH:mm", { timeZone: "Asia/Tokyo" });
+ * time.parse("31/02/2024", "DD/MM/YYYY"); // undefined, no such day
+ *
+ * @param {string} text
+ * @param {string} pattern Tokens like `YYYY`, `MM`, `DD`, `HH`, `mm`, `ss`, `A`, `Z`. Text in brackets must match as is.
+ * @param {ParseDateOptions} [options]
+ * @returns {Date | undefined} `undefined` when the text doesn't match or isn't a real date.
+ */
+export function parse(text: string, pattern: string, options?: ParseDateOptions): Date | undefined;
 /**
  * The date as `YYYY-MM-DD`, the format `<input type="date">` and most APIs
  * expect.
@@ -366,20 +406,26 @@ export function format(date: DateInput, pattern?: string, options?: FormatDateOp
  */
 export function toISODate(date?: DateInput, options?: TimeZoneOptions): string;
 /**
- * Adds time to a date and returns a new `Date`. Months and years follow the
- * calendar: January 31 plus one month is the end of February.
+ * Adds time to a date and returns a new `Date`. Whole days, weeks, months
+ * and years follow the calendar: one day later is the same time tomorrow,
+ * even when the clocks change in between, and January 31 plus one month is
+ * the end of February. Hours and smaller units are exact.
  *
  * @example
  * time.add(new Date(), "2h30m");
  * time.add(new Date(), 3, "days");
+ * time.add(new Date(), "1 month");
  * time.add(new Date(2024, 0, 31), 1, "month"); // 2024-02-29
+ * time.add(date, "1 day", { timeZone: "Europe/Paris" });
  *
  * @param {DateInput} date
- * @param {number | string} amount A number with `unit`, or a duration like `"1h30m"`.
- * @param {CalendarUnit} [unit="ms"]
+ * @param {number | string} amount A number with `unit`, or a duration like `"1h30m"` or `"1 month"`.
+ * @param {CalendarUnit | TimeZoneOptions} [unit="ms"] The unit of a number. With a text amount there is none to give: the options can come here.
+ * @param {TimeZoneOptions} [options] The zone whose calendar is followed.
  * @returns {Date}
+ * @throws {TypeError} If a text amount isn't a duration, or the unit isn't one.
  */
-export function add(date: DateInput, amount: number | string, unit?: CalendarUnit): Date;
+export function add(date: DateInput, amount: number | string, unit?: CalendarUnit | TimeZoneOptions, options?: TimeZoneOptions): Date;
 /**
  * Subtracts time from a date and returns a new `Date`.
  *
@@ -389,10 +435,12 @@ export function add(date: DateInput, amount: number | string, unit?: CalendarUni
  *
  * @param {DateInput} date
  * @param {number | string} amount
- * @param {CalendarUnit} [unit="ms"]
+ * @param {CalendarUnit | TimeZoneOptions} [unit="ms"] The unit of a number, or the options when the amount is text.
+ * @param {TimeZoneOptions} [options]
  * @returns {Date}
+ * @throws {TypeError} If a text amount isn't a duration, or the unit isn't one.
  */
-export function subtract(date: DateInput, amount: number | string, unit?: CalendarUnit): Date;
+export function subtract(date: DateInput, amount: number | string, unit?: CalendarUnit | TimeZoneOptions, options?: TimeZoneOptions): Date;
 /**
  * `a - b` in a unit. Fixed units can give fractions; months and years are
  * whole calendar months and years.
@@ -404,16 +452,20 @@ export function subtract(date: DateInput, amount: number | string, unit?: Calend
  * @param {DateInput} a
  * @param {DateInput} b
  * @param {CalendarUnit} [unit="ms"]
+ * @param {TimeZoneOptions} [options] The zone whose calendar months and years follow.
  * @returns {number}
+ * @throws {TypeError} If the unit isn't one.
  */
-export function diff(a: DateInput, b: DateInput, unit?: CalendarUnit): number;
+export function diff(a: DateInput, b: DateInput, unit?: CalendarUnit, options?: TimeZoneOptions): number;
 /**
- * A new `Date` at the start of the day, week, month... in local time.
+ * A new `Date` at the start of the day, week, month... in the global time
+ * zone, or the one you name.
  *
  * @example
- * time.startOf(new Date(), "day");                         // today at 00:00
- * time.startOf(new Date(), "week");                        // Monday at 00:00
- * time.startOf(new Date(), "week", { weekStartsOn: 0 });   // Sunday at 00:00
+ * time.startOf(new Date(), "day");                              // today at 00:00
+ * time.startOf(new Date(), "week");                             // Monday at 00:00
+ * time.startOf(new Date(), "week", { weekStartsOn: 0 });        // Sunday at 00:00
+ * time.startOf(new Date(), "day", { timeZone: "Asia/Tokyo" });  // midnight in Tokyo
  *
  * @param {DateInput} date
  * @param {StartOfUnit} unit
@@ -461,6 +513,20 @@ export function isAfter(a: DateInput, b: DateInput): boolean;
  * @returns {boolean}
  */
 export function isBetween(date: DateInput, start: DateInput, end: DateInput): boolean;
+/**
+ * Are both dates in the same year, month, week, day, hour...?
+ *
+ * @example
+ * time.isSame(a, b, "month");
+ * time.isSame(a, b, "day", { timeZone: "America/New_York" });
+ *
+ * @param {DateInput} a
+ * @param {DateInput} b
+ * @param {StartOfUnit} unit
+ * @param {WeekOptions} [options]
+ * @returns {boolean}
+ */
+export function isSame(a: DateInput, b: DateInput, unit: StartOfUnit, options?: WeekOptions): boolean;
 /**
  * Are both dates on the same calendar day?
  *
@@ -544,9 +610,10 @@ export function daysInMonth(dateOrYear: DateInput | number, month?: number): num
  * Day of the year, from 1 to 366.
  *
  * @param {DateInput} [date] Defaults to now.
+ * @param {TimeZoneOptions} [options]
  * @returns {number}
  */
-export function dayOfYear(date?: DateInput): number;
+export function dayOfYear(date?: DateInput, options?: TimeZoneOptions): number;
 /**
  * ISO week number, from 1 to 53. Weeks start on Monday, and week 1 holds
  * the year's first Thursday.
@@ -555,11 +622,12 @@ export function dayOfYear(date?: DateInput): number;
  * time.weekOfYear(new Date(2021, 0, 3)); // 53, the last week of 2020
  *
  * @param {DateInput} [date] Defaults to now.
- * @param {{ utc?: boolean }} [options] Read the date in UTC.
+ * @param {{ utc?: boolean, timeZone?: string }} [options] `utc` reads the date in UTC, `timeZone` in another zone.
  * @returns {number}
  */
 export function weekOfYear(date?: DateInput, options?: {
     utc?: boolean;
+    timeZone?: string;
 }): number;
 /**
  * The earliest date.
@@ -581,6 +649,33 @@ export function max(dates: Iterable<DateInput>): Date | undefined;
  * @returns {number}
  */
 export function unix(): number;
+/**
+ * A `Date` from a Unix timestamp in seconds, as found in JWTs and many APIs.
+ *
+ * @example
+ * time.fromUnix(1705329000); // 2024-01-15T14:30:00.000Z
+ *
+ * @param {number} seconds
+ * @returns {Date}
+ */
+export function fromUnix(seconds: number): Date;
+/**
+ * Every date from `start` to `end`, both included, one unit apart. Handy
+ * for charts, calendars and reports.
+ *
+ * @example
+ * time.range("2024-01-01", "2024-01-07", "day");           // 7 dates
+ * time.range(start, end, "month");                          // the same day each month
+ * time.range(start, end, "minute", { step: 15 });           // every quarter of an hour
+ *
+ * @param {DateInput} start
+ * @param {DateInput} end
+ * @param {CalendarUnit} [unit="day"]
+ * @param {DateRangeOptions} [options]
+ * @returns {Date[]}
+ * @throws {RangeError} If the step isn't positive, or the range would hold more than a million dates.
+ */
+export function range(start: DateInput, end: DateInput, unit?: CalendarUnit, options?: DateRangeOptions): Date[];
 /**
  * Starts a precise stopwatch.
  *
@@ -630,9 +725,10 @@ export function every(interval: number | string, task: () => unknown, options?:
  *
  * Expressions have 5 fields (`minute hour day month weekday`), or 6 with
  * seconds first. You can use `*`, lists (`1,15`), ranges (`1-5`), steps
- * (`*\/15`), names (`jan`, `mon-fri`) and `@daily`, `@hourly`, `@weekly`,
- * `@monthly`, `@yearly`. As in classic cron, when both the day and the
- * weekday are set, either one matching is enough.
+ * (`*\/15`), names (`jan`, `mon-fri`), `L` for the last day of the month,
+ * and `@daily`, `@hourly`, `@weekly`, `@monthly`, `@yearly`. As in classic
+ * cron, when both the day and the weekday are set, either one matching is
+ * enough.
  *
  * @example
  * time.nextRun("0 9 * * mon-fri");                              // next weekday at 09:00

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

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

package/types/src/Utils.d.ts

@@ -16,13 +16,13 @@ export type WaitOptions = {
  */
 export type WhenOptions = {
     /**
-     * Milliseconds between two checks. Defaults to `50`.
+     * Time between two checks, in ms or like `"1s"`. Defaults to `50`.
      */
-    interval?: number | undefined;
+    interval?: string | number | undefined;
     /**
-     * Give up after this many milliseconds and emit `"timeout"`.
+     * Give up after this long, in ms or like `"10s"`, and emit `"timeout"`.
      */
-    timeout?: number | null | undefined;
+    timeout?: string | number | null | undefined;
     /**
      * Stop after this many triggers.
      */
@@ -71,8 +71,8 @@ export type DontCrashController = {
 /**
  * Options for `when()`.
  * @typedef {object} WhenOptions
- * @property {number} [interval] Milliseconds between two checks. Defaults to `50`.
- * @property {number | null} [timeout] Give up after this many milliseconds and emit `"timeout"`.
+ * @property {number | string} [interval] Time between two checks, in ms or like `"1s"`. Defaults to `50`.
+ * @property {number | string | null} [timeout] Give up after this long, in ms or like `"10s"`, and emit `"timeout"`.
  * @property {number | null} [max] Stop after this many triggers.
  */
 /**
@@ -113,7 +113,7 @@ export function wait(duration: number | string, options?: WaitOptions): Promise<
  * await a condition, `nc.async.poll()` is simpler.
  *
  * @example
- * nc.when(() => queue.length > 0, { reason: "jobs waiting" }, { interval: 500, max: 1, timeout: 10_000 })
+ * nc.when(() => queue.length > 0, { reason: "jobs waiting" }, { interval: 500, max: 1, timeout: "10s" })
  *   .on("trigger", (payload) => nc.info(payload.reason))
  *   .on("timeout", () => nc.warn("Nothing happened in 10s"))
  *   .start();
@@ -145,12 +145,13 @@ export function when(predicate: boolean | PromiseLike<boolean> | (() => unknown)
 export function dontCrash(): DontCrashController;
 /**
  * `JSON.stringify` that never throws. Circular references become
- * `"[Circular]"`, bigints become strings, Maps become objects and Sets become
- * arrays.
+ * `"[Circular]"`, bigints become strings, Maps become objects, Sets become
+ * arrays, and errors keep their name, message and stack.
  *
  * @example
  * nc.JSONString({ a: 1 });                          // '{\n    "a": 1\n}'
  * nc.JSONString({ id: 10n, tags: new Set(["x"]) }, 0); // '{"id":"10","tags":["x"]}'
+ * nc.JSONString({ error: new Error("boom") }, 0);   // '{"error":{"name":"Error","message":"boom","stack":"..."}}'
  *
  * @param {unknown} value
  * @param {number} [spaces=4] Indentation. Use `0` for a single line.
@@ -159,18 +160,21 @@ export function dontCrash(): DontCrashController;
 export function JSONString(value: unknown, spaces?: number): string;
 /**
  * `JSON.parse` with an optional fallback. With a fallback, invalid input
- * returns it instead of throwing.
+ * returns it instead of throwing. A leading byte order mark, which Windows
+ * editors like to add, is ignored.
  *
  * @example
  * nc.JSONParse('{"a":1}');    // { a: 1 }
  * nc.JSONParse("oops", null); // null
  * nc.JSONParse("oops");       // throws SyntaxError
+ * nc.JSONParse(text, {}, (key, value) => (key === "at" ? new Date(value) : value));
  *
  * @template [T=any]
  * @param {string} text
  * @param {T} [fallback] Returned when `text` isn't valid JSON.
+ * @param {(this: any, key: string, value: any) => any} [reviver] Passed to `JSON.parse`.
  * @returns {T}
  * @throws {SyntaxError} If `text` is invalid and there's no fallback.
  */
-export function JSONParse<T = any>(text: string, fallback?: T, ...args: any[]): T;
+export function JSONParse<T = any>(text: string, fallback?: T, reviver?: (this: any, key: string, value: any) => any, ...args: any[]): T;
 //# sourceMappingURL=Utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../src/Utils.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAgCc,MAAM,QAAQ;;;;UACd,MAAM,QAAQ;;;;QACd,CAAC,CAAC,SAAS,SAAS,GAAG,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,KAAK,QAAQ;;;;;6BAKlJ,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY;;;;;;;;QAMtC,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,mBAAmB;;;;aACjM,MAAM,IAAI;;AAhCxB;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;;;;;GAMG;AAEH;;;GAGG;AAEH;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,+BANW,MAAM,GAAG,MAAM,YACf,WAAW,GACT,OAAO,CAAC,IAAI,CAAC,CAqBzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,gCALW,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,YAChD,GAAG,YACH,WAAW,GACT,QAAQ,CAuEpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,6BAFa,mBAAmB,CAoE/B;AAKD;;;;;;;;;;;;GAYG;AACH,kCAJW,OAAO,WACP,MAAM,GACJ,MAAM,CAmBlB;AAED;;;;;;;;;;;;;;GAcG;AACH,0BANc,CAAC,cACJ,MAAM,aACN,CAAC,mBACC,CAAC,CAUb"}
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../src/Utils.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAgCc,MAAM,QAAQ;;;;UACd,MAAM,QAAQ;;;;QACd,CAAC,CAAC,SAAS,SAAS,GAAG,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,KAAK,QAAQ;;;;;6BAKlJ,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY;;;;;;;;QAMtC,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,mBAAmB;;;;aACjM,MAAM,IAAI;;AAhCxB;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;;;;;GAMG;AAEH;;;GAGG;AAEH;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,+BANW,MAAM,GAAG,MAAM,YACf,WAAW,GACT,OAAO,CAAC,IAAI,CAAC,CAazB;AAED;;;;;;;;;;;;;;;GAeG;AACH,gCALW,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,YAChD,GAAG,YACH,WAAW,GACT,QAAQ,CAuEpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,6BAFa,mBAAmB,CAoE/B;AAKD;;;;;;;;;;;;;GAaG;AACH,kCAJW,OAAO,WACP,MAAM,GACJ,MAAM,CA6BlB;AAgBD;;;;;;;;;;;;;;;;;GAiBG;AACH,0BAPc,CAAC,cACJ,MAAM,aACN,CAAC,YACD,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,mBACzC,CAAC,CAWb"}

package/types/src/errors.d.ts

@@ -37,9 +37,13 @@ export type ValidationIssue = {
     received?: string | undefined;
 };
 /**
- * The errors node-comfort throws. They all extend `NodeComfortError` (itself
- * a regular `Error`) and carry a stable `code`, so you can branch on the
- * kind of failure without parsing messages.
+ * The errors node-comfort throws when something goes wrong at run time: a
+ * request fails, data is invalid, a command exits badly. They all extend
+ * `NodeComfortError` (itself a regular `Error`) and carry a stable `code`,
+ * so you can branch on the kind of failure without parsing messages.
+ *
+ * A mistake in your own code, like a wrong argument, still throws a plain
+ * `TypeError` or `RangeError`, as it does everywhere in JavaScript.
  *
  * @example
  * try {
@@ -63,6 +67,15 @@ export type ValidationIssue = {
  * if (error instanceof nc.errors.NodeComfortError) logger.warn(error.code);
  */
 export class NodeComfortError extends Error {
+    /**
+     * Makes `instanceof` work when two copies of the package are installed,
+     * which would otherwise give two unrelated `HttpError` classes.
+     *
+     * @override
+     * @param {unknown} value
+     * @returns {boolean}
+     */
+    static override [Symbol.hasInstance](value: unknown): boolean;
     /**
      * @param {string} message
      * @param {NodeComfortErrorOptions} [options]
@@ -70,6 +83,17 @@ export class NodeComfortError extends Error {
     constructor(message: string, options?: NodeComfortErrorOptions);
     /** Stable, machine-readable code. */
     code: string;
+    /**
+     * What `JSON.stringify()` writes for the error: its name, code, message
+     * and own fields, without the stack. Handy for API responses and logs.
+     *
+     * @example
+     * res.status(400).json({ error });
+     * // {"error":{"name":"ValidationError","code":"ERR_VALIDATION","message":"...","issues":[...]}}
+     *
+     * @returns {Record<string, unknown>}
+     */
+    toJSON(): Record<string, unknown>;
 }
 /**
  * Thrown by `nc.assert()` and `nc.assertType()`.

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

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

package/types/src/internal/shared.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Parsed cron fields. `lastDay` is set by `L` in the day-of-month field.
+ */
+export type CronSpec = {
+    seconds: Set<number>;
+    minutes: Set<number>;
+    hours: Set<number>;
+    days: Set<number>;
+    months: Set<number>;
+    weekdays: Set<number>;
+    anyDay: boolean;
+    anyWeekday: boolean;
+    lastDay: boolean;
+};
+/** Keys that must never be copied onto an object: they reach its prototype. */
+export const UNSAFE_KEYS: Set<string>;
+export namespace MS {
+    let ms: number;
+    let s: number;
+    let m: number;
+    let h: number;
+    let d: number;
+    let w: number;
+}
+/**
+ * The defaults set with `time.setLocale()` and `time.setTimezone()`. English
+ * by default, so output never depends on the machine.
+ * @type {{ locale: string, timeZone: string | undefined }}
+ */
+export const timeConfig: {
+    locale: string;
+    timeZone: string | undefined;
+};
+export const ASCII: RegExp;
+/**
+ * @param {unknown} value
+ * @returns {value is Record<string, any>}
+ */
+export function isPlainObject(value: unknown): value is Record<string, any>;
+/**
+ * @param {string} unit
+ * @returns {keyof typeof MS | "M" | "y" | undefined}
+ */
+export function unitOf(unit: string): keyof typeof MS | "M" | "y" | undefined;
+/**
+ * A duration in milliseconds, or `null` when the input isn't one.
+ * @param {unknown} input
+ * @returns {number | null}
+ */
+export function parseDuration(input: unknown): number | null;
+/**
+ * Milliseconds from a number or a duration string.
+ * @param {number | string} value
+ * @param {string} [what="duration"] Names the value in the error message.
+ * @returns {number}
+ * @throws {TypeError} If it can't be read.
+ */
+export function toMs(value: number | string, what?: string): number;
+/**
+ * `setTimeout` that also works past its 24.8-day limit. `Infinity` never fires.
+ * @param {() => void} fn
+ * @param {number} ms
+ * @param {boolean} [unref=false]
+ * @returns {() => void} Cancels the timer.
+ */
+export function setLongTimeout(fn: () => void, ms: number, unref?: boolean): () => void;
+/**
+ * Resolves after `ms`, or rejects with an `AbortError` when the signal fires.
+ * @param {number} ms
+ * @param {AbortSignal} [signal]
+ * @param {boolean} [unref=false]
+ * @returns {Promise<void>}
+ */
+export function sleep(ms: number, signal?: AbortSignal, unref?: boolean): Promise<void>;
+/**
+ * Blocks the thread for a few milliseconds. Only for short retries of
+ * synchronous file operations.
+ * @param {number} ms
+ */
+export function sleepSync(ms: number): void;
+export namespace intl {
+    let number: (locale?: string, options?: object) => Intl.NumberFormat;
+    let dateTime: (locale?: string, options?: object) => Intl.DateTimeFormat;
+    let plural: (locale?: string, options?: object) => Intl.PluralRules;
+    let collator: (locale?: string, options?: object) => Intl.Collator;
+    let relativeTime: (locale?: string, options?: object) => Intl.RelativeTimeFormat;
+    let list: (locale?: string, options?: object) => Intl.ListFormat;
+}
+/** The grapheme segmenter, built on first use. */
+export function segmenter(): Intl.Segmenter;
+/**
+ * Splits text into graphemes, so emoji and accents stay whole.
+ * @param {string} input
+ * @returns {string[]}
+ */
+export function graphemes(input: string): string[];
+/**
+ * Counts graphemes without building an array.
+ * @param {string} input
+ * @returns {number}
+ */
+export function graphemeCount(input: string): number;
+/**
+ * Adds numbers with Neumaier's compensation, so `0.1 + 0.2 + 0.3` is `0.6`.
+ * @param {Iterable<number>} values
+ * @returns {number}
+ */
+export function preciseSum(values: Iterable<number>): number;
+/**
+ * A cache key for a list of arguments. Primitives are compared by value and
+ * type, plain objects and arrays by content, everything else by identity.
+ * @param {readonly unknown[]} args
+ * @returns {unknown} A primitive usable as a `Map` key.
+ */
+export function argsKey(args: readonly unknown[]): unknown;
+/**
+ * Parses a cron expression with 5 fields, or 6 with seconds first.
+ * @param {string} expression
+ * @returns {CronSpec}
+ * @throws {SyntaxError} If the expression is invalid.
+ */
+export function parseCron(expression: string): CronSpec;
+//# sourceMappingURL=shared.d.ts.map

package/types/src/internal/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/internal/shared.js"],"names":[],"mappings":";;;uBAmTa;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AA7StM,+EAA+E;AAC/E,sCAAuE;;;;;;;;;AAevE;;;;GAIG;AACH,yBAFU;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAED;AA8KzD,2BAA+B;AAhM/B;;;GAGG;AACH,qCAHW,OAAO,GACL,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAOxC;AAuBD;;;GAGG;AACH,6BAHW,MAAM,GACJ,MAAM,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,SAAS,CAE2B;AAyC/E;;;;GAIG;AACH,qCAHW,OAAO,GACL,MAAM,GAAG,IAAI,CAazB;AAED;;;;;;GAMG;AACH,4BALW,MAAM,GAAG,MAAM,SACf,MAAM,GACJ,MAAM,CAWlB;AAID;;;;;;GAMG;AACH,mCALW,MAAM,IAAI,MACV,MAAM,UACN,OAAO,GACL,MAAM,IAAI,CAYtB;AAED;;;;;;GAMG;AACH,0BALW,MAAM,WACN,WAAW,UACX,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CAetB;AAgOJ;;;;GAIG;AACH,8BAFW,MAAM,QAIhB;;0BAhOsB,MAAM,YAAY,MAAM;4BAAxB,MAAM,YAAY,MAAM;0BAAxB,MAAM,YAAY,MAAM;4BAAxB,MAAM,YAAY,MAAM;gCAAxB,MAAM,YAAY,MAAM;wBAAxB,MAAM,YAAY,MAAM;;AA6B/C,kDAAkD;AAClD,4CAAmG;AAInG;;;;GAIG;AACH,iCAHW,MAAM,GACJ,MAAM,EAAE,CAKpB;AAED;;;;GAIG;AACH,qCAHW,MAAM,GACJ,MAAM,CAOlB;AAED;;;;GAIG;AACH,mCAHW,QAAQ,CAAC,MAAM,CAAC,GACd,MAAM,CAYlB;AA+CD;;;;;GAKG;AACH,8BAHW,SAAS,OAAO,EAAE,GAChB,OAAO,CAYnB;AAkBD;;;;;GAKG;AACH,sCAJW,MAAM,GACJ,QAAQ,CA4DpB"}