@autologix-engineering/shared 1.2.380 → 1.2.381

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,38 @@
+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);
+    // Typed as a possible miss on purpose: `prefix` is the first two characters
+    // of whatever GSTIN was supplied, not necessarily one of the codes the map
+    // holds, so the lookup can come back undefined — which the check below
+    // already treats as "unresolved" and falls through to the city.
+    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,4EAA4E;IAC5E,2EAA2E;IAC3E,uEAAuE;IACvE,gEAAgE;IAChE,MAAM,SAAS,GAAG,MAAM;QACvB,CAAC,CAAE,eAAqD,CAAC,MAAM,CAAC;QAChE,CAAC,CAAC,SAAS,CAAC;IACb,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/utilities/src/vendor.operations.log.d.ts

@@ -0,0 +1,28 @@
+import { IVendorOperations } from '../../models/src/index';
+/** FutureRecord entity name for a scheduled Operational Information change. */
+export declare const VENDOR_OPERATIONS_UPDATE_ENTITY = "vendor_operations_update";
+type VendorOperationLogKind = 'text' | 'number' | 'bool' | 'date';
+export interface VendorOperationFieldChange {
+    label: string;
+    oldValue: string;
+    newValue: string;
+}
+/**
+ * Renders a stored value the way the grid shows it. Shares are `decimal`
+ * columns that Postgres returns as strings, so they are compared as numbers;
+ * dates are date-only values stored as the UTC instant of IST midnight.
+ */
+export declare function formatVendorOperationValue(kind: VendorOperationLogKind, raw: unknown): string;
+/** Ties a log line to its grid row; one city can hold several business types. */
+export declare function vendorOperationLogPrefix(cityName?: string | null, businessType?: string | null): string;
+/** A row's rate card id, from the joined relation when present. */
+export declare function vendorOperationRateCardId(row?: Partial<IVendorOperations> | null): string | null;
+/**
+ * One entry per field that differs between `before` and `after`. A null
+ * `before` means the row is being created, and lists each field that has a
+ * value. Rate card names come from `rateCardName` so this stays free of I/O.
+ */
+export declare function diffVendorOperationFields(before: Partial<IVendorOperations> | null, after: Partial<IVendorOperations>, rateCardName: (rateCardId: string) => string | undefined, options?: {
+    skipBusinessType?: boolean;
+}): VendorOperationFieldChange[];
+export {};

package/src/lib/utilities/src/vendor.operations.log.js

