@ix-xs/node-comfort 2.1.0 → 2.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"Str.d.ts","sourceRoot":"","sources":["../../src/Str.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA4Dc,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+KpB;;;;;;;;GAQG;AACH,kCAHW,OAAO,GACL,MAAM,CAOlB;AAED;;;;;;;;GAQG;AACH,kCAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;GAQG;AACH,kCAHW,OAAO,GACL,MAAM,CAMlB;AAED;;;;;;;;;;GAUG;AACH,gCAHW,OAAO,GACL,MAAM,CAYlB;AAED;;;;;;;;;GASG;AACH,iCAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;GAQG;AACH,oCAHW,OAAO,GACL,MAAM,CAMlB;AAED;;;;;;;;;GASG;AACH,iCAHW,OAAO,GACL,MAAM,CAMlB;AAED;;;;;;;;GAQG;AACH,kCAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;GAQG;AACH,iCAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;GAQG;AACH,iCAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;GAQG;AACH,oCAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;GAQG;AACH,+BAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;;GASG;AACH,6BAHW,OAAO,GACL,MAAM,EAAE,CAIpB;AAED;;;;;;;;;;GAUG;AACH,8BAHW,OAAO,GACL,MAAM,CASlB;AAED;;;;;;;;;;;GAWG;AACH,+BAJW,OAAO,YACP,cAAc,GACZ,MAAM,CAmBlB;AAED;;;;;;;;GAQG;AACH,8BAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;;GASG;AACH,iCAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;;GASG;AACH,kCAHW,OAAO,GACL,MAAM,CAKlB;AAED;;;;;;;;;GASG;AACH,oCAHW,OAAO,GACL,MAAM,CAclB;AAED;;;;;;;;GAQG;AACH,oCAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;;;GAUG;AACH,8BAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;;;;GAWG;AACH,kCAJW,OAAO,aACP,cAAc,GACZ,MAAM,CAIlB;AAED;;;;;;;;;;GAUG;AACH,6BAJW,OAAO,UACP,MAAM,GACJ,MAAM,CAYlB;AAED;;;;;;;;;;;;GAYG;AACH,gCALW,OAAO,UACP,MAAM,YACN,eAAe,GACb,MAAM,CAwBlB;AAED;;;;;;;;;;GAUG;AACH,6BAJW,OAAO,QACP,MAAM,GACJ,MAAM,EAAE,CAepB;AAED;;;;;;;;;;;GAWG;AACH,+BALW,OAAO,SACP,MAAM,OACN,MAAM,GACJ,MAAM,GAAG,SAAS,CAQ9B;AAED;;;;;;;;;;GAUG;AACH,iCAJW,OAAO,aACP,MAAM,GACJ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAMxC;AAED;;;;;;;;GAQG;AACH,6BAHW,OAAO,GACL,MAAM,EAAE,CAIpB;AAED;;;;;;;;;;GAUG;AACH,gCALW,OAAO,UACP,MAAM,SACN,MAAM,GACJ,MAAM,CAKlB;AAED;;;;;;;;;;GAUG;AACH,8BALW,OAAO,UACP,MAAM,SACN,MAAM,GACJ,MAAM,CAKlB;AAED;;;;;;;;;;GAUG;AACH,8BALW,OAAO,UACP,MAAM,SACN,MAAM,GACJ,MAAM,CAQlB;AAED;;;;;;;;;;GAUG;AACH,8BAJW,OAAO,WACP,MAAM,GAAG,MAAM,GACb,MAAM,CAKlB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,8BAJW,OAAO,aACJ,OAAO,EAAA,GACR,MAAM,CAqBlB;AAED;;;;;;;;;;;GAWG;AACH,4BAJW,OAAO,YACP,WAAW,GAAG,MAAM,GAClB,MAAM,CA2ClB;AAED;;;;;;;;GAQG;AACH,+BAHW,OAAO,GACL,MAAM,CAIlB;AAED;;;;;;;;;;;GAWG;AACH,4BAJW,OAAO,YACP,WAAW,GACT,MAAM,CAelB;AAED;;;;;;;;;;GAUG;AACH,gCAJW,OAAO,QACP,MAAM,GACJ,MAAM,CAOlB;AAED;;;;;;;;;;;;;;GAcG;AACH,8BALW,MAAM,SACN,WAAW,YACX,aAAa,GACX,MAAM,CASlB;AAED;;;;;;;;;;;;;;GAcG;AACH,gCALW,OAAO,QACP,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YACnB,eAAe,GACb,MAAM,CA8BlB;AAED;;;;;;;;;GASG;AACH,oCAJW,OAAO,UACP,MAAM,GACJ,MAAM,CAKlB;AAED;;;;;;;;;GASG;AACH,oCAJW,OAAO,UACP,MAAM,GACJ,MAAM,CAKlB;AAED;;;;;;;;;GASG;AACH,oCAJW,OAAO,UACP,MAAM,GACJ,MAAM,CAKlB;AAED;;;;;;;;;GASG;AACH,oCAJW,OAAO,UACP,MAAM,GACJ,MAAM,CAKlB;AAED;;;;;;;;;;;;GAYG;AACH,2BALW,OAAO,KACP,OAAO,YACP,cAAc,GACZ,MAAM,CAQlB;AAED;;;;;;;;;GASG;AACH,+BAJW,OAAO,KACP,OAAO,GACL,MAAM,CAMlB;AAED;;;;;;;;;GASG;AACH,8BAJW,OAAO,KACP,OAAO,GACL,MAAM,CAUlB;AAED;;;;;;;;;;;;GAYG;AACH,+BALW,OAAO,cACP,QAAQ,CAAC,MAAM,CAAC,YAChB,cAAc,GACZ,MAAM,GAAG,SAAS,CAoB9B;AAED;;;;;;;;;;;GAWG;AACH,8BAJW,MAAM,YACN,mBAAmB,GAAG,MAAM,GAC1B,MAAM,CAOlB"}
+{"version":3,"file":"Str.d.ts","sourceRoot":"","sources":["../../src/Str.js"],"names":[],"mappings":"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"}

