@socketsecurity/lib 0.0.0 → 1.0.0

package/dist/suppress-warnings.js

@@ -0,0 +1,100 @@
+/* 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 suppress_warnings_exports = {};
+__export(suppress_warnings_exports, {
+  restoreWarnings: () => restoreWarnings,
+  setMaxEventTargetListeners: () => setMaxEventTargetListeners,
+  suppressMaxListenersWarning: () => suppressMaxListenersWarning,
+  suppressWarningType: () => suppressWarningType,
+  withSuppressedWarnings: () => withSuppressedWarnings
+});
+module.exports = __toCommonJS(suppress_warnings_exports);
+const { apply: ReflectApply } = Reflect;
+let originalEmitWarning;
+const suppressedWarnings = /* @__PURE__ */ new Set();
+function setupSuppression() {
+  if (!originalEmitWarning) {
+    originalEmitWarning = process.emitWarning;
+    process.emitWarning = (warning, ...args) => {
+      if (typeof warning === "string") {
+        for (const suppressedType of suppressedWarnings) {
+          if (warning.includes(suppressedType)) {
+            return;
+          }
+        }
+      } else if (warning && typeof warning === "object") {
+        const warningObj = warning;
+        if (warningObj.name && suppressedWarnings.has(warningObj.name)) {
+          return;
+        }
+      }
+      return ReflectApply(
+        originalEmitWarning,
+        process,
+        [warning, ...args]
+      );
+    };
+  }
+}
+function suppressMaxListenersWarning() {
+  suppressedWarnings.add("MaxListenersExceededWarning");
+  setupSuppression();
+}
+function suppressWarningType(warningType) {
+  suppressedWarnings.add(warningType);
+  setupSuppression();
+}
+function setMaxEventTargetListeners(target, maxListeners = 10) {
+  if (!target) {
+    return;
+  }
+  const symbols = Object.getOwnPropertySymbols(target);
+  const kMaxEventTargetListeners = symbols.find(
+    (s) => s.description === "events.maxEventTargetListeners"
+  );
+  if (kMaxEventTargetListeners) {
+    ;
+    target[kMaxEventTargetListeners] = maxListeners;
+  }
+}
+function restoreWarnings() {
+  if (originalEmitWarning) {
+    process.emitWarning = originalEmitWarning;
+    originalEmitWarning = void 0;
+    suppressedWarnings.clear();
+  }
+}
+async function withSuppressedWarnings(warningType, callback) {
+  const original = process.emitWarning;
+  suppressWarningType(warningType);
+  try {
+    return await callback();
+  } finally {
+    process.emitWarning = original;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  restoreWarnings,
+  setMaxEventTargetListeners,
+  suppressMaxListenersWarning,
+  suppressWarningType,
+  withSuppressedWarnings
+});
+//# sourceMappingURL=suppress-warnings.js.map

