@autologix-engineering/shared 1.2.355 → 1.2.357

package/src/lib/utilities/src/ba.contract.lock.d.ts

@@ -0,0 +1,55 @@
+import { BAContractField, IBAContract } from '../../models/src/index';
+/**
+ * Has the contract run past its effective end day?
+ *
+ * "Expired" is not a status. BAContractStatus is Active | Inactive |
+ * Surrendered | Cancelled, and expiry is applied by the endBAContracts cron at
+ * 00:00 IST, which flips Active -> Inactive once the end date has passed. So a
+ * contract is expired in the stored sense the moment that cron touches it, and
+ * expired in the real sense from the day after its effective end. This answers
+ * the second question, which is the one that closes the up-to-24-hour window
+ * between the two.
+ *
+ * Strictly before today: a contract is still live on its own end date.
+ */
+export declare function isBAContractExpired(contract: IBAContract | null | undefined, now?: Date): boolean;
+/**
+ * Is the contract past termination, and therefore read-only apart from the RM
+ * and SD refund fields?
+ *
+ * True when the contract is Surrendered, or Inactive (where the expiry cron
+ * parks expired contracts), or still Active only because that cron has not run
+ * since its effective end day passed.
+ *
+ * Cancelled is deliberately not here. AD-3246 names Surrendered and Expired
+ * and nothing else, and a cancelled contract is editable today; folding it in
+ * would be a silent behaviour change nobody asked for. It is worth a ticket of
+ * its own.
+ *
+ * Inactive covers one case that is not strictly expiry — a contract
+ * deactivated because its business associate was switched off. Locking that is
+ * not a regression: an Inactive contract is already entirely read-only in the
+ * UI today, so the only thing this changes for it is that the RM and SD refund
+ * fields become editable, which is the point of the ticket.
+ */
+export declare function isBAContractLocked(contract: IBAContract | null | undefined, now?: Date): boolean;
+/**
+ * The only fields an editor may change on a locked contract: the RM block and
+ * the SD block, so finance and CS can still settle refunds after termination.
+ *
+ * Model field names, which is also what the `BAContracts` columns are called,
+ * so this list can be used directly to filter an entity patch. The UI holds
+ * the same eight fields under its own Formik names; there is no single
+ * spelling that serves both, so the pairing is written down here rather than
+ * pretended away.
+ *
+ *   rvStatus      / RVStatus        RM Status
+ *   rvAmount      / RVRefundAmount  RM Refund Amount
+ *   rvRefundDate  / RVRefundDate    RM Refund Date
+ *   rvRemarks     / RVRemarks       RM Remarks
+ *   sdStatus      / SDStatus        SD Status
+ *   refundAmount  / RefundAmount    SD Refund Amount
+ *   refundDate    / RefundDate      SD Refund Date
+ *   refundRemarks / RefundRemarks   SD Remarks
+ */
+export declare const BA_CONTRACT_LOCK_EDITABLE_FIELDS: BAContractField[];

package/src/lib/utilities/src/ba.contract.lock.js

