@bisondesk/core-sdk 1.0.610 → 1.0.612

package/src/types/offers.js

@@ -0,0 +1,56 @@
+export var OfferActions;
+(function (OfferActions) {
+    OfferActions["CREATE_BID"] = "create_bid";
+    OfferActions["SET_FINAL_VALUATION"] = "set_final_valuation";
+    OfferActions["LOSE"] = "lose";
+    OfferActions["REOPEN"] = "reopen";
+    OfferActions["SET_DOCUMENTS"] = "set_documents";
+    OfferActions["SET_METADATA"] = "set_metadata";
+    OfferActions["SEE_SUPPLIER"] = "see_supplier";
+    OfferActions["SEE_INSIGHTS"] = "see_insights";
+    OfferActions["VIEW_BIDS"] = "view_bids";
+    OfferActions["DELETE_FINAL_VALUATION"] = "delete_final_valuation";
+    OfferActions["SEE_ASKING_PRICE"] = "see_asking_price";
+    OfferActions["ACCEPT_NEGOTIATION"] = "accept_negotiation";
+    OfferActions["UNDO_ACCEPT_NEGOTIATION"] = "undo_accept_negotiation";
+    OfferActions["SET_SUPPLIER_VEHICLE"] = "set_supplier_vehicle";
+    OfferActions["CAN_PURCHASE"] = "can_purchase";
+})(OfferActions || (OfferActions = {}));
+export var OfferBidActions;
+(function (OfferBidActions) {
+    OfferBidActions["EDIT_BID"] = "create_bid";
+    OfferBidActions["DELETE_BID"] = "delete_bid";
+})(OfferBidActions || (OfferBidActions = {}));
+export var OfferStatus;
+(function (OfferStatus) {
+    OfferStatus["PROSPECTION"] = "prospection";
+    OfferStatus["VALUATION"] = "valuation";
+    OfferStatus["NEGOTIATION"] = "negotiation";
+})(OfferStatus || (OfferStatus = {}));
+export var OfferLostReasonValues;
+(function (OfferLostReasonValues) {
+    OfferLostReasonValues["Expensive"] = "expensive";
+    OfferLostReasonValues["NoMarket"] = "no_market";
+    OfferLostReasonValues["BadExperience"] = "bad_experience";
+    OfferLostReasonValues["NoAnswer"] = "supplier_mia";
+    OfferLostReasonValues["Other"] = "other";
+    OfferLostReasonValues["Automatic"] = "automatic";
+})(OfferLostReasonValues || (OfferLostReasonValues = {}));
+export var OfferBidType;
+(function (OfferBidType) {
+    OfferBidType["INTERNAL"] = "internal";
+    OfferBidType["EXTERNAL"] = "external";
+})(OfferBidType || (OfferBidType = {}));
+export var OfferWarningsCode;
+(function (OfferWarningsCode) {
+    OfferWarningsCode["NO_SUPPLIER"] = "no_supplier";
+})(OfferWarningsCode || (OfferWarningsCode = {}));
+export const OfferStatusOrder = [
+    OfferStatus.PROSPECTION,
+    OfferStatus.VALUATION,
+    OfferStatus.NEGOTIATION,
+];
+export const OfferWonColumnId = 'closed_won';
+export const OfferKanbanColumns = [...OfferStatusOrder, OfferWonColumnId];
+export const OfferKanbanEndColumns = [OfferWonColumnId];
+//# sourceMappingURL=offers.js.map

package/src/types/opportunities.js

