@socketsecurity/lib 3.2.8 → 3.3.1

package/dist/external/@inquirer/confirm.js

@@ -3202,3 +3202,4 @@ var require_commonjs4 = __commonJS({
 
 // src/external/@inquirer/confirm.js
 module.exports = require_commonjs4();
+if (module.exports && module.exports.default && Object.keys(module.exports).length === 1) { module.exports = module.exports.default; }

package/dist/external/@inquirer/input.js

@@ -3226,3 +3226,4 @@ var require_commonjs4 = __commonJS({
 
 // src/external/@inquirer/input.js
 module.exports = require_commonjs4();
+if (module.exports && module.exports.default && Object.keys(module.exports).length === 1) { module.exports = module.exports.default; }

package/dist/external/@inquirer/password.js

@@ -3334,3 +3334,4 @@ var require_commonjs4 = __commonJS({
 
 // src/external/@inquirer/password.js
 module.exports = require_commonjs4();
+if (module.exports && module.exports.default && Object.keys(module.exports).length === 1) { module.exports = module.exports.default; }

package/dist/external/@inquirer/search.js

@@ -3331,3 +3331,4 @@ ${theme.style.description(selectedChoice.description)}` : ``;
 
 // src/external/@inquirer/search.js
 module.exports = require_commonjs4();
+if (module.exports && module.exports.default && Object.keys(module.exports).length === 1) { module.exports = module.exports.default; }

package/dist/external/@inquirer/select.js

@@ -3448,3 +3448,4 @@ ${page}${helpTipBottom}${choiceDescription}${ansi_escapes_1.default.cursorHide}`
 
 // src/external/@inquirer/select.js
 module.exports = require_commonjs4();
+if (module.exports && module.exports.default && Object.keys(module.exports).length === 1) { module.exports = module.exports.default; }

package/dist/fs.js

@@ -48,7 +48,7 @@ __export(fs_exports, {
   writeJsonSync: () => writeJsonSync
 });
 module.exports = __toCommonJS(fs_exports);
-var import_process = require("./constants/process");
+var import_process = require("#constants/process");
 var import_arrays = require("./arrays");
 var import_globs = require("./globs");
 var import_json = require("./json");
@@ -429,7 +429,7 @@ function getAllowedDirectories() {
       getOsTmpDir,
       getSocketCacacheDir,
       getSocketUserDir
-    } = require("./paths");
+    } = require("#lib/paths");
     _cachedAllowedDirs = [
       path.resolve(getOsTmpDir()),
       path.resolve(getSocketCacacheDir()),
@@ -444,8 +444,7 @@ function invalidatePathCache() {
 (0, import_rewire.registerCacheInvalidation)(invalidatePathCache);
 // @__NO_SIDE_EFFECTS__
 async function safeDelete(filepath, options) {
-  const del = require("./external/del");
-  const { deleteAsync } = del;
+  const { deleteAsync } = require("./external/del");
   const opts = { __proto__: null, ...options };
   const patterns = (0, import_arrays.isArray)(filepath) ? filepath.map(import_path.pathLikeToString) : [(0, import_path.pathLikeToString)(filepath)];
   let shouldForce = opts.force !== false;
@@ -477,8 +476,7 @@ async function safeDelete(filepath, options) {
 }
 // @__NO_SIDE_EFFECTS__
 function safeDeleteSync(filepath, options) {
-  const del = require("./external/del");
-  const { deleteSync } = del;
+  const { deleteSync } = require("./external/del");
   const opts = { __proto__: null, ...options };
   const patterns = (0, import_arrays.isArray)(filepath) ? filepath.map(import_path.pathLikeToString) : [(0, import_path.pathLikeToString)(filepath)];
   let shouldForce = opts.force !== false;

package/dist/git.js

@@ -45,7 +45,7 @@ __export(git_exports, {
 });
 module.exports = __toCommonJS(git_exports);
 var import_path = __toESM(require("path"));
-var import_platform = require("./constants/platform");
+var import_platform = require("#constants/platform");
 var import_debug = require("./debug");
 var import_globs = require("./globs");
 var import_path2 = require("./path");

package/dist/github.js

@@ -31,8 +31,8 @@ __export(github_exports, {
 });
 module.exports = __toCommonJS(github_exports);
 var import_cache_with_ttl = require("./cache-with-ttl");
-var import_github = require("./env/github");
-var import_socket_cli = require("./env/socket-cli");
+var import_github = require("#env/github");
+var import_socket_cli = require("#env/socket-cli");
 var import_http_request = require("./http-request");
 var import_spawn = require("./spawn");
 const GITHUB_API_BASE_URL = "https://api.github.com";

package/dist/globs.js

@@ -77,8 +77,7 @@ let _fastGlob;
 // @__NO_SIDE_EFFECTS__
 function getFastGlob() {
   if (_fastGlob === void 0) {
-    const globExport = require("./external/fast-glob");
-    _fastGlob = "default" in globExport ? globExport.default : globExport;
+    _fastGlob = require("./external/fast-glob");
   }
   return _fastGlob;
 }
@@ -97,14 +96,14 @@ function globStreamLicenses(dirname, options) {
   if (ignoreOriginals) {
     const { LICENSE_ORIGINAL_GLOB_RECURSIVE } = (
       /*@__INLINE__*/
-      require("./constants/paths")
+      require("#constants/paths")
     );
     ignore.push(LICENSE_ORIGINAL_GLOB_RECURSIVE);
   }
   const fastGlob = /* @__PURE__ */ getFastGlob();
   const paths = (
     /*@__INLINE__*/
-    require("./constants/paths")
+    require("#constants/paths")
   );
   return fastGlob.globStream(
     [recursive ? paths.LICENSE_GLOB_RECURSIVE : paths.LICENSE_GLOB],

package/dist/lifecycle-script-names.d.ts

@@ -1,2 +1,8 @@
-declare const _default: Set<string>;
-export default _default;
+/**
+ * @fileoverview NPM lifecycle script names.
+ *
+ * Standard npm lifecycle hooks that can be defined in package.json scripts.
+ * https://docs.npmjs.com/cli/v10/using-npm/scripts#life-cycle-scripts
+ */
+declare const lifecycleScriptNames: Set<string>;
+export { lifecycleScriptNames };

package/dist/lifecycle-script-names.js

@@ -18,8 +18,11 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var lifecycle_script_names_exports = {};
-/* module.exports will be set at end of file */
-var lifecycle_script_names_default = new Set(
+__export(lifecycle_script_names_exports, {
+  lifecycleScriptNames: () => lifecycleScriptNames
+});
+module.exports = __toCommonJS(lifecycle_script_names_exports);
+const lifecycleScriptNames = new Set(
   [
     "dependencies",
     "prepublishOnly",
@@ -35,5 +38,7 @@ var lifecycle_script_names_default = new Set(
     ].map((n) => [`pre${n}`, n, `post${n}`])
   ].flat()
 );
-
-module.exports = lifecycle_script_names_default;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  lifecycleScriptNames
+});

package/dist/logger.d.ts

@@ -13,6 +13,7 @@
  * console.log(`${LOG_SYMBOLS.warn} Warning message`)
  * console.log(`${LOG_SYMBOLS.info} Information message`)
  * console.log(`${LOG_SYMBOLS.step} Processing step`)
+ * console.log(`${LOG_SYMBOLS.reason} Working through logic`)
  * ```
  */
 type LogSymbols = {
@@ -20,6 +21,8 @@ type LogSymbols = {
     fail: string;
     /** Blue colored information symbol (ℹ or i in ASCII) */
     info: string;
+    /** Dimmed yellow reasoning/working symbol (∴ or :. in ASCII) */
+    reason: string;
     /** Cyan colored step symbol (→ or > in ASCII) */
     step: string;
     /** Green colored success symbol (✔ or √ in ASCII) */
@@ -62,9 +65,9 @@ export type { LogSymbols, LoggerMethods, Task };
 /**
  * Log symbols for terminal output with colored indicators.
  *
- * Provides colored Unicode symbols (✔, ✖, ⚠, ℹ, →) with ASCII fallbacks (√, ×, ‼, i, >)
+ * Provides colored Unicode symbols (✖, ℹ, ∴, →, ✔, ⚠) with ASCII fallbacks (×, i, :., >, √, ‼)
  * for terminals that don't support Unicode. Symbols are colored according to the active
- * theme's color palette (success, error, warning, info, step).
+ * theme's color palette (error, info, reason, step, success, warning).
  *
  * The symbols are lazily initialized on first access and automatically update when the
  * fallback theme changes (via setTheme()). Note that LOG_SYMBOLS reflect the global
@@ -74,11 +77,12 @@ export type { LogSymbols, LoggerMethods, Task };
  * ```typescript
  * import { LOG_SYMBOLS } from '@socketsecurity/lib'
  *
- * console.log(`${LOG_SYMBOLS.success} Build completed`)    // Theme success color ✔
  * console.log(`${LOG_SYMBOLS.fail} Build failed`)          // Theme error color ✖
- * console.log(`${LOG_SYMBOLS.warn} Deprecated API used`)   // Theme warning color ⚠
  * console.log(`${LOG_SYMBOLS.info} Starting process`)      // Theme info color ℹ
+ * console.log(`${LOG_SYMBOLS.reason} Analyzing dependencies`) // Dimmed yellow ∴
  * console.log(`${LOG_SYMBOLS.step} Processing files`)      // Theme step color →
+ * console.log(`${LOG_SYMBOLS.success} Build completed`)    // Theme success color ✔
+ * console.log(`${LOG_SYMBOLS.warn} Deprecated API used`)   // Theme warning color ⚠
  * ```
  */
 export declare const LOG_SYMBOLS: Record<string, string>;
@@ -288,6 +292,35 @@ export declare class Logger {
      * ```
      */
     assert(value: unknown, ...message: unknown[]): this;
+    /**
+     * Clears the current line in the terminal.
+     *
+     * Moves the cursor to the beginning of the line and clears all content.
+     * Works in both TTY and non-TTY environments. Useful for clearing
+     * progress indicators created with `progress()`.
+     *
+     * The stream to clear (stderr or stdout) depends on whether the logger
+     * is stream-bound.
+     *
+     * @returns The logger instance for chaining
+     *
+     * @example
+     * ```typescript
+     * logger.progress('Loading...')
+     * // ... do work ...
+     * logger.clearLine()
+     * logger.success('Loaded')
+     *
+     * // Clear multiple progress updates
+     * for (const file of files) {
+     *   logger.progress(`Processing ${file}`)
+     *   processFile(file)
+     *   logger.clearLine()
+     * }
+     * logger.success('All files processed')
+     * ```
+     */
+    clearLine(): this;
     /**
      * Clears the visible terminal screen.
      *
@@ -413,6 +446,28 @@ export declare class Logger {
      * ```
      */
     dirxml(...data: unknown[]): this;
+    /**
+     * Logs a completion message with a success symbol (alias for `success()`).
+     *
+     * Provides semantic clarity when marking something as "done". Does NOT
+     * automatically clear the current line - call `clearLine()` first if
+     * needed after using `progress()`.
+     *
+     * @param args - Message and additional arguments to log
+     * @returns The logger instance for chaining
+     *
+     * @example
+     * ```typescript
+     * logger.done('Task completed')
+     *
+     * // After progress indicator
+     * logger.progress('Processing...')
+     * // ... do work ...
+     * logger.clearLine()
+     * logger.done('Processing complete')
+     * ```
+     */
+    done(...args: unknown[]): this;
     /**
      * Logs an error message to stderr.
      *
@@ -614,6 +669,53 @@ export declare class Logger {
      * ```
      */
     logNewline(): this;
+    /**
+     * Shows a progress indicator that can be cleared with `clearLine()`.
+     *
+     * Displays a simple status message with a '∴' prefix. Does not include
+     * animation or spinner. Intended to be cleared once the operation completes.
+     * The output stream (stderr or stdout) depends on whether the logger is
+     * stream-bound.
+     *
+     * @param text - The progress message to display
+     * @returns The logger instance for chaining
+     *
+     * @example
+     * ```typescript
+     * logger.progress('Processing files...')
+     * // ... do work ...
+     * logger.clearLine()
+     * logger.success('Files processed')
+     *
+     * // Stream-specific progress
+     * logger.stdout.progress('Loading...')
+     * // ... do work ...
+     * logger.stdout.clearLine()
+     * logger.stdout.log('Done')
+     * ```
+     */
+    progress(text: string): this;
+    /**
+     * Logs a reasoning/working message with a dimmed yellow therefore symbol.
+     *
+     * Automatically prefixes the message with `LOG_SYMBOLS.reason` (dimmed yellow ∴).
+     * Useful for showing intermediate reasoning, logic steps, or "working" output
+     * that leads to a conclusion. Always outputs to stderr. If the message starts
+     * with an existing symbol, it will be stripped and replaced.
+     *
+     * @param args - Message and additional arguments to log
+     * @returns The logger instance for chaining
+     *
+     * @example
+     * ```typescript
+     * logger.step('Analyzing package security')
+     * logger.reason('Found 3 direct dependencies')
+     * logger.reason('Checking 47 transitive dependencies')
+     * logger.reason('Risk score: 8.5/10')
+     * logger.fail('Package blocked due to high risk')
+     * ```
+     */
+    reason(...args: unknown[]): this;
     /**
      * Resets all indentation to zero.
      *
@@ -706,28 +808,6 @@ export declare class Logger {
      * ```
      */
     success(...args: unknown[]): this;
-    /**
-     * Logs a completion message with a success symbol (alias for `success()`).
-     *
-     * Provides semantic clarity when marking something as "done". Does NOT
-     * automatically clear the current line - call `clearLine()` first if
-     * needed after using `progress()`.
-     *
-     * @param args - Message and additional arguments to log
-     * @returns The logger instance for chaining
-     *
-     * @example
-     * ```typescript
-     * logger.done('Task completed')
-     *
-     * // After progress indicator
-     * logger.progress('Processing...')
-     * // ... do work ...
-     * logger.clearLine()
-     * logger.done('Processing complete')
-     * ```
-     */
-    done(...args: unknown[]): this;
     /**
      * Displays data in a table format.
      *
@@ -893,61 +973,6 @@ export declare class Logger {
      * ```
      */
     write(text: string): this;
-    /**
-     * Shows a progress indicator that can be cleared with `clearLine()`.
-     *
-     * Displays a simple status message with a '∴' prefix. Does not include
-     * animation or spinner. Intended to be cleared once the operation completes.
-     * The output stream (stderr or stdout) depends on whether the logger is
-     * stream-bound.
-     *
-     * @param text - The progress message to display
-     * @returns The logger instance for chaining
-     *
-     * @example
-     * ```typescript
-     * logger.progress('Processing files...')
-     * // ... do work ...
-     * logger.clearLine()
-     * logger.success('Files processed')
-     *
-     * // Stream-specific progress
-     * logger.stdout.progress('Loading...')
-     * // ... do work ...
-     * logger.stdout.clearLine()
-     * logger.stdout.log('Done')
-     * ```
-     */
-    progress(text: string): this;
-    /**
-     * Clears the current line in the terminal.
-     *
-     * Moves the cursor to the beginning of the line and clears all content.
-     * Works in both TTY and non-TTY environments. Useful for clearing
-     * progress indicators created with `progress()`.
-     *
-     * The stream to clear (stderr or stdout) depends on whether the logger
-     * is stream-bound.
-     *
-     * @returns The logger instance for chaining
-     *
-     * @example
-     * ```typescript
-     * logger.progress('Loading...')
-     * // ... do work ...
-     * logger.clearLine()
-     * logger.success('Loaded')
-     *
-     * // Clear multiple progress updates
-     * for (const file of files) {
-     *   logger.progress(`Processing ${file}`)
-     *   processFile(file)
-     *   logger.clearLine()
-     * }
-     * logger.success('All files processed')
-     * ```
-     */
-    clearLine(): this;
 }
 /**
  * Get the default logger instance.