@jobsearch-works/firestore-models 1.1.11 → 1.1.13

package/README.md

@@ -75,7 +75,9 @@ Client
   ├── questions (ClientQuestion)
   ├── preferences/targetPreferences (TargetPreferences)
   ├── vacancySuggestions (VacancySuggestion)
-  └── clientEmails/{clientId}/messages (GmailMessage)
+  ├── emails (GmailMessage)
+  ├── logins (ClientLogin)
+  └── resumeLinks (ResumeLink)
 
 Vacancy
   └── Referenced by Application and VacancySuggestion
@@ -88,9 +90,6 @@ User
 
 ClientData
   └── Root collection
-
-ClientLogin
-  └── clientLogins/{userId}/logins/{domain}
 ```
 
 | Entity              | References / Path                                    | Description                                                          |
@@ -107,8 +106,8 @@ ClientLogin
 | Agent               | Root collection                                      | Standalone entity                                                    |
 | AuthUser            | Root collection                                      | Standalone entity                                                    |
 | ClientData          | Root collection                                      | Standalone entity                                                    |
-| ClientLogin         | clientLogins/{userId}/logins/{domain}                | References `userId`                                                  |
-| GmailMessage        | clientEmails/{clientId}/messages/{messageId}         | References `clientId`                                                |
+| ClientLogin         | clients/{clientId}/logins/{domain}                   | References `clientId`                                                |
+| GmailMessage        | clients/{clientId}/emails/{messageId}                | References `clientId`                                                |
 | ResumeLink          | clients/{clientId}/resumeLinks/{linkId}              | References `clientId`, stores PDF resume URLs                        |
 
 **Notes:**
@@ -122,7 +121,7 @@ ClientLogin
 
 ## ✅ Usage
 
-This library is intentionally SDK-free. All Firebase logic — including `Timestamp`, `doc()`, and `onSnapshot()` — is handled in your app’s service layer. This ensures portability across React apps, Firebase functions, and testing environments.
+This library is intentionally SDK-free. All Firebase logic — including `Timestamp`, `doc()`, and `onSnapshot()` — is handled in your app's service layer. This ensures portability across React apps, Firebase functions, and testing environments.
 
 ### Importing Models and Paths
 
@@ -304,11 +303,11 @@ All Firestore document schemas are defined as TypeScript interfaces in `src/type
 
   ```ts
   export interface ResumeLink {
-    id: string;
+    id?: string;
     title: string;
     url: string;
     description: string;
-    createdAt: any; // Timestamp from firebase/firestore
+    createdAt?: Date | string;
     createdBy: string;
     clientId: string;
   }
@@ -447,9 +446,17 @@ export function withId<T>(snap: DocumentSnapshot): T & { id: string } {
 - `firestorePaths.clients.doc(clientId)` → "clients/{clientId}"
 - `firestorePaths.clients.applications.collection(clientId)` → "clients/{clientId}/applications"
 - `firestorePaths.clients.applications.doc(clientId, applicationId)` → "clients/{clientId}/applications/{applicationId}"
+- `firestorePaths.clients.applications.questions.collection(clientId, applicationId)` → "clients/{clientId}/applications/{applicationId}/questions"
+- `firestorePaths.clients.applications.questions.doc(clientId, applicationId, questionId)` → "clients/{clientId}/applications/{applicationId}/questions/{questionId}"
+- `firestorePaths.clients.emails.collection(clientId)` → "clients/{clientId}/emails"
+- `firestorePaths.clients.emails.doc(clientId, messageId)` → "clients/{clientId}/emails/{messageId}"
+- `firestorePaths.clients.logins.collection(clientId)` → "clients/{clientId}/logins"
+- `firestorePaths.clients.logins.doc(clientId, domain)` → "clients/{clientId}/logins/{domain}"
+- `firestorePaths.clients.preferences.target(clientId)` → "clients/{clientId}/preferences/targetPreferences"
 - `firestorePaths.clients.questions.collection(clientId)` → "clients/{clientId}/questions"
 - `firestorePaths.clients.questions.doc(clientId, questionId)` → "clients/{clientId}/questions/{questionId}"
-- `firestorePaths.clients.preferences.target(clientId)` → "clients/{clientId}/preferences/targetPreferences"
+- `firestorePaths.clients.resumeLinks.collection(clientId)` → "clients/{clientId}/resumeLinks"
+- `firestorePaths.clients.resumeLinks.doc(clientId, resumeLinkId)` → "clients/{clientId}/resumeLinks/{resumeLinkId}"
 - `firestorePaths.clients.vacancySuggestions.collection(clientId)` → "clients/{clientId}/vacancySuggestions"
 - `firestorePaths.clients.vacancySuggestions.doc(clientId, suggestionId)` → "clients/{clientId}/vacancySuggestions/{suggestionId}"
 - `firestorePaths.users.collection()` → "users"
@@ -460,10 +467,6 @@ export function withId<T>(snap: DocumentSnapshot): T & { id: string } {
 - `firestorePaths.agents.doc(agentId)` → "agents/{agentId}"
 - `firestorePaths.clientData.collection()` → "clientData"
 - `firestorePaths.clientData.doc(clientDataId)` → "clientData/{clientDataId}"
-- `firestorePaths.clientLogins.collection(userId)` → "clientLogins/{userId}"
-- `firestorePaths.clientLogins.doc(userId, domain)` → "clientLogins/{userId}/logins/{domain}"
-- `firestorePaths.gmailMessages.collection(clientId)` → "clientEmails/{clientId}/messages"
-- `firestorePaths.gmailMessages.doc(clientId, messageId)` → "clientEmails/{clientId}/messages/{messageId}"
 
 ---
 

package/dist/index.d.mts

@@ -261,21 +261,29 @@ declare const firestorePaths: {
                 readonly doc: (clientId: string, applicationId: string, questionId: string) => string;
             };
         };
-        readonly questions: {
+        readonly emails: {
             readonly collection: (clientId: string) => string;
-            readonly doc: (clientId: string, questionId: string) => string;
+            readonly doc: (clientId: string, messageId: string) => string;
+        };
+        readonly logins: {
+            readonly collection: (clientId: string) => string;
+            readonly doc: (clientId: string, domain: string) => string;
         };
         readonly preferences: {
             readonly target: (clientId: string) => string;
         };
-        readonly vacancySuggestions: {
+        readonly questions: {
             readonly collection: (clientId: string) => string;
-            readonly doc: (clientId: string, suggestionId: string) => string;
+            readonly doc: (clientId: string, questionId: string) => string;
         };
         readonly resumeLinks: {
             readonly collection: (clientId: string) => string;
             readonly doc: (clientId: string, resumeLinkId: string) => string;
         };
+        readonly vacancySuggestions: {
+            readonly collection: (clientId: string) => string;
+            readonly doc: (clientId: string, suggestionId: string) => string;
+        };
     };
     readonly users: {
         readonly collection: () => string;
@@ -294,10 +302,10 @@ declare const firestorePaths: {
         readonly doc: (clientDataId: string) => string;
     };
     readonly clientLogins: {
-        readonly collection: (userId: string) => string;
-        readonly doc: (userId: string, domain: string) => string;
+        readonly collection: (clientId: string) => string;
+        readonly doc: (clientId: string, domain: string) => string;
     };
-    readonly gmailMessages: {
+    readonly clientEmails: {
         readonly collection: (clientId: string) => string;
         readonly doc: (clientId: string, messageId: string) => string;
     };

package/dist/index.d.ts

@@ -261,21 +261,29 @@ declare const firestorePaths: {
                 readonly doc: (clientId: string, applicationId: string, questionId: string) => string;
             };
         };
-        readonly questions: {
+        readonly emails: {
             readonly collection: (clientId: string) => string;
-            readonly doc: (clientId: string, questionId: string) => string;
+            readonly doc: (clientId: string, messageId: string) => string;
+        };
+        readonly logins: {
+            readonly collection: (clientId: string) => string;
+            readonly doc: (clientId: string, domain: string) => string;
         };
         readonly preferences: {
             readonly target: (clientId: string) => string;
         };
-        readonly vacancySuggestions: {
+        readonly questions: {
             readonly collection: (clientId: string) => string;
-            readonly doc: (clientId: string, suggestionId: string) => string;
+            readonly doc: (clientId: string, questionId: string) => string;
         };
         readonly resumeLinks: {
             readonly collection: (clientId: string) => string;
             readonly doc: (clientId: string, resumeLinkId: string) => string;
         };
+        readonly vacancySuggestions: {
+            readonly collection: (clientId: string) => string;
+            readonly doc: (clientId: string, suggestionId: string) => string;
+        };
     };
     readonly users: {
         readonly collection: () => string;
@@ -294,10 +302,10 @@ declare const firestorePaths: {
         readonly doc: (clientDataId: string) => string;
     };
     readonly clientLogins: {
-        readonly collection: (userId: string) => string;
-        readonly doc: (userId: string, domain: string) => string;
+        readonly collection: (clientId: string) => string;
+        readonly doc: (clientId: string, domain: string) => string;
     };
-    readonly gmailMessages: {
+    readonly clientEmails: {
         readonly collection: (clientId: string) => string;
         readonly doc: (clientId: string, messageId: string) => string;
     };

package/dist/index.js

@@ -97,20 +97,28 @@ var firestorePaths = {
         doc: (clientId, applicationId, questionId) => `clients/${clientId}/applications/${applicationId}/questions/${questionId}`
       }
     },
-    questions: {
-      collection: (clientId) => `clients/${clientId}/questions`,
-      doc: (clientId, questionId) => `clients/${clientId}/questions/${questionId}`
+    emails: {
+      collection: (clientId) => `clients/${clientId}/emails`,
+      doc: (clientId, messageId) => `clients/${clientId}/emails/${messageId}`
+    },
+    logins: {
+      collection: (clientId) => `clients/${clientId}/logins`,
+      doc: (clientId, domain) => `clients/${clientId}/logins/${domain}`
     },
     preferences: {
       target: (clientId) => `clients/${clientId}/preferences/targetPreferences`
     },
-    vacancySuggestions: {
-      collection: (clientId) => `clients/${clientId}/vacancySuggestions`,
-      doc: (clientId, suggestionId) => `clients/${clientId}/vacancySuggestions/${suggestionId}`
+    questions: {
+      collection: (clientId) => `clients/${clientId}/questions`,
+      doc: (clientId, questionId) => `clients/${clientId}/questions/${questionId}`
     },
     resumeLinks: {
       collection: (clientId) => `clients/${clientId}/resumeLinks`,
       doc: (clientId, resumeLinkId) => `clients/${clientId}/resumeLinks/${resumeLinkId}`
+    },
+    vacancySuggestions: {
+      collection: (clientId) => `clients/${clientId}/vacancySuggestions`,
+      doc: (clientId, suggestionId) => `clients/${clientId}/vacancySuggestions/${suggestionId}`
     }
   },
   users: {
@@ -130,12 +138,12 @@ var firestorePaths = {
     doc: (clientDataId) => `clientData/${clientDataId}`
   },
   clientLogins: {
-    collection: (userId) => `clientLogins/${userId}/logins`,
-    doc: (userId, domain) => `clientLogins/${userId}/logins/${domain}`
+    collection: (clientId) => `clients/${clientId}/logins`,
+    doc: (clientId, domain) => `clients/${clientId}/logins/${domain}`
   },
-  gmailMessages: {
-    collection: (clientId) => `clientEmails/${clientId}/messages`,
-    doc: (clientId, messageId) => `clientEmails/${clientId}/messages/${messageId}`
+  clientEmails: {
+    collection: (clientId) => `clients/${clientId}/emails`,
+    doc: (clientId, messageId) => `clients/${clientId}/emails/${messageId}`
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -67,20 +67,28 @@ var firestorePaths = {
         doc: (clientId, applicationId, questionId) => `clients/${clientId}/applications/${applicationId}/questions/${questionId}`
       }
     },
-    questions: {
-      collection: (clientId) => `clients/${clientId}/questions`,
-      doc: (clientId, questionId) => `clients/${clientId}/questions/${questionId}`
+    emails: {
+      collection: (clientId) => `clients/${clientId}/emails`,
+      doc: (clientId, messageId) => `clients/${clientId}/emails/${messageId}`
+    },
+    logins: {
+      collection: (clientId) => `clients/${clientId}/logins`,
+      doc: (clientId, domain) => `clients/${clientId}/logins/${domain}`
     },
     preferences: {
       target: (clientId) => `clients/${clientId}/preferences/targetPreferences`
     },
-    vacancySuggestions: {
-      collection: (clientId) => `clients/${clientId}/vacancySuggestions`,
-      doc: (clientId, suggestionId) => `clients/${clientId}/vacancySuggestions/${suggestionId}`
+    questions: {
+      collection: (clientId) => `clients/${clientId}/questions`,
+      doc: (clientId, questionId) => `clients/${clientId}/questions/${questionId}`
     },
     resumeLinks: {
       collection: (clientId) => `clients/${clientId}/resumeLinks`,
       doc: (clientId, resumeLinkId) => `clients/${clientId}/resumeLinks/${resumeLinkId}`
+    },
+    vacancySuggestions: {
+      collection: (clientId) => `clients/${clientId}/vacancySuggestions`,
+      doc: (clientId, suggestionId) => `clients/${clientId}/vacancySuggestions/${suggestionId}`
     }
   },
   users: {
@@ -100,12 +108,12 @@ var firestorePaths = {
     doc: (clientDataId) => `clientData/${clientDataId}`
   },
   clientLogins: {
-    collection: (userId) => `clientLogins/${userId}/logins`,
-    doc: (userId, domain) => `clientLogins/${userId}/logins/${domain}`
+    collection: (clientId) => `clients/${clientId}/logins`,
+    doc: (clientId, domain) => `clients/${clientId}/logins/${domain}`
   },
-  gmailMessages: {
-    collection: (clientId) => `clientEmails/${clientId}/messages`,
-    doc: (clientId, messageId) => `clientEmails/${clientId}/messages/${messageId}`
+  clientEmails: {
+    collection: (clientId) => `clients/${clientId}/emails`,
+    doc: (clientId, messageId) => `clients/${clientId}/emails/${messageId}`
   }
 };
 export {

package/package.json

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