joye-backend-utility 8.0.10 → 8.1.1

package/dist/index.d.ts

@@ -4,3 +4,4 @@ export { createHashPassword, createUuid } from './util';
 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';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.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");
@@ -24,3 +24,5 @@ Object.defineProperty(exports, "getMoment", { enumerable: true, get: function ()
 Object.defineProperty(exports, "getCurrentEpoch", { enumerable: true, get: function () { return dateTime_1.getCurrentEpoch; } });
 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; } });

package/dist/schema/user_analytic.js

@@ -125,6 +125,12 @@ const UserAnalytic = new mongoose_1.Schema({
     dailySuggestion: {
         type: Object,
         required: false,
+        // Never add index: true or compound index on this field — large payload, high write RU.
+    },
+    /** Denormalized from `dailySuggestion != null` for indexed queue-cron filters (avoid `$ne: null`). */
+    hasDailySuggestion: {
+        type: Boolean,
+        required: false,
     },
     fallbackData: {
         // To show the data is a fallback data from UI initiated /emotion-data request
@@ -137,7 +143,10 @@ const UserAnalytic = new mongoose_1.Schema({
         required: false,
     },
 });
+// Allowed compound indexes only — never add `dailySuggestion` (large object → high write RU).
+// `autoIndex` is false in `database.ts`; create indexes manually in Cosmos if needed.
 UserAnalytic.index({ employeeId: 1, weekNumber: -1, year: -1, date: -1 });
 UserAnalytic.index({ employeeId: 1, month: -1, year: -1, date: -1 });
-UserAnalytic.index({ year: 1, weekNumber: 1, bucket: 1 });
+UserAnalytic.index({ year: 1, weekNumber: 1, bucket: 1, _id: 1 });
+UserAnalytic.index({ year: 1, weekNumber: 1, hasDailySuggestion: 1, bucket: 1, _id: 1 });
 exports.UserAnalyticSchema = UserAnalytic;

package/dist/userAnalytic.d.ts

@@ -0,0 +1,2 @@
+/** Cosmos-indexable flag: true when `dailySuggestion` is stored on `User_Analytic`. */
+export declare function hasDailySuggestionFlag(dailySuggestion: unknown): boolean;

package/dist/userAnalytic.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasDailySuggestionFlag = void 0;
+/** Cosmos-indexable flag: true when `dailySuggestion` is stored on `User_Analytic`. */
+function hasDailySuggestionFlag(dailySuggestion) {
+    return dailySuggestion != null;
+}
+exports.hasDailySuggestionFlag = hasDailySuggestionFlag;

package/dist/userAnalyticIndexes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `User_Analytic` Cosmos/Mongo index names.
+ *
+ * Do NOT index `dailySuggestion` (large object) — it inflates write RU on every upsert.
+ * Use `hasDailySuggestion` (boolean) in compound indexes instead.
+ */
+/** Manually created in Cosmos for old `$ne: null` cron filter — drop in production. */
+export declare const LEGACY_USER_ANALYTIC_INDEX_NAMES_TO_DROP: readonly ["weekNumber_-1_year_-1_dailySuggestion_1", "weekNumber_1_year_1_dailySuggestion_1"];
+/** Mongoose/Cosmos compound indexes defined in `user_analytic` schema (create if missing). */
+export declare const USER_ANALYTIC_COMPOUND_INDEX_SPECS: readonly [{
+    readonly employeeId: 1;
+    readonly weekNumber: -1;
+    readonly year: -1;
+    readonly date: -1;
+}, {
+    readonly employeeId: 1;
+    readonly month: -1;
+    readonly year: -1;
+    readonly date: -1;
+}, {
+    readonly year: 1;
+    readonly weekNumber: 1;
+    readonly bucket: 1;
+    readonly _id: 1;
+}, {
+    readonly year: 1;
+    readonly weekNumber: 1;
+    readonly hasDailySuggestion: 1;
+    readonly bucket: 1;
+    readonly _id: 1;
+}];

package/dist/userAnalyticIndexes.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * `User_Analytic` Cosmos/Mongo index names.
+ *
+ * Do NOT index `dailySuggestion` (large object) — it inflates write RU on every upsert.
+ * Use `hasDailySuggestion` (boolean) in compound indexes instead.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USER_ANALYTIC_COMPOUND_INDEX_SPECS = exports.LEGACY_USER_ANALYTIC_INDEX_NAMES_TO_DROP = void 0;
+/** Manually created in Cosmos for old `$ne: null` cron filter — drop in production. */
+exports.LEGACY_USER_ANALYTIC_INDEX_NAMES_TO_DROP = [
+    'weekNumber_-1_year_-1_dailySuggestion_1',
+    'weekNumber_1_year_1_dailySuggestion_1',
+];
+/** Mongoose/Cosmos compound indexes defined in `user_analytic` schema (create if missing). */
+exports.USER_ANALYTIC_COMPOUND_INDEX_SPECS = [
+    { employeeId: 1, weekNumber: -1, year: -1, date: -1 },
+    { employeeId: 1, month: -1, year: -1, date: -1 },
+    { year: 1, weekNumber: 1, bucket: 1, _id: 1 },
+    { year: 1, weekNumber: 1, hasDailySuggestion: 1, bucket: 1, _id: 1 },
+];

package/package.json

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