@@ -0,0 +1,168 @@
+import { BAContractField } from '../../models/src/index';
+import { BAContractStatus } from '../../enums/src/index';
+import { IST_OFFSET_MS } from './ist';
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+/**
+ * The IST calendar day an instant falls on, as a plain day number.
+ *
+ * Deliberately arithmetic rather than `toLocaleString('en-IN')` or a moment
+ * timezone: this file is compiled into both the API and the browser bundle,
+ * and the two have to agree. A locale-based conversion agrees only when the
+ * browser happens to be in Asia/Kolkata, which is exactly the case that hides
+ * the bug during local testing.
+ *
+ * An instant landing exactly on IST midnight is attributed to the day that is
+ * *starting*. That is the plain reading, and it is also the safe one — see the
+ * note on effectiveEndDay.
+ */
+function istDayNumber(instant) {
+    return Math.floor((instant.getTime() + IST_OFFSET_MS) / MS_PER_DAY);
+}
+/**
+ * The day the contract actually stops running: the earlier of its end date and
+ * its surrender effective date.
+ *
+ * AND, not OR — the same rule findBAContractForBooking settled on. A contract
+ * surrendered early still carries its original, later `contractEndDate`, so
+ * taking whichever is present last would keep a surrendered contract alive
+ * until its untouched end date.
+ *
+ * Returns null when the contract has no usable end boundary at all, which the
+ * callers read as "cannot conclude it has expired".
+ *
+ * ---------------------------------------------------------------------------
+ * On the time-of-day spread in these two columns, and why this errs late
+ * ---------------------------------------------------------------------------
+ *
+ * Both are naive timestamps written by several generations of code, and they
+ * do not share a convention. On staging:
+ *
+ *   contractEndDate         18:29:59.999Z (255)  IST end of the stored day
+ *                           18:30:00.000Z ( 46)  IST midnight *starting* the
+ *                                                next day — an exclusive bound
+ *                           00:00:00.000Z ( 89)  05:30 IST on the stored day
+ *
+ *   surrenderEffectiveDate  18:30:00.000Z (125)  IST midnight of the effective
+ *                                                day (a legacy startOfDay)
+ *                           18:29:59.999Z (  2)  IST end of the effective day
+ *                                                (today's formatToEndOfDay)
+ *
+ * Plain flooring gives the right day for every one of those except
+ * contractEndDate at 18:30:00.000Z, where it lands one day late — the instant
+ * sits exactly on a day boundary and is read as the day beginning.
+ *
+ * That is left alone on purpose. Nudging the boundary back (subtracting a
+ * millisecond before flooring) would fix those 46 rows and simultaneously
+ * break the 125 surrender rows, which carry the same literal timestamp with
+ * the opposite meaning. There is no single adjustment that is right for both
+ * columns, so the tie is broken by consequence rather than by neatness:
+ *
+ *   - Late is free. The contract stays editable one extra day, which is the
+ *     behaviour it had before this rule existed, and the endBAContracts cron
+ *     flips it to Inactive anyway — at which point the status check locks it.
+ *   - Early is a bug. It takes a contract that is still live and makes most of
+ *     it read-only for a user who is entitled to edit it.
+ *
+ * This whole derived branch only covers the window between a contract ending
+ * and the 00:00 IST cron sweeping it. It is defence in depth, not the primary
+ * rule, and as of writing it changes the answer for zero of the 39 Active
+ * contracts on staging. Precision here is not worth a false lock.
+ */
+function effectiveEndDay(contract) {
+    const endRaw = contract?.[BAContractField.ContractEndDate];
+    const surrenderRaw = contract?.[BAContractField.SurrenderEffectiveDate];
+    const days = [];
+    for (const raw of [endRaw, surrenderRaw]) {
+        if (!raw)
+            continue;
+        const parsed = new Date(raw);
+        if (isNaN(parsed.getTime()))
+            continue;
+        days.push(istDayNumber(parsed));
+    }
+    if (!days.length)
+        return null;
+    return Math.min(...days);
+}
+/**
+ * Has the contract run past its effective end day?
+ *
+ * "Expired" is not a status. BAContractStatus is Active | Inactive |
+ * Surrendered | Cancelled, and expiry is applied by the endBAContracts cron at
+ * 00:00 IST, which flips Active -> Inactive once the end date has passed. So a
+ * contract is expired in the stored sense the moment that cron touches it, and
+ * expired in the real sense from the day after its effective end. This answers
+ * the second question, which is the one that closes the up-to-24-hour window
+ * between the two.
+ *
+ * Strictly before today: a contract is still live on its own end date.
+ */
+export function isBAContractExpired(contract, now = new Date()) {
+    if (!contract)
+        return false;
+    const endDay = effectiveEndDay(contract);
+    if (endDay === null)
+        return false;
+    return endDay < istDayNumber(now);
+}
+/**
+ * Is the contract past termination, and therefore read-only apart from the RM
+ * and SD refund fields?
+ *
+ * True when the contract is Surrendered, or Inactive (where the expiry cron
+ * parks expired contracts), or still Active only because that cron has not run
+ * since its effective end day passed.
+ *
+ * Cancelled is deliberately not here. AD-3246 names Surrendered and Expired
+ * and nothing else, and a cancelled contract is editable today; folding it in
+ * would be a silent behaviour change nobody asked for. It is worth a ticket of
+ * its own.
+ *
+ * Inactive covers one case that is not strictly expiry — a contract
+ * deactivated because its business associate was switched off. Locking that is
+ * not a regression: an Inactive contract is already entirely read-only in the
+ * UI today, so the only thing this changes for it is that the RM and SD refund
+ * fields become editable, which is the point of the ticket.
+ */
+export function isBAContractLocked(contract, now = new Date()) {
+    if (!contract)
+        return false;
+    const status = contract?.[BAContractField.Status];
+    if (status === BAContractStatus.Cancelled)
+        return false;
+    if (status === BAContractStatus.Surrendered)
+        return true;
+    if (status === BAContractStatus.InActive)
+        return true;
+    return isBAContractExpired(contract, now);
+}
+/**
+ * The only fields an editor may change on a locked contract: the RM block and
+ * the SD block, so finance and CS can still settle refunds after termination.
+ *
+ * Model field names, which is also what the `BAContracts` columns are called,
+ * so this list can be used directly to filter an entity patch. The UI holds
+ * the same eight fields under its own Formik names; there is no single
+ * spelling that serves both, so the pairing is written down here rather than
+ * pretended away.
+ *
+ *   rvStatus      / RVStatus        RM Status
+ *   rvAmount      / RVRefundAmount  RM Refund Amount
+ *   rvRefundDate  / RVRefundDate    RM Refund Date
+ *   rvRemarks     / RVRemarks       RM Remarks
+ *   sdStatus      / SDStatus        SD Status
+ *   refundAmount  / RefundAmount    SD Refund Amount
+ *   refundDate    / RefundDate      SD Refund Date
+ *   refundRemarks / RefundRemarks   SD Remarks
+ */
+export const BA_CONTRACT_LOCK_EDITABLE_FIELDS = [
+    BAContractField.RVStatus,
+    BAContractField.RVAmount,
+    BAContractField.RVRefundDate,
+    BAContractField.RVRemarks,
+    BAContractField.SDStatus,
+    BAContractField.RefundAmount,
+    BAContractField.RefundDate,
+    BAContractField.RefundRemarks,
+];
+//# sourceMappingURL=ba.contract.lock.js.map

