@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/cacache/clear.js

@@ -1,77 +1,84 @@
 "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 clear_exports = {};
-__export(clear_exports, {
-  clear: () => clear,
-  createPatternMatcher: () => createPatternMatcher
-});
-module.exports = __toCommonJS(clear_exports);
-var import_socket = require("../paths/socket");
-var import_regexp = require("../primordials/regexp");
-var import_string = require("../primordials/string");
-var import_internal = require("./_internal");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_string = require('../primordials/string.js');
+const require_primordials_regexp = require('../primordials/regexp.js');
+const require_paths_socket = require('../paths/socket.js');
+const require_cacache__internal = require('./_internal.js');
+
+//#region src/cacache/clear.ts
+/**
+* @file Bulk-clear entries from the Socket shared cacache — `clear()` plus its
+*   wildcard helper `createPatternMatcher`. The helper is exported because
+*   callers occasionally compose their own filtering pipelines.
+*/
+/**
+* Clear entries from the Socket shared cache.
+*
+* Supports wildcard patterns (*) in prefix for flexible matching. For simple
+* prefixes without wildcards, uses efficient streaming. For wildcard patterns,
+* iterates and matches each entry.
+*
+* @example
+*   // Clear all entries
+*   await clear()
+*
+* @example
+*   // Clear entries with simple prefix
+*   const removed = await clear({ prefix: 'socket-sdk:scans' })
+*   console.log(`Removed ${removed} scan cache entries`)
+*
+* @example
+*   // Clear entries with wildcard pattern
+*   await clear({ prefix: 'socket-sdk:scans:abc*' })
+*   await clear({ prefix: 'socket-sdk:npm/lodash/*' })
+*
+* @param options - Optional configuration for selective clearing.
+* @param options.prefix - Prefix or pattern to match (supports * wildcards)
+*
+* @returns Number of entries removed (only when prefix is specified)
+*/
 async function clear(options) {
-  const opts = { __proto__: null, ...options };
-  const cacache = (0, import_internal.getCacache)();
-  const cacheDir = (0, import_socket.getSocketCacacheDir)();
-  if (!opts.prefix) {
-    try {
-      await cacache.rm.all(cacheDir);
-      return;
-    } catch (e) {
-      if (e?.code !== "ENOTEMPTY") {
-        throw e;
-      }
-      return;
-    }
-  }
-  let removed = 0;
-  const matches = createPatternMatcher(opts.prefix);
-  const stream = cacache.ls.stream(cacheDir);
-  for await (const entry of stream) {
-    if (matches(entry.key)) {
-      try {
-        await cacache.rm.entry(cacheDir, entry.key);
-        removed++;
-      } catch {
-      }
-    }
-  }
-  return removed;
+	const opts = {
+		__proto__: null,
+		...options
+	};
+	const cacache = require_cacache__internal.getCacache();
+	const cacheDir = require_paths_socket.getSocketCacacheDir();
+	if (!opts.prefix) try {
+		/* c8 ignore next - External cacache call */
+		await cacache.rm.all(cacheDir);
+		return;
+	} catch (e) {
+		if (e?.code !== "ENOTEMPTY") throw e;
+		return;
+	}
+	let removed = 0;
+	const matches = createPatternMatcher(opts.prefix);
+	/* c8 ignore next - External cacache call */
+	const stream = cacache.ls.stream(cacheDir);
+	for await (const entry of stream) if (matches(entry.key)) try {
+		/* c8 ignore next - External cacache call */
+		await cacache.rm.entry(cacheDir, entry.key);
+		removed++;
+	} catch {}
+	return removed;
 }
