@bisondesk/core-sdk 1.0.318 → 1.0.320

package/src/apis/vehicles.ts

@@ -2,8 +2,8 @@ import { SERVICE_ID_ADMIN_HEADER, TENANT_ID_ADMIN_HEADER } from '@bisondesk/comm
 import { XError } from '@bisondesk/commons-sdk/errors';
 import { cleanHeaders, fetchJson, getAdminAuth } from '@bisondesk/commons-sdk/fetch';
 import fetch, { Response } from 'node-fetch';
-import { DataRecord } from '../types/utils';
-import { NewVehicle, Vehicle, VehicleMarketing, VehiclePurchase } from '../types/vehicles';
+import { DataRecord } from '../types/utils.js';
+import { NewVehicle, Vehicle, VehicleMarketing, VehiclePurchase } from '../types/vehicles.js';
 
 export const getVehicle = async (
   tenantId: string,
@@ -21,7 +21,7 @@ export const getVehicle = async (
   );
 
   if (response.ok) {
-    return response.status === 200 ? response.json() : undefined;
+    return response.status === 200 ? (response.json() as any) : undefined;
   }
 
   const body = await response.text();
@@ -57,7 +57,7 @@ export const getVehiclePurchase = async (
   );
 
   if (response.ok) {
-    return response.status === 200 ? response.json() : undefined;
+    return response.status === 200 ? (response.json() as any) : undefined;
   }
 
   const body = await response.text();
@@ -80,7 +80,7 @@ export const getVehicleByStockNumber = async (
   );
 
   if (response.ok) {
-    return response.status === 200 ? response.json() : undefined;
+    return response.status === 200 ? (response.json() as any) : undefined;
   }
 
   const body = await response.text();
@@ -103,7 +103,7 @@ export const getVehicleByPurchaseStockNumber = async (
   );
 
   if (response.ok) {
-    return response.status === 200 ? response.json() : undefined;
+    return response.status === 200 ? (response.json() as any) : undefined;
   }
 
   const body = await response.text();
@@ -129,7 +129,7 @@ export const listVehiclesMarketing = async (
   );
 
   if (response.ok) {
-    return response.status === 200 ? response.json() : undefined;
+    return response.status === 200 ? (response.json() as any) : undefined;
   }
 
   const body = await response.text();
@@ -152,7 +152,7 @@ export const getVehicleMarketing = async (
   );
 
   if (response.ok) {
-    return response.status === 200 ? response.json() : undefined;
+    return response.status === 200 ? (response.json() as any) : undefined;
   }
 
   const body = await response.text();
@@ -180,7 +180,7 @@ export const saveMarketing = async (
   );
 
   if (response.ok) {
-    return response.json();
+    return response.json() as any;
   }
   const body = await response.text();
   throw new XError(response.statusText, { body, tenantId, vehicleId, marketing });
@@ -208,7 +208,7 @@ export const saveVehiclePurchase = async (
   );
 
   if (response.ok) {
-    return response.json();
+    return response.json() as any;
   }
   const body = await response.text();
   throw new XError(response.statusText, { body, tenantId, vehicleId, purchase, opts });
@@ -232,7 +232,7 @@ export const saveVehicle = async (
   });
 
   if (response.ok) {
-    return response.json();
+    return response.json() as any;
   }
   const body = await response.text();
   throw new XError(response.statusText, { body, tenantId, vehicle, opts });

package/src/constants.ts

@@ -1,4 +1,4 @@
-import { VehicleAxle } from './types/vehicles';
+import { VehicleAxle } from './types/vehicles.js';
 
 export { BusinessEntityIds } from '@bisondesk/commons-sdk/constants';
 
@@ -34,6 +34,8 @@ export const SHIPPING_COMPANIES_PICKLIST_ID = 'shippingCompanies';
 export const SLB_PARTNERS_PICKLIST_ID = 'slb_partners';
 export const PURCHASE_LOGISTICS_STATUS_PICKLIST_ID = 'purchaseLogisticsStatus';
 export const QUOTE_STATUS_PICKLIST_ID = 'quoteStatus';
+export const DOCUMENT_CATEGORIES_PICKLIST_ID = 'documentCategories';
+export const DOCUMENT_LINE_CATEGORIES_PICKLIST_ID = 'documentLineCategories';
 
 export const PICKLIST_FALLBACK_LOCALE = 'en';
 

package/src/types/crm.ts

