@cronn/lib-file-snapshots 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -24,13 +24,6 @@ interface SnapshotSerializerResult {
     fileExtension: string;
 }
 
-declare class CompositeSerializer implements SnapshotSerializer {
-    private readonly serializers;
-    constructor(serializers: SnapshotSerializer[]);
-    canSerialize(value: unknown): boolean;
-    serialize(value: unknown): SnapshotSerializerResult;
-}
-
 interface JsonSerializerOptions {
     /**
      * Serializes `undefined` properties in objects. By default, they are omitted.
@@ -38,14 +31,22 @@ interface JsonSerializerOptions {
      * @default false
      */
     includeUndefinedObjectProperties?: boolean;
+    /**
+     * Custom normalizers to apply before serialization
+     */
+    normalizers?: JsonNormalizer[];
+}
+type JsonNormalizer = (value: unknown, context: JsonNormalizerContext) => unknown;
+interface JsonNormalizerContext {
+    key?: string;
 }
 declare class JsonSerializer implements SnapshotSerializer {
     private readonly includeUndefinedObjectProperties;
+    private readonly normalizers;
     constructor(options?: JsonSerializerOptions);
     canSerialize(value: unknown): boolean;
     serialize(value: unknown): SnapshotSerializerResult;
     private normalizeValueRecursive;
-    private normalizeValue;
     private normalizeNumber;
     private normalizeArray;
     private normalizeObject;
@@ -54,9 +55,19 @@ declare class JsonSerializer implements SnapshotSerializer {
     private normalizeMap;
     private serializedValue;
     private assertKeyType;
+    private applyCustomNormalizers;
 }
 
+interface TextSerializerOptions {
+    /**
+     * Custom normalizers to apply before serialization
+     */
+    normalizers?: TextNormalizer[];
+}
+type TextNormalizer = (value: string) => string;
 declare class TextSerializer implements SnapshotSerializer {
+    private readonly normalizers;
+    constructor(options?: TextSerializerOptions);
     canSerialize(value: unknown): value is string;
     serialize(value: unknown): SnapshotSerializerResult;
     private normalizeValue;
@@ -117,4 +128,4 @@ declare class ValidationFileMatcher {
     private writeFileSnapshots;
 }
 
-export { CompositeSerializer, JsonSerializer, TextSerializer, ValidationFileMatcher };
+export { type JsonNormalizer, type JsonNormalizerContext, JsonSerializer, type SnapshotSerializer, type TextNormalizer, TextSerializer, ValidationFileMatcher };

package/dist/index.js

@@ -1,24 +1,3 @@
-// src/serializers/composite-serializer.ts
-var CompositeSerializer = class {
-  serializers;
-  constructor(serializers) {
-    this.serializers = serializers;
-  }
-  canSerialize(value) {
-    return this.serializers.some(
-      (serializer) => serializer.canSerialize(value)
-    );
-  }
-  serialize(value) {
-    for (const serializer of this.serializers) {
-      if (serializer.canSerialize(value)) {
-        return serializer.serialize(value);
-      }
-    }
-    throw new Error(`Missing serializer for value of type ${typeof value}.`);
-  }
-};
-
 // src/utils/guards.ts
 function isArray(value) {
   return Array.isArray(value);
@@ -37,56 +16,54 @@ function isPlainObject(value) {
 // src/serializers/json-serializer.ts
 var JsonSerializer = class {
   includeUndefinedObjectProperties;
+  normalizers;
   constructor(options = {}) {
     this.includeUndefinedObjectProperties = options.includeUndefinedObjectProperties ?? false;
+    this.normalizers = options.normalizers ?? [];
   }
   canSerialize(value) {
     return true;
   }
   serialize(value) {
-    const jsonValue = isPlainObject(value) || isArray(value) ? this.normalizeValueRecursive(value) : this.normalizeValue(value);
+    const jsonValue = this.normalizeValueRecursive(value);
     const serializedValue = JSON.stringify(jsonValue, void 0, 2);
     return {
       serializedValue,
       fileExtension: "json"
     };
   }
-  normalizeValueRecursive(value) {
-    if (isArray(value)) {
-      return this.normalizeArray(value);
-    }
-    if (isPlainObject(value)) {
-      return this.normalizePlainObject(value);
-    }
-    if (typeof value === "string" || typeof value === "boolean" || value === null) {
-      return value;
-    }
-    return this.normalizeValue(value);
-  }
-  normalizeValue(value) {
-    if (value === void 0) {
+  normalizeValueRecursive(value, context) {
+    const customValue = this.applyCustomNormalizers(value, context);
+    if (customValue === void 0) {
       return this.serializedValue("undefined");
     }
-    if (value === null || typeof value === "string" || typeof value === "boolean") {
-      return this.serializedValue(typeof value, { value });
+    if (customValue === null || typeof customValue === "string" || typeof customValue === "boolean") {
+      const isRoot = context === void 0;
+      return isRoot ? this.serializedValue(typeof customValue, {
+        value: customValue
+      }) : customValue;
     }
-    if (typeof value === "number") {
-      return this.normalizeNumber(value);
+    if (typeof customValue === "number") {
+      return this.normalizeNumber(customValue);
     }
-    if (typeof value === "bigint") {
-      return this.serializedValue("bigint", { value: value.toString() });
+    if (typeof customValue === "bigint") {
+      return this.serializedValue("bigint", {
+        value: customValue.toString()
+      });
     }
-    if (typeof value === "symbol") {
-      return this.serializedValue("symbol", { description: value.description });
+    if (typeof customValue === "symbol") {
+      return this.serializedValue("symbol", {
+        description: customValue.description
+      });
     }
-    if (typeof value === "function") {
-      return this.serializedValue("function", { name: value.name });
+    if (typeof customValue === "function") {
+      return this.serializedValue("function", { name: customValue.name });
     }
-    if (typeof value === "object") {
-      return this.normalizeObject(value);
+    if (typeof customValue === "object") {
+      return this.normalizeObject(customValue);
     }
     throw new Error(
-      `Missing JSON normalization for value of type ${typeof value}.`
+      `Missing JSON normalization for value of type ${typeof customValue}.`
     );
   }
   normalizeNumber(value) {
@@ -119,9 +96,17 @@ var JsonSerializer = class {
     }
   }
   normalizeArray(value) {
-    return value.map((item) => this.normalizeValueRecursive(item));
+    return value.map(
+      (item, index) => this.normalizeValueRecursive(item, { key: index.toString() })
+    );
   }
   normalizeObject(value) {
+    if (isArray(value)) {
+      return this.normalizeArray(value);
+    }
+    if (isPlainObject(value)) {
+      return this.normalizePlainObject(value);
+    }
     if (value instanceof Date) {
       return this.normalizeDate(value);
     }
@@ -156,7 +141,9 @@ var JsonSerializer = class {
         continue;
       }
       this.assertKeyType(key);
-      normalizedObject[key] = this.normalizeValueRecursive(propertyValue);
+      normalizedObject[key] = this.normalizeValueRecursive(propertyValue, {
+        key
+      });
     }
     return normalizedObject;
   }
@@ -178,10 +165,21 @@ var JsonSerializer = class {
       throw new Error(`Key of type ${typeof key} cannot be normalized.`);
     }
   }
+  applyCustomNormalizers(value, context = {}) {
+    let normalizedValue = value;
+    for (const normalizer of this.normalizers) {
+      normalizedValue = normalizer(normalizedValue, context);
+    }
+    return normalizedValue;
+  }
 };
 
 // src/serializers/text-serializer.ts
 var TextSerializer = class {
+  normalizers;
+  constructor(options = {}) {
+    this.normalizers = options.normalizers ?? [];
+  }
   canSerialize(value) {
     return typeof value === "string";
   }
@@ -197,7 +195,11 @@ var TextSerializer = class {
     };
   }
   normalizeValue(value) {
-    return value.trim();
+    let normalizedValue = value;
+    for (const normalizer of this.normalizers) {
+      normalizedValue = normalizer(normalizedValue);
+    }
+    return normalizedValue.trim();
   }
 };
 
@@ -288,7 +290,6 @@ does not match validation file '${validationFile}'`
   }
 };
 export {
-  CompositeSerializer,
   JsonSerializer,
   TextSerializer,
   ValidationFileMatcher

package/package.json

@@ -1,21 +1,21 @@
 {
   "name": "@cronn/lib-file-snapshots",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "The library agnostic core for testing file snapshots",
   "keywords": [
     "file snapshots"
   ],
   "bugs": {
-    "url": "https://github.com/cronn/vitest-file-snapshots/issues"
+    "url": "https://github.com/cronn/file-snapshots/issues"
   },
   "author": "cronn",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/cronn/vitest-file-snapshots.git",
+    "url": "https://github.com/cronn/file-snapshots.git",
     "directory": "packages/lib-file-snapshots"
   },
-  "homepage": "https://github.com/cronn/vitest-file-snapshots",
+  "homepage": "https://github.com/cronn/file-snapshots",
   "engines": {
     "node": ">=22",
     "pnpm": ">=10"
@@ -34,10 +34,10 @@
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
     "@types/node": "22.15.30",
-    "@vitest/coverage-istanbul": "3.2.3",
+    "@vitest/coverage-istanbul": "3.2.4",
     "tsup": "8.5.0",
     "typescript": "5.8.3",
-    "vitest": "3.2.3",
+    "vitest": "3.2.4",
     "@cronn/shared-configs": "0.0.0"
   },
   "scripts": {