package/dist/suppress-warnings.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/suppress-warnings.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Utilities to suppress specific process warnings.\n */\n\nconst { apply: ReflectApply } = Reflect\n\n// Store the original emitWarning function to avoid repeat wrapping.\nlet originalEmitWarning: typeof process.emitWarning | undefined\n\n// Track which warning types are currently suppressed.\nconst suppressedWarnings = new Set<string>()\n\n/**\n * Internal function to set up warning suppression.\n * Only wraps process.emitWarning once, regardless of how many times it's called.\n */\nfunction setupSuppression(): void {\n  // Only wrap once - store the original on first call.\n  if (!originalEmitWarning) {\n    originalEmitWarning = process.emitWarning\n    // biome-ignore lint/suspicious/noExplicitAny: Process emitWarning accepts variable args.\n    process.emitWarning = (warning: string | Error, ...args: any[]) => {\n      // Check both string warnings and warning objects.\n      if (typeof warning === 'string') {\n        // Check if any suppressed warning type matches.\n        for (const suppressedType of suppressedWarnings) {\n          if (warning.includes(suppressedType)) {\n            return\n          }\n        }\n      } else if (warning && typeof warning === 'object') {\n        const warningObj = warning as { name?: string }\n        if (warningObj.name && suppressedWarnings.has(warningObj.name)) {\n          return\n        }\n      }\n      // Not suppressed - call the original function.\n      return ReflectApply(\n        originalEmitWarning as typeof process.emitWarning,\n        process,\n        [warning, ...args],\n      )\n    }\n  }\n}\n\n/**\n * Suppress MaxListenersExceededWarning messages.\n * This is useful in tests or scripts where multiple listeners are expected.\n *\n * @example\n * import { suppressMaxListenersWarning } from '@socketsecurity/registry/lib/suppress-warnings'\n *\n * suppressMaxListenersWarning()\n */\nexport function suppressMaxListenersWarning(): void {\n  suppressedWarnings.add('MaxListenersExceededWarning')\n  setupSuppression()\n}\n\n/**\n * Suppress all process warnings of a specific type.\n *\n * @param warningType - The warning type to suppress (e.g., 'DeprecationWarning', 'ExperimentalWarning')\n *\n * @example\n * import { suppressWarningType } from '@socketsecurity/registry/lib/suppress-warnings'\n *\n * suppressWarningType('ExperimentalWarning')\n */\nexport function suppressWarningType(warningType: string): void {\n  suppressedWarnings.add(warningType)\n  setupSuppression()\n}\n\n/**\n * Set max listeners on an EventTarget (like AbortSignal) to avoid TypeError.\n *\n * By manually setting `kMaxEventTargetListeners` on the target we avoid:\n *   TypeError [ERR_INVALID_ARG_TYPE]: The \"emitter\" argument must be an\n *   instance of EventEmitter or EventTarget. Received an instance of\n *   AbortSignal\n *\n * in some patch releases of Node 18-23 when calling events.getMaxListeners().\n * See https://github.com/nodejs/node/pull/56807.\n *\n * Instead of calling events.setMaxListeners(n, target) we set the symbol\n * property directly to avoid depending on 'node:events' module.\n *\n * @param target - The EventTarget or AbortSignal to configure\n * @param maxListeners - Maximum number of listeners (defaults to 10, the Node.js default)\n *\n * @example\n * import { setMaxEventTargetListeners } from '@socketsecurity/registry/lib/suppress-warnings'\n *\n * const controller = new AbortController()\n * setMaxEventTargetListeners(controller.signal)\n */\nexport function setMaxEventTargetListeners(\n  target: EventTarget | AbortSignal | undefined,\n  maxListeners: number = 10,\n): void {\n  if (!target) {\n    return\n  }\n  const symbols = Object.getOwnPropertySymbols(target)\n  const kMaxEventTargetListeners = symbols.find(\n    s => s.description === 'events.maxEventTargetListeners',\n  )\n  if (kMaxEventTargetListeners) {\n    // The default events.defaultMaxListeners value is 10.\n    // https://nodejs.org/api/events.html#eventsdefaultmaxlisteners\n    // biome-ignore lint/suspicious/noExplicitAny: Setting Node.js internal symbol property.\n    ;(target as any)[kMaxEventTargetListeners] = maxListeners\n  }\n}\n\n/**\n * Restore the original process.emitWarning function.\n * Call this to re-enable all warnings after suppressing them.\n */\nexport function restoreWarnings(): void {\n  if (originalEmitWarning) {\n    process.emitWarning = originalEmitWarning\n    originalEmitWarning = undefined\n    suppressedWarnings.clear()\n  }\n}\n\n/**\n * Suppress warnings temporarily within a callback.\n *\n * @param warningType - The warning type to suppress\n * @param callback - Function to execute with warnings suppressed\n * @returns The result of the callback\n *\n * @example\n * import { withSuppressedWarnings } from '@socketsecurity/registry/lib/suppress-warnings'\n *\n * const result = await withSuppressedWarnings('ExperimentalWarning', async () => {\n *   // Code that triggers experimental warnings\n *   return someValue\n * })\n */\nexport async function withSuppressedWarnings<T>(\n  warningType: string,\n  callback: () => T | Promise<T>,\n): Promise<T> {\n  const original = process.emitWarning\n  suppressWarningType(warningType)\n  try {\n    return await callback()\n  } finally {\n    process.emitWarning = original\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,MAAM,EAAE,OAAO,aAAa,IAAI;AAGhC,IAAI;AAGJ,MAAM,qBAAqB,oBAAI,IAAY;AAM3C,SAAS,mBAAyB;AAEhC,MAAI,CAAC,qBAAqB;AACxB,0BAAsB,QAAQ;AAE9B,YAAQ,cAAc,CAAC,YAA4B,SAAgB;AAEjE,UAAI,OAAO,YAAY,UAAU;AAE/B,mBAAW,kBAAkB,oBAAoB;AAC/C,cAAI,QAAQ,SAAS,cAAc,GAAG;AACpC;AAAA,UACF;AAAA,QACF;AAAA,MACF,WAAW,WAAW,OAAO,YAAY,UAAU;AACjD,cAAM,aAAa;AACnB,YAAI,WAAW,QAAQ,mBAAmB,IAAI,WAAW,IAAI,GAAG;AAC9D;AAAA,QACF;AAAA,MACF;AAEA,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,CAAC,SAAS,GAAG,IAAI;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACF;AAWO,SAAS,8BAAoC;AAClD,qBAAmB,IAAI,6BAA6B;AACpD,mBAAiB;AACnB;AAYO,SAAS,oBAAoB,aAA2B;AAC7D,qBAAmB,IAAI,WAAW;AAClC,mBAAiB;AACnB;AAyBO,SAAS,2BACd,QACA,eAAuB,IACjB;AACN,MAAI,CAAC,QAAQ;AACX;AAAA,EACF;AACA,QAAM,UAAU,OAAO,sBAAsB,MAAM;AACnD,QAAM,2BAA2B,QAAQ;AAAA,IACvC,OAAK,EAAE,gBAAgB;AAAA,EACzB;AACA,MAAI,0BAA0B;AAI5B;AAAC,IAAC,OAAe,wBAAwB,IAAI;AAAA,EAC/C;AACF;AAMO,SAAS,kBAAwB;AACtC,MAAI,qBAAqB;AACvB,YAAQ,cAAc;AACtB,0BAAsB;AACtB,uBAAmB,MAAM;AAAA,EAC3B;AACF;AAiBA,eAAsB,uBACpB,aACA,UACY;AACZ,QAAM,WAAW,QAAQ;AACzB,sBAAoB,WAAW;AAC/B,MAAI;AACF,WAAO,MAAM,SAAS;AAAA,EACxB,UAAE;AACA,YAAQ,cAAc;AAAA,EACxB;AACF;",
+  "names": []
+}

