@ls-stack/utils 3.36.0 → 3.37.0

package/dist/asyncQueue.cjs

@@ -61,10 +61,10 @@ var AsyncQueue = class {
     this.#signal = signal;
     this.#taskTimeout = taskTimeout;
     this.events.on("error", (e) => {
-      this.failures.push(e);
+      this.failures.push(e.payload);
     });
     this.events.on("complete", (e) => {
-      this.completions.push(e);
+      this.completions.push(e.payload);
     });
   }
   #enqueue(task) {

package/dist/asyncQueue.js

@@ -32,10 +32,10 @@ var AsyncQueue = class {
     this.#signal = signal;
     this.#taskTimeout = taskTimeout;
     this.events.on("error", (e) => {
-      this.failures.push(e);
+      this.failures.push(e.payload);
     });
     this.events.on("complete", (e) => {
-      this.completions.push(e);
+      this.completions.push(e.payload);
     });
   }
   #enqueue(task) {

package/dist/testUtils.cjs

@@ -1347,6 +1347,7 @@ function compactSnapshot(value, {
   maxLineLength = 100,
   showUndefined = false,
   showBooleansAs = true,
+  replaceValues,
   rejectKeys,
   filterKeys,
   sortKeys,
@@ -1364,6 +1365,9 @@ function compactSnapshot(value, {
       });
     }
   }
+  if (replaceValues) {
+    processedValue = applyValueReplacements(processedValue, replaceValues);
+  }
   processedValue = showBooleansAs ? replaceBooleansWithEmoji(processedValue, showBooleansAs) : processedValue;
   return `
 ${yamlStringify(processedValue, {
@@ -1373,6 +1377,46 @@ ${yamlStringify(processedValue, {
     ...options
   })}`;
 }
