@burdenoff/microfe-movethewheels 2026.1101.3 → 2026.1102.1

package/dist/generated/tracking-quality-operations.d.ts

@@ -148,6 +148,8 @@ export type CreateCustomerInput = {
     context?: InputMaybe<ContextInput>;
     email?: InputMaybe<Scalars['String']['input']>;
     name: Scalars['String']['input'];
+    notifyByEmail?: InputMaybe<Scalars['Boolean']['input']>;
+    notifyBySms?: InputMaybe<Scalars['Boolean']['input']>;
     phone?: InputMaybe<Scalars['String']['input']>;
     rating?: InputMaybe<Scalars['Float']['input']>;
     taxId?: InputMaybe<Scalars['String']['input']>;
@@ -939,6 +941,10 @@ export type MtwCustomer = {
     email?: Maybe<Scalars['String']['output']>;
     id: Scalars['ID']['output'];
     name: Scalars['String']['output'];
+    /** Send this customer delivery notifications by email (BOFF-4402). The workspace must also switch customer notifications on. */
+    notifyByEmail: Scalars['Boolean']['output'];
+    /** Send this customer delivery notifications by SMS. Needs a phone number with its country code. */
+    notifyBySms: Scalars['Boolean']['output'];
     onBehalfOf: Scalars['String']['output'];
     phone?: Maybe<Scalars['String']['output']>;
     rating?: Maybe<Scalars['Float']['output']>;
@@ -948,6 +954,91 @@ export type MtwCustomer = {
     updatedBy?: Maybe<Scalars['String']['output']>;
     workspaceId: Scalars['ID']['output'];
 };
+/** One notification sent (or attempted) to a shipment's customer. */
+export type MtwCustomerNotification = {
+    __typename?: 'MtwCustomerNotification';
+    attempts: Scalars['Int']['output'];
+    channel: MtwCustomerNotificationChannel;
+    createdAt: Scalars['DateTime']['output'];
+    customerId?: Maybe<Scalars['ID']['output']>;
+    event: MtwCustomerNotificationEvent;
+    id: Scalars['ID']['output'];
+    lastError?: Maybe<Scalars['String']['output']>;
+    /** Masked address, e.g. j***@example.com. */
+    recipient?: Maybe<Scalars['String']['output']>;
+    sentAt?: Maybe<Scalars['DateTime']['output']>;
+    shipmentId: Scalars['ID']['output'];
+    shipmentNumber?: Maybe<Scalars['String']['output']>;
+    status: MtwCustomerNotificationStatus;
+    subject?: Maybe<Scalars['String']['output']>;
+    updatedAt: Scalars['DateTime']['output'];
+};
+/** How a customer is reached. */
+export type MtwCustomerNotificationChannel = 'EMAIL' | 'SMS';
+/** A shipment lifecycle moment a customer can be told about (BOFF-4402). */
+export type MtwCustomerNotificationEvent = 
+/** The shipment was created for the customer. */
+'BOOKED'
+/** The risk monitor expects the shipment to miss its promised delivery. Sent once per promise. */
+ | 'DELAYED'
+/** The shipment was delivered. */
+ | 'DELIVERED'
+/** Delivery could not be completed. */
+ | 'FAILED'
+/** The latest tracking event says the shipment is out for delivery. */
+ | 'OUT_FOR_DELIVERY'
+/** The shipment was collected. */
+ | 'PICKED_UP';
+export type MtwCustomerNotificationFilterInput = {
+    event?: InputMaybe<MtwCustomerNotificationEvent>;
+    shipmentId?: InputMaybe<Scalars['ID']['input']>;
+    status?: InputMaybe<MtwCustomerNotificationStatus>;
+};
+/** A page of customer notifications, newest first. */
+export type MtwCustomerNotificationPage = {
+    __typename?: 'MtwCustomerNotificationPage';
+    hasMore: Scalars['Boolean']['output'];
+    items: Array<MtwCustomerNotification>;
+    total: Scalars['Int']['output'];
+};
+/** What a customer notification for an event looks like, rendered with sample data. */
+export type MtwCustomerNotificationPreview = {
+    __typename?: 'MtwCustomerNotificationPreview';
+    emailText: Scalars['String']['output'];
+    event: MtwCustomerNotificationEvent;
+    smsText: Scalars['String']['output'];
+    subject: Scalars['String']['output'];
+};
+/**
+ * Whether and how this workspace tells its customers about their shipments.
+ * Off until a workspace admin switches it on; only shipment changes made after
+ * that moment notify, so switching on never mails customers about old shipments.
+ */
+export type MtwCustomerNotificationSettings = {
+    __typename?: 'MtwCustomerNotificationSettings';
+    emailEnabled: Scalars['Boolean']['output'];
+    enabled: Scalars['Boolean']['output'];
+    /** When notifications were last switched on. */
+    enabledAt?: Maybe<Scalars['DateTime']['output']>;
+    /** Events that notify customers. */
+    events: Array<MtwCustomerNotificationEvent>;
+    /** False until the workspace saves these settings. */
+    isCustomized: Scalars['Boolean']['output'];
+    smsEnabled: Scalars['Boolean']['output'];
+    updatedAt?: Maybe<Scalars['DateTime']['output']>;
+    updatedBy?: Maybe<Scalars['ID']['output']>;
+    workspaceId: Scalars['ID']['output'];
+};
+/** Where a customer notification stands. */
+export type MtwCustomerNotificationStatus = 
+/** Not accepted; retried by a later evaluation up to three times. */
+'FAILED'
+/** Claimed and being sent. */
+ | 'PENDING'
+/** Accepted by the platform notification service. */
+ | 'SENT'
+/** Not sent because the customer has no usable address for the channel. */
+ | 'SKIPPED';
 export type MtwCustomerStats = {
     __typename?: 'MtwCustomerStats';
     /** Unavailable because customers have no lifecycle status field. */
@@ -2960,6 +3051,9 @@ export type MtwRiskForecast = {
     evaluatedAt: Scalars['DateTime']['output'];
     /** Forecasting method, e.g. DETERMINISTIC_V1. */
     method: Scalars['String']['output'];
+    /** AI narration of this forecast. Null when AI is disabled, credits are spent, or none was generated yet. */
+    narration?: Maybe<MtwRiskNarration>;
+    narrationStatus: MtwRiskNarrationStatus;
     predictedDeliveryEarliest?: Maybe<Scalars['DateTime']['output']>;
     predictedDeliveryLatest?: Maybe<Scalars['DateTime']['output']>;
     predictedSlipMinutes: Scalars['Int']['output'];
@@ -2975,6 +3069,40 @@ export type MtwRiskForecast = {
     status: ShipmentStatus;
 };
 export type MtwRiskLevel = 'HIGH' | 'LOW' | 'MEDIUM' | 'NONE';
+/**
+ * Plain-language explanation of a risk forecast, written by a model from the
+ * forecast's computed features. It never changes the forecast's numbers.
+ */
+export type MtwRiskNarration = {
+    __typename?: 'MtwRiskNarration';
+    /** Suggested message to the end customer re-promising delivery, when one is warranted. */
+    customerMessage?: Maybe<Scalars['String']['output']>;
+    /** Why the shipment is predicted to slip, in two or three sentences. */
+    explanation: Scalars['String']['output'];
+    generatedAt: Scalars['DateTime']['output'];
+    id: Scalars['ID']['output'];
+    /** Language the narration was written in. */
+    locale: Scalars['String']['output'];
+    /** Provider-qualified model that wrote it, e.g. openai/gpt-4o-mini. */
+    model: Scalars['String']['output'];
+    /** interactive, scheduled or event. */
+    trigger: Scalars['String']['output'];
+};
+export type MtwRiskNarrationStatus = 
+/** AI narration is switched off for this environment. */
+'AI_DISABLED'
+/** A narration for the forecast as it stands now is attached. */
+ | 'AVAILABLE'
+/** The workspace has spent its MoveTheWheels AI credits; no model call was made. */
+ | 'CREDITS_EXHAUSTED'
+/** The workspace reached its daily narration cap; no model call was made. */
+ | 'DAILY_CAP_REACHED'
+/** The forecast has no risk signals, so there is nothing to explain. */
+ | 'NOT_NEEDED'
+/** No narration has been generated for this forecast yet; call mtwNarrateShipmentRiskForecast. */
+ | 'NOT_REQUESTED'
+/** The model could not produce a narration this time; the forecast is unchanged. */
+ | 'UNAVAILABLE';
 export type MtwRiskRecommendedAction = 'MONITOR' | 'NONE' | 'REASSIGN_VEHICLE' | 'REPROMISE_DELIVERY' | 'REQUEST_TRACKING_UPDATE';
 /**
  * One piece of evidence behind a risk forecast. `weight` is the number of risk
@@ -2989,6 +3117,49 @@ export type MtwRiskSignal = {
     weight: Scalars['Int']['output'];
 };
 export type MtwRiskSignalCode = 'CARRIER_LATE_HISTORY' | 'EXCESS_DWELL' | 'LEG_SLIP' | 'OPEN_LEG_OVERDUE' | 'ROUTE_DURATION_OVERRUN' | 'TRACKING_STALE' | 'VEHICLE_UNAVAILABLE';
+export type MtwRiskSweep = {
+    __typename?: 'MtwRiskSweep';
+    atRisk: Scalars['Int']['output'];
+    /**
+     * True when this call was a redelivery of an earlier scheduler fire with the
+     * same idempotency key; the original sweep is returned and nothing ran again.
+     */
+    duplicate: Scalars['Boolean']['output'];
+    durationMs?: Maybe<Scalars['Int']['output']>;
+    episodesClosed: Scalars['Int']['output'];
+    episodesOpened: Scalars['Int']['output'];
+    error?: Maybe<Scalars['String']['output']>;
+    finishedAt?: Maybe<Scalars['DateTime']['output']>;
+    id: Scalars['ID']['output'];
+    notificationsSent: Scalars['Int']['output'];
+    scheduledFor?: Maybe<Scalars['DateTime']['output']>;
+    shipmentsEvaluated: Scalars['Int']['output'];
+    /** KILL_SWITCH when the monitor is switched off. */
+    skippedReason?: Maybe<Scalars['String']['output']>;
+    startedAt: Scalars['DateTime']['output'];
+    /** RUNNING, COMPLETED, SKIPPED or FAILED. */
+    status: Scalars['String']['output'];
+    /** SCHEDULED (fired by wspace-scheduler-svc) or MANUAL. */
+    trigger: Scalars['String']['output'];
+    workspaceId: Scalars['ID']['output'];
+};
+/**
+ * The workspace's cadence job in wspace-scheduler-svc. A workspace admin can pause
+ * it on the shared Schedules screen; the monitor leaves a paused job alone.
+ */
+export type MtwRiskSweepSchedule = {
+    __typename?: 'MtwRiskSweepSchedule';
+    cronExpression: Scalars['String']['output'];
+    id: Scalars['ID']['output'];
+    lastError?: Maybe<Scalars['String']['output']>;
+    lastSweepAt?: Maybe<Scalars['DateTime']['output']>;
+    schedulerJobId?: Maybe<Scalars['ID']['output']>;
+    /** PENDING, ACTIVE or FAILED. */
+    status: Scalars['String']['output'];
+    timezone: Scalars['String']['output'];
+    updatedAt: Scalars['DateTime']['output'];
+    workspaceId: Scalars['ID']['output'];
+};
 export type MtwRoute = {
     __typename?: 'MtwRoute';
     actualDistance?: Maybe<Scalars['Float']['output']>;
@@ -3025,6 +3196,15 @@ export type MtwRouteStats = {
     totalDistance: Scalars['Float']['output'];
     totalDuration: Scalars['Float']['output'];
 };
+/**
+ * Set by wspace-scheduler-svc at fire time: idempotencyKey is
+ * "<scheduleId>:<scheduledTime>" and triggerData carries scheduledTime, firedAt,
+ * timezone, scheduleId and eventId. Ignored for on-demand runs by a person.
+ */
+export type MtwRunRiskSweepInput = {
+    idempotencyKey?: InputMaybe<Scalars['String']['input']>;
+    triggerData?: InputMaybe<Scalars['JSON']['input']>;
+};
 /** Whether the provider currently has capacity for an offering. */
 export type MtwServiceAvailability = 'AVAILABLE' | 'LIMITED' | 'UNAVAILABLE';
 /** A discoverable service a provider offers, with indicative price and availability. */
@@ -3209,6 +3389,39 @@ export type MtwShipmentLeg = {
     widthCm?: Maybe<Scalars['Float']['output']>;
     workspaceId: Scalars['ID']['output'];
 };
+/**
+ * The current (or last) risk episode of one shipment. An episode opens when the
+ * forecast first reports the shipment at risk, notifies once, and closes when the
+ * forecast recovers, the promise passes or the shipment finishes.
+ */
+export type MtwShipmentRiskEpisode = {
+    __typename?: 'MtwShipmentRiskEpisode';
+    /** RECOVERED, BREACHED, COMPLETED or REMOVED. */
+    closeReason?: Maybe<Scalars['String']['output']>;
+    closedAt?: Maybe<Scalars['DateTime']['output']>;
+    /** How many episodes this shipment has had. */
+    episodeCount: Scalars['Int']['output'];
+    id: Scalars['ID']['output'];
+    lastEvaluatedAt: Scalars['DateTime']['output'];
+    lastNotificationError?: Maybe<Scalars['String']['output']>;
+    /** EVENT or SWEEP: what evaluated the shipment last. */
+    lastTrigger: Scalars['String']['output'];
+    notificationAttempts: Scalars['Int']['output'];
+    notificationsSent: Scalars['Int']['output'];
+    /** When the episode's notification reached at least one recipient. */
+    notifiedAt?: Maybe<Scalars['DateTime']['output']>;
+    openedAt: Scalars['DateTime']['output'];
+    predictedSlipMinutes: Scalars['Int']['output'];
+    /** The promised delivery the episode was raised against. */
+    promisedDelivery?: Maybe<Scalars['DateTime']['output']>;
+    recommendedAction?: Maybe<Scalars['String']['output']>;
+    riskLevel: Scalars['String']['output'];
+    riskScore: Scalars['Int']['output'];
+    shipmentId: Scalars['ID']['output'];
+    signals: Array<Scalars['String']['output']>;
+    /** OPEN or CLOSED. */
+    state: Scalars['String']['output'];
+};
 export type MtwShipmentStatusDecision = {
     __typename?: 'MtwShipmentStatusDecision';
     authorityEpoch: Scalars['Int']['output'];
@@ -3502,6 +3715,8 @@ export type MtwTrackingAlert = {
     /** Stable alert id, `<shipmentId>:<alertType>`. */
     id: Scalars['ID']['output'];
     message: Scalars['String']['output'];
+    /** AI narration of the forecast behind an AT_RISK alert, when one was generated for its current signals. */
+    narration?: Maybe<MtwRiskNarration>;
     predictedDelivery?: Maybe<Scalars['DateTime']['output']>;
     /** The shipment's promised delivery (estimatedDelivery) the alert was raised against. */
     promisedDelivery?: Maybe<Scalars['DateTime']['output']>;
@@ -3842,6 +4057,24 @@ export type Mutation = {
     importMtwDrivers: MtwImportResult;
     importMtwVehicles: MtwImportResult;
     importMtwWarehouses: MtwImportResult;
+    /**
+     * Register, verify or repair the workspace's risk sweep with the platform
+     * scheduler. Idempotent; leaves a job an operator paused alone.
+     */
+    mtwEnsureRiskSweepSchedule?: Maybe<MtwRiskSweepSchedule>;
+    /**
+     * Generate (or reuse) the AI narration for a shipment's current risk forecast
+     * and return the forecast with it attached. With AI disabled, credits spent or
+     * the daily cap reached, this returns the deterministic forecast unchanged and
+     * makes no model call; `narrationStatus` says why.
+     */
+    mtwNarrateShipmentRiskForecast: MtwRiskForecast;
+    /**
+     * Re-forecast every in-flight shipment of the workspace and notify for any that
+     * started slipping. Fired by wspace-scheduler-svc as this service's own service
+     * actor; a workspace user may also run it on demand.
+     */
+    mtwRunRiskSweep: MtwRiskSweep;
     openMtwContainerCycle: MtwContainerCycle;
     openMtwFreeTimeClock: MtwFreeTimeClock;
     optimizeRoute: MtwRoute;
@@ -3887,6 +4120,8 @@ export type Mutation = {
     updateDriverStatus: MtwDriver;
     updateIntegration: MtwIntegration;
     updateInventoryItem: MtwInventoryItem;
+    /** Switch customer notifications on or off and choose channels and events. */
+    updateMtwCustomerNotificationSettings: MtwCustomerNotificationSettings;
     /** Save the workspace's MoveTheWheels operational defaults. Every field is validated. */
     updateMtwModuleSettings: MtwModuleSettings;
     updateRoute: MtwRoute;
@@ -4043,6 +4278,12 @@ export type MutationImportMtwVehiclesArgs = {
 export type MutationImportMtwWarehousesArgs = {
     input: MtwImportInput;
 };
+export type MutationMtwNarrateShipmentRiskForecastArgs = {
+    shipmentId: Scalars['ID']['input'];
+};
+export type MutationMtwRunRiskSweepArgs = {
+    input?: InputMaybe<MtwRunRiskSweepInput>;
+};
 export type MutationOpenMtwContainerCycleArgs = {
     input: OpenMtwContainerCycleInput;
 };
@@ -4188,6 +4429,9 @@ export type MutationUpdateInventoryItemArgs = {
     id: Scalars['ID']['input'];
     input: UpdateInventoryItemInput;
 };
+export type MutationUpdateMtwCustomerNotificationSettingsArgs = {
+    input: UpdateMtwCustomerNotificationSettingsInput;
+};
 export type MutationUpdateMtwModuleSettingsArgs = {
     input: UpdateMtwModuleSettingsInput;
 };
@@ -4372,6 +4616,12 @@ export type Query = {
     mtwContainerReleaseDecisionPage: MtwContainerReleaseDecisionPage;
     mtwContainerRepairPage: MtwContainerRepairPage;
     mtwContainers: Array<MtwContainer>;
+    /** Sample messages for each event, signed with this workspace's name. */
+    mtwCustomerNotificationPreviews: Array<MtwCustomerNotificationPreview>;
+    /** This workspace's customer notification settings; off when none were saved. */
+    mtwCustomerNotificationSettings: MtwCustomerNotificationSettings;
+    /** Customer notifications sent or attempted in this workspace, newest first. */
+    mtwCustomerNotifications: MtwCustomerNotificationPage;
     /** Exact immutable instruction, including a proposal's historical owner; not a current-eligibility claim. */
     mtwEmptyReturnInstruction: MtwEmptyReturnInstruction;
     mtwEmptyReturnInstructionPage: MtwEmptyReturnInstructionPage;
@@ -4411,6 +4661,12 @@ export type Query = {
     mtwReuseProposalPage: MtwReuseProposalPage;
     mtwReuseReservationPage: MtwReuseReservationPage;
     mtwReuseReservationTransitionPage: MtwReuseReservationTransitionPage;
+    /** The workspace's risk-sweep registration with the platform scheduler, if any. */
+    mtwRiskSweepSchedule?: Maybe<MtwRiskSweepSchedule>;
+    /** Recent risk sweeps of the workspace, newest first. */
+    mtwRiskSweeps: Array<MtwRiskSweep>;
+    /** The shipment's current or last risk episode, or null if it has never been at risk. */
+    mtwShipmentRiskEpisode?: Maybe<MtwShipmentRiskEpisode>;
     mtwShipmentRiskForecast: MtwRiskForecast;
     mtwStockBindingAssessment: MtwStockBindingAssessment;
     mtwStockBindingAssessmentPage: MtwStockBindingAssessmentPage;
@@ -4639,6 +4895,10 @@ export type QueryMtwContainersArgs = {
     pagination?: InputMaybe<MtwContainerPagination>;
     search?: InputMaybe<Scalars['String']['input']>;
 };
+export type QueryMtwCustomerNotificationsArgs = {
+    filter?: InputMaybe<MtwCustomerNotificationFilterInput>;
+    pagination?: InputMaybe<PaginationInput>;
+};
 export type QueryMtwEmptyReturnInstructionArgs = {
     id: Scalars['ID']['input'];
 };
@@ -4750,6 +5010,12 @@ export type QueryMtwReuseReservationTransitionPageArgs = {
     pagination?: InputMaybe<MtwContainerPagination>;
     reservationId: Scalars['ID']['input'];
 };
+export type QueryMtwRiskSweepsArgs = {
+    pagination?: InputMaybe<PaginationInput>;
+};
+export type QueryMtwShipmentRiskEpisodeArgs = {
+    shipmentId: Scalars['ID']['input'];
+};
 export type QueryMtwShipmentRiskForecastArgs = {
     shipmentId: Scalars['ID']['input'];
 };
@@ -5260,6 +5526,8 @@ export type UpdateCustomerInput = {
     context?: InputMaybe<ContextInput>;
     email?: InputMaybe<Scalars['String']['input']>;
     name?: InputMaybe<Scalars['String']['input']>;
+    notifyByEmail?: InputMaybe<Scalars['Boolean']['input']>;
+    notifyBySms?: InputMaybe<Scalars['Boolean']['input']>;
     phone?: InputMaybe<Scalars['String']['input']>;
     rating?: InputMaybe<Scalars['Float']['input']>;
     taxId?: InputMaybe<Scalars['String']['input']>;
@@ -5332,6 +5600,13 @@ export type UpdateInventoryItemInput = {
     safetyStock?: InputMaybe<Scalars['Int']['input']>;
     unitCost?: InputMaybe<Scalars['Float']['input']>;
 };
+/** Changes to the customer notification settings. Omitted fields keep their value. */
+export type UpdateMtwCustomerNotificationSettingsInput = {
+    emailEnabled?: InputMaybe<Scalars['Boolean']['input']>;
+    enabled?: InputMaybe<Scalars['Boolean']['input']>;
+    events?: InputMaybe<Array<MtwCustomerNotificationEvent>>;
+    smsEnabled?: InputMaybe<Scalars['Boolean']['input']>;
+};
 /**
  * Changes to the workspace's MoveTheWheels defaults. Omitted fields keep their
  * current value. `timezone: null` (or an empty string) clears the time zone so

package/dist/generated/wspace-operations.d.ts

@@ -1141,6 +1141,7 @@ export type GetMovethewheelsDemandForecastByLaneQuery = {
     demandForecastByLane: Array<{
         scopeType: Types.DemandForecastScope;
         scopeKey: string;
+        scopeLabel: string;
         periodStart: string;
         periodEnd: string;
         predictedVolume: number;
@@ -1157,6 +1158,7 @@ export type GetMovethewheelsDemandForecastByCustomerQuery = {
     demandForecastByCustomer: Array<{
         scopeType: Types.DemandForecastScope;
         scopeKey: string;
+        scopeLabel: string;
         periodStart: string;
         periodEnd: string;
         predictedVolume: number;
@@ -1174,6 +1176,7 @@ export type GetMovethewheelsDemandForecastVarianceQuery = {
     demandForecastVariance: Array<{
         scopeType: Types.DemandForecastScope;
         scopeKey: string;
+        scopeLabel: string;
         periodStart: string;
         periodEnd: string;
         predictedVolume: number;

package/dist/hooks/useCustomers.js

@@ -2,7 +2,7 @@ import { useMoveTheWheels as e } from "../providers/MoveTheWheelsProvider.js";
 import { executeGraphQL as t } from "../utils/graphqlClient.js";
 import { useCallback as n, useEffect as r, useMemo as i, useState as a } from "react";
 //#region src/movethewheels/hooks/useCustomers.ts
-var o = "\n  query ListCustomers($filter: CustomerFilterInput, $pagination: PaginationInput) {\n    customers(filter: $filter, pagination: $pagination) {\n      id\n      name\n      email\n      phone\n      type\n      company\n      address\n      businessLicense\n      taxId\n      rating\n      createdAt\n      updatedAt\n      deletedAt\n    }\n    customersCount(filter: $filter)\n  }\n", s = "\n  query GetCustomer($id: ID!) {\n    customer(id: $id) {\n      id\n      name\n      email\n      phone\n      type\n      company\n      address\n      businessLicense\n      taxId\n      rating\n      createdAt\n      updatedAt\n      deletedAt\n    }\n  }\n", c = "\n  mutation CreateCustomer($input: CreateCustomerInput!) {\n    createCustomer(input: $input) {\n      id\n      name\n      email\n      phone\n      type\n      company\n      address\n      businessLicense\n      taxId\n      rating\n      createdAt\n      updatedAt\n      deletedAt\n    }\n  }\n", l = "\n  mutation UpdateCustomer($id: ID!, $input: UpdateCustomerInput!) {\n    updateCustomer(id: $id, input: $input) {\n      id\n      name\n      email\n      phone\n      type\n      company\n      address\n      businessLicense\n      taxId\n      rating\n      createdAt\n      updatedAt\n      deletedAt\n    }\n  }\n", u = "\n  mutation DeleteCustomer($id: ID!) {\n    deleteCustomer(id: $id)\n  }\n";
+var o = "\n  query ListCustomers($filter: CustomerFilterInput, $pagination: PaginationInput) {\n    customers(filter: $filter, pagination: $pagination) {\n      id\n      name\n      email\n      phone\n      type\n      company\n      address\n      businessLicense\n      taxId\n      rating\n      notifyByEmail\n      notifyBySms\n      createdAt\n      updatedAt\n      deletedAt\n    }\n    customersCount(filter: $filter)\n  }\n", s = "\n  query GetCustomer($id: ID!) {\n    customer(id: $id) {\n      id\n      name\n      email\n      phone\n      type\n      company\n      address\n      businessLicense\n      taxId\n      rating\n      notifyByEmail\n      notifyBySms\n      createdAt\n      updatedAt\n      deletedAt\n    }\n  }\n", c = "\n  mutation CreateCustomer($input: CreateCustomerInput!) {\n    createCustomer(input: $input) {\n      id\n      name\n      email\n      phone\n      type\n      company\n      address\n      businessLicense\n      taxId\n      rating\n      notifyByEmail\n      notifyBySms\n      createdAt\n      updatedAt\n      deletedAt\n    }\n  }\n", l = "\n  mutation UpdateCustomer($id: ID!, $input: UpdateCustomerInput!) {\n    updateCustomer(id: $id, input: $input) {\n      id\n      name\n      email\n      phone\n      type\n      company\n      address\n      businessLicense\n      taxId\n      rating\n      notifyByEmail\n      notifyBySms\n      createdAt\n      updatedAt\n      deletedAt\n    }\n  }\n", u = "\n  mutation DeleteCustomer($id: ID!) {\n    deleteCustomer(id: $id)\n  }\n";
 function d(e) {
 	let t = e.address ?? {};
 	return {
@@ -16,6 +16,8 @@ function d(e) {
 		businessLicense: e.businessLicense ?? void 0,
 		taxId: e.taxId ?? void 0,
 		rating: e.rating ?? void 0,
+		notifyByEmail: e.notifyByEmail ?? !0,
+		notifyBySms: e.notifyBySms ?? !1,
 		createdAt: new Date(e.createdAt),
 		updatedAt: new Date(e.updatedAt)
 	};
@@ -120,7 +122,9 @@ function f(s = {}) {
 				address: e.address,
 				businessLicense: e.businessLicense,
 				taxId: e.taxId,
-				rating: e.rating
+				rating: e.rating,
+				notifyByEmail: e.notifyByEmail,
+				notifyBySms: e.notifyBySms
 			} })).createCustomer);
 			return C((e) => [n, ...e]), n;
 		}, [P]),
@@ -136,7 +140,9 @@ function f(s = {}) {
 					address: n.address,
 					businessLicense: n.businessLicense,
 					taxId: n.taxId,
-					rating: n.rating
+					rating: n.rating,
+					notifyByEmail: n.notifyByEmail,
+					notifyBySms: n.notifyBySms
 				}
 			})).updateCustomer);
 			return C((t) => t.map((t) => t.id === e ? r : t)), r;

package/dist/hooks/useDemandForecast.js

@@ -2,7 +2,7 @@ import { useMoveTheWheels as e } from "../providers/MoveTheWheelsProvider.js";
 import { executeGraphQL as t } from "../utils/graphqlClient.js";
 import { useCallback as n, useEffect as r, useMemo as i, useState as a } from "react";
 //#region src/movethewheels/hooks/useDemandForecast.ts
-var o = "\n  query GetMovethewheelsDemandForecast($weeks: Int!, $varianceLimit: Int!) {\n    demandForecastByLane(weeks: $weeks) {\n      scopeType\n      scopeKey\n      periodStart\n      periodEnd\n      predictedVolume\n      predictedRevenue\n      actualVolume\n      actualRevenue\n      confidence\n    }\n    demandForecastByCustomer(weeks: $weeks) {\n      scopeType\n      scopeKey\n      periodStart\n      periodEnd\n      predictedVolume\n      predictedRevenue\n      actualVolume\n      actualRevenue\n      confidence\n    }\n    laneVariance: demandForecastVariance(scopeType: LANE, limit: $varianceLimit) {\n      scopeType\n      scopeKey\n      periodStart\n      periodEnd\n      predictedVolume\n      actualVolume\n      volumeVariance\n      predictedRevenue\n      actualRevenue\n      revenueVariance\n    }\n    customerVariance: demandForecastVariance(scopeType: CUSTOMER, limit: $varianceLimit) {\n      scopeType\n      scopeKey\n      periodStart\n      periodEnd\n      predictedVolume\n      actualVolume\n      volumeVariance\n      predictedRevenue\n      actualRevenue\n      revenueVariance\n    }\n  }\n";
+var o = "\n  query GetMovethewheelsDemandForecast($weeks: Int!, $varianceLimit: Int!) {\n    demandForecastByLane(weeks: $weeks) {\n      scopeType\n      scopeKey\n      scopeLabel\n      periodStart\n      periodEnd\n      predictedVolume\n      predictedRevenue\n      actualVolume\n      actualRevenue\n      confidence\n    }\n    demandForecastByCustomer(weeks: $weeks) {\n      scopeType\n      scopeKey\n      scopeLabel\n      periodStart\n      periodEnd\n      predictedVolume\n      predictedRevenue\n      actualVolume\n      actualRevenue\n      confidence\n    }\n    laneVariance: demandForecastVariance(scopeType: LANE, limit: $varianceLimit) {\n      scopeType\n      scopeKey\n      scopeLabel\n      periodStart\n      periodEnd\n      predictedVolume\n      actualVolume\n      volumeVariance\n      predictedRevenue\n      actualRevenue\n      revenueVariance\n    }\n    customerVariance: demandForecastVariance(scopeType: CUSTOMER, limit: $varianceLimit) {\n      scopeType\n      scopeKey\n      scopeLabel\n      periodStart\n      periodEnd\n      predictedVolume\n      actualVolume\n      volumeVariance\n      predictedRevenue\n      actualRevenue\n      revenueVariance\n    }\n  }\n";
 function s(s = 4, c = 8) {
 	let { apiGatewayUrl: l, authToken: u, workspaceToken: d, workspaceId: f, tenantId: p, currentUser: m } = e(), [h, g] = a([]), [_, v] = a([]), [y, b] = a([]), [x, S] = a([]), [C, w] = a(!1), [T, E] = a(null), D = i(() => ({
 		apiGatewayUrl: l,

package/dist/movethewheels/components/CustomerDeliveryUpdatesFields.d.ts

@@ -0,0 +1,12 @@
+export interface DeliveryUpdatesValue {
+    notifyByEmail: boolean;
+    notifyBySms: boolean;
+}
+export declare function CustomerDeliveryUpdatesFields({ idPrefix, value, onChange, disabled, }: {
+    idPrefix: string;
+    value: DeliveryUpdatesValue;
+    onChange: (next: DeliveryUpdatesValue) => void;
+    disabled?: boolean;
+}): import('react').JSX.Element;
+/** "Email and SMS", "Email", "SMS" or "Off". */
+export declare function deliveryUpdatesSummary(value: DeliveryUpdatesValue): string;

package/dist/movethewheels/components/CustomerNotificationSettingsCard.d.ts

@@ -0,0 +1,3 @@
+export declare function CustomerNotificationSettingsCard({ readOnly }: {
+    readOnly: boolean;
+}): import('react').JSX.Element;

package/dist/movethewheels/hooks/useDemandForecast.d.ts

@@ -6,6 +6,8 @@
 export interface ForecastPoint {
     scopeType: 'LANE' | 'CUSTOMER';
     scopeKey: string;
+    /** Customer name or `Origin → Destination`; falls back to the key. */
+    scopeLabel: string;
     periodStart: string;
     periodEnd: string;
     predictedVolume: number;
@@ -17,6 +19,7 @@ export interface ForecastPoint {
 export interface ForecastVariance {
     scopeType: 'LANE' | 'CUSTOMER';
     scopeKey: string;
+    scopeLabel: string;
     periodStart: string;
     periodEnd: string;
     predictedVolume: number;

package/dist/movethewheels/types/index.d.ts

@@ -141,6 +141,10 @@ export interface Customer {
     businessLicense?: string;
     taxId?: string;
     rating?: number;
+    /** Delivery notifications by email (BOFF-4402). */
+    notifyByEmail: boolean;
+    /** Delivery notifications by SMS; needs a phone number with its country code. */
+    notifyBySms: boolean;
     createdAt: Date;
     updatedAt: Date;
 }

package/dist/movethewheels/utils/customerNotifications.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Customer delivery notifications — client side of wspace-movethewheels-svc's
+ * customer notification settings, history and previews (BOFF-4402).
+ *
+ * The service decides what to send and when; this module holds the GraphQL
+ * documents, the labels and the pure draft helpers the Settings page uses.
+ * Kept free of React so the contract can be unit-tested.
+ */
+export type MtwCustomerNotificationEvent = 'BOOKED' | 'PICKED_UP' | 'OUT_FOR_DELIVERY' | 'DELIVERED' | 'DELAYED' | 'FAILED';
+export type MtwCustomerNotificationChannel = 'EMAIL' | 'SMS';
+export type MtwCustomerNotificationStatus = 'PENDING' | 'SENT' | 'FAILED' | 'SKIPPED';
+export interface MtwCustomerNotificationSettings {
+    workspaceId: string;
+    enabled: boolean;
+    enabledAt: string | null;
+    emailEnabled: boolean;
+    smsEnabled: boolean;
+    events: MtwCustomerNotificationEvent[];
+    isCustomized: boolean;
+    updatedAt: string | null;
+    updatedBy: string | null;
+}
+export type MtwCustomerNotificationSettingsInput = Partial<Pick<MtwCustomerNotificationSettings, 'enabled' | 'emailEnabled' | 'smsEnabled' | 'events'>>;
+export interface MtwCustomerNotification {
+    id: string;
+    shipmentId: string;
+    shipmentNumber: string | null;
+    customerId: string | null;
+    event: MtwCustomerNotificationEvent;
+    channel: MtwCustomerNotificationChannel;
+    status: MtwCustomerNotificationStatus;
+    recipient: string | null;
+    subject: string | null;
+    attempts: number;
+    lastError: string | null;
+    sentAt: string | null;
+    createdAt: string;
+}
+export interface MtwCustomerNotificationPreview {
+    event: MtwCustomerNotificationEvent;
+    subject: string;
+    emailText: string;
+    smsText: string;
+}
+/** Every event, in the order a shipment reaches them. */
+export declare const CUSTOMER_NOTIFICATION_EVENTS: ReadonlyArray<{
+    value: MtwCustomerNotificationEvent;
+    label: string;
+    description: string;
+}>;
+export declare function eventLabel(event: MtwCustomerNotificationEvent): string;
+export declare const STATUS_LABELS: Record<MtwCustomerNotificationStatus, string>;
+/** Off, email only, every event — what a workspace sees until it saves. */
+export declare function defaultNotificationSettings(workspaceId?: string): MtwCustomerNotificationSettings;
+/** Events in canonical order without duplicates. */
+export declare function orderedEvents(events: readonly MtwCustomerNotificationEvent[]): MtwCustomerNotificationEvent[];
+/** Add or remove one event from a selection. */
+export declare function toggleEvent(events: readonly MtwCustomerNotificationEvent[], event: MtwCustomerNotificationEvent, on: boolean): MtwCustomerNotificationEvent[];
+/** Only the fields the draft changed, ready for the update mutation. */
+export declare function changedNotificationSettings(saved: MtwCustomerNotificationSettings, draft: Pick<MtwCustomerNotificationSettings, 'enabled' | 'emailEnabled' | 'smsEnabled' | 'events'>): MtwCustomerNotificationSettingsInput;
+/** Why the draft cannot be saved, or null. Switching on needs a channel and an event. */
+export declare function notificationDraftError(draft: Pick<MtwCustomerNotificationSettings, 'enabled' | 'emailEnabled' | 'smsEnabled' | 'events'>): string | null;
+export declare const MTW_CUSTOMER_NOTIFICATION_SETTINGS_QUERY = "\n  query MtwCustomerNotificationSettings {\n    mtwCustomerNotificationSettings {\n  workspaceId\n  enabled\n  enabledAt\n  emailEnabled\n  smsEnabled\n  events\n  isCustomized\n  updatedAt\n  updatedBy\n}\n  }\n";
+export declare const UPDATE_MTW_CUSTOMER_NOTIFICATION_SETTINGS_MUTATION = "\n  mutation UpdateMtwCustomerNotificationSettings($input: UpdateMtwCustomerNotificationSettingsInput!) {\n    updateMtwCustomerNotificationSettings(input: $input) {\n  workspaceId\n  enabled\n  enabledAt\n  emailEnabled\n  smsEnabled\n  events\n  isCustomized\n  updatedAt\n  updatedBy\n}\n  }\n";
+export declare const MTW_CUSTOMER_NOTIFICATIONS_QUERY = "\n  query MtwCustomerNotifications(\n    $filter: MtwCustomerNotificationFilterInput\n    $pagination: PaginationInput\n  ) {\n    mtwCustomerNotifications(filter: $filter, pagination: $pagination) {\n      total\n      hasMore\n      items {\n        id\n        shipmentId\n        shipmentNumber\n        customerId\n        event\n        channel\n        status\n        recipient\n        subject\n        attempts\n        lastError\n        sentAt\n        createdAt\n      }\n    }\n  }\n";
+export declare const MTW_CUSTOMER_NOTIFICATION_PREVIEWS_QUERY = "\n  query MtwCustomerNotificationPreviews {\n    mtwCustomerNotificationPreviews {\n      event\n      subject\n      emailText\n      smsText\n    }\n  }\n";

package/dist/node_modules/lucide-react/dist/esm/icons/bell-ring.js

@@ -0,0 +1,22 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/bell-ring.js
+var t = e("BellRing", [
+	["path", {
+		d: "M10.268 21a2 2 0 0 0 3.464 0",
+		key: "vwvbt9"
+	}],
+	["path", {
+		d: "M22 8c0-2.3-.8-4.3-2-6",
+		key: "5bb3ad"
+	}],
+	["path", {
+		d: "M3.262 15.326A1 1 0 0 0 4 17h16a1 1 0 0 0 .74-1.673C19.41 13.956 18 12.499 18 8A6 6 0 0 0 6 8c0 4.499-1.411 5.956-2.738 7.326",
+		key: "11g9vi"
+	}],
+	["path", {
+		d: "M4 2C2.8 3.7 2 5.7 2 8",
+		key: "tap9e0"
+	}]
+]);
+//#endregion
+export { t as BellRing };