@socketsecurity/lib 5.18.1 → 5.19.0

package/dist/memoization.d.ts

@@ -1,7 +1,11 @@
+/**
+ * @fileoverview Memoization utilities for caching function results.
+ * Provides function result caching to optimize repeated computations and expensive operations.
+ */
 /**
  * Options for memoization behavior.
  */
-type MemoizeOptions<Args extends unknown[], _Result = unknown> = {
+export type MemoizeOptions<Args extends unknown[], _Result = unknown> = {
     /** Custom cache key generator (defaults to JSON.stringify) */
     keyGen?: (...args: Args) => string;
     /** Maximum cache size (LRU eviction when exceeded) */
@@ -15,6 +19,37 @@ type MemoizeOptions<Args extends unknown[], _Result = unknown> = {
     /** Custom equality check for cache hits */
     equals?: (a: Args, b: Args) => boolean;
 };
+/**
+ * Clear all memoization caches.
+ * Useful for testing or when you need to force recomputation.
+ *
+ * @example
+ * ```typescript
+ * clearAllMemoizationCaches()
+ * ```
+ */
+export declare function clearAllMemoizationCaches(): void;
+/**
+ * Create a memoized version of a method.
+ * Preserves 'this' context for class methods.
+ *
+ * @param target - Object containing the method
+ * @param propertyKey - Method name
+ * @param descriptor - Property descriptor
+ * @returns Modified descriptor with memoized method
+ *
+ * @example
+ * import { Memoize } from '@socketsecurity/lib/memoization'
+ *
+ * class Calculator {
+ *   @Memoize()
+ *   fibonacci(n: number): number {
+ *     if (n <= 1) return n
+ *     return this.fibonacci(n - 1) + this.fibonacci(n - 2)
+ *   }
+ * }
+ */
+export declare function Memoize(options?: MemoizeOptions<unknown[], unknown>): (_target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 /**
  * Memoize a function with configurable caching behavior.
  * Caches function results to avoid repeated computation.
@@ -56,36 +91,24 @@ export declare function memoize<Args extends unknown[], Result>(fn: (...args: Ar
  */
 export declare function memoizeAsync<Args extends unknown[], Result>(fn: (...args: Args) => Promise<Result>, options?: MemoizeOptions<Args, Result>): (...args: Args) => Promise<Result>;
 /**
- * Create a memoized version of a method.
- * Preserves 'this' context for class methods.
+ * Create a debounced memoized function.
+ * Combines memoization with debouncing for expensive operations.
  *
- * @param target - Object containing the method
- * @param propertyKey - Method name
- * @param descriptor - Property descriptor
- * @returns Modified descriptor with memoized method
+ * @param fn - Function to memoize and debounce
+ * @param wait - Debounce wait time in milliseconds
+ * @param options - Memoization options
+ * @returns Debounced memoized function
  *
  * @example
- * import { Memoize } from '@socketsecurity/lib/memoization'
- *
- * class Calculator {
- *   @Memoize()
- *   fibonacci(n: number): number {
- *     if (n <= 1) return n
- *     return this.fibonacci(n - 1) + this.fibonacci(n - 2)
- *   }
- * }
- */
-export declare function Memoize(options?: MemoizeOptions<unknown[], unknown>): (_target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * Clear all memoization caches.
- * Useful for testing or when you need to force recomputation.
+ * import { memoizeDebounced } from '@socketsecurity/lib/memoization'
  *
- * @example
- * ```typescript
- * clearAllMemoizationCaches()
- * ```
+ * const search = memoizeDebounced(
+ *   (query: string) => performSearch(query),
+ *   300,
+ *   { name: 'search' }
+ * )
  */
-export declare function clearAllMemoizationCaches(): void;
+export declare function memoizeDebounced<Args extends unknown[], Result>(fn: (...args: Args) => Result, wait: number, options?: MemoizeOptions<Args, Result>): (...args: Args) => Result;
 /**
  * Memoize with WeakMap for object keys.
  * Allows garbage collection when objects are no longer referenced.
@@ -107,10 +130,10 @@ export declare function clearAllMemoizationCaches(): void;
  */
 export declare function memoizeWeak<K extends object, Result>(fn: (key: K) => Result): (key: K) => Result;
 /**
- * Simple once() implementation - caches single result forever.
- * Useful for initialization functions that should only run once.
+ * Simple once() for zero-argument initialization functions.
+ * Caches a single result forever and emits debug-log events on hit/miss.
  *
- * @param fn - Function to run once
+ * @param fn - Zero-argument function to run once
  * @returns Memoized version that only executes once
  *
  * @example
@@ -125,23 +148,3 @@ export declare function memoizeWeak<K extends object, Result>(fn: (key: K) => Re
  * initialize() // Returns cached config (no log)
  */
 export declare function once<Result>(fn: () => Result): () => Result;
-/**
- * Create a debounced memoized function.
- * Combines memoization with debouncing for expensive operations.
- *
- * @param fn - Function to memoize and debounce
- * @param wait - Debounce wait time in milliseconds
- * @param options - Memoization options
- * @returns Debounced memoized function
- *
- * @example
- * import { memoizeDebounced } from '@socketsecurity/lib/memoization'
- *
- * const search = memoizeDebounced(
- *   (query: string) => performSearch(query),
- *   300,
- *   { name: 'search' }
- * )
- */
-export declare function memoizeDebounced<Args extends unknown[], Result>(fn: (...args: Args) => Result, wait: number, options?: MemoizeOptions<Args, Result>): (...args: Args) => Result;
-export {};

package/dist/memoization.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -30,9 +31,45 @@ __export(memoization_exports, {
 module.exports = __toCommonJS(memoization_exports);
 var import_debug = require("./debug");
 const cacheRegistry = [];
+function defaultKeyGen(args) {
+  return JSON.stringify(args, (_key, value) => {
+    if (value === void 0) {
+      return "\0undefined";
+    }
+    if (typeof value === "bigint") {
+      return `\0bigint:${value.toString()}`;
+    }
+    if (typeof value === "function") {
+      return `\0fn:${value.name || "anonymous"}`;
+    }
+    if (value instanceof Map) {
+      return { __tag: "Map", entries: Array.from(value.entries()) };
+    }
+    if (value instanceof Set) {
+      return { __tag: "Set", values: Array.from(value.values()) };
+    }
+    return value;
+  });
+}
+function clearAllMemoizationCaches() {
+  (0, import_debug.debugLog)("[memoize:all] clear", { action: "clear-all-caches" });
+  for (const clear of cacheRegistry) {
+    clear();
+  }
+}
+function Memoize(options = {}) {
+  return (_target, propertyKey, descriptor) => {
+    const originalMethod = descriptor.value;
+    descriptor.value = memoize(originalMethod, {
+      ...options,
+      name: options.name || propertyKey
+    });
+    return descriptor;
+  };
+}
 function memoize(fn, options = {}) {
   const {
-    keyGen = (...args) => JSON.stringify(args),
+    keyGen = (...args) => defaultKeyGen(args),
     maxSize = Number.POSITIVE_INFINITY,
     name = fn.name || "anonymous",
     ttl = Number.POSITIVE_INFINITY
@@ -99,7 +136,7 @@ function memoize(fn, options = {}) {
 }
 function memoizeAsync(fn, options = {}) {
   const {
-    keyGen = (...args) => JSON.stringify(args),
+    keyGen = (...args) => defaultKeyGen(args),
     maxSize = Number.POSITIVE_INFINITY,
     name = fn.name || "anonymous",
     ttl = Number.POSITIVE_INFINITY
@@ -128,7 +165,7 @@ function memoizeAsync(fn, options = {}) {
     }
     return Date.now() - entry.timestamp > ttl;
   }
-  const refreshing = /* @__PURE__ */ new Set();
+  const refreshing = /* @__PURE__ */ new Map();
   return async function memoized(...args) {
     const key = keyGen(...args);
     const cached = cache.get(key);
@@ -143,9 +180,10 @@ function memoizeAsync(fn, options = {}) {
         (0, import_debug.debugLog)(`[memoizeAsync:${name}] hit`, { key, hits: cached.hits });
         return await cached.value;
       }
-      if (refreshing.has(key)) {
+      const inflight = refreshing.get(key);
+      if (inflight) {
         (0, import_debug.debugLog)(`[memoizeAsync:${name}] stale-dedup`, { key });
-        return await cached.value;
+        return await inflight;
       }
       cache.delete(key);
       const index = accessOrder.indexOf(key);
@@ -154,7 +192,6 @@ function memoizeAsync(fn, options = {}) {
       }
     }
     (0, import_debug.debugLog)(`[memoizeAsync:${name}] miss`, { key });
-    refreshing.add(key);
     const promise = fn(...args).then(
       (result) => {
         refreshing.delete(key);
@@ -175,6 +212,7 @@ function memoizeAsync(fn, options = {}) {
         throw error;
       }
     );
+    refreshing.set(key, promise);
     evictLRU();
     cache.set(key, {
       value: promise,
@@ -186,22 +224,19 @@ function memoizeAsync(fn, options = {}) {
     return await promise;
   };
 }
-function Memoize(options = {}) {
-  return (_target, propertyKey, descriptor) => {
-    const originalMethod = descriptor.value;
-    descriptor.value = memoize(originalMethod, {
-      ...options,
-      name: options.name || propertyKey
-    });
-    return descriptor;
+function memoizeDebounced(fn, wait, options = {}) {
+  const memoized = memoize(fn, options);
+  let timeoutId;
+  return function debounced(...args) {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+    timeoutId = setTimeout(() => {
+      memoized(...args);
+    }, wait);
+    return memoized(...args);
   };
 }
-function clearAllMemoizationCaches() {
-  (0, import_debug.debugLog)("[memoize:all] clear", { action: "clear-all-caches" });
-  for (const clear of cacheRegistry) {
-    clear();
-  }
-}
 function memoizeWeak(fn) {
   const cache = /* @__PURE__ */ new WeakMap();
   return function memoized(key) {
@@ -229,19 +264,6 @@ function once(fn) {
     return result;
   };
 }
-function memoizeDebounced(fn, wait, options = {}) {
-  const memoized = memoize(fn, options);
-  let timeoutId;
-  return function debounced(...args) {
-    if (timeoutId) {
-      clearTimeout(timeoutId);
-    }
-    timeoutId = setTimeout(() => {
-      memoized(...args);
-    }, wait);
-    return memoized(...args);
-  };
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Memoize,

package/dist/objects.d.ts

@@ -1,4 +1,7 @@
-// Type definitions
+/**
+ * @fileoverview Object manipulation and reflection utilities.
+ * Provides type-safe object operations, property access, and structural helpers.
+ */
 /**
  * Record of property keys mapped to getter functions.
  * Used for defining lazy getters on objects.
@@ -91,7 +94,6 @@ export type { GetterDefObj, LazyGetterStats, ConstantsObjectOptions, Remap };
  * console.log(config[kInternalsSymbol].version) // '1.0.0'
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function createConstantsObject(props: object, options_?: ConstantsObjectOptions | undefined): Readonly<object>;
 /**
  * Create a lazy getter function that memoizes its result.
@@ -118,7 +120,6 @@ export declare function createConstantsObject(props: object, options_?: Constant
  * console.log(stats.initialized.has('data')) // true
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function createLazyGetter<T>(name: PropertyKey, getter: () => T, stats?: LazyGetterStats | undefined): () => T;
 /**
  * Define a getter property on an object.
@@ -210,7 +211,6 @@ export declare function defineLazyGetters(object: object, getterDefObj: GetterDe
  * // [['apple', 2], ['banana', 3], ['zebra', 1]]
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function entryKeyComparator(a: [PropertyKey, unknown], b: [PropertyKey, unknown]): number;
 /**
  * Get the enumerable own property keys of an object.
@@ -230,7 +230,6 @@ export declare function entryKeyComparator(a: [PropertyKey, unknown], b: [Proper
  * getKeys('hello') // []
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function getKeys(obj: unknown): string[];
 /**
  * Get an own property value from an object safely.
@@ -253,7 +252,6 @@ export declare function getKeys(obj: unknown): string[];
  * getOwn(undefined, 'name') // undefined
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function getOwn(obj: unknown, propKey: PropertyKey): unknown;
 /**
  * Get all own property values from an object.
@@ -272,7 +270,6 @@ export declare function getOwn(obj: unknown, propKey: PropertyKey): unknown;
  * getOwnPropertyValues(undefined) // []
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function getOwnPropertyValues<T>(obj: {
     [key: PropertyKey]: T;
 } | null | undefined): T[];
@@ -296,7 +293,6 @@ export declare function getOwnPropertyValues<T>(obj: {
  * hasKeys(Object.create({ inherited: true })) // false (inherited, not own)
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function hasKeys(obj: unknown): obj is PropertyBag;
 /**
  * Check if an object has an own property.
@@ -319,7 +315,6 @@ export declare function hasKeys(obj: unknown): obj is PropertyBag;
  * hasOwn(undefined, 'name') // false
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function hasOwn(obj: unknown, propKey: PropertyKey): obj is object & PropertyBag;
 /**
  * Check if a value is an object (including arrays).
@@ -342,7 +337,6 @@ export declare function hasOwn(obj: unknown, propKey: PropertyKey): obj is objec
  * isObject('string') // false
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function isObject(value: unknown): value is {
     [key: PropertyKey]: unknown;
 };
@@ -366,33 +360,9 @@ export declare function isObject(value: unknown): value is {
  * isObjectObject(42) // false
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function isObjectObject(value: unknown): value is {
     [key: PropertyKey]: unknown;
 };
-// IMPORTANT: Do not use destructuring here - use direct assignment instead.
-// tsgo has a bug that incorrectly transpiles destructured exports, resulting in
-// `exports.SomeName = void 0;` which causes runtime errors.
-// See: https://github.com/SocketDev/socket-packageurl-js/issues/3
-/**
- * Alias for native `Object.assign`.
- *
- * Copies all enumerable own properties from one or more source objects
- * to a target object and returns the modified target object.
- *
- * @example
- * ```ts
- * const target = { a: 1 }
- * const source = { b: 2, c: 3 }
- * objectAssign(target, source) // { a: 1, b: 2, c: 3 }
- * ```
- */
-export declare const objectAssign: {
-    <T extends {}, U>(target: T, source: U): T & U;
-    <T extends {}, U, V>(target: T, source1: U, source2: V): T & U & V;
-    <T extends {}, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;
-    (target: object, ...sources: any[]): any;
-};
 /**
  * Deep merge source object into target object.
  *
@@ -425,8 +395,26 @@ export declare const objectAssign: {
  * // { config: { api: 'v2', timeout: 1000, retries: 3 } }
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function merge<T extends object, U extends object>(target: T, source: U): T & U;
+/**
+ * Alias for native `Object.assign`.
+ *
+ * Copies all enumerable own properties from one or more source objects
+ * to a target object and returns the modified target object.
+ *
+ * @example
+ * ```ts
+ * const target = { a: 1 }
+ * const source = { b: 2, c: 3 }
+ * objectAssign(target, source) // { a: 1, b: 2, c: 3 }
+ * ```
+ */
+export declare const objectAssign: {
+    <T extends {}, U>(target: T, source: U): T & U;
+    <T extends {}, U, V>(target: T, source1: U, source2: V): T & U & V;
+    <T extends {}, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;
+    (target: object, ...sources: any[]): any;
+};
 /**
  * Get all own property entries (key-value pairs) from an object.
  *
@@ -445,12 +433,7 @@ export declare function merge<T extends object, U extends object>(target: T, sou
  * objectEntries(undefined) // []
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function objectEntries(obj: unknown): Array<[PropertyKey, unknown]>;
-// IMPORTANT: Do not use destructuring here - use direct assignment instead.
-// tsgo has a bug that incorrectly transpiles destructured exports, resulting in
-// `exports.SomeName = void 0;` which causes runtime errors.
-// See: https://github.com/SocketDev/socket-packageurl-js/issues/3
 /**
  * Alias for native `Object.freeze`.
  *
@@ -468,8 +451,8 @@ export declare function objectEntries(obj: unknown): Array<[PropertyKey, unknown
 export declare const objectFreeze: {
     <T extends Function>(f: T): T;
     <T extends {
-        [idx: string]: object | U;
-    }, U extends string | number | bigint | symbol | boolean>(o: T): Readonly<T>;
+        [idx: string]: U | null | undefined | object;
+    }, U extends string | bigint | number | boolean | symbol>(o: T): Readonly<T>;
     <T>(o: T): Readonly<T>;
 };
 /**
@@ -493,7 +476,6 @@ export declare const objectFreeze: {
  * // { [Symbol(first)]: 4, [Symbol(second)]: 2, a: 3, z: 1 }
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function toSortedObject<T extends object>(obj: T): T;
 /**
  * Create an object from entries with sorted keys.
@@ -515,5 +497,4 @@ export declare function toSortedObject<T extends object>(obj: T): T;
  * // { alpha: 1, beta: 2, gamma: 3 }
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function toSortedObjectFromEntries<T = unknown>(entries: Iterable<[PropertyKey, T]>): SortedObject<T>;

package/dist/objects.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -207,7 +208,6 @@ function isObjectObject(value) {
   const proto = ObjectGetPrototypeOf(value);
   return proto === null || proto === ObjectPrototype;
 }
-const objectAssign = Object.assign;
 // @__NO_SIDE_EFFECTS__
 function merge(target, source) {
   if (!/* @__PURE__ */ isObject(target) || !/* @__PURE__ */ isObject(source)) {
@@ -249,6 +249,7 @@ function merge(target, source) {
   }
   return target;
 }
+const objectAssign = Object.assign;
 // @__NO_SIDE_EFFECTS__
 function objectEntries(obj) {
   if (obj === null || obj === void 0) {

package/dist/package-extensions.d.ts

@@ -1,3 +1,9 @@
+/**
+ * @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/package-extensions.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -32,7 +33,7 @@ __export(package_extensions_exports, {
   packageExtensions: () => packageExtensions
 });
 module.exports = __toCommonJS(package_extensions_exports);
-var yarnPkgExtensions = __toESM(require("./external/@yarnpkg/extensions.js"));
+var yarnPkgExtensions = __toESM(require("./external/@yarnpkg/extensions"));
 const { freeze: ObjectFreeze } = Object;
 const packageExtensions = ObjectFreeze(
   [

package/dist/packages/edit.d.ts

@@ -1,5 +1,7 @@
+/**
+ * @fileoverview Editable package.json manipulation utilities.
+ */
 import type { EditablePackageJsonOptions, NormalizeOptions, PackageJson, SaveOptions } from '../packages';
-// Define the interface for the dynamic class
 interface EditablePackageJsonConstructor {
     new (): EditablePackageJsonInstance;
     fixSteps: unknown[];
@@ -91,7 +93,6 @@ export interface EditablePackageJsonInstance {
  * console.log(pkg.content.name)
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function getEditablePackageJsonClass(): EditablePackageJsonConstructor;
 /**
  * Convert a package.json object to an editable instance.
@@ -101,7 +102,6 @@ export declare function getEditablePackageJsonClass(): EditablePackageJsonConstr
  * const editable = pkgJsonToEditable({ name: 'my-pkg', version: '1.0.0' })
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function pkgJsonToEditable(pkgJson: PackageJson, options?: EditablePackageJsonOptions): unknown;
 /**
  * Convert package.json to editable instance with file persistence.
@@ -114,7 +114,6 @@ export declare function pkgJsonToEditable(pkgJson: PackageJson, options?: Editab
  * )
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function toEditablePackageJson(pkgJson: PackageJson, options?: EditablePackageJsonOptions): Promise<unknown>;
 /**
  * Convert package.json to editable instance with file persistence synchronously.
@@ -127,6 +126,5 @@ export declare function toEditablePackageJson(pkgJson: PackageJson, options?: Ed
  * )
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function toEditablePackageJsonSync(pkgJson: PackageJson, options?: EditablePackageJsonOptions): unknown;
 export {};

package/dist/packages/edit.js

@@ -1,5 +1,6 @@
 "use strict";
 /* Socket Lib - Built with esbuild */
+"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -47,7 +48,7 @@ let _fs;
 // @__NO_SIDE_EFFECTS__
 function getFs() {
   if (_fs === void 0) {
-    _fs = require("fs");
+    _fs = require("node:fs");
   }
   return _fs;
 }
@@ -55,7 +56,7 @@ let _path;
 // @__NO_SIDE_EFFECTS__
 function getPath() {
   if (_path === void 0) {
-    _path = require("path");
+    _path = require("node:path");
   }
   return _path;
 }
@@ -63,7 +64,7 @@ let _util;
 // @__NO_SIDE_EFFECTS__
 function getUtil() {
   if (_util === void 0) {
-    _util = require("util");
+    _util = require("node:util");
   }
   return _util;
 }

package/dist/packages/exports.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @fileoverview Package exports field utilities.
+ */
 /**
  * Find types definition for a specific subpath in package exports.
  *
@@ -8,30 +11,27 @@
  * // types === './dist/index.d.ts'
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function findTypesForSubpath(entryExports: unknown, subpath: string): string | undefined;
 /**
- * Get subpaths from package exports.
+ * Get file paths from package exports.
  *
  * @example
  * ```typescript
- * const exports = { '.': './index.js', './utils': './utils.js' }
- * getSubpaths(exports) // ['.', './utils']
+ * const exports = { '.': './dist/index.js', './utils': './dist/utils.js' }
+ * getExportFilePaths(exports) // ['./dist/index.js', './dist/utils.js']
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
-export declare function getSubpaths(entryExports: unknown): string[];
+export declare function getExportFilePaths(entryExports: unknown): string[];
 /**
- * Get file paths from package exports.
+ * Get subpaths from package exports.
  *
  * @example
  * ```typescript
- * const exports = { '.': './dist/index.js', './utils': './dist/utils.js' }
- * getExportFilePaths(exports) // ['./dist/index.js', './dist/utils.js']
+ * const exports = { '.': './index.js', './utils': './utils.js' }
+ * getSubpaths(exports) // ['.', './utils']
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
-export declare function getExportFilePaths(entryExports: unknown): string[];
+export declare function getSubpaths(entryExports: unknown): string[];
 /**
  * Check if package exports use conditional patterns (e.g., import/require).
  *
@@ -41,7 +41,6 @@ export declare function getExportFilePaths(entryExports: unknown): string[];
  * isConditionalExports({ '.': './index.js' })                            // false
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function isConditionalExports(entryExports: unknown): boolean;
 /**
  * Check if package exports use subpath patterns (keys starting with '.').
@@ -52,7 +51,6 @@ export declare function isConditionalExports(entryExports: unknown): boolean;
  * isSubpathExports({ import: './index.mjs' })                     // false
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function isSubpathExports(entryExports: unknown): boolean;
 /**
  * Normalize package.json exports field to canonical format.
@@ -66,5 +64,4 @@ export declare function isSubpathExports(entryExports: unknown): boolean;
  * // { '.': './index.js' }
  * ```
  */
-/*@__NO_SIDE_EFFECTS__*/
 export declare function resolvePackageJsonEntryExports(entryExports: unknown): unknown;