@jobsearch-works/firestore-models 4.2.7 → 4.2.9

package/dist/index.d.mts

@@ -880,6 +880,43 @@ interface ApplicationRun {
     updatedAt?: Date | string;
 }
 
+/**
+ * Daily statistics for application submissions and archivals
+ * Stored in a single document per client for efficient querying
+ */
+interface DailyApplicationStats {
+    /** Number of applications applied (submitted) on this day */
+    applied: number;
+    /** Number of applications archived (rejected or withdrawn) on this day */
+    archived: number;
+}
+/**
+ * Application statistics aggregated by day
+ * Path: stats/{clientId}
+ *
+ * One document per client containing all application statistics.
+ * The dailyStats object uses date strings (YYYY-MM-DD format) as keys
+ * for efficient daily aggregation and querying.
+ */
+interface ApplicationStats {
+    /** Document ID is the clientId */
+    id?: string;
+    clientId: string;
+    /**
+     * Daily statistics keyed by date string (YYYY-MM-DD format)
+     * Example: { "2025-01-15": { applied: 3, archived: 1 } }
+     */
+    dailyStats: Record<string, DailyApplicationStats>;
+    /** Total count of all applications applied (ever) */
+    totalApplied: number;
+    /** Total count of all applications archived (ever) */
+    totalArchived: number;
+    /** Last time stats were updated */
+    updatedAt?: Date | string;
+    /** When this stats document was created */
+    createdAt?: Date | string;
+}
+
 /**
  * Embedded sub-object within Client document
  * @see Client - Parent document interface
@@ -1087,7 +1124,7 @@ interface ClientAccessToken {
  * Subcollection document under clients/{userId}/emails/{emailId}
  * For new email structure
  */
-type EmailCategory = "One Time Pin" | "Spam" | "Job Submitted" | "Job Interview" | "Job Accepted" | "Job Rejection" | "Require More Info" | "Job Suggestions" | "Uncategorised";
+type EmailCategory = "One Time Pin" | "Spam" | "Job Submitted" | "Job Interview" | "Job Accepted" | "Job Rejection" | "Vacancy Closed" | "Require More Info" | "Job Suggestions" | "Uncategorised";
 /**
  * Array of all valid EmailCategory values for validation and iteration
  * This ensures consistency across the system
@@ -1197,6 +1234,10 @@ declare const firestorePaths: {
         readonly collection: () => string;
         readonly doc: (authEmail: string) => string;
     };
+    readonly stats: {
+        readonly collection: () => string;
+        readonly doc: (clientId: string) => string;
+    };
 };
 
-export { Address, AdminReport, Agent, AgentStatus, Application, ApplicationQuestion, ApplicationQuestionType, ApplicationQuestionTypeOptions, ApplicationRun, ApplicationRunMetadata, ApplicationRunOutcome, ApplicationRunStatus, ApplicationRunTrigger, ApplicationStatus, AuthEmail, AuthUser, Certification, Client, ClientAccessToken, ClientCompanyPreferences, ClientEmail, ClientGmailToken, ClientInitialQuestion, ClientJobPreferences, ClientLogin, ClientPersonalData, ClientQuestion, ClientResume, ClientStatus, ClientStatusEnum, ClientVirtualInterview, Companies, EMAIL_CATEGORIES, Education, EmailCategory, EmailLog, Experience, FirestoreTimestamp, GmailOAuthSession, JobCategory, JobTitle, LocationId, Project, UserPublic, Vacancy, VacancyCategory, VacancySuggestion, countries, firestorePaths, initialQuestions, jobClassifications, locations };
+export { Address, AdminReport, Agent, AgentStatus, Application, ApplicationQuestion, ApplicationQuestionType, ApplicationQuestionTypeOptions, ApplicationRun, ApplicationRunMetadata, ApplicationRunOutcome, ApplicationRunStatus, ApplicationRunTrigger, ApplicationStats, ApplicationStatus, AuthEmail, AuthUser, Certification, Client, ClientAccessToken, ClientCompanyPreferences, ClientEmail, ClientGmailToken, ClientInitialQuestion, ClientJobPreferences, ClientLogin, ClientPersonalData, ClientQuestion, ClientResume, ClientStatus, ClientStatusEnum, ClientVirtualInterview, Companies, DailyApplicationStats, EMAIL_CATEGORIES, Education, EmailCategory, EmailLog, Experience, FirestoreTimestamp, GmailOAuthSession, JobCategory, JobTitle, LocationId, Project, UserPublic, Vacancy, VacancyCategory, VacancySuggestion, countries, firestorePaths, initialQuestions, jobClassifications, locations };

package/dist/index.d.ts

@@ -880,6 +880,43 @@ interface ApplicationRun {
     updatedAt?: Date | string;
 }
 
+/**
+ * Daily statistics for application submissions and archivals
+ * Stored in a single document per client for efficient querying
+ */
+interface DailyApplicationStats {
+    /** Number of applications applied (submitted) on this day */
+    applied: number;
+    /** Number of applications archived (rejected or withdrawn) on this day */
+    archived: number;
+}
+/**
+ * Application statistics aggregated by day
+ * Path: stats/{clientId}
+ *
+ * One document per client containing all application statistics.
+ * The dailyStats object uses date strings (YYYY-MM-DD format) as keys
+ * for efficient daily aggregation and querying.
+ */
+interface ApplicationStats {
+    /** Document ID is the clientId */
+    id?: string;
+    clientId: string;
+    /**
+     * Daily statistics keyed by date string (YYYY-MM-DD format)
+     * Example: { "2025-01-15": { applied: 3, archived: 1 } }
+     */
+    dailyStats: Record<string, DailyApplicationStats>;
+    /** Total count of all applications applied (ever) */
+    totalApplied: number;
+    /** Total count of all applications archived (ever) */
+    totalArchived: number;
+    /** Last time stats were updated */
+    updatedAt?: Date | string;
+    /** When this stats document was created */
+    createdAt?: Date | string;
+}
+
 /**
  * Embedded sub-object within Client document
  * @see Client - Parent document interface
@@ -1087,7 +1124,7 @@ interface ClientAccessToken {
  * Subcollection document under clients/{userId}/emails/{emailId}
  * For new email structure
  */