package/dist/tables.d.ts

@@ -0,0 +1,69 @@
+export type ColumnAlignment = 'left' | 'right' | 'center';
+/**
+ * Table column configuration.
+ */
+export type TableColumn = {
+    key: string;
+    header: string;
+    align?: ColumnAlignment | undefined;
+    width?: number | undefined;
+    color?: ((value: string) => string) | undefined;
+};
+/**
+ * Format data as an ASCII table with borders.
+ *
+ * @param data - Array of data objects
+ * @param columns - Column configuration
+ * @returns Formatted table string
+ *
+ * @example
+ * import { formatTable } from '@socketsecurity/registry/lib/tables'
+ * import colors from 'yoctocolors-cjs'
+ *
+ * const data = [
+ *   { name: 'lodash', version: '4.17.21', issues: 0 },
+ *   { name: 'react', version: '18.2.0', issues: 2 },
+ * ]
+ * const columns = [
+ *   { key: 'name', header: 'Package' },
+ *   { key: 'version', header: 'Version', align: 'center' },
+ *   { key: 'issues', header: 'Issues', align: 'right', color: (v) => v === '0' ? colors.green(v) : colors.red(v) },
+ * ]
+ * console.log(formatTable(data, columns))
+ * // Output:
+ * // ┌─────────┬─────────┬────────┐
+ * // │ Package │ Version │ Issues │
+ * // ├─────────┼─────────┼────────┤
+ * // │ lodash  │ 4.17.21 │      0 │
+ * // │ react   │ 18.2.0  │      2 │
+ * // └─────────┴─────────┴────────┘
+ */
+export declare function formatTable(data: Array<Record<string, unknown>>, columns: TableColumn[]): string;
+/**
+ * Format data as a simple table without borders.
+ * Lighter weight alternative to formatTable().
+ *
+ * @param data - Array of data objects
+ * @param columns - Column configuration
+ * @returns Formatted table string
+ *
+ * @example
+ * import { formatSimpleTable } from '@socketsecurity/registry/lib/tables'
+ * import colors from 'yoctocolors-cjs'
+ *
+ * const data = [
+ *   { name: 'lodash', version: '4.17.21' },
+ *   { name: 'react', version: '18.2.0' },
+ * ]
+ * const columns = [
+ *   { key: 'name', header: 'Package' },
+ *   { key: 'version', header: 'Version' },
+ * ]
+ * console.log(formatSimpleTable(data, columns))
+ * // Output:
+ * // Package  Version
+ * // ───────  ───────
+ * // lodash   4.17.21
+ * // react    18.2.0
+ */
+export declare function formatSimpleTable(data: Array<Record<string, unknown>>, columns: TableColumn[]): string;

package/dist/tables.js