package/src/lib/utilities/src/ba.contract.lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ba.contract.lock.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/ba.contract.lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAe,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,SAAS,YAAY,CAAC,OAAa;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,GAAG,UAAU,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,SAAS,eAAe,CAAC,QAAqB;IAC7C,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,QAAQ,EAAE,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAC;IAExE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAAE,SAAS;QACtC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAClC,QAAwC,EACxC,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CACjC,QAAwC,EACxC,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAElD,IAAI,MAAM,KAAK,gBAAgB,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,MAAM,KAAK,gBAAgB,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,MAAM,KAAK,gBAAgB,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEtD,OAAO,mBAAmB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAsB;IAClE,eAAe,CAAC,QAAQ;IACxB,eAAe,CAAC,QAAQ;IACxB,eAAe,CAAC,YAAY;IAC5B,eAAe,CAAC,SAAS;IACzB,eAAe,CAAC,QAAQ;IACxB,eAAe,CAAC,YAAY;IAC5B,eAAe,CAAC,UAAU;IAC1B,eAAe,CAAC,aAAa;CAC7B,CAAC"}

package/src/lib/utilities/src/index.d.ts

@@ -17,6 +17,7 @@ export * from './bill.matrix.request.util';
 export * from './build.request.guests.in.pickup.order';
 export * from './dedupe.email.recipients';
 export * from './ist';
+export * from './ltr.cycle.month.index';
 export * from './format.cleartax.b2c.error';
 export * from './build.cleartax.pay.dtls';
 export * from './resolve.cleartax.driver.sac.hsn';
@@ -24,7 +25,6 @@ export * from './resolve.passenger.display.name';
 export * from './remove.null.filter';
 export * from './calculate.deducted.sharing.amount';
 export * from './find.ba.contract.for.booking';
-export * from './pick.latest.numbered.invoice';
 export * from './pick.numbered.invoice.for.booking';
 export * from './pick.incentive.amount';
 export * from './line.item.helpers';
