@jobsearch-works/firestore-models 1.0.29 → 1.0.31

package/dist/index.d.mts

@@ -61,35 +61,35 @@ declare namespace Application {
     const updateStatus: (application: Application.Model, newStatus: Application.Model["status"]) => Application.Model;
 }
 
-interface FirestoreTimestamp {
-    seconds: number;
-    nanoseconds: number;
-    _firestore_timestamp?: boolean;
-}
-/**
- * AuthUser interface - replaces the old class-based model
- */
-interface AuthUser extends BaseModel {
-    email: string;
-    displayName?: string;
-    photoURL?: string;
-    lastSignIn?: Date | string;
-    emailVerified?: boolean;
-}
-declare const AuthUserCollectionPath = "users";
-declare const getAuthUserDocumentPath: (userId: string) => string;
-declare const AuthUserUtils: {
-    getTimestampFields: () => string[];
-    isFirestoreTimestamp: (value: any) => value is FirestoreTimestamp;
-    fromFirebaseUser: (user: any) => AuthUser;
-    formatDates: (user: AuthUser) => {
+declare namespace AuthUser {
+    export interface Model extends BaseModel {
+        email: string;
+        displayName?: string;
+        photoURL?: string;
+        lastSignIn?: string;
+        emailVerified?: boolean;
+    }
+    interface FirestoreTimestamp {
+        seconds: number;
+        nanoseconds: number;
+        _firestore_timestamp?: boolean;
+    }
+    export const collection: () => string;
+    export const document: (userId: string) => string;
+    export const getTimestampFields: () => (keyof Model)[];
+    export const isFirestoreTimestamp: (value: any) => value is FirestoreTimestamp;
+    export const fromFirebaseUser: (user: any) => Model;
+    export const format: (user: Model) => string;
+    export const formatDates: (user: Model) => {
         lastSignIn: string;
         createdAt: string;
         updatedAt?: string;
     };
-    toFirestore: (user: AuthUser) => Record<string, any>;
-    fromFirestore: (data: Record<string, any>) => AuthUser;
-};
+    export const toFirestore: (user: Model) => Record<string, any>;
+    export const fromFirestore: (data: Record<string, any>) => Model;
+    export const createNew: (email: string, displayName?: string, photoURL?: string) => Model;
+    export {};
+}
 
 declare namespace Client {
     interface Model extends BaseModel {
@@ -301,4 +301,38 @@ declare namespace Agent {
     const createNew: (name: string, email: string) => Agent.Model;
 }
 
-export { Agent, Application, ApplicationQuestion, AuthUser, AuthUserCollectionPath, AuthUserUtils, Client, ClientData, ClientLogin, ClientQuestion, Vacancy, VacancySuggestion, getAuthUserDocumentPath };
+declare namespace GmailMessage {
+    interface Model extends BaseModel {
+        messageId: string;
+        threadId?: string;
+        labelIds?: string[];
+        snippet?: string;
+        internalDate?: string;
+        payload?: {
+            headers?: Array<{
+                name: string;
+                value: string;
+            }>;
+            body?: {
+                data?: string;
+            };
+            parts?: Array<{
+                mimeType?: string;
+                body?: {
+                    data?: string;
+                };
+            }>;
+        };
+    }
+    const collection: (clientId: string) => string;
+    const document: (clientId: string, messageId: string) => string;
+    const extractBody: (email: Model) => string;
+    const extractReceivedDate: (email: Model) => Date;
+    const extractSubject: (email: Model) => string;
+    const extractFromAddress: (email: Model) => string;
+    const formatEmailDate: (email: Model) => string;
+    const getEmailSender: (email: Model) => string;
+    const createNew: (messageId: string, threadId?: string, payload?: Model["payload"], labelIds?: string[], snippet?: string, internalDate?: string) => Model;
+}
+
+export { Agent, Application, ApplicationQuestion, AuthUser, Client, ClientData, ClientLogin, ClientQuestion, GmailMessage, Vacancy, VacancySuggestion };

package/dist/index.d.ts

@@ -61,35 +61,35 @@ declare namespace Application {
     const updateStatus: (application: Application.Model, newStatus: Application.Model["status"]) => Application.Model;
 }
 
-interface FirestoreTimestamp {
-    seconds: number;
-    nanoseconds: number;
-    _firestore_timestamp?: boolean;
-}
-/**
- * AuthUser interface - replaces the old class-based model
- */
-interface AuthUser extends BaseModel {
-    email: string;
-    displayName?: string;
-    photoURL?: string;
-    lastSignIn?: Date | string;
-    emailVerified?: boolean;
-}
-declare const AuthUserCollectionPath = "users";
-declare const getAuthUserDocumentPath: (userId: string) => string;
-declare const AuthUserUtils: {
-    getTimestampFields: () => string[];
-    isFirestoreTimestamp: (value: any) => value is FirestoreTimestamp;
-    fromFirebaseUser: (user: any) => AuthUser;
-    formatDates: (user: AuthUser) => {
+declare namespace AuthUser {
+    export interface Model extends BaseModel {
+        email: string;
+        displayName?: string;
+        photoURL?: string;
+        lastSignIn?: string;
+        emailVerified?: boolean;
+    }
+    interface FirestoreTimestamp {
+        seconds: number;
+        nanoseconds: number;
+        _firestore_timestamp?: boolean;
+    }
+    export const collection: () => string;
+    export const document: (userId: string) => string;
+    export const getTimestampFields: () => (keyof Model)[];
+    export const isFirestoreTimestamp: (value: any) => value is FirestoreTimestamp;
+    export const fromFirebaseUser: (user: any) => Model;
+    export const format: (user: Model) => string;
+    export const formatDates: (user: Model) => {
         lastSignIn: string;
         createdAt: string;
         updatedAt?: string;
     };
-    toFirestore: (user: AuthUser) => Record<string, any>;
-    fromFirestore: (data: Record<string, any>) => AuthUser;
-};
+    export const toFirestore: (user: Model) => Record<string, any>;
+    export const fromFirestore: (data: Record<string, any>) => Model;
+    export const createNew: (email: string, displayName?: string, photoURL?: string) => Model;
+    export {};
+}
 
 declare namespace Client {
     interface Model extends BaseModel {
@@ -301,4 +301,38 @@ declare namespace Agent {
     const createNew: (name: string, email: string) => Agent.Model;
 }
 
-export { Agent, Application, ApplicationQuestion, AuthUser, AuthUserCollectionPath, AuthUserUtils, Client, ClientData, ClientLogin, ClientQuestion, Vacancy, VacancySuggestion, getAuthUserDocumentPath };
+declare namespace GmailMessage {
+    interface Model extends BaseModel {
+        messageId: string;
+        threadId?: string;
+        labelIds?: string[];
+        snippet?: string;
+        internalDate?: string;
+        payload?: {
+            headers?: Array<{
+                name: string;
+                value: string;
+            }>;
+            body?: {
+                data?: string;
+            };
+            parts?: Array<{
+                mimeType?: string;
+                body?: {
+                    data?: string;
+                };
+            }>;
+        };
+    }
+    const collection: (clientId: string) => string;
+    const document: (clientId: string, messageId: string) => string;
+    const extractBody: (email: Model) => string;
+    const extractReceivedDate: (email: Model) => Date;
+    const extractSubject: (email: Model) => string;
+    const extractFromAddress: (email: Model) => string;
+    const formatEmailDate: (email: Model) => string;
+    const getEmailSender: (email: Model) => string;
+    const createNew: (messageId: string, threadId?: string, payload?: Model["payload"], labelIds?: string[], snippet?: string, internalDate?: string) => Model;
+}
+
+export { Agent, Application, ApplicationQuestion, AuthUser, Client, ClientData, ClientLogin, ClientQuestion, GmailMessage, Vacancy, VacancySuggestion };

package/dist/index.js

@@ -23,15 +23,14 @@ __export(src_exports, {
   Agent: () => Agent,
   Application: () => Application,
   ApplicationQuestion: () => ApplicationQuestion,
-  AuthUserCollectionPath: () => AuthUserCollectionPath,
-  AuthUserUtils: () => AuthUserUtils,
+  AuthUser: () => AuthUser,
   Client: () => Client,
   ClientData: () => ClientData,
   ClientLogin: () => ClientLogin,
   ClientQuestion: () => ClientQuestion,
+  GmailMessage: () => GmailMessage,
   Vacancy: () => Vacancy,
-  VacancySuggestion: () => VacancySuggestion,
-  getAuthUserDocumentPath: () => getAuthUserDocumentPath
+  VacancySuggestion: () => VacancySuggestion
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -87,17 +86,19 @@ var Application;
 })(Application || (Application = {}));
 
 // src/models/AuthUser.ts
-var AuthUserCollectionPath = "users";
-var getAuthUserDocumentPath = (userId) => `users/${userId}`;
-var AuthUserUtils = {
-  // Get timestamp fields for AuthUser
-  getTimestampFields: () => [],
-  // Check if value is a Firestore timestamp
-  isFirestoreTimestamp: (value) => {
+var AuthUser;
+((AuthUser2) => {
+  AuthUser2.collection = () => "users";
+  AuthUser2.document = (userId) => `users/${userId}`;
+  AuthUser2.getTimestampFields = () => [
+    "lastSignIn",
+    "createdAt",
+    "updatedAt"
+  ];
+  AuthUser2.isFirestoreTimestamp = (value) => {
     return typeof value === "object" && value !== null && ("seconds" in value || "_firestore_timestamp" in value);
-  },
-  // Create from Firebase user object
-  fromFirebaseUser: (user) => {
+  };
+  AuthUser2.fromFirebaseUser = (user) => {
     return {
       id: user.uid,
       email: user.email,
@@ -105,16 +106,18 @@ var AuthUserUtils = {
       photoURL: user.photoURL,
       emailVerified: user.emailVerified,
       lastSignIn: (/* @__PURE__ */ new Date()).toISOString(),
-      // Current timestamp for new logins
-      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
-  },
-  // Convert dates to display format
-  formatDates: (user) => {
+  };
+  AuthUser2.format = (user) => {
+    return `${user.email}${user.displayName ? " (" + user.displayName + ")" : ""}`;
+  };
+  AuthUser2.formatDates = (user) => {
     const formatDate = (dateValue) => {
       if (!dateValue)
         return "N/A";
-      const date = typeof dateValue === "string" ? new Date(dateValue) : dateValue;
+      const date = dateValue instanceof Date ? dateValue : new Date(dateValue);
       return date.toLocaleString();
     };
     return {
@@ -122,41 +125,49 @@ var AuthUserUtils = {
       createdAt: formatDate(user.createdAt),
       updatedAt: user.updatedAt ? formatDate(user.updatedAt) : void 0
     };
-  },
-  // Convert AuthUser to format for storage
-  toFirestore: (user) => {
+  };
+  AuthUser2.toFirestore = (user) => {
     const { id, ...data } = user;
-    if (data.lastSignIn && data.lastSignIn instanceof Date) {
-      data.lastSignIn = data.lastSignIn.toISOString();
-    }
-    if (data.createdAt && data.createdAt instanceof Date) {
-      data.createdAt = data.createdAt.toISOString();
-    }
-    if (data.updatedAt && data.updatedAt instanceof Date) {
-      data.updatedAt = data.updatedAt.toISOString();
-    } else {
-      data.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    }
+    (0, AuthUser2.getTimestampFields)().forEach((field) => {
+      if (data[field] instanceof Date) {
+        data[field] = data[field].toISOString();
+      } else if (!data[field]) {
+        if (field === "updatedAt") {
+          data.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+        }
+      }
+    });
     return data;
-  },
-  // Convert from Firestore data to AuthUser
-  fromFirestore: (data) => {
-    const processedData = { ...data };
-    const timestampFields = [];
-    timestampFields.forEach((field) => {
+  };
+  AuthUser2.fromFirestore = (data) => {
+    const processed = { ...data };
+    (0, AuthUser2.getTimestampFields)().forEach((field) => {
       if (data[field]) {
-        if (AuthUserUtils.isFirestoreTimestamp(data[field])) {
-          processedData[field] = new Date(
+        if ((0, AuthUser2.isFirestoreTimestamp)(data[field])) {
+          processed[field] = new Date(
             data[field].seconds * 1e3
           ).toISOString();
         } else if (typeof data[field] === "string") {
-          processedData[field] = data[field];
+          processed[field] = data[field];
         }
       }
     });
-    return processedData;
-  }
-};
+    return processed;
+  };
+  AuthUser2.createNew = (email, displayName, photoURL) => {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    return {
+      id: void 0,
+      email,
+      displayName,
+      photoURL,
+      emailVerified: false,
+      lastSignIn: now,
+      createdAt: now,
+      updatedAt: now
+    };
+  };
+})(AuthUser || (AuthUser = {}));
 
 // src/models/Client.ts
 var Client;
@@ -365,18 +376,92 @@ var Agent;
     };
   };
 })(Agent || (Agent = {}));
+
+// src/models/GmailMessage.ts
+var GmailMessage;
+((GmailMessage2) => {
+  GmailMessage2.collection = (clientId) => `clientEmails/${clientId}/messages`;
+  GmailMessage2.document = (clientId, messageId) => `${(0, GmailMessage2.collection)(clientId)}/${messageId}`;
+  GmailMessage2.extractBody = (email) => {
+    const payload = email.payload;
+    if (!payload)
+      return "No body available";
+    const getTextContent = (parts) => {
+      for (const part of parts) {
+        if (part.mimeType === "text/plain" && part.body?.data) {
+          return Buffer.from(part.body.data, "base64").toString();
+        }
+      }
+      return "";
+    };
+    if (payload.parts && Array.isArray(payload.parts)) {
+      return getTextContent(payload.parts) || "No body available";
+    }
+    if (payload.body?.data) {
+      return Buffer.from(payload.body.data, "base64").toString();
+    }
+    return "No body available";
+  };
+  GmailMessage2.extractReceivedDate = (email) => {
+    const headers = email.payload?.headers || [];
+    const dateHeader = headers.find(
+      (header) => header.name.toLowerCase() === "date"
+    );
+    if (dateHeader?.value) {
+      const parsedDate = new Date(dateHeader.value);
+      if (!isNaN(parsedDate.getTime())) {
+        return parsedDate;
+      }
+    }
+    if (email.internalDate) {
+      return new Date(parseInt(email.internalDate, 10));
+    }
+    return /* @__PURE__ */ new Date();
+  };
+  GmailMessage2.extractSubject = (email) => {
+    const headers = email.payload?.headers || [];
+    const subjectHeader = headers.find(
+      (header) => header.name.toLowerCase() === "subject"
+    );
+    return subjectHeader?.value || "No subject available";
+  };
+  GmailMessage2.extractFromAddress = (email) => {
+    const headers = email.payload?.headers || [];
+    const fromHeader = headers.find(
+      (header) => header.name.toLowerCase() === "from"
+    );
+    return fromHeader?.value || "No sender available";
+  };
+  GmailMessage2.formatEmailDate = (email) => {
+    const date = (0, GmailMessage2.extractReceivedDate)(email);
+    return date.toLocaleString();
+  };
+  GmailMessage2.getEmailSender = (email) => {
+    return (0, GmailMessage2.extractFromAddress)(email);
+  };
+  GmailMessage2.createNew = (messageId, threadId, payload, labelIds, snippet, internalDate) => {
+    return {
+      messageId,
+      threadId,
+      payload,
+      labelIds,
+      snippet,
+      internalDate,
+      createdAt: /* @__PURE__ */ new Date()
+    };
+  };
+})(GmailMessage || (GmailMessage = {}));
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Agent,
   Application,
   ApplicationQuestion,
-  AuthUserCollectionPath,
-  AuthUserUtils,
+  AuthUser,
   Client,
   ClientData,
   ClientLogin,
   ClientQuestion,
+  GmailMessage,
   Vacancy,
-  VacancySuggestion,
-  getAuthUserDocumentPath
+  VacancySuggestion
 });

package/dist/index.mjs

@@ -50,17 +50,19 @@ var Application;
 })(Application || (Application = {}));
 
 // src/models/AuthUser.ts
-var AuthUserCollectionPath = "users";
-var getAuthUserDocumentPath = (userId) => `users/${userId}`;
-var AuthUserUtils = {
-  // Get timestamp fields for AuthUser
-  getTimestampFields: () => [],
-  // Check if value is a Firestore timestamp
-  isFirestoreTimestamp: (value) => {
+var AuthUser;
+((AuthUser2) => {
+  AuthUser2.collection = () => "users";
+  AuthUser2.document = (userId) => `users/${userId}`;
+  AuthUser2.getTimestampFields = () => [
+    "lastSignIn",
+    "createdAt",
+    "updatedAt"
+  ];
+  AuthUser2.isFirestoreTimestamp = (value) => {
     return typeof value === "object" && value !== null && ("seconds" in value || "_firestore_timestamp" in value);
-  },
-  // Create from Firebase user object
-  fromFirebaseUser: (user) => {
+  };
+  AuthUser2.fromFirebaseUser = (user) => {
     return {
       id: user.uid,
       email: user.email,
@@ -68,16 +70,18 @@ var AuthUserUtils = {
       photoURL: user.photoURL,
       emailVerified: user.emailVerified,
       lastSignIn: (/* @__PURE__ */ new Date()).toISOString(),
-      // Current timestamp for new logins
-      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
-  },
-  // Convert dates to display format
-  formatDates: (user) => {
+  };
+  AuthUser2.format = (user) => {
+    return `${user.email}${user.displayName ? " (" + user.displayName + ")" : ""}`;
+  };
+  AuthUser2.formatDates = (user) => {
     const formatDate = (dateValue) => {
       if (!dateValue)
         return "N/A";
-      const date = typeof dateValue === "string" ? new Date(dateValue) : dateValue;
+      const date = dateValue instanceof Date ? dateValue : new Date(dateValue);
       return date.toLocaleString();
     };
     return {
@@ -85,41 +89,49 @@ var AuthUserUtils = {
       createdAt: formatDate(user.createdAt),
       updatedAt: user.updatedAt ? formatDate(user.updatedAt) : void 0
     };
-  },
-  // Convert AuthUser to format for storage
-  toFirestore: (user) => {
+  };
+  AuthUser2.toFirestore = (user) => {
     const { id, ...data } = user;
-    if (data.lastSignIn && data.lastSignIn instanceof Date) {
-      data.lastSignIn = data.lastSignIn.toISOString();
-    }
-    if (data.createdAt && data.createdAt instanceof Date) {
-      data.createdAt = data.createdAt.toISOString();
-    }
-    if (data.updatedAt && data.updatedAt instanceof Date) {
-      data.updatedAt = data.updatedAt.toISOString();
-    } else {
-      data.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    }
+    (0, AuthUser2.getTimestampFields)().forEach((field) => {
+      if (data[field] instanceof Date) {
+        data[field] = data[field].toISOString();
+      } else if (!data[field]) {
+        if (field === "updatedAt") {
+          data.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+        }
+      }
+    });
     return data;
-  },
-  // Convert from Firestore data to AuthUser
-  fromFirestore: (data) => {
-    const processedData = { ...data };
-    const timestampFields = [];
-    timestampFields.forEach((field) => {
+  };
+  AuthUser2.fromFirestore = (data) => {
+    const processed = { ...data };
+    (0, AuthUser2.getTimestampFields)().forEach((field) => {
       if (data[field]) {
-        if (AuthUserUtils.isFirestoreTimestamp(data[field])) {
-          processedData[field] = new Date(
+        if ((0, AuthUser2.isFirestoreTimestamp)(data[field])) {
+          processed[field] = new Date(
             data[field].seconds * 1e3
           ).toISOString();
         } else if (typeof data[field] === "string") {
-          processedData[field] = data[field];
+          processed[field] = data[field];
         }
       }
     });
-    return processedData;
-  }
-};
+    return processed;
+  };
+  AuthUser2.createNew = (email, displayName, photoURL) => {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    return {
+      id: void 0,
+      email,
+      displayName,
+      photoURL,
+      emailVerified: false,
+      lastSignIn: now,
+      createdAt: now,
+      updatedAt: now
+    };
+  };
+})(AuthUser || (AuthUser = {}));
 
 // src/models/Client.ts
 var Client;
@@ -328,17 +340,91 @@ var Agent;
     };
   };
 })(Agent || (Agent = {}));
+
+// src/models/GmailMessage.ts
+var GmailMessage;
+((GmailMessage2) => {
+  GmailMessage2.collection = (clientId) => `clientEmails/${clientId}/messages`;
+  GmailMessage2.document = (clientId, messageId) => `${(0, GmailMessage2.collection)(clientId)}/${messageId}`;
+  GmailMessage2.extractBody = (email) => {
+    const payload = email.payload;
+    if (!payload)
+      return "No body available";
+    const getTextContent = (parts) => {
+      for (const part of parts) {
+        if (part.mimeType === "text/plain" && part.body?.data) {
+          return Buffer.from(part.body.data, "base64").toString();
+        }
+      }
+      return "";
+    };
+    if (payload.parts && Array.isArray(payload.parts)) {
+      return getTextContent(payload.parts) || "No body available";
+    }
+    if (payload.body?.data) {
+      return Buffer.from(payload.body.data, "base64").toString();
+    }
+    return "No body available";
+  };
+  GmailMessage2.extractReceivedDate = (email) => {
+    const headers = email.payload?.headers || [];
+    const dateHeader = headers.find(
+      (header) => header.name.toLowerCase() === "date"
+    );
+    if (dateHeader?.value) {
+      const parsedDate = new Date(dateHeader.value);
+      if (!isNaN(parsedDate.getTime())) {
+        return parsedDate;
+      }
+    }
+    if (email.internalDate) {
+      return new Date(parseInt(email.internalDate, 10));
+    }
+    return /* @__PURE__ */ new Date();
+  };
+  GmailMessage2.extractSubject = (email) => {
+    const headers = email.payload?.headers || [];
+    const subjectHeader = headers.find(
+      (header) => header.name.toLowerCase() === "subject"
+    );
+    return subjectHeader?.value || "No subject available";
+  };
+  GmailMessage2.extractFromAddress = (email) => {
+    const headers = email.payload?.headers || [];
+    const fromHeader = headers.find(
+      (header) => header.name.toLowerCase() === "from"
+    );
+    return fromHeader?.value || "No sender available";
+  };
+  GmailMessage2.formatEmailDate = (email) => {
+    const date = (0, GmailMessage2.extractReceivedDate)(email);
+    return date.toLocaleString();
+  };
+  GmailMessage2.getEmailSender = (email) => {
+    return (0, GmailMessage2.extractFromAddress)(email);
+  };
+  GmailMessage2.createNew = (messageId, threadId, payload, labelIds, snippet, internalDate) => {
+    return {
+      messageId,
+      threadId,
+      payload,
+      labelIds,
+      snippet,
+      internalDate,
+      createdAt: /* @__PURE__ */ new Date()
+    };
+  };
+})(GmailMessage || (GmailMessage = {}));
 export {
   Agent,
   Application,
   ApplicationQuestion,
-  AuthUserCollectionPath,
-  AuthUserUtils,
+  AuthUser,
   Client,
   ClientData,
   ClientLogin,
   ClientQuestion,
+  GmailMessage,
   Vacancy,
-  VacancySuggestion,
-  getAuthUserDocumentPath
+  VacancySuggestion
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jobsearch-works/firestore-models",
-  "version": "1.0.29",
+  "version": "1.0.31",
   "description": "A shared library for standardizing Firestore document schemas and paths across multiple projects",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",