joye-backend-utility 8.1.8 → 8.2.0

package/dist/database.js

@@ -56,6 +56,7 @@ class database {
             con.model('User_Profile', schema_1.UserProfileSchema);
             con.model('AI_Responses_Tracking', schema_1.AIResponsesTrackingSchema);
             con.model('User_Analytic', schema_1.UserAnalyticSchema);
+            con.model('Llm_Batch_Job', schema_1.LlmBatchJobSchema);
             con.model('AI_Prompts', schema_1.AIPromptsSchema);
             con.model('Page_View', schema_1.PageViewSchema);
             con.model('Error_Log', schema_1.ErrorLogSchema);

package/dist/index.d.ts

@@ -5,3 +5,5 @@ export { createToken, jwtVerify } from './jwt';
 export { getPreviousWorkday, get2ndLastPreviousWorkday, addDays, addMinutes, addYears, getCurrentDateTime, getCurrentUtcTime, newDate, getDatesBetweenRange, getMoment, getCurrentEpoch, } from './dateTime';
 export { RedisClient } from './redisClient';
 export { hasDailySuggestionFlag } from './userAnalytic';
+export { LlmBatchJobSchema, LLM_BATCH_IN_PROGRESS_ITEM_STATUSES } from './schema/llm_batch_job';
+export type { LlmBatchItemStatus, LlmBatchJobStatus, LlmBatchProvider } from './schema/llm_batch_job';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasDailySuggestionFlag = exports.RedisClient = exports.getCurrentEpoch = exports.getMoment = exports.getDatesBetweenRange = exports.newDate = exports.getCurrentUtcTime = exports.getCurrentDateTime = exports.addYears = exports.addMinutes = exports.addDays = exports.get2ndLastPreviousWorkday = exports.getPreviousWorkday = exports.jwtVerify = exports.createToken = exports.createUuid = exports.createHashPassword = void 0;
+exports.LLM_BATCH_IN_PROGRESS_ITEM_STATUSES = exports.LlmBatchJobSchema = exports.hasDailySuggestionFlag = exports.RedisClient = exports.getCurrentEpoch = exports.getMoment = exports.getDatesBetweenRange = exports.newDate = exports.getCurrentUtcTime = exports.getCurrentDateTime = exports.addYears = exports.addMinutes = exports.addDays = exports.get2ndLastPreviousWorkday = exports.getPreviousWorkday = exports.jwtVerify = exports.createToken = exports.createUuid = exports.createHashPassword = void 0;
 const database_1 = require("./database");
 exports.default = database_1.default;
 var util_1 = require("./util");
@@ -26,3 +26,6 @@ var redisClient_1 = require("./redisClient");
 Object.defineProperty(exports, "RedisClient", { enumerable: true, get: function () { return redisClient_1.RedisClient; } });
 var userAnalytic_1 = require("./userAnalytic");
 Object.defineProperty(exports, "hasDailySuggestionFlag", { enumerable: true, get: function () { return userAnalytic_1.hasDailySuggestionFlag; } });
+var llm_batch_job_1 = require("./schema/llm_batch_job");
+Object.defineProperty(exports, "LlmBatchJobSchema", { enumerable: true, get: function () { return llm_batch_job_1.LlmBatchJobSchema; } });
+Object.defineProperty(exports, "LLM_BATCH_IN_PROGRESS_ITEM_STATUSES", { enumerable: true, get: function () { return llm_batch_job_1.LLM_BATCH_IN_PROGRESS_ITEM_STATUSES; } });

package/dist/schema/index.d.ts

@@ -47,6 +47,7 @@ export { UserChatSessionSchema } from './userChatSession';
 export { UserProfileSchema } from './userProfile';
 export { AIResponsesTrackingSchema } from './ai_responses_tracking';
 export { UserAnalyticSchema } from './user_analytic';
+export { LlmBatchJobSchema } from './llm_batch_job';
 export { AIPromptsSchema } from './ai_prompts';
 export { PageViewSchema } from './pageView';
 export { ErrorLogSchema } from './errorLog';

package/dist/schema/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AIPromptsSchema = exports.UserAnalyticSchema = exports.AIResponsesTrackingSchema = exports.UserProfileSchema = exports.UserChatSessionSchema = exports.FeatureFeedbackSchema = exports.UserWeekActivitySchema = exports.UserTrainingRemindersSchema = exports.UserTrainingDailyDataSchema = exports.MasterTrainingDaysSchema = exports.UserTrainingWeekDataSchema = exports.UserTrainingDataSchema = exports.MasterTrainingWeekSchema = exports.MasterTrainingSchema = exports.userJoyLevelQaSchema = exports.userGoalSchema = exports.OrganizationUserAttrPermissionSchema = exports.TimezoneSchema = exports.UserVideoSchema = exports.UserFeedbackSchema = exports.UserReminderSchema = exports.MasterLinkCardSchema = exports.UserRecommendationSchema = exports.MasterSuggestionsParameterSchema = exports.MasterSuggestionsMessageSchema = exports.MasterBlessingsDataSchema = exports.MasterVideoSchema = exports.DatabaseInfoSchema = exports.UserSchema = exports.UserNotificationLogSchema = exports.UserMessageLogSchema = exports.UserMessageSchema = exports.UserMeetingSchema = exports.UserLogSchema = exports.PlatformSchema = exports.OrganizationAnalyticsSchema = exports.OrganizationSchema = exports.MasterThemeMessageSchema = exports.MasterThemeDataSchema = exports.MasterPredictionEmotionsMessageMappingSchema = exports.MasterPredictionEmotionMessageSchema = exports.MasterPredictionEmotionSchema = exports.MasterPodcastSchema = exports.MasterEmotionMessageTypeThemeMappingSchema = exports.MasterEmotionsMessageMappingSchemaV2 = exports.MasterEmotionsMessageMappingSchema = exports.MasterEmotionsSchema = exports.MasterDataSchema = exports.MasterAppSettingSchema = exports.BrewSchema = void 0;
-exports.UserEmotionalHealthDetailSchema = exports.UserEmotionalHealthSchema = exports.UserWellbeingDataSchema = exports.UserSuperPowerDataSchema = exports.MasterSuperPowerRuleSchema = exports.MasterSuperPowerDataSchema = exports.MasterEmotionalHealthSchema = exports.MasterEmotionalDriverSchema = exports.MasterEmotionsSchemaV2 = exports.ErrorLogSchema = exports.PageViewSchema = void 0;
+exports.LlmBatchJobSchema = exports.UserAnalyticSchema = exports.AIResponsesTrackingSchema = exports.UserProfileSchema = exports.UserChatSessionSchema = exports.FeatureFeedbackSchema = exports.UserWeekActivitySchema = exports.UserTrainingRemindersSchema = exports.UserTrainingDailyDataSchema = exports.MasterTrainingDaysSchema = exports.UserTrainingWeekDataSchema = exports.UserTrainingDataSchema = exports.MasterTrainingWeekSchema = exports.MasterTrainingSchema = exports.userJoyLevelQaSchema = exports.userGoalSchema = exports.OrganizationUserAttrPermissionSchema = exports.TimezoneSchema = exports.UserVideoSchema = exports.UserFeedbackSchema = exports.UserReminderSchema = exports.MasterLinkCardSchema = exports.UserRecommendationSchema = exports.MasterSuggestionsParameterSchema = exports.MasterSuggestionsMessageSchema = exports.MasterBlessingsDataSchema = exports.MasterVideoSchema = exports.DatabaseInfoSchema = exports.UserSchema = exports.UserNotificationLogSchema = exports.UserMessageLogSchema = exports.UserMessageSchema = exports.UserMeetingSchema = exports.UserLogSchema = exports.PlatformSchema = exports.OrganizationAnalyticsSchema = exports.OrganizationSchema = exports.MasterThemeMessageSchema = exports.MasterThemeDataSchema = exports.MasterPredictionEmotionsMessageMappingSchema = exports.MasterPredictionEmotionMessageSchema = exports.MasterPredictionEmotionSchema = exports.MasterPodcastSchema = exports.MasterEmotionMessageTypeThemeMappingSchema = exports.MasterEmotionsMessageMappingSchemaV2 = exports.MasterEmotionsMessageMappingSchema = exports.MasterEmotionsSchema = exports.MasterDataSchema = exports.MasterAppSettingSchema = exports.BrewSchema = void 0;
+exports.UserEmotionalHealthDetailSchema = exports.UserEmotionalHealthSchema = exports.UserWellbeingDataSchema = exports.UserSuperPowerDataSchema = exports.MasterSuperPowerRuleSchema = exports.MasterSuperPowerDataSchema = exports.MasterEmotionalHealthSchema = exports.MasterEmotionalDriverSchema = exports.MasterEmotionsSchemaV2 = exports.ErrorLogSchema = exports.PageViewSchema = exports.AIPromptsSchema = void 0;
 var brew_1 = require("./brew");
 Object.defineProperty(exports, "BrewSchema", { enumerable: true, get: function () { return brew_1.BrewSchema; } });
 var masterAppSetting_1 = require("./masterAppSetting");
@@ -100,6 +100,8 @@ var ai_responses_tracking_1 = require("./ai_responses_tracking");
 Object.defineProperty(exports, "AIResponsesTrackingSchema", { enumerable: true, get: function () { return ai_responses_tracking_1.AIResponsesTrackingSchema; } });
 var user_analytic_1 = require("./user_analytic");
 Object.defineProperty(exports, "UserAnalyticSchema", { enumerable: true, get: function () { return user_analytic_1.UserAnalyticSchema; } });
+var llm_batch_job_1 = require("./llm_batch_job");
+Object.defineProperty(exports, "LlmBatchJobSchema", { enumerable: true, get: function () { return llm_batch_job_1.LlmBatchJobSchema; } });
 var ai_prompts_1 = require("./ai_prompts");
 Object.defineProperty(exports, "AIPromptsSchema", { enumerable: true, get: function () { return ai_prompts_1.AIPromptsSchema; } });
 var pageView_1 = require("./pageView");

package/dist/schema/llm_batch_job.d.ts

@@ -0,0 +1,13 @@
+import { Schema } from 'mongoose';
+/**
+ * Provider-neutral LLM batch job store (Gemini Batch today; Claude Message Batches later).
+ * Collection / model name: `Llm_Batch_Job`
+ */
+/** Item-level statuses for one request inside an LLM batch job. */
+export declare type LlmBatchItemStatus = 'queued' | 'submitted' | 'succeeded' | 'failed' | 'timed_out' | 'fallback_sync' | 'fallback_local';
+/** Job-level statuses on `Llm_Batch_Job`. */
+export declare type LlmBatchJobStatus = 'open' | 'submitted' | 'succeeded' | 'failed' | 'timed_out' | 'cancelled';
+/** LLM vendor for this batch — keep jobs isolated across providers. */
+export declare type LlmBatchProvider = 'gemini' | 'claude';
+export declare const LLM_BATCH_IN_PROGRESS_ITEM_STATUSES: LlmBatchItemStatus[];
+export declare const LlmBatchJobSchema: Schema<import("mongoose").Document<any, any, any>, import("mongoose").Model<import("mongoose").Document<any, any, any>, any, any>, undefined, {}>;

package/dist/schema/llm_batch_job.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmBatchJobSchema = exports.LLM_BATCH_IN_PROGRESS_ITEM_STATUSES = void 0;
+const mongoose_1 = require("mongoose");
+exports.LLM_BATCH_IN_PROGRESS_ITEM_STATUSES = ['queued', 'submitted'];
+const LlmBatchJobItemSchema = new mongoose_1.Schema({
+    key: { type: String, required: true },
+    analyticsId: { type: String, required: true, index: true },
+    employeeId: { type: String, required: true },
+    period: { type: String, required: true },
+    date: { type: String, required: true },
+    bucket: { type: Number, required: false },
+    status: { type: String, required: true, default: 'queued' },
+    error: { type: String, required: false },
+    /** Provider-specific request payload (GenerateContent / Messages batch body). */
+    request: { type: mongoose_1.Schema.Types.Mixed, required: true },
+}, { _id: false });
+exports.LlmBatchJobSchema = new mongoose_1.Schema({
+    /** `gemini` | `claude` — required so providers never share an open job. */
+    provider: {
+        type: String,
+        required: true,
+        index: true,
+    },
+    /** Optional feature/purpose tag, e.g. `databricks-analytics`. */
+    purpose: {
+        type: String,
+        required: false,
+        index: true,
+    },
+    /** Remote provider job id/name (e.g. Gemini `batches/...`). */
+    batchName: { type: String, required: false, index: true },
+    displayName: { type: String, required: true },
+    state: { type: String, required: true, default: 'open', index: true },
+    /** Model id used for the batch (e.g. gemini-3.5-flash-lite / claude-sonnet-4-6). */
+    model: { type: String, required: false },
+    createdAt: { type: Number, required: true },
+    submittedAt: { type: Number, required: false },
+    completedAt: { type: Number, required: false },
+    lastPolledAt: { type: Number, required: false },
+    requestCount: { type: Number, required: false, default: 0 },
+    items: { type: [LlmBatchJobItemSchema], default: [] },
+});
+exports.LlmBatchJobSchema.index({ 'items.analyticsId': 1, 'items.status': 1 });
+exports.LlmBatchJobSchema.index({ provider: 1, state: 1, createdAt: -1 });
+exports.LlmBatchJobSchema.index({ provider: 1, purpose: 1, state: 1 });

package/dist/schema/userProfile.js

@@ -99,4 +99,10 @@ UserProfile.index({ employeeId: 1, date: -1, type: -1 }, {
 UserProfile.index({ employeeId: 1, week: -1, type: -1 }, {
     unique: false,
 });
+// Analytics and profile lookups filter { employeeId, type } with no date.
+// Without this compound, Cosmos cannot use (employeeId, date, type) and scans.
+// Create this index in Cosmos Data Explorer if autoIndex is off.
+UserProfile.index({ employeeId: 1, type: 1 }, {
+    unique: false,
+});
 exports.UserProfileSchema = UserProfile;

package/dist/schema/userSuperPowerData.js

@@ -126,4 +126,6 @@ const UserSuperPowerData = new mongoose_1.Schema({
 UserSuperPowerData.index({ employeeId: 1, dimensionKey: 1 });
 UserSuperPowerData.index({ employeeId: 1, year: 1, month: 1, feature: 1 });
 UserSuperPowerData.index({ date: -1 });
+// Organization analytics queries { employeeId, date: { $in } }.
+UserSuperPowerData.index({ employeeId: 1, date: -1 });
 exports.UserSuperPowerDataSchema = UserSuperPowerData;

package/dist/schema/userTrainingData.js

@@ -19,6 +19,7 @@ const UserTrainingData = new mongoose_1.Schema({
     employeeId: {
         type: String,
         required: true,
+        index: true,
     },
     startWeek: {
         type: String,
@@ -94,4 +95,7 @@ const UserTrainingData = new mongoose_1.Schema({
         required: false,
     },
 });
+// Organization analytics queries { employeeId, startDate: { $in } }.
+// Create this index in Cosmos Data Explorer if autoIndex is off.
+UserTrainingData.index({ employeeId: 1, startDate: -1 });
 exports.UserTrainingDataSchema = UserTrainingData;

package/dist/schema/user_analytic.js

@@ -142,11 +142,29 @@ const UserAnalytic = new mongoose_1.Schema({
         type: Boolean,
         required: false,
     },
-    /** Claude model used for weekly insights generation (Databricks cron). */
+    /** Claude/Gemini model used for weekly insights generation (Databricks cron). */
     model: {
         type: String,
         required: false,
     },
+    /** How AI insights were produced: batch | sync | fallback-local */
+    aiInsightsSource: {
+        type: String,
+        required: false,
+    },
+    /** Set when batch path failed/timed out and sync/fallback was used. */
+    aiInsightsBatchError: {
+        type: String,
+        required: false,
+    },
+    aiInsightsBatchKey: {
+        type: String,
+        required: false,
+    },
+    aiInsightsBatchName: {
+        type: String,
+        required: false,
+    },
     inputToken: {
         type: Number,
         required: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "joye-backend-utility",
-  "version": "8.1.8",
+  "version": "8.2.0",
   "description": "Joye backend utility for db functions and common functions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",