@@ -33,6 +33,10 @@ export * from './build.include.revenue.client.id.set';
 export * from './amount.in.words';
 export * from './calculate.ba.payout.working.days';
 export * from './garage.start.from.pickup';
+export * from './parse.display.date';
+export * from './ltr.payout.row.key';
 export * from './invoice.generation.alert.util';
 export * from './concurrency.peak';
 export * from './resolve.invoice.bank.details';
+export * from './resolve.gst.state';
+export * from './ba.contract.lock';

package/src/lib/utilities/src/index.js

@@ -17,6 +17,7 @@ export * from './bill.matrix.request.util';
 export * from './build.request.guests.in.pickup.order';
 export * from './dedupe.email.recipients';
 export * from './ist';
+export * from './ltr.cycle.month.index';
 export * from './format.cleartax.b2c.error';
 export * from './build.cleartax.pay.dtls';
 export * from './resolve.cleartax.driver.sac.hsn';
@@ -24,7 +25,6 @@ export * from './resolve.passenger.display.name';
 export * from './remove.null.filter';
 export * from './calculate.deducted.sharing.amount';
 export * from './find.ba.contract.for.booking';
-export * from './pick.latest.numbered.invoice';
 export * from './pick.numbered.invoice.for.booking';
 export * from './pick.incentive.amount';
 export * from './line.item.helpers';
@@ -33,7 +33,11 @@ export * from './build.include.revenue.client.id.set';
 export * from './amount.in.words';
 export * from './calculate.ba.payout.working.days';
 export * from './garage.start.from.pickup';
+export * from './parse.display.date';
+export * from './ltr.payout.row.key';
 export * from './invoice.generation.alert.util';
 export * from './concurrency.peak';
 export * from './resolve.invoice.bank.details';
+export * from './resolve.gst.state';
+export * from './ba.contract.lock';
 //# sourceMappingURL=index.js.map

package/src/lib/utilities/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,OAAO,CAAC;AACtB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,mBAAmB,CAAC;AAClC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,OAAO,CAAC;AACtB,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,mBAAmB,CAAC;AAClC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/src/lib/utilities/src/ltr.cycle.month.index.d.ts

@@ -0,0 +1 @@
+export declare function ltrCycleMonthIndex(anchor: Date, booking: Date): number;

package/src/lib/utilities/src/ltr.cycle.month.index.js

@@ -0,0 +1,9 @@
+import { IST_OFFSET_MS } from './ist';
+export function ltrCycleMonthIndex(anchor, booking) {
+    const anchorIst = new Date(anchor.getTime() + IST_OFFSET_MS);
+    const bookingIst = new Date(booking.getTime() + IST_OFFSET_MS);
+    return ((bookingIst.getFullYear() - anchorIst.getFullYear()) * 12 +
+        (bookingIst.getMonth() - anchorIst.getMonth()) +
+        1);
+}
+//# sourceMappingURL=ltr.cycle.month.index.js.map

package/src/lib/utilities/src/ltr.cycle.month.index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltr.cycle.month.index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/ltr.cycle.month.index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,UAAU,kBAAkB,CAAC,MAAY,EAAE,OAAa;IAC7D,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC;IAC/D,OAAO,CACN,CAAC,UAAU,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE;QACzD,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC9C,CAAC,CACD,CAAC;AACH,CAAC"}

package/src/lib/utilities/src/ltr.payout.row.key.d.ts

