@autologix-engineering/shared 1.2.375 → 1.2.377

package/src/lib/utilities/src/financial.year.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Indian financial year helpers, in IST.
+ *
+ * A financial year runs 1 April 00:00:00.000 IST to 31 March 23:59:59.999 IST.
+ * Every boundary here is an IST boundary expressed as a UTC instant, because
+ * that is how the database stores time: TimePeriod.startDate for September 2026
+ * is 2026-08-31T18:30:00Z, i.e. 1 September 00:00 IST. Deriving the month with
+ * plain `getMonth()` on the server's local clock would put every payout period
+ * that starts at 18:30 UTC into the previous month on any machine running UTC —
+ * a whole column of the RM schedule shifted by one.
+ *
+ * Written for AD-3098 (BA Retention Money schedule) and deliberately kept free
+ * of anything RM-specific so AD-3097 (Security Deposit schedule), which has the
+ * same April–March, one-column-group-per-month shape, can use it unchanged.
+ */
+/** 1 April 00:00:00.000 IST of `startYear`, as a UTC instant. */
+export declare function financialYearStart(startYear: number): Date;
+/** 31 March 23:59:59.999 IST of `startYear + 1`, as a UTC instant. */
+export declare function financialYearEnd(startYear: number): Date;
+/**
+ * The financial year's bounds as plain IST calendar dates, 'YYYY-MM-DD'.
+ *
+ * Preferred over the Date forms whenever the other side of the comparison also
+ * came out of Postgres as an IST calendar day, because string comparison of
+ * 'YYYY-MM-DD' cannot be knocked off by the process timezone. `timestamp
+ * without time zone` columns — which is what every contract date in this schema
+ * is — are parsed by node-postgres in the SERVER's local zone, so the same row
+ * yields a different instant on a UTC box than on an IST laptop.
+ */
+export declare function financialYearStartDay(startYear: number): string;
+export declare function financialYearEndDay(startYear: number): string;
+/**
+ * The financial year that contains `d`, identified by its opening calendar
+ * year: 2026 means FY 2026-27 (Apr 2026 – Mar 2027).
+ *
+ * Takes ANY instant inside the year rather than requiring the caller to pass
+ * 1 April, so a report can be re-run from a stored request payload without the
+ * caller having to remember which end of the range was canonical.
+ */
+export declare function resolveFinancialYearStartYear(d: Date | string): number;
+/** e.g. startYear 2026 -> '2026-27'. */
+export declare function financialYearLabel(startYear: number): string;
+export interface FinancialYearMonth {
+    /** 0-based position in the financial year: 0 = April, 11 = March. */
+    index: number;
+    /** Calendar year of this month (2027 for the March of FY 2026-27). */
+    year: number;
+    /** 0-based calendar month, as `Date.getUTCMonth()` returns it. */
+    month: number;
+    /** 'Apr 26' — the label the RM/SD schedule column groups are titled with. */
+    label: string;
+    /**
+     * 'YYYY-MM'. Matches what `to_char(ts + interval '5 hours 30 minutes',
+     * 'YYYY-MM')` produces in Postgres, so a month can be bucketed in SQL and
+     * looked up here without either side parsing a timestamp in Node.
+     */
+    key: string;
+    /** First instant of the month, 00:00:00.000 IST as a UTC instant. */
+    startUTC: Date;
+    /** Last instant of the month, 23:59:59.999 IST as a UTC instant. */
+    endUTC: Date;
+}
+/**
+ * The twelve months of a financial year in order, April first.
+ */
+export declare function financialYearMonths(startYear: number): FinancialYearMonth[];
+/**
+ * Which financial-year month `d` falls in, as a 0-based index (0 = April), or
+ * -1 when it falls outside the year entirely.
+ *
+ * Accepts either an instant (TimePeriod.startDate, a UTC timestamp) or a plain
+ * 'YYYY-MM-DD' calendar date (rvRefundDate, a Postgres `date`). A calendar date
+ * has no timezone at all, so it is read as the IST day it names — parsing it as
+ * a UTC instant and then adding the IST offset would move 1 April to 1 April
+ * 05:30 IST, which is still 1 April, but 31 March would move to 31 March 05:30
+ * and stay correct too. The branch exists so the intent is not accidental.
+ */
+export declare function financialYearMonthIndex(d: Date | string | null | undefined, startYear: number): number;
+/**
+ * True when `d` lands strictly before 1 April 00:00 IST of the financial year —
+ * i.e. it belongs to the opening balance rather than to any month column.
+ */
+export declare function isBeforeFinancialYear(d: Date | string | null | undefined, startYear: number): boolean;