+function applyValueReplacements(value, replaceValues, visited = /* @__PURE__ */ new Set(), currentPath = "") {
+  function processValue(val, path) {
+    const replacement = replaceValues(val, path);
+    if (replacement !== false) {
+      return replacement.newValue;
+    }
+    if (Array.isArray(val)) {
+      if (visited.has(val)) {
+        throw new Error("Circular reference detected in array");
+      }
+      visited.add(val);
+      try {
+        return val.map((item, index) => {
+          const itemPath = path ? `${path}[${index}]` : `[${index}]`;
+          return processValue(item, itemPath);
+        });
+      } finally {
+        visited.delete(val);
+      }
+    }
+    if (isPlainObject(val)) {
+      if (visited.has(val)) {
+        throw new Error("Circular reference detected in object");
+      }
+      visited.add(val);
+      try {
+        const result = {};
+        for (const [key, itemValue] of Object.entries(val)) {
+          const itemPath = path ? `${path}.${key}` : key;
+          result[key] = processValue(itemValue, itemPath);
+        }
+        return result;
+      } finally {
+        visited.delete(val);
+      }
+    }
+    return val;
+  }
+  return processValue(value, currentPath);
+}
 function replaceBooleansWithEmoji(value, showBooleansAs, visited = /* @__PURE__ */ new Set()) {
   if (showBooleansAs === false) {
     return value;

package/dist/testUtils.d.cts

@@ -88,11 +88,12 @@ declare function waitController(): {
  * @param options.rejectKeys - The keys to reject.
  * @param options.filterKeys - The keys to filter.
  * @param options.ignoreProps - The props to ignore.
+ * @param options.replaceValues - Function to replace values at specific paths. Returns `false` to keep original value or `{newValue}` to replace.
  * @param options.sortKeys - Sort all keys by a specific order (default: `simpleValuesFirst`).
  * @param options.sortPatterns - Sort specific keys by pattern. Use to control the order of specific properties. The same patterns as `filterKeys` are supported.
  * @returns The compact snapshot of the value.
  */
-declare function compactSnapshot(value: unknown, { collapseObjects, maxLineLength, showUndefined, showBooleansAs, rejectKeys, filterKeys, sortKeys, sortPatterns, ...options }?: YamlStringifyOptions & {
+declare function compactSnapshot(value: unknown, { collapseObjects, maxLineLength, showUndefined, showBooleansAs, replaceValues, rejectKeys, filterKeys, sortKeys, sortPatterns, ...options }?: YamlStringifyOptions & {
     showBooleansAs?: boolean | {
         props?: Record<string, {
             trueText?: string;
@@ -102,6 +103,9 @@ declare function compactSnapshot(value: unknown, { collapseObjects, maxLineLengt
         trueText?: string;
         falseText?: string;
     };
+    replaceValues?: (value: unknown, path: string) => false | {
+        newValue: unknown;
+    };
     rejectKeys?: string[] | string;
     filterKeys?: string[] | string;
     sortKeys?: 'asc' | 'desc' | 'simpleValuesFirst' | false;

package/dist/testUtils.d.ts

@@ -88,11 +88,12 @@ declare function waitController(): {
  * @param options.rejectKeys - The keys to reject.
  * @param options.filterKeys - The keys to filter.
  * @param options.ignoreProps - The props to ignore.
+ * @param options.replaceValues - Function to replace values at specific paths. Returns `false` to keep original value or `{newValue}` to replace.
  * @param options.sortKeys - Sort all keys by a specific order (default: `simpleValuesFirst`).
  * @param options.sortPatterns - Sort specific keys by pattern. Use to control the order of specific properties. The same patterns as `filterKeys` are supported.
  * @returns The compact snapshot of the value.
  */
-declare function compactSnapshot(value: unknown, { collapseObjects, maxLineLength, showUndefined, showBooleansAs, rejectKeys, filterKeys, sortKeys, sortPatterns, ...options }?: YamlStringifyOptions & {
+declare function compactSnapshot(value: unknown, { collapseObjects, maxLineLength, showUndefined, showBooleansAs, replaceValues, rejectKeys, filterKeys, sortKeys, sortPatterns, ...options }?: YamlStringifyOptions & {
     showBooleansAs?: boolean | {
         props?: Record<string, {
             trueText?: string;
@@ -102,6 +103,9 @@ declare function compactSnapshot(value: unknown, { collapseObjects, maxLineLengt
         trueText?: string;
         falseText?: string;
     };
+    replaceValues?: (value: unknown, path: string) => false | {
+        newValue: unknown;
+    };
     rejectKeys?: string[] | string;
     filterKeys?: string[] | string;
     sortKeys?: 'asc' | 'desc' | 'simpleValuesFirst' | false;

package/dist/testUtils.js

@@ -261,6 +261,7 @@ function compactSnapshot(value, {
   maxLineLength = 100,
   showUndefined = false,
   showBooleansAs = true,
+  replaceValues,
   rejectKeys,
   filterKeys,
   sortKeys,
@@ -278,6 +279,9 @@ function compactSnapshot(value, {
       });
     }
   }
+  if (replaceValues) {
+    processedValue = applyValueReplacements(processedValue, replaceValues);
+  }
   processedValue = showBooleansAs ? replaceBooleansWithEmoji(processedValue, showBooleansAs) : processedValue;
   return `
 ${yamlStringify(processedValue, {
@@ -287,6 +291,46 @@ ${yamlStringify(processedValue, {
     ...options
   })}`;
 }
+function applyValueReplacements(value, replaceValues, visited = /* @__PURE__ */ new Set(), currentPath = "") {
+  function processValue(val, path) {
+    const replacement = replaceValues(val, path);
+    if (replacement !== false) {
+      return replacement.newValue;
+    }
+    if (Array.isArray(val)) {
+      if (visited.has(val)) {
+        throw new Error("Circular reference detected in array");
+      }
+      visited.add(val);
+      try {
+        return val.map((item, index) => {
+          const itemPath = path ? `${path}[${index}]` : `[${index}]`;
+          return processValue(item, itemPath);
+        });
+      } finally {
+        visited.delete(val);
+      }
+    }
+    if (isPlainObject(val)) {
+      if (visited.has(val)) {
+        throw new Error("Circular reference detected in object");
+      }
+      visited.add(val);
+      try {
+        const result = {};
+        for (const [key, itemValue] of Object.entries(val)) {
+          const itemPath = path ? `${path}.${key}` : key;
+          result[key] = processValue(itemValue, itemPath);
+        }
+        return result;
+      } finally {
+        visited.delete(val);
+      }
+    }
+    return val;
+  }
+  return processValue(value, currentPath);
+}
 function replaceBooleansWithEmoji(value, showBooleansAs, visited = /* @__PURE__ */ new Set()) {
   if (showBooleansAs === false) {
     return value;

package/docs/testUtils.md

@@ -14,7 +14,7 @@
 function compactSnapshot(value, options): string;
 ```
 
-Defined in: [packages/utils/src/testUtils.ts:363](https://github.com/lucasols/utils/blob/main/packages/utils/src/testUtils.ts#L363)
+Defined in: [packages/utils/src/testUtils.ts:364](https://github.com/lucasols/utils/blob/main/packages/utils/src/testUtils.ts#L364)
 
 Produces a more compact and readable snapshot of a value using yaml.
 By default booleans are shown as `✅` and `❌`, use `showBooleansAs` to disable/configure this.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Universal TypeScript utilities for browser and Node.js",
-  "version": "3.36.0",
+  "version": "3.37.0",
   "license": "MIT",
   "files": [
     "dist",
@@ -222,7 +222,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.18.0",
-    "@ls-stack/extended-lint": "^0.20.1",
+    "@ls-stack/extended-lint": "^0.67.2",
     "@types/eslint": "^9.6.1",
     "@types/eslint__js": "^8.42.3",
     "@types/node": "^22.10.9",
@@ -247,7 +247,7 @@
     "vitest": "^3.0.4"
   },
   "dependencies": {
-    "evtmitter": "^0.3.3",
+    "evtmitter": "^1.0.2",
     "t-result": "^0.3.0"
   },
   "scripts": {