@@ -0,0 +1,43 @@
+import { LTRPayoutRow } from '../../models/src/index';
+/**
+ * A payout row's stable identity: the calendar date it covers, plus its shift
+ * where the contract has shifts.
+ *
+ * Derived from the row's own content rather than its position in
+ * `LTRPayout.ltrPayoutRows`. That matters because the array is re-sorted by
+ * date whenever an entry is added, so a row logged for an earlier date shifts
+ * the index of every row after it — an index captured in one response is not
+ * the same row in the next.
+ *
+ * This is already the uniqueness rule the system enforces: at most one row per
+ * date, or per (date, shift) on a shift contract. Two rows can therefore never
+ * share a key.
+ *
+ * Returns null when the row carries no parsable date, which only happens on
+ * malformed data; callers should fall back to the array index for those.
+ */
+export declare function ltrPayoutRowKey(row: LTRPayoutRow): string | null;
+/**
+ * The instant a row starts, for ordering a booking's rows by date.
+ *
+ * Duty start first, garage start for garage-to-garage rows that record no
+ * separate duty window.
+ */
+export declare function ltrPayoutRowStart(row: LTRPayoutRow): Date | null;
+/**
+ * A booking's rows in date order.
+ *
+ * The stored array is kept sorted so the charge calculation sees the duty as
+ * one continuous sequence — running KM and overtime both depend on the
+ * preceding row.
+ */
+export declare function sortLTRPayoutRowsByDate(rows: LTRPayoutRow[]): LTRPayoutRow[];
+/**
+ * The first date in `newRows` that `existingRows` already occupies, as a label
+ * for the caller's error message — or null when there is no clash.
+ *
+ * Callers decide which rows count as "existing": adding an entry checks every
+ * stored row, while editing one checks only the OTHER entries, since the dates
+ * it currently holds are being released.
+ */
+export declare function findOverlappingLTRPayoutDate(existingRows: LTRPayoutRow[], newRows: LTRPayoutRow[]): string | null;

package/src/lib/utilities/src/ltr.payout.row.key.js

@@ -0,0 +1,78 @@
+import { LTRPayoutRowField } from '../../models/src/index';
+import { firstParsableDisplayDate } from './parse.display.date';
+/**
+ * A payout row's stable identity: the calendar date it covers, plus its shift
+ * where the contract has shifts.
+ *
+ * Derived from the row's own content rather than its position in
+ * `LTRPayout.ltrPayoutRows`. That matters because the array is re-sorted by
+ * date whenever an entry is added, so a row logged for an earlier date shifts
+ * the index of every row after it — an index captured in one response is not
+ * the same row in the next.
+ *
+ * This is already the uniqueness rule the system enforces: at most one row per
+ * date, or per (date, shift) on a shift contract. Two rows can therefore never
+ * share a key.
+ *
+ * Returns null when the row carries no parsable date, which only happens on
+ * malformed data; callers should fall back to the array index for those.
+ */
+export function ltrPayoutRowKey(row) {
+    const date = firstParsableDisplayDate([
+        row?.[LTRPayoutRowField.DutyStartDateTime],
+        row?.[LTRPayoutRowField.DutyStartDate],
+        row?.[LTRPayoutRowField.GarageStartDateTime],
+        row?.[LTRPayoutRowField.GarageStartDate],
+    ]);
+    if (!date)
+        return null;
+    const datePart = `${String(date.getDate()).padStart(2, '0')}/${String(date.getMonth() + 1).padStart(2, '0')}/${date.getFullYear()}`;
+    const shift = row?.[LTRPayoutRowField.Shift];
+    return shift ? `${datePart}#${shift}` : datePart;
+}
+/**
+ * The instant a row starts, for ordering a booking's rows by date.
+ *
+ * Duty start first, garage start for garage-to-garage rows that record no
+ * separate duty window.
+ */
+export function ltrPayoutRowStart(row) {
+    return firstParsableDisplayDate([
+        row?.[LTRPayoutRowField.DutyStartDateTime],
+        row?.[LTRPayoutRowField.GarageStartDateTime],
+    ]);
+}
+/**
+ * A booking's rows in date order.
+ *
+ * The stored array is kept sorted so the charge calculation sees the duty as
+ * one continuous sequence — running KM and overtime both depend on the
+ * preceding row.
+ */
+export function sortLTRPayoutRowsByDate(rows) {
+    return [...rows].sort((a, b) => (ltrPayoutRowStart(a)?.getTime() ?? 0) -
+        (ltrPayoutRowStart(b)?.getTime() ?? 0));
+}
+/**
+ * The first date in `newRows` that `existingRows` already occupies, as a label
+ * for the caller's error message — or null when there is no clash.
+ *
+ * Callers decide which rows count as "existing": adding an entry checks every
+ * stored row, while editing one checks only the OTHER entries, since the dates
+ * it currently holds are being released.
+ */
+export function findOverlappingLTRPayoutDate(existingRows, newRows) {
+    const taken = new Set(existingRows
+        .map((row) => ltrPayoutRowKey(row))
+        .filter((key) => !!key));
+    for (const row of newRows) {
+        const key = ltrPayoutRowKey(row);
+        if (!key || !taken.has(key))
+            continue;
+        const shift = row?.[LTRPayoutRowField.Shift];
+        const date = row?.[LTRPayoutRowField.DutyStartDate] ?? key.split('#')[0];
+        return shift ? `${date} (shift ${shift})` : date;
+    }
+    return null;
+}
+//# sourceMappingURL=ltr.payout.row.key.js.map

