@jobsearch-works/firestore-models 4.3.2 → 4.3.3

package/dist/index.d.mts

@@ -818,6 +818,8 @@ interface Application {
     advertisingDomain?: string;
     description?: string;
     fullPageText?: string;
+    requiresHumanVerification?: boolean;
+    verificationType?: string;
     createdAt?: Date | string;
     updatedAt?: Date | string;
 }
@@ -887,7 +889,6 @@ interface ApplicationRun {
     completedAt?: Date | string;
     tokensUsed?: number;
     summary?: string;
-    log?: string;
     logEntries?: ApplicationRunLogEntry[];
     failureReason?: string;
     triggeredBy: ApplicationRunTrigger;
@@ -897,22 +898,25 @@ interface ApplicationRun {
 }
 
 /**
- * Daily statistics for application submissions and archivals
- * Stored in a single document per client for efficient querying
+ * Statistics for a time period (day, week, or month)
+ * Tracks all application status changes
  */
-interface DailyApplicationStats {
-    /** Number of applications applied (submitted) on this day */
+interface ApplicationPeriodStats {
+    /** Number of applications suggested in this period */
+    suggested: number;
+    /** Number of applications applied (submitted) in this period */
     applied: number;
-    /** Number of applications archived (rejected or withdrawn) on this day */
+    /** Number of applications archived (rejected or withdrawn) in this period */
     archived: number;
+    /** Number of applications that moved to interviewing in this period */
+    interviews: number;
 }
 /**
- * Application statistics aggregated by day
+ * Application statistics aggregated by day, week, and month
  * 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.
+ * Statistics are keyed by date strings for efficient aggregation and querying.
  */
 interface ApplicationStats {
     /** Document ID is the clientId */
@@ -920,13 +924,27 @@ interface ApplicationStats {
     clientId: string;
     /**
      * Daily statistics keyed by date string (YYYY-MM-DD format)
-     * Example: { "2025-01-15": { applied: 3, archived: 1 } }
+     * Example: { "2025-01-15": { suggested: 2, applied: 3, archived: 1, interviews: 0 } }
      */
-    dailyStats: Record<string, DailyApplicationStats>;
+    dailyStats: Record<string, ApplicationPeriodStats>;
+    /**
+     * Weekly statistics keyed by week start date (YYYY-MM-DD format, Monday of the week)
+     * Example: { "2025-01-13": { suggested: 10, applied: 15, archived: 5, interviews: 2 } }
+     */
+    weeklyStats?: Record<string, ApplicationPeriodStats>;
+    /**
+     * Monthly statistics keyed by month (YYYY-MM format)
+     * Example: { "2025-01": { suggested: 45, applied: 60, archived: 20, interviews: 8 } }
+     */
+    monthlyStats?: Record<string, ApplicationPeriodStats>;
+    /** Total count of all applications suggested (ever) */
+    totalSuggested: number;
     /** Total count of all applications applied (ever) */
     totalApplied: number;
     /** Total count of all applications archived (ever) */
     totalArchived: number;
+    /** Total count of all applications that reached interview stage (ever) */
+    totalInterviews: number;
     /** Last time stats were updated */
     updatedAt?: Date | string;
     /** When this stats document was created */
@@ -1258,4 +1276,4 @@ declare const firestorePaths: {
     };
 };
 
-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 };
+export { Address, AdminReport, Agent, AgentStatus, Application, ApplicationPeriodStats, 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, 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

@@ -818,6 +818,8 @@ interface Application {
     advertisingDomain?: string;
     description?: string;
     fullPageText?: string;
+    requiresHumanVerification?: boolean;
+    verificationType?: string;
     createdAt?: Date | string;
     updatedAt?: Date | string;
 }
@@ -887,7 +889,6 @@ interface ApplicationRun {
     completedAt?: Date | string;
     tokensUsed?: number;
     summary?: string;
-    log?: string;
     logEntries?: ApplicationRunLogEntry[];
     failureReason?: string;
     triggeredBy: ApplicationRunTrigger;
@@ -897,22 +898,25 @@ interface ApplicationRun {
 }
 
 /**
- * Daily statistics for application submissions and archivals
- * Stored in a single document per client for efficient querying
+ * Statistics for a time period (day, week, or month)
+ * Tracks all application status changes
  */
-interface DailyApplicationStats {
-    /** Number of applications applied (submitted) on this day */
+interface ApplicationPeriodStats {
+    /** Number of applications suggested in this period */
+    suggested: number;
+    /** Number of applications applied (submitted) in this period */
     applied: number;
-    /** Number of applications archived (rejected or withdrawn) on this day */
+    /** Number of applications archived (rejected or withdrawn) in this period */
     archived: number;
+    /** Number of applications that moved to interviewing in this period */
+    interviews: number;
 }
 /**
- * Application statistics aggregated by day
+ * Application statistics aggregated by day, week, and month
  * 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.
+ * Statistics are keyed by date strings for efficient aggregation and querying.
  */
 interface ApplicationStats {
     /** Document ID is the clientId */
@@ -920,13 +924,27 @@ interface ApplicationStats {
     clientId: string;
     /**
      * Daily statistics keyed by date string (YYYY-MM-DD format)
-     * Example: { "2025-01-15": { applied: 3, archived: 1 } }
+     * Example: { "2025-01-15": { suggested: 2, applied: 3, archived: 1, interviews: 0 } }
      */
-    dailyStats: Record<string, DailyApplicationStats>;
+    dailyStats: Record<string, ApplicationPeriodStats>;
+    /**
+     * Weekly statistics keyed by week start date (YYYY-MM-DD format, Monday of the week)
+     * Example: { "2025-01-13": { suggested: 10, applied: 15, archived: 5, interviews: 2 } }
+     */
+    weeklyStats?: Record<string, ApplicationPeriodStats>;
+    /**
+     * Monthly statistics keyed by month (YYYY-MM format)
+     * Example: { "2025-01": { suggested: 45, applied: 60, archived: 20, interviews: 8 } }
+     */
+    monthlyStats?: Record<string, ApplicationPeriodStats>;
+    /** Total count of all applications suggested (ever) */
+    totalSuggested: number;
     /** Total count of all applications applied (ever) */
     totalApplied: number;
     /** Total count of all applications archived (ever) */
     totalArchived: number;
+    /** Total count of all applications that reached interview stage (ever) */
+    totalInterviews: number;
     /** Last time stats were updated */
     updatedAt?: Date | string;
     /** When this stats document was created */
@@ -1258,4 +1276,4 @@ declare const firestorePaths: {
     };
 };
 
-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 };
+export { Address, AdminReport, Agent, AgentStatus, Application, ApplicationPeriodStats, 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, EMAIL_CATEGORIES, Education, EmailCategory, EmailLog, Experience, FirestoreTimestamp, GmailOAuthSession, JobCategory, JobTitle, LocationId, Project, UserPublic, Vacancy, VacancyCategory, VacancySuggestion, countries, firestorePaths, initialQuestions, jobClassifications, locations };

package/package.json

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