@ls-stack/utils 3.23.0 → 3.24.1

package/lib/testUtils.d.ts

@@ -1,3 +1,5 @@
+import { YamlStringifyOptions } from './yamlStringify.js';
+
 declare function createLoggerStore({ filterKeys: defaultFilterKeys, rejectKeys: defaultRejectKeys, splitLongLines: defaultSplitLongLines, maxLineLengthBeforeSplit: defaultMaxLineLengthBeforeSplit, fromLastSnapshot: defaultFromLastSnapshot, arrays: defaultArrays, changesOnly: defaultChangesOnly, useEmojiForBooleans: defaultUseEmojiForBooleans, }?: {
     filterKeys?: string[];
     rejectKeys?: string[];
@@ -39,5 +41,69 @@ declare function waitController(): {
     stopWaiting: () => void;
     stopWaitingAfter: (ms: number) => void;
 };
+declare function compactSnapshot(value: unknown, { collapseObjects, maxLineLength, showUndefined, showBooleansAs, rejectKeys, filterKeys, ...options }?: YamlStringifyOptions & {
+    showBooleansAs?: boolean | {
+        props?: Record<string, {
+            trueText?: string;
+            falseText?: string;
+        } | true>;
+        ignoreProps?: string[];
+        trueText?: string;
+        falseText?: string;
+    };
+    /**
+     * Reject (exclude) keys from the snapshot using pattern matching.
+     *
+     * **Pattern Syntax:**
+     * - `'prop'` - Only root-level properties named 'prop'
+     * - `'prop.nested'` - Exact nested property paths like `obj.prop.nested`
+     * - `'*prop'` - Any property named exactly 'prop' at any level (root or nested)
+     * - `'*.prop'` - Any nested property named 'prop' (excludes root-level matches)
+     *
+     * **Examples:**
+     * ```typescript
+     * // Reject root-level 'secret' only
+     * rejectKeys: ['secret']
+     *
+     * // Reject nested 'password' properties only
+     * rejectKeys: ['*.password']
+     *
+     * // Reject any 'apiKey' property at any level
+     * rejectKeys: ['*apiKey']
+     *
+     * // Reject specific nested path
+     * rejectKeys: ['user.settings.theme']
+     * ```
+     */
+    rejectKeys?: string[] | string;
+    /**
+     * Filter (include only) keys that match the specified patterns.
+     *
+     * **Pattern Syntax:** (same as rejectKeys)
+     * - `'prop'` - Only root-level properties named 'prop'
+     * - `'prop.nested'` - Exact nested property paths like `obj.prop.nested`
+     * - `'*prop'` - Any property named exactly 'prop' at any level (root or nested)
+     * - `'*.prop'` - Any nested property named 'prop' (excludes root-level matches)
+     *
+     * **Examples:**
+     * ```typescript
+     * // Include only root-level 'user'
+     * filterKeys: ['user']
+     *
+     * // Include all 'name' properties at any level
+     * filterKeys: ['*name']
+     *
+     * // Include only nested 'id' properties
+     * filterKeys: ['*.id']
+     *
+     * // Include specific nested paths
+     * filterKeys: ['user.profile.email', 'settings.theme']
+     * ```
+     *
+     * **Note:** When filtering, parent paths are automatically included if needed
+     * to preserve the structure for nested matches.
+     */
+    filterKeys?: string[] | string;
+}): string;
 
-export { createLoggerStore, getResultFn, waitController };
+export { compactSnapshot, createLoggerStore, getResultFn, waitController };

package/lib/testUtils.js

@@ -1,7 +1,11 @@
+import {
+  yamlStringify
+} from "./chunk-JAPKLFIK.js";
 import {
   omit,
   pick
 } from "./chunk-GHAQOUA6.js";
+import "./chunk-IATIXMCE.js";
 import {
   deepEqual
 } from "./chunk-JQFUKJU5.js";
@@ -11,6 +15,7 @@ import {
 import {
   clampMin
 } from "./chunk-HTCYUMDR.js";
+import "./chunk-4REIIZQY.js";
 import {
   arrayWithPrevAndIndex,
   filterAndMap
@@ -18,7 +23,9 @@ import {
 import {
   isObject
 } from "./chunk-C2SVCIWE.js";
-import "./chunk-JF2MDHOJ.js";
+import {
+  isPlainObject
+} from "./chunk-JF2MDHOJ.js";
 
 // src/testUtils.ts
 function createLoggerStore({
@@ -246,7 +253,209 @@ function waitController() {
     }
   };
 }
+function matchesKeyPattern(fullPath, key, pattern, currentPath) {
+  if (fullPath === pattern) {
+    return true;
+  }
+  if (pattern.startsWith("*.")) {
+    const propName = pattern.slice(2);
+    return currentPath !== "" && key === propName;
+  }
+  if (pattern.startsWith("*") && !pattern.startsWith("*.")) {
+    const propName = pattern.slice(1);
+    return key === propName;
+  }
+  if (!pattern.includes("*")) {
+    return currentPath === "" && key === pattern;
+  }
+  return false;
+}
+function isParentOfPattern(path, pattern) {
+  if (pattern.includes("*")) {
+    const patternParts = pattern.split(".");
+    const pathParts = path.split(".");
+    if (pathParts.length >= patternParts.length) {
+      return false;
+    }
+    for (let i = 0; i < pathParts.length; i++) {
+      const pathPart = pathParts[i];
+      const patternPart = patternParts[i];
+      if (patternPart === "*") {
+        continue;
+      }
+      if (pathPart !== patternPart) {
+        return false;
+      }
+    }
+    return true;
+  } else {
+    return pattern.startsWith(`${path}.`);
+  }
+}
+function applyKeyFiltering(value, { rejectKeys, filterKeys }, currentPath = "", visited = /* @__PURE__ */ new Set()) {
+  if (!isPlainObject(value) && !Array.isArray(value)) {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    if (visited.has(value)) {
+      throw new Error(
+        "Circular reference detected in array during key filtering"
+      );
+    }
+    visited.add(value);
+    try {
+      return value.map(
+        (item, index) => applyKeyFiltering(
+          item,
+          { rejectKeys, filterKeys },
+          currentPath ? `${currentPath}[${index}]` : `[${index}]`,
+          visited
+        )
+      );
+    } finally {
+      visited.delete(value);
+    }
+  }
+  if (isPlainObject(value)) {
+    if (visited.has(value)) {
+      throw new Error(
+        "Circular reference detected in object during key filtering"
+      );
+    }
+    visited.add(value);
+    try {
+      const result = {};
+      for (const [key, itemValue] of Object.entries(value)) {
+        const fullPath = currentPath ? `${currentPath}.${key}` : key;
+        if (rejectKeys?.some(
+          (rejectPath) => matchesKeyPattern(fullPath, key, rejectPath, currentPath)
+        )) {
+          continue;
+        }
+        if (filterKeys) {
+          const exactMatch = filterKeys.some(
+            (filterPath) => matchesKeyPattern(fullPath, key, filterPath, currentPath)
+          );
+          const isParent = filterKeys.some(
+            (filterPath) => isParentOfPattern(fullPath, filterPath)
+          );
+          if (!exactMatch && !isParent) {
+            continue;
+          }
+          if (exactMatch) {
+            result[key] = applyKeyFiltering(
+              itemValue,
+              { rejectKeys },
+              fullPath,
+              visited
+            );
+          } else {
+            result[key] = applyKeyFiltering(
+              itemValue,
+              { rejectKeys, filterKeys },
+              fullPath,
+              visited
+            );
+          }
+        } else {
+          result[key] = applyKeyFiltering(
+            itemValue,
+            { rejectKeys, filterKeys },
+            fullPath,
+            visited
+          );
+        }
+      }
+      return result;
+    } finally {
+      visited.delete(value);
+    }
+  }
+  return value;
+}
+function compactSnapshot(value, {
+  collapseObjects = true,
+  maxLineLength = 100,
+  showUndefined = false,
+  showBooleansAs = true,
+  rejectKeys,
+  filterKeys,
+  ...options
+} = {}) {
+  let processedValue = value;
+  if (rejectKeys || filterKeys) {
+    processedValue = applyKeyFiltering(processedValue, {
+      rejectKeys: Array.isArray(rejectKeys) ? rejectKeys : rejectKeys ? [rejectKeys] : void 0,
+      filterKeys: Array.isArray(filterKeys) ? filterKeys : filterKeys ? [filterKeys] : void 0
+    });
+  }
+  processedValue = showBooleansAs ? replaceBooleansWithEmoji(processedValue, showBooleansAs) : processedValue;
+  return `
+${yamlStringify(processedValue, {
+    collapseObjects,
+    maxLineLength,
+    showUndefined,
+    ...options
+  })}`;
+}
+function replaceBooleansWithEmoji(value, showBooleansAs, visited = /* @__PURE__ */ new Set()) {
+  if (showBooleansAs === false) {
+    return value;
+  }
+  const defaultTrueText = "\u2705";
+  const defaultFalseText = "\u274C";
+  const config = typeof showBooleansAs === "boolean" ? { trueText: defaultTrueText, falseText: defaultFalseText } : {
+    trueText: showBooleansAs.trueText ?? defaultTrueText,
+    falseText: showBooleansAs.falseText ?? defaultFalseText,
+    props: showBooleansAs.props ?? {},
+    ignoreProps: showBooleansAs.ignoreProps ?? []
+  };
+  function processValue(val, propName) {
+    if (typeof val === "boolean") {
+      if (propName && config.ignoreProps?.includes(propName)) {
+        return val;
+      }
+      if (propName && config.props?.[propName]) {
+        const propConfig = config.props[propName];
+        if (propConfig === true) {
+          return val ? config.trueText : config.falseText;
+        }
+        return val ? propConfig.trueText ?? config.trueText : propConfig.falseText ?? config.falseText;
+      }
+      return val ? config.trueText : config.falseText;
+    }
+    if (Array.isArray(val)) {
+      if (visited.has(val)) {
+        throw new Error("Circular reference detected in array");
+      }
+      visited.add(val);
+      try {
+        return val.map((item) => processValue(item));
+      } 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)) {
+          result[key] = processValue(itemValue, key);
+        }
+        return result;
+      } finally {
+        visited.delete(val);
+      }
+    }
+    return val;
+  }
+  return processValue(value);
+}
 export {
+  compactSnapshot,
   createLoggerStore,
   getResultFn,
   waitController

package/lib/yamlStringify.cjs

@@ -24,26 +24,6 @@ __export(yamlStringify_exports, {
 });
 module.exports = __toCommonJS(yamlStringify_exports);
 
-// src/typeGuards.ts
-function isObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function isPlainObject(value) {
-  if (!value || typeof value !== "object") return false;
-  const proto = Object.getPrototypeOf(value);
-  if (proto === null) {
-    return true;
-  }
-  const Ctor = Object.hasOwnProperty.call(proto, "constructor") && proto.constructor;
-  if (Ctor === Object) return true;
-  const objectCtorString = Object.prototype.constructor.toString();
-  return typeof Ctor == "function" && Function.toString.call(Ctor) === objectCtorString;
-}
-
-// src/assertions.ts
-var isObject2 = isObject;
-var isPlainObject2 = isPlainObject;
-
 // src/conversions.ts
 function bytesToHumanReadable(bytes) {
   if (bytes < 1024) {
@@ -67,26 +47,80 @@ function truncateString(str, length, ellipsis = "\u2026") {
   return str.slice(0, length - 1) + ellipsis;
 }
 
+// src/typeGuards.ts
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPlainObject(value) {
+  if (!value || typeof value !== "object") return false;
+  const proto = Object.getPrototypeOf(value);
+  if (proto === null) {
+    return true;
+  }
+  const Ctor = Object.hasOwnProperty.call(proto, "constructor") && proto.constructor;
+  if (Ctor === Object) return true;
+  const objectCtorString = Object.prototype.constructor.toString();
+  return typeof Ctor == "function" && Function.toString.call(Ctor) === objectCtorString;
+}
+
 // src/yamlStringify.ts
 function yamlStringify(obj, {
   maxLineLength = 100,
   showUndefined,
   maxDepth = 50,
+  collapseObjects = false,
   addRootObjSpaces = "beforeAndAfter"
 } = {}) {
-  if (isObject2(obj) || Array.isArray(obj) || typeof obj === "function") {
-    return `${stringifyValue(obj, "", maxLineLength, !!showUndefined, maxDepth, 0, addRootObjSpaces)}
+  if (isObject(obj) || Array.isArray(obj) || typeof obj === "function") {
+    return `${stringifyValue(obj, "", maxLineLength, !!showUndefined, maxDepth, 0, collapseObjects, addRootObjSpaces)}
 `;
   }
   return JSON.stringify(obj) || "undefined";
 }
-function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, depth, addObjSpaces) {
+function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, depth, collapseObjects, addObjSpaces) {
   let result = "";
   const childIndent = `${indent}  `;
-  if (isPlainObject2(value)) {
+  if (isPlainObject(value)) {
     if (Object.keys(value).length === 0) {
       return "{}";
     }
+    if (collapseObjects && depth > 0) {
+      const entries = Object.entries(value).filter(
+        ([, val]) => val !== void 0 || showUndefined
+      );
+      const isSimpleObject = entries.every(
+        ([, val]) => {
+          if (typeof val === "string") {
+            return !val.includes("'") && !val.includes('"') && !val.includes("\\");
+          }
+          return typeof val === "number" || typeof val === "boolean" || val === null || val === void 0;
+        }
+      );
+      if (isSimpleObject && entries.length > 0) {
+        let line = "{ ";
+        line += entries.map(([key, val]) => {
+          let valueStr;
+          if (typeof val === "string") {
+            if (val.includes("'") && !val.includes('"')) {
+              valueStr = `"${val}"`;
+            } else if (val.includes('"') && !val.includes("'")) {
+              valueStr = `'${val}'`;
+            } else if (val.includes("'") && val.includes('"')) {
+              valueStr = `"${val.replace(/"/g, '\\"')}"`;
+            } else {
+              valueStr = `'${val}'`;
+            }
+          } else {
+            valueStr = String(val);
+          }
+          return `${key}: ${valueStr}`;
+        }).join(", ");
+        line += " }";
+        if (line.length <= maxLineLength) {
+          return line;
+        }
+      }
+    }
     let prevValue;
     let afterSpaceWasAdded = false;
     for (let [key, objVal] of Object.entries(value)) {
@@ -108,9 +142,22 @@ function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, d
         showUndefined,
         maxDepth,
         depth + 1,
+        collapseObjects,
         addObjSpaces
       );