package/src/lib/utilities/src/ltr.payout.row.key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltr.payout.row.key.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/ltr.payout.row.key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,GAAiB;IAChD,MAAM,IAAI,GAAG,wBAAwB,CAAC;QACrC,GAAG,EAAE,CAAC,iBAAiB,CAAC,iBAAiB,CAAC;QAC1C,GAAG,EAAE,CAAC,iBAAiB,CAAC,aAAa,CAAC;QACtC,GAAG,EAAE,CAAC,iBAAiB,CAAC,mBAAmB,CAAC;QAC5C,GAAG,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC;KACxC,CAAC,CAAC;IACH,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CACpE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CACnB,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;IAE3C,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IAClD,OAAO,wBAAwB,CAAC;QAC/B,GAAG,EAAE,CAAC,iBAAiB,CAAC,iBAAiB,CAAC;QAC1C,GAAG,EAAE,CAAC,iBAAiB,CAAC,mBAAmB,CAAC;KAC5C,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAoB;IAC3D,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CACpB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACR,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CACvC,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAC3C,YAA4B,EAC5B,OAAuB;IAEvB,MAAM,KAAK,GAAG,IAAI,GAAG,CACpB,YAAY;SACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;SAClC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CACvC,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAEtC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,GACT,GAAG,EAAE,CAAC,iBAAiB,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,WAAW,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC"}

package/src/lib/utilities/src/parse.display.date.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Parses the `dd/MM/yyyy` / `dd-MM-yyyy` date strings — with an optional
+ * `HH:mm` — that LTR payout rows are stored in.
+ *
+ * Payout rows keep dates as display strings rather than timestamps (the Excel
+ * upload writes them that way and the sheet round-trips them), so every reader
+ * has to parse them back. This is the single implementation: it previously
+ * existed as three copies that were free to drift apart.
+ *
+ * Returns null for anything unparseable, including calendar dates that do not
+ * exist — `Date` silently rolls 31/02/2026 forward to 03/03/2026, which would
+ * otherwise place a row in the wrong month.
+ */
+export declare function parseDisplayDate(value: unknown): Date | null;
+/** First parsable value, for rows that record the same moment several ways. */
+export declare function firstParsableDisplayDate(candidates: unknown[]): Date | null;

package/src/lib/utilities/src/parse.display.date.js

@@ -0,0 +1,43 @@
+/**
+ * Parses the `dd/MM/yyyy` / `dd-MM-yyyy` date strings — with an optional
+ * `HH:mm` — that LTR payout rows are stored in.
+ *
+ * Payout rows keep dates as display strings rather than timestamps (the Excel
+ * upload writes them that way and the sheet round-trips them), so every reader
+ * has to parse them back. This is the single implementation: it previously
+ * existed as three copies that were free to drift apart.
+ *
+ * Returns null for anything unparseable, including calendar dates that do not
+ * exist — `Date` silently rolls 31/02/2026 forward to 03/03/2026, which would
+ * otherwise place a row in the wrong month.
+ */
+export function parseDisplayDate(value) {
+    if (!value)
+        return null;
+    const match = String(value)
+        .trim()
+        .match(/^(\d{2})[-/](\d{2})[-/](\d{4})(?:\s+(\d{2}):(\d{2}))?$/);
+    if (!match)
+        return null;
+    const [, day, month, year, hour, minute] = match;
+    const date = new Date(Number(year), Number(month) - 1, Number(day), Number(hour ?? 0), Number(minute ?? 0));
+    if (isNaN(date.getTime()))
+        return null;
+    // Reject impossible calendar dates that Date silently rolls over.
+    if (date.getFullYear() !== Number(year) ||
+        date.getMonth() !== Number(month) - 1 ||
+        date.getDate() !== Number(day)) {
+        return null;
+    }
+    return date;
+}
+/** First parsable value, for rows that record the same moment several ways. */
+export function firstParsableDisplayDate(candidates) {
+    for (const candidate of candidates) {
+        const parsed = parseDisplayDate(candidate);
+        if (parsed)
+            return parsed;
+    }
+    return null;
+}
+//# sourceMappingURL=parse.display.date.js.map

