@bisondesk/core-sdk 1.0.621 → 1.0.623

package/src/types/vehicle-purchase-payments.ts

@@ -0,0 +1,58 @@
+import { BaseEvent } from './internal-events.js';
+import { SearchVehicle } from './vehicles.js';
+
+export const VEHICLE_PURCHASE_PAYMENT_ALLOWED_NOTIFICATION_ORIGIN =
+  'vehicle-purchase-payment-allowed-notification';
+
+export type NewVehiclePurchasePayment = {
+  vehicleId: string;
+  amount: string;
+  description?: string;
+  paidAt?: string;
+  paidBy?: string;
+};
+
+export type VehiclePurchasePayment = NewVehiclePurchasePayment & {
+  id: string;
+  createdBy: string;
+  createdAt: string;
+};
+
+export type VehiclePurchasePaymentBff = {
+  payment: VehiclePurchasePayment;
+  vehicle: SearchVehicle;
+};
+
+export type VehiclePurchasePaymentCreateEvent = {
+  payment: VehiclePurchasePayment;
+  previousPayment?: undefined;
+  action: 'create';
+  actionAt: string;
+  userId: string;
+  tenantId: string;
+};
+
+export type VehiclePurchasePaymentUpdateEvent = {
+  payment: VehiclePurchasePayment;
+  previousPayment: VehiclePurchasePayment;
+  action: 'update';
+  actionAt: string;
+  userId: string;
+  tenantId: string;
+};
+
+export type VehiclePurchasePaymentDeleteEvent = {
+  payment?: undefined;
+  previousPayment: VehiclePurchasePayment;
+  action: 'delete';
+  actionAt: string;
+  userId: string;
+  tenantId: string;
+};
+
+export type VehiclePurchasePaymentEvent = BaseEvent &
+  (
+    | VehiclePurchasePaymentCreateEvent
+    | VehiclePurchasePaymentUpdateEvent
+    | VehiclePurchasePaymentDeleteEvent
+  );

package/src/types/vehicle-sales.js

@@ -0,0 +1,6 @@
+export var VehicleSaleInfoActions;
+(function (VehicleSaleInfoActions) {
+    VehicleSaleInfoActions["VIEW_COSTS"] = "canSeeCosts";
+    VehicleSaleInfoActions["VIEW_CUSTOMER"] = "canSeeCustomer";
+})(VehicleSaleInfoActions || (VehicleSaleInfoActions = {}));
+//# sourceMappingURL=vehicle-sales.js.map

package/src/types/vehicle-sales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vehicle-sales.js","sourceRoot":"","sources":["vehicle-sales.ts"],"names":[],"mappings":"AAOA,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,oDAA0B,CAAA;IAC1B,0DAAgC,CAAA;AAClC,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC"}

package/src/types/vehicles.js

