@socketsecurity/lib 0.0.0 → 1.0.0

package/dist/cover/formatters.js

@@ -0,0 +1,103 @@
+/* Socket Lib - Built with esbuild */
+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 formatters_exports = {};
+__export(formatters_exports, {
+  formatCoverage: () => formatCoverage,
+  getCoverageEmoji: () => getCoverageEmoji
+});
+module.exports = __toCommonJS(formatters_exports);
+var import_strings = require("../strings");
+const COVERAGE_EMOJI_THRESHOLDS = [
+  { emoji: " \u{1F680}", threshold: 99 },
+  { emoji: " \u{1F3AF}", threshold: 95 },
+  { emoji: " \u2728", threshold: 90 },
+  { emoji: " \u{1F49A}", threshold: 85 },
+  { emoji: " \u2705", threshold: 80 },
+  { emoji: " \u{1F7E2}", threshold: 70 },
+  { emoji: " \u{1F7E1}", threshold: 60 },
+  { emoji: " \u{1F528}", threshold: 50 },
+  { emoji: " \u26A0\uFE0F", threshold: 0 }
+];
+function getCoverageEmoji(percent) {
+  const entry = COVERAGE_EMOJI_THRESHOLDS.find(
+    ({ threshold }) => percent >= threshold
+  );
+  return entry?.emoji || "";
+}
+function formatCoverage(options) {
+  const opts = {
+    __proto__: null,
+    format: "default",
+    ...options
+  };
+  const { code, format, type } = opts;
+  if (format === "json") {
+    return JSON.stringify({ code, type }, null, 2);
+  }
+  const overall = calculateOverall(code, type);
+  if (format === "simple") {
+    return overall;
+  }
+  let output = "";
+  output += "Code Coverage:\n";
+  output += (0, import_strings.indentString)(`Statements: ${code.statements.percent}%
+`, {
+    count: 2
+  });
+  output += (0, import_strings.indentString)(`Branches: ${code.branches.percent}%
+`, { count: 2 });
+  output += (0, import_strings.indentString)(`Functions: ${code.functions.percent}%
+`, {
+    count: 2
+  });
+  output += (0, import_strings.indentString)(`Lines: ${code.lines.percent}%
+`, { count: 2 });
+  if (type) {
+    output += "\nType Coverage:\n";
+    output += (0, import_strings.indentString)(
+      `${type.percent}% (${type.covered}/${type.total})
+`,
+      { count: 2 }
+    );
+  }
+  const emoji = getCoverageEmoji(Number.parseFloat(overall));
+  output += `
+Overall: ${overall}%${emoji}
+`;
+  return output;
+}
+function calculateOverall(code, type) {
+  const metrics = [
+    Number.parseFloat(code.statements.percent),
+    Number.parseFloat(code.branches.percent),
+    Number.parseFloat(code.functions.percent),
+    Number.parseFloat(code.lines.percent)
+  ];
+  if (type) {
+    metrics.push(Number.parseFloat(type.percent));
+  }
+  const average = metrics.reduce((sum, val) => sum + val, 0) / metrics.length;
+  return average.toFixed(2);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formatCoverage,
+  getCoverageEmoji
+});
+//# sourceMappingURL=formatters.js.map

