law-common 14.0.3-beta.0 → 14.0.3-beta.10

package/dist/src/entities/interface/timesheet.entity.interface.d.ts

@@ -1,6 +1,7 @@
 import { TimesheetClassificationStatusEnum } from "../enums/timesheet_classification_status_enum";
 import { TimesheetStatusEnum } from "../enums/timesheet_status_enum";
 import { IEntityAuditColumn } from "./entity-audit-columns.interface";
+import { Nullable } from "./entity.utils.interface";
 export interface ITimesheetEntity extends IEntityAuditColumn {
     id: number;
     userId: number;
@@ -15,6 +16,6 @@ export interface ITimesheetEntity extends IEntityAuditColumn {
     billedDuration?: number;
     notBilledDuration?: number;
     classificationStatus: TimesheetClassificationStatusEnum;
-    classifiedBy?: number;
+    classifiedBy?: Nullable<number>;
 }
 export type PendingApprovalStatus = TimesheetStatusEnum.CREATE_APPROVAL_PENDING | TimesheetStatusEnum.UPDATE_APPROVAL_PENDING | TimesheetStatusEnum.DELETE_APPROVAL_PENDING | TimesheetStatusEnum.RESOLVED_REJECTED;

package/dist/src/entities/model/timesheet.entity.model.d.ts

@@ -1,4 +1,4 @@
-import { ITimesheetUpdateDto, ITimesheetFlowContextData } from "../../api";
+import { ITimesheetFlowContextData, ITimesheetUpdateDto } from "../../api";
 import { CurrencyEnum } from "../../enums";
 import { IClassificationWindowConfig, ITimesheetActionItem, SortableTimesheet } from "../../model/entities/interface/timesheet.model.interface";
 import { TimesheetClassificationStatusEnum } from "../enums/timesheet_classification_status_enum";
@@ -51,11 +51,33 @@ export declare class TimesheetEntityModel extends BaseEntityModel<EntityEnum.TIM
     get latestStatusFromHistory(): TimesheetStatusEnum | undefined;
     getDateCodeDay(): number;
     getClassificationDeadline(config: IClassificationWindowConfig): Date;
+    /**
+     * IST point-in-time AUTO-CLASSIFY trigger. Returns the classification window
+     * whose `endDay + bufferDays + 1 == today` (IST) — i.e. it fires on a SINGLE day
+     * per window (the auto-classify cron runs at 01:00 IST each morning).
+     * Trailing window (endDay === null) evaluates against the PREVIOUS month's EOM.
+     *
+     * "today" is `getTodayInIST()` (IST calendar day). Concrete per getTodayInIST()
+     * rollover rule: endDay 13 + buffer 3 -> trigger IST day 17; that 01:00 IST IS
+     * UTC 19:30 the PREVIOUS day, so a UTC-default container reads getDate() = 16 ->
+     * 17 !== 16 -> returns null -> auto-classification silently no-ops.
+     */
     static getTimesheetAutoClassificationDateCodeRange(config: IClassificationWindowConfig): {
         windowStart: string;
         windowEnd: string;
     } | null;
-    static getActiveClassificationWindowRange(config: IClassificationWindowConfig): {
+    /**
+     * Resolves the classification window that contains `now` (used by the reminder).
+     * `now` defaults to the IST calendar day (getTodayInIST()).
+     *
+     * Boundary examples per getTodayInIST() rollover rule (IST < 05:30 -> UTC prev day):
+     *   IST day 1 00:xx   -> UTC last day of the PREVIOUS month
+     *                        (a UTC clock would skip the day-1-3 spillover onto the
+     *                        prev-month 21-EOM window);
+     *   IST day 21 00:30  -> UTC day 20
+     *                        (a UTC clock would miss the current-month 21-EOM tail).
+     */
+    static getActiveClassificationWindowRange(config: IClassificationWindowConfig, now?: Date): {
         windowStart: string;
         windowEnd: string;
     } | null;
@@ -63,5 +85,12 @@ export declare class TimesheetEntityModel extends BaseEntityModel<EntityEnum.TIM
         startDay: number;
         endDay: Nullable<number>;
     }>;
+    /**
+     * Fields on a timesheet that, when changed via an UPDATE, reset the timesheet's
+     * `classificationStatus` back to `PENDING`. Shared by backend (toUpdateDto) and frontend
+     * (edit warning). `billingId` intentionally NOT included — a billing change does not reset
+     * classification. Anything not listed here is by definition "non-reset".
+     */
+    static timesheetClassificationResetFieldsSet(): string[];
     static sortByProjectAndDesignation(data: SortableTimesheet[], designations: IDesignationEntity[]): SortableTimesheet[];
 }