@@ -0,0 +1,98 @@
+export var VehicleRoles;
+(function (VehicleRoles) {
+    VehicleRoles["SALE"] = "SALE";
+    VehicleRoles["OWN_USE"] = "OWN_USE";
+    VehicleRoles["RENTAL"] = "RENTAL";
+    VehicleRoles["BUILD"] = "BUILD";
+    VehicleRoles["UNKNOWN"] = "UNKNOWN";
+    VehicleRoles["BANK_FINANCE"] = "BANK_FINANCE";
+})(VehicleRoles || (VehicleRoles = {}));
+export var VehicleFuelType;
+(function (VehicleFuelType) {
+    VehicleFuelType["Petrol"] = "PETROL";
+    VehicleFuelType["Diesel"] = "DIESEL";
+    VehicleFuelType["LPG"] = "LPG";
+    VehicleFuelType["LPG_G3"] = "LPG_G3";
+    VehicleFuelType["Electric"] = "ELECTRIC";
+    VehicleFuelType["CNG"] = "CNG";
+    VehicleFuelType["Hydrogen"] = "HYDROGEN";
+    VehicleFuelType["BioEthanol"] = "BIO_ETHANOL";
+    VehicleFuelType["BioDiesel"] = "BIO_DIESEL";
+    VehicleFuelType["E85"] = "E85";
+    VehicleFuelType["HCNG"] = "HCNG";
+    VehicleFuelType["LPG_Petrol"] = "LPG_PETROL";
+    VehicleFuelType["LPG_Diesel"] = "LPG_DIESEL";
+    VehicleFuelType["LPG_G3_Petrol"] = "LPG_G3_PETROL";
+    VehicleFuelType["LPG_G3_Diesel"] = "LPG_G3_DIESEL";
+    VehicleFuelType["Electric_Diesel"] = "ELECTRIC_DIESEL";
+    VehicleFuelType["Electric_Petrol"] = "ELECTRIC_PETROL";
+    VehicleFuelType["Hybrid"] = "HYBRID";
+    VehicleFuelType["Other"] = "OTHER";
+})(VehicleFuelType || (VehicleFuelType = {}));
+export var VehicleTachoTypes;
+(function (VehicleTachoTypes) {
+    VehicleTachoTypes["Analog"] = "ANALOG";
+    VehicleTachoTypes["Digital"] = "DIGITAL";
+    VehicleTachoTypes["SmartTacho1"] = "SMART_TACHO_1";
+    VehicleTachoTypes["SmartTacho2"] = "SMART_TACHO_2";
+})(VehicleTachoTypes || (VehicleTachoTypes = {}));
+export var SearchVehicleSaleDealStatus;
+(function (SearchVehicleSaleDealStatus) {
+    SearchVehicleSaleDealStatus["NotSold"] = "NOT_SOLD";
+    SearchVehicleSaleDealStatus["Reserved"] = "RESERVED";
+    SearchVehicleSaleDealStatus["Sold"] = "SOLD";
+})(SearchVehicleSaleDealStatus || (SearchVehicleSaleDealStatus = {}));
+export var VehiclePurchaseDealStatus;
+(function (VehiclePurchaseDealStatus) {
+    VehiclePurchaseDealStatus["Marketing"] = "MARKETING";
+    VehiclePurchaseDealStatus["PurchaseEvaluation"] = "PURCHASE_EVALUATION";
+    VehiclePurchaseDealStatus["PurchaseAgreed"] = "PURCHASE_AGREED";
+    VehiclePurchaseDealStatus["FirstPaymentAllowed"] = "FIRST_PAYMENT_ALLOWED";
+    VehiclePurchaseDealStatus["FirstPaymentSent"] = "FIRST_PAYMENT_SENT";
+    VehiclePurchaseDealStatus["FullPaymentAllowed"] = "FULL_PAYMENT_ALLOWED";
+    VehiclePurchaseDealStatus["FullPaymentSent"] = "FULL_PAYMENT_SENT";
+})(VehiclePurchaseDealStatus || (VehiclePurchaseDealStatus = {}));
+export var VehiclePurchaseLogisticsStatus;
+(function (VehiclePurchaseLogisticsStatus) {
+    VehiclePurchaseLogisticsStatus["AtOrigin"] = "AT_ORIGIN";
+    VehiclePurchaseLogisticsStatus["Arrived"] = "ARRIVED";
+    VehiclePurchaseLogisticsStatus["CheckedIn"] = "CHECKED_IN";
+})(VehiclePurchaseLogisticsStatus || (VehiclePurchaseLogisticsStatus = {}));
+export var VehiclePurchaseDeliveryType;
+(function (VehiclePurchaseDeliveryType) {
+    VehiclePurchaseDeliveryType["PickUp"] = "PICK_UP";
+    VehiclePurchaseDeliveryType["DropOff"] = "DROP_OFF";
+})(VehiclePurchaseDeliveryType || (VehiclePurchaseDeliveryType = {}));
+export var VehicleActions;
+(function (VehicleActions) {
+    VehicleActions["EditAdminDocs"] = "edit_admin_docs";
+    VehicleActions["EditEngineeringDocs"] = "edit_engineering_docs";
+    VehicleActions["EditMarketing"] = "edit_marketing";
+    VehicleActions["EditMedia"] = "edit_media";
+    VehicleActions["EditPictures"] = "edit_pictures";
+    VehicleActions["EditPrices"] = "edit_prices";
+    VehicleActions["EditPurchaseDeal"] = "edit_purchase_deal";
+    VehicleActions["EditPurchaseLogistics"] = "edit_purchase_logistics";
+    VehicleActions["EditSpecs"] = "edit_specs";
+    VehicleActions["EditVideos"] = "edit_videos";
+    VehicleActions["ViewLeads"] = "view_leads";
+    VehicleActions["ViewSimilarOnline"] = "view_similar_online";
+    VehicleActions["ViewPurchase"] = "view_purchase";
+    VehicleActions["ViewPriceHistory"] = "view_price_history";
+    VehicleActions["DeleteVehicle"] = "delete_vehicle";
+})(VehicleActions || (VehicleActions = {}));
+export var PurchaseActions;
+(function (PurchaseActions) {
+    PurchaseActions["ViewDeal"] = "view_deal";
+    PurchaseActions["ViewSupplierOrganization"] = "view_supplier_organization";
+    PurchaseActions["ViewContact"] = "view_contact";
+    PurchaseActions["ViewLegalAddress"] = "view_legal_address";
+    PurchaseActions["ViewPickupAddress"] = "view_pickup_address";
+    PurchaseActions["ViewEstimatedCosts"] = "view_estimated_costs";
+    PurchaseActions["ViewFinanceDocuments"] = "view_finance_documents";
+    PurchaseActions["AddPayment"] = "add_payment";
+    PurchaseActions["EditPayment"] = "edit_payment";
+    PurchaseActions["MarkPaymentDone"] = "mark_payment_done";
+    PurchaseActions["AddRemarks"] = "add_remarks";
+})(PurchaseActions || (PurchaseActions = {}));
+//# sourceMappingURL=vehicles.js.map

