@socketsecurity/lib 5.27.0 → 6.0.0

package/dist/objects.js

@@ -1,303 +0,0 @@
-"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 objects_exports = {};
-__export(objects_exports, {
-  createConstantsObject: () => createConstantsObject,
-  createLazyGetter: () => createLazyGetter,
-  defineGetter: () => defineGetter,
-  defineLazyGetter: () => defineLazyGetter,
-  defineLazyGetters: () => defineLazyGetters,
-  entryKeyComparator: () => entryKeyComparator,
-  getKeys: () => getKeys,
-  getOwn: () => getOwn,
-  getOwnPropertyValues: () => getOwnPropertyValues,
-  hasKeys: () => hasKeys,
-  hasOwn: () => hasOwn,
-  isObject: () => isObject,
-  isObjectObject: () => isObjectObject,
-  merge: () => merge,
-  objectAssign: () => objectAssign,
-  objectEntries: () => objectEntries,
-  objectFreeze: () => objectFreeze,
-  toSortedObject: () => toSortedObject,
-  toSortedObjectFromEntries: () => toSortedObjectFromEntries
-});
-module.exports = __toCommonJS(objects_exports);
-var import_core = require("./constants/core");
-var import_arrays = require("./arrays");
-var import_primordials = require("./primordials");
-var import_sorts = require("./sorts");
-// @__NO_SIDE_EFFECTS__
-function createConstantsObject(props, options_) {
-  const options = { __proto__: null, ...options_ };
-  const attributes = (0, import_primordials.ObjectFreeze)({
-    __proto__: null,
-    getters: options.getters ? (0, import_primordials.ObjectFreeze)(
-      (0, import_primordials.ObjectSetPrototypeOf)(/* @__PURE__ */ toSortedObject(options.getters), null)
-    ) : void 0,
-    internals: options.internals ? (0, import_primordials.ObjectFreeze)(
-      (0, import_primordials.ObjectSetPrototypeOf)(/* @__PURE__ */ toSortedObject(options.internals), null)
-    ) : void 0,
-    mixin: options.mixin ? (0, import_primordials.ObjectFreeze)(
-      (0, import_primordials.ObjectDefineProperties)(
-        { __proto__: null },
-        (0, import_primordials.ObjectGetOwnPropertyDescriptors)(options.mixin)
-      )
-    ) : void 0,
-    props: props ? (0, import_primordials.ObjectFreeze)((0, import_primordials.ObjectSetPrototypeOf)(/* @__PURE__ */ toSortedObject(props), null)) : void 0
-  });
-  const lazyGetterStats = (0, import_primordials.ObjectFreeze)({
-    __proto__: null,
-    initialized: new import_primordials.SetCtor()
-  });
-  const object = defineLazyGetters(
-    {
-      __proto__: null,
-      [import_core.kInternalsSymbol]: (0, import_primordials.ObjectFreeze)({
-        __proto__: null,
-        get attributes() {
-          return attributes;
-        },
-        get lazyGetterStats() {
-          return lazyGetterStats;
-        },
-        ...attributes.internals
-      }),
-      kInternalsSymbol: import_core.kInternalsSymbol,
-      ...attributes.props
-    },
-    attributes.getters,
-    lazyGetterStats
-  );
-  if (attributes.mixin) {
-    (0, import_primordials.ObjectDefineProperties)(
-      object,
-      /* @__PURE__ */ toSortedObjectFromEntries(
-        (/* @__PURE__ */ objectEntries((0, import_primordials.ObjectGetOwnPropertyDescriptors)(attributes.mixin))).filter(
-          (p) => !(0, import_primordials.ObjectHasOwn)(object, p[0])
-        )
-      )
-    );
-  }
-  return (0, import_primordials.ObjectFreeze)(object);
-}
-// @__NO_SIDE_EFFECTS__
-function createLazyGetter(name, getter, stats) {
-  let lazyValue = import_core.UNDEFINED_TOKEN;
-  const { [name]: lazyGetter } = {
-    [name]() {
-      if (lazyValue === import_core.UNDEFINED_TOKEN) {
-        stats?.initialized?.add(name);
-        lazyValue = getter();
-      }
-      return lazyValue;
-    }
-  };
-  return lazyGetter;
-}
-function defineGetter(object, propKey, getter) {
-  (0, import_primordials.ObjectDefineProperty)(object, propKey, {
-    get: getter,
-    enumerable: false,
-    configurable: true
-  });
-  return object;
-}
-function defineLazyGetter(object, propKey, getter, stats) {
-  return defineGetter(object, propKey, /* @__PURE__ */ createLazyGetter(propKey, getter, stats));
-}
-function defineLazyGetters(object, getterDefObj, stats) {
-  if (getterDefObj !== null && typeof getterDefObj === "object") {
-    const keys = (0, import_primordials.ReflectOwnKeys)(getterDefObj);
-    for (let i = 0, { length } = keys; i < length; i += 1) {
-      const key = keys[i];
-      defineLazyGetter(object, key, getterDefObj[key], stats);
-    }
-  }
-  return object;
-}
-// @__NO_SIDE_EFFECTS__
-function entryKeyComparator(a, b) {
-  const keyA = a[0];
-  const keyB = b[0];
-  const strKeyA = typeof keyA === "string" ? keyA : String(keyA);
-  const strKeyB = typeof keyB === "string" ? keyB : String(keyB);
-  return (0, import_sorts.localeCompare)(strKeyA, strKeyB);
-}
-// @__NO_SIDE_EFFECTS__
-function getKeys(obj) {
-  return /* @__PURE__ */ isObject(obj) ? (0, import_primordials.ObjectKeys)(obj) : [];
-}
-// @__NO_SIDE_EFFECTS__
-function getOwn(obj, propKey) {
-  if (obj === null || obj === void 0) {
-    return void 0;
-  }
-  return (0, import_primordials.ObjectHasOwn)(obj, propKey) ? obj[propKey] : void 0;
-}
-// @__NO_SIDE_EFFECTS__
-function getOwnPropertyValues(obj) {
-  if (obj === null || obj === void 0) {
-    return [];
-  }
-  const keys = (0, import_primordials.ObjectGetOwnPropertyNames)(obj);
-  const { length } = keys;
-  const values = Array(length);
-  for (let i = 0; i < length; i += 1) {
-    values[i] = obj[keys[i]];
-  }
-  return values;
-}
-// @__NO_SIDE_EFFECTS__
-function hasKeys(obj) {
-  if (obj === null || obj === void 0) {
-    return false;
-  }
-  for (const key in obj) {
-    if ((0, import_primordials.ObjectHasOwn)(obj, key)) {
-      return true;
-    }
-  }
-  return false;
-}
-// @__NO_SIDE_EFFECTS__
-function hasOwn(obj, propKey) {
-  if (obj === null || obj === void 0) {
-    return false;
-  }
-  return (0, import_primordials.ObjectHasOwn)(obj, propKey);
-}
-// @__NO_SIDE_EFFECTS__
-function isObject(value) {
-  return value !== null && typeof value === "object";
-}
-// @__NO_SIDE_EFFECTS__
-function isObjectObject(value) {
-  if (value === null || typeof value !== "object" || (0, import_arrays.isArray)(value)) {
-    return false;
-  }
-  const proto = (0, import_primordials.ObjectGetPrototypeOf)(value);
-  return proto === null || proto === import_primordials.ObjectPrototype;
-}
-// @__NO_SIDE_EFFECTS__
-function merge(target, source) {
-  if (!/* @__PURE__ */ isObject(target) || !/* @__PURE__ */ isObject(source)) {
-    return target;
-  }
-  const queue = [[target, source]];
-  let pos = 0;
-  let { length: queueLength } = queue;
-  while (pos < queueLength) {
-    if (pos === import_core.LOOP_SENTINEL) {
-      throw new import_primordials.ErrorCtor("Detected infinite loop in object crawl of merge");
-    }
-    const { 0: currentTarget, 1: currentSource } = queue[pos++];
-    if (!currentSource || !currentTarget) {
-      continue;
-    }
-    const isSourceArray = (0, import_arrays.isArray)(currentSource);
-    const isTargetArray = (0, import_arrays.isArray)(currentTarget);
-    if (isSourceArray || isTargetArray) {
-      continue;
-    }
-    const keys = (0, import_primordials.ReflectOwnKeys)(currentSource);
-    for (let i = 0, { length } = keys; i < length; i += 1) {
-      const key = keys[i];
-      const srcVal = currentSource[key];
-      const targetVal = currentTarget[key];
-      if ((0, import_arrays.isArray)(srcVal)) {
-        currentTarget[key] = srcVal;
-      } else if (/* @__PURE__ */ isObject(srcVal)) {
-        if (/* @__PURE__ */ isObject(targetVal) && !(0, import_arrays.isArray)(targetVal)) {
-          queue[queueLength++] = [targetVal, srcVal];
-        } else {
-          currentTarget[key] = srcVal;
-        }
-      } else {
-        currentTarget[key] = srcVal;
-      }
-    }
-  }
-  return target;
-}
-const objectAssign = Object.assign;
-// @__NO_SIDE_EFFECTS__
-function objectEntries(obj) {
-  if (obj === null || obj === void 0) {
-    return [];
-  }
-  const keys = (0, import_primordials.ReflectOwnKeys)(obj);
-  const { length } = keys;
-  const entries = Array(length);
-  const record = obj;
-  for (let i = 0; i < length; i += 1) {
-    const key = keys[i];
-    entries[i] = [key, record[key]];
-  }
-  return entries;
-}
-const objectFreeze = Object.freeze;
-// @__NO_SIDE_EFFECTS__
-function toSortedObject(obj) {
-  return /* @__PURE__ */ toSortedObjectFromEntries(/* @__PURE__ */ objectEntries(obj));
-}
-// @__NO_SIDE_EFFECTS__
-function toSortedObjectFromEntries(entries) {
-  const otherEntries = [];
-  const symbolEntries = [];
-  for (const entry of entries) {
-    if (typeof entry[0] === "symbol") {
-      symbolEntries.push(entry);
-    } else {
-      otherEntries.push(entry);
-    }
-  }
-  if (!otherEntries.length && !symbolEntries.length) {
-    return {};
-  }
-  return (0, import_primordials.ObjectFromEntries)([
-    // The String constructor is safe to use with symbols.
-    ...symbolEntries.sort(entryKeyComparator),
-    ...otherEntries.sort(entryKeyComparator)
-  ]);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createConstantsObject,
-  createLazyGetter,
-  defineGetter,
-  defineLazyGetter,
-  defineLazyGetters,
-  entryKeyComparator,
-  getKeys,
-  getOwn,
-  getOwnPropertyValues,
-  hasKeys,
-  hasOwn,
-  isObject,
-  isObjectObject,
-  merge,
-  objectAssign,
-  objectEntries,
-  objectFreeze,
-  toSortedObject,
-  toSortedObjectFromEntries
-});