package/src/lib/utilities/src/parse.display.date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.display.date.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/parse.display.date.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;SACzB,IAAI,EAAE;SACN,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,IAAI,CACpB,MAAM,CAAC,IAAI,CAAC,EACZ,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EACjB,MAAM,CAAC,GAAG,CAAC,EACX,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EACjB,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CACnB,CAAC;IACF,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,kEAAkE;IAClE,IACC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,EAC7B,CAAC;QACF,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,wBAAwB,CAAC,UAAqB;IAC7D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/src/lib/utilities/src/resolve.gst.state.d.ts

@@ -0,0 +1,23 @@
+import { City, State } from '../../enums/src/index';
+/** The subset of a GST city entry this resolver needs. */
+interface GstStateCitySource {
+    cityName?: City | null;
+}
+/**
+ * Resolves the state to store on a GST record.
+ *
+ * The state is captured on the billing form but was historically never persisted, leaving every
+ * consumer to re-derive it from either the GSTIN prefix or the city. Neither source exists for a
+ * GST-unregistered record saved without a city, so it is stored instead — and every write path
+ * that can change the GSTIN or the cities has to keep it current, or the stored value goes stale.
+ *
+ * Priority:
+ *  1. An explicit state. Only the billing form sends one, and it is also the only form that can
+ *     omit a GSTIN, so it is the sole source for the case the column exists to cover.
+ *  2. The GSTIN's first two digits, which authoritatively encode the state.
+ *  3. The city mapping, for payloads carrying neither.
+ *
+ * Returns null when nothing resolves, which is a legitimate state for the row to be in.
+ */
+export declare const resolveGstState: (explicitState?: State | null, gstin?: string | null, cities?: GstStateCitySource[] | null) => State | null;
+export {};

package/src/lib/utilities/src/resolve.gst.state.js

@@ -0,0 +1,32 @@
+import { CityStateMapping, GstStatemapping } from '../../enums/src/index';
+/**
+ * Resolves the state to store on a GST record.
+ *
+ * The state is captured on the billing form but was historically never persisted, leaving every
+ * consumer to re-derive it from either the GSTIN prefix or the city. Neither source exists for a
+ * GST-unregistered record saved without a city, so it is stored instead — and every write path
+ * that can change the GSTIN or the cities has to keep it current, or the stored value goes stale.
+ *
+ * Priority:
+ *  1. An explicit state. Only the billing form sends one, and it is also the only form that can
+ *     omit a GSTIN, so it is the sole source for the case the column exists to cover.
+ *  2. The GSTIN's first two digits, which authoritatively encode the state.
+ *  3. The city mapping, for payloads carrying neither.
+ *
+ * Returns null when nothing resolves, which is a legitimate state for the row to be in.
+ */
+export const resolveGstState = (explicitState, gstin, cities) => {
+    if (explicitState)
+        return explicitState;
+    const prefix = gstin?.trim()?.slice(0, 2);
+    const fromGstin = prefix ? GstStatemapping[prefix] : undefined;
+    if (fromGstin)
+        return fromGstin;
+    // The legacy cityName/Address columns mirror cities[0] positionally, but for the state any
+    // populated city will do — a blank first entry should not lose a state we can still resolve.
+    const cityName = (cities ?? [])
+        .map((c) => c?.cityName)
+        .find((name) => Boolean(name));
+    return cityName ? (CityStateMapping[cityName] ?? null) : null;
+};
+//# sourceMappingURL=resolve.gst.state.js.map