package/dist/cover/formatters.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/cover/formatters.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Coverage output formatters.\n */\n\nimport { indentString } from '../strings'\n\nimport type { FormatCoverageOptions } from './types'\n\n/**\n * Coverage emoji thresholds for visual feedback.\n */\nconst COVERAGE_EMOJI_THRESHOLDS = [\n  { emoji: ' \uD83D\uDE80', threshold: 99 },\n  { emoji: ' \uD83C\uDFAF', threshold: 95 },\n  { emoji: ' \u2728', threshold: 90 },\n  { emoji: ' \uD83D\uDC9A', threshold: 85 },\n  { emoji: ' \u2705', threshold: 80 },\n  { emoji: ' \uD83D\uDFE2', threshold: 70 },\n  { emoji: ' \uD83D\uDFE1', threshold: 60 },\n  { emoji: ' \uD83D\uDD28', threshold: 50 },\n  { emoji: ' \u26A0\uFE0F', threshold: 0 },\n]\n\n/**\n * Get emoji for coverage percentage.\n */\nexport function getCoverageEmoji(percent: number): string {\n  const entry = COVERAGE_EMOJI_THRESHOLDS.find(\n    ({ threshold }) => percent >= threshold,\n  )\n  return entry?.emoji || ''\n}\n\n/**\n * Format coverage data for console output.\n */\nexport function formatCoverage(options: FormatCoverageOptions): string {\n  const opts = {\n    __proto__: null,\n    format: 'default' as const,\n    ...options,\n  } as Required<FormatCoverageOptions>\n\n  const { code, format, type } = opts\n\n  if (format === 'json') {\n    return JSON.stringify({ code, type }, null, 2)\n  }\n\n  const overall = calculateOverall(code, type)\n\n  if (format === 'simple') {\n    return overall\n  }\n\n  // Default format with emoji and details.\n  let output = ''\n\n  // Code coverage section.\n  output += 'Code Coverage:\\n'\n  output += indentString(`Statements: ${code.statements.percent}%\\n`, {\n    count: 2,\n  })\n  output += indentString(`Branches: ${code.branches.percent}%\\n`, { count: 2 })\n  output += indentString(`Functions: ${code.functions.percent}%\\n`, {\n    count: 2,\n  })\n  output += indentString(`Lines: ${code.lines.percent}%\\n`, { count: 2 })\n\n  // Type coverage section.\n  if (type) {\n    output += '\\nType Coverage:\\n'\n    output += indentString(\n      `${type.percent}% (${type.covered}/${type.total})\\n`,\n      { count: 2 },\n    )\n  }\n\n  // Overall.\n  const emoji = getCoverageEmoji(Number.parseFloat(overall))\n  output += `\\nOverall: ${overall}%${emoji}\\n`\n\n  return output\n}\n\n/**\n * Calculate overall coverage percentage.\n */\nfunction calculateOverall(\n  code: FormatCoverageOptions['code'],\n  type: FormatCoverageOptions['type'],\n): string {\n  const metrics = [\n    Number.parseFloat(code.statements.percent),\n    Number.parseFloat(code.branches.percent),\n    Number.parseFloat(code.functions.percent),\n    Number.parseFloat(code.lines.percent),\n  ]\n\n  if (type) {\n    metrics.push(Number.parseFloat(type.percent))\n  }\n\n  const average = metrics.reduce((sum, val) => sum + val, 0) / metrics.length\n  return average.toFixed(2)\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,qBAA6B;AAO7B,MAAM,4BAA4B;AAAA,EAChC,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,WAAM,WAAW,GAAG;AAAA,EAC7B,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,WAAM,WAAW,GAAG;AAAA,EAC7B,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,cAAO,WAAW,GAAG;AAAA,EAC9B,EAAE,OAAO,iBAAO,WAAW,EAAE;AAC/B;AAKO,SAAS,iBAAiB,SAAyB;AACxD,QAAM,QAAQ,0BAA0B;AAAA,IACtC,CAAC,EAAE,UAAU,MAAM,WAAW;AAAA,EAChC;AACA,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,eAAe,SAAwC;AACrE,QAAM,OAAO;AAAA,IACX,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,GAAG;AAAA,EACL;AAEA,QAAM,EAAE,MAAM,QAAQ,KAAK,IAAI;AAE/B,MAAI,WAAW,QAAQ;AACrB,WAAO,KAAK,UAAU,EAAE,MAAM,KAAK,GAAG,MAAM,CAAC;AAAA,EAC/C;AAEA,QAAM,UAAU,iBAAiB,MAAM,IAAI;AAE3C,MAAI,WAAW,UAAU;AACvB,WAAO;AAAA,EACT;AAGA,MAAI,SAAS;AAGb,YAAU;AACV,gBAAU,6BAAa,eAAe,KAAK,WAAW,OAAO;AAAA,GAAO;AAAA,IAClE,OAAO;AAAA,EACT,CAAC;AACD,gBAAU,6BAAa,aAAa,KAAK,SAAS,OAAO;AAAA,GAAO,EAAE,OAAO,EAAE,CAAC;AAC5E,gBAAU,6BAAa,cAAc,KAAK,UAAU,OAAO;AAAA,GAAO;AAAA,IAChE,OAAO;AAAA,EACT,CAAC;AACD,gBAAU,6BAAa,UAAU,KAAK,MAAM,OAAO;AAAA,GAAO,EAAE,OAAO,EAAE,CAAC;AAGtE,MAAI,MAAM;AACR,cAAU;AACV,kBAAU;AAAA,MACR,GAAG,KAAK,OAAO,MAAM,KAAK,OAAO,IAAI,KAAK,KAAK;AAAA;AAAA,MAC/C,EAAE,OAAO,EAAE;AAAA,IACb;AAAA,EACF;AAGA,QAAM,QAAQ,iBAAiB,OAAO,WAAW,OAAO,CAAC;AACzD,YAAU;AAAA,WAAc,OAAO,IAAI,KAAK;AAAA;AAExC,SAAO;AACT;AAKA,SAAS,iBACP,MACA,MACQ;AACR,QAAM,UAAU;AAAA,IACd,OAAO,WAAW,KAAK,WAAW,OAAO;AAAA,IACzC,OAAO,WAAW,KAAK,SAAS,OAAO;AAAA,IACvC,OAAO,WAAW,KAAK,UAAU,OAAO;AAAA,IACxC,OAAO,WAAW,KAAK,MAAM,OAAO;AAAA,EACtC;AAEA,MAAI,MAAM;AACR,YAAQ,KAAK,OAAO,WAAW,KAAK,OAAO,CAAC;AAAA,EAC9C;AAEA,QAAM,UAAU,QAAQ,OAAO,CAAC,KAAK,QAAQ,MAAM,KAAK,CAAC,IAAI,QAAQ;AACrE,SAAO,QAAQ,QAAQ,CAAC;AAC1B;",
+  "names": []
+}

