@bisondesk/core-sdk 1.0.634 → 1.0.636

package/lib/types/whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.js","sourceRoot":"/","sources":["types/whatsapp.ts"],"names":[],"mappings":"","sourcesContent":["import {\n  WhatsappActivityTemplateName,\n  WhatsappTemplateTranslation,\n} from '@bisondesk/commons-sdk/notifications-whatsapp';\nimport { BusinessEntityIds } from '../constants.js';\nimport { Activity } from './activities.js';\nimport { DataRecord } from './utils.js';\n\nexport type { WhatsappActivityTemplateName };\n\nexport type WhatsappTemplateLanguage = {\n  language: string;\n  status: string;\n};\n\nexport type WhatsappTemplateSummary = {\n  name: WhatsappActivityTemplateName;\n  languages: WhatsappTemplateLanguage[];\n};\n\nexport type WhatsappActivityTemplateTranslation =\n  WhatsappTemplateTranslation<WhatsappActivityTemplateName>;\n\nexport type WhatsappTemplatePreview = {\n  sent: WhatsappActivityTemplateTranslation;\n  canonical?: WhatsappActivityTemplateTranslation;\n};\n\nexport type WhatsappRecipient = {\n  contactId?: string;\n  organizationId?: string;\n  phone: string;\n  countryLanguage?: string;\n};\n\nexport type WhatsappActivityContext = {\n  businessEntityId: BusinessEntityIds;\n  recordId: string;\n  organizationId?: string;\n};\n\nexport type SendWhatsappActivityTemplateRequest = {\n  templateName: WhatsappActivityTemplateName;\n  language: string;\n  recipient: Pick<WhatsappRecipient, 'contactId' | 'phone'>;\n  context: WhatsappActivityContext;\n};\n\nexport type SendWhatsappActivityTemplateResponse = DataRecord<Activity>;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bisondesk/core-sdk",
-  "version": "1.0.634",
+  "version": "1.0.636",
   "description": "",
   "type": "module",
   "author": "TheTruckCompany",

package/src/apis/crm.ts

@@ -95,6 +95,27 @@ export const getCrmOrganizationsByVatNumber = async (
   throw new XError(response.statusText, { url, body, tenantId, vatNumber });
 };
 