package/src/types/vehicles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vehicles.js","sourceRoot":"","sources":["vehicles.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;IACjB,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,6CAA6B,CAAA;AAC/B,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAED,MAAM,CAAN,IAAY,eAoBX;AApBD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;IACjB,8BAAW,CAAA;IACX,oCAAiB,CAAA;IACjB,wCAAqB,CAAA;IACrB,8BAAW,CAAA;IACX,wCAAqB,CAAA;IACrB,6CAA0B,CAAA;IAC1B,2CAAwB,CAAA;IACxB,8BAAW,CAAA;IACX,gCAAa,CAAA;IACb,4CAAyB,CAAA;IACzB,4CAAyB,CAAA;IACzB,kDAA+B,CAAA;IAC/B,kDAA+B,CAAA;IAC/B,sDAAmC,CAAA;IACnC,sDAAmC,CAAA;IACnC,oCAAiB,CAAA;IACjB,kCAAe,CAAA;AACjB,CAAC,EApBW,eAAe,KAAf,eAAe,QAoB1B;AAED,MAAM,CAAN,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,sCAAiB,CAAA;IACjB,wCAAmB,CAAA;IACnB,kDAA6B,CAAA;IAC7B,kDAA6B,CAAA;AAC/B,CAAC,EALW,iBAAiB,KAAjB,iBAAiB,QAK5B;AAiLD,MAAM,CAAN,IAAY,2BAIX;AAJD,WAAY,2BAA2B;IACrC,mDAAoB,CAAA;IACpB,oDAAqB,CAAA;IACrB,4CAAa,CAAA;AACf,CAAC,EAJW,2BAA2B,KAA3B,2BAA2B,QAItC;AAwWD,MAAM,CAAN,IAAY,yBAQX;AARD,WAAY,yBAAyB;IACnC,oDAAuB,CAAA;IACvB,uEAA0C,CAAA;IAC1C,+DAAkC,CAAA;IAClC,0EAA6C,CAAA;IAC7C,oEAAuC,CAAA;IACvC,wEAA2C,CAAA;IAC3C,kEAAqC,CAAA;AACvC,CAAC,EARW,yBAAyB,KAAzB,yBAAyB,QAQpC;AAED,MAAM,CAAN,IAAY,8BAIX;AAJD,WAAY,8BAA8B;IACxC,wDAAsB,CAAA;IACtB,qDAAmB,CAAA;IACnB,0DAAwB,CAAA;AAC1B,CAAC,EAJW,8BAA8B,KAA9B,8BAA8B,QAIzC;AAED,MAAM,CAAN,IAAY,2BAGX;AAHD,WAAY,2BAA2B;IACrC,iDAAkB,CAAA;IAClB,mDAAoB,CAAA;AACtB,CAAC,EAHW,2BAA2B,KAA3B,2BAA2B,QAGtC;AAwGD,MAAM,CAAN,IAAY,cAgBX;AAhBD,WAAY,cAAc;IACxB,mDAAiC,CAAA;IACjC,+DAA6C,CAAA;IAC7C,kDAAgC,CAAA;IAChC,0CAAwB,CAAA;IACxB,gDAA8B,CAAA;IAC9B,4CAA0B,CAAA;IAC1B,yDAAuC,CAAA;IACvC,mEAAiD,CAAA;IACjD,0CAAwB,CAAA;IACxB,4CAA0B,CAAA;IAC1B,0CAAwB,CAAA;IACxB,2DAAyC,CAAA;IACzC,gDAA8B,CAAA;IAC9B,yDAAuC,CAAA;IACvC,kDAAgC,CAAA;AAClC,CAAC,EAhBW,cAAc,KAAd,cAAc,QAgBzB;AAED,MAAM,CAAN,IAAY,eAYX;AAZD,WAAY,eAAe;IACzB,yCAAsB,CAAA;IACtB,0EAAuD,CAAA;IACvD,+CAA4B,CAAA;IAC5B,0DAAuC,CAAA;IACvC,4DAAyC,CAAA;IACzC,8DAA2C,CAAA;IAC3C,kEAA+C,CAAA;IAC/C,6CAA0B,CAAA;IAC1B,+CAA4B,CAAA;IAC5B,wDAAqC,CAAA;IACrC,6CAA0B,CAAA;AAC5B,CAAC,EAZW,eAAe,KAAf,eAAe,QAY1B"}