package/dist/src/entities/model/timesheet.entity.model.js

@@ -84,8 +84,10 @@ class TimesheetEntityModel extends base_entity_model_1.BaseEntityModel {
                 return false;
             if (actionKey === timesheet_action_enum_1.TimesheetActionEnum.CLASSIFY)
                 return false;
-            if (actionKey === timesheet_action_enum_1.TimesheetActionEnum.UPDATE && this.classificationStatus && this.classificationStatus !== timesheet_classification_status_enum_1.TimesheetClassificationStatusEnum.PENDING)
-                return false;
+            // LW-842: allow UPDATE regardless of classification status — the backend now resets
+            // classificationStatus to PENDING in toUpdateDto when a reset-field changes.
+            // if (actionKey === TimesheetActionEnum.UPDATE && this.classificationStatus && this.classificationStatus !== TimesheetClassificationStatusEnum.PENDING)
+            //   return false;
             return true;
         })
             .map(([actionKey, actionConfig]) => {
@@ -225,10 +227,21 @@ class TimesheetEntityModel extends base_entity_model_1.BaseEntityModel {
         d.setHours(23, 59, 59, 999);
         return d;
     }
+    /**
+     * IST point-in-time AUTO-CLASSIFY trigger. Returns the classification window
+     * whose `endDay + bufferDays + 1 == today` (IST) — i.e. it fires on a SINGLE day
+     * per window (the auto-classify cron runs at 01:00 IST each morning).
+     * Trailing window (endDay === null) evaluates against the PREVIOUS month's EOM.
+     *
+     * "today" is `getTodayInIST()` (IST calendar day). Concrete per getTodayInIST()
+     * rollover rule: endDay 13 + buffer 3 -> trigger IST day 17; that 01:00 IST IS
+     * UTC 19:30 the PREVIOUS day, so a UTC-default container reads getDate() = 16 ->
+     * 17 !== 16 -> returns null -> auto-classification silently no-ops.
+     */
     static getTimesheetAutoClassificationDateCodeRange(config) {
         var _a;
         const { bufferDays, windows } = config;
-        const today = new Date();
+        const today = (0, utils_1.getTodayInIST)();
         for (const window of windows) {
             // Last window (endDay === null) belongs to the previous month
             const targetDate = window.endDay === null ? (0, date_fns_1.subMonths)(today, 1) : today;
@@ -245,35 +258,54 @@ class TimesheetEntityModel extends base_entity_model_1.BaseEntityModel {
         }
         return null;
     }
-    static getActiveClassificationWindowRange(config) {
-        var _a;
-        const { bufferDays, windows } = config;
-        const today = new Date();
-        const day = today.getDate();
-        const year = today.getFullYear();
-        const month = today.getMonth();
+    /**
+     * Resolves the classification window that contains `now` (used by the reminder).
+     * `now` defaults to the IST calendar day (getTodayInIST()).
+     *
+     * Boundary examples per getTodayInIST() rollover rule (IST < 05:30 -> UTC prev day):
+     *   IST day 1 00:xx   -> UTC last day of the PREVIOUS month
+     *                        (a UTC clock would skip the day-1-3 spillover onto the
+     *                        prev-month 21-EOM window);
+     *   IST day 21 00:30  -> UTC day 20
+     *                        (a UTC clock would miss the current-month 21-EOM tail).
+     */
+    static getActiveClassificationWindowRange(config, now = (0, utils_1.getTodayInIST)()) {
+        const { bufferDays, windows } = config; // bufferDays = 3
+        const year = now.getFullYear(); // now = Oct 1 2026 -> year = 2026
+        const month = now.getMonth(); // month = 9 (Oct)
+        // Spillover check: does `now` still fall within the PREVIOUS month's trailing
+        // window (21-EOM) plus its buffer? If so, that window is still pending
+        // classification and takes priority over the current month's own windows.
+        const lastWindow = windows[windows.length - 1]; // lastWindow = { startDay: 21, endDay: null }
+        if ((lastWindow === null || lastWindow === void 0 ? void 0 : lastWindow.endDay) === null) {
+            const prevMonthDate = (0, date_fns_1.subMonths)(new Date(year, month, 1), 1); // prevMonthDate = Sep 1 2026
+            const prevYear = prevMonthDate.getFullYear(); // prevYear = 2026
+            const prevMonth = prevMonthDate.getMonth(); // prevMonth = 8 (Sep)
+            const prevMonthEom = (0, date_fns_1.lastDayOfMonth)(prevMonthDate).getDate(); // prevMonthEom = 30
+            const prevWindowStartDate = new Date(prevYear, prevMonth, lastWindow.startDay); // Sep 21 2026
+            prevWindowStartDate.setHours(0, 0, 0, 0); // Sep 21 2026 00:00:00.000
+            const prevWindowEndDate = new Date(prevYear, prevMonth, prevMonthEom); // Sep 30 2026
+            prevWindowEndDate.setHours(23, 59, 59, 999); // Sep 30 2026 23:59:59.999
+            const prevWindowEndDateWithBuffer = (0, date_fns_1.addDays)(new Date(prevYear, prevMonth, prevMonthEom), bufferDays); // Sep30 + 3 -> Oct 3 2026
+            prevWindowEndDateWithBuffer.setHours(23, 59, 59, 999); // Oct 3 2026 23:59:59.999
+            if (now.getTime() >= prevWindowStartDate.getTime() && now.getTime() <= prevWindowEndDateWithBuffer.getTime()) {
+                // Oct1 >= Sep21 -> true, Oct1 <= Oct3 -> true, so this branch matches and returns here
+                return {
+                    windowStart: (0, date_fns_1.format)(prevWindowStartDate, "yyyyMMdd"), // "20260921"
+                    windowEnd: (0, date_fns_1.format)(prevWindowEndDate, "yyyyMMdd"), // "20260930"
+                };
+            }
+        }
         for (const window of windows) {
-            // last window (21–end) belongs to previous month
-            const targetDate = window.endDay === null ? (0, date_fns_1.subMonths)(today, 1) : today;
-            const targetYear = targetDate.getFullYear();
-            const targetMonth = targetDate.getMonth();
-            const actualEndDay = (_a = window.endDay) !== null && _a !== void 0 ? _a : (0, date_fns_1.lastDayOfMonth)(targetDate).getDate();
-            const windowStartDay = window.startDay;
-            const windowEndDay = actualEndDay;
-            // check if today falls within this window's active period
-            // active period = from windowStart until triggerDate (endDay + bufferDays)
-            const triggerDate = (0, date_fns_1.addDays)(new Date(targetYear, targetMonth, actualEndDay), bufferDays);
-            const triggerDay = triggerDate.getDate();
-            const triggerMonth = triggerDate.getMonth();
-            const triggerYear = triggerDate.getFullYear();
-            const todayTime = today.getTime();
-            const windowOpenDate = new Date(targetYear, targetMonth, windowStartDay);
-            const windowCloseDate = new Date(triggerYear, triggerMonth, triggerDay);
-            windowCloseDate.setHours(23, 59, 59, 999);
-            if (todayTime >= windowOpenDate.getTime() && todayTime <= windowCloseDate.getTime()) {
+            const windowStartDate = new Date(year, month, window.startDay);
+            windowStartDate.setHours(0, 0, 0, 0);
+            const windowEndDate = window.endDay === null ? (0, date_fns_1.lastDayOfMonth)(new Date(year, month, 1)) : new Date(year, month, window.endDay);
+            windowEndDate.setHours(23, 59, 59, 999);
+            if (now.getTime() >= windowStartDate.getTime() && now.getTime() <= windowEndDate.getTime()) {
+                // not reached for Oct 1 -- spillover branch already returned above
                 return {
-                    windowStart: (0, date_fns_1.format)(new Date(targetYear, targetMonth, windowStartDay), "yyyyMMdd"),
-                    windowEnd: (0, date_fns_1.format)(new Date(targetYear, targetMonth, windowEndDay), "yyyyMMdd"),
+                    windowStart: (0, date_fns_1.format)(windowStartDate, "yyyyMMdd"),
+                    windowEnd: (0, date_fns_1.format)(windowEndDate, "yyyyMMdd"),
                 };
             }
         }
@@ -288,6 +320,21 @@ class TimesheetEntityModel extends base_entity_model_1.BaseEntityModel {
             };
         });
     }
+    /**
+     * Fields on a timesheet that, when changed via an UPDATE, reset the timesheet's
+     * `classificationStatus` back to `PENDING`. Shared by backend (toUpdateDto) and frontend
+     * (edit warning). `billingId` intentionally NOT included — a billing change does not reset
+     * classification. Anything not listed here is by definition "non-reset".
+     */
+    static timesheetClassificationResetFieldsSet() {
+        return [
+            "userId",
+            "projectId",
+            "dateCode",
+            "totalDuration",
+            // "task", "description",
+        ];
+    }
     static sortByProjectAndDesignation(data, designations) {
         const priorityMap = new Map();
         designations.forEach((d) => {

package/dist/src/utils/date.util.d.ts

@@ -1,3 +1,22 @@
 export declare function compareDates(recordDate: string, buffer: number): boolean;
 export declare function epochToDateStringFormat(epoch: number, format?: string): string;
 export declare function convertDateCodeToFormat(dateString: string, toFormat: string): string;
+/**
+ * Current calendar date resolved in Asia/Kolkata (IST).
+ *
+ * TIMEZONE RULE: IST = UTC + 5:30 (fixed offset, no DST).
+ * Converting IST -> UTC: subtract 5:30.
+ *   - If IST time < 05:30 -> UTC date is the PREVIOUS calendar day.
+ *   - If IST time >= 05:30 -> UTC date is the SAME calendar day.
+ *
+ * Example: IST 01:00 -> UTC 19:30 (prev day).
+ *
+ * Why this matters: the production container (node:20.10-alpine) sets no TZ,
+ * so it defaults to UTC. A bare `new Date().getDate()` at 01:00 IST would read
+ * UTC's date (still "yesterday"), causing classification jobs to target the
+ * wrong day or silently miss their trigger window.
+ *
+ * This function returns a Date whose local getFullYear()/getMonth()/getDate()
+ * always equal the IST calendar date, regardless of container timezone.
+ */
+export declare function getTodayInIST(): Date;

package/dist/src/utils/date.util.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.compareDates = compareDates;
 exports.epochToDateStringFormat = epochToDateStringFormat;
 exports.convertDateCodeToFormat = convertDateCodeToFormat;
+exports.getTodayInIST = getTodayInIST;
 const date_fns_1 = require("date-fns");
 const date_code_model_util_1 = require("./models/date-code.model.util");
 function compareDates(recordDate, buffer) {
@@ -16,3 +17,31 @@ function convertDateCodeToFormat(dateString, toFormat) {
     const dateObj = new date_code_model_util_1.DateCodeModel(dateString);
     return dateObj.toStringFormat(toFormat);
 }
+/**
+ * Current calendar date resolved in Asia/Kolkata (IST).
+ *
+ * TIMEZONE RULE: IST = UTC + 5:30 (fixed offset, no DST).
+ * Converting IST -> UTC: subtract 5:30.
+ *   - If IST time < 05:30 -> UTC date is the PREVIOUS calendar day.
+ *   - If IST time >= 05:30 -> UTC date is the SAME calendar day.
+ *
+ * Example: IST 01:00 -> UTC 19:30 (prev day).
+ *
+ * Why this matters: the production container (node:20.10-alpine) sets no TZ,
+ * so it defaults to UTC. A bare `new Date().getDate()` at 01:00 IST would read
+ * UTC's date (still "yesterday"), causing classification jobs to target the
+ * wrong day or silently miss their trigger window.
+ *
+ * This function returns a Date whose local getFullYear()/getMonth()/getDate()
+ * always equal the IST calendar date, regardless of container timezone.
+ */
+function getTodayInIST() {
+    const parts = new Intl.DateTimeFormat("en-GB", {
+        timeZone: "Asia/Kolkata",
+        year: "numeric",
+        month: "numeric",
+        day: "numeric",
+    }).formatToParts(new Date());
+    const get = (type) => { var _a, _b; return Number((_b = (_a = parts.find((part) => part.type === type)) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : 0); };
+    return new Date(get("year"), get("month") - 1, get("day"));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "law-common",
-  "version": "14.0.3-beta.0",
+  "version": "14.0.3-beta.10",
   "description": "",
   "main": "dist/index.js",
   "files": [
@@ -35,7 +35,8 @@
     "script:publish:install:patch": "node scripts/publish-and-install.js patch",
     "script:publish:install:minor": "node scripts/publish-and-install.js minor",
     "script:publish:install:major": "node scripts/publish-and-install.js major",
-    "build:link": "bash scripts/build-link.sh"
+    "build:link": "bash scripts/build-link.sh",
+    "script:deploy:prod": "bash scripts/deploy-prod.sh"
   },
   "keywords": [],
   "author": "",