@@ -0,0 +1,130 @@
+/* Socket Lib - Built with esbuild */
+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 tables_exports = {};
+__export(tables_exports, {
+  formatSimpleTable: () => formatSimpleTable,
+  formatTable: () => formatTable
+});
+module.exports = __toCommonJS(tables_exports);
+var import_yoctocolors_cjs = __toESM(require("./external/yoctocolors-cjs"));
+var import_strings = require("./strings");
+function displayWidth(text) {
+  return (0, import_strings.stripAnsi)(text).length;
+}
+function padText(text, width, align = "left") {
+  const stripped = (0, import_strings.stripAnsi)(text);
+  const textWidth = stripped.length;
+  const padding = Math.max(0, width - textWidth);
+  switch (align) {
+    case "right":
+      return " ".repeat(padding) + text;
+    case "center": {
+      const leftPad = Math.floor(padding / 2);
+      const rightPad = padding - leftPad;
+      return " ".repeat(leftPad) + text + " ".repeat(rightPad);
+    }
+    default:
+      return text + " ".repeat(padding);
+  }
+}
+function formatTable(data, columns) {
+  if (data.length === 0) {
+    return "(no data)";
+  }
+  const widths = columns.map((col) => {
+    const headerWidth = displayWidth(col.header);
+    const maxDataWidth = Math.max(
+      ...data.map((row) => displayWidth(String(row[col.key] ?? "")))
+    );
+    return col.width ?? Math.max(headerWidth, maxDataWidth);
+  });
+  const lines = [];
+  const topBorder = `\u250C\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u252C\u2500")}\u2500\u2510`;
+  lines.push(import_yoctocolors_cjs.default.dim(topBorder));
+  const headerCells = columns.map((col, i) => {
+    const text = import_yoctocolors_cjs.default.bold(col.header);
+    return padText(text, widths[i], col.align);
+  });
+  lines.push(
+    import_yoctocolors_cjs.default.dim("\u2502 ") + headerCells.join(import_yoctocolors_cjs.default.dim(" \u2502 ")) + import_yoctocolors_cjs.default.dim(" \u2502")
+  );
+  const headerSep = `\u251C\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u253C\u2500")}\u2500\u2524`;
+  lines.push(import_yoctocolors_cjs.default.dim(headerSep));
+  for (const row of data) {
+    const cells = columns.map((col, i) => {
+      let value = String(row[col.key] ?? "");
+      if (col.color) {
+        value = col.color(value);
+      }
+      return padText(value, widths[i], col.align);
+    });
+    lines.push(
+      import_yoctocolors_cjs.default.dim("\u2502 ") + cells.join(import_yoctocolors_cjs.default.dim(" \u2502 ")) + import_yoctocolors_cjs.default.dim(" \u2502")
+    );
+  }
+  const bottomBorder = `\u2514\u2500${widths.map((w) => "\u2500".repeat(w)).join("\u2500\u2534\u2500")}\u2500\u2518`;
+  lines.push(import_yoctocolors_cjs.default.dim(bottomBorder));
+  return lines.join("\n");
+}
+function formatSimpleTable(data, columns) {
+  if (data.length === 0) {
+    return "(no data)";
+  }
+  const widths = columns.map((col) => {
+    const headerWidth = displayWidth(col.header);
+    const maxDataWidth = Math.max(
+      ...data.map((row) => displayWidth(String(row[col.key] ?? "")))
+    );
+    return col.width ?? Math.max(headerWidth, maxDataWidth);
+  });
+  const lines = [];
+  const headerCells = columns.map(
+    (col, i) => padText(import_yoctocolors_cjs.default.bold(col.header), widths[i], col.align)
+  );
+  lines.push(headerCells.join("  "));
+  const separators = widths.map((w) => import_yoctocolors_cjs.default.dim("\u2500".repeat(w)));
+  lines.push(separators.join("  "));
+  for (const row of data) {
+    const cells = columns.map((col, i) => {
+      let value = String(row[col.key] ?? "");
+      if (col.color) {
+        value = col.color(value);
+      }
+      return padText(value, widths[i], col.align);
+    });
+    lines.push(cells.join("  "));
+  }
+  return lines.join("\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formatSimpleTable,
+  formatTable
+});
+//# sourceMappingURL=tables.js.map

