@blackcode_sa/metaestetics-api 1.6.13 → 1.6.14

package/src/utils/TimestampUtils.ts

@@ -0,0 +1,136 @@
+import * as admin from "firebase-admin";
+import { Timestamp as ClientTimestamp } from "firebase/firestore";
+
+/**
+ * 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 {
+  /**
+   * Converts an admin Firestore Timestamp to a client Firestore Timestamp
+   * @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
+   */
+  static adminToClient(
+    adminTimestamp: admin.firestore.Timestamp | null
+  ): ClientTimestamp | null {
+    if (!adminTimestamp) return null;
+
+    return new ClientTimestamp(
+      adminTimestamp.seconds,
+      adminTimestamp.nanoseconds
+    );
+  }
+
+  /**
+   * Converts a client Firestore Timestamp to an admin Firestore Timestamp
+   * @param clientTimestamp - Client SDK Timestamp (from firebase/firestore)
+   * @returns An admin SDK Timestamp (from firebase-admin) with same seconds/nanoseconds or null if input is null
+   */
+  static clientToAdmin(
+    clientTimestamp: ClientTimestamp | null
+  ): admin.firestore.Timestamp | null {
+    if (!clientTimestamp) return null;
+
+    return new admin.firestore.Timestamp(
+      clientTimestamp.seconds,
+      clientTimestamp.nanoseconds
+    );
+  }
+
+  /**
+   * Creates a client-compatible timestamp for the current time
+   * @returns A client SDK Timestamp (from firebase/firestore) for the current time
+   */
+  static nowAsClient(): ClientTimestamp {
+    const now = admin.firestore.Timestamp.now();
+    return this.adminToClient(now) as ClientTimestamp;
+  }
+
+  /**
+   * Converts a Date object to a client Firestore Timestamp
+   * @param date - JavaScript Date object
+   * @returns A client SDK Timestamp (from firebase/firestore) or null if input is null
+   */
+  static dateToClientTimestamp(date: Date | null): ClientTimestamp | null {
+    if (!date) return null;
+
+    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
+   */
+  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
+   */
+  static convertObjectTimestampsAdminToClient<T>(obj: T): T {
+    if (!obj || typeof obj !== "object") {
+      return obj;
+    }
+
+    if (obj instanceof admin.firestore.Timestamp) {
+      return this.adminToClient(obj) as unknown as T;
+    }
+
+    if (Array.isArray(obj)) {
+      return obj.map((item) =>
+        this.convertObjectTimestampsAdminToClient(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.convertObjectTimestampsAdminToClient(result[key]);
+      }
+    }
+
+    return result as T;
+  }
+
+  /**
+   * 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
+   */
+  static convertObjectTimestampsClientToAdmin<T>(obj: T): T {
+    if (!obj || typeof obj !== "object") {
+      return obj;
+    }
+
+    if (obj instanceof ClientTimestamp) {
+      return this.clientToAdmin(obj) as unknown as T;
+    }
+
+    if (Array.isArray(obj)) {
+      return obj.map((item) =>
+        this.convertObjectTimestampsClientToAdmin(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.convertObjectTimestampsClientToAdmin(result[key]);
+      }
+    }
+
+    return result as T;
+  }
+}