-      if (!afterSpaceWasAdded && indent === "" && isObject2(objVal) && prevValue && (addObjSpaces === "before" || addObjSpaces === "beforeAndAfter")) {
+      const willBeCollapsed = isObject(objVal) && (Object.keys(objVal).length === 0 || collapseObjects && depth + 1 > 0 && Object.entries(objVal).filter(([, val]) => val !== void 0 || showUndefined).every(([, val]) => {
+        if (typeof val === "string") {
+          return !val.includes("'") && !val.includes('"') && !val.includes("\\");
+        }
+        return typeof val === "number" || typeof val === "boolean" || val === null || val === void 0;
+      }));
+      const prevWasCollapsed = prevValue && isObject(prevValue) && (Object.keys(prevValue).length === 0 || collapseObjects && depth + 1 > 0 && Object.entries(prevValue).filter(([, val]) => val !== void 0 || showUndefined).every(([, val]) => {
+        if (typeof val === "string") {
+          return !val.includes("'") && !val.includes('"') && !val.includes("\\");
+        }
+        return typeof val === "number" || typeof val === "boolean" || val === null || val === void 0;
+      }));
+      if (!afterSpaceWasAdded && indent === "" && isObject(objVal) && !willBeCollapsed && prevValue && !prevWasCollapsed && (addObjSpaces === "before" || addObjSpaces === "beforeAndAfter")) {
         result += "\n";
       }
       if (Array.isArray(objVal)) {
@@ -121,8 +168,9 @@ function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, d
           result += `${indent}${key}:
 `;
         }
-      } else if (isObject2(objVal)) {
-        if (Object.keys(objVal).length === 0) {
+      } else if (isObject(objVal)) {
+        const isCollapsedObject = valueString.startsWith("{") && !valueString.includes("\n");
+        if (Object.keys(objVal).length === 0 || isCollapsedObject) {
           result += `${indent}${key}: `;
         } else {
           result += `${indent}${key}:
@@ -134,7 +182,8 @@ function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, d
       result += valueString;
       result += "\n";
       if (indent === "") {
-        if (isObject2(objVal)) {
+        const isCollapsedObject = valueString.startsWith("{") && !valueString.includes("\n") && valueString.length > 2;
+        if (isObject(objVal) && !isCollapsedObject) {
           if (addObjSpaces === "after" || addObjSpaces === "beforeAndAfter") {
             result += "\n";
             afterSpaceWasAdded = true;
@@ -169,6 +218,7 @@ function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, d
           showUndefined,
           maxDepth,
           depth + 1,
+          collapseObjects,
           addObjSpaces
         );
       }).join(", ");
@@ -184,7 +234,7 @@ function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, d
           item = `{max depth reached}`;
         }
         result += `${indent}- `;
-        if (Array.isArray(item) || isObject2(item)) {
+        if (Array.isArray(item) || isObject(item)) {
           let arrayString = stringifyValue(
             item,
             childIndent,
@@ -192,6 +242,7 @@ function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, d
             showUndefined,
             maxDepth,
             depth + 1,
+            collapseObjects,
             addObjSpaces
           );
           arrayString = arrayString.trimStart();
@@ -204,6 +255,7 @@ function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, d
             showUndefined,
             maxDepth,
             depth + 1,
+            collapseObjects,
             addObjSpaces
           );
         }
@@ -257,13 +309,14 @@ ${indent}${line}
       showUndefined,
       maxDepth,
       depth + 1,
+      collapseObjects,
       addObjSpaces
     );
   }
   return JSON.stringify(value);
 }
 function normalizeValue(value) {
-  if (value === null || isPlainObject2(value) || Array.isArray(value)) {
+  if (value === null || isPlainObject(value) || Array.isArray(value)) {
     return null;
   }
   if (value instanceof Map) {

package/lib/yamlStringify.d.cts

@@ -1,8 +1,10 @@
-declare function yamlStringify(obj: unknown, { maxLineLength, showUndefined, maxDepth, addRootObjSpaces, }?: {
+type YamlStringifyOptions = {
     maxLineLength?: number;
     showUndefined?: boolean;
     maxDepth?: number;
+    collapseObjects?: boolean;
     addRootObjSpaces?: 'before' | 'after' | 'beforeAndAfter' | false;
-}): string;
+};
+declare function yamlStringify(obj: unknown, { maxLineLength, showUndefined, maxDepth, collapseObjects, addRootObjSpaces, }?: YamlStringifyOptions): string;
 
-export { yamlStringify };
+export { type YamlStringifyOptions, yamlStringify };

package/lib/yamlStringify.d.ts

@@ -1,8 +1,10 @@
-declare function yamlStringify(obj: unknown, { maxLineLength, showUndefined, maxDepth, addRootObjSpaces, }?: {
+type YamlStringifyOptions = {
     maxLineLength?: number;
     showUndefined?: boolean;
     maxDepth?: number;
+    collapseObjects?: boolean;
     addRootObjSpaces?: 'before' | 'after' | 'beforeAndAfter' | false;
-}): string;
+};
+declare function yamlStringify(obj: unknown, { maxLineLength, showUndefined, maxDepth, collapseObjects, addRootObjSpaces, }?: YamlStringifyOptions): string;
 
-export { yamlStringify };
+export { type YamlStringifyOptions, yamlStringify };