package/dist/tables.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/tables.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Table formatting utilities for CLI applications.\n * Provides ASCII table rendering with borders, alignment, and colors.\n */\n\nimport colors from './external/yoctocolors-cjs'\nimport { stripAnsi } from './strings'\n\nexport type ColumnAlignment = 'left' | 'right' | 'center'\n\n/**\n * Table column configuration.\n */\nexport type TableColumn = {\n  key: string\n  header: string\n  align?: ColumnAlignment | undefined\n  width?: number | undefined\n  color?: ((value: string) => string) | undefined\n}\n\n/**\n * Calculate display width accounting for ANSI codes.\n */\nfunction displayWidth(text: string): number {\n  return stripAnsi(text).length\n}\n\n/**\n * Pad text to specified width with alignment.\n */\nfunction padText(\n  text: string,\n  width: number,\n  align: ColumnAlignment = 'left',\n): string {\n  const stripped = stripAnsi(text)\n  const textWidth = stripped.length\n  const padding = Math.max(0, width - textWidth)\n\n  switch (align) {\n    case 'right':\n      return ' '.repeat(padding) + text\n    case 'center': {\n      const leftPad = Math.floor(padding / 2)\n      const rightPad = padding - leftPad\n      return ' '.repeat(leftPad) + text + ' '.repeat(rightPad)\n    }\n    default:\n      return text + ' '.repeat(padding)\n  }\n}\n\n/**\n * Format data as an ASCII table with borders.\n *\n * @param data - Array of data objects\n * @param columns - Column configuration\n * @returns Formatted table string\n *\n * @example\n * import { formatTable } from '@socketsecurity/registry/lib/tables'\n * import colors from 'yoctocolors-cjs'\n *\n * const data = [\n *   { name: 'lodash', version: '4.17.21', issues: 0 },\n *   { name: 'react', version: '18.2.0', issues: 2 },\n * ]\n * const columns = [\n *   { key: 'name', header: 'Package' },\n *   { key: 'version', header: 'Version', align: 'center' },\n *   { key: 'issues', header: 'Issues', align: 'right', color: (v) => v === '0' ? colors.green(v) : colors.red(v) },\n * ]\n * console.log(formatTable(data, columns))\n * // Output:\n * // \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n * // \u2502 Package \u2502 Version \u2502 Issues \u2502\n * // \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n * // \u2502 lodash  \u2502 4.17.21 \u2502      0 \u2502\n * // \u2502 react   \u2502 18.2.0  \u2502      2 \u2502\n * // \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n */\nexport function formatTable(\n  data: Array<Record<string, unknown>>,\n  columns: TableColumn[],\n): string {\n  if (data.length === 0) {\n    return '(no data)'\n  }\n\n  // Calculate column widths\n  const widths = columns.map(col => {\n    const headerWidth = displayWidth(col.header)\n    const maxDataWidth = Math.max(\n      ...data.map(row => displayWidth(String(row[col.key] ?? ''))),\n    )\n    return col.width ?? Math.max(headerWidth, maxDataWidth)\n  })\n\n  const lines: string[] = []\n\n  // Top border\n  const topBorder = `\u250C\u2500${widths.map(w => '\u2500'.repeat(w)).join('\u2500\u252C\u2500')}\u2500\u2510`\n  lines.push(colors.dim(topBorder))\n\n  // Header row\n  const headerCells = columns.map((col, i) => {\n    const text = colors.bold(col.header)\n    return padText(text, widths[i] as number, col.align)\n  })\n  lines.push(\n    colors.dim('\u2502 ') + headerCells.join(colors.dim(' \u2502 ')) + colors.dim(' \u2502'),\n  )\n\n  // Header separator\n  const headerSep = `\u251C\u2500${widths.map(w => '\u2500'.repeat(w)).join('\u2500\u253C\u2500')}\u2500\u2524`\n  lines.push(colors.dim(headerSep))\n\n  // Data rows\n  for (const row of data) {\n    const cells = columns.map((col, i) => {\n      let value = String(row[col.key] ?? '')\n      if (col.color) {\n        value = col.color(value)\n      }\n      return padText(value, widths[i] as number, col.align)\n    })\n    lines.push(\n      colors.dim('\u2502 ') + cells.join(colors.dim(' \u2502 ')) + colors.dim(' \u2502'),\n    )\n  }\n\n  // Bottom border\n  const bottomBorder = `\u2514\u2500${widths.map(w => '\u2500'.repeat(w)).join('\u2500\u2534\u2500')}\u2500\u2518`\n  lines.push(colors.dim(bottomBorder))\n\n  return lines.join('\\n')\n}\n\n/**\n * Format data as a simple table without borders.\n * Lighter weight alternative to formatTable().\n *\n * @param data - Array of data objects\n * @param columns - Column configuration\n * @returns Formatted table string\n *\n * @example\n * import { formatSimpleTable } from '@socketsecurity/registry/lib/tables'\n * import colors from 'yoctocolors-cjs'\n *\n * const data = [\n *   { name: 'lodash', version: '4.17.21' },\n *   { name: 'react', version: '18.2.0' },\n * ]\n * const columns = [\n *   { key: 'name', header: 'Package' },\n *   { key: 'version', header: 'Version' },\n * ]\n * console.log(formatSimpleTable(data, columns))\n * // Output:\n * // Package  Version\n * // \u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\n * // lodash   4.17.21\n * // react    18.2.0\n */\nexport function formatSimpleTable(\n  data: Array<Record<string, unknown>>,\n  columns: TableColumn[],\n): string {\n  if (data.length === 0) {\n    return '(no data)'\n  }\n\n  // Calculate column widths\n  const widths = columns.map(col => {\n    const headerWidth = displayWidth(col.header)\n    const maxDataWidth = Math.max(\n      ...data.map(row => displayWidth(String(row[col.key] ?? ''))),\n    )\n    return col.width ?? Math.max(headerWidth, maxDataWidth)\n  })\n\n  const lines: string[] = []\n\n  // Header row\n  const headerCells = columns.map((col, i) =>\n    padText(colors.bold(col.header), widths[i] as number, col.align),\n  )\n  lines.push(headerCells.join('  '))\n\n  // Header separator\n  const separators = widths.map(w => colors.dim('\u2500'.repeat(w)))\n  lines.push(separators.join('  '))\n\n  // Data rows\n  for (const row of data) {\n    const cells = columns.map((col, i) => {\n      let value = String(row[col.key] ?? '')\n      if (col.color) {\n        value = col.color(value)\n      }\n      return padText(value, widths[i] as number, col.align)\n    })\n    lines.push(cells.join('  '))\n  }\n\n  return lines.join('\\n')\n}\n"],
+  "mappings": "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",
+  "names": ["colors"]
+}