package/src/lib/utilities/src/resolve.gst.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.gst.state.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/resolve.gst.state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,gBAAgB,EAAE,eAAe,EAAS,MAAM,uBAAuB,CAAC;AAOvF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC9B,aAA4B,EAC5B,KAAqB,EACrB,MAAoC,EACrB,EAAE;IACjB,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,MAAM,MAAM,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAEhC,2FAA2F;IAC3F,6FAA6F;IAC7F,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC;SACvB,IAAI,CAAC,CAAC,IAAI,EAAgB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9C,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC,CAAC"}

package/src/lib/view-models/src/public.config.d.ts

@@ -1,4 +1,4 @@
-import { LoginType, OrganizationTypeConfig } from '@autologix/shared/enums';
+import { LoginType, LtrAppFont, OrganizationTypeConfig } from '@autologix/shared/enums';
 import { ICarouselImage } from '../../models/src/white.label.config.model';
 import { ILanguage } from '../../models/src/language.model';
 export interface IPublicConfig {
@@ -39,4 +39,8 @@ export interface IPublicConfig {
     carouselImages?: ICarouselImage[];
     knowMoreUrl?: string;
     backgroundImage?: string;
+    otpLength?: number;
+    primaryFont?: LtrAppFont;
+    ltrOtpLength?: number;
+    ltrAppFont?: LtrAppFont;
 }

package/src/lib/view-models/src/successful.response.d.ts

@@ -2,4 +2,21 @@ import { RequestProcessingStatus } from '../../enums/src/index';
 export interface SuccessfulResponse<Data> {
     data: Data;
     status: RequestProcessingStatus.Success;
+    /**
+     * Optional note about the success itself — not an error.
+     *
+     * `UnsuccessfulResponse` has always carried `message`; this member did not,
+     * so a caller that narrowed a `RequestResponse<T>` on
+     * `status === Success` had no field to read even when the server had
+     * something to say. That bit AD-3227: the draft save reports Success while
+     * deliberately keeping the stored `validRows` over an empty incoming set,
+     * and the rows-less success payload gives the caller no other way to notice
+     * the divergence.
+     *
+     * Optional and additive, so every existing producer and consumer is
+     * unaffected. Use it for "we did what you asked, but here is something you
+     * should know", never for a failure — those still go through
+     * `UnsuccessfulResponse`.
+     */
+    message?: string;
 }

package/src/lib/data-transfer-objects/src/get.ext.available.ratecards.dto.d.ts

@@ -1,5 +0,0 @@
-export declare class GetExtAvailableRatecardsDTO {
-    contextId?: string;
-    clientIds?: string[];
-    constructor(obj?: Partial<GetExtAvailableRatecardsDTO>);
-}

package/src/lib/data-transfer-objects/src/get.ext.available.ratecards.dto.js

@@ -1,19 +0,0 @@
-import { __decorate, __metadata } from "tslib";
-import { IsArray, IsOptional, IsString, IsUUID, } from 'class-validator';
-export class GetExtAvailableRatecardsDTO {
-    constructor(obj) {
-        Object.assign(this, obj);
-    }
-}
-__decorate([
-    IsOptional(),
-    IsUUID(),
-    __metadata("design:type", String)
-], GetExtAvailableRatecardsDTO.prototype, "contextId", void 0);
-__decorate([
-    IsOptional(),
-    IsArray(),
-    IsString({ each: true }),
-    __metadata("design:type", Array)
-], GetExtAvailableRatecardsDTO.prototype, "clientIds", void 0);
-//# sourceMappingURL=get.ext.available.ratecards.dto.js.map

package/src/lib/data-transfer-objects/src/get.ext.available.ratecards.dto.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"get.ext.available.ratecards.dto.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/data-transfer-objects/src/get.ext.available.ratecards.dto.ts"],"names":[],"mappings":";AAAA,OAAO,EACN,OAAO,EAEP,UAAU,EACV,QAAQ,EACR,MAAM,GACN,MAAM,iBAAiB,CAAC;AAGzB,MAAM,OAAO,2BAA2B;IAUvC,YAAY,GAA0C;QACrD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;CACD;AAVA;IAFC,UAAU,EAAE;IACZ,MAAM,EAAE;;8DACU;AAKnB;IAHC,UAAU,EAAE;IACZ,OAAO,EAAE;IACT,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;8DACJ"}