@@ -0,0 +1,128 @@
+import { RateCardField, VendorOperationsField, } from '../../models/src/index';
+import { addIstOffset } from './ist';
+/** FutureRecord entity name for a scheduled Operational Information change. */
+export const VENDOR_OPERATIONS_UPDATE_ENTITY = 'vendor_operations_update';
+/** Every Operational Information field a user can edit, labelled as the form labels it. */
+const VENDOR_OPERATIONS_LOG_FIELDS = [
+    {
+        key: VendorOperationsField.BusinessType,
+        label: 'Business Type',
+        kind: 'text',
+    },
+    {
+        key: VendorOperationsField.AccountCode,
+        label: 'Account Code',
+        kind: 'text',
+    },
+    {
+        key: VendorOperationsField.ClientShare,
+        label: 'Client Share',
+        kind: 'number',
+    },
+    {
+        key: VendorOperationsField.VendorShare,
+        label: 'Vendor Share',
+        kind: 'number',
+    },
+    {
+        key: VendorOperationsField.ShareRental,
+        label: 'Share Rental',
+        kind: 'bool',
+    },
+    {
+        key: VendorOperationsField.ShareExtraKms,
+        label: 'Share Extra Kms',
+        kind: 'bool',
+    },
+    {
+        key: VendorOperationsField.ShareFuelSurcharge,
+        label: 'Share Fuel Surcharge',
+        kind: 'bool',
+    },
+    {
+        key: VendorOperationsField.ShareGgKmsTime,
+        label: 'Share GG Kms & Time',
+        kind: 'bool',
+    },
+    {
+        key: VendorOperationsField.ShareAddons,
+        label: 'Share Addons',
+        kind: 'bool',
+    },
+    { key: VendorOperationsField.ValidFrom, label: 'Valid From', kind: 'date' },
+    { key: VendorOperationsField.ValidTill, label: 'Valid Till', kind: 'date' },
+];
+/**
+ * Renders a stored value the way the grid shows it. Shares are `decimal`
+ * columns that Postgres returns as strings, so they are compared as numbers;
+ * dates are date-only values stored as the UTC instant of IST midnight.
+ */
+export function formatVendorOperationValue(kind, raw) {
+    if (kind === 'bool')
+        return raw ? 'Yes' : 'No';
+    if (raw === null || raw === undefined || raw === '')
+        return '-';
+    if (kind === 'date') {
+        const _date = raw instanceof Date ? raw : new Date(raw);
+        if (Number.isNaN(_date.getTime()))
+            return '-';
+        const _ist = addIstOffset(_date);
+        return `${String(_ist.getUTCDate()).padStart(2, '0')}/${String(_ist.getUTCMonth() + 1).padStart(2, '0')}/${_ist.getUTCFullYear()}`;
+    }
+    if (kind === 'number') {
+        const _num = Number(raw);
+        return Number.isNaN(_num) ? '-' : String(_num);
+    }
+    return String(raw);
+}
+/** Ties a log line to its grid row; one city can hold several business types. */
+export function vendorOperationLogPrefix(cityName, businessType) {
+    return `Operational Info - ${cityName ?? '-'} (${businessType ?? '-'})`;
+}
+/** A row's rate card id, from the joined relation when present. */
+export function vendorOperationRateCardId(row) {
+    return (row?.[VendorOperationsField.RateCard]?.[RateCardField.RateCardId] ??
+        row?.[VendorOperationsField.RateCardId] ??
+        null);
+}
+/**
+ * One entry per field that differs between `before` and `after`. A null
+ * `before` means the row is being created, and lists each field that has a
+ * value. Rate card names come from `rateCardName` so this stays free of I/O.
+ */
+export function diffVendorOperationFields(before, after, rateCardName, options = {}) {
+    const changes = [];
+    for (const _spec of VENDOR_OPERATIONS_LOG_FIELDS) {
+        if (options.skipBusinessType &&
+            _spec.key === VendorOperationsField.BusinessType) {
+            continue;
+        }
+        const newValue = formatVendorOperationValue(_spec.kind, after?.[_spec.key]);
+        if (!before) {
+            if (newValue !== '-' && newValue !== 'No') {
+                changes.push({ label: _spec.label, oldValue: '-', newValue });
+            }
+            continue;
+        }
+        const oldValue = formatVendorOperationValue(_spec.kind, before[_spec.key]);
+        if (oldValue !== newValue) {
+            changes.push({ label: _spec.label, oldValue, newValue });
+        }
+    }
+    const nameOf = (row, id) => id
+        ? row?.[VendorOperationsField.RateCard]?.[RateCardField.Name] ||
+            rateCardName(id) ||
+            '-'
+        : '-';
+    const oldRateCardId = vendorOperationRateCardId(before);
+    const newRateCardId = vendorOperationRateCardId(after);
+    if (oldRateCardId !== newRateCardId) {
+        changes.push({
+            label: 'Rate Card',
+            oldValue: nameOf(before, oldRateCardId),
+            newValue: nameOf(after, newRateCardId),
+        });
+    }
+    return changes;
+}
+//# sourceMappingURL=vendor.operations.log.js.map

package/src/lib/utilities/src/vendor.operations.log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor.operations.log.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/vendor.operations.log.ts"],"names":[],"mappings":"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"}