package/src/lib/utilities/src/financial.year.js

@@ -0,0 +1,145 @@
+import { IST_OFFSET_MS, addIstOffset } from './ist';
+/**
+ * Indian financial year helpers, in IST.
+ *
+ * A financial year runs 1 April 00:00:00.000 IST to 31 March 23:59:59.999 IST.
+ * Every boundary here is an IST boundary expressed as a UTC instant, because
+ * that is how the database stores time: TimePeriod.startDate for September 2026
+ * is 2026-08-31T18:30:00Z, i.e. 1 September 00:00 IST. Deriving the month with
+ * plain `getMonth()` on the server's local clock would put every payout period
+ * that starts at 18:30 UTC into the previous month on any machine running UTC —
+ * a whole column of the RM schedule shifted by one.
+ *
+ * Written for AD-3098 (BA Retention Money schedule) and deliberately kept free
+ * of anything RM-specific so AD-3097 (Security Deposit schedule), which has the
+ * same April–March, one-column-group-per-month shape, can use it unchanged.
+ */
+/** 1 April 00:00:00.000 IST of `startYear`, as a UTC instant. */
+export function financialYearStart(startYear) {
+    return new Date(Date.UTC(startYear, 3, 1) - IST_OFFSET_MS);
+}
+/** 31 March 23:59:59.999 IST of `startYear + 1`, as a UTC instant. */
+export function financialYearEnd(startYear) {
+    return new Date(Date.UTC(startYear + 1, 3, 1) - IST_OFFSET_MS - 1);
+}
+/**
+ * The financial year's bounds as plain IST calendar dates, 'YYYY-MM-DD'.
+ *
+ * Preferred over the Date forms whenever the other side of the comparison also
+ * came out of Postgres as an IST calendar day, because string comparison of
+ * 'YYYY-MM-DD' cannot be knocked off by the process timezone. `timestamp
+ * without time zone` columns — which is what every contract date in this schema
+ * is — are parsed by node-postgres in the SERVER's local zone, so the same row
+ * yields a different instant on a UTC box than on an IST laptop.
+ */
+export function financialYearStartDay(startYear) {
+    return `${startYear}-04-01`;
+}
+export function financialYearEndDay(startYear) {
+    return `${startYear + 1}-03-31`;
+}
+/**
+ * The financial year that contains `d`, identified by its opening calendar
+ * year: 2026 means FY 2026-27 (Apr 2026 – Mar 2027).
+ *
+ * Takes ANY instant inside the year rather than requiring the caller to pass
+ * 1 April, so a report can be re-run from a stored request payload without the
+ * caller having to remember which end of the range was canonical.
+ */
+export function resolveFinancialYearStartYear(d) {
+    const ist = addIstOffset(new Date(d));
+    const month = ist.getUTCMonth(); // 0 = January
+    const year = ist.getUTCFullYear();
+    // January, February and March belong to the FY that opened last April.
+    return month < 3 ? year - 1 : year;
+}
+/** e.g. startYear 2026 -> '2026-27'. */
+export function financialYearLabel(startYear) {
+    return `${startYear}-${String((startYear + 1) % 100).padStart(2, '0')}`;
+}
+const MONTH_SHORT_NAMES = [
+    'Jan',
+    'Feb',
+    'Mar',
+    'Apr',
+    'May',
+    'Jun',
+    'Jul',
+    'Aug',
+    'Sep',
+    'Oct',
+    'Nov',
+    'Dec',
+];
+/**
+ * The twelve months of a financial year in order, April first.
+ */
+export function financialYearMonths(startYear) {
+    const months = [];
+    for (let index = 0; index < 12; index++) {
+        const absolute = 3 + index; // April is calendar month 3.
+        const year = startYear + Math.floor(absolute / 12);
+        const month = absolute % 12;
+        const startUTC = new Date(Date.UTC(year, month, 1) - IST_OFFSET_MS);
+        const endUTC = new Date(Date.UTC(year, month + 1, 1) - IST_OFFSET_MS - 1);
+        months.push({
+            index,
+            year,
+            month,
+            label: `${MONTH_SHORT_NAMES[month]} ${String(year % 100).padStart(2, '0')}`,
+            key: `${year}-${String(month + 1).padStart(2, '0')}`,
+            startUTC,
+            endUTC,
+        });
+    }
+    return months;
+}
+/**
+ * Which financial-year month `d` falls in, as a 0-based index (0 = April), or
+ * -1 when it falls outside the year entirely.
+ *
+ * Accepts either an instant (TimePeriod.startDate, a UTC timestamp) or a plain
+ * 'YYYY-MM-DD' calendar date (rvRefundDate, a Postgres `date`). A calendar date
+ * has no timezone at all, so it is read as the IST day it names — parsing it as
+ * a UTC instant and then adding the IST offset would move 1 April to 1 April
+ * 05:30 IST, which is still 1 April, but 31 March would move to 31 March 05:30
+ * and stay correct too. The branch exists so the intent is not accidental.
+ */
+export function financialYearMonthIndex(d, startYear) {
+    if (d === null || d === undefined || d === '')
+        return -1;
+    let istYear;
+    let istMonth;
+    if (typeof d === 'string' && /^\d{4}-\d{2}(-\d{2})?$/.test(d)) {
+        istYear = Number(d.slice(0, 4));
+        istMonth = Number(d.slice(5, 7)) - 1;
+    }
+    else {
+        const parsed = new Date(d);
+        if (Number.isNaN(parsed.getTime()))
+            return -1;
+        const ist = addIstOffset(parsed);
+        istYear = ist.getUTCFullYear();
+        istMonth = ist.getUTCMonth();
+    }
+    const absolute = (istYear - startYear) * 12 + istMonth - 3;
+    return absolute >= 0 && absolute < 12 ? absolute : -1;
+}
+/**
+ * True when `d` lands strictly before 1 April 00:00 IST of the financial year —
+ * i.e. it belongs to the opening balance rather than to any month column.
+ */
+export function isBeforeFinancialYear(d, startYear) {
+    if (d === null || d === undefined || d === '')
+        return false;
+    if (typeof d === 'string' && /^\d{4}-\d{2}(-\d{2})?$/.test(d)) {
+        const year = Number(d.slice(0, 4));
+        const month = Number(d.slice(5, 7)) - 1;
+        return year * 12 + month < startYear * 12 + 3;
+    }
+    const parsed = new Date(d);
+    if (Number.isNaN(parsed.getTime()))
+        return false;
+    return parsed.getTime() < financialYearStart(startYear).getTime();
+}
+//# sourceMappingURL=financial.year.js.map

