@socketsecurity/lib 5.28.0 → 6.0.0

package/dist/cover/code.js

@@ -30,16 +30,19 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var code_exports = {};
 __export(code_exports, {
+  calculateMetric: () => calculateMetric,
   getCodeCoverage: () => getCodeCoverage
 });
 module.exports = __toCommonJS(code_exports);
 var import_node_process = __toESM(require("node:process"));
-var import_fs = require("../fs");
-var import_objects = require("../objects");
-var import_spawn = require("../spawn");
-var import_primordials = require("../primordials");
-let _fs;
-let _path;
+var import_read_json = require("../fs/read-json");
+var import_predicates = require("../objects/predicates");
+var import_spawn = require("../spawn/spawn");
+var import_array = require("../primordials/array");
+var import_error = require("../primordials/error");
+var import_object = require("../primordials/object");
+var import_fs = require("../node/fs");
+var import_path = require("../node/path");
 function calculateMetric(data) {
   const percent = data.total === 0 ? "0.00" : (data.covered / data.total * 100).toFixed(2);
   return {
@@ -48,22 +51,8 @@ function calculateMetric(data) {
     total: data.total
   };
 }
-// @__NO_SIDE_EFFECTS__
-function getFs() {
-  if (_fs === void 0) {
-    _fs = require("node:fs");
-  }
-  return _fs;
-}
-// @__NO_SIDE_EFFECTS__
-function getPath() {
-  if (_path === void 0) {
-    _path = require("node:path");
-  }
-  return _path;
-}
 async function getCodeCoverage(options) {
-  const path = /* @__PURE__ */ getPath();
+  const path = (0, import_path.getNodePath)();
   const opts = {
     __proto__: null,
     coveragePath: path.join(import_node_process.default.cwd(), "coverage/coverage-final.json"),
@@ -72,9 +61,9 @@ async function getCodeCoverage(options) {
   };
   const { coveragePath, generateIfMissing } = opts;
   if (!coveragePath) {
-    throw new import_primordials.ErrorCtor("Coverage path is required");
+    throw new import_error.ErrorCtor("Coverage path is required");
   }
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   if (!fs.existsSync(coveragePath)) {
     if (generateIfMissing) {
       await (0, import_spawn.spawn)("vitest", ["run", "--coverage"], {
@@ -82,14 +71,14 @@ async function getCodeCoverage(options) {
         stdio: "inherit"
       });
     } else {
-      throw new import_primordials.ErrorCtor(
+      throw new import_error.ErrorCtor(
         `Coverage file not found at "${coveragePath}". Run tests with coverage first.`
       );
     }
   }
-  const coverageData = await (0, import_fs.readJson)(coveragePath);
-  if (!(0, import_objects.isObjectObject)(coverageData)) {
-    throw new import_primordials.ErrorCtor(`Invalid coverage data format in "${coveragePath}"`);
+  const coverageData = await (0, import_read_json.readJson)(coveragePath);
+  if (!(0, import_predicates.isPlainObject)(coverageData)) {
+    throw new import_error.ErrorCtor(`Invalid coverage data format in "${coveragePath}"`);
   }
   const totals = {
     __proto__: null,
@@ -99,13 +88,13 @@ async function getCodeCoverage(options) {
     statements: { __proto__: null, covered: 0, total: 0 }
   };
   const v8Data = coverageData;
-  for (const fileCoverage of (0, import_primordials.ObjectValues)(v8Data)) {
-    if (!(0, import_objects.isObjectObject)(fileCoverage)) {
+  for (const fileCoverage of (0, import_object.ObjectValues)(v8Data)) {
+    if (!(0, import_predicates.isPlainObject)(fileCoverage)) {
       continue;
     }
     const fc = fileCoverage;
-    if (fc.s && (0, import_objects.isObjectObject)(fc.s)) {
-      const statementCounts = (0, import_primordials.ObjectValues)(fc.s);
+    if (fc.s && (0, import_predicates.isPlainObject)(fc.s)) {
+      const statementCounts = (0, import_object.ObjectValues)(fc.s);
       for (const count of statementCounts) {
         if (typeof count === "number") {
           totals.statements.total += 1;
@@ -115,10 +104,10 @@ async function getCodeCoverage(options) {
         }
       }
     }
-    if (fc.b && (0, import_objects.isObjectObject)(fc.b)) {
-      const branchCounts = (0, import_primordials.ObjectValues)(fc.b);
+    if (fc.b && (0, import_predicates.isPlainObject)(fc.b)) {
+      const branchCounts = (0, import_object.ObjectValues)(fc.b);
       for (const branches of branchCounts) {
-        if ((0, import_primordials.ArrayIsArray)(branches)) {
+        if ((0, import_array.ArrayIsArray)(branches)) {
           for (const count of branches) {
             if (typeof count === "number") {
               totals.branches.total += 1;
@@ -130,8 +119,8 @@ async function getCodeCoverage(options) {
         }
       }
     }
-    if (fc.f && (0, import_objects.isObjectObject)(fc.f)) {
-      const functionCounts = (0, import_primordials.ObjectValues)(fc.f);
+    if (fc.f && (0, import_predicates.isPlainObject)(fc.f)) {
+      const functionCounts = (0, import_object.ObjectValues)(fc.f);
       for (const count of functionCounts) {
         if (typeof count === "number") {
           totals.functions.total += 1;
@@ -153,5 +142,6 @@ async function getCodeCoverage(options) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  calculateMetric,
   getCodeCoverage
 });

package/dist/cover/formatters.d.ts

@@ -1,30 +1,34 @@
 /**
- * @fileoverview Coverage output formatters.
+ * @file Coverage output formatters.
  */
 import type { FormatCoverageOptions } from './types';
+/**
+ * Calculate overall coverage percentage.
+ */
+export declare function calculateOverall(code: FormatCoverageOptions['code'], type: FormatCoverageOptions['type']): string;
 /**
  * Format coverage data for console output.
  *
  * @example
- * ```typescript
- * const output = formatCoverage({
- *   code: {
- *     statements: { percent: '85.00' },
- *     branches: { percent: '80.00' },
- *     functions: { percent: '90.00' },
- *     lines: { percent: '88.00' },
- *   },
- * })
- * ```
+ *   ;```typescript
+ *   const output = formatCoverage({
+ *     code: {
+ *       statements: { percent: '85.00' },
+ *       branches: { percent: '80.00' },
+ *       functions: { percent: '90.00' },
+ *       lines: { percent: '88.00' },
+ *     },
+ *   })
+ *   ```
  */
 export declare function formatCoverage(options: FormatCoverageOptions): string;
 /**
  * Get emoji for coverage percentage.
  *
  * @example
- * ```typescript
- * getCoverageEmoji(95)  // ' \u{1F3AF}'
- * getCoverageEmoji(50)  // ' \u{1F528}'
- * ```
+ *   ;```typescript
+ *   getCoverageEmoji(95) // ' \u{1F3AF}'
+ *   getCoverageEmoji(50) // ' \u{1F528}'
+ *   ```
  */
 export declare function getCoverageEmoji(percent: number): string;

package/dist/cover/formatters.js

@@ -20,12 +20,14 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var formatters_exports = {};
 __export(formatters_exports, {
+  calculateOverall: () => calculateOverall,
   formatCoverage: () => formatCoverage,
   getCoverageEmoji: () => getCoverageEmoji
 });
 module.exports = __toCommonJS(formatters_exports);
-var import_strings = require("../strings");
-var import_primordials = require("../primordials");
+var import_format = require("../strings/format");
+var import_json = require("../primordials/json");
+var import_number = require("../primordials/number");
 const COVERAGE_EMOJI_THRESHOLDS = [
   { emoji: " \u{1F680}", threshold: 99 },
   { emoji: " \u{1F3AF}", threshold: 95 },
@@ -39,17 +41,17 @@ const COVERAGE_EMOJI_THRESHOLDS = [
 ];
 function calculateOverall(code, type) {
   const metrics = [
-    (0, import_primordials.NumberParseFloat)(code.statements.percent),
-    (0, import_primordials.NumberParseFloat)(code.branches.percent),
-    (0, import_primordials.NumberParseFloat)(code.functions.percent),
-    (0, import_primordials.NumberParseFloat)(code.lines.percent)
-  ].map((val) => (0, import_primordials.NumberIsNaN)(val) ? 0 : val);
+    (0, import_number.NumberParseFloat)(code.statements.percent),
+    (0, import_number.NumberParseFloat)(code.branches.percent),
+    (0, import_number.NumberParseFloat)(code.functions.percent),
+    (0, import_number.NumberParseFloat)(code.lines.percent)
+  ].map((val) => (0, import_number.NumberIsNaN)(val) ? 0 : val);
   if (type) {
-    const typePercent = (0, import_primordials.NumberParseFloat)(type.percent);
-    metrics.push((0, import_primordials.NumberIsNaN)(typePercent) ? 0 : typePercent);
+    const typePercent = (0, import_number.NumberParseFloat)(type.percent);
+    metrics.push((0, import_number.NumberIsNaN)(typePercent) ? 0 : typePercent);
   }
   const average = metrics.reduce((sum, val) => sum + val, 0) / metrics.length;
-  return (0, import_primordials.NumberPrototypeToFixed)(average, 2);
+  return (0, import_number.NumberPrototypeToFixed)(average, 2);
 }
 function formatCoverage(options) {
   const opts = {
@@ -59,7 +61,7 @@ function formatCoverage(options) {
   };
   const { code, format, type } = opts;
   if (format === "json") {
-    return (0, import_primordials.JSONStringify)({ code, type }, null, 2);
+    return (0, import_json.JSONStringify)({ code, type }, void 0, 2);
   }
   const overall = calculateOverall(code, type);
   if (format === "simple") {
@@ -67,28 +69,28 @@ function formatCoverage(options) {
   }
   let output = "";
   output += "Code Coverage:\n";
-  output += (0, import_strings.indentString)(`Statements: ${code.statements.percent}%
+  output += (0, import_format.indentString)(`Statements: ${code.statements.percent}%
 `, {
     count: 2
   });
-  output += (0, import_strings.indentString)(`Branches: ${code.branches.percent}%
+  output += (0, import_format.indentString)(`Branches: ${code.branches.percent}%
 `, { count: 2 });
-  output += (0, import_strings.indentString)(`Functions: ${code.functions.percent}%
+  output += (0, import_format.indentString)(`Functions: ${code.functions.percent}%
 `, {
     count: 2
   });
-  output += (0, import_strings.indentString)(`Lines: ${code.lines.percent}%
+  output += (0, import_format.indentString)(`Lines: ${code.lines.percent}%
 `, { count: 2 });
   if (type) {
     output += "\nType Coverage:\n";
-    output += (0, import_strings.indentString)(
+    output += (0, import_format.indentString)(
       `${type.percent}% (${type.covered}/${type.total})
 `,
       { count: 2 }
     );
   }
-  const overallValue = (0, import_primordials.NumberParseFloat)(overall);
-  const emoji = getCoverageEmoji((0, import_primordials.NumberIsNaN)(overallValue) ? 0 : overallValue);
+  const overallValue = (0, import_number.NumberParseFloat)(overall);
+  const emoji = getCoverageEmoji((0, import_number.NumberIsNaN)(overallValue) ? 0 : overallValue);
   output += `
 Overall: ${overall}%${emoji}
 `;
@@ -102,6 +104,7 @@ function getCoverageEmoji(percent) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  calculateOverall,
   formatCoverage,
   getCoverageEmoji
 });

package/dist/cover/type.d.ts

@@ -1,10 +1,11 @@
 /**
- * @fileoverview TypeScript type coverage utilities.
+ * @file TypeScript type coverage utilities.
  */
 import type { GetTypeCoverageOptions, TypeCoverageResult } from './types';
 /**
  * Get TypeScript type coverage metrics.
  *
- * @throws {Error} When type-coverage command fails (if generateIfMissing is false).
+ * @throws {Error} When type-coverage command fails (if generateIfMissing is
+ *   false).
  */
-export declare function getTypeCoverage(options?: GetTypeCoverageOptions | undefined): Promise<TypeCoverageResult | null>;
+export declare function getTypeCoverage(options?: GetTypeCoverageOptions | undefined): Promise<TypeCoverageResult | undefined>;

package/dist/cover/type.js

@@ -34,8 +34,9 @@ __export(type_exports, {
 });
 module.exports = __toCommonJS(type_exports);
 var import_node_process = __toESM(require("node:process"));
-var import_spawn = require("../spawn");
-var import_primordials = require("../primordials");
+var import_spawn = require("../spawn/spawn");
+var import_error = require("../primordials/error");
+var import_number = require("../primordials/number");
 async function getTypeCoverage(options) {
   const opts = {
     __proto__: null,
@@ -45,7 +46,7 @@ async function getTypeCoverage(options) {
   };
   const { cwd, generateIfMissing } = opts;
   if (!cwd) {
-    throw new import_primordials.ErrorCtor("Working directory is required.");
+    throw new import_error.ErrorCtor("Working directory is required.");
   }
   try {
     const result = await (0, import_spawn.spawn)("type-coverage", ["--detail"], {
@@ -55,21 +56,21 @@ async function getTypeCoverage(options) {
     const outputText = result.stdout ? result.stdout.toString() : "";
     const match = /(\d+) \/ (\d+) ([\d.]+)%/.exec(outputText);
     if (!match || !match[1] || !match[2] || !match[3]) {
-      return null;
+      return void 0;
     }
     return {
-      covered: (0, import_primordials.NumberParseInt)(match[1], 10),
+      covered: (0, import_number.NumberParseInt)(match[1], 10),
       percent: match[3],
-      total: (0, import_primordials.NumberParseInt)(match[2], 10)
+      total: (0, import_number.NumberParseInt)(match[2], 10)
     };
   } catch (e) {
     if (generateIfMissing) {
-      throw new import_primordials.ErrorCtor(
+      throw new import_error.ErrorCtor(
         "Unable to generate type coverage. Ensure type-coverage is installed.",
         { cause: e }
       );
     }
-    return null;
+    return void 0;
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/cover/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Type definitions for coverage utilities.
+ * @file Type definitions for coverage utilities.
  */
 /**
  * Code coverage metrics for a single category.

package/dist/crypto/hash.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @file Crypto hash helpers that prefer Node builtins where available. Probes
+ *   `node:crypto.hash()` (added v21.7.0 / v20.12.0) and falls back to the
+ *   streaming `createHash().update().digest()` chain on older runtimes.
+ */
+/**
+ * Compute a one-shot cryptographic hash.
+ *
+ * Prefers Node's `crypto.hash(algorithm, data, outputEncoding)` (added v21.7.0
+ * / v20.12.0), which is ~30% faster than the `createHash().update().digest()`
+ * chain on small-to-medium inputs because it skips constructing the streaming
+ * `Hash` object. Falls back to that chain on older runtimes.
+ *
+ * Use this only for the one-shot case where the entire input is available as a
+ * single buffer or string; if you need to feed chunks, stay on `createHash()`.
+ *
+ * @example
+ *   ;```typescript
+ *   import { hash } from '@socketsecurity/lib/crypto/hash'
+ *
+ *   hash('sha256', 'hello', 'hex')
+ *   // '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
+ *
+ *   hash('sha512', someBuffer, 'base64')
+ *   // 'z4PhNX7vuL3xVChQ1m2AB9Yg5AULVxXcg/SpIdNs6c5H0NE8XYXysP+DGNKHfuwvY7kxvUdBeoGlODJ6+SfaPg=='
+ *   ```
+ */
+export declare function hash(algorithm: string, data: string | NodeJS.ArrayBufferView, outputEncoding: 'hex' | 'base64' | 'base64url' | 'binary'): string;
+/**
+ * Resolve `crypto.hash` (or `undefined` if the runtime predates it).
+ *
+ * Exported for unit tests; not part of the public API.
+ *
+ * @internal
+ */
+export declare function nativeHash(): typeof import('node:crypto').hash | undefined;

package/dist/{crypto.js → crypto/hash.js}

@@ -18,17 +18,25 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var crypto_exports = {};
-__export(crypto_exports, {
-  getNativeHash: () => getNativeHash,
-  hash: () => hash
+var hash_exports = {};
+__export(hash_exports, {
+  hash: () => hash,
+  nativeHash: () => nativeHash
 });
-module.exports = __toCommonJS(crypto_exports);
-var import_crypto = require("./node/crypto");
+module.exports = __toCommonJS(hash_exports);
+var import_crypto = require("../node/crypto");
 let _hash;
 let _hashProbed = false;
 // @__NO_SIDE_EFFECTS__
-function getNativeHash() {
+function hash(algorithm, data, outputEncoding) {
+  const native = /* @__PURE__ */ nativeHash();
+  if (native !== void 0) {
+    return native(algorithm, data, outputEncoding);
+  }
+  return (0, import_crypto.getNodeCrypto)().createHash(algorithm).update(data).digest(outputEncoding);
+}
+// @__NO_SIDE_EFFECTS__
+function nativeHash() {
   if (!_hashProbed) {
     const fn = (0, import_crypto.getNodeCrypto)().hash;
     if (typeof fn === "function") {
@@ -38,16 +46,8 @@ function getNativeHash() {
   }
   return _hash;
 }
-// @__NO_SIDE_EFFECTS__
-function hash(algorithm, data, outputEncoding) {
-  const native = /* @__PURE__ */ getNativeHash();
-  if (native !== void 0) {
-    return native(algorithm, data, outputEncoding);
-  }
-  return (0, import_crypto.getNodeCrypto)().createHash(algorithm).update(data).digest(outputEncoding);
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  getNativeHash,
-  hash
+  hash,
+  nativeHash
 });

package/dist/debug/_internal.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file Private internals for `debug/*` modules — the cached logger instance,
+ *   lazy `node:util` accessor, the `debugByNamespace` cache that
+ *   `namespace.getDebugJsInstance` fills, the lazy `pointingTriangle` glyph
+ *   used by every output function, and `customLog` (the `debug-js` log-writer
+ *   override). Co-located so the namespace / output / caller-info leaves don't
+ *   fragment ownership of this shared module state.
+ */
+export declare const logger: import("../logger/logger").Logger;
+export declare const debugByNamespace: Map<any, any>;
+export { getNodeUtil as getUtil } from '../node/util';
+/**
+ * Custom log function for debug output.
+ *
+ * @private
+ */
+export declare function customLog(...args: unknown[]): void;
+/**
+ * Lazily resolve the "pointing triangle" glyph — `▸` on terminals with unicode
+ * support, `>` everywhere else. Initialised on first call by the output
+ * functions.
+ *
+ * @private
+ */
+export declare function getPointingTriangle(): string;

package/dist/debug/_internal.js

@@ -0,0 +1,77 @@
+"use strict";
+/* Socket Lib - Built with esbuild */
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var internal_exports = {};
+__export(internal_exports, {
+  customLog: () => customLog,
+  debugByNamespace: () => debugByNamespace,
+  getPointingTriangle: () => getPointingTriangle,
+  getUtil: () => import_util2.getNodeUtil,
+  logger: () => logger
+});
+module.exports = __toCommonJS(internal_exports);
+var import_is_unicode_supported = __toESM(require("../external/@socketregistry/is-unicode-supported"));
+var import_debug = __toESM(require("../external/debug"));
+var import_logger = require("../logger/logger");
+var import_map_set = require("../primordials/map-set");
+var import_reflect = require("../primordials/reflect");
+var import_util = require("../node/util");
+var import_util2 = require("../node/util");
+const logger = (0, import_logger.getDefaultLogger)();
+const debugByNamespace = new import_map_set.MapCtor();
+let _pointingTriangle;
+// @__NO_SIDE_EFFECTS__
+function customLog(...args) {
+  const util = (0, import_util.getNodeUtil)();
+  const inspectOpts = import_debug.default.inspectOpts ? {
+    ...import_debug.default.inspectOpts,
+    showHidden: import_debug.default.inspectOpts.showHidden === null ? void 0 : import_debug.default.inspectOpts.showHidden,
+    depth: import_debug.default.inspectOpts.depth === null || typeof import_debug.default.inspectOpts.depth === "boolean" ? void 0 : import_debug.default.inspectOpts.depth
+  } : {};
+  (0, import_reflect.ReflectApply)(logger.info, logger, [
+    util.formatWithOptions(inspectOpts, ...args)
+  ]);
+}
+// @__NO_SIDE_EFFECTS__
+function getPointingTriangle() {
+  if (_pointingTriangle === void 0) {
+    const supported = (0, import_is_unicode_supported.default)();
+    _pointingTriangle = supported ? "\u25B8" : ">";
+  }
+  return _pointingTriangle;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  customLog,
+  debugByNamespace,
+  getPointingTriangle,
+  getUtil,
+  logger
+});

package/dist/debug/caller-info.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file `getCallerInfo` — extract the caller's function name from the V8 stack
+ *   trace at a given offset. Used by every output function to prefix the debug
+ *   line with the calling site. Strips V8-injected prefixes (`async`, `bound`,
+ *   `Object.`, etc.) so the printed name matches what the developer typed.
+ */
+/**
+ * Extract caller information from the stack trace.
+ *
+ * @private
+ */
+export declare function getCallerInfo(stackOffset?: number): string;

package/dist/debug/caller-info.js

@@ -0,0 +1,67 @@
+"use strict";
+/* Socket Lib - Built with esbuild */
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var caller_info_exports = {};
+__export(caller_info_exports, {
+  getCallerInfo: () => getCallerInfo
+});
+module.exports = __toCommonJS(caller_info_exports);
+var import_predicates = require("../objects/predicates");
+var import_string = require("../primordials/string");
+// @__NO_SIDE_EFFECTS__
+function getCallerInfo(stackOffset = 3) {
+  let name = "";
+  const captureStackTrace = Error.captureStackTrace;
+  if (typeof captureStackTrace === "function") {
+    const obj = {};
+    captureStackTrace(obj, getCallerInfo);
+    const stack = obj.stack;
+    if (typeof stack === "string") {
+      let lineCount = 0;
+      let lineStart = 0;
+      for (let i = 0, { length } = stack; i < length; i += 1) {
+        if (stack[i] === "\n") {
+          lineCount += 1;
+          if (lineCount < stackOffset) {
+            lineStart = i + 1;
+          } else {
+            const line = stack.slice(lineStart, i).trimStart();
+            const match = /(?<=^at\s+).*?(?=\s+\(|$)/.exec(line)?.[0];
+            if (match) {
+              name = match.replace(/^(?:async|bound|get|new|set)\s+/, "");
+              if ((0, import_string.StringPrototypeStartsWith)(name, "Object.")) {
+                const afterDot = (0, import_string.StringPrototypeSlice)(name, 7);
+                if (!(0, import_predicates.hasOwn)(Object, afterDot)) {
+                  name = afterDot;
+                }
+              }
+            }
+            break;
+          }
+        }
+      }
+    }
+  }
+  return name;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getCallerInfo
+});

package/dist/debug/namespace.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file Namespace-handling helpers — `extractOptions` normalises the
+ *   polymorphic first argument that every `*Ns` function takes,
+ *   `getDebugJsInstance` per-namespace caches the underlying `debug-js`
+ *   instance with `customLog` patched in, and `isEnabled` / `isDebug` /
+ *   `isDebugNs` are the gate predicates every output function consults before
+ *   writing.
+ */
+import type { DebugOptions, NamespacesOrOptions } from './types';
+/**
+ * Extract options from namespaces parameter.
+ *
+ * @private
+ */
+export declare function extractOptions(namespaces: NamespacesOrOptions): DebugOptions;
+/**
+ * Get or create a debug instance for a namespace.
+ *
+ * @private
+ */
+export declare function getDebugJsInstance(namespace: string): any;
+/**
+ * Check if debug mode is enabled.
+ */
+export declare function isDebug(): boolean;
+/**
+ * Check if debug mode is enabled.
+ */
+export declare function isDebugNs(namespaces: string | undefined): boolean;
+/**
+ * Check if debug is enabled for given namespaces.
+ *
+ * @private
+ */
+export declare function isEnabled(namespaces: string | undefined): boolean;