firestore-snapshot-utils/dist/internal/replaceTimestamps.js

**Utils for testing Firestore DB snapshots**

import { Timestamp } from 'firebase-admin/firestore';
/**
 * Replaces all Timestamp objects in a value with normalized string representations.
 * The normalized format is: /Timestamp 0000/ where the number represents the
 * timestamp's position in the provided sorted array.
 *
 * This function is idempotent - calling it multiple times with the same input
 * will always produce the same output, and it doesn't modify any input parameters.
 *
 * @param value - The value to process
 * @param sortedTimestamps - Array of timestamp values (from valueOf()) sorted chronologically
 * @returns A new value with timestamps replaced by their normalized representations
 */
export const replaceTimestamps = (value, sortedTimestamps) => {
    // Handle Timestamp objects
    if (value instanceof Timestamp) {
        const timeValue = value.valueOf();
        const index = sortedTimestamps.indexOf(timeValue);
        // Timestamp not found in sorted array
        if (index === -1) {
            throw new Error('Timestamp not found in sorted array');
        }
        // Format: /Timestamp 0000/ - zero-padded index in the sorted array
        return `/Timestamp ${index.toString().padStart(4, '0')}/`;
    }
    // Handle arrays - create a new array to avoid modifying the input
    if (Array.isArray(value)) {
        return value.map((item) => replaceTimestamps(item, sortedTimestamps));
    }
    // Handle objects (but not null) - create a new object to avoid modifying the input
    if (typeof value === 'object' && value !== null) {
        const result = {};
        for (const [key, val] of Object.entries(value)) {
            result[key] = replaceTimestamps(val, sortedTimestamps);
        }
        return result;
    }
    // For primitive values, return as is
    return value;
};