-type EmailCategory = "One Time Pin" | "Spam" | "Job Submitted" | "Job Interview" | "Job Accepted" | "Job Rejection" | "Require More Info" | "Job Suggestions" | "Uncategorised";
+type EmailCategory = "One Time Pin" | "Spam" | "Job Submitted" | "Job Interview" | "Job Accepted" | "Job Rejection" | "Vacancy Closed" | "Require More Info" | "Job Suggestions" | "Uncategorised";
 /**
  * Array of all valid EmailCategory values for validation and iteration
  * This ensures consistency across the system
@@ -1197,6 +1234,10 @@ declare const firestorePaths: {
         readonly collection: () => string;
         readonly doc: (authEmail: string) => string;
     };
+    readonly stats: {
+        readonly collection: () => string;
+        readonly doc: (clientId: string) => string;
+    };
 };
 
-export { Address, AdminReport, Agent, AgentStatus, Application, ApplicationQuestion, ApplicationQuestionType, ApplicationQuestionTypeOptions, ApplicationRun, ApplicationRunMetadata, ApplicationRunOutcome, ApplicationRunStatus, ApplicationRunTrigger, ApplicationStatus, AuthEmail, AuthUser, Certification, Client, ClientAccessToken, ClientCompanyPreferences, ClientEmail, ClientGmailToken, ClientInitialQuestion, ClientJobPreferences, ClientLogin, ClientPersonalData, ClientQuestion, ClientResume, ClientStatus, ClientStatusEnum, ClientVirtualInterview, Companies, EMAIL_CATEGORIES, Education, EmailCategory, EmailLog, Experience, FirestoreTimestamp, GmailOAuthSession, JobCategory, JobTitle, LocationId, Project, UserPublic, Vacancy, VacancyCategory, VacancySuggestion, countries, firestorePaths, initialQuestions, jobClassifications, locations };
+export { Address, AdminReport, Agent, AgentStatus, Application, ApplicationQuestion, ApplicationQuestionType, ApplicationQuestionTypeOptions, ApplicationRun, ApplicationRunMetadata, ApplicationRunOutcome, ApplicationRunStatus, ApplicationRunTrigger, ApplicationStats, ApplicationStatus, AuthEmail, AuthUser, Certification, Client, ClientAccessToken, ClientCompanyPreferences, ClientEmail, ClientGmailToken, ClientInitialQuestion, ClientJobPreferences, ClientLogin, ClientPersonalData, ClientQuestion, ClientResume, ClientStatus, ClientStatusEnum, ClientVirtualInterview, Companies, DailyApplicationStats, EMAIL_CATEGORIES, Education, EmailCategory, EmailLog, Experience, FirestoreTimestamp, GmailOAuthSession, JobCategory, JobTitle, LocationId, Project, UserPublic, Vacancy, VacancyCategory, VacancySuggestion, countries, firestorePaths, initialQuestions, jobClassifications, locations };

package/dist/index.js

@@ -1443,6 +1443,7 @@ var EMAIL_CATEGORIES = [
   "Job Interview",
   "Job Accepted",
   "Job Rejection",
+  "Vacancy Closed",
   "Require More Info",
   "Job Suggestions",
   "Uncategorised"
@@ -1521,6 +1522,10 @@ var firestorePaths = {
   authEmails: {
     collection: () => "authEmails",
     doc: (authEmail) => `authEmails/${authEmail}`
+  },
+  stats: {
+    collection: () => "stats",
+    doc: (clientId) => `stats/${clientId}`
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -1405,6 +1405,7 @@ var EMAIL_CATEGORIES = [
   "Job Interview",
   "Job Accepted",
   "Job Rejection",
+  "Vacancy Closed",
   "Require More Info",
   "Job Suggestions",
   "Uncategorised"
@@ -1483,6 +1484,10 @@ var firestorePaths = {
   authEmails: {
     collection: () => "authEmails",
     doc: (authEmail) => `authEmails/${authEmail}`
+  },
+  stats: {
+    collection: () => "stats",
+    doc: (clientId) => `stats/${clientId}`
   }
 };
 export {

package/package.json

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