+/**
+* Build a key→boolean matcher for `pattern`. For non-wildcard patterns this
+* returns a prefix-startsWith predicate (no regex allocation); for wildcard
+* patterns it compiles the regex _once_ and closes over it so the caller can
+* apply the same matcher across N keys in O(1)-per-key.
+*
+* Anchors both ends — `foo*bar` matches exactly `foo<anything>bar`, not
+* `foo<anything>bar<more>`.
+*/
 function createPatternMatcher(pattern) {
-  if (!pattern.includes("*")) {
-    return (key) => (0, import_string.StringPrototypeStartsWith)(key, pattern);
-  }
-  const escaped = (0, import_string.StringPrototypeReplaceAll)(
-    pattern,
-    /[.+?^${}()|[\]\\]/g,
-    "\\$&"
-  );
-  const regexPattern = (0, import_string.StringPrototypeReplaceAll)(escaped, "*", ".*");
-  const regex = new import_regexp.RegExpCtor(`^${regexPattern}$`);
-  return (key) => (0, import_regexp.RegExpPrototypeTest)(regex, key);
+	if (!pattern.includes("*")) return (key) => require_primordials_string.StringPrototypeStartsWith(key, pattern);
+	const regex = new require_primordials_regexp.RegExpCtor(`^${require_primordials_string.StringPrototypeReplaceAll(require_primordials_string.StringPrototypeReplaceAll(pattern, /[.+?^${}()|[\]\\]/g, "\\$&"), "*", ".*")}$`);
+	return (key) => require_primordials_regexp.RegExpPrototypeTest(regex, key);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  clear,
-  createPatternMatcher
-});
+
+//#endregion
+exports.clear = clear;
+exports.createPatternMatcher = createPatternMatcher;

package/dist/cacache/read.js

@@ -1,51 +1,53 @@
 "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 read_exports = {};
-__export(read_exports, {
-  get: () => get,
-  safeGet: () => safeGet
-});
-module.exports = __toCommonJS(read_exports);
-var import_socket = require("../paths/socket");
-var import_error = require("../primordials/error");
-var import_string = require("../primordials/string");
-var import_internal = require("./_internal");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_error = require('../primordials/error.js');
+const require_primordials_string = require('../primordials/string.js');
+const require_paths_socket = require('../paths/socket.js');
+const require_cacache__internal = require('./_internal.js');
+
+//#region src/cacache/read.ts
+/**
+* @file Cache read entrypoints — `get` (throws on miss) and `safeGet` (returns
+*   `undefined` on miss). Both reject keys containing wildcards; bulk reads go
+*   through `clear` / `ls` patterns.
+*/
+/**
+* Get data from the Socket shared cache by key.
+*
+* @example
+*   ;```typescript
+*   const entry = await get('socket-sdk:scans:abc123')
+*   console.log(entry.data.toString('utf8'))
+*   ```
+*
+* @throws {Error} When cache entry is not found.
+* @throws {TypeError} If key contains wildcards (*)
+*/
 async function get(key, options) {
-  if ((0, import_string.StringPrototypeIncludes)(key, "*")) {
-    throw new import_error.TypeErrorCtor(
-      'Cache key cannot contain wildcards (*). Wildcards are only supported in clear({ prefix: "pattern*" }).'
-    );
-  }
-  const cacache = (0, import_internal.getCacache)();
-  return await cacache.get((0, import_socket.getSocketCacacheDir)(), key, options);
+	if (require_primordials_string.StringPrototypeIncludes(key, "*")) throw new require_primordials_error.TypeErrorCtor("Cache key cannot contain wildcards (*). Wildcards are only supported in clear({ prefix: \"pattern*\" }).");
+	/* c8 ignore next - External cacache call */
+	return await require_cacache__internal.getCacache().get(require_paths_socket.getSocketCacacheDir(), key, options);
 }
+/**
+* Get data from the Socket shared cache by key without throwing.
+*
+* @example
+*   ;```typescript
+*   const entry = await safeGet('socket-sdk:scans:abc123')
+*   if (entry) {
+*     console.log(entry.data.toString('utf8'))
+*   }
+*   ```
+*/
 async function safeGet(key, options) {
-  try {
-    return await get(key, options);
-  } catch {
-    return void 0;
-  }
+	try {
+		return await get(key, options);
+	} catch {
+		return;
+	}
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  get,
-  safeGet
-});
+
+//#endregion
+exports.get = get;
+exports.safeGet = safeGet;

package/dist/cacache/tmp.js

@@ -1,39 +1,32 @@
 "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 tmp_exports = {};