@@ -0,0 +1,107 @@
+export var OpportunityActions;
+(function (OpportunityActions) {
+    OpportunityActions["ADD_REMARKS"] = "add_remarks";
+    OpportunityActions["CREATE_QUOTE"] = "create_quote";
+    OpportunityActions["LOSE"] = "lose";
+    OpportunityActions["REOPEN"] = "reopen";
+    OpportunityActions["START_PREPARATION"] = "start_preparation";
+    OpportunityActions["REVERT_PREPARATION"] = "revert_preparation";
+    OpportunityActions["START_DELIVERY"] = "start_delivery";
+    OpportunityActions["REVERT_DELIVERY"] = "revert_delivery";
+    OpportunityActions["SET_CUSTOMER"] = "set_customer";
+    OpportunityActions["SET_DOCUMENTS"] = "set_documents";
+    OpportunityActions["SET_INTEREST"] = "set_interest";
+    OpportunityActions["SET_METADATA"] = "set_metadata";
+    OpportunityActions["SET_VEHICLE"] = "set_vehicle";
+    OpportunityActions["ADD_ACTIVITY"] = "add_activity";
+    OpportunityActions["ADD_PAYMENT"] = "add_payment";
+    OpportunityActions["SWITCH_VEHICLE"] = "switch_vehicle";
+    OpportunityActions["DELIVER_VEHICLE"] = "deliver_vehicle";
+    OpportunityActions["UNDO_DELIVER_VEHICLE"] = "undo_deliver_vehicle";
+    OpportunityActions["SET_DEAL_INFO"] = "update_deal_info";
+    OpportunityActions["ISSUE_INVOICE"] = "issue_invoice";
+})(OpportunityActions || (OpportunityActions = {}));
+export var OpportunityPaymentStatus;
+(function (OpportunityPaymentStatus) {
+    OpportunityPaymentStatus["PARTIAL_PAYMENT"] = "partial_payment";
+    OpportunityPaymentStatus["FULL_PAYMENT"] = "full_payment";
+    OpportunityPaymentStatus["NO_PAYMENT"] = "no_payment";
+})(OpportunityPaymentStatus || (OpportunityPaymentStatus = {}));
+export var OpportunityStatus;
+(function (OpportunityStatus) {
+    OpportunityStatus["PROSPECTION"] = "prospection";
+    OpportunityStatus["DISCOVERY"] = "discovery";
+    OpportunityStatus["EVALUATION"] = "evaluation";
+    OpportunityStatus["REVIEW"] = "review";
+    OpportunityStatus["PREPARATION"] = "preparation";
+    OpportunityStatus["DELIVERY"] = "delivery";
+})(OpportunityStatus || (OpportunityStatus = {}));
+export const OpportunityStatusOrder = [
+    OpportunityStatus.PROSPECTION,
+    OpportunityStatus.DISCOVERY,
+    OpportunityStatus.EVALUATION,
+    OpportunityStatus.REVIEW,
+    OpportunityStatus.PREPARATION,
+    OpportunityStatus.DELIVERY,
+];
+export var OpportunityRequirementsCode;
+(function (OpportunityRequirementsCode) {
+    OpportunityRequirementsCode["VEHICLE_AT_ORIGIN"] = "vehicle_at_origin";
+    OpportunityRequirementsCode["LEASING_SL_ACTION"] = "sl_action";
+    OpportunityRequirementsCode["TECHNICAL_NOTES_CHANGED"] = "technical_notes_changed";
+})(OpportunityRequirementsCode || (OpportunityRequirementsCode = {}));
+export var OpportunityWarningsCode;
+(function (OpportunityWarningsCode) {
+    OpportunityWarningsCode["QUOTE_PENDING_VALIDATION"] = "quote_pending_validation";
+    OpportunityWarningsCode["QUOTE_PEDING_MANAGER_APPROVAL"] = "quote_pending_manager_approval";
+    OpportunityWarningsCode["CONCURRENT_OPPORTUNITIES"] = "concurrent_opportunities";
+    OpportunityWarningsCode["VEHICLE_RESERVED"] = "vehicle_reserved";
+    OpportunityWarningsCode["OPPORTUNITY_NEEDS_SWITCH_VEHICLE"] = "opportunity_needs_switch_vehicle";
+    OpportunityWarningsCode["VEHICLE_RESERVED_DATE_INFO"] = "vehicle_reserved_date_info";
+    OpportunityWarningsCode["VEHICLE_RESERVED_INDEFINITELY"] = "vehicle_reserved_indefinitely";
+    OpportunityWarningsCode["QUOTE_MISSING_DELIVERY_DETAILS"] = "quote_missing_delivery_details";
+    OpportunityWarningsCode["VEHICLE_TECHNICAL_DETAILS_CHANGED"] = "vehicle_technical_details_changed";
+    OpportunityWarningsCode["QUOTE_MISSING_FINANCING_DETAILS"] = "quote_missing_financing_details";
+})(OpportunityWarningsCode || (OpportunityWarningsCode = {}));
+export const OpportunityWonColumnId = 'closed_won';
+export const OpportunityKanbanColumns = [...OpportunityStatusOrder, OpportunityWonColumnId];
+export const OpportunityKanbanEndColumns = [OpportunityWonColumnId];
+export var OpportunityLostReasonValues;
+(function (OpportunityLostReasonValues) {
+    OpportunityLostReasonValues["Expensive"] = "expensive";
+    OpportunityLostReasonValues["AlreadySold"] = "already_sold";
+    OpportunityLostReasonValues["BadExperience"] = "bad_experience";
+    OpportunityLostReasonValues["IncorrectVehicleCondition"] = "incorrect_vehicle_condition";
+    OpportunityLostReasonValues["NoStock"] = "not_enough_stock";
+    OpportunityLostReasonValues["SlowDelivery"] = "slow_delivery";
+    OpportunityLostReasonValues["HighDeposit"] = "deposit_too_high";
+    OpportunityLostReasonValues["NoAnswer"] = "client_not_answered";
+    OpportunityLostReasonValues["Automatic"] = "automatic";
+    OpportunityLostReasonValues["LeasingDeal"] = "sold-via-leasing";
+})(OpportunityLostReasonValues || (OpportunityLostReasonValues = {}));
+export var VehicleSaleDealStatus;
+(function (VehicleSaleDealStatus) {
+    VehicleSaleDealStatus["SaleAgreed"] = "SALE_AGREED";
+    VehicleSaleDealStatus["FirstPaymentReceived"] = "FIRST_PAYMENT_RECEIVED";
+    VehicleSaleDealStatus["FullPaymentReceived"] = "FULL_PAYMENT_RECEIVED";
+})(VehicleSaleDealStatus || (VehicleSaleDealStatus = {}));
+export var VehicleSaleLogisticsStatus;
+(function (VehicleSaleLogisticsStatus) {
+    VehicleSaleLogisticsStatus["AtOrigin"] = "AT_ORIGIN";
+    VehicleSaleLogisticsStatus["Delivered"] = "DELIVERED";
+})(VehicleSaleLogisticsStatus || (VehicleSaleLogisticsStatus = {}));
+export const QUOTE_NEEDS_VALIDATION_NOTIFICATION_ORIGIN = 'quote-validation';
+export const QUOTE_NOT_CREATED_BY_ACCOUNT_MANAGER = 'quote-not-created-by-account-manager';
+export const QUOTE_VALIDATOR_FEEDBACK_NOTIFICATION_ORIGIN = 'quote-validation-feedback';
+export const OPPORTUNITY_VEHICLE_AVAILABLE_NOTIFICATION_ORIGIN = 'opportunity-vehicle-available';
+export const OPPORTUNITY_VEHICLE_DELIVERY_NOTIFICATION_ORIGIN = 'opportunity-vehicle-delivery';
+export const OPPORTUNITY_VEHICLE_RESERVATION_ABOUT_TO_EXPIRE_NOTIFICATION_ORIGIN = 'opportunity-vehicle-reservation-to-expire';
+export const OPPORTUNITY_VEHICLE_RESERVATION_EXPIRED_NOTIFICATION_ORIGIN = 'opportunity-vehicle-reservation-expired';
+export const OFFER_SET_FINAL_VALUATION_ORIGIN = 'offer-set-final-valuation';
+export const VEHICLE_PRICE_DECREASES_NOTIFICATION_ORIGIN = 'vehicle-price-decreased';
+export const VEHICLE_ARRIVED_NOTIFICATION_ORIGIN = 'vehicle-arrived';
+export const VEHICLE_CHECKEDIN_NOTIFICATION_ORIGIN = 'vehicle-checkedin';
+export const VEHICLE_PURCHASED_NOTIFICATION_ORIGIN = 'vehicle-purchased';
+export const VEHICLE_PRICE_CHANGED_NOTIFICATION_ORIGIN = 'vehicle-price-changed';
+export const VEHICLE_SOLD_NOTIFICATION_ORIGIN = 'vehicle-sold';
+//# sourceMappingURL=opportunities.js.map