package/src/utils/leasing.js

@@ -0,0 +1,6 @@
+import { UTCDate } from '@date-fns/utc';
+import { format } from 'date-fns';
+import { last, map, sortBy, uniqBy } from 'lodash-es';
+export const sortContractClients = (clients) => sortBy(map(uniqBy(clients, (c) => c.takeoverId), (c) => ({ ...c, since: format(new UTCDate(c.since), 'yyyy-MM-dd') })), (cli) => cli.since, (cli) => (cli.takeoverId ? parseInt(cli.takeoverId.replace(/[^0-9]/g, '')) : 0));
+export const getDealRef = ({ conditions, opportunities, }) => last(conditions) ?? last(opportunities);
+//# sourceMappingURL=leasing.js.map

package/src/utils/leasing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leasing.js","sourceRoot":"","sources":["leasing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAStD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAgC,EAA2B,EAAE,CAC/F,MAAM,CACJ,GAAG,CACD,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,CACrE,EACD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAClB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAChF,CAAC;AAEJ,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EACzB,UAAU,EACV,aAAa,GACyC,EAAkC,EAAE,CAC1F,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,aAAa,CAAE,CAAC"}

package/src/utils/opportunities.js

@@ -0,0 +1,48 @@
+import { OpportunityStatus, OpportunityStatusOrder } from '../types/opportunities.js';
+const compareOpportunityStatus = (input) => {
+    const { currentStatus, referenceStatus } = input;
+    const currentStatusIdx = OpportunityStatusOrder.indexOf(currentStatus);
+    const referenceStatusIdx = OpportunityStatusOrder.indexOf(referenceStatus);
+    return {
+        currentStatusIdx,
+        referenceStatusIdx,
+    };
+};
+export const getPreviousStatus = (currentStatus) => {
+    const currentIndex = OpportunityStatusOrder.indexOf(currentStatus);
+    if (currentIndex === 0) {
+        return;
+    }
+    return OpportunityStatusOrder[currentIndex - 1];
+};
+export const getNextStatus = (status) => {
+    const statusIndex = OpportunityStatusOrder.indexOf(status);
+    if (statusIndex >= OpportunityStatusOrder.length - 1) {
+        return;
+    }
+    return OpportunityStatusOrder[statusIndex + 1];
+};
+export const isSameOrAfterReferenceOpportunityStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOpportunityStatus(input);
+    return currentStatusIdx >= referenceStatusIdx;
+};
+export const isAfterReferenceOpportunityStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOpportunityStatus(input);
+    return currentStatusIdx > referenceStatusIdx;
+};
+export const isSameOrBeforeReferenceOpportunityStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOpportunityStatus(input);
+    return currentStatusIdx <= referenceStatusIdx;
+};
+export const isBeforeReferenceOpportunityStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOpportunityStatus(input);
+    return currentStatusIdx < referenceStatusIdx;
+};
+export const isOpportunityLost = (input) => input.lostAt != null;
+export const getOpportunityReservedStatus = () => [
+    OpportunityStatus.REVIEW,
+    OpportunityStatus.PREPARATION,
+    OpportunityStatus.DELIVERY,
+];
+export const isOpportunityReserved = (input) => getOpportunityReservedStatus().includes(input.status);
+//# sourceMappingURL=opportunities.js.map