package/dist/package-extensions.d.ts

@@ -1,9 +0,0 @@
-/**
- * @fileoverview Package extensions for compatibility adjustments.
- *
- * Package extensions allow modifying package.json fields of dependencies
- * to fix compatibility issues, missing peer dependencies, etc.
- */
-type PackageExtension = readonly [string, Record<string, unknown>];
-declare const packageExtensions: readonly PackageExtension[];
-export { packageExtensions };

package/dist/packages.js

@@ -1,132 +0,0 @@
-"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 packages_exports = {};
-__export(packages_exports, {
-  collectIncompatibleLicenses: () => import_licenses.collectIncompatibleLicenses,
-  collectLicenseWarnings: () => import_licenses.collectLicenseWarnings,
-  createAstNode: () => import_licenses.createAstNode,
-  createBinaryOperationNode: () => import_licenses.createBinaryOperationNode,
-  createLicenseNode: () => import_licenses.createLicenseNode,
-  createPackageJson: () => import_manifest.createPackageJson,
-  extractPackage: () => import_operations.extractPackage,
-  fetchPackageManifest: () => import_manifest.fetchPackageManifest,
-  fetchPackagePackument: () => import_manifest.fetchPackagePackument,
-  fetchPackageProvenance: () => import_provenance.fetchPackageProvenance,
-  findPackageExtensions: () => import_operations.findPackageExtensions,
-  findTypesForSubpath: () => import_exports.findTypesForSubpath,
-  getEditablePackageJsonClass: () => import_edit.getEditablePackageJsonClass,
-  getExportFilePaths: () => import_exports.getExportFilePaths,
-  getProvenanceDetails: () => import_provenance.getProvenanceDetails,
-  getReleaseTag: () => import_operations.getReleaseTag,
-  getRepoUrlDetails: () => import_specs.getRepoUrlDetails,
-  getSubpaths: () => import_exports.getSubpaths,
-  gitHubTagRefUrl: () => import_specs.gitHubTagRefUrl,
-  gitHubTgzUrl: () => import_specs.gitHubTgzUrl,
-  isBlessedPackageName: () => import_validation.isBlessedPackageName,
-  isConditionalExports: () => import_exports.isConditionalExports,
-  isGitHubTgzSpec: () => import_specs.isGitHubTgzSpec,
-  isGitHubUrlSpec: () => import_specs.isGitHubUrlSpec,
-  isRegistryFetcherType: () => import_validation.isRegistryFetcherType,
-  isSubpathExports: () => import_exports.isSubpathExports,
-  isValidPackageName: () => import_validation.isValidPackageName,
-  isolatePackage: () => import_isolation.isolatePackage,
-  normalizePackageJson: () => import_normalize.normalizePackageJson,
-  packPackage: () => import_operations.packPackage,
-  parseSpdxExp: () => import_licenses.parseSpdxExp,
-  pkgJsonToEditable: () => import_edit.pkgJsonToEditable,
-  readPackageJson: () => import_operations.readPackageJson,
-  readPackageJsonSync: () => import_operations.readPackageJsonSync,
-  resolveEscapedScope: () => import_normalize.resolveEscapedScope,
-  resolveGitHubTgzUrl: () => import_operations.resolveGitHubTgzUrl,
-  resolveOriginalPackageName: () => import_normalize.resolveOriginalPackageName,
-  resolvePackageJsonDirname: () => import_packages.resolvePackageJsonDirname,
-  resolvePackageJsonEntryExports: () => import_exports.resolvePackageJsonEntryExports,
-  resolvePackageJsonPath: () => import_packages.resolvePackageJsonPath,
-  resolvePackageLicenses: () => import_licenses.resolvePackageLicenses,
-  resolvePackageName: () => import_operations.resolvePackageName,
-  resolveRegistryPackageName: () => import_operations.resolveRegistryPackageName,
-  toEditablePackageJson: () => import_edit.toEditablePackageJson,
-  toEditablePackageJsonSync: () => import_edit.toEditablePackageJsonSync,
-  unescapeScope: () => import_normalize.unescapeScope,
-  visitLicenses: () => import_licenses.visitLicenses
-});
-module.exports = __toCommonJS(packages_exports);
-var import_edit = require("./packages/edit");
-var import_exports = require("./packages/exports");
-var import_isolation = require("./packages/isolation");
-var import_licenses = require("./packages/licenses");
-var import_manifest = require("./packages/manifest");
-var import_normalize = require("./packages/normalize");
-var import_operations = require("./packages/operations");
-var import_provenance = require("./packages/provenance");
-var import_specs = require("./packages/specs");
-var import_validation = require("./packages/validation");
-var import_packages = require("./paths/packages");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  collectIncompatibleLicenses,
-  collectLicenseWarnings,
-  createAstNode,
-  createBinaryOperationNode,
-  createLicenseNode,
-  createPackageJson,
-  extractPackage,
-  fetchPackageManifest,
-  fetchPackagePackument,
-  fetchPackageProvenance,
-  findPackageExtensions,
-  findTypesForSubpath,
-  getEditablePackageJsonClass,
-  getExportFilePaths,
-  getProvenanceDetails,
-  getReleaseTag,
-  getRepoUrlDetails,
-  getSubpaths,
-  gitHubTagRefUrl,
-  gitHubTgzUrl,
-  isBlessedPackageName,
-  isConditionalExports,
-  isGitHubTgzSpec,
-  isGitHubUrlSpec,
-  isRegistryFetcherType,
-  isSubpathExports,
-  isValidPackageName,
-  isolatePackage,
-  normalizePackageJson,
-  packPackage,
-  parseSpdxExp,
-  pkgJsonToEditable,
-  readPackageJson,
-  readPackageJsonSync,
-  resolveEscapedScope,
-  resolveGitHubTgzUrl,
-  resolveOriginalPackageName,
-  resolvePackageJsonDirname,
-  resolvePackageJsonEntryExports,
-  resolvePackageJsonPath,
-  resolvePackageLicenses,
-  resolvePackageName,
-  resolveRegistryPackageName,
-  toEditablePackageJson,
-  toEditablePackageJsonSync,
-  unescapeScope,
-  visitLicenses
-});