package/types/src/Sys.d.ts

@@ -11,7 +11,7 @@ export type RunOptions = {
      */
     env?: Record<string, string | undefined> | undefined;
     /**
-     * Set to `false` to pass only `env`, without `process.env`.
+     * Set to `false` to pass only `env`, without `process.env`. Without `env`, the command then gets an empty environment.
      */
     extendEnv?: boolean | undefined;
     /**
@@ -39,7 +39,7 @@ export type RunOptions = {
      */
     onStderr?: ((line: string) => void) | undefined;
     /**
-     * Throw when the exit code isn't 0. Defaults to `true`.
+     * Reject when the exit code isn't 0. Defaults to `true`.
      */
     reject?: boolean | undefined;
     /**
@@ -89,6 +89,28 @@ export type ShutdownOptions = {
  * `sys.shutdown()` was called.
  */
 export type ShutdownReason = NodeJS.Signals | "shutdown";
+/**
+ * Options for `which()`.
+ */
+export type WhichOptions = {
+    /**
+     * Where a relative path like `"./bin/tool"`, or a relative folder in `PATH`, is looked up from. Defaults to `process.cwd()`.
+     */
+    cwd?: string | undefined;
+};
+/**
+ * Options for `open()`.
+ */
+export type OpenOptions = {
+    /**
+     * The URL schemes that may be opened, like `"https:"` or `"vscode:"`. Defaults to `["http:", "https:", "mailto:"]`: `file:`, `search-ms:` and the schemes other apps register can start programs, so they're refused unless you name them. An allowed `file:` URL is checked like a path.
+     */
+    protocols?: string[] | undefined;
+    /**
+     * Allow a Windows network path like `\\server\share\file`. Defaults to `false`: just looking one up can send your Windows credentials to that server.
+     */
+    allowUNC?: boolean | undefined;
+};
 /**
  * Returned by `info()`.
  */
@@ -156,7 +178,7 @@ export type SystemInfo = {
  * @param {string[]} [args=[]]
  * @param {RunOptions} [options]
  * @returns {Promise<RunResult>}
- * @throws {ProcessError} If it can't start, fails (unless `reject: false`) or times out.
+ * @throws {ProcessError} If it can't start, fails (unless `reject: false`) or times out. On Windows, also when a `.cmd` or `.bat` file would get an argument with a line break, or with a quote when the file doesn't pass its arguments on with `%*`: cmd.exe can't be given those safely.
  */
 export function run(file: string, args?: string[], options?: RunOptions): Promise<RunResult>;
 /**
@@ -174,26 +196,37 @@ export function run(file: string, args?: string[], options?: RunOptions): Promis
  */
 export function exec(command: string, options?: RunOptions): Promise<RunResult>;
 /**
- * Finds an executable in `PATH`, like the `which` command.
+ * Finds an executable in `PATH`, like the `which` command. A path, like
+ * `"./bin/tool"`, is looked up from `cwd` instead.
  *
  * @example
  * sys.which("git");  // "/usr/bin/git"
  * sys.which("nope"); // undefined
+ * sys.which("./tool", { cwd: "./app" });
  *
  * @param {string} command
+ * @param {WhichOptions} [options]
  * @returns {string | undefined}
  */
-export function which(command: string): string | undefined;
+export function which(command: string, options?: WhichOptions): string | undefined;
 /**
- * Opens a URL, file or folder with the default app.
+ * Opens a URL, file or folder with the default app. Only `http:`,
+ * `https:` and `mailto:` URLs are opened unless you allow more with
+ * `protocols`; anything else is a path, which must exist. A program is
+ * started, as with a double click: don't pass a path you didn't choose.
  *
  * @example
  * sys.open("http://localhost:3000");
+ * sys.open("./report.html");
+ * sys.open("vscode://file/C:/app/index.js", { protocols: ["vscode:"] });
  *
- * @param {string} target
+ * @param {string} target A URL, or the path of a file or folder.
+ * @param {OpenOptions} [options]
  * @returns {boolean} `true` if the opener started.
+ * @throws {TypeError} If the URL's scheme isn't allowed, the target holds a control character (or a double quote, on Windows), or it's a network path without `allowUNC`.
+ * @throws {Error} If the path doesn't exist.
  */
-export function open(target: string): boolean;
+export function open(target: string, options?: OpenOptions): boolean;
 /**
  * Runs cleanup code when the process is asked to stop (Ctrl+C,
  * `docker stop`, `kill`): close servers, flush logs, disconnect databases.
@@ -207,9 +240,9 @@ export function open(target: string): boolean;
  *
  * @param {(reason: ShutdownReason) => unknown} handler Can be async. Gets the signal that stopped the process.
  * @param {ShutdownOptions} [options]
- * @returns {() => void} Removes the handler.
+ * @returns {(() => void) & Disposable} Removes the handler. With `using`, at the end of the block.
  */
-export function onShutdown(handler: (reason: ShutdownReason) => unknown, options?: ShutdownOptions): () => void;
+export function onShutdown(handler: (reason: ShutdownReason) => unknown, options?: ShutdownOptions): (() => void) & Disposable;
 /**
  * Stops the process the clean way: runs the `onShutdown()` handlers, then
  * exits. Use it instead of `process.exit()` when something goes wrong for

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

@@ -1 +1 @@
-{"version":3,"file":"Sys.d.ts","sourceRoot":"","sources":["../../src/Sys.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAqCqB,MAAM,KAAK,IAAI;;;;uBACf,MAAM,KAAK,IAAI;;;;;;;;;;;;;;;;;aAQtB,MAAM;YACN,MAAM;YACN,MAAM;;;;cACN,MAAM,GAAG,IAAI;YACb,MAAM,GAAG,IAAI;;;;cACb,MAAM;;;;;;;;;;;;;;;;;;;;;;;6BAcP,MAAM,CAAC,OAAO,GAAG,UAAU;;;;;;;;cAM1B,MAAM,CAAC,QAAQ;;;;UACf,MAAM;;;;aACN,MAAM;;;;UACN,MAAM;;;;UACN,MAAM;cACN,MAAM;;;;YACN;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;;YAC7C,MAAM;cACN,MAAM;UACN,MAAM;SACN,MAAM;;;;QACN,OAAO;;;;YACP,OAAO;;;;SACP,OAAO;;AA0KrB;;;;;;;;;;;;;;;GAeG;AACH,0BANW,MAAM,SACN,MAAM,EAAE,YACR,UAAU,GACR,OAAO,CAAC,SAAS,CAAC,CAM9B;AAED;;;;;;;;;;;;GAYG;AACH,8BALW,MAAM,YACN,UAAU,GACR,OAAO,CAAC,SAAS,CAAC,CAK9B;AAgBD;;;;;;;;;GASG;AACH,+BAHW,MAAM,GACJ,MAAM,GAAG,SAAS,CA8B9B;AAED;;;;;;;;GAQG;AACH,6BAHW,MAAM,GACJ,OAAO,CAenB;AAUD;;;;;;;;;;;;;;GAcG;AACH,oCAJW,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,YACnC,eAAe,GACb,MAAM,IAAI,CAsBtB;AAgCD;;;;;;;;;;;;;GAaG;AACH,oCAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAIzB;AA2GD;;;;;;;;;;;GAWG;AACH,qCAJW,MAAM,SACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAqB3B;AAED;;;;;;;;;;GAUG;AACH,iCAHW,CAAC,GAAG,CAAC,GACH,MAAM,GAAG,SAAS,CAW9B;AA9JD;;;GAGG;AACH,6BAFa,OAAO,CAInB;AAED;;;GAGG;AACH,yBAFa,OAAO,CAInB;AAED;;;GAGG;AACH,2BAFa,OAAO,CAInB;AAED;;;;;;;;GAQG;AACH,wBAFa,OAAO,CAUnB;AAKD;;;;GAIG;AACH,4BAFa,OAAO,CAWnB;AAED;;;;GAIG;AACH,yBAFa,OAAO,CAInB;AAED;;;;;;;GAOG;AACH,wBAFa,UAAU,CA0BtB;AAyDD;;;;;;;GAOG;AACH,0BAFa;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAKxG"}
+{"version":3,"file":"Sys.d.ts","sourceRoot":"","sources":["../../src/Sys.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAqCqB,MAAM,KAAK,IAAI;;;;uBACf,MAAM,KAAK,IAAI;;;;;;;;;;;;;;;;;aAQtB,MAAM;YACN,MAAM;YACN,MAAM;;;;cACN,MAAM,GAAG,IAAI;YACb,MAAM,GAAG,IAAI;;;;cACb,MAAM;;;;;;;;;;;;;;;;;;;;;;;6BAcP,MAAM,CAAC,OAAO,GAAG,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmB1B,MAAM,CAAC,QAAQ;;;;UACf,MAAM;;;;aACN,MAAM;;;;UACN,MAAM;;;;UACN,MAAM;cACN,MAAM;;;;YACN;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;;YAC7C,MAAM;cACN,MAAM;UACN,MAAM;SACN,MAAM;;;;QACN,OAAO;;;;YACP,OAAO;;;;SACP,OAAO;;AAkNrB;;;;;;;;;;;;;;;GAeG;AACH,0BANW,MAAM,SACN,MAAM,EAAE,YACR,UAAU,GACR,OAAO,CAAC,SAAS,CAAC,CAM9B;AAED;;;;;;;;;;;;GAYG;AACH,8BALW,MAAM,YACN,UAAU,GACR,OAAO,CAAC,SAAS,CAAC,CAK9B;AAgBD;;;;;;;;;;;;GAYG;AACH,+BAJW,MAAM,YACN,YAAY,GACV,MAAM,GAAG,SAAS,CA+B9B;AAsBD;;;;;;;;;;;;;;;;GAgBG;AACH,6BANW,MAAM,YACN,WAAW,GACT,OAAO,CAiCnB;AAUD;;;;;;;;;;;;;;GAcG;AACH,oCAJW,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,YACnC,eAAe,GACb,CAAC,MAAM,IAAI,CAAC,GAAG,UAAU,CAsBrC;AAgCD;;;;;;;;;;;;;GAaG;AACH,oCAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAIzB;AA2GD;;;;;;;;;;;GAWG;AACH,qCAJW,MAAM,SACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAqB3B;AAED;;;;;;;;;;GAUG;AACH,iCAHW,CAAC,GAAG,CAAC,GACH,MAAM,GAAG,SAAS,CAW9B;AA9JD;;;GAGG;AACH,6BAFa,OAAO,CAInB;AAED;;;GAGG;AACH,yBAFa,OAAO,CAInB;AAED;;;GAGG;AACH,2BAFa,OAAO,CAInB;AAED;;;;;;;;GAQG;AACH,wBAFa,OAAO,CAUnB;AAKD;;;;GAIG;AACH,4BAFa,OAAO,CAWnB;AAED;;;;GAIG;AACH,yBAFa,OAAO,CAInB;AAED;;;;;;;GAOG;AACH,wBAFa,UAAU,CA0BtB;AAyDD;;;;;;;GAOG;AACH,0BAFa;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAKxG"}

package/types/src/Time.d.ts

@@ -1,8 +1,11 @@
 /**
- * A date: a `Date`, a timestamp in ms, or a string `new Date()` understands
- * (ISO 8601 is safest).
+ * A date: a `Date`, a timestamp in ms, a string `new Date()` understands
+ * (ISO 8601 is safest), or an instant from `Temporal`, like a
+ * `Temporal.Instant` or a `Temporal.ZonedDateTime`.
  */
-export type DateInput = Date | number | string;
+export type DateInput = Date | number | string | {
+    readonly epochMilliseconds: number;
+};
 /**
  * A unit with a fixed length.
  */
@@ -182,9 +185,11 @@ export type CronOptions = {
     onError?: ((error: unknown) => void) | undefined;
 };
 /**
- * A schedule returned by `every()` and `cron()`.
+ * A schedule returned by `every()` and `cron()`. With `using`, it stops at
+ * the end of the block.
  */
-export type ScheduledTask = {
+export type ScheduledTask = _ScheduledTaskMethods & Disposable;
+export type _ScheduledTaskMethods = {
     /**
      * Stops the schedule. A run in progress finishes.
      */
@@ -420,7 +425,7 @@ export function toISODate(date?: DateInput, options?: TimeZoneOptions): string;
  *
  * @param {DateInput} date
  * @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 {CalendarUnit | TimeZoneOptions} [unit="ms"] The unit of a number. A text amount carries its own units, so the options can come here instead.
  * @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.
@@ -452,7 +457,7 @@ 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.
+ * @param {TimeZoneOptions} [options] The zone whose calendar is followed for months and years.
  * @returns {number}
  * @throws {TypeError} If the unit isn't one.
  */

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

@@ -30,8 +30,10 @@ export type WhenOptions = {
 };
 /**
  * The task returned by `when()`. Every method returns the task, so calls chain.
+ * With `using`, it stops at the end of the block.
  */
-export type WhenTask = {
+export type WhenTask = _WhenTaskMethods & Disposable;
+export type _WhenTaskMethods = {
     /**
      * Starts checking. A stopped task can't be restarted.
      */
@@ -50,9 +52,10 @@ export type WhenTask = {
  */
 export type DontCrashEvent = "error" | "exit" | "sig" | "beforeExit";
 /**
- * Returned by `dontCrash()`.
+ * Returned by `dontCrash()`. With `using`, what it installed goes at the end of the block.
  */
-export type DontCrashController = {
+export type DontCrashController = _DontCrashMethods & Disposable;
+export type _DontCrashMethods = {
     /**
      * Replaces the handler for an event. Call it without a handler to restore the default one.
      */
@@ -77,7 +80,11 @@ export type DontCrashController = {
  */
 /**
  * The task returned by `when()`. Every method returns the task, so calls chain.
- * @typedef {object} WhenTask
+ * With `using`, it stops at the end of the block.
+ * @typedef {_WhenTaskMethods & Disposable} WhenTask
+ */
+/**
+ * @typedef {object} _WhenTaskMethods
  * @property {() => WhenTask} start Starts checking. A stopped task can't be restarted.
  * @property {() => WhenTask} stop Stops checking and clears the timers.
  * @property {<E extends "trigger" | "error" | "timeout">(event: E, handler: E extends "error" ? (error: unknown) => void : (payload: any) => void) => WhenTask} on Listens to `"trigger"` (the condition is true), `"error"` (it threw) or `"timeout"`.
@@ -87,8 +94,11 @@ export type DontCrashController = {
  * @typedef {"error" | "exit" | "sig" | "beforeExit"} DontCrashEvent
  */
 /**
- * Returned by `dontCrash()`.
- * @typedef {object} DontCrashController
+ * Returned by `dontCrash()`. With `using`, what it installed goes at the end of the block.
+ * @typedef {_DontCrashMethods & Disposable} DontCrashController
+ */
+/**
+ * @typedef {object} _DontCrashMethods
  * @property {<E extends DontCrashEvent>(event: E, handler?: E extends "error" ? (error: unknown) => void : E extends "sig" ? (signal: NodeJS.Signals) => void : (code: number) => void) => DontCrashController} on Replaces the handler for an event. Call it without a handler to restore the default one.
  * @property {() => void} dispose Removes everything `dontCrash()` installed.
  */

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,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"}
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../src/Utils.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAgCa,gBAAgB,GAAG,UAAU;;;;;WAK5B,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;;;;kCAKvC,iBAAiB,GAAG,UAAU;;;;;QAK7B,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;;AAzCxB;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;;;GAIG;AAEH;;;;;GAKG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;;GAIG;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,CA0EpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,6BAFa,mBAAmB,CAuE/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

@@ -193,6 +193,10 @@ export class ValidationError extends NodeComfortError {
  * Thrown by `nc.http` when the response status isn't 2xx (unless you pass
  * `throwHttpErrors: false`), and for network failures (`status` 0).
  *
+ * The values of query parameters that look secret (`api_key`, `token`,
+ * `sig`...) read `***` in the message and in `url`, so the error can go to
+ * logs as it is.
+ *
  * @example
  * try {
  *   await nc.http.get(url);
@@ -202,7 +206,7 @@ export class ValidationError extends NodeComfortError {
  */
 export class HttpError extends NodeComfortError {
     /**
-     * @param {string} message
+     * @param {string} message URLs in it have their secret query values masked.
      * @param {NodeComfortErrorOptions & { status?: number, statusText?: string, url?: string, method?: string, headers?: Record<string, string>, data?: unknown }} [options]
      */
     constructor(message: string, options?: NodeComfortErrorOptions & {
@@ -217,7 +221,7 @@ export class HttpError extends NodeComfortError {
     status: number;
     /** HTTP status text, like `"Not Found"`. */
     statusText: string;
-    /** The requested URL. */
+    /** The requested URL, with `***` for the values of query parameters that look secret. */
     url: string;
     /** The HTTP method, like `"GET"`. */
     method: string;

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

@@ -12,6 +12,13 @@ export type CronSpec = {
     anyWeekday: boolean;
     lastDay: boolean;
 };
+/**
+ * A function that undoes something, usable with `using` too: the undoing then
+ * happens at the end of the block.
+ * @param {() => void} fn
+ * @returns {(() => void) & Disposable}
+ */
+export function disposable(fn: () => void): (() => void) & Disposable;
 /** Keys that must never be copied onto an object: they reach its prototype. */
 export const UNSAFE_KEYS: Set<string>;
 export namespace MS {

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

@@ -1 +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"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/internal/shared.js"],"names":[],"mappings":";;;uBA0Va;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;AA8FtM;;;;;GAKG;AACH,+BAHW,MAAM,IAAI,GACR,CAAC,MAAM,IAAI,CAAC,GAAG,UAAU,CAEwF;AAxb9H,+EAA+E;AAC/E,sCAAuE;;;;;;;;;AAevE;;;;GAIG;AACH,yBAFU;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAED;AA4LzD,2BAA+B;AA9M/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,CAOnD;AAgDD;;;;GAIG;AACH,qCAHW,OAAO,GACL,MAAM,GAAG,IAAI,CAezB;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;AA+PJ;;;;GAIG;AACH,8BAFW,MAAM,QAIhB;;0BA/PsB,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;AAwED;;;;;GAKG;AACH,8BAHW,SAAS,OAAO,EAAE,GAChB,OAAO,CAYnB;AAkBD;;;;;GAKG;AACH,sCAJW,MAAM,GACJ,QAAQ,CAkEpB"}

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

@@ -0,0 +1,13 @@
+/**
+ * Text that can't drive the terminal: every control character and escape
+ * sequence is shown as text (`\x1b`, `\r`), except new lines, tabs, colors
+ * and whole links like `link()` makes. Without colors, colors are removed
+ * too, and a link becomes `text (url)`. Used by the logger and the CLI on
+ * what they print.
+ * @param {string} text
+ * @param {boolean} colors
+ * @returns {string}
+ */
+declare function _safe(text: string, colors: boolean): string;
+export { _safe as safe };
+//# sourceMappingURL=terminal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/internal/terminal.js"],"names":[],"mappings":"AAoCA;;;;;;;;;GASG;AACH,6BAJW,MAAM,UACN,OAAO,GACL,MAAM,CAEsG"}