@socketsecurity/lib 6.0.2 → 6.0.4

package/dist/fs/validate.js

@@ -1,46 +1,59 @@
 "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 validate_exports = {};
-__export(validate_exports, {
-  validateFiles: () => validateFiles
-});
-module.exports = __toCommonJS(validate_exports);
-var import_fs = require("../node/fs");
-// @__NO_SIDE_EFFECTS__
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_fs_access = require('./access.js');
+
+//#region src/fs/validate.ts
+/**
+* @file Pre-flight readability check for file lists. Used to filter out paths
+*   that exist in glob results but cannot be opened — Yarn Berry PnP virtual
+*   filesystem entries, pnpm symlinks pointing into a missing
+*   content-addressable store, or filesystem races during CI runs.
+*/
+/**
+* Validate that file paths are readable before processing. Filters out files
+* from glob results that cannot be accessed (common with Yarn Berry PnP virtual
+* filesystem, pnpm content-addressable store symlinks, or filesystem race
+* conditions in CI/CD environments).
+*
+* This defensive pattern prevents ENOENT errors when files exist in glob
+* results but are not accessible via standard filesystem operations.
+*
+* @example
+*   ```ts
+*   import { validateFiles } from '@socketsecurity/lib/fs/validate'
+*
+*   const files = ['package.json', '.pnp.cjs/virtual-file.json']
+*   const { validPaths, invalidPaths } = validateFiles(files)
+*
+*   console.log(`Valid: ${validPaths.length}`)
+*   console.log(`Invalid: ${invalidPaths.length}`)
+*   ```
+*
+* @example
+*   ;```ts
+*   // Typical usage in Socket CLI commands
+*   const packagePaths = await getPackageFilesForScan(targets)
+*   const { validPaths } = validateFiles(packagePaths)
+*   await sdk.uploadManifestFiles(orgSlug, validPaths)
+*   ```
+*
+* @param filepaths - Array of file paths to validate.
+*
+* @returns Object with `validPaths` (readable) and `invalidPaths` (unreadable)
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function validateFiles(filepaths) {
-  const fs = (0, import_fs.getNodeFs)();
-  const validPaths = [];
-  const invalidPaths = [];
-  const { R_OK } = fs.constants;
-  for (const filepath of filepaths) {
-    try {
-      fs.accessSync(filepath, R_OK);
-      validPaths.push(filepath);
-    } catch {
-      invalidPaths.push(filepath);
-    }
-  }
-  return { __proto__: null, validPaths, invalidPaths };
+	const validPaths = [];
+	const invalidPaths = [];
+	for (const filepath of filepaths) if (/* @__PURE__ */ require_fs_access.canRead(filepath)) validPaths.push(filepath);
+	else invalidPaths.push(filepath);
+	return {
+		__proto__: null,
+		validPaths,
+		invalidPaths
+	};
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  validateFiles
-});
+
+//#endregion
+exports.validateFiles = validateFiles;

package/dist/fs/write-json.js

@@ -1,83 +1,117 @@
 "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_json_exports = {};
-__export(write_json_exports, {
-  stringify: () => stringify,
-  writeJson: () => writeJson,
-  writeJsonSync: () => writeJsonSync
-});
-module.exports = __toCommonJS(write_json_exports);
-var import_fs = require("../node/fs");
-var import_json = require("../primordials/json");
-var import_string = require("../primordials/string");
+/* Socket Lib - Built with rolldown */
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primordials_string = require('../primordials/string.js');
+const require_node_fs = require('../node/fs.js');
+const require_primordials_json = require('../primordials/json.js');
+
+//#region src/fs/write-json.ts
+/**
+* @file JSON writers that match the wire-format conventions a tool ecosystem
+*   expects: configurable indentation, configurable EOL, trailing newline by
+*   default. The `stringify` helper is exported so callers that already have an
+*   `fs` handle can render a buffer without round-tripping through this
+*   module's writers.
+*/
 const NEWLINE_REGEX = /\n/g;
-// @__NO_SIDE_EFFECTS__
+/**
+* Stringify JSON with custom formatting options. Formats JSON with configurable
+* line endings and indentation.
+*
+* @param json - Value to stringify.
+* @param EOL - End-of-line sequence.
+* @param finalEOL - Whether to add final newline.
+* @param replacer - JSON replacer function.
+* @param spaces - Indentation spaces or string.
+*
+* @returns Formatted JSON string
+*/
+/* @__NO_SIDE_EFFECTS__ */
 function stringify(json, EOL, finalEOL, replacer, spaces = 2) {
-  const EOF = finalEOL ? EOL : "";
-  const str = (0, import_json.JSONStringify)(json, replacer, spaces);
-  return `${(0, import_string.StringPrototypeReplace)(str, NEWLINE_REGEX, EOL)}${EOF}`;
+	const EOF = finalEOL ? EOL : "";
+	return `${require_primordials_string.StringPrototypeReplace(require_primordials_json.JSONStringify(json, replacer, spaces), NEWLINE_REGEX, EOL)}${EOF}`;
 }
