@bisondesk/core-sdk 1.0.368 → 1.0.370

package/lib/types/offers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.js","sourceRoot":"/","sources":["types/offers.ts"],"names":[],"mappings":"AASA,MAAM,CAAN,IAAY,YAcX;AAdD,WAAY,YAAY;IACtB,yCAAyB,CAAA;IACzB,2DAA2C,CAAA;IAC3C,6BAAa,CAAA;IACb,iCAAiB,CAAA;IACjB,+CAA+B,CAAA;IAC/B,6CAA6B,CAAA;IAC7B,6CAA6B,CAAA;IAC7B,6CAA6B,CAAA;IAC7B,uCAAuB,CAAA;IACvB,qDAAqC,CAAA;IACrC,yDAAyC,CAAA;IACzC,mEAAmD,CAAA;IACnD,6DAA6C,CAAA;AAC/C,CAAC,EAdW,YAAY,KAAZ,YAAY,QAcvB;AAED,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,0CAAuB,CAAA;IACvB,4CAAyB,CAAA;AAC3B,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,0CAA2B,CAAA;IAC3B,sCAAuB,CAAA;IACvB,0CAA2B,CAAA;AAC7B,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAED,MAAM,CAAN,IAAY,qBAMX;AAND,WAAY,qBAAqB;IAC/B,gDAAuB,CAAA;IACvB,+CAAsB,CAAA;IACtB,yDAAgC,CAAA;IAChC,kDAAyB,CAAA;IACzB,gDAAuB,CAAA;AACzB,CAAC,EANW,qBAAqB,KAArB,qBAAqB,QAMhC;AAED,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;AACvB,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AAED,MAAM,CAAN,IAAY,iBAEX;AAFD,WAAY,iBAAiB;IAC3B,gDAA2B,CAAA;AAC7B,CAAC,EAFW,iBAAiB,KAAjB,iBAAiB,QAE5B;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C,WAAW,CAAC,WAAW;IACvB,WAAW,CAAC,SAAS;IACrB,WAAW,CAAC,WAAW;CACxB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AAE1E,MAAM,CAAC,MAAM,qBAAqB,GAAa,CAAC,gBAAgB,CAAC,CAAC","sourcesContent":["import { DistributiveOmit, Document, NextList } from '@bisondesk/commons-sdk/types';\nimport { BusinessEntityIds, WarningHints } from '../constants.js';\nimport { Contact, Organization } from './crm.js';\nimport { Insights, InsightsComparableSpecs } from './insights.js';\nimport { ContactMetdata } from './opportunities.js';\nimport { BaseSearchRequest } from './search.js';\nimport { DataRecord, ReferenceData } from './utils.js';\nimport { VehicleExternalInfo } from './vehicles.js';\n\nexport enum OfferActions {\n  CREATE_BID = 'create_bid',\n  SET_FINAL_VALUATION = 'set_final_valuation',\n  LOSE = 'lose',\n  REOPEN = 'reopen',\n  SET_DOCUMENTS = 'set_documents',\n  SET_METADATA = 'set_metadata',\n  SEE_SUPPLIER = 'see_supplier',\n  SEE_INSIGHTS = 'see_insights',\n  VIEW_BIDS = 'view_bids',\n  SEE_ASKING_PRICE = 'see_asking_price',\n  ACCEPT_NEGOTIATION = 'accept_negotiation',\n  UNDO_ACCEPT_NEGOTIATION = 'undo_accept_negotiation',\n  SET_SUPPLIER_VEHICLE = 'set_supplier_vehicle',\n}\n\nexport enum OfferBidActions {\n  EDIT_BID = 'create_bid',\n  DELETE_BID = 'delete_bid',\n}\n\nexport enum OfferStatus {\n  PROSPECTION = 'prospection', // initial status\n  VALUATION = 'valuation', // has at least one internal or external bid with bid amount > 0\n  NEGOTIATION = 'negotiation', // there is a final valuation, purchaser is talking to the supplier\n}\n\nexport enum OfferLostReasonValues {\n  Expensive = 'expensive',\n  NoMarket = 'no_market',\n  BadExperience = 'bad_experience',\n  NoAnswer = 'supplier_mia',\n  Automatic = 'automatic',\n}\n\nexport enum OfferBidType {\n  INTERNAL = 'internal',\n  EXTERNAL = 'external',\n}\n\nexport enum OfferWarningsCode {\n  NO_SUPPLIER = 'no_supplier',\n}\n\nexport const OfferStatusOrder: OfferStatus[] = [\n  OfferStatus.PROSPECTION,\n  OfferStatus.VALUATION,\n  OfferStatus.NEGOTIATION,\n];\n\nexport const OfferWonColumnId = 'closed_won';\n\nexport const OfferKanbanColumns = [...OfferStatusOrder, OfferWonColumnId];\n\nexport const OfferKanbanEndColumns: string[] = [OfferWonColumnId];\n\ntype BaseOffer = {\n  branchId: string;\n  availableWeek?: string; // ISOWEEK, e.g. 2016-W02\n  askingPrice?: string;\n  currency?: string;\n  quantity: number;\n  specs: VehicleExternalInfo;\n  documents: Document[];\n  source?: string; // e.g., website, email, visit\n  contactId: string;\n  organizationId?: string;\n\n  supplierNotes?: string; // Optional notes from the supplier\n};\n\nexport type NewOffer = BaseOffer & {\n  id?: undefined;\n  createdAt?: undefined;\n  createdBy?: undefined;\n  modifiedAt?: undefined;\n  modifiedBy?: undefined;\n};\n\nexport type Offer = BaseOffer & {\n  id: string;\n  accountManager?: string; // optional since some offers might come directly from the internet\n  createdAt: string;\n  createdBy: string;\n  modifiedAt: string;\n  modifiedBy: string;\n  firstBidAt?: string;\n\n  lostReason?: OfferLostReasonValues;\n  status: OfferStatus;\n  quantity: number;\n\n  appPrice?: string;\n  appAvailability: boolean;\n\n  wonAt?: string;\n  wonBy?: string;\n  lostAt?: string;\n  lostBy?: string;\n\n  valuation?: { amount: string; valuationAt: string; valuationBy: string };\n\n  agreedAt?: string;\n  agreedBy?: string;\n};\n\nexport type OfferUpdate = {\n  accountManager?: string | null;\n  branchId?: string | null;\n  supplierNotes?: string | null;\n  contactId?: string | null;\n  organizationId?: string | null;\n  lost?: boolean;\n  lostReason?: OfferLostReasonValues;\n  source?: string;\n  askingPrice?: string;\n  currency?: string;\n  quantity?: number;\n  specs?: VehicleExternalInfo;\n  addNewBid?: boolean;\n  documents?: Document[];\n  appAvailability?: boolean;\n\n  finalValuation?: string;\n  agreed?: boolean;\n};\n\ntype OfferWarningActionLink = {\n  businessEntityId: BusinessEntityIds;\n  recordId: string;\n};\n\ntype OfferWarningActionData = { [key: string]: string | number };\n\nexport type OfferWarning = {\n  code: OfferWarningsCode;\n  level: WarningHints;\n  link?: OfferWarningActionLink;\n  data?: OfferWarningActionData;\n  showAction?: boolean;\n};\n\nexport type OfferMetadata = {\n  insights: {\n    online: Pick<Insights['online'], 'count' | 'percentilesDays' | 'percentilesPrices'>;\n    sold: Pick<Insights['sold'], 'count' | 'percentilesPrices' | 'percentilesDays'>;\n  };\n  stock: {\n    available: number;\n    leads: number;\n  };\n  comparable: InsightsComparableSpecs;\n  warnings: OfferWarning[];\n};\n\nexport type OfferBff = {\n  offer: DataRecord<Offer, OfferMetadata>;\n  bids: DataRecord<OfferBid>[];\n  customer?: {\n    contact: DataRecord<Contact>;\n    org?: DataRecord<Organization>;\n  };\n};\n\n/************\n *\n * Bids\n */\n\ntype BaseOfferBid = {\n  id: string;\n  createdAt: string;\n  createdBy: string;\n  modifiedAt: string;\n  modifiedBy: string;\n  offerId: string;\n  amount: string;\n  currency: string;\n  description?: string;\n  deleted: boolean;\n};\n\nexport type InternalOfferBid = BaseOfferBid & {\n  userId: string;\n  final?: boolean; // Optional flag to indicate if this is the final valuation\n  type: OfferBidType.INTERNAL;\n};\n\nexport type ExternalOfferBid = BaseOfferBid & {\n  contactId: string;\n  organizationId: string;\n  notes?: string;\n  type: OfferBidType.EXTERNAL;\n};\n\nexport type OfferBid = InternalOfferBid | ExternalOfferBid;\n\nexport type NewOfferBid = DistributiveOmit<\n  OfferBid,\n  'id' | 'createdAt' | 'createdBy' | 'modifiedAt' | 'modifiedBy' | 'deleted'\n>;\n\nexport type InternalOfferBidUpdate = {\n  amount?: string | null;\n  currency?: string | null;\n  description?: string | null;\n};\n\n/************\n *\n * Search\n */\n\nexport type SearchOffer = {\n  contact?: Contact;\n  offer: Offer;\n  org?: Organization;\n  custom: {\n    lost: boolean;\n    status: OfferStatus | 'won';\n    totalBids: number;\n  };\n};\n\nexport type AppOffer = {\n  id: string;\n  branchId: string;\n  createdAt: string;\n  unavailableAt?: string;\n\n  availableWeek?: string;\n  appPrice?: string;\n  currency?: string;\n  quantity: number;\n\n  specs: VehicleExternalInfo;\n};\n\n/************\n *\n * Kanban\n */\n\nexport type OffersKanbanColumn = {\n  status: string;\n  results: SearchOffer[];\n  totalCount: number;\n  totalValue: string;\n};\n\nexport type MSearchOffersKanbanColumn = {\n  column: OffersKanbanColumn;\n  nextToken?: string;\n};\n\nexport type KanbanOffersSearchRequest = BaseSearchRequest & {\n  nextTokens?: Record<string, string | undefined>;\n};\n\nexport type KanbanOffersNextList = Omit<\n  NextList<OffersKanbanColumn, ReferenceData>,\n  'nextToken'\n> & {\n  nextTokens?: Record<string, string | undefined>;\n};\n"]}

package/lib/utils/offers.d.ts

@@ -0,0 +1,11 @@
+import { OfferStatus } from '../types/offers.js';
+type CompareInput = {
+    currentStatus: OfferStatus;
+    referenceStatus: OfferStatus;
+};
+export declare const isSameOrAfterReferenceOfferStatus: (input: CompareInput) => boolean;
+export declare const isAfterReferenceOfferStatus: (input: CompareInput) => boolean;
+export declare const isSameOrBeforeReferenceOfferStatus: (input: CompareInput) => boolean;
+export declare const isBeforeReferenceOfferStatus: (input: CompareInput) => boolean;
+export {};
+//# sourceMappingURL=offers.d.ts.map

package/lib/utils/offers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.d.ts","sourceRoot":"/","sources":["utils/offers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,oBAAoB,CAAC;AAEnE,KAAK,YAAY,GAAG;IAClB,aAAa,EAAE,WAAW,CAAC;IAC3B,eAAe,EAAE,WAAW,CAAC;CAC9B,CAAC;AAcF,eAAO,MAAM,iCAAiC,UAAW,YAAY,KAAG,OAIvE,CAAC;AAEF,eAAO,MAAM,2BAA2B,UAAW,YAAY,KAAG,OAIjE,CAAC;AAEF,eAAO,MAAM,kCAAkC,UAAW,YAAY,KAAG,OAIxE,CAAC;AAEF,eAAO,MAAM,4BAA4B,UAAW,YAAY,KAAG,OAIlE,CAAC"}

package/lib/utils/offers.js

@@ -0,0 +1,27 @@
+import { OfferStatusOrder } from '../types/offers.js';
+const compareOfferStatus = (input) => {
+    const { currentStatus, referenceStatus } = input;
+    const currentStatusIdx = OfferStatusOrder.indexOf(currentStatus);
+    const referenceStatusIdx = OfferStatusOrder.indexOf(referenceStatus);
+    return {
+        currentStatusIdx,
+        referenceStatusIdx,
+    };
+};
+export const isSameOrAfterReferenceOfferStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);
+    return currentStatusIdx >= referenceStatusIdx;
+};
+export const isAfterReferenceOfferStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);
+    return currentStatusIdx > referenceStatusIdx;
+};
+export const isSameOrBeforeReferenceOfferStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);
+    return currentStatusIdx <= referenceStatusIdx;
+};
+export const isBeforeReferenceOfferStatus = (input) => {
+    const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);
+    return currentStatusIdx < referenceStatusIdx;
+};
+//# sourceMappingURL=offers.js.map