package/dist/performance.d.ts

@@ -1,181 +0,0 @@
-/**
- * @fileoverview Performance monitoring utilities for profiling and optimization.
- * Provides timing, profiling, and performance metric collection for identifying bottlenecks.
- */
-/**
- * Performance metrics collected during execution.
- */
-export type PerformanceMetrics = {
-    operation: string;
-    duration: number;
-    timestamp: number;
-    metadata?: Record<string, unknown>;
-};
-/**
- * Clear all collected performance metrics.
- *
- * @example
- * import { clearPerformanceMetrics } from '@socketsecurity/lib/performance'
- *
- * clearPerformanceMetrics()
- */
-export declare function clearPerformanceMetrics(): void;
-/**
- * Create a performance report for the current execution.
- * Only available when DEBUG=perf is enabled.
- *
- * @returns Formatted performance report
- *
- * @example
- * import { generatePerformanceReport } from '@socketsecurity/lib/performance'
- *
- * console.log(generatePerformanceReport())
- * // ╔═══════════════════════════════════════════════╗
- * // ║         Performance Report                    ║
- * // ╚═══════════════════════════════════════════════╝
- * //
- * // api-call:
- * //   Calls: 5
- * //   Avg:   246.8ms
- * //   Min:   100ms
- * //   Max:   500ms
- * //   Total: 1234ms
- */
-export declare function generatePerformanceReport(): string;
-/**
- * Get all collected performance metrics.
- * Only available when DEBUG=perf is enabled.
- *
- * @returns Array of performance metrics
- *
- * @example
- * import { getPerformanceMetrics } from '@socketsecurity/lib/performance'
- *
- * const metrics = getPerformanceMetrics()
- * console.log(metrics)
- */
-export declare function getPerformanceMetrics(): PerformanceMetrics[];
-/**
- * Get performance summary statistics.
- *
- * @returns Summary of metrics grouped by operation
- *
- * @example
- * import { getPerformanceSummary } from '@socketsecurity/lib/performance'
- *
- * const summary = getPerformanceSummary()
- * console.log(summary)
- * // {
- * //   'api-call': { count: 5, total: 1234, avg: 246.8, min: 100, max: 500 },
- * //   'file-read': { count: 10, total: 50, avg: 5, min: 2, max: 15 }
- * // }
- */
-export declare function getPerformanceSummary(): Record<string, {
-    count: number;
-    total: number;
-    avg: number;
-    min: number;
-    max: number;
-}>;
-/**
- * Measure execution time of an async function.
- *
- * @param operation - Name of the operation
- * @param fn - Async function to measure
- * @param metadata - Optional metadata
- * @returns Result of the function and duration
- *
- * @example
- * import { measure } from '@socketsecurity/lib/performance'
- *
- * const { result, duration } = await measure('fetch-packages', async () => {
- *   return await fetchPackages()
- * })
- * console.log(`Fetched packages in ${duration}ms`)
- */
-export declare function measure<T>(operation: string, fn: () => Promise<T>, metadata?: Record<string, unknown>): Promise<{
-    result: T;
-    duration: number;
-}>;
-/**
- * Measure synchronous function execution time.
- *
- * @param operation - Name of the operation
- * @param fn - Synchronous function to measure
- * @param metadata - Optional metadata
- * @returns Result of the function and duration
- *
- * @example
- * import { measureSync } from '@socketsecurity/lib/performance'
- *
- * const { result, duration } = measureSync('parse-json', () => {
- *   return JSON.parse(data)
- * })
- */
-export declare function measureSync<T>(operation: string, fn: () => T, metadata?: Record<string, unknown>): {
-    result: T;
-    duration: number;
-};
-/**
- * Mark a checkpoint in performance tracking.
- * Useful for tracking progress through complex operations.
- *
- * @param checkpoint - Name of the checkpoint
- * @param metadata - Optional metadata
- *
- * @example
- * import { perfCheckpoint } from '@socketsecurity/lib/performance'
- *
- * perfCheckpoint('start-scan')
- * // ... do work ...
- * perfCheckpoint('fetch-packages', { count: 50 })
- * // ... do work ...
- * perfCheckpoint('analyze-issues', { issueCount: 10 })
- * perfCheckpoint('end-scan')
- */
-export declare function perfCheckpoint(checkpoint: string, metadata?: Record<string, unknown>): void;
-/**
- * Start a performance timer for an operation.
- * Returns a stop function that records the duration.
- *
- * @param operation - Name of the operation being timed
- * @param metadata - Optional metadata to attach to the metric
- * @returns Stop function that completes the timing
- *
- * @example
- * import { perfTimer } from '@socketsecurity/lib/performance'
- *
- * const stop = perfTimer('api-call')
- * await fetchData()
- * stop({ endpoint: '/npm/lodash/score' })
- */
-export declare function perfTimer(operation: string, metadata?: Record<string, unknown>): (additionalMetadata?: Record<string, unknown>) => void;
-/**
- * Print performance summary to console.
- * Only prints when DEBUG=perf is enabled.
- *
- * @example
- * import { printPerformanceSummary } from '@socketsecurity/lib/performance'
- *
- * printPerformanceSummary()
- * // Performance Summary:
- * // api-call: 5 calls, avg 246.8ms (min 100ms, max 500ms, total 1234ms)
- * // file-read: 10 calls, avg 5ms (min 2ms, max 15ms, total 50ms)
- */
-export declare function printPerformanceSummary(): void;
-/**
- * Track memory usage at a specific point.
- * Only available when DEBUG=perf is enabled.
- *
- * @param label - Label for this memory snapshot
- * @returns Memory usage in MB
- *
- * @example
- * import { trackMemory } from '@socketsecurity/lib/performance'
- *
- * const memBefore = trackMemory('before-operation')
- * await heavyOperation()
- * const memAfter = trackMemory('after-operation')
- * console.log(`Memory increased by ${memAfter - memBefore}MB`)
- */
-export declare function trackMemory(label: string): number;