@socketsecurity/lib 4.1.0 → 4.3.0

package/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.3.0](https://github.com/SocketDev/socket-lib/releases/tag/v4.3.0) - 2025-11-20
+
+### Added
+
+- **globs**: New `glob()` and `globSync()` wrapper functions for fast-glob
+  - Provides convenient wrappers around fast-glob with normalized options
+  - Maintains consistent API with existing glob functionality
+  - Export: `@socketsecurity/lib/globs`
+
 ## [4.1.0](https://github.com/SocketDev/socket-lib/releases/tag/v4.1.0) - 2025-11-17
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 [![Socket Badge](https://socket.dev/api/badge/npm/package/@socketsecurity/lib)](https://socket.dev/npm/package/@socketsecurity/lib)
 [![CI](https://github.com/SocketDev/socket-lib/actions/workflows/ci.yml/badge.svg)](https://github.com/SocketDev/socket-lib/actions/workflows/ci.yml)
-![Coverage](https://img.shields.io/badge/coverage-83.95%25-brightgreen)
+![Coverage](https://img.shields.io/badge/coverage-84.12%25-brightgreen)
 
 [![Follow @SocketSecurity](https://img.shields.io/twitter/follow/SocketSecurity?style=social)](https://twitter.com/SocketSecurity)
 [![Follow @socket.dev on Bluesky](https://img.shields.io/badge/Follow-@socket.dev-1DA1F2?style=social&logo=bluesky)](https://bsky.app/profile/socket.dev)

package/dist/constants/process.d.ts

@@ -1,7 +1,2 @@
-/**
- * Process control: abort signals and UI utilities.
- */
-import type { Spinner } from '../spinner';
 export declare function getAbortController(): AbortController;
 export declare function getAbortSignal(): AbortSignal;
-export declare function getSpinner(): Spinner | null;

package/dist/constants/process.js

@@ -20,11 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var process_exports = {};
 __export(process_exports, {
   getAbortController: () => getAbortController,
-  getAbortSignal: () => getAbortSignal,
-  getSpinner: () => getSpinner
+  getAbortSignal: () => getAbortSignal
 });
 module.exports = __toCommonJS(process_exports);
-var import_spinner = require("../spinner");
 let _abortController;
 function getAbortController() {
   if (_abortController === void 0) {
@@ -35,16 +33,8 @@ function getAbortController() {
 function getAbortSignal() {
   return getAbortController().signal;
 }
-let _spinner;
-function getSpinner() {
-  if (_spinner === void 0) {
-    _spinner = (0, import_spinner.Spinner)() ?? null;
-  }
-  return _spinner ?? null;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getAbortController,
-  getAbortSignal,
-  getSpinner
+  getAbortSignal
 });

package/dist/debug.js

@@ -43,16 +43,16 @@ __export(debug_exports, {
   isDebugNs: () => isDebugNs
 });
 module.exports = __toCommonJS(debug_exports);
-var import_process = require("./constants/process");
 var import_debug = require("./env/debug");
 var import_socket = require("./env/socket");
 var import_is_unicode_supported = __toESM(require("./external/@socketregistry/is-unicode-supported"));
 var import_debug2 = __toESM(require("./external/debug"));
 var import_logger = require("./logger");
 var import_objects = require("./objects");
+var import_spinner = require("./spinner");
 var import_strings = require("./strings");
-const logger = (0, import_logger.getDefaultLogger)();
 const ReflectApply = Reflect.apply;
+const logger = (0, import_logger.getDefaultLogger)();
 const debugByNamespace = /* @__PURE__ */ new Map();
 // @__NO_SIDE_EFFECTS__
 function getDebugJsInstance(namespace) {
@@ -176,7 +176,7 @@ function debugDirNs(namespacesOrOpts, obj, inspectOpts) {
       };
     }
   }
-  const spinnerInstance = options.spinner || (0, import_process.getSpinner)();
+  const spinnerInstance = options.spinner || (0, import_spinner.getDefaultSpinner)();
   const wasSpinning = spinnerInstance?.isSpinning;
   spinnerInstance?.stop();
   logger.info(`[DEBUG] ${callerName} ${pointingTriangle} object inspection:`);
@@ -205,7 +205,7 @@ function debugNs(namespacesOrOpts, ...args) {
     ),
     ...args.slice(1)
   ] : args;
-  const spinnerInstance = options.spinner || (0, import_process.getSpinner)();
+  const spinnerInstance = options.spinner || (0, import_spinner.getDefaultSpinner)();
   const wasSpinning = spinnerInstance?.isSpinning;
   spinnerInstance?.stop();
   ReflectApply(logger.info, logger, logArgs);
@@ -232,7 +232,7 @@ function debugLogNs(namespacesOrOpts, ...args) {
     ),
     ...args.slice(1)
   ] : [`[DEBUG] ${callerName} ${pointingTriangle}`, ...args];
-  const spinnerInstance = options.spinner || (0, import_process.getSpinner)();
+  const spinnerInstance = options.spinner || (0, import_spinner.getDefaultSpinner)();
   const wasSpinning = spinnerInstance?.isSpinning;
   spinnerInstance?.stop();
   ReflectApply(logger.info, logger, logArgs);
@@ -253,7 +253,7 @@ function debugCacheNs(namespacesOrOpts, operation, key, meta) {
   }
   const prefix = `[CACHE] ${callerName} ${pointingTriangle} ${operation}: ${key}`;
   const logArgs = meta !== void 0 ? [prefix, meta] : [prefix];
-  const spinnerInstance = options.spinner || (0, import_process.getSpinner)();
+  const spinnerInstance = options.spinner || (0, import_spinner.getDefaultSpinner)();
   const wasSpinning = spinnerInstance?.isSpinning;
   spinnerInstance?.stop();
   ReflectApply(logger.info, logger, logArgs);

package/dist/external/fast-glob.js

@@ -5723,7 +5723,11 @@ var require_out4 = __commonJS({
 
 // src/external/fast-glob.js
 var fastGlob = require_out4();
-module.exports = fastGlob.globStream ? { globStream: fastGlob.globStream } : fastGlob;
+module.exports = fastGlob.globStream ? {
+  glob: fastGlob,
+  globStream: fastGlob.globStream,
+  globSync: fastGlob.sync
+} : fastGlob;
 /*! Bundled license information:
 
 is-extglob/index.js:

package/dist/globs.d.ts

@@ -44,3 +44,15 @@ export declare function getGlobMatcher(glob: Pattern | Pattern[], options?: {
     nocase?: boolean;
     ignore?: string[];
 }): (path: string) => boolean;
+/**
+ * Asynchronously find files matching glob patterns.
+ * Wrapper around fast-glob.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function glob(patterns: Pattern | Pattern[], options?: FastGlobOptions): Promise<string[]>;
+/**
+ * Synchronously find files matching glob patterns.
+ * Wrapper around fast-glob.sync.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function globSync(patterns: Pattern | Pattern[], options?: FastGlobOptions): string[];

package/dist/globs.js

@@ -31,7 +31,9 @@ var globs_exports = {};
 __export(globs_exports, {
   defaultIgnore: () => defaultIgnore,
   getGlobMatcher: () => getGlobMatcher,
-  globStreamLicenses: () => globStreamLicenses
+  glob: () => glob,
+  globStreamLicenses: () => globStreamLicenses,
+  globSync: () => globSync
 });
 module.exports = __toCommonJS(globs_exports);
 var fastGlob = __toESM(require("./external/fast-glob.js"));
@@ -107,8 +109,8 @@ function globStreamLicenses(dirname, options) {
 }
 const matcherCache = /* @__PURE__ */ new Map();
 // @__NO_SIDE_EFFECTS__
-function getGlobMatcher(glob, options) {
-  const patterns = Array.isArray(glob) ? glob : [glob];
+function getGlobMatcher(glob2, options) {
+  const patterns = Array.isArray(glob2) ? glob2 : [glob2];
   const key = JSON.stringify({ patterns, options });
   let matcher = matcherCache.get(key);
   if (matcher) {
@@ -129,9 +131,19 @@ function getGlobMatcher(glob, options) {
   matcherCache.set(key, matcher);
   return matcher;
 }
+// @__NO_SIDE_EFFECTS__
+function glob(patterns, options) {
+  return fastGlob.glob(patterns, options);
+}
+// @__NO_SIDE_EFFECTS__
+function globSync(patterns, options) {
+  return fastGlob.globSync(patterns, options);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   defaultIgnore,
   getGlobMatcher,
-  globStreamLicenses
+  glob,
+  globStreamLicenses,
+  globSync
 });

package/dist/package-default-node-range.d.ts

@@ -1,2 +1,3 @@
+/* c8 ignore next - External semver call */
 declare const packageDefaultNodeRange: string;
 export { packageDefaultNodeRange };

package/dist/package-extensions.js

@@ -36,6 +36,7 @@ var yarnPkgExtensions = __toESM(require("./external/@yarnpkg/extensions.js"));
 const { freeze: ObjectFreeze } = Object;
 const packageExtensions = ObjectFreeze(
   [
+    /* c8 ignore next - External @yarnpkg/extensions data */
     ...yarnPkgExtensions.packageExtensions,
     [
       "@yarnpkg/extensions@>=1.1.0",

package/dist/spawn.d.ts

@@ -1,3 +1,4 @@
+import type { EventEmitter } from 'node:events';
 // Define BufferEncoding type for TypeScript compatibility.
 type BufferEncoding = globalThis.BufferEncoding;
 /**
@@ -31,7 +32,7 @@ export type PromiseSpawnOptions = {
  * This is a Promise that resolves with process exit information and output,
  * with additional properties for accessing the running process and stdin stream.
  *
- * @property {ChildProcessType} process - The running child process instance
+ * @property {ChildProcess} process - The running child process instance
  * @property {WritableStreamType | null} stdin - Writable stream for process stdin, or `null` if not piped
  *
  * @example
@@ -48,7 +49,7 @@ export type PromiseSpawnResult = Promise<{
     stdout: string | Buffer;
     stderr: string | Buffer;
 }> & {
-    process: ChildProcessType;
+    process: ChildProcess;
     stdin: WritableStreamType | null;
 };
 /**
@@ -218,7 +219,7 @@ interface NodeSpawnOptions {
 }
 // Duplicated from Node.js child_process.ChildProcess
 // This represents a spawned child process
-interface ChildProcessType {
+interface ChildProcess extends EventEmitter {
     stdin: NodeJS.WritableStream | null;
     stdout: NodeJS.ReadableStream | null;
     stderr: NodeJS.ReadableStream | null;

package/dist/spawn.js

@@ -42,9 +42,10 @@ var import_arrays = require("./arrays");
 var import_bin = require("./bin");
 var import_normalize = require("./paths/normalize");
 var import_objects = require("./objects");
+var import_spinner = require("./spinner");
 var import_strings = require("./strings");
 const abortSignal = (0, import_process.getAbortSignal)();
-const spinner = (0, import_process.getSpinner)();
+const spinner = (0, import_spinner.getDefaultSpinner)();
 const windowsScriptExtRegExp = /\.(?:cmd|bat|ps1)$/i;
 let _child_process;
 // @__NO_SIDE_EFFECTS__

package/dist/stdio/prompts.js

@@ -48,12 +48,13 @@ var import_input = __toESM(require("../external/@inquirer/input"));
 var import_password = __toESM(require("../external/@inquirer/password"));
 var searchModule = __toESM(require("../external/@inquirer/search"));
 var selectModuleImport = __toESM(require("../external/@inquirer/select"));
+var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
+var import_spinner = require("../spinner");
 var import_context = require("../themes/context");
 var import_themes = require("../themes/themes");
 var import_utils = require("../themes/utils");
-var import_yoctocolors_cjs = __toESM(require("../external/yoctocolors-cjs"));
 const abortSignal = (0, import_process.getAbortSignal)();
-const spinner = (0, import_process.getSpinner)();
+const spinner = (0, import_spinner.getDefaultSpinner)();
 const searchRaw = searchModule.default;
 const selectModule = selectModuleImport;
 const selectRaw = selectModule.default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socketsecurity/lib",
-  "version": "4.1.0",
+  "version": "4.3.0",
   "packageManager": "pnpm@10.22.0",
   "license": "MIT",
   "description": "Core utilities and infrastructure for Socket.dev security tools",
@@ -690,7 +690,7 @@
     "@socketregistry/is-unicode-supported": "1.0.5",
     "@socketregistry/packageurl-js": "1.3.5",
     "@socketregistry/yocto-spinner": "1.0.25",
-    "@socketsecurity/lib-stable": "npm:@socketsecurity/lib@4.0.1",
+    "@socketsecurity/lib-stable": "npm:@socketsecurity/lib@4.1.0",
     "@types/node": "24.9.2",
     "@typescript/native-preview": "7.0.0-dev.20250920.1",
     "@vitest/coverage-v8": "4.0.3",