package/src/lib/utilities/src/financial.year.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"financial.year.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/financial.year.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AAEH,iEAAiE;AACjE,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IACnD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;AAC5D,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IACjD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACtD,OAAO,GAAG,SAAS,QAAQ,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACpD,OAAO,GAAG,SAAS,GAAG,CAAC,QAAQ,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAAC,CAAgB;IAC7D,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,cAAc;IAC/C,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;IAClC,uEAAuE;IACvE,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpC,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IACnD,OAAO,GAAG,SAAS,IAAI,MAAM,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,iBAAiB,GAAG;IACzB,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACL,CAAC;AAuBF;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACpD,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,6BAA6B;QACzD,MAAM,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,QAAQ,GAAG,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,IAAI,CACtB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,GAAG,CAAC,CAChD,CAAC;QACF,MAAM,CAAC,IAAI,CAAC;YACX,KAAK;YACL,IAAI;YACJ,KAAK;YACL,KAAK,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YAC3E,GAAG,EAAE,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YACpD,QAAQ;YACR,MAAM;SACN,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACtC,CAAmC,EACnC,SAAiB;IAEjB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,CAAC,CAAC;IAEzD,IAAI,OAAe,CAAC;IACpB,IAAI,QAAgB,CAAC;IAErB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChC,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACP,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,CAAC,CAAC;IAC3D,OAAO,QAAQ,IAAI,CAAC,IAAI,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACpC,CAAmC,EACnC,SAAiB;IAEjB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,IAAI,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,OAAO,MAAM,CAAC,OAAO,EAAE,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;AACnE,CAAC"}

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

