@autologix-engineering/shared 1.2.374 → 1.2.376

package/src/lib/utilities/src/spot.placeholder.registration.js

@@ -0,0 +1,88 @@
+import { GenericStatus, VehicleOwnershipType } from '@autologix/shared/enums';
+/**
+ * Registration formats the RTO actually issues.
+ *
+ * Two shapes cover the fleet:
+ *
+ *   STANDARD  `KA05QR3436` — 2-letter state, 1-2 digit RTO, 0-3 letter series,
+ *             4 digits. The series is optional because older plates omit it
+ *             (`KA079715`), and a 1-letter series is normal (`MH58B1199`).
+ *   BH        `22BH1299ZA` — Bharat series: 2-digit year, BH, 4 digits, 1-2
+ *             letters.
+ *
+ * Calibrated against UAT rather than assumed. It matches 359/359 Company Owned
+ * + BA, 83/83 Hotel Managed and 29/29 MMG registrations, so it is not
+ * rejecting real plates — which is the failure mode that would matter, since a
+ * false positive here stops a real vehicle being checked.
+ */
+const STANDARD_PLATE = /^[A-Z]{2}\d{1,2}[A-Z]{0,3}\d{4}$/;
+const BH_SERIES_PLATE = /^\d{2}BH\d{4}[A-Z]{1,2}$/;
+/** Uppercased, with the separators people type stripped out. */
+export const normaliseRegistration = (value) => (value ?? '').toUpperCase().replace(/[\s.-]/g, '');
+/** Whether a registration could plausibly be a real Indian number plate. */
+export const looksLikeRealRegistration = (value) => {
+    const plate = normaliseRegistration(value);
+    if (!plate)
+        return false;
+    return STANDARD_PLATE.test(plate) || BH_SERIES_PLATE.test(plate);
+};
+/**
+ * A spot-hire row that stands in for a vehicle rather than naming one.
+ *
+ * Spot hire books capacity from a supplier before anyone knows which car will
+ * turn up, so the vehicle master row carries the supplier's own code — UAT
+ * holds `TBS03`, `SWIFT1`, `MYCITI5`, `WINGS22`, `STATE05`. The real plate is
+ * captured separately at allocation as the Actual Vehicle Number.
+ *
+ * 793 of UAT's 2490 spot rows are like this. Every provider hit against one is
+ * a billable call that can only ever return "RC number is invalid" — precisely
+ * the 400 QA reported — and every compliance verdict derived from one judges a
+ * vehicle that does not exist.
+ *
+ * Deliberately narrowed to spot hire. The same regex would also flag test rows
+ * in other business types (`TEST123`, `SANJOG9`), but those are meant to name a
+ * real vehicle, so a bad registration there is a data-quality problem someone
+ * should see and fix — not a reason to stop checking compliance. Exempting them
+ * would quietly turn a typo into a hole in the allocation block.
+ */
+export const isSpotPlaceholderRegistration = (registration, businessType) => {
+    if (businessType !== VehicleOwnershipType.HiredCarSpot)
+        return false;
+    return !looksLikeRealRegistration(registration);
+};
+/**
+ * The business type a vehicle's compliance should be judged against.
+ *
+ * The ACTIVE contract wins, then the most recently created one, then the
+ * vehicle's own ownership field. That ordering matters: `Vehicle.ownershipType`
+ * goes stale when a vehicle moves vendors, so reading it directly applies the
+ * PREVIOUS business type's rules — a vehicle showing "Company Owned" was still
+ * being judged as "Company Owned + BA" (AD-3140, QA round 2 finding M).
+ *
+ * Falls back rather than returning undefined when no contract is loaded: a
+ * caller that omits the relation should degrade to the old behaviour, not to
+ * "no compliance is mandatory", which would silently disable the block.
+ *
+ * Pure and shared because three places need this answer — the allocation
+ * block, the §8 report, and the provider-hit filter — and three copies is
+ * three places for it to drift. The evaluation service and the report service
+ * had already drifted once, which is what finding M was.
+ */
+export const resolveVehicleBusinessType = (contracts, fallbackOwnershipType, now = new Date()) => {
+    const rows = contracts ?? [];
+    const active = rows.find((contract) => {
+        const from = contract.bizTypeEffectiveFrom
+            ? new Date(contract.bizTypeEffectiveFrom)
+            : undefined;
+        const end = contract.endDate ? new Date(contract.endDate) : undefined;
+        return ((!from || from <= now) &&
+            (!end || end >= now) &&
+            contract.status === GenericStatus.Active);
+    });
+    const latest = rows.length
+        ? [...rows].sort((a, b) => new Date(b.crdAt ?? 0).getTime() -
+            new Date(a.crdAt ?? 0).getTime())[0]
+        : undefined;
+    return (active?.bizType ?? latest?.bizType ?? fallbackOwnershipType ?? undefined);
+};
+//# sourceMappingURL=spot.placeholder.registration.js.map

package/src/lib/utilities/src/spot.placeholder.registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spot.placeholder.registration.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/spot.placeholder.registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAC1D,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAEnD,gEAAgE;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAqB,EAAU,EAAE,CACtE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AAEpD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAqB,EAAW,EAAE;IAC3E,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC5C,YAA4B,EAC5B,YAA4B,EAClB,EAAE;IACZ,IAAI,YAAY,KAAK,oBAAoB,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IACrE,OAAO,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACzC,SAMsB,EACtB,qBAAgD,EAChD,MAAY,IAAI,IAAI,EAAE,EACD,EAAE;IACvB,MAAM,IAAI,GAAG,SAAS,IAAI,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,oBAAoB;YACzC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YACzC,CAAC,CAAC,SAAS,CAAC;QACb,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtE,OAAO,CACN,CAAC,CAAC,IAAI,IAAI,IAAI,IAAI,GAAG,CAAC;YACtB,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC;YACpB,QAAQ,CAAC,MAAM,KAAK,aAAa,CAAC,MAAM,CACxC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;QACzB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CACd,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACR,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE;YAChC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CACjC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,SAAS,CAAC;IAEb,OAAO,CACN,MAAM,EAAE,OAAO,IAAI,MAAM,EAAE,OAAO,IAAI,qBAAqB,IAAI,SAAS,CACxE,CAAC;AACH,CAAC,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":""}