@blackcode_sa/metaestetics-api 1.6.14 → 1.6.16

package/src/utils/TimestampUtils.ts

@@ -1,22 +1,62 @@
 import * as admin from "firebase-admin";
 import { Timestamp as ClientTimestamp } from "firebase/firestore";
 
+/**
+ * Detect if we're running in a server environment (like Cloud Functions)
+ * or compiled for server usage
+ */
+const IS_SERVER_ENV =
+  process.env.NODE_ENV === "production" ||
+  process.env.FUNCTIONS_EMULATOR === "true" ||
+  process.env.FIREBASE_CONFIG !== undefined;
+
 /**
  * Utilities for managing timestamps across client and server-side Firebase code.
  * This module provides conversion functions to ensure timestamp compatibility
  * between admin and client Firebase SDKs.
  */
 export class TimestampUtils {
+  /**
+   * Flag to force server mode where admin timestamps are preserved
+   * This should be true in Cloud Functions environments
+   */
+  private static serverMode = IS_SERVER_ENV;
+
+  /**
+   * Enables server mode where admin timestamps are preserved when saving
+   * to Firestore via the admin SDK
+   */
+  static enableServerMode(): void {
+    this.serverMode = true;
+  }
+
+  /**
+   * Disables server mode - use this only for client-side or mixed environments
+   */
+  static disableServerMode(): void {
+    this.serverMode = false;
+  }
+
   /**
    * Converts an admin Firestore Timestamp to a client Firestore Timestamp
+   * In server mode, returns the original admin timestamp for storage consistency
+   *
    * @param adminTimestamp - Admin SDK Timestamp (from firebase-admin)
-   * @returns A client SDK Timestamp (from firebase/firestore) with same seconds/nanoseconds or null if input is null
+   * @returns A client SDK Timestamp (from firebase/firestore) with same seconds/nanoseconds,
+   *          or the original admin timestamp in server mode,
+   *          or null if input is null
    */
   static adminToClient(
     adminTimestamp: admin.firestore.Timestamp | null
-  ): ClientTimestamp | null {
+  ): ClientTimestamp | admin.firestore.Timestamp | null {
     if (!adminTimestamp) return null;
 
+    // In server mode (Cloud Functions), just return the admin timestamp
+    if (this.serverMode) {
+      return adminTimestamp;
+    }
+
+    // In client mode, convert to client timestamp
     return new ClientTimestamp(
       adminTimestamp.seconds,
       adminTimestamp.nanoseconds
@@ -40,8 +80,21 @@ export class TimestampUtils {
   }
 
   /**
-   * Creates a client-compatible timestamp for the current time
-   * @returns A client SDK Timestamp (from firebase/firestore) for the current time
+   * Creates a timestamp for the current time in the appropriate format based on environment
+   * @returns A timestamp for the current time (admin timestamp in server mode, client in client mode)
+   */
+  static nowAsTimestamp(): admin.firestore.Timestamp | ClientTimestamp {
+    const now = admin.firestore.Timestamp.now();
+    // In server mode, return the admin timestamp directly
+    if (this.serverMode) {
+      return now;
+    }
+    // In client mode, convert to client timestamp
+    return this.adminToClient(now) as ClientTimestamp;
+  }
+
+  /**
+   * @deprecated Use nowAsTimestamp() instead for better cross-environment compatibility
    */
   static nowAsClient(): ClientTimestamp {
     const now = admin.firestore.Timestamp.now();
@@ -49,33 +102,87 @@ export class TimestampUtils {
   }
 
   /**
-   * Converts a Date object to a client Firestore Timestamp
+   * Converts a Date object to a timestamp in the appropriate format based on environment
    * @param date - JavaScript Date object
-   * @returns A client SDK Timestamp (from firebase/firestore) or null if input is null
+   * @returns A timestamp (admin timestamp in server mode, client in client mode) or null if input is null
    */
-  static dateToClientTimestamp(date: Date | null): ClientTimestamp | null {
+  static dateToTimestamp(
+    date: Date | null
+  ): admin.firestore.Timestamp | ClientTimestamp | null {
     if (!date) return null;
 
+    if (this.serverMode) {
+      return admin.firestore.Timestamp.fromDate(date);
+    }
+
     return ClientTimestamp.fromDate(date);
   }
 
   /**
-   * Converts a Date object to an admin Firestore Timestamp
-   * @param date - JavaScript Date object
-   * @returns An admin SDK Timestamp (from firebase-admin) or null if input is null
+   * @deprecated Use dateToTimestamp() instead for better cross-environment compatibility
+   */
+  static dateToClientTimestamp(date: Date | null): ClientTimestamp | null {
+    if (!date) return null;
+    return ClientTimestamp.fromDate(date);
+  }
+
+  /**
+   * @deprecated Use dateToTimestamp() instead for better cross-environment compatibility
    */
   static dateToAdminTimestamp(
     date: Date | null
   ): admin.firestore.Timestamp | null {
     if (!date) return null;
-
     return admin.firestore.Timestamp.fromDate(date);
   }
 
   /**
-   * Deeply converts all admin Firestore Timestamps in an object to client Firestore Timestamps
-   * @param obj - Object that may contain admin Firestore Timestamps
-   * @returns The same object with all admin Timestamps converted to client Timestamps
+   * Gets a server timestamp field value for use in create/update operations
+   * Works in both admin and client environments
+   */
+  static serverTimestamp(): admin.firestore.FieldValue | any {
+    if (this.serverMode) {
+      return admin.firestore.FieldValue.serverTimestamp();
+    }
+    // In client mode, we'd need to import from firebase/firestore
+    // This would be implemented for client environments
+    throw new Error("Server timestamp in client mode not implemented");
+  }
+
+  /**
+   * For objects with mixed timestamp types, ensures all timestamps are
+   * in the correct format for the current environment
+   */
+  static normalizeTimestamps<T>(obj: T): T {
+    if (!obj || typeof obj !== "object") {
+      return obj;
+    }
+
+    if (obj instanceof admin.firestore.Timestamp) {
+      return this.serverMode ? obj : (this.adminToClient(obj) as unknown as T);
+    }
+
+    if (obj instanceof ClientTimestamp && this.serverMode) {
+      return this.clientToAdmin(obj) as unknown as T;
+    }
+
+    if (Array.isArray(obj)) {
+      return obj.map((item) => this.normalizeTimestamps(item)) as unknown as T;
+    }
+
+    const result = { ...obj } as any;
+
+    for (const key in result) {
+      if (Object.prototype.hasOwnProperty.call(result, key)) {
+        result[key] = this.normalizeTimestamps(result[key]);
+      }
+    }
+
+    return result as T;
+  }
+
+  /**
+   * @deprecated Use normalizeTimestamps() instead for better cross-environment compatibility
    */
   static convertObjectTimestampsAdminToClient<T>(obj: T): T {
     if (!obj || typeof obj !== "object") {
@@ -104,9 +211,7 @@ export class TimestampUtils {
   }
 
   /**
-   * Deeply converts all client Firestore Timestamps in an object to admin Firestore Timestamps
-   * @param obj - Object that may contain client Firestore Timestamps
-   * @returns The same object with all client Timestamps converted to admin Timestamps
+   * @deprecated Use normalizeTimestamps() instead for better cross-environment compatibility
    */
   static convertObjectTimestampsClientToAdmin<T>(obj: T): T {
     if (!obj || typeof obj !== "object") {