package/dist/temporary-executor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Detects if the current process is running in a temporary package execution context
+ * such as npm exec, npx, pnpm dlx, or yarn dlx.
+ *
+ * When package managers run commands via exec/npx/dlx, they execute in temporary directories
+ * that are cleaned up after execution. Creating persistent shadows or modifying PATH
+ * in these contexts can break subsequent package manager commands.
+ */
+export declare function isRunningInTemporaryExecutor(cwd?: string): boolean;

package/dist/temporary-executor.js

@@ -0,0 +1,54 @@
+/* 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 temporary_executor_exports = {};
+__export(temporary_executor_exports, {
+  isRunningInTemporaryExecutor: () => isRunningInTemporaryExecutor
+});
+module.exports = __toCommonJS(temporary_executor_exports);
+var import_path = require("./path");
+function isRunningInTemporaryExecutor(cwd = process.cwd()) {
+  const userAgent = process.env["npm_config_user_agent"];
+  if (userAgent?.includes("exec") || userAgent?.includes("npx") || userAgent?.includes("dlx")) {
+    return true;
+  }
+  const normalizedCwd = (0, import_path.normalizePath)(cwd);
+  const npmCache = process.env["npm_config_cache"];
+  if (npmCache && normalizedCwd.includes((0, import_path.normalizePath)(npmCache))) {
+    return true;
+  }
+  const tempPatterns = [
+    // npm's npx cache directory
+    "_npx",
+    // pnpm dlx temporary store
+    ".pnpm-store",
+    // Common dlx directory prefix
+    "dlx-",
+    // Yarn Berry PnP virtual packages.
+    ".yarn/$$"
+  ];
+  if (process.platform === "win32") {
+    tempPatterns.push("AppData/Local/Temp/xfs-");
+  }
+  return tempPatterns.some((pattern) => normalizedCwd.includes(pattern));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isRunningInTemporaryExecutor
+});
+//# sourceMappingURL=temporary-executor.js.map

package/dist/temporary-executor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/temporary-executor.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Temporary package executor detection utilities for Socket ecosystem.\n * Identifies and handles temporary execution contexts such as npx, pnpm dlx, and yarn dlx.\n */\n\nimport { normalizePath } from './path'\n\n/**\n * Detects if the current process is running in a temporary package execution context\n * such as npm exec, npx, pnpm dlx, or yarn dlx.\n *\n * When package managers run commands via exec/npx/dlx, they execute in temporary directories\n * that are cleaned up after execution. Creating persistent shadows or modifying PATH\n * in these contexts can break subsequent package manager commands.\n */\nexport function isRunningInTemporaryExecutor(cwd = process.cwd()): boolean {\n  // Check environment variable for exec/npx/dlx indicators.\n  const userAgent = process.env['npm_config_user_agent']\n  if (\n    userAgent?.includes('exec') ||\n    userAgent?.includes('npx') ||\n    userAgent?.includes('dlx')\n  ) {\n    return true\n  }\n\n  // Normalize the cwd path for consistent checking across platforms.\n  const normalizedCwd = normalizePath(cwd)\n\n  // Check if running from npm's npx cache.\n  const npmCache = process.env['npm_config_cache']\n  if (npmCache && normalizedCwd.includes(normalizePath(npmCache))) {\n    return true\n  }\n\n  // Check common temporary execution path patterns.\n  const tempPatterns = [\n    // npm's npx cache directory\n    '_npx',\n    // pnpm dlx temporary store\n    '.pnpm-store',\n    // Common dlx directory prefix\n    'dlx-',\n    // Yarn Berry PnP virtual packages.\n    '.yarn/$$',\n  ]\n\n  // Yarn on Windows uses AppData/Local/Temp/xfs- pattern.\n  if (process.platform === 'win32') {\n    tempPatterns.push('AppData/Local/Temp/xfs-')\n  }\n\n  return tempPatterns.some(pattern => normalizedCwd.includes(pattern))\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,kBAA8B;AAUvB,SAAS,6BAA6B,MAAM,QAAQ,IAAI,GAAY;AAEzE,QAAM,YAAY,QAAQ,IAAI,uBAAuB;AACrD,MACE,WAAW,SAAS,MAAM,KAC1B,WAAW,SAAS,KAAK,KACzB,WAAW,SAAS,KAAK,GACzB;AACA,WAAO;AAAA,EACT;AAGA,QAAM,oBAAgB,2BAAc,GAAG;AAGvC,QAAM,WAAW,QAAQ,IAAI,kBAAkB;AAC/C,MAAI,YAAY,cAAc,aAAS,2BAAc,QAAQ,CAAC,GAAG;AAC/D,WAAO;AAAA,EACT;AAGA,QAAM,eAAe;AAAA;AAAA,IAEnB;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA;AAAA,IAEA;AAAA,EACF;AAGA,MAAI,QAAQ,aAAa,SAAS;AAChC,iBAAa,KAAK,yBAAyB;AAAA,EAC7C;AAEA,SAAO,aAAa,KAAK,aAAW,cAAc,SAAS,OAAO,CAAC;AACrE;",
+  "names": []
+}

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Type definitions for Socket Registry.
+ */
+// Type definitions
+declare enum Categories {
+    CLEANUP = "cleanup",
+    LEVELUP = "levelup",
+    SPEEDUP = "speedup",
+    TUNEUP = "tuneup"
+}
+export type CategoryString = `${Categories}`;
+declare enum Interop {
+    BROWSERIFY = "browserify",
+    CJS = "cjs",
+    ESM = "esm"
+}
+export type InteropString = `${Interop}`;
+// Based on SocketPURL_Type from socket-sdk-js
+export declare enum PURL_Type {
+    APK = "apk",
+    BITBUCKET = "bitbucket",
+    COCOAPODS = "cocoapods",
+    CARGO = "cargo",
+    CHROME = "chrome",
+    COMPOSER = "composer",
+    CONAN = "conan",
+    CONDA = "conda",
+    CRAN = "cran",
+    DEB = "deb",
+    DOCKER = "docker",
+    GEM = "gem",
+    GENERIC = "generic",
+    GITHUB = "github",
+    GOLANG = "golang",
+    HACKAGE = "hackage",
+    HEX = "hex",
+    HUGGINGFACE = "huggingface",
+    MAVEN = "maven",
+    MLFLOW = "mlflow",
+    NPM = "npm",
+    NUGET = "nuget",
+    OCI = "oci",
+    PUB = "pub",
+    PYPI = "pypi",
+    QPKG = "qpkg",
+    RPM = "rpm",
+    SWID = "swid",
+    SWIFT = "swift",
+    VCS = "vcs"
+}
+export type PURLString = `${PURL_Type}`;
+// Alias for backward compatibility and semantic clarity
+export type EcosystemString = PURLString;
+// Manifest types for Socket Registry
+export type ManifestEntryData = {
+    categories?: CategoryString[] | undefined;
+    interop?: InteropString | undefined;
+    license?: string | undefined;
+    name: string;
+    version: string;
+    [key: string]: unknown;
+};
+export type ManifestEntry = [packageName: string, data: ManifestEntryData];
+export type Manifest = Record<EcosystemString, ManifestEntry[]>;
+export {};