+export const getCrmOrganizationsByRegistrationNumber = async (
+  tenantId: string,
+  registrationNumber: string,
+): Promise<Organization[]> => {
+  const auth = await getAdminAuth();
+  const url = `${process.env.CORE_API_ORIGIN}/admin/crm/organizations/registration-number/${encodeURIComponent(registrationNumber)}`;
+  const response: Response = await fetch(url, {
+    headers: cleanHeaders({
+      Authorization: auth,
+      [TENANT_ID_ADMIN_HEADER]: tenantId,
+    }),
+  });
+
+  if (response.ok) {
+    return (response.status === 200 ? response.json() : []) as Promise<Organization[]>;
+  }
+
+  const body = await response.text();
+  throw new XError(response.statusText, { url, body, tenantId, registrationNumber });
+};
+
 export const saveCrmOrganization = async (
   tenantId: string,
   org: Organization | NewOrganization,

package/src/types/activities.ts

@@ -94,8 +94,8 @@ export type ActivityDeleteEvent = BaseActivityEvent & {
 export type ActivityV2Meta =
   | EmailDebtorsDossierActivityPayload
   | CallActivityPayload
-  | MeetingDebtorsDossierActivityPayload
-  | ChatDebtorsDossierActivityPayload;
+  | MeetingActivityPayload
+  | ChatActivityPayload;
 
 export type EmailDebtorsDossierActivityPayload = {
   /*   from: { email: string; name?: string; external?: boolean };
@@ -115,7 +115,7 @@ export type CallActivityPayload = {
   transcription?: string; */
 };
 
-export type MeetingDebtorsDossierActivityPayload = {
+export type MeetingActivityPayload = {
   /*   organizer: string;
   participants: string[];
   location?: string;
@@ -123,9 +123,11 @@ export type MeetingDebtorsDossierActivityPayload = {
   endTime: string; */
 };
 
-export type ChatDebtorsDossierActivityPayload = {
+export type ChatActivityPayload = {
   /*   from: { phone: string; name?: string; external?: boolean };
   to: string[]; */
   message: string;
   platform: 'whatsapp' | 'sms';
+  templateName?: string;
+  language?: string;
 };

package/src/types/crm.ts

@@ -120,6 +120,12 @@ type BaseOrganization = {
    * cautionnement names the customer by capital alongside its trade-register number.
    */
   shareCapital?: string;
+  /**
+   * National business registration number. For FR orgs this is a SIREN (9 digits) or a SIRET
+   * (14 digits = SIREN + 5-digit NIC) — whichever is available; needed for annuaire routing of
+   * FR B2B e-invoices. A SIREN is derivable from a valid FR VAT (digits 3–11).
+   */
+  registrationNumber?: string;
   addresses?: {
     legal?: LocationValue;
     transport?: LocationValue;

package/src/types/reports-sales.ts

@@ -120,6 +120,24 @@ export type SalesReportHistogramBucket = {
   count: number;
 };
 
+/**
+ * Current-month sales projection for the histogram's last bucket: the average sales
+ * per business day over the last 5 business days, extended over the business days
+ * left in the month. Business days are UTC weekdays (Mon–Fri) — no holiday calendar.
+ * Today is excluded on both sides: it is still filling up (its sales land in the
+ * month's actual count as they happen).
+ */
+export type SalesReportProjection = {
+  /** The projected month, `YYYY-MM` — always the histogram's last bucket. */
+  month: string;
+  /** Average sales per business day over the last 5 business days. */
+  salesPerBusinessDay: number;
+  /** Business days (Mon–Fri, UTC) left in the month after today. */
+  businessDaysLeft: number;
+  /** Expected further sales this month: `salesPerBusinessDay × businessDaysLeft` (unrounded). */
+  projectedRemaining: number;
+};
+
 /**
  * Age-of-stock bands, in days of capital tied up. Cut points at 30 / 90 / 180 days,
  * upper bound inclusive; the last band is open-ended, so `180+` means "181 and over".
@@ -129,15 +147,22 @@ export const STOCK_AGE_BANDS = ['0-30', '31-90', '91-180', '180+'] as const;
 export type StockAgeBand = (typeof STOCK_AGE_BANDS)[number];
 
 /**
- * One day on the stock-age chart, measured by capital tied up in inventory. A vehicle
- * counts on `date` when the supplier was fully paid on or before that day and it had not
- * been sold yet; its age is `date − supplierFullyPaidAt` in days. Used vehicles only.
+ * One monthly snapshot on the stock-age charts, measured by capital tied up in
+ * inventory. A vehicle counts on `date` when the supplier was fully paid on or before
+ * that day and it had not been sold yet; its age is `date − supplierFullyPaidAt` in
+ * days. Used vehicles only.
  */
 export type StockAgePoint = {
-  /** Snapshot day, `YYYY-MM-DD` (UTC). */
+  /** Snapshot day — the 1st of a month, `YYYY-MM-DD` (UTC). */
   date: string;
   /** In-stock vehicle count per age band on that day. */
   counts: Record<StockAgeBand, number>;
+  /**
+   * Sum of those vehicles' purchase costs per age band on that day (`deal.purchase`,
+   * excl VAT, tenant currency). A vehicle without a recorded purchase cost still counts
+   * in `counts` but contributes 0 here.
+   */
+  purchaseCosts: Record<StockAgeBand, number>;
 };
 
 export type SalesReportResponse = {
@@ -178,10 +203,12 @@ export type SalesReportResponse = {
   conglomerate: SalesReportConglomerate;
   /** Fixed last-18-calendar-months histogram of opps into Preparation (period-independent). */
   histogram: SalesReportHistogramBucket[];
+  /** Current-month projection, stacked on the histogram's last bucket by the client. */
+  projection: SalesReportProjection;
   /**
-   * Stock-age evolution measured as capital tied up in inventory: one daily snapshot of
-   * vehicles by days from supplier-fully-paid to sold (used vehicles). Fixed to the last
-   * 6 months, period-independent.
+   * Stock-age evolution measured as capital tied up in inventory: one snapshot per
+   * month-1st of vehicles by days from supplier-fully-paid to sold (used vehicles).
+   * Fixed to the last 24 months, period-independent.
    */
   stockAge: StockAgePoint[];
   /**

package/src/types/tenants.ts

@@ -142,6 +142,18 @@ export type Branch = {
   location: LocationValue;
 
   storecoveExternalId?: number;
+  // true if the branch is for a company where VAT is due when the invoice
+  // is issued not when the payment is collected (e.g. France, Italy, Spain)
+  vatOnDebits?: boolean;
+  /**
+   * The French issuing duties — e-invoicing, e-reporting and the Encaissée status — are switched
+   * on for this branch. Receiving is unaffected and always active.
+   *
+   * Kept separate from `storecoveExternalId` on purpose: registering a Storecove legal entity only
+   * makes a branch reachable, it does not mean the French duties have started. As a PME those
+   * duties begin 2027-09-01, so this stays off until then or until a deliberate earlier adoption.
+   */
+  frIssuingEnabled?: boolean;
   externalQuote?: boolean;
   hyperdmsId?: string;
   internalDealsEnabled?: boolean;

package/src/types/user-performance.ts

@@ -22,7 +22,6 @@ export type MetricConfig = {
   commissionType: CommissionType;
   personal: boolean; // if true, this metric is personal to the user
   format?: Intl.NumberFormatOptions;
-  listVehicles?: boolean; // should this metric be allowed to list vehicles?
   defaultTarget?: number; // default target for the metric, useful for showing metrics to users w/o a commission plan
   autoHide?: boolean; // hide in UI when annual value is 0
   manualEntry?: boolean; // if true, data comes from manually added entries instead of vehicle_business_overviews

package/src/types/whatsapp.ts

@@ -0,0 +1,49 @@
+import {
+  WhatsappActivityTemplateName,
+  WhatsappTemplateTranslation,
+} from '@bisondesk/commons-sdk/notifications-whatsapp';
+import { BusinessEntityIds } from '../constants.js';
+import { Activity } from './activities.js';
+import { DataRecord } from './utils.js';
+
+export type { WhatsappActivityTemplateName };
+
+export type WhatsappTemplateLanguage = {
+  language: string;
+  status: string;
+};
+
+export type WhatsappTemplateSummary = {
+  name: WhatsappActivityTemplateName;
+  languages: WhatsappTemplateLanguage[];
+};
+
+export type WhatsappActivityTemplateTranslation =
+  WhatsappTemplateTranslation<WhatsappActivityTemplateName>;
+
+export type WhatsappTemplatePreview = {
+  sent: WhatsappActivityTemplateTranslation;
+  canonical?: WhatsappActivityTemplateTranslation;
+};
+
+export type WhatsappRecipient = {
+  contactId?: string;
+  organizationId?: string;
+  phone: string;
+  countryLanguage?: string;
+};
+
+export type WhatsappActivityContext = {
+  businessEntityId: BusinessEntityIds;
+  recordId: string;
+  organizationId?: string;
+};
+
+export type SendWhatsappActivityTemplateRequest = {
+  templateName: WhatsappActivityTemplateName;
+  language: string;
+  recipient: Pick<WhatsappRecipient, 'contactId' | 'phone'>;
+  context: WhatsappActivityContext;
+};
+
+export type SendWhatsappActivityTemplateResponse = DataRecord<Activity>;