@@ -5,9 +5,9 @@ import {
   PhoneNumberValue,
   SearchPermissions,
 } from '@bisondesk/commons-sdk/types';
-import { PublicSearchDefinition } from './definitions';
-import { LeasingContract } from './leasing';
-import { ReferenceData } from './utils';
+import { PublicSearchDefinition } from './definitions.js';
+import { LeasingContract } from './leasing.js';
+import { ReferenceData } from './utils.js';
 
 export type CrmEvent = CrmOrganizationEvent | CrmContactEvent;
 
@@ -41,11 +41,14 @@ type BaseOrganization = {
     transport?: LocationValue;
   };
   accountManagers: string[];
+  conglomerate?: boolean;
+  riskTags?: string[];
+
+  // billing
   billingEmails?: string[];
+  billingPhone?: string;
   skipPaymentReminders?: boolean;
   trustworthy?: boolean;
-  conglomerate?: boolean;
-  riskTags?: string[];
 };
 
 export type NewOrganization = BaseOrganization & {

package/src/types/definitions.ts

@@ -1,6 +1,6 @@
 import { SUPPORTED_LANGUAGES } from '@bisondesk/commons-sdk/constants';
-import { FieldTypeInfo } from './fields';
-import { Aggregation } from './search';
+import { FieldTypeInfo } from './fields.js';
+import { Aggregation } from './search.js';
 
 //
 // These definitions are sent to the UI

package/src/types/delivery-settings.ts

@@ -1,7 +1,7 @@
 import { LocationValue } from '@bisondesk/commons-sdk/types';
-import { Categories } from '../constants';
+import { Categories } from '../constants.js';
 
-export const enum TransitPlateCountries {
+export enum TransitPlateCountries {
   BE = 'be',
   AT = 'at',
 }

package/src/types/insights.ts

@@ -1,5 +1,5 @@
-import { ComparableSpecs } from './comparables';
-import { ReferenceData } from './utils';
+import { ComparableSpecs } from './comparables.js';
+import { ReferenceData } from './utils.js';
 
 export type SimilarVehiclesRequest = {
   offset: number;

package/src/types/interests.ts

@@ -1,5 +1,5 @@
-import { ComparableSpecs } from './comparables';
-import { ReferenceData } from './utils';
+import { ComparableSpecs } from './comparables.js';
+import { ReferenceData } from './utils.js';
 
 export enum InterestActions {
   SET_INTEREST = 'set_interest',

package/src/types/internet-opportunities.ts

@@ -1,5 +1,5 @@
 import { PhoneNumberValue } from '@bisondesk/commons-sdk/types';
-import { OpportunityType } from '../constants';
+import { OpportunityType } from '../constants.js';
 
 type BaseInternetOpportunity = {
   // ids
@@ -20,16 +20,19 @@ type BaseInternetOpportunity = {
   lastName?: string;
   message?: string;
   name: string;
-  platformEmail?: string;
   source: string;
   stockNumber?: string;
   type?: OpportunityType;
+  vehicleBid?: string;
 };
 
 export type InternetOpportunityEvent = BaseInternetOpportunity & {
   phoneNumber?: string;
+  replyToEmail?: string;
+  fromEmail?: string;
 };
 
 export type InternetOpportunity = BaseInternetOpportunity & {
+  platformEmail?: string;
   phoneNumber?: PhoneNumberValue;
 };

package/src/types/internet-vehicles.ts

@@ -1,7 +1,7 @@
 import { LocationValue, PhoneNumberValue } from '@bisondesk/commons-sdk/types';
-import { PublicSearchDefinition } from './definitions';
-import { AggregationRequest } from './search';
-import { Vehicle } from './vehicles';
+import { PublicSearchDefinition } from './definitions.js';
+import { AggregationRequest } from './search.js';
+import { Vehicle } from './vehicles.js';
 
 export type InternetVehicleInternalInfo = {
   createdAt: string;

package/src/types/leasing-administration.ts

@@ -1,5 +1,5 @@
 import { AttachmentValue } from '@bisondesk/commons-sdk/types';
-import { LeasingAdminUploadHandlers } from '../constants';
+import { LeasingAdminUploadHandlers } from '../constants.js';
 
 export type LeasingAdminUploadStatus = 'success' | 'processing' | 'error';
 
@@ -70,7 +70,8 @@ export type INGMetadata = {
   interest: string;
   invoiceDate: string;
   invoiceNumber: string;
-  pdfUrl: string;
+  pdfUrl: string; // data url
+  pdfFilename?: string;
   stockNumber: string;
   yearlyFee?: string;
 };

package/src/types/leasing-debtors.ts

@@ -1,4 +1,4 @@
-import { Contact, Organization } from './crm';
+import { Contact, Organization } from './crm.js';
 
 export type MonthData = {
   activeContractIds: string[];

package/src/types/leasing-search.ts

@@ -1,9 +1,9 @@
 import { InsuranceEntry } from '@bisondesk/commons-sdk/insurance';
 import { SearchPermissions } from '@bisondesk/commons-sdk/types';
-import { Contact, Organization } from './crm';
-import { PublicSearchDefinition } from './definitions';
-import { LeasingContract } from './leasing';
-import { Vehicle } from './vehicles';
+import { Contact, Organization } from './crm.js';
+import { PublicSearchDefinition } from './definitions.js';
+import { LeasingContract } from './leasing.js';
+import { Vehicle } from './vehicles.js';
 
 export type LeasingPublicSearchDefinitions = {
   searchLeasingContract: PublicSearchDefinition;

package/src/types/leasing-settings.ts

@@ -1,6 +1,6 @@
 import { MultiLangValue } from '@bisondesk/commons-sdk/types';
-import { Categories, OpportunityType } from '../constants';
-import { SortFilter } from './search';
+import { Categories, OpportunityType } from '../constants.js';
+import { SortFilter } from './search.js';
 
 type BaseQuoteExtraSettings = {
   referenceCode: string;

package/src/types/leasing.ts

@@ -1,7 +1,7 @@
 import { EmailMessage } from '@bisondesk/commons-sdk/messages';
 import { AttachmentValue, Document, LinkValue, PaginatedList } from '@bisondesk/commons-sdk/types';
-import { SortFilter } from './search';
-import { ReferenceData } from './utils';
+import { SortFilter } from './search.js';
+import { ReferenceData } from './utils.js';
 
 export enum LeasingContractActions {
   CREATE_FINANCE_DOCUMENT = 'create_finance_document',
@@ -392,3 +392,19 @@ export enum LEASING_EXPORT_TYPES {
   RENTAL_SOLUTIONS = 'rental-solutions',
   DEFAULT = 'default',
 }
+
+export type NewExistingLeasingFinanceDocument = {
+  id?: undefined;
+  type: 'Sale Finance';
+  subtype: 'Invoice' | 'Credit Note';
+  issueDate: string;
+  contractId: string;
+  amount: string;
+  paidAt?: string;
+  dueDate?: string;
+  attachment: AttachmentValue;
+  invoiceNumber: string;
+  vatPercentage: string;
+  period: string;
+  description: string;
+};

package/src/types/opportunities.ts

@@ -1,13 +1,13 @@
 import { Document, NextList } from '@bisondesk/commons-sdk/types';
-import { BusinessEntityIds, OpportunityType, WarningHints } from '../constants';
-import { Contact, Organization } from './crm';
-import type { InterestBffMeta, OpportunityInterest } from './interests';
-import { Payment } from './payments';
-import { Quote, QuoteStatus } from './quotes';
-import { OpportunityReservation } from './reservations';
-import { BaseSearchRequest } from './search';
-import { DataRecord, ReferenceData } from './utils';
-import { Vehicle } from './vehicles';
+import { BusinessEntityIds, OpportunityType, WarningHints } from '../constants.js';
+import { Contact, Organization } from './crm.js';
+import type { InterestBffMeta, OpportunityInterest } from './interests.js';
+import { Payment } from './payments.js';
+import { Quote, QuoteStatus } from './quotes.js';
+import { OpportunityReservation } from './reservations.js';
+import { BaseSearchRequest } from './search.js';
+import { DataRecord, ReferenceData } from './utils.js';
+import { Vehicle } from './vehicles.js';
 
 export enum OpportunityActions {
   ADD_COMMISSION = 'add_commission',
@@ -228,6 +228,10 @@ export type OpportunityBffMeta = ReferenceData & {
   warnings: OpportunityWarning[];
 };
 
+export type ContactMetdata = {
+  openOpportunities: number;
+};
+
 export type OpportunityBFF = {
   opportunity: DataRecord<Opportunity, OpportunityBffMeta>;
   vehicle?: DataRecord<Vehicle, VehicleBffMetadata>;
@@ -238,7 +242,7 @@ export type OpportunityBFF = {
   payments: PaymentSummary | undefined;
   reservation?: DataRecord<OpportunityReservation>;
   customer?: {
-    contact: DataRecord<Contact>;
+    contact: DataRecord<Contact, ContactMetdata>;
     org?: DataRecord<Organization>;
   };
 };

package/src/types/picklists.ts

@@ -3,6 +3,7 @@ import { MultiLangValue } from '@bisondesk/commons-sdk/types';
 export type PicklistValueUpdateRequest = {
   picklistId: string;
   value: PicklistValue | NewPicklistValue;
+  tenantId?: string;
 };
 
 export type NewPicklistValue<T = Record<string, string>> = {
@@ -57,6 +58,12 @@ export type PicklistOptionsRequest = {
   lang: string;
 };
 
+export type PicklistUpsertValueRequest = {
+  tenantId?: string;
+  picklistId: string;
+  value: PicklistValue | NewPicklistValue;
+};
+
 export type QuickAddPicklistValue = {
   sortPriority?: number;
   titles: MultiLangValue;

package/src/types/quote-settings.ts

@@ -1,4 +1,4 @@
-import { DeliveryParams } from './delivery-settings';
+import { DeliveryParams } from './delivery-settings.js';
 
 export type UsedVehiclesSalesParams = BaseQuoteSettings & {
   modifiedBy: string;

package/src/types/quotes.ts

@@ -1,14 +1,14 @@
 import { AttachmentValue, LocationValue } from '@bisondesk/commons-sdk/types';
-import { OpportunityType } from '../constants';
+import { OpportunityType } from '../constants.js';
 import {
   CustomLeasingQuoteExtraInput,
   CustomSalesQuoteExtraInput,
   LeasingDeliveryPackageInput,
   LeasingQuoteExtraInput,
   SalesQuoteExtraInput,
-} from './leasing-settings';
-import { MatchingRuleValue } from './roi-ratings';
-import { PricePercentageMode } from './utils';
+} from './leasing-settings.js';
+import { MatchingRuleValue } from './roi-ratings.js';
+import { PricePercentageMode } from './utils.js';
 
 export enum QuoteActions {
   ACCEPT = 'accept',

package/src/types/recently-viewed.ts

@@ -1,5 +1,5 @@
 import { AttachmentValue, Requester } from '@bisondesk/commons-sdk/types';
-import { BusinessEntityIds } from '../constants';
+import { BusinessEntityIds } from '../constants.js';
 
 export type ViewedItemsRequest = {
   businessEntity?: string;

package/src/types/roi-ratings.ts

@@ -1,6 +1,6 @@
-import { AdditionalOperation, RulesLogic } from 'json-logic-js';
-import { OpportunityType } from '../constants';
-import { FieldTypeInfo } from './fields';
+import type { AdditionalOperation, RulesLogic } from 'json-logic-js';
+import { OpportunityType } from '../constants.js';
+import { FieldTypeInfo } from './fields.js';
 
 export enum DisplayType {
   StarsRating = 'stars-rating',

package/src/types/saved-filters.ts

@@ -1,5 +1,5 @@
-import { BusinessEntityIds } from '../constants';
-import { ComplexFilter } from './search';
+import { BusinessEntityIds } from '../constants.js';
+import { ComplexFilter } from './search.js';
 
 type SavedFilterQuery = {
   conditions: {

package/src/types/search.ts

@@ -2,9 +2,9 @@
 // Generic stuff
 ///////////////////////////////////////////////////////
 
-import { SUPPORTED_LANGUAGES } from '@bisondesk/commons-sdk/constants';
+import { BusinessEntityIds, SUPPORTED_LANGUAGES } from '@bisondesk/commons-sdk/constants';
 import { MultiLangValue } from '@bisondesk/commons-sdk/types';
-import { FieldTypes, NumberMeta } from './fields';
+import { FieldTypes, NumberMeta } from './fields.js';
 
 export enum ConditionType {
   and = 'AND',
@@ -110,6 +110,28 @@ export type SearchRequest = {
   sortBy?: SortFilter[];
 } & (InfiniteSearchRequest | PaginatedSearchRequest);
 
+export type GlobalSearchRequest = {
+  fullText: string;
+  limit: number;
+} & {
+  entityIds: BusinessEntityIds[];
+} & (InfiniteSearchRequest | PaginatedSearchRequest);
+
+export type GlobalSearchResult = {
+  businessEntityId: BusinessEntityIds;
+  recordId: string;
+  title: string;
+  description: string;
+  tags?: string[];
+};
+
+export type GlobalSearchByIdRequest = {
+  ids: {
+    businessEntityId: BusinessEntityIds;
+    recordId: string;
+  }[];
+};
+
 export type PublicSearchRequest = {
   limit: number;
   offset?: number;

package/src/types/tenants.ts

@@ -1,5 +1,5 @@
 import { LocationValue, Region } from '@bisondesk/commons-sdk/types';
-import { OpportunityType } from '../constants';
+import { OpportunityType } from '../constants.js';
 
 export type PublicTenant = {
   defaultCountry: string;
@@ -52,6 +52,7 @@ export type Branch = {
   currency: string;
   adminNumberPrefix: string;
   stockNumberPrefix: string;
+  vatNumber?: string;
   vatRates: {
     standard: string; //percentage value (e.g. 21)
   };

package/src/types/utils.ts

@@ -1,5 +1,5 @@
 import { MultiLangValue } from '@bisondesk/commons-sdk/types';
-import { AdHocPicklistValueDisplay } from './picklists';
+import { AdHocPicklistValueDisplay } from './picklists.js';
 
 export type CountryInfo = {
   code: string; // code is ISO 3166-1 alpha-2

package/src/types/vehicles.ts

@@ -6,7 +6,7 @@ import {
   MultiLangValue,
   SearchPermissions,
 } from '@bisondesk/commons-sdk/types';
-import { OpportunityReservation } from './reservations';
+import { OpportunityReservation } from './reservations.js';
 
 type BaseVehicleEvent = {
   id: string;

package/src/utils/forms.ts

@@ -1,5 +1,5 @@
-import Decimal from 'decimal.js';
-import { PricePercentageMode } from '../types/utils';
+import { Decimal } from 'decimal.js';
+import { PricePercentageMode } from '../types/utils.js';
 
 export const computePricePercentage = (
   totalAmount: string,

package/src/utils/leasing.ts

@@ -1,13 +1,14 @@
-import { utc } from '@bisondesk/commons-sdk/dayjs-utils';
-import { map, sortBy, uniqBy } from 'lodash';
-import { LeasingContractClient } from '../types/leasing';
+import { UTCDate } from '@date-fns/utc';
+import { format } from 'date-fns';
+import { map, sortBy, uniqBy } from 'lodash-es';
+import { LeasingContractClient } from '../types/leasing.js';
 
 /* sort from oldest to most recent client */
 export const sortContractClients = (clients: LeasingContractClient[]): LeasingContractClient[] =>
   sortBy(
     map(
       uniqBy(clients, (c) => c.takeoverId),
-      (c) => ({ ...c, since: utc(c.since).format('YYYY-MM-DD') }) // doing a map to also fix legacy data
+      (c) => ({ ...c, since: format(new UTCDate(c.since), 'yyyy-MM-dd') }) // doing a map to also fix legacy data
     ),
     (cli) => cli.since,
     (cli) => (cli.takeoverId ? parseInt(cli.takeoverId.replace(/[^0-9]/g, '')) : 0)

package/src/utils/opportunities.ts

@@ -1,4 +1,4 @@
-import { Opportunity, OpportunityStatus, OpportunityStatusOrder } from '../types/opportunities';
+import { Opportunity, OpportunityStatus, OpportunityStatusOrder } from '../types/opportunities.js';
 
 type CompareInput = {
   currentStatus: OpportunityStatus;

package/src/utils/search.ts

@@ -0,0 +1,130 @@
+import { joinWithSeparator } from '@bisondesk/commons-sdk/formatting';
+import { BusinessEntityIds } from '../constants.js';
+import { Contact, Organization, SearchOrganization } from '../types/crm.js';
+import { SearchLeasingContract } from '../types/leasing-search.js';
+import { LeasingContract } from '../types/leasing.js';
+import { Opportunity, SearchOpportunity } from '../types/opportunities.js';
+import { SearchVehicle, Vehicle } from '../types/vehicles.js';
+
+export type GlobalBusinessEntity = Opportunity | Vehicle | Organization | LeasingContract;
+export type GlobalSearchEntity =
+  | SearchOpportunity
+  | SearchVehicle
+  | SearchOrganization
+  | SearchLeasingContract;
+
+export const getCustomerInformation = (org?: Organization, contact?: Contact) => {
+  if (org != null) {
+    return {
+      countryCode: org.countryCode,
+      title: org.name,
+      code: org.externalId,
+    };
+  }
+
+  if (contact != null) {
+    return {
+      countryCode: contact.countryCode,
+      title: [contact?.firstName, contact?.lastName].filter(Boolean).join(' '),
+    };
+  }
+};
+
+export const mappings: {
+  [key in BusinessEntityIds]?: {
+    getMainEntity: (entity: any) => GlobalBusinessEntity;
+    getTitle: (entity: any) => string;
+    getTags: (entity: any) => (string | undefined)[];
+    getDescription?: (entity: any) => string;
+  };
+} = {
+  [BusinessEntityIds.Opportunities]: {
+    getMainEntity: (entity: SearchOpportunity) => entity.opportunity,
+    getTitle: (opp: Opportunity) => opp.id,
+    getDescription: (opp: SearchOpportunity) =>
+      joinWithSeparator(
+        [
+          getCustomerInformation(opp.org, opp.contact)?.code,
+          opp.vehicle?.external.identification.stockNumber,
+        ].filter(Boolean)
+      ),
+    getTags: (opp: Opportunity) => [opp.id],
+  },
+  [BusinessEntityIds.Vehicles]: {
+    getMainEntity: (entity: SearchVehicle) => entity.vehicle,
+    getTitle: (vehicle: Vehicle) => vehicle.internal.description.title,
+    getTags: (vehicle: Vehicle) => [
+      vehicle.external.identification?.stockNumber,
+      vehicle.internal.identification?.administrativeNumber,
+    ],
+  },
+  [BusinessEntityIds.Organizations]: {
+    getMainEntity: (entity: SearchOrganization) => entity.org,
+    getTitle: (org: Organization) => org.name,
+    getTags: (org: Organization) => [`${org.externalId}`, org.vatNumber],
+  },
+  [BusinessEntityIds.LeasingContracts]: {
+    getMainEntity: (entity: SearchLeasingContract) => entity.contract,
+    getTitle: (contract: LeasingContract) => contract.contractNumber ?? contract.id,
+    getTags: (contract: LeasingContract) => [contract.contractNumber, contract.slbPartner],
+  },
+};
+
+const getMapping = (businessEntityId: BusinessEntityIds) => {
+  const mapping = mappings[businessEntityId];
+  if (!mapping) {
+    throw new Error(`Invalid business entity id ${businessEntityId}`);
+  }
+  return mapping;
+};
+
+export const getTagsForBusinessEntity = (
+  businessEntityId: BusinessEntityIds,
+  entity: GlobalBusinessEntity
+): string[] => getMapping(businessEntityId).getTags(entity).filter(Boolean) as string[];
+
+export const getTagsForSearchBusinessEntity = (
+  businessEntityId: BusinessEntityIds,
+  entity: GlobalSearchEntity
+) =>
+  getTagsForBusinessEntity(
+    businessEntityId,
+    getMainEntityFromSearchEntity(businessEntityId, entity)
+  );
+
+export const getDescriptionForBusinessEntity = (
+  businessEntityId: BusinessEntityIds,
+  entity: GlobalBusinessEntity
+) => joinWithSeparator(getTagsForBusinessEntity(businessEntityId, entity));
+
+export const getDescriptionForSearchBusinessEntity = (
+  businessEntityId: BusinessEntityIds,
+  entity: GlobalSearchEntity
+) => {
+  return (
+    getMapping(businessEntityId).getDescription?.(entity) ??
+    getDescriptionForBusinessEntity(
+      businessEntityId,
+      getMainEntityFromSearchEntity(businessEntityId, entity)
+    )
+  );
+};
+
+export const getMainEntityFromSearchEntity = (
+  businessEntityId: BusinessEntityIds,
+  entity: GlobalSearchEntity
+) => getMapping(businessEntityId).getMainEntity(entity);
+
+export const getTitleForBusinessEntity = (
+  businessEntityId: BusinessEntityIds,
+  entity: GlobalBusinessEntity
+) => getMapping(businessEntityId).getTitle(entity);
+
+export const getTitleForSearchBusinessEntity = (
+  businessEntityId: BusinessEntityIds,
+  searchEntity: GlobalSearchEntity
+) =>
+  getTitleForBusinessEntity(
+    businessEntityId,
+    getMainEntityFromSearchEntity(businessEntityId, searchEntity)
+  );