package/dist/types.js

@@ -0,0 +1,74 @@
+/* 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 types_exports = {};
+__export(types_exports, {
+  PURL_Type: () => PURL_Type
+});
+module.exports = __toCommonJS(types_exports);
+var Categories = /* @__PURE__ */ ((Categories2) => {
+  Categories2["CLEANUP"] = "cleanup";
+  Categories2["LEVELUP"] = "levelup";
+  Categories2["SPEEDUP"] = "speedup";
+  Categories2["TUNEUP"] = "tuneup";
+  return Categories2;
+})(Categories || {});
+var Interop = /* @__PURE__ */ ((Interop2) => {
+  Interop2["BROWSERIFY"] = "browserify";
+  Interop2["CJS"] = "cjs";
+  Interop2["ESM"] = "esm";
+  return Interop2;
+})(Interop || {});
+var PURL_Type = /* @__PURE__ */ ((PURL_Type2) => {
+  PURL_Type2["APK"] = "apk";
+  PURL_Type2["BITBUCKET"] = "bitbucket";
+  PURL_Type2["COCOAPODS"] = "cocoapods";
+  PURL_Type2["CARGO"] = "cargo";
+  PURL_Type2["CHROME"] = "chrome";
+  PURL_Type2["COMPOSER"] = "composer";
+  PURL_Type2["CONAN"] = "conan";
+  PURL_Type2["CONDA"] = "conda";
+  PURL_Type2["CRAN"] = "cran";
+  PURL_Type2["DEB"] = "deb";
+  PURL_Type2["DOCKER"] = "docker";
+  PURL_Type2["GEM"] = "gem";
+  PURL_Type2["GENERIC"] = "generic";
+  PURL_Type2["GITHUB"] = "github";
+  PURL_Type2["GOLANG"] = "golang";
+  PURL_Type2["HACKAGE"] = "hackage";
+  PURL_Type2["HEX"] = "hex";
+  PURL_Type2["HUGGINGFACE"] = "huggingface";
+  PURL_Type2["MAVEN"] = "maven";
+  PURL_Type2["MLFLOW"] = "mlflow";
+  PURL_Type2["NPM"] = "npm";
+  PURL_Type2["NUGET"] = "nuget";
+  PURL_Type2["OCI"] = "oci";
+  PURL_Type2["PUB"] = "pub";
+  PURL_Type2["PYPI"] = "pypi";
+  PURL_Type2["QPKG"] = "qpkg";
+  PURL_Type2["RPM"] = "rpm";
+  PURL_Type2["SWID"] = "swid";
+  PURL_Type2["SWIFT"] = "swift";
+  PURL_Type2["VCS"] = "vcs";
+  return PURL_Type2;
+})(PURL_Type || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PURL_Type
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/types.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Type definitions for Socket Registry.\n */\n\n// Type definitions\nenum Categories {\n  CLEANUP = 'cleanup',\n  LEVELUP = 'levelup',\n  SPEEDUP = 'speedup',\n  TUNEUP = 'tuneup',\n}\n\nexport type CategoryString = `${Categories}`\n\nenum Interop {\n  BROWSERIFY = 'browserify',\n  CJS = 'cjs',\n  ESM = 'esm',\n}\n\nexport type InteropString = `${Interop}`\n\n// Based on SocketPURL_Type from socket-sdk-js\nexport enum PURL_Type {\n  APK = 'apk',\n  BITBUCKET = 'bitbucket',\n  COCOAPODS = 'cocoapods',\n  CARGO = 'cargo',\n  CHROME = 'chrome',\n  COMPOSER = 'composer',\n  CONAN = 'conan',\n  CONDA = 'conda',\n  CRAN = 'cran',\n  DEB = 'deb',\n  DOCKER = 'docker',\n  GEM = 'gem',\n  GENERIC = 'generic',\n  GITHUB = 'github',\n  GOLANG = 'golang',\n  HACKAGE = 'hackage',\n  HEX = 'hex',\n  HUGGINGFACE = 'huggingface',\n  MAVEN = 'maven',\n  MLFLOW = 'mlflow',\n  NPM = 'npm',\n  NUGET = 'nuget',\n  OCI = 'oci',\n  PUB = 'pub',\n  PYPI = 'pypi',\n  QPKG = 'qpkg',\n  RPM = 'rpm',\n  SWID = 'swid',\n  SWIFT = 'swift',\n  VCS = 'vcs',\n}\n\nexport type PURLString = `${PURL_Type}`\n\n// Alias for backward compatibility and semantic clarity\nexport type EcosystemString = PURLString\n\n// Manifest types for Socket Registry\nexport type ManifestEntryData = {\n  categories?: CategoryString[] | undefined\n  interop?: InteropString | undefined\n  license?: string | undefined\n  name: string\n  version: string\n  [key: string]: unknown\n}\n\nexport type ManifestEntry = [packageName: string, data: ManifestEntryData]\n\nexport type Manifest = Record<EcosystemString, ManifestEntry[]>\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,IAAK,aAAL,kBAAKA,gBAAL;AACE,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,YAAS;AAJN,SAAAA;AAAA,GAAA;AASL,IAAK,UAAL,kBAAKC,aAAL;AACE,EAAAA,SAAA,gBAAa;AACb,EAAAA,SAAA,SAAM;AACN,EAAAA,SAAA,SAAM;AAHH,SAAAA;AAAA,GAAA;AASE,IAAK,YAAL,kBAAKC,eAAL;AACL,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,eAAY;AACZ,EAAAA,WAAA,eAAY;AACZ,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,cAAW;AACX,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,aAAU;AACV,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,aAAU;AACV,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,SAAM;AACN,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,SAAM;AA9BI,SAAAA;AAAA,GAAA;",
+  "names": ["Categories", "Interop", "PURL_Type"]
+}