package/lib/utils/offers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.js","sourceRoot":"/","sources":["utils/offers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAOnE,MAAM,kBAAkB,GAAG,CAAC,KAAmB,EAAE,EAAE;IACjD,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC;IAEjD,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAErE,OAAO;QACL,gBAAgB;QAChB,kBAAkB;KACnB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,KAAmB,EAAW,EAAE;IAChF,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAE3E,OAAO,gBAAgB,IAAI,kBAAkB,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,KAAmB,EAAW,EAAE;IAC1E,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAE3E,OAAO,gBAAgB,GAAG,kBAAkB,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,KAAmB,EAAW,EAAE;IACjF,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAE3E,OAAO,gBAAgB,IAAI,kBAAkB,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,KAAmB,EAAW,EAAE;IAC3E,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAE3E,OAAO,gBAAgB,GAAG,kBAAkB,CAAC;AAC/C,CAAC,CAAC","sourcesContent":["import { OfferStatus, OfferStatusOrder } from '../types/offers.js';\n\ntype CompareInput = {\n  currentStatus: OfferStatus;\n  referenceStatus: OfferStatus;\n};\n\nconst compareOfferStatus = (input: CompareInput) => {\n  const { currentStatus, referenceStatus } = input;\n\n  const currentStatusIdx = OfferStatusOrder.indexOf(currentStatus);\n  const referenceStatusIdx = OfferStatusOrder.indexOf(referenceStatus);\n\n  return {\n    currentStatusIdx,\n    referenceStatusIdx,\n  };\n};\n\nexport const isSameOrAfterReferenceOfferStatus = (input: CompareInput): boolean => {\n  const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);\n\n  return currentStatusIdx >= referenceStatusIdx;\n};\n\nexport const isAfterReferenceOfferStatus = (input: CompareInput): boolean => {\n  const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);\n\n  return currentStatusIdx > referenceStatusIdx;\n};\n\nexport const isSameOrBeforeReferenceOfferStatus = (input: CompareInput): boolean => {\n  const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);\n\n  return currentStatusIdx <= referenceStatusIdx;\n};\n\nexport const isBeforeReferenceOfferStatus = (input: CompareInput): boolean => {\n  const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);\n\n  return currentStatusIdx < referenceStatusIdx;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bisondesk/core-sdk",
-  "version": "1.0.368",
+  "version": "1.0.370",
   "description": "",
   "type": "module",
   "scripts": {

package/src/constants.ts

@@ -14,6 +14,8 @@ export const VEHICLE_STATE_FILTERS_PICKLIST_ID = 'vehicleStateFilters';
 export const VEHICLE_SALE_DEAL_STATUS_PICKLIST_ID = 'vehicleSaleDealStatus';
 export const VEHICLE_ROLES_PICKLIST_ID = 'vehicleRoles';
 export const MARKETING_PLATFORMS_PICKLIST_ID = 'marketingPlatforms';
+export const OFFER_STATUS_PICKLIST_ID = 'offerStatus';
+export const OFFER_SOURCE_PICKLIST_ID = 'offerSource';
 export const OPPORTUNITY_STATUS_PICKLIST_ID = 'opportunityStatus';
 export const OPPORTUNITY_DEAL_STATUS_PICKLIST_ID = 'opportunityDealStatus';
 export const OPPORTUNITY_PAYMENT_STATUS_PICKLIST_ID = 'opportunityPaymentStatus';

package/src/types/crm.ts

@@ -7,6 +7,14 @@ import {
 import { PublicSearchDefinition } from './definitions.js';
 import { ReferenceData } from './utils.js';
 
+export enum OrganizatioRiskTags {
+  BAD_FINANCIAL_INFO = 'BAD_FINANCIAL_INFO',
+  VAT_NUMBER_INVALID = 'VAT_NUMBER_INVALID',
+  INSTINCT = 'INSTINCT',
+  NEW_CUSTOMER = 'NEW_CUSTOMER',
+  BANK_ACCOUNT_BLOCKED = 'BANK_ACCOUNT_BLOCKED',
+}
+
 export type CrmEvent = CrmOrganizationEvent | CrmContactEvent;
 
 export type CrmContactEvent = {

package/src/types/insights.ts

@@ -8,6 +8,7 @@ export type SimilarVehiclesRequest = {
 
 export type InsightsSimilarRequest = {
   comparable: InsightsComparableSpecs;
+  excludeVehicleIds?: string[];
   limit: number;
   nextToken?: string;
 };
@@ -23,9 +24,7 @@ export type InsightsVehicleComparableResponse = {
 };
 
 // here we are considering only specs that we can use to filter Market vehicles
-export interface InsightsComparableSpecs extends ComparableSpecs {
-  vehicleId: string;
-}
+export interface InsightsComparableSpecs extends ComparableSpecs {}
 
 export type InsightsOptions = {
   months?: number;

package/src/types/offers.ts

@@ -0,0 +1,274 @@
+import { DistributiveOmit, Document, NextList } from '@bisondesk/commons-sdk/types';
+import { BusinessEntityIds, WarningHints } from '../constants.js';
+import { Contact, Organization } from './crm.js';
+import { Insights, InsightsComparableSpecs } from './insights.js';
+import { ContactMetdata } from './opportunities.js';
+import { BaseSearchRequest } from './search.js';
+import { DataRecord, ReferenceData } from './utils.js';
+import { VehicleExternalInfo } from './vehicles.js';
+
+export enum OfferActions {
+  CREATE_BID = 'create_bid',
+  SET_FINAL_VALUATION = 'set_final_valuation',
+  LOSE = 'lose',
+  REOPEN = 'reopen',
+  SET_DOCUMENTS = 'set_documents',
+  SET_METADATA = 'set_metadata',
+  SEE_SUPPLIER = 'see_supplier',
+  SEE_INSIGHTS = 'see_insights',
+  VIEW_BIDS = 'view_bids',
+  SEE_ASKING_PRICE = 'see_asking_price',
+  ACCEPT_NEGOTIATION = 'accept_negotiation',
+  UNDO_ACCEPT_NEGOTIATION = 'undo_accept_negotiation',
+  SET_SUPPLIER_VEHICLE = 'set_supplier_vehicle',
+}
+
+export enum OfferBidActions {
+  EDIT_BID = 'create_bid',
+  DELETE_BID = 'delete_bid',
+}
+
+export enum OfferStatus {
+  PROSPECTION = 'prospection', // initial status
+  VALUATION = 'valuation', // has at least one internal or external bid with bid amount > 0
+  NEGOTIATION = 'negotiation', // there is a final valuation, purchaser is talking to the supplier
+}
+
+export enum OfferLostReasonValues {
+  Expensive = 'expensive',
+  NoMarket = 'no_market',
+  BadExperience = 'bad_experience',
+  NoAnswer = 'supplier_mia',
+  Automatic = 'automatic',
+}
+
+export enum OfferBidType {
+  INTERNAL = 'internal',
+  EXTERNAL = 'external',
+}
+
+export enum OfferWarningsCode {
+  NO_SUPPLIER = 'no_supplier',
+}
+
+export const OfferStatusOrder: OfferStatus[] = [
+  OfferStatus.PROSPECTION,
+  OfferStatus.VALUATION,
+  OfferStatus.NEGOTIATION,
+];
+
+export const OfferWonColumnId = 'closed_won';
+
+export const OfferKanbanColumns = [...OfferStatusOrder, OfferWonColumnId];
+
+export const OfferKanbanEndColumns: string[] = [OfferWonColumnId];
+
+type BaseOffer = {
+  branchId: string;
+  availableWeek?: string; // ISOWEEK, e.g. 2016-W02
+  askingPrice?: string;
+  currency?: string;
+  quantity: number;
+  specs: VehicleExternalInfo;
+  documents: Document[];
+  source?: string; // e.g., website, email, visit
+  contactId: string;
+  organizationId?: string;
+
+  supplierNotes?: string; // Optional notes from the supplier
+};
+
+export type NewOffer = BaseOffer & {
+  id?: undefined;
+  createdAt?: undefined;
+  createdBy?: undefined;
+  modifiedAt?: undefined;
+  modifiedBy?: undefined;
+};
+
+export type Offer = BaseOffer & {
+  id: string;
+  accountManager?: string; // optional since some offers might come directly from the internet
+  createdAt: string;
+  createdBy: string;
+  modifiedAt: string;
+  modifiedBy: string;
+  firstBidAt?: string;
+
+  lostReason?: OfferLostReasonValues;
+  status: OfferStatus;
+  quantity: number;
+
+  appPrice?: string;
+  appAvailability: boolean;
+
+  wonAt?: string;
+  wonBy?: string;
+  lostAt?: string;
+  lostBy?: string;
+
+  valuation?: { amount: string; valuationAt: string; valuationBy: string };
+
+  agreedAt?: string;
+  agreedBy?: string;
+};
+
+export type OfferUpdate = {
+  accountManager?: string | null;
+  branchId?: string | null;
+  supplierNotes?: string | null;
+  contactId?: string | null;
+  organizationId?: string | null;
+  lost?: boolean;
+  lostReason?: OfferLostReasonValues;
+  source?: string;
+  askingPrice?: string;
+  currency?: string;
+  quantity?: number;
+  specs?: VehicleExternalInfo;
+  addNewBid?: boolean;
+  documents?: Document[];
+  appAvailability?: boolean;
+
+  finalValuation?: string;
+  agreed?: boolean;
+};
+
+type OfferWarningActionLink = {
+  businessEntityId: BusinessEntityIds;
+  recordId: string;
+};
+
+type OfferWarningActionData = { [key: string]: string | number };
+
+export type OfferWarning = {
+  code: OfferWarningsCode;
+  level: WarningHints;
+  link?: OfferWarningActionLink;
+  data?: OfferWarningActionData;
+  showAction?: boolean;
+};
+
+export type OfferMetadata = {
+  insights: {
+    online: Pick<Insights['online'], 'count' | 'percentilesDays' | 'percentilesPrices'>;
+    sold: Pick<Insights['sold'], 'count' | 'percentilesPrices' | 'percentilesDays'>;
+  };
+  stock: {
+    available: number;
+    leads: number;
+  };
+  comparable: InsightsComparableSpecs;
+  warnings: OfferWarning[];
+};
+
+export type OfferBff = {
+  offer: DataRecord<Offer, OfferMetadata>;
+  bids: DataRecord<OfferBid>[];
+  customer?: {
+    contact: DataRecord<Contact>;
+    org?: DataRecord<Organization>;
+  };
+};
+
+/************
+ *
+ * Bids
+ */
+
+type BaseOfferBid = {
+  id: string;
+  createdAt: string;
+  createdBy: string;
+  modifiedAt: string;
+  modifiedBy: string;
+  offerId: string;
+  amount: string;
+  currency: string;
+  description?: string;
+  deleted: boolean;
+};
+
+export type InternalOfferBid = BaseOfferBid & {
+  userId: string;
+  final?: boolean; // Optional flag to indicate if this is the final valuation
+  type: OfferBidType.INTERNAL;
+};
+
+export type ExternalOfferBid = BaseOfferBid & {
+  contactId: string;
+  organizationId: string;
+  notes?: string;
+  type: OfferBidType.EXTERNAL;
+};
+
+export type OfferBid = InternalOfferBid | ExternalOfferBid;
+
+export type NewOfferBid = DistributiveOmit<
+  OfferBid,
+  'id' | 'createdAt' | 'createdBy' | 'modifiedAt' | 'modifiedBy' | 'deleted'
+>;
+
+export type InternalOfferBidUpdate = {
+  amount?: string | null;
+  currency?: string | null;
+  description?: string | null;
+};
+
+/************
+ *
+ * Search
+ */
+
+export type SearchOffer = {
+  contact?: Contact;
+  offer: Offer;
+  org?: Organization;
+  custom: {
+    lost: boolean;
+    status: OfferStatus | 'won';
+    totalBids: number;
+  };
+};
+
+export type AppOffer = {
+  id: string;
+  branchId: string;
+  createdAt: string;
+  unavailableAt?: string;
+
+  availableWeek?: string;
+  appPrice?: string;
+  currency?: string;
+  quantity: number;
+
+  specs: VehicleExternalInfo;
+};
+
+/************
+ *
+ * Kanban
+ */
+
+export type OffersKanbanColumn = {
+  status: string;
+  results: SearchOffer[];
+  totalCount: number;
+  totalValue: string;
+};
+
+export type MSearchOffersKanbanColumn = {
+  column: OffersKanbanColumn;
+  nextToken?: string;
+};
+
+export type KanbanOffersSearchRequest = BaseSearchRequest & {
+  nextTokens?: Record<string, string | undefined>;
+};
+
+export type KanbanOffersNextList = Omit<
+  NextList<OffersKanbanColumn, ReferenceData>,
+  'nextToken'
+> & {
+  nextTokens?: Record<string, string | undefined>;
+};

package/src/utils/offers.ts

@@ -0,0 +1,42 @@
+import { OfferStatus, OfferStatusOrder } from '../types/offers.js';
+
+type CompareInput = {
+  currentStatus: OfferStatus;
+  referenceStatus: OfferStatus;
+};
+
+const compareOfferStatus = (input: CompareInput) => {
+  const { currentStatus, referenceStatus } = input;
+
+  const currentStatusIdx = OfferStatusOrder.indexOf(currentStatus);
+  const referenceStatusIdx = OfferStatusOrder.indexOf(referenceStatus);
+
+  return {
+    currentStatusIdx,
+    referenceStatusIdx,
+  };
+};
+
+export const isSameOrAfterReferenceOfferStatus = (input: CompareInput): boolean => {
+  const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);
+
+  return currentStatusIdx >= referenceStatusIdx;
+};
+
+export const isAfterReferenceOfferStatus = (input: CompareInput): boolean => {
+  const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);
+
+  return currentStatusIdx > referenceStatusIdx;
+};
+
+export const isSameOrBeforeReferenceOfferStatus = (input: CompareInput): boolean => {
+  const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);
+
+  return currentStatusIdx <= referenceStatusIdx;
+};
+
+export const isBeforeReferenceOfferStatus = (input: CompareInput): boolean => {
+  const { currentStatusIdx, referenceStatusIdx } = compareOfferStatus(input);
+
+  return currentStatusIdx < referenceStatusIdx;
+};