package/dist/cover/type.d.ts

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

package/dist/cover/type.js

@@ -0,0 +1,65 @@
+/* Socket Lib - Built with esbuild */
+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 type_exports = {};
+__export(type_exports, {
+  getTypeCoverage: () => getTypeCoverage
+});
+module.exports = __toCommonJS(type_exports);
+var import_spawn = require("../spawn");
+async function getTypeCoverage(options) {
+  const opts = {
+    __proto__: null,
+    cwd: process.cwd(),
+    generateIfMissing: false,
+    ...options
+  };
+  const { cwd, generateIfMissing } = opts;
+  if (!cwd) {
+    throw new Error("Working directory is required.");
+  }
+  try {
+    const result = await (0, import_spawn.spawn)("type-coverage", ["--detail"], {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    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 {
+      covered: Number.parseInt(match[1], 10),
+      percent: match[3],
+      total: Number.parseInt(match[2], 10)
+    };
+  } catch (e) {
+    if (generateIfMissing) {
+      throw new Error(
+        "Unable to generate type coverage. Ensure type-coverage is installed.",
+        { cause: e }
+      );
+    }
+    return null;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getTypeCoverage
+});
+//# sourceMappingURL=type.js.map

package/dist/cover/type.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/cover/type.ts"],
+  "sourcesContent": ["/**\n * @fileoverview TypeScript type coverage utilities.\n */\n\nimport { spawn } from '../spawn'\n\nimport type { GetTypeCoverageOptions, TypeCoverageResult } from './types'\n\n/**\n * Get TypeScript type coverage metrics.\n *\n * @throws {Error} When type-coverage command fails (if generateIfMissing is false).\n */\nexport async function getTypeCoverage(\n  options?: GetTypeCoverageOptions | undefined,\n): Promise<TypeCoverageResult | null> {\n  const opts = {\n    __proto__: null,\n    cwd: process.cwd(),\n    generateIfMissing: false,\n    ...options,\n  } as GetTypeCoverageOptions\n\n  const { cwd, generateIfMissing } = opts\n\n  if (!cwd) {\n    throw new Error('Working directory is required.')\n  }\n\n  try {\n    // Run type-coverage to get metrics.\n    const result = await spawn('type-coverage', ['--detail'], {\n      cwd,\n      stdio: ['ignore', 'pipe', 'pipe'],\n    })\n\n    // Parse output: \"1234 / 5678 48.92%\"\n    const outputText = result.stdout ? result.stdout.toString() : ''\n    const match = /(\\d+) \\/ (\\d+) ([\\d.]+)%/.exec(outputText)\n\n    if (!match || !match[1] || !match[2] || !match[3]) {\n      return null\n    }\n\n    return {\n      covered: Number.parseInt(match[1], 10),\n      percent: match[3],\n      total: Number.parseInt(match[2], 10),\n    }\n  } catch (e) {\n    if (generateIfMissing) {\n      throw new Error(\n        'Unable to generate type coverage. Ensure type-coverage is installed.',\n        { cause: e },\n      )\n    }\n    // If not generating, return null when type-coverage isn't available.\n    return null\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,mBAAsB;AAStB,eAAsB,gBACpB,SACoC;AACpC,QAAM,OAAO;AAAA,IACX,WAAW;AAAA,IACX,KAAK,QAAQ,IAAI;AAAA,IACjB,mBAAmB;AAAA,IACnB,GAAG;AAAA,EACL;AAEA,QAAM,EAAE,KAAK,kBAAkB,IAAI;AAEnC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,gCAAgC;AAAA,EAClD;AAEA,MAAI;AAEF,UAAM,SAAS,UAAM,oBAAM,iBAAiB,CAAC,UAAU,GAAG;AAAA,MACxD;AAAA,MACA,OAAO,CAAC,UAAU,QAAQ,MAAM;AAAA,IAClC,CAAC;AAGD,UAAM,aAAa,OAAO,SAAS,OAAO,OAAO,SAAS,IAAI;AAC9D,UAAM,QAAQ,2BAA2B,KAAK,UAAU;AAExD,QAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;AACjD,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL,SAAS,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE;AAAA,MACrC,SAAS,MAAM,CAAC;AAAA,MAChB,OAAO,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE;AAAA,IACrC;AAAA,EACF,SAAS,GAAG;AACV,QAAI,mBAAmB;AACrB,YAAM,IAAI;AAAA,QACR;AAAA,QACA,EAAE,OAAO,EAAE;AAAA,MACb;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/dist/cover/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Type definitions for coverage utilities.
+ */
+/**
+ * Code coverage metrics for a single category.
+ */
+export type CoverageMetric = {
+    covered: number;
+    percent: string;
+    total: number;
+};
+/**
+ * Complete code coverage results from v8.
+ */
+export type CodeCoverageResult = {
+    branches: CoverageMetric;
+    functions: CoverageMetric;
+    lines: CoverageMetric;
+    statements: CoverageMetric;
+};
+/**
+ * TypeScript type coverage results.
+ */
+export type TypeCoverageResult = {
+    covered: number;
+    percent: string;
+    total: number;
+};
+/**
+ * Options for getting code coverage.
+ */
+export type GetCodeCoverageOptions = {
+    coveragePath?: string | undefined;
+    generateIfMissing?: boolean | undefined;
+};
+/**
+ * Options for getting type coverage.
+ */
+export type GetTypeCoverageOptions = {
+    cwd?: string | undefined;
+    generateIfMissing?: boolean | undefined;
+};
+/**
+ * Output format for coverage display.
+ */
+export type CoverageFormat = 'default' | 'json' | 'simple';
+/**
+ * Options for formatting coverage output.
+ */
+export type FormatCoverageOptions = {
+    code: CodeCoverageResult;
+    format?: CoverageFormat | undefined;
+    type?: TypeCoverageResult | undefined;
+};
+/**
+ * V8 coverage data structure for a single file.
+ */
+export type V8FileCoverage = {
+    b?: Record<string, number[]> | undefined;
+    branchMap?: Record<string, unknown> | undefined;
+    f?: Record<string, number> | undefined;
+    fnMap?: Record<string, unknown> | undefined;
+    path: string;
+    s?: Record<string, number> | undefined;
+    statementMap?: Record<string, unknown> | undefined;
+};
+/**
+ * V8 coverage-final.json structure.
+ */
+export type V8CoverageData = Record<string, V8FileCoverage>;

package/dist/cover/types.js

@@ -0,0 +1,17 @@
+/* Socket Lib - Built with esbuild */
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/dist/cover/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/cover/types.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Type definitions for coverage utilities.\n */\n\n/**\n * Code coverage metrics for a single category.\n */\nexport type CoverageMetric = {\n  covered: number\n  percent: string\n  total: number\n}\n\n/**\n * Complete code coverage results from v8.\n */\nexport type CodeCoverageResult = {\n  branches: CoverageMetric\n  functions: CoverageMetric\n  lines: CoverageMetric\n  statements: CoverageMetric\n}\n\n/**\n * TypeScript type coverage results.\n */\nexport type TypeCoverageResult = {\n  covered: number\n  percent: string\n  total: number\n}\n\n/**\n * Options for getting code coverage.\n */\nexport type GetCodeCoverageOptions = {\n  coveragePath?: string | undefined\n  generateIfMissing?: boolean | undefined\n}\n\n/**\n * Options for getting type coverage.\n */\nexport type GetTypeCoverageOptions = {\n  cwd?: string | undefined\n  generateIfMissing?: boolean | undefined\n}\n\n/**\n * Output format for coverage display.\n */\nexport type CoverageFormat = 'default' | 'json' | 'simple'\n\n/**\n * Options for formatting coverage output.\n */\nexport type FormatCoverageOptions = {\n  code: CodeCoverageResult\n  format?: CoverageFormat | undefined\n  type?: TypeCoverageResult | undefined\n}\n\n/**\n * V8 coverage data structure for a single file.\n */\nexport type V8FileCoverage = {\n  b?: Record<string, number[]> | undefined\n  branchMap?: Record<string, unknown> | undefined\n  f?: Record<string, number> | undefined\n  fnMap?: Record<string, unknown> | undefined\n  path: string\n  s?: Record<string, number> | undefined\n  statementMap?: Record<string, unknown> | undefined\n}\n\n/**\n * V8 coverage-final.json structure.\n */\nexport type V8CoverageData = Record<string, V8FileCoverage>\n"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/debug.d.ts

@@ -0,0 +1,99 @@
+// Type definitions
+interface DebugOptions {
+    namespaces?: string;
+    spinner?: {
+        isSpinning: boolean;
+        stop(): void;
+        start(): void;
+    };
+    [key: string]: unknown;
+}
+type NamespacesOrOptions = string | DebugOptions;
+interface InspectOptions {
+    depth?: number | null;
+    colors?: boolean;
+    [key: string]: unknown;
+}
+export type { DebugOptions, NamespacesOrOptions, InspectOptions };
+/**
+ * Debug output for object inspection with caller info.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function debugDirNs(namespacesOrOpts: NamespacesOrOptions, obj: unknown, inspectOpts?: InspectOptions | undefined): void;
+/**
+ * Debug output with caller info.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function debugNs(namespacesOrOpts: NamespacesOrOptions, ...args: unknown[]): void;
+/**
+ * Debug logging function with caller info.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function debugLogNs(namespacesOrOpts: NamespacesOrOptions, ...args: unknown[]): void;
+/**
+ * Debug output for cache operations with caller info.
+ * First argument is the operation type (hit/miss/set/clear).
+ * Second argument is the cache key or message.
+ * Optional third argument is metadata object.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function debugCacheNs(namespacesOrOpts: NamespacesOrOptions, operation: string, key: string, meta?: unknown | undefined): void;
+/**
+ * Cache debug function with caller info.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function debugCache(operation: string, key: string, meta?: unknown | undefined): void;
+/**
+ * Check if debug mode is enabled.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function isDebugNs(namespaces: string | undefined): boolean;
+/**
+ * Debug output with caller info (wrapper for debugNs with default namespace).
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function debug(...args: unknown[]): void;
+/**
+ * Debug output for object inspection (wrapper for debugDirNs with default namespace).
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function debugDir(obj: unknown, inspectOpts?: InspectOptions | undefined): void;
+/**
+ * Debug logging function (wrapper for debugLogNs with default namespace).
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function debugLog(...args: unknown[]): void;
+/**
+ * Check if debug mode is enabled.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function isDebug(): boolean;
+/**
+ * Create a Node.js util.debuglog compatible function.
+ * Returns a function that conditionally writes debug messages to stderr.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function debuglog(section: string): import("util").DebugLogger;
+/**
+ * Create timing functions for measuring code execution time.
+ * Returns an object with start() and end() methods, plus a callable function.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+declare function debugtime(label: string): {
+    (): void;
+    start: () => void;
+    end: () => void;
+};
+// Export main debug functions with caller info.
+export { debug };
+// debugCache is already exported directly above
+export { debugCacheNs };
+export { debugDir };
+export { debugDirNs };
+export { debugLog };
+export { debuglog };
+export { debugLogNs };
+export { debugNs };
+export { debugtime };
+export { isDebug };
+export { isDebugNs };