package/src/utils/opportunities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunities.js","sourceRoot":"","sources":["opportunities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAOnG,MAAM,wBAAwB,GAAG,CAAC,KAAmB,EAAE,EAAE;IACvD,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC;IAEjD,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACvE,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAE3E,OAAO;QACL,gBAAgB;QAChB,kBAAkB;KACnB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,aAAgC,EACD,EAAE;IACjC,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,OAAO,sBAAsB,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAyB,EAAiC,EAAE;IACxF,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,WAAW,IAAI,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO;IACT,CAAC;IACD,OAAO,sBAAsB,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,KAAmB,EAAW,EAAE;IACtF,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEjF,OAAO,gBAAgB,IAAI,kBAAkB,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,KAAmB,EAAW,EAAE;IAChF,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEjF,OAAO,gBAAgB,GAAG,kBAAkB,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,KAAmB,EAAW,EAAE;IACvF,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEjF,OAAO,gBAAgB,IAAI,kBAAkB,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,KAAmB,EAAW,EAAE;IACjF,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEjF,OAAO,gBAAgB,GAAG,kBAAkB,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAkB,EAAW,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC;AAEvF,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAwB,EAAE,CAAC;IACrE,iBAAiB,CAAC,MAAM;IACxB,iBAAiB,CAAC,WAAW;IAC7B,iBAAiB,CAAC,QAAQ;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAkB,EAAW,EAAE,CACnE,4BAA4B,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC"}

package/src/utils/opportunities.ts

@@ -69,3 +69,23 @@ export const getOpportunityReservedStatus = (): OpportunityStatus[] => [
 
 export const isOpportunityReserved = (input: Opportunity): boolean =>
   getOpportunityReservedStatus().includes(input.status);
+
+/**
+ * Whether the opportunity currently reserves the vehicle attached to it: reserved-stage
+ * (REVIEW onwards) and not lost — independent of whether a reservation row exists. Query-side
+ * twin: `getOpportunityReservingVehicle` in core's opportunities/read.ts. Availability
+ * propagation, warnings and guards must share this one definition rather than re-composing
+ * the two primitives.
+ */
+export const isOpportunityReservingVehicle = (input: Opportunity): boolean =>
+  isOpportunityReserved(input) && !isOpportunityLost(input);
+
+/**
+ * The vehicle the opportunity currently reserves, if any — undefined outside the reserved
+ * range, when lost, without a vehicle, or for a missing opportunity. Compare this value
+ * before/after an update to detect a vehicle being taken or freed.
+ */
+export const getOpportunityReservedVehicleId = (
+  input: Opportunity | undefined,
+): string | undefined =>
+  input != null && isOpportunityReservingVehicle(input) ? input.vehicleId : undefined;