package/dist/url.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Check if a value is a valid URL.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function isUrl(value: string | URL | null | undefined): boolean;
+/**
+ * Parse a value as a URL.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function parseUrl(value: string | URL): URL | undefined;
+/**
+ * Convert a URL search parameter to an array.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function urlSearchParamAsArray(value: string | null | undefined): string[];
+export interface UrlSearchParamAsBooleanOptions {
+    defaultValue?: boolean;
+}
+/**
+ * Convert a URL search parameter to a boolean.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function urlSearchParamAsBoolean(value: string | null | undefined, options?: UrlSearchParamAsBooleanOptions | undefined): boolean;
+/**
+ * Helper to get array from URLSearchParams.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function urlSearchParamsGetArray(params: URLSearchParams | null | undefined, key: string): string[];
+export interface UrlSearchParamsGetBooleanOptions {
+    defaultValue?: boolean;
+}
+/**
+ * Helper to get boolean from URLSearchParams.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function urlSearchParamsGetBoolean(params: URLSearchParams | null | undefined, key: string, options?: UrlSearchParamsGetBooleanOptions | undefined): boolean;
+export interface CreateRelativeUrlOptions {
+    base?: string;
+}
+/**
+ * Create a relative URL for testing.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function createRelativeUrl(path: string, options?: CreateRelativeUrlOptions | undefined): string;
+export interface UrlSearchParamAsStringOptions {
+    defaultValue?: string;
+}
+/**
+ * Get string value from URLSearchParams with a default.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function urlSearchParamAsString(params: URLSearchParams | null | undefined, key: string, options?: UrlSearchParamAsStringOptions | undefined): string;
+export interface UrlSearchParamAsNumberOptions {
+    defaultValue?: number;
+}
+/**
+ * Get number value from URLSearchParams with a default.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function urlSearchParamAsNumber(params: URLSearchParams | null | undefined, key: string, options?: UrlSearchParamAsNumberOptions | undefined): number;