@socketsecurity/lib 5.27.0 → 6.0.0

package/dist/json/edit.js

@@ -30,79 +30,21 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var edit_exports = {};
 __export(edit_exports, {
-  getEditableJsonClass: () => getEditableJsonClass
+  getEditableJsonClass: () => getEditableJsonClass,
+  readFile: () => readFile,
+  retryWrite: () => retryWrite
 });
 module.exports = __toCommonJS(edit_exports);
 var import_node_process = __toESM(require("node:process"));
 var import_promises = require("node:timers/promises");
-var import_errors = require("../errors");
-var import_primordials = require("../primordials");
+var import_predicates = require("../errors/predicates");
+var import_fs = require("../node/fs");
+var import_error = require("../primordials/error");
+var import_json = require("../primordials/json");
 var import_format = require("./format");
 const identSymbol = import_format.INDENT_SYMBOL;
 const newlineSymbol = import_format.NEWLINE_SYMBOL;
-const JSONParse = JSON.parse;
 let _EditableJsonClass;
-let _fs;
-// @__NO_SIDE_EFFECTS__
-function getFs() {
-  if (_fs === void 0) {
-    _fs = require("node:fs");
-  }
-  return _fs;
-}
-function parseJson(content) {
-  return JSONParse(content);
-}
-async function readFile(filepath) {
-  const { promises: fsPromises } = /* @__PURE__ */ getFs();
-  const maxRetries = import_node_process.default.platform === "win32" ? 5 : 1;
-  for (let attempt = 0; attempt <= maxRetries; attempt++) {
-    try {
-      return await fsPromises.readFile(filepath, "utf8");
-    } catch (e) {
-      const isLastAttempt = attempt === maxRetries;
-      const isEnoent = (0, import_errors.isErrnoException)(e) && e.code === "ENOENT";
-      if (!isEnoent || isLastAttempt) {
-        throw e;
-      }
-      const delay = import_node_process.default.platform === "win32" ? 50 * (attempt + 1) : 20;
-      await (0, import_promises.setTimeout)(delay);
-    }
-  }
-  throw new import_primordials.ErrorCtor("Unreachable code");
-}
-async function retryWrite(filepath, content, retries = 3, baseDelay = 10) {
-  const fs = /* @__PURE__ */ getFs();
-  const { promises: fsPromises } = fs;
-  for (let attempt = 0; attempt <= retries; attempt++) {
-    try {
-      await fsPromises.writeFile(filepath, content);
-      if (import_node_process.default.platform === "win32") {
-        await (0, import_promises.setTimeout)(50);
-        let accessRetries = 0;
-        const maxAccessRetries = 5;
-        while (accessRetries < maxAccessRetries) {
-          if (fs.existsSync(filepath)) {
-            await (0, import_promises.setTimeout)(10);
-            break;
-          }
-          const delay = 20 * (accessRetries + 1);
-          await (0, import_promises.setTimeout)(delay);
-          accessRetries++;
-        }
-      }
-      return;
-    } catch (e) {
-      const isLastAttempt = attempt === retries;
-      const isRetriableError = (0, import_errors.isErrnoException)(e) && (e.code === "EPERM" || e.code === "EBUSY" || e.code === "ENOENT");
-      if (!isRetriableError || isLastAttempt) {
-        throw e;
-      }
-      const delay = baseDelay * 2 ** attempt;
-      await (0, import_promises.setTimeout)(delay);
-    }
-  }
-}
 // @__NO_SIDE_EFFECTS__
 function getEditableJsonClass() {
   if (_EditableJsonClass === void 0) {
@@ -125,12 +67,16 @@ function getEditableJsonClass() {
       get path() {
         return this._path;
       }
-      static async create(path, opts = {}) {
+      static async create(path, opts = {
+        __proto__: null
+      }) {
         const instance = new EditableJson();
         instance.create(path);
         return opts.data ? instance.update(opts.data) : instance;
       }
-      static async load(path, opts = {}) {
+      static async load(path, opts = {
+        __proto__: null
+      }) {
         const instance = new EditableJson();
         if (!opts.create) {
           return await instance.load(path);
@@ -138,7 +84,7 @@ function getEditableJsonClass() {
         try {
           return await instance.load(path);
         } catch (err) {
-          if (!err.message.includes("ENOENT") && !err.message.includes("no such file")) {
+          if (!(0, import_predicates.isErrnoException)(err) || err.code !== "ENOENT") {
             throw err;
           }
           return instance.create(path);
@@ -156,7 +102,7 @@ function getEditableJsonClass() {
         return this;
       }
       fromJSON(data) {
-        const parsed = parseJson(data);
+        const parsed = (0, import_json.JSONParse)(data);
         const indent = (0, import_format.detectIndent)(data);
         const newline = (0, import_format.detectNewline)(data);
         parsed[identSymbol] = indent;
@@ -164,34 +110,16 @@ function getEditableJsonClass() {
         this._content = parsed;
         return this;
       }
-      async load(path, create) {
+      async load(path) {
         this._path = path;
-        let parseErr;
-        try {
-          this._readFileContent = await readFile(this.filename);
-        } catch (e) {
-          if (!create) {
-            throw e;
-          }
-          parseErr = e;
-        }
-        if (parseErr) {
-          throw parseErr;
-        }
+        this._readFileContent = await readFile(this.filename);
         this.fromJSON(this._readFileContent);
-        this._readFileJson = parseJson(this._readFileContent);
-        return this;
-      }
-      update(content) {
-        this._content = {
-          ...this._content,
-          ...content
-        };
+        this._readFileJson = (0, import_json.JSONParse)(this._readFileContent);
         return this;
       }
       async save(options) {
         if (!this._canSave || this.content === void 0) {
-          throw new import_primordials.ErrorCtor("No file path to save to");
+          throw new import_error.ErrorCtor("No file path to save to");
         }
         if (!(0, import_format.shouldSave)(
           this.content,
@@ -211,12 +139,12 @@ function getEditableJsonClass() {
         const fileContent = (0, import_format.stringifyWithFormatting)(sortedContent, formatting);
         await retryWrite(this.filename, fileContent);
         this._readFileContent = fileContent;
-        this._readFileJson = parseJson(fileContent);
+        this._readFileJson = (0, import_json.JSONParse)(fileContent);
         return true;
       }
       saveSync(options) {
         if (!this._canSave || this.content === void 0) {
-          throw new import_primordials.ErrorCtor("No file path to save to");
+          throw new import_error.ErrorCtor("No file path to save to");
         }
         if (!(0, import_format.shouldSave)(
           this.content,
@@ -234,12 +162,19 @@ function getEditableJsonClass() {
           this.content
         );
         const fileContent = (0, import_format.stringifyWithFormatting)(sortedContent, formatting);
-        const fs = /* @__PURE__ */ getFs();
+        const fs = (0, import_fs.getNodeFs)();
         fs.writeFileSync(this.filename, fileContent);
         this._readFileContent = fileContent;
-        this._readFileJson = parseJson(fileContent);
+        this._readFileJson = (0, import_json.JSONParse)(fileContent);
         return true;
       }
+      update(content) {
+        this._content = {
+          ...this._content,
+          ...content
+        };
+        return this;
+      }
       willSave(options) {
         if (!this._canSave || this.content === void 0) {
           return false;
@@ -255,7 +190,61 @@ function getEditableJsonClass() {
   }
   return _EditableJsonClass;
 }
+async function readFile(filepath) {
+  const { promises: fsPromises } = (0, import_fs.getNodeFs)();
+  const maxRetries = import_node_process.default.platform === "win32" ? 5 : 1;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await fsPromises.readFile(filepath, "utf8");
+    } catch (e) {
+      const isLastAttempt = attempt === maxRetries;
+      const isEnoent = (0, import_predicates.isErrnoException)(e) && e.code === "ENOENT";
+      if (!isEnoent || isLastAttempt) {
+        throw e;
+      }
+      const delay = import_node_process.default.platform === "win32" ? 50 * (attempt + 1) : 20;
+      await (0, import_promises.setTimeout)(delay);
+    }
+  }
+  throw new import_error.ErrorCtor(
+    `readFile: exhausted ${maxRetries + 1} attempts reading ${filepath}`
+  );
+}
+async function retryWrite(filepath, content, retries = 3, baseDelay = 10) {
+  const fs = (0, import_fs.getNodeFs)();
+  const { promises: fsPromises } = fs;
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      await fsPromises.writeFile(filepath, content);
+      if (import_node_process.default.platform === "win32") {
+        await (0, import_promises.setTimeout)(50);
+        let accessRetries = 0;
+        const maxAccessRetries = 5;
+        while (accessRetries < maxAccessRetries) {
+          if (fs.existsSync(filepath)) {
+            await (0, import_promises.setTimeout)(10);
+            break;
+          }
+          const delay = 20 * (accessRetries + 1);
+          await (0, import_promises.setTimeout)(delay);
+          accessRetries++;
+        }
+      }
+      return;
+    } catch (e) {
+      const isLastAttempt = attempt === retries;
+      const isRetriableError = (0, import_predicates.isErrnoException)(e) && (e.code === "EPERM" || e.code === "EBUSY" || e.code === "ENOENT");
+      if (!isRetriableError || isLastAttempt) {
+        throw e;
+      }
+      const delay = baseDelay * 2 ** attempt;
+      await (0, import_promises.setTimeout)(delay);
+    }
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  getEditableJsonClass
+  getEditableJsonClass,
+  readFile,
+  retryWrite
 });

package/dist/json/format.d.ts

@@ -1,7 +1,7 @@
 /**
- * @fileoverview Shared utilities for JSON formatting preservation and manipulation.
- * Provides functions for detecting and preserving indentation, line endings, and
- * determining when JSON files should be saved based on content changes.
+ * @file Shared utilities for JSON formatting preservation and manipulation.
+ *   Provides functions for detecting and preserving indentation, line endings,
+ *   and determining when JSON files should be saved based on content changes.
  */
 /**
  * Symbols used to store formatting metadata in JSON objects.
@@ -24,135 +24,149 @@ export interface ShouldSaveOptions {
     sortFn?: ((obj: Record<string, unknown>) => Record<string, unknown>) | undefined;
 }
 /**
- * Detect indentation from a JSON string.
- * Supports space-based indentation (returns count) or mixed indentation (returns string).
- *
- * @param json - JSON string to analyze
- * @returns Number of spaces or indentation string, defaults to 2 if not detected
+ * Detect indentation from a JSON string. Supports space-based indentation
+ * (returns count) or mixed indentation (returns string).
  *
  * @example
- * ```ts
- * detectIndent('{\n  "key": "value"\n}')  // => 2
- * detectIndent('{\n    "key": "value"\n}')  // => 4
- * detectIndent('{\n\t"key": "value"\n}')  // => '\t'
- * ```
+ *   ;```ts
+ *   detectIndent('{\n  "key": "value"\n}') // => 2
+ *   detectIndent('{\n    "key": "value"\n}') // => 4
+ *   detectIndent('{\n\t"key": "value"\n}') // => '\t'
+ *   ```
+ *
+ * @param json - JSON string to analyze.
+ *
+ * @returns Number of spaces or indentation string, defaults to 2 if not
+ *   detected.
  */
 export declare function detectIndent(json: string): string | number;
 /**
- * Detect newline character(s) from a JSON string.
- * Supports LF (\n) and CRLF (\r\n) line endings.
- *
- * @param json - JSON string to analyze
- * @returns Line ending string ('\n' or '\r\n'), defaults to '\n' if not detected
+ * Detect newline character(s) from a JSON string. Supports LF (\n) and CRLF
+ * (\r\n) line endings.
  *
  * @example
- * ```ts
- * detectNewline('{\n  "key": "value"\n}')  // => '\n'
- * detectNewline('{\r\n  "key": "value"\r\n}')  // => '\r\n'
- * ```
+ *   ;```ts
+ *   detectNewline('{\n  "key": "value"\n}') // => '\n'
+ *   detectNewline('{\r\n  "key": "value"\r\n}') // => '\r\n'
+ *   ```
+ *
+ * @param json - JSON string to analyze.
+ *
+ * @returns Line ending string ('\n' or '\r\n'), defaults to '\n' if not
+ *   detected.
  */
 export declare function detectNewline(json: string): string;
 /**
  * Extract formatting metadata from a JSON string.
  *
- * @param json - JSON string to analyze
- * @returns Object containing indent and newline formatting
- *
  * @example
- * ```ts
- * const formatting = extractFormatting('{\n  "key": "value"\n}')
- * // => { indent: 2, newline: '\n' }
- * ```
+ *   ;```ts
+ *   const formatting = extractFormatting('{\n  "key": "value"\n}')
+ *   // => { indent: 2, newline: '\n' }
+ *   ```
+ *
+ * @param json - JSON string to analyze.
+ *
+ * @returns Object containing indent and newline formatting
  */
 export declare function extractFormatting(json: string): JsonFormatting;
 /**
  * Get default formatting for JSON files.
  *
- * @returns Default formatting (2 spaces, LF line endings)
- *
  * @example
- * ```typescript
- * const fmt = getDefaultFormatting()
- * // { indent: 2, newline: '\n' }
- * ```
+ *   ;```typescript
+ *   const fmt = getDefaultFormatting()
+ *   // { indent: 2, newline: '\n' }
+ *   ```
+ *
+ * @returns Default formatting (2 spaces, LF line endings)
  */
 export declare function getDefaultFormatting(): JsonFormatting;
 /**
  * Extract formatting from content object that has symbol-based metadata.
  *
- * @param content - Content object with Symbol.for('indent') and Symbol.for('newline')
- * @returns Formatting metadata, or defaults if symbols not present
- *
  * @example
- * ```typescript
- * const content = { [Symbol.for("indent")]: 4, [Symbol.for("newline")]: "\r\n" }
- * getFormattingFromContent(content)  // { indent: 4, newline: "\r\n" }
- * ```
+ *   ;```typescript
+ *   const content = {
+ *     [Symbol.for('indent')]: 4,
+ *     [Symbol.for('newline')]: '\r\n',
+ *   }
+ *   getFormattingFromContent(content) // { indent: 4, newline: "\r\n" }
+ *   ```
+ *
+ * @param content - Content object with Symbol.for('indent') and
+ *   Symbol.for('newline')
+ *
+ * @returns Formatting metadata, or defaults if symbols not present
  */
 export declare function getFormattingFromContent(content: Record<string | symbol, unknown>): JsonFormatting;
 /**
- * Determine if content should be saved based on changes and options.
- * Compares current content with original content and respects options like
+ * Determine if content should be saved based on changes and options. Compares
+ * current content with original content and respects options like
  * ignoreWhitespace and sort.
  *
- * @param currentContent - Current content object (may include formatting symbols)
- * @param originalContent - Original content for comparison (may include formatting symbols)
- * @param originalFileContent - Original file content as string (for whitespace comparison)
- * @param options - Options controlling save behavior
- * @returns true if content should be saved, false otherwise
- *
  * @example
- * ```ts
- * const current = { key: 'new-value', [Symbol.for('indent')]: 2 }
- * const original = { key: 'old-value', [Symbol.for('indent')]: 2 }
- * shouldSave(current, original, '{\n  "key": "old-value"\n}\n')
- * // => true
- * ```
+ *   ;```ts
+ *   const current = { key: 'new-value', [Symbol.for('indent')]: 2 }
+ *   const original = { key: 'old-value', [Symbol.for('indent')]: 2 }
+ *   shouldSave(current, original, '{\n  "key": "old-value"\n}\n')
+ *   // => true
+ *   ```
+ *
+ * @param currentContent - Current content object (may include formatting
+ *   symbols)
+ * @param originalContent - Original content for comparison (may include
+ *   formatting symbols)
+ * @param originalFileContent - Original file content as string (for whitespace
+ *   comparison)
+ * @param options - Options controlling save behavior.
+ *
+ * @returns True if content should be saved, false otherwise
  */
 export declare function shouldSave(currentContent: Record<string | symbol, unknown>, originalContent: Record<string | symbol, unknown> | undefined, originalFileContent: string, options?: ShouldSaveOptions): boolean;
 /**
- * Sort object keys alphabetically.
- * Creates a new object with sorted keys (does not mutate input).
- *
- * @param obj - Object to sort
- * @returns New object with alphabetically sorted keys
+ * Sort object keys alphabetically. Creates a new object with sorted keys (does
+ * not mutate input).
  *
  * @example
- * ```ts
- * sortKeys({ z: 3, a: 1, m: 2 })
- * // => { a: 1, m: 2, z: 3 }
- * ```
+ *   ;```ts
+ *   sortKeys({ z: 3, a: 1, m: 2 })
+ *   // => { a: 1, m: 2, z: 3 }
+ *   ```
+ *
+ * @param obj - Object to sort.
+ *
+ * @returns New object with alphabetically sorted keys
  */
 export declare function sortKeys(obj: Record<string, unknown>): Record<string, unknown>;
 /**
- * Stringify JSON with specific formatting.
- * Applies indentation and line ending preferences.
+ * Stringify JSON with specific formatting. Applies indentation and line ending
+ * preferences.
+ *
+ * @example
+ *   ;```ts
+ *   stringifyWithFormatting({ key: 'value' }, { indent: 4, newline: '\r\n' })
+ *   // => '{\r\n    "key": "value"\r\n}\r\n'
+ *   ```
  *
- * @param content - Object to stringify
+ * @param content - Object to stringify.
  * @param formatting - Formatting preferences (indent and newline)
- * @returns Formatted JSON string with trailing newline
  *
- * @example
- * ```ts
- * stringifyWithFormatting(
- *   { key: 'value' },
- *   { indent: 4, newline: '\r\n' }
- * )
- * // => '{\r\n    "key": "value"\r\n}\r\n'
- * ```
+ * @returns Formatted JSON string with trailing newline
  */
 export declare function stringifyWithFormatting(content: Record<string, unknown>, formatting: JsonFormatting): string;
 /**
- * Strip formatting symbols from content object.
- * Removes Symbol.for('indent') and Symbol.for('newline') from the object.
- *
- * @param content - Content object with potential symbol properties
- * @returns Object with symbols removed
+ * Strip formatting symbols from content object. Removes Symbol.for('indent')
+ * and Symbol.for('newline') from the object.
  *
  * @example
- * ```typescript
- * const obj = { key: "value", [Symbol.for("indent")]: 2 }
- * stripFormattingSymbols(obj)  // { key: "value" }
- * ```
+ *   ;```typescript
+ *   const obj = { key: 'value', [Symbol.for('indent')]: 2 }
+ *   stripFormattingSymbols(obj) // { key: "value" }
+ *   ```
+ *
+ * @param content - Content object with potential symbol properties.
+ *
+ * @returns Object with symbols removed
  */
 export declare function stripFormattingSymbols(content: Record<string | symbol, unknown>): Record<string, unknown>;

package/dist/json/format.js

@@ -33,7 +33,8 @@ __export(format_exports, {
   stripFormattingSymbols: () => stripFormattingSymbols
 });
 module.exports = __toCommonJS(format_exports);
-var import_primordials = require("../primordials");
+var import_json = require("../primordials/json");
+var import_object = require("../primordials/object");
 const INDENT_SYMBOL = Symbol.for("indent");
 const NEWLINE_SYMBOL = Symbol.for("newline");
 function detectIndent(json) {
@@ -86,7 +87,7 @@ function shouldSave(currentContent, originalContent, originalFileContent, option
 }
 function sortKeys(obj) {
   const sorted = { __proto__: null };
-  const keys = (0, import_primordials.ObjectKeys)(obj).sort();
+  const keys = (0, import_object.ObjectKeys)(obj).sort();
   for (const key of keys) {
     sorted[key] = obj[key];
   }
@@ -96,7 +97,7 @@ function stringifyWithFormatting(content, formatting) {
   const { indent, newline } = formatting;
   const format = indent === void 0 || indent === null ? "  " : indent;
   const eol = newline === void 0 || newline === null ? "\n" : newline;
-  return `${(0, import_primordials.JSONStringify)(content, void 0, format)}
+  return `${(0, import_json.JSONStringify)(content, void 0, format)}
 `.replace(/\n/g, eol);
 }
 function stripFormattingSymbols(content) {