package/src/types/opportunities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunities.js","sourceRoot":"","sources":["opportunities.ts"],"names":[],"mappings":"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"}

package/src/types/opportunities.ts

@@ -2,7 +2,7 @@ import { Task } from '@bisondesk/commons-sdk/tasks';
 import { Document, NextList } from '@bisondesk/commons-sdk/types';
 import { BusinessEntityIds, OpportunityType, WarningHints } from '../constants.js';
 import { Contact, Organization } from './crm.js';
-import type { InterestBffMeta, OpportunityInterest } from './interests.js';
+import type { Interest, InterestBffMeta } from './interests.js';
 import { BaseEvent } from './internal-events.js';
 import { Payment } from './payments.js';
 import { Quote, QuoteStatus } from './quotes.js';
@@ -91,6 +91,7 @@ export enum OpportunityWarningsCode {
   QUOTE_MISSING_DELIVERY_DETAILS = 'quote_missing_delivery_details',
   VEHICLE_TECHNICAL_DETAILS_CHANGED = 'vehicle_technical_details_changed',
   QUOTE_MISSING_FINANCING_DETAILS = 'quote_missing_financing_details',
+  VEHICLE_BRANCH_MISMATCH = 'vehicle_branch_mismatch',
 }
 
 export const OpportunityWonColumnId = 'closed_won';
