@burdenoff/microfe-movethewheels 2026.1101.4 → 2026.1102.1

package/dist/utils/customerNotifications.js

@@ -0,0 +1,83 @@
+//#region src/movethewheels/utils/customerNotifications.ts
+var e = [
+	{
+		value: "BOOKED",
+		label: "Booked",
+		description: "A shipment is created for the customer"
+	},
+	{
+		value: "PICKED_UP",
+		label: "Picked up",
+		description: "The shipment is collected"
+	},
+	{
+		value: "OUT_FOR_DELIVERY",
+		label: "Out for delivery",
+		description: "Tracking says the shipment is on its last leg"
+	},
+	{
+		value: "DELIVERED",
+		label: "Delivered",
+		description: "The shipment is delivered"
+	},
+	{
+		value: "DELAYED",
+		label: "Running late",
+		description: "The risk monitor expects it to miss the promised delivery (once per promise)"
+	},
+	{
+		value: "FAILED",
+		label: "Delivery failed",
+		description: "Delivery could not be completed"
+	}
+];
+function t(t) {
+	return e.find((e) => e.value === t)?.label ?? t;
+}
+var n = {
+	PENDING: "Sending",
+	SENT: "Sent",
+	FAILED: "Failed",
+	SKIPPED: "Not sent"
+};
+function r(t = "") {
+	return {
+		workspaceId: t,
+		enabled: !1,
+		enabledAt: null,
+		emailEnabled: !0,
+		smsEnabled: !1,
+		events: e.map((e) => e.value),
+		isCustomized: !1,
+		updatedAt: null,
+		updatedBy: null
+	};
+}
+function i(t) {
+	let n = new Set(t);
+	return e.map((e) => e.value).filter((e) => n.has(e));
+}
+function a(e, t, n) {
+	let r = new Set(e);
+	return n ? r.add(t) : r.delete(t), i([...r]);
+}
+function o(e, t) {
+	let n = {};
+	t.enabled !== e.enabled && (n.enabled = t.enabled), t.emailEnabled !== e.emailEnabled && (n.emailEnabled = t.emailEnabled), t.smsEnabled !== e.smsEnabled && (n.smsEnabled = t.smsEnabled);
+	let r = i(t.events), a = i(e.events);
+	return r.join(",") !== a.join(",") && (n.events = r), n;
+}
+function s(e) {
+	return e.enabled ? !e.emailEnabled && !e.smsEnabled ? "Choose email, SMS or both." : e.events.length === 0 ? "Choose at least one event to notify customers about." : null : null;
+}
+var c = "\n  workspaceId\n  enabled\n  enabledAt\n  emailEnabled\n  smsEnabled\n  events\n  isCustomized\n  updatedAt\n  updatedBy\n", l = `
+  query MtwCustomerNotificationSettings {
+    mtwCustomerNotificationSettings {${c}}
+  }
+`, u = `
+  mutation UpdateMtwCustomerNotificationSettings($input: UpdateMtwCustomerNotificationSettingsInput!) {
+    updateMtwCustomerNotificationSettings(input: $input) {${c}}
+  }
+`, d = "\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", f = "\n  query MtwCustomerNotificationPreviews {\n    mtwCustomerNotificationPreviews {\n      event\n      subject\n      emailText\n      smsText\n    }\n  }\n";
+//#endregion
+export { e as CUSTOMER_NOTIFICATION_EVENTS, d as MTW_CUSTOMER_NOTIFICATIONS_QUERY, f as MTW_CUSTOMER_NOTIFICATION_PREVIEWS_QUERY, l as MTW_CUSTOMER_NOTIFICATION_SETTINGS_QUERY, n as STATUS_LABELS, u as UPDATE_MTW_CUSTOMER_NOTIFICATION_SETTINGS_MUTATION, o as changedNotificationSettings, r as defaultNotificationSettings, t as eventLabel, s as notificationDraftError, a as toggleEvent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/microfe-movethewheels",
-  "version": "2026.1101.4",
+  "version": "2026.1102.1",
   "description": "Burdenoff MoveTheWheels Microfrontend - Logistics & Supply Chain Management Platform",
   "type": "module",
   "files": [
@@ -37,7 +37,7 @@
     "format": "prettier --write \"src/**/*.{ts,tsx}\"",
     "type:check": "bash scripts/build-limits.sh tsc --noEmit",
     "validate:schema-drift": "graphql-schema-drift",
-    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run codegen && bun run validate:schema-drift && bun run lint:sanity && bun run format && bun run type:check && bun run verify:live-logistics-contract && bun run verify:empty-reuse-retry && bun run verify:empty-reuse-recovery && bun run verify:trip-utilization-input && bun run verify:trip-draft-context && bun run verify:stock-binding-input && bun run verify:stock-observation-input && bun run verify:pending-pick-input && bun run verify:pick-review-ack && bun run verify:driver-license-expiry && bun run verify:tracking-alerts && bun run verify:freight-input && bun run verify:freight-recovery && bun run verify:freight-commercial && bun run verify:freight-invoice && bun run verify:procedure-input && bun run verify:consolidation && bun run verify:multimodal-single-attempt && bun run verify:workspace-predispatch && bun run verify:tracking-quality-outcomes && bun run verify:shipment-status-authority && bun run verify:free-time-permissions && bun run verify:core-codegen && bun run verify:order-vehicle-hold && bun run verify:pallet-preview && bun run verify:entity-export && bun run verify:entity-import && bun run verify:module-settings && bun run verify:carrier-integrations && bun run verify:driver-day && bun run verify:consumed-fuel-preview && bun run build && bun run build-storybook'",
+    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run codegen && bun run validate:schema-drift && bun run lint:sanity && bun run format && bun run type:check && bun run verify:live-logistics-contract && bun run verify:empty-reuse-retry && bun run verify:empty-reuse-recovery && bun run verify:trip-utilization-input && bun run verify:trip-draft-context && bun run verify:stock-binding-input && bun run verify:stock-observation-input && bun run verify:pending-pick-input && bun run verify:pick-review-ack && bun run verify:driver-license-expiry && bun run verify:tracking-alerts && bun run verify:freight-input && bun run verify:freight-recovery && bun run verify:freight-commercial && bun run verify:freight-invoice && bun run verify:procedure-input && bun run verify:consolidation && bun run verify:multimodal-single-attempt && bun run verify:workspace-predispatch && bun run verify:tracking-quality-outcomes && bun run verify:shipment-status-authority && bun run verify:free-time-permissions && bun run verify:core-codegen && bun run verify:order-vehicle-hold && bun run verify:pallet-preview && bun run verify:entity-export && bun run verify:entity-import && bun run verify:module-settings && bun run verify:carrier-integrations && bun run verify:driver-day && bun run verify:customer-notifications && bun run verify:consumed-fuel-preview && bun run build && bun run build-storybook'",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build",
     "test:storybook": "vitest run --project=storybook",
@@ -77,6 +77,7 @@
     "verify:module-settings": "bun test scripts/check-module-settings.test.ts",
     "verify:driver-day": "bun test scripts/verify-driver-day.test.ts && bun scripts/verify-acknowledged-pending-delivery.mjs",
     "verify:carrier-integrations": "bun test scripts/check-carrier-integrations.test.ts",
+    "verify:customer-notifications": "bun test scripts/check-customer-notifications.test.ts",
     "verify:pallet-preview": "bun test scripts/check-pallet-preview.test.ts && bun scripts/verify-pallet-preview-hook.mjs",
     "verify:consumed-fuel-preview": "bun test scripts/check-consumed-fuel-preview.test.ts && bun scripts/verify-consumed-fuel-preview-hook.mjs && bun scripts/verify-consumed-fuel-preview-component.mjs"
   },

package/src/generated/tracking-quality-operations.ts

@@ -128,6 +128,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']>;
@@ -1115,6 +1117,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']>;
@@ -1125,6 +1131,101 @@ export type MtwCustomer = {
   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. */
@@ -3562,6 +3663,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'];
@@ -3583,6 +3687,42 @@ export type MtwRiskLevel =
   | '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'
@@ -3612,6 +3752,51 @@ export type MtwRiskSignalCode =
   | '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']>;
@@ -3650,6 +3835,16 @@ export type MtwRouteStats = {
   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'
@@ -3871,6 +4066,40 @@ export type MtwShipmentLeg = {
   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'];
@@ -4254,6 +4483,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']>;
@@ -4652,6 +4883,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;
@@ -4697,6 +4946,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;
@@ -4947,6 +5198,16 @@ export type MutationImportMtwWarehousesArgs = {
 };
 
 
+export type MutationMtwNarrateShipmentRiskForecastArgs = {
+  shipmentId: Scalars['ID']['input'];
+};
+
+
+export type MutationMtwRunRiskSweepArgs = {
+  input?: InputMaybe<MtwRunRiskSweepInput>;
+};
+
+
 export type MutationOpenMtwContainerCycleArgs = {
   input: OpenMtwContainerCycleInput;
 };
@@ -5182,6 +5443,11 @@ export type MutationUpdateInventoryItemArgs = {
 };
 
 
+export type MutationUpdateMtwCustomerNotificationSettingsArgs = {
+  input: UpdateMtwCustomerNotificationSettingsInput;
+};
+
+
 export type MutationUpdateMtwModuleSettingsArgs = {
   input: UpdateMtwModuleSettingsInput;
 };
@@ -5400,6 +5666,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;
@@ -5439,6 +5711,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;
@@ -5773,6 +6051,12 @@ export type QueryMtwContainersArgs = {
 };
 
 
+export type QueryMtwCustomerNotificationsArgs = {
+  filter?: InputMaybe<MtwCustomerNotificationFilterInput>;
+  pagination?: InputMaybe<PaginationInput>;
+};
+
+
 export type QueryMtwEmptyReturnInstructionArgs = {
   id: Scalars['ID']['input'];
 };
@@ -5940,6 +6224,16 @@ export type QueryMtwReuseReservationTransitionPageArgs = {
 };
 
 
+export type QueryMtwRiskSweepsArgs = {
+  pagination?: InputMaybe<PaginationInput>;
+};
+
+
+export type QueryMtwShipmentRiskEpisodeArgs = {
+  shipmentId: Scalars['ID']['input'];
+};
+
+
 export type QueryMtwShipmentRiskForecastArgs = {
   shipmentId: Scalars['ID']['input'];
 };
@@ -6617,6 +6911,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']>;
@@ -6695,6 +6991,14 @@ export type UpdateInventoryItemInput = {
   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/src/movethewheels/components/CustomerDeliveryUpdatesFields.tsx

@@ -0,0 +1,67 @@
+/**
+ * A customer's delivery notification preferences (BOFF-4402): whether they
+ * get shipment updates by email and by SMS. Used by the new and edit customer
+ * forms. The workspace must also switch customer notifications on in Settings.
+ */
+import { Checkbox, Label } from './ui';
+
+export interface DeliveryUpdatesValue {
+  notifyByEmail: boolean;
+  notifyBySms: boolean;
+}
+
+export function CustomerDeliveryUpdatesFields({
+  idPrefix,
+  value,
+  onChange,
+  disabled,
+}: {
+  idPrefix: string;
+  value: DeliveryUpdatesValue;
+  onChange: (next: DeliveryUpdatesValue) => void;
+  disabled?: boolean;
+}) {
+  return (
+    <fieldset
+      className="space-y-3"
+      disabled={disabled}
+      data-testid={`${idPrefix}-delivery-updates`}
+    >
+      <legend className="text-sm font-medium text-text-primary">Delivery updates</legend>
+      <div className="flex items-start gap-2">
+        <Checkbox
+          id={`${idPrefix}-notify-email`}
+          checked={value.notifyByEmail}
+          disabled={disabled}
+          onCheckedChange={(checked) => onChange({ ...value, notifyByEmail: checked === true })}
+        />
+        <Label htmlFor={`${idPrefix}-notify-email`} className="text-sm font-normal leading-snug">
+          Email this customer about their shipments
+        </Label>
+      </div>
+      <div className="flex items-start gap-2">
+        <Checkbox
+          id={`${idPrefix}-notify-sms`}
+          checked={value.notifyBySms}
+          disabled={disabled}
+          onCheckedChange={(checked) => onChange({ ...value, notifyBySms: checked === true })}
+        />
+        <Label htmlFor={`${idPrefix}-notify-sms`} className="text-sm font-normal leading-snug">
+          Text this customer about their shipments (only with their consent; the phone number needs
+          its country code, e.g. +91…)
+        </Label>
+      </div>
+      <p className="text-xs text-text-secondary">
+        Sent only while customer delivery notifications are on in Settings.
+      </p>
+    </fieldset>
+  );
+}
+
+/** "Email and SMS", "Email", "SMS" or "Off". */
+export function deliveryUpdatesSummary(value: DeliveryUpdatesValue): string {
+  if (value.notifyByEmail && value.notifyBySms) return 'Email and SMS';
+  if (value.notifyByEmail) return 'Email';
+  if (value.notifyBySms) return 'SMS';
+  return 'Off';
+}