-__export(tmp_exports, {
-  withTmp: () => withTmp
-});
-module.exports = __toCommonJS(tmp_exports);
-var import_socket = require("../paths/socket");
-var import_internal = require("./_internal");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_paths_socket = require('../paths/socket.js');
+const require_cacache__internal = require('./_internal.js');
+
+//#region src/cacache/tmp.ts
+/**
+* @file `withTmp` — run a callback with a freshly-created temp directory under
+*   the cacache root. Wraps cacache's `tmp.withTmp` with a corrected type
+*   signature (the DefinitelyTyped definition incorrectly declares `void` even
+*   though the function forwards the callback's return value).
+*/
+/**
+* Execute a callback with a temporary directory for cache operations.
+*
+* @example
+*   ;```typescript
+*   const result = await withTmp(async tmpDir => {
+*     // Use tmpDir for temporary cache work
+*     return 'done'
+*   })
+*   ```
+*/
 async function withTmp(callback) {
-  const cacache = (0, import_internal.getCacache)();
-  return await cacache.tmp.withTmp(
-    (0, import_socket.getSocketCacacheDir)(),
-    {},
-    callback
-  );
+	/* c8 ignore start - External cacache call */
+	return await require_cacache__internal.getCacache().tmp.withTmp(require_paths_socket.getSocketCacacheDir(), {}, callback);
+	/* c8 ignore stop */
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  withTmp
-});
+
+//#endregion
+exports.withTmp = withTmp;

package/dist/cacache/types.js

@@ -1,18 +1,2 @@
 "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 __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 = {};
-module.exports = __toCommonJS(types_exports);
+/* Socket Lib - Built with rolldown */

package/dist/cacache/write.js

@@ -1,53 +1,48 @@
 "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 write_exports = {};
-__export(write_exports, {
-  put: () => put,
-  remove: () => remove
-});
-module.exports = __toCommonJS(write_exports);
-var import_socket = require("../paths/socket");
-var import_error = require("../primordials/error");
-var import_string = require("../primordials/string");
-var import_internal = require("./_internal");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_error = require('../primordials/error.js');
+const require_primordials_string = require('../primordials/string.js');
+const require_paths_socket = require('../paths/socket.js');
+const require_cacache__internal = require('./_internal.js');
+
+//#region src/cacache/write.ts
+/**
+* @file Cache write entrypoints — `put` (insert/replace by key) and `remove`
+*   (single-key delete). Both reject wildcards; for pattern deletes use
+*   `clear({ prefix: 'foo*' })`.
+*/
+/**
+* Put data into the Socket shared cache with a key.
+*
+* @example
+*   ;```typescript
+*   await put('socket-sdk:scans:abc123', Buffer.from('result data'))
+*   ```
+*
+* @throws {TypeError} If key contains wildcards (*)
+*/
 async function put(key, data, options) {
-  if ((0, import_string.StringPrototypeIncludes)(key, "*")) {
-    throw new import_error.TypeErrorCtor(
-      'Cache key cannot contain wildcards (*). Wildcards are only supported in clear({ prefix: "pattern*" }).'
-    );
-  }
-  const cacache = (0, import_internal.getCacache)();
-  return await cacache.put((0, import_socket.getSocketCacacheDir)(), key, data, options);
+	if (require_primordials_string.StringPrototypeIncludes(key, "*")) throw new require_primordials_error.TypeErrorCtor("Cache key cannot contain wildcards (*). Wildcards are only supported in clear({ prefix: \"pattern*\" }).");
+	/* c8 ignore next - External cacache call */
+	return await require_cacache__internal.getCacache().put(require_paths_socket.getSocketCacacheDir(), key, data, options);
 }
+/**
+* Remove an entry from the Socket shared cache by key.
+*
+* @example
+*   ;```typescript
+*   await remove('socket-sdk:scans:abc123')
+*   ```
+*
+* @throws {TypeError} If key contains wildcards (*)
+*/
 async function remove(key) {
-  if ((0, import_string.StringPrototypeIncludes)(key, "*")) {
-    throw new import_error.TypeErrorCtor(
-      'Cache key cannot contain wildcards (*). Use clear({ prefix: "pattern*" }) to remove multiple entries.'
-    );
-  }
-  const cacache = (0, import_internal.getCacache)();
-  return await cacache.rm.entry((0, import_socket.getSocketCacacheDir)(), key);
+	if (require_primordials_string.StringPrototypeIncludes(key, "*")) throw new require_primordials_error.TypeErrorCtor("Cache key cannot contain wildcards (*). Use clear({ prefix: \"pattern*\" }) to remove multiple entries.");
+	/* c8 ignore next - External cacache call */
+	return await require_cacache__internal.getCacache().rm.entry(require_paths_socket.getSocketCacacheDir(), key);
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  put,
-  remove
-});
+
+//#endregion
+exports.put = put;
+exports.remove = remove;