+/**
+* Write JSON content to a file asynchronously with formatting. Stringifies the
+* value with configurable indentation and line endings. Automatically adds a
+* final newline by default for POSIX compliance.
+*
+* @example
+*   ;```ts
+*   // Write formatted JSON with default 2-space indentation
+*   await writeJson('./data.json', { name: 'example', version: '1.0.0' })
+*
+*   // Write with custom indentation
+*   await writeJson('./config.json', config, { spaces: 4 })
+*
+*   // Write with tabs instead of spaces
+*   await writeJson('./data.json', data, { spaces: '\t' })
+*
+*   // Write without final newline
+*   await writeJson('./inline.json', obj, { finalEOL: false })
+*
+*   // Write with Windows line endings
+*   await writeJson('./win.json', data, { EOL: '\r\n' })
+*   ```
+*
+* @param filepath - Path to write to.
+* @param jsonContent - Value to stringify and write.
+* @param options - Write options including formatting and encoding.
+*
+* @returns Promise that resolves when write completes
+*/
 async function writeJson(filepath, jsonContent, options) {
-  const opts = typeof options === "string" ? { encoding: options } : options;
-  const { EOL, finalEOL, replacer, spaces, ...fsOptions } = {
-    __proto__: null,
-    ...opts
-  };
-  const fs = (0, import_fs.getNodeFs)();
-  const jsonString = /* @__PURE__ */ stringify(
-    jsonContent,
-    EOL || "\n",
-    finalEOL !== void 0 ? finalEOL : true,
-    replacer,
-    spaces
-  );
-  await fs.promises.writeFile(filepath, jsonString, {
-    encoding: "utf8",
-    ...fsOptions,
-    __proto__: null
-  });
+	const { EOL, finalEOL, replacer, spaces, ...fsOptions } = {
+		__proto__: null,
+		...typeof options === "string" ? { encoding: options } : options
+	};
+	const fs = /* @__PURE__ */ require_node_fs.getNodeFs();
+	const jsonString = /* @__PURE__ */ stringify(jsonContent, EOL || "\n", finalEOL !== void 0 ? finalEOL : true, replacer, spaces);
+	await fs.promises.writeFile(filepath, jsonString, {
+		encoding: "utf8",
+		...fsOptions,
+		__proto__: null
+	});
 }
+/**
+* Write JSON content to a file synchronously with formatting. Stringifies the
+* value with configurable indentation and line endings. Automatically adds a
+* final newline by default for POSIX compliance.
+*
+* @example
+*   ;```ts
+*   // Write formatted JSON with default 2-space indentation
+*   writeJsonSync('./package.json', pkg)
+*
+*   // Write with custom indentation
+*   writeJsonSync('./tsconfig.json', tsconfig, { spaces: 4 })
+*
+*   // Write with tabs for indentation
+*   writeJsonSync('./data.json', data, { spaces: '\t' })
+*
+*   // Write compacted (no indentation)
+*   writeJsonSync('./compact.json', data, { spaces: 0 })
+*   ```
+*
+* @param filepath - Path to write to.
+* @param jsonContent - Value to stringify and write.
+* @param options - Write options including formatting and encoding.
+*/
 function writeJsonSync(filepath, jsonContent, options) {
-  const opts = typeof options === "string" ? { encoding: options } : options;
-  const { EOL, finalEOL, replacer, spaces, ...fsOptions } = {
-    __proto__: null,
-    ...opts
-  };
-  const fs = (0, import_fs.getNodeFs)();
-  const jsonString = /* @__PURE__ */ stringify(
-    jsonContent,
-    EOL || "\n",
-    finalEOL !== void 0 ? finalEOL : true,
-    replacer,
-    spaces
-  );
-  fs.writeFileSync(filepath, jsonString, {
-    encoding: "utf8",
-    ...fsOptions,
-    __proto__: null
-  });
+	const { EOL, finalEOL, replacer, spaces, ...fsOptions } = {
+		__proto__: null,
+		...typeof options === "string" ? { encoding: options } : options
+	};
+	const fs = /* @__PURE__ */ require_node_fs.getNodeFs();
+	const jsonString = /* @__PURE__ */ stringify(jsonContent, EOL || "\n", finalEOL !== void 0 ? finalEOL : true, replacer, spaces);
+	fs.writeFileSync(filepath, jsonString, {
+		encoding: "utf8",
+		...fsOptions,
+		__proto__: null
+	});
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  stringify,
-  writeJson,
-  writeJsonSync
-});
+
+//#endregion
+exports.stringify = stringify;
+exports.writeJson = writeJson;
+exports.writeJsonSync = writeJsonSync;