@@ -268,7 +269,7 @@ export type ContactMetdata = {
 export type OpportunityBFF = {
   opportunity: DataRecord<Opportunity, OpportunityBffMeta>;
   vehicle?: DataRecord<Vehicle, VehicleBffMetadata>;
-  interest?: DataRecord<OpportunityInterest, InterestBffMeta>;
+  interest?: DataRecord<Interest, InterestBffMeta>;
   bids: DataRecord<Bid>[];
   quotes: DataRecord<Quote>[];
   activeQuote?: DataRecord<Quote>;
@@ -352,6 +353,9 @@ export type SearchOpportunity = {
     // Operational supplier for reporting. For SLB clones this is the source vehicle supplier,
     // not the bank supplier on the clone purchase.
     realSupplierId?: string;
+    // Branch of the associated vehicle, coalesced from the synced original branch then the
+    // local branch — mirrors the vehicle index `custom.originalBranchId` facet.
+    originalBranchId?: string;
   };
 };
 

package/src/types/payments.js

@@ -0,0 +1,7 @@
+export var PaymentActions;
+(function (PaymentActions) {
+    PaymentActions["DELETE"] = "delete";
+    PaymentActions["EDIT"] = "edit";
+})(PaymentActions || (PaymentActions = {}));
+export const PAYMENT_NOTIFICATION_ORIGIN = 'payment-notification';
+//# sourceMappingURL=payments.js.map

package/src/types/picklists.js

@@ -0,0 +1,2 @@
+export * from '@bisondesk/commons-sdk/picklists';
+//# sourceMappingURL=picklists.js.map

package/src/types/picklists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picklists.js","sourceRoot":"","sources":["picklists.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC"}

package/src/types/prospects.ts

@@ -1,15 +1,21 @@
 import { Task } from '@bisondesk/commons-sdk/tasks';
-import { MultiLangValue, NextList } from '@bisondesk/commons-sdk/types';
+import { MultiLangValue, NextList, PaginatedList } from '@bisondesk/commons-sdk/types';
+import { Activity } from './activities.js';
 import { Contact, Organization } from './crm.js';
 import { Interest } from './interests.js';
 import { BaseEvent } from './internal-events.js';
-import { BaseSearchRequest } from './search.js';
+import { Offer } from './offers.js';
+import { Opportunity } from './opportunities.js';
+import { BaseSearchRequest, SearchRequest, SortFilter } from './search.js';
 import { DataRecord, ReferenceData } from './utils.js';
 
 export enum ProspectActions {
   CLOSE = 'close',
   REOPEN = 'reopen',
   ENGAGE = 'engage',
+  // Claiming an unassigned prospect is open to any active sales rep — a deliberate widening of
+  // ADR-0013's permission matrix (ADR-0021 §7).
+  CLAIM = 'claim',
   SET_METADATA = 'set_metadata',
   SET_OBJECTIVES = 'set_objectives',
   SET_CUSTOMER = 'set_customer',
@@ -46,20 +52,170 @@ export enum ProspectPriority {
   LOW = 'low',
   NORMAL = 'normal',
   HIGH = 'high',
+  // "Call me" fast lane (ADR-0021 §8): a manual URGENT prospect sorts ahead of every
+  // engine-ranked card. Above NORMAL, priority dominates scoreTier in the "next" cursor.
+  URGENT = 'urgent',
 }
 
+/**
+ * Numeric rank for priority, computed at index time into `custom.priorityRank` so OpenSearch
+ * can sort ordinally rather than alphabetically. Higher = more urgent.
+ */
+export const PRIORITY_RANK: Record<ProspectPriority, number> = {
+  [ProspectPriority.LOW]: 1,
+  [ProspectPriority.NORMAL]: 2,
+  [ProspectPriority.HIGH]: 3,
+  [ProspectPriority.URGENT]: 4,
+};
+
+/**
+ * How a prospect entered the system (ADR-0021 §3). The engine's truncate-and-regenerate
+ * delete predicate only ever touches `AUTO` cards, so `MANUAL`/`IMPORT` cards survive
+ * regardless of status. `IMPORT` is reserved for the v2 import pipeline — nothing produces
+ * it in v1, but it stays in the enum because the discriminator is part of the delete-predicate
+ * safety contract.
+ */
+export enum ProspectSource {
+  MANUAL = 'manual',
+  AUTO = 'auto',
+  IMPORT = 'import',
+}
+
+/**
+ * Discrete ranking band for an auto prospect (ADR-0021 §4). Each generator maps its own raw
+ * score into these bands via its own thresholds; the tier — not a raw number — is what the
+ * engine persists and the "next" cursor sorts on.
+ */
+export enum ProspectScoreTier {
+  COLD = 'cold',
+  LUKEWARM = 'lukewarm',
+  WARM = 'warm',
+  HOT = 'hot',
+}
+
+/**
+ * Numeric rank for a score tier, computed at index time into `custom.scoreTierRank`
+ * (0 = unscored/no tier). Higher = warmer.
+ */
+export const SCORE_TIER_RANK: Record<ProspectScoreTier, number> = {
+  [ProspectScoreTier.COLD]: 1,
+  [ProspectScoreTier.LUKEWARM]: 2,
+  [ProspectScoreTier.WARM]: 3,
+  [ProspectScoreTier.HOT]: 4,
+};
+
+/**
+ * Virtual sort field for search requests: "importance" is the compound priority → tier
+ * ranking (ADR-0021 §5). The backend expands it server-side, so clients never spell out
+ * the underlying fields.
+ */
+export const PROSPECT_IMPORTANCE_SORT_FIELD = 'prospect.importance';
+
+/** One line of the score breakdown recorded for explanation (raw score, thresholds, dampening). */
+export type ProspectScoreDetail = {
+  name: string;
+  value: number | string;
+};
+
+/**
+ * Denormalized vehicle display data carried on each candidate vehicle, so the UI can render the
+ * anchor and runner-ups without a second fetch. Mirrors `InterestLead.vehicleData` (and extends it
+ * with make/model/category/vin), keeping the two card surfaces consistent.
+ */
+export type ProspectVehicleData = {
+  title: string;
+  mainPictureUrl?: string;
+  stockNumber?: string;
+
+  category: string;
+  bodywork?: string;
+  makeName: string;
+  modelName?: string;
+  typeName?: string;
+
+  used?: boolean; // Vehicle.condition.used — false/absent means new.
+  damaged?: boolean;
+
+  advertisingYear?: number;
+  km?: number;
+  emissionsClass?: string;
+  emissionsSubClass?: string;
+  cabinModel?: string;
+  configuration?: string;
+  vin?: string;
+
+  // Notable boolean equipment, mirroring Vehicle.accessories (and superstructure.crane).
+  features?: {
+    adr?: boolean;
+    jumbo?: boolean;
+    crane?: boolean;
+    hydraulicTipperKit?: boolean;
+    lowDeck?: boolean;
+    retarderIntarder?: boolean;
+  };
+};
+
+/** A candidate anchor/runner-up vehicle, scored by the lead-engine matcher. */
+export type ProspectVehicleCandidate = {
+  vehicleId: string;
+  /** Branch that holds this stock. The anchor's branch decides the card's branch (ADR-0021 §2). */
+  branchId: string;
+  score: number;
+  vehicleData: ProspectVehicleData;
+};
+
+/** A recommended account manager with an affinity score and the reasons behind it. */
+export type ProspectRecommendedAm = {
+  userId: string;
+  score: number;
+  reasons: string[];
+};
+
 export type ProspectObjective = {
   id: string;
   title: MultiLangValue;
 };
 
+/**
+ * Inline identity for a card whose person/company matches no CRM record yet — the "draft party"
+ * of ADR-0021 §9. Carries enough structure to materialise a Contact (first/last name, phone,
+ * email) and/or an Organization (orgName, VAT, country) when the draft is converted
+ * (`SET_CUSTOMER`, grown). Drafts enter through import or manual entry only — the engine never
+ * produces them — and the nightly truncate never touches them.
+ */
+export type ProspectPartyDraft = {
+  // contact identity
+  firstName?: string;
+  lastName?: string;
+  phone?: string;
+  email?: string;
+  // organization identity
+  orgName?: string;
+  vatNumber?: string;
+  countryCode?: string;
+  /**
+   * Client sector (Tier 1) and sub-industry (Tier 2), captured on the draft so they survive
+   * promotion to an Organization. Same picklists and semantics as the Organization fields of the
+   * same name (`ORG_INDUSTRY_PICKLIST_ID` / `SUB_INDUSTRY_PICKLIST_ID`).
+   */
+  industry?: string;
+  subIndustry?: string;
+  /**
+   * The draft party's interests, embedded on the card — a draft has no CRM record to hang
+   * interests on, so they ride the card until conversion copies them onto the linked
+   * Contact/Organization (where the lead engine picks them up; embedded ones never feed it).
+   */
+  interests?: Interest[];
+};
+
 type BaseProspect = {
   contactId?: string;
   organizationId?: string;
+  /** Draft-party identity when the card is linked to no Contact/Organization yet (ADR §9). */
+  partyDraft?: ProspectPartyDraft;
   branchId: string;
   accountManager?: string;
   priority: ProspectPriority;
-  score?: number;
   objectives: ProspectObjective[];
 };
 
@@ -76,6 +232,17 @@ export type Prospect = BaseProspect & {
 
   status: ProspectStatus;
 
+  // ── Engine-owned fields (ADR-0021). The manual write path treats these as read-only
+  // (Joi.forbidden in the user schemas) so a human edit is never silently overwritten by the
+  // next nightly run. `source` is always present on a persisted card; the rest exist only on
+  // scored auto cards.
+  source: ProspectSource;
+  scoreTier?: ProspectScoreTier;
+  scoreDetails?: ProspectScoreDetail[];
+  /** Ordered by score desc; `vehicles[0]` is the anchor the rep opens the call with. */
+  vehicles?: ProspectVehicleCandidate[];
+  recommendedAccountManagers?: ProspectRecommendedAm[];
+
   attemptingAt?: string;
   attemptingBy?: string;
   engagedAt?: string;
@@ -93,10 +260,10 @@ export type Prospect = BaseProspect & {
 export type ProspectUpdate = {
   contactId?: string | null;
   organizationId?: string | null;
+  partyDraft?: ProspectPartyDraft | null;
   branchId?: string;
   accountManager?: string | null;
   priority?: ProspectPriority;
-  score?: number | null;
   objectives?: ProspectObjective[];
 
   close?: boolean;
@@ -110,6 +277,19 @@ export type ProspectBff = {
   contact?: DataRecord<Contact>;
   org?: DataRecord<Organization>;
   tasks: DataRecord<Task>[];
+
+  /** All interests in scope: the linked contact/org's, or the draft party's embedded ones. */
+  interests: Interest[];
+  /** Opportunities for the linked contact/org, deduped by id. */
+  opportunities: Opportunity[];
+  /** Offers for the linked contact/org, deduped by id, newest first. */
+  offers: Offer[];
+  /** The other prospect lines on the same contact/org (this one excluded), newest first. */
+  relatedProspects: Prospect[];
+  /** Most-recent interaction history (first page): the card's own + linked contact/org activities. */
+  activities: DataRecord<Activity>[];
+  /** Cursor for the next page of the merged activity history; absent when fully loaded. */
+  activitiesNextToken?: string;
 };
 
 /************
@@ -134,17 +314,107 @@ export type SearchProspect = {
      * Country of the lead, preferring contact country over org country when both are set.
      */
     country?: string;
+    /**
+     * Numeric ranks computed at index time so OpenSearch sorts ordinally, not alphabetically
+     * (ADR-0021 §4, §5). The "next" cursor sorts priorityRank desc → scoreTierRank desc → id asc.
+     */
+    priorityRank: number;
+    /** 0 = unscored (no tier yet). */
+    scoreTierRank: number;
+    /** User ids from `recommendedAccountManagers`, for the "suitable for me" filter (ADR §6). */
+    recommendedAmIds?: string[];
+    /**
+     * Collapse key for grouping by main vehicle (minimizing context switch): the anchor's
+     * vehicleId when the card carries vehicles, else the prospect id (a singleton group).
+     * Mirrors the opportunities kanban's `custom.groupKey` (group-by-client) convention.
+     */
+    groupKey: string;
+  };
+  /** Task counters denormalized at index time, for kanban/list badges. */
+  tasks?: {
+    totalTasks: number;
+    openTasks: number;
+    /** Soonest due date among open tasks. */
+    nextDueAt?: string;
   };
 };
 
+/************
+ *
+ * Claim
+ */
+
+/**
+ * Returned with HTTP 409 when a guarded claim finds the prospect already owned (a lost race). On
+ * success the endpoint returns the claimed `DataRecord<Prospect>` with 200 instead (ADR-0021 §7).
+ */
+export type ProspectClaimConflict = {
+  claimed: false;
+  accountManager?: string;
+};
+
+/************
+ *
+ * Next cursor / play mode
+ */
+
+/**
+ * The "next prospect" cursor (ADR-0021 §5). Accepts the same filter body as the list search, so
+ * "next" walks the rep's current view. Only the filter-defining fields are honored — sort, paging
+ * size and `nextToken` are owned by the endpoint (fixed priority→tier sort, `cursor` below). `cursor`
+ * is an opaque token embedding the sort position and a hash of the filters — it is rejected if the
+ * filter set changed. `claim: true` is play mode: the next matching unassigned card is served and
+ * claimed atomically (ADR §7).
+ */
+export type ProspectNextRequest = Pick<SearchRequest, 'fullText' | 'query' | 'geoFilters'> & {
+  cursor?: string;
+  claim?: boolean;
+  /**
+   * Serve cards grouped by main vehicle (minimizing context switch): all matching cards anchored
+   * on the same vehicle come consecutively before "next" moves to the following vehicle group.
+   */
+  groupByVehicle?: boolean;
+};
+
+export type ProspectNextResponse = {
+  result?: SearchProspect;
+  cursor?: string;
+  meta: ReferenceData;
+};
+
+/** A main-vehicle group (ES collapse on `custom.groupKey`), shared by kanban and list. */
+export type ProspectVehicleGroup = {
+  representative: SearchProspect;
+  items: SearchProspect[];
+};
+
+/** Flat list search, optionally collapsed by the card's main vehicle. */
+export type ProspectsSearchRequest = SearchRequest & {
+  /** Collapse on `custom.groupKey`: the page then streams GROUPS (offset-paged), not rows. */
+  groupByVehicle?: boolean;
+};
+
+export type ProspectsSearchResponse = PaginatedList<SearchProspect, ReferenceData> & {
+  /**
+   * Populated only when `groupByVehicle` is requested; `results` is then empty and
+   * `totalCount` counts groups (collapse cardinality), not rows.
+   */
+  groups?: ProspectVehicleGroup[];
+};
+
 /************
  *
  * Kanban
  */
 
+/** A main-vehicle group inside a kanban column when `groupByVehicle` is on. */
+export type KanbanProspectGroup = ProspectVehicleGroup;
+
 export type ProspectsKanbanColumn = {
   status: string;
   results: SearchProspect[];
+  /** Populated only when `groupByVehicle` is requested; `results` is then empty. */
+  groups?: KanbanProspectGroup[];
   totalCount: number;
 };
 
@@ -155,6 +425,13 @@ export type MSearchProspectsKanbanColumn = {
 
 export type KanbanProspectsSearchRequest = BaseSearchRequest & {
   nextTokens?: Record<string, string | undefined>;
+  /** Collapse each column by the card's main vehicle (mirrors opportunities' group-by-client). */
+  groupByVehicle?: boolean;
+  /**
+   * Per-column sort overrides, keyed by prospect status. Unlisted columns keep their defaults:
+   * the nurture column sorts by the priority→tier "next" order, the rest newest-first.
+   */
+  statusSortBy?: Partial<Record<ProspectStatus, SortFilter[]>>;
 };
 
 export type KanbanProspectsNextList = Omit<

package/src/types/quotes.js

@@ -0,0 +1,42 @@
+export var QuoteActions;
+(function (QuoteActions) {
+    QuoteActions["ACCEPT"] = "accept";
+    QuoteActions["VALIDATE"] = "validate";
+    QuoteActions["DONWLOAD_PDFS"] = "download-pdfs";
+    QuoteActions["CANCEL"] = "cancel";
+})(QuoteActions || (QuoteActions = {}));
+export var QuoteStatus;
+(function (QuoteStatus) {
+    QuoteStatus["CREATED"] = "created";
+    QuoteStatus["VALIDATED"] = "validated";
+    QuoteStatus["INVALIDATED"] = "invalidated";
+    QuoteStatus["ACCEPTED"] = "accepted";
+    QuoteStatus["REJECTED"] = "rejected";
+    QuoteStatus["CANCELLED"] = "cancelled";
+    QuoteStatus["MANAGER_REJECTED"] = "managerRejected";
+    QuoteStatus["MANAGER_ACCEPTED"] = "managerAccepted";
+})(QuoteStatus || (QuoteStatus = {}));
+export var QuoteMetricsScore;
+(function (QuoteMetricsScore) {
+    QuoteMetricsScore["DANGER"] = "danger";
+    QuoteMetricsScore["NEUTRAL"] = "neutral";
+    QuoteMetricsScore["GOOD"] = "good";
+})(QuoteMetricsScore || (QuoteMetricsScore = {}));
+export var DeliveryTypes;
+(function (DeliveryTypes) {
+    DeliveryTypes["PICK_UP"] = "pickUp";
+    DeliveryTypes["ADDRESS"] = "address";
+    DeliveryTypes["PORT"] = "port";
+})(DeliveryTypes || (DeliveryTypes = {}));
+export var SpoilerInfo;
+(function (SpoilerInfo) {
+    SpoilerInfo["MOUNT"] = "mount";
+    SpoilerInfo["UNMOUNT"] = "unmount";
+    SpoilerInfo["NO_ACTION"] = "noAction";
+})(SpoilerInfo || (SpoilerInfo = {}));
+export var TransportationMode;
+(function (TransportationMode) {
+    TransportationMode["BY_ROAD"] = "byRoad";
+    TransportationMode["ON_LOW_BED"] = "onLowBed";
+})(TransportationMode || (TransportationMode = {}));
+//# sourceMappingURL=quotes.js.map

package/src/types/recently-viewed.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recently-viewed.js.map

package/src/types/recently-viewed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recently-viewed.js","sourceRoot":"","sources":["recently-viewed.ts"],"names":[],"mappings":""}

package/src/types/reports-leasing.ts

@@ -99,6 +99,13 @@ export type LeasingOverdueBucket = {
   amount: number;
 };
 
+export type LeasingInvoicedBucket = {
+  /** `YYYY-MM` month. */
+  month: string;
+  /** Net invoiced rent (invoices − credit notes, excl VAT) issued in that month. */
+  amount: number;
+};
+
 export type LeasingReportResponse = {
   period: {
     key: LeasingPeriodKey;
@@ -173,6 +180,8 @@ export type LeasingReportResponse = {
   cumulativeContracts: LeasingCumulativeBucket[];
   /** Fixed trailing-6-month overdue rent amount (excl VAT), as of each month-end. */
   overdueHistory: LeasingOverdueBucket[];
+  /** Net invoiced rent (excl VAT) by issue month, from a fixed start (Jan 2025) to now. */
+  invoicedHistory: LeasingInvoicedBucket[];
   /** Track-and-trace fleet usage over the window. */
   fleet: {
     /**