@@ -44,3 +44,5 @@ export * from './resolve.gst.state';
 export * from './ba.contract.lock';
 export * from './vehicle.insurance.validity';
 export * from './spot.placeholder.registration';
+export * from './ba.payout.workshop.days';
+export * from './financial.year';

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

@@ -44,4 +44,6 @@ export * from './resolve.gst.state';
 export * from './ba.contract.lock';
 export * from './vehicle.insurance.validity';
 export * from './spot.placeholder.registration';
+export * from './ba.payout.workshop.days';
+export * from './financial.year';
 //# 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,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,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,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,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,0BAA0B,CAAC;AACzC,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,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC"}

package/src/lib/view-models/src/index.d.ts

@@ -27,3 +27,4 @@ export * from './process.vehicle.rates.upload.progress';
 export * from './process.ba.payout.upload.progress';
 export * from './concurrent.users';
 export * from './ext.rate.card';
+export * from './vehicle.allocation.conflict';

package/src/lib/view-models/src/index.js

@@ -27,4 +27,5 @@ export * from './process.vehicle.rates.upload.progress';
 export * from './process.ba.payout.upload.progress';
 export * from './concurrent.users';
 export * from './ext.rate.card';
+export * from './vehicle.allocation.conflict';
 //# sourceMappingURL=index.js.map

package/src/lib/view-models/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/view-models/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/view-models/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,+BAA+B,CAAC"}

package/src/lib/view-models/src/vehicle.allocation.conflict.d.ts

@@ -0,0 +1,28 @@
+import { VehicleAllocationConflictReason } from '../../enums/src/index';
+/** AD-3373 — one duty that clashes with the allocation being attempted. */
+export interface IVehicleAllocationConflict {
+    requestId: string;
+    /** Booking number of the clashing duty, for the dispatcher to look up. */
+    bookingNumber: string | null;
+    /** Pickup of the clashing duty, as a UTC instant. Render it in IST. */
+    pickupTime: string | null;
+    /** Booking status of the clashing duty (Booked / Allotted / Dispatched). */
+    status: string | null;
+    /** Trip status, present when the clashing duty has a trip. */
+    tripStatus: string | null;
+    reason: VehicleAllocationConflictReason;
+    /** True when the clash is on the very booking the user is working from. */
+    isSameBooking: boolean;
+}
+/**
+ * AD-3373 — result of the allocation conflict check.
+ *
+ * `windowMinutes` is echoed back so the client can name the window in the
+ * warning without holding its own copy of the config, which would drift.
+ */
+export interface IVehicleAllocationConflictResult {
+    windowMinutes: number;
+    /** Server clock at evaluation, UTC. The window is measured from here. */
+    evaluatedAt: string;
+    conflicts: IVehicleAllocationConflict[];
+}

package/src/lib/view-models/src/vehicle.allocation.conflict.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vehicle.allocation.conflict.js.map

package/src/lib/view-models/src/vehicle.allocation.conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vehicle.allocation.conflict.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/view-models/src/vehicle.allocation.conflict.ts"],"names":[],"mappings":""}