@jobsearch-works/firestore-models 4.2.8 → 4.3.0

package/dist/index.d.mts

@@ -861,6 +861,17 @@ interface ApplicationRunMetadata {
     fieldsCompleted?: number;
     durationSeconds?: number;
 }
+/**
+ * Structured log entry for automation runs
+ * Provides better querying, filtering, and UI display than plain text logs
+ */
+interface ApplicationRunLogEntry {
+    timestamp: Date | string;
+    message: string;
+    level?: "info" | "success" | "warning" | "error";
+    step?: string;
+    metadata?: Record<string, any>;
+}
 interface ApplicationRun {
     id?: string;
     applicationId: string;
@@ -873,6 +884,7 @@ interface ApplicationRun {
     tokensUsed?: number;
     summary?: string;
     log?: string;
+    logEntries?: ApplicationRunLogEntry[];
     failureReason?: string;
     triggeredBy: ApplicationRunTrigger;
     metadata?: ApplicationRunMetadata;
@@ -880,6 +892,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
@@ -1197,6 +1246,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, ApplicationRunLogEntry, 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

@@ -861,6 +861,17 @@ interface ApplicationRunMetadata {
     fieldsCompleted?: number;
     durationSeconds?: number;
 }
+/**
+ * Structured log entry for automation runs
+ * Provides better querying, filtering, and UI display than plain text logs
+ */
+interface ApplicationRunLogEntry {
+    timestamp: Date | string;
+    message: string;
+    level?: "info" | "success" | "warning" | "error";
+    step?: string;
+    metadata?: Record<string, any>;
+}
 interface ApplicationRun {
     id?: string;
     applicationId: string;
@@ -873,6 +884,7 @@ interface ApplicationRun {
     tokensUsed?: number;
     summary?: string;
     log?: string;
+    logEntries?: ApplicationRunLogEntry[];
     failureReason?: string;
     triggeredBy: ApplicationRunTrigger;
     metadata?: ApplicationRunMetadata;
@@ -880,6 +892,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
@@ -1197,6 +1246,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, ApplicationRunLogEntry, 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

@@ -1522,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

@@ -1484,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.8",
+  "version": "4.3.0",
   "description": "A shared library for standardizing Firestore document schemas and paths across multiple projects",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",