package/src/lib/view-models/src/ext.rate.card.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Response shape for the external Rate Card sync (`get_ext_rate_card`).
+ *
+ * Keys are lower_snake_case by agreement with the booking-website team, and
+ * deliberately differ from the internal camelCase models: this is a published
+ * contract that outlives any internal rename.
+ */
+/**
+ * How `included_kms` on a row must be read. Derived from the rate configuration
+ * already held in AutoLogix — no extra setup per rate card:
+ *
+ * - `Slab`     City Local on `RateType.SlabRate` — total for the whole booking.
+ * - `Hourly`   City Local on `RateType.HourlyRate`, or Packages on
+ *              `PackageRateType.HourlyBased` — no included KM at all; bill on
+ *              `per_km_rate`, capped by `max_km_per_hour`.
+ * - `Per Day`  Outstation, or Packages on `PackageRateType.DayBased` — a
+ *              per-day limit, never a booking total.
+ * - `KM Range` Transfers on `AirportRateType.KmRangeLogic` — the row is one
+ *              band, `slab_start_km` to `slab_end_km`.
+ * - `Trip`     Transfers on `AirportRateType.GeneralTransfer` — flat per transfer.
+ */
+export type ExtIncludedKmsBasis = 'Slab' | 'Hourly' | 'Per Day' | 'KM Range' | 'Trip';
+export type ExtRentalType = 'City Local' | 'Outstation' | 'Transfers' | 'Packages';
+/** A charge with no dedicated key, so a new charge type never breaks the schema. */
+export interface IExtAdditionalCharge {
+    charge_type: string;
+    amount: number;
+}
+/** One rate row: a package priced for one vehicle group in one city. */
+export interface IExtRateCardRow {
+    vehicle_type_code_numeric: number;
+    vehicle_type_code: string;
+    vehicle_type_description: string;
+    city_code: number;
+    city_name: string;
+    rental_type: ExtRentalType;
+    rental_type_code: 1 | 2 | 3 | 4;
+    package_type: string;
+    gst_percentage: number | null;
+    base_amount: number | null;
+    included_hours: number | null;
+    included_kms: number | null;
+    included_kms_basis: ExtIncludedKmsBasis;
+    /** `KM Range` only — the band this row prices. */
+    slab_start_km: number | null;
+    slab_end_km: number | null;
+    /**
+     * Outstation only. AutoLogix prices first/last days differently from middle
+     * days; a consumer that bills a multi-day outstation trip off the single
+     * `included_kms` will compute the wrong excess, and so the wrong due amount.
+     */
+    included_kms_first_last_day: number | null;
+    included_kms_middle_day: number | null;
+    /** `Hourly` only — the KM allowance that accrues per billed hour. */
+    max_km_per_hour: number | null;
+    extra_hour_rate: number | null;
+    extra_km_rate: number | null;
+    per_km_rate: number | null;
+    /**
+     * Packages and Outstation only.
+     *
+     * Always null today: AutoLogix has no minimum-days field at any level, so
+     * there is nothing truthful to send. Wire it to the new field once it lands
+     * rather than defaulting to 1 — auto-invoicing bills off whatever we return.
+     */
+    min_days_applicable: number | null;
+    min_hours_applicable: number | null;
+    day_retention_charges: number | null;
+    night_retention_charges: number | null;
+    /**
+     * Section 6 buffer. `rounding_minutes` is live and is held per
+     * (package x vehicle group) — it is NOT a single company-wide 35, so
+     * consumers must read it from the row rather than hardcoding it, or their
+     * within-buffer decision will disagree with what ARC bills.
+     *
+     * `rounding_kms` is always null: no KM buffer exists anywhere in AutoLogix
+     * billing today (extra KM is charged from the first KM over the limit).
+     * Null rather than a hardcoded 10, so no consumer can silently diverge.
+     */
+    rounding_minutes: number | null;
+    rounding_kms: number | null;
+    additional_charges: IExtAdditionalCharge[];
+    /** Row-level change key, so a checker sees which rows moved. */
+    row_hash: string;
+}
+/** One contract and the rate card behind it. */
+export interface IExtRateCardContract {
+    contract_id: string;
+    contract_code: number | null;
+    customer_code: number | null;
+    customer_name: string | null;
+    rate_card_id: string;
+    rate_card_name: string;
+    effective_from_date: string | null;
+    effective_to_date: string | null;
+    /** `effective_to_date - effective_from_date`, in days. Null when open-ended. */
+    validity_days: number | null;
+    published: boolean;
+    last_updated_at: string | null;
+    /**
+     * Card-level change key. Equal hash means nothing to review, so the
+     * maker-checker step needs no field-by-field diff.
+     */
+    rate_card_hash: string;
+    rates: IExtRateCardRow[];
+}
+export interface IExtRateCardSyncResponse {
+    generated_at: string;
+    /** Contracts matching the filter, before paging. */
+    total_contracts: number;
+    page: number;
+    page_size: number;
+    contracts: IExtRateCardContract[];
+}

package/src/lib/view-models/src/ext.rate.card.js

@@ -0,0 +1,9 @@
+/**
+ * Response shape for the external Rate Card sync (`get_ext_rate_card`).
+ *
+ * Keys are lower_snake_case by agreement with the booking-website team, and
+ * deliberately differ from the internal camelCase models: this is a published
+ * contract that outlives any internal rename.
+ */
+export {};
+//# sourceMappingURL=ext.rate.card.js.map

package/src/lib/view-models/src/ext.rate.card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext.rate.card.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/view-models/src/ext.rate.card.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

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

@@ -26,3 +26,5 @@ export * from './save.ba.payout.progress';
 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

@@ -26,4 +26,6 @@ export * from './save.ba.payout.progress';
 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"}
+{"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/public.config.d.ts

@@ -1,4 +1,4 @@
-import { LoginType, OrganizationTypeConfig } from '@autologix/shared/enums';
+import { LoginType, LoginVariant, 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,9 @@ export interface IPublicConfig {
     carouselImages?: ICarouselImage[];
     knowMoreUrl?: string;
     backgroundImage?: string;
+    otpLength?: number;
+    primaryFont?: LtrAppFont;
+    ltrOtpLength?: number;
+    ltrAppFont?: LtrAppFont;
+    loginVariant?: LoginVariant;
 }

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":""}

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"}

package/src/lib/utilities/src/pick.latest.numbered.invoice.d.ts

@@ -1,21 +0,0 @@
-import { INumberedInvoice } from '../../models/src/index';
-/**
- * Newest NumberedInvoice on a booking.
- *
- * `Request.numberedInvoices` is a plain @ManyToMany with no @OrderBy, so the
- * array order is whatever the join-table scan yields and can change with the
- * query plan. Callers reaching for `[0]` or `[length - 1]` were therefore
- * picking an arbitrary invoice. That is invisible while a booking has exactly
- * one, and surfaces as stale data the moment it has more — a rebill after
- * modification, or the consolidated clone in
- * `create.consolidated.invoice.handler`, both leave two attached.
- *
- * Ordered by `preparedAt` descending, with the id as a stable tiebreak for
- * rows sharing a timestamp. Rows with no usable `preparedAt` sort last, so a
- * legacy row without one never outranks a real invoice.
- *
- * Mirrors the explicit `ORDER BY ni.preparedAt` that
- * `duties.query.raw.controller` and `bill.calculation.controller` already
- * apply in SQL, for the callers that hold the relation in memory instead.
- */
-export declare function pickLatestNumberedInvoice(invoices?: INumberedInvoice[] | null): INumberedInvoice | undefined;

package/src/lib/utilities/src/pick.latest.numbered.invoice.js

@@ -1,52 +0,0 @@
-import { NumberedInvoiceField, } from '../../models/src/index';
-/**
- * Newest NumberedInvoice on a booking.
- *
- * `Request.numberedInvoices` is a plain @ManyToMany with no @OrderBy, so the
- * array order is whatever the join-table scan yields and can change with the
- * query plan. Callers reaching for `[0]` or `[length - 1]` were therefore
- * picking an arbitrary invoice. That is invisible while a booking has exactly
- * one, and surfaces as stale data the moment it has more — a rebill after
- * modification, or the consolidated clone in
- * `create.consolidated.invoice.handler`, both leave two attached.
- *
- * Ordered by `preparedAt` descending, with the id as a stable tiebreak for
- * rows sharing a timestamp. Rows with no usable `preparedAt` sort last, so a
- * legacy row without one never outranks a real invoice.
- *
- * Mirrors the explicit `ORDER BY ni.preparedAt` that
- * `duties.query.raw.controller` and `bill.calculation.controller` already
- * apply in SQL, for the callers that hold the relation in memory instead.
- */
-export function pickLatestNumberedInvoice(invoices) {
-    if (!invoices?.length) {
-        return undefined;
-    }
-    let latest;
-    let latestAt = -Infinity;
-    for (const invoice of invoices) {
-        if (!invoice) {
-            continue;
-        }
-        const preparedAt = invoice[NumberedInvoiceField.PreparedAt];
-        const parsed = preparedAt ? new Date(preparedAt).getTime() : NaN;
-        const at = Number.isNaN(parsed) ? -Infinity : parsed;
-        if (!latest) {
-            latest = invoice;
-            latestAt = at;
-            continue;
-        }
-        // Compare ids only when the timestamps tie, so the winner is stable
-        // across query plans rather than dependent on array order.
-        const isNewer = at > latestAt ||
-            (at === latestAt &&
-                String(invoice[NumberedInvoiceField.NumberedInvoiceId] ?? '') >
-                    String(latest[NumberedInvoiceField.NumberedInvoiceId] ?? ''));
-        if (isNewer) {
-            latest = invoice;
-            latestAt = at;
-        }
-    }
-    return latest;
-}
-//# sourceMappingURL=pick.latest.numbered.invoice.js.map

package/src/lib/utilities/src/pick.latest.numbered.invoice.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pick.latest.numbered.invoice.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/pick.latest.numbered.invoice.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,oBAAoB,GACpB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,yBAAyB,CACxC,QAAoC;IAEpC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,IAAI,MAAoC,CAAC;IACzC,IAAI,QAAQ,GAAG,CAAC,QAAQ,CAAC;IAEzB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,SAAS;QACV,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACjE,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAErD,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,GAAG,OAAO,CAAC;YACjB,QAAQ,GAAG,EAAE,CAAC;YACd,SAAS;QACV,CAAC;QAED,oEAAoE;QACpE,2DAA2D;QAC3D,MAAM,OAAO,GACZ,EAAE,GAAG,QAAQ;YACb,CAAC,EAAE,KAAK,QAAQ;gBACf,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;oBAC5D,MAAM,CACL,MAAM,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,IAAI,EAAE,CACpD,CAAC,CAAC;QAEN,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,GAAG,OAAO,CAAC;YACjB,QAAQ,GAAG,EAAE,CAAC;QACf,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}