@burdenoff/microfe-movethewheels 2026.1031.1 → 2026.1031.3

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

@@ -0,0 +1,109 @@
+/**
+ * Entity import — client side of wspace-movethewheels-svc's bulk import (BOFF-3990).
+ *
+ * The service owns parsing and validation; this module only picks the right
+ * mutation for an entity, detects the file format, builds CSV templates from
+ * the server's column specification and shapes the result for display.
+ * Kept free of React so the contract can be unit-tested.
+ */
+export declare const MTW_IMPORT_ENTITIES: readonly [{
+    readonly entityType: "CUSTOMER";
+    readonly label: "Customers";
+    readonly noun: "customer";
+    readonly field: "importMtwCustomers";
+}, {
+    readonly entityType: "VEHICLE";
+    readonly label: "Vehicles";
+    readonly noun: "vehicle";
+    readonly field: "importMtwVehicles";
+}, {
+    readonly entityType: "DRIVER";
+    readonly label: "Drivers";
+    readonly noun: "driver";
+    readonly field: "importMtwDrivers";
+}, {
+    readonly entityType: "WAREHOUSE";
+    readonly label: "Warehouses";
+    readonly noun: "warehouse";
+    readonly field: "importMtwWarehouses";
+}, {
+    readonly entityType: "CARGO_ITEM";
+    readonly label: "Products";
+    readonly noun: "product";
+    readonly field: "importMtwCargoItems";
+}];
+export type MtwImportEntityType = (typeof MTW_IMPORT_ENTITIES)[number]['entityType'];
+export type MtwImportFormat = 'CSV' | 'JSON';
+export type MtwImportStatus = 'DRY_RUN' | 'COMPLETED' | 'PARTIAL' | 'REJECTED';
+/** Mirrors the service limits so an oversized file is refused before upload. */
+export declare const MTW_IMPORT_MAX_BYTES: number;
+export declare const MTW_IMPORT_MAX_ROWS = 1000;
+export declare function isImportEntityType(value: string | null | undefined): value is MtwImportEntityType;
+export declare function importEntity(entityType: MtwImportEntityType): {
+    readonly entityType: "CUSTOMER";
+    readonly label: "Customers";
+    readonly noun: "customer";
+    readonly field: "importMtwCustomers";
+} | {
+    readonly entityType: "VEHICLE";
+    readonly label: "Vehicles";
+    readonly noun: "vehicle";
+    readonly field: "importMtwVehicles";
+} | {
+    readonly entityType: "DRIVER";
+    readonly label: "Drivers";
+    readonly noun: "driver";
+    readonly field: "importMtwDrivers";
+} | {
+    readonly entityType: "WAREHOUSE";
+    readonly label: "Warehouses";
+    readonly noun: "warehouse";
+    readonly field: "importMtwWarehouses";
+} | {
+    readonly entityType: "CARGO_ITEM";
+    readonly label: "Products";
+    readonly noun: "product";
+    readonly field: "importMtwCargoItems";
+};
+export declare const IMPORT_MUTATIONS: Record<MtwImportEntityType, string>;
+/** The mutation document for one entity's import. */
+export declare function importMutation(entityType: MtwImportEntityType): string;
+export declare const MTW_IMPORT_SPEC_QUERY = "\n  query MtwImportSpec {\n    mtwImportSpec {\n      entityType\n      keyColumn\n      columns {\n        name\n        type\n        required\n        description\n        allowedValues\n        maxLength\n        min\n        max\n      }\n    }\n  }\n";
+export interface MtwImportColumn {
+    name: string;
+    type: string;
+    required: boolean;
+    description: string;
+    allowedValues: string[] | null;
+    maxLength: number | null;
+    min: number | null;
+    max: number | null;
+}
+export interface MtwImportEntitySpec {
+    entityType: MtwImportEntityType;
+    keyColumn: string | null;
+    columns: MtwImportColumn[];
+}
+export interface MtwImportRowError {
+    row: number;
+    field: string | null;
+    message: string;
+}
+export interface MtwImportResult {
+    entityType: MtwImportEntityType;
+    status: MtwImportStatus;
+    dryRun: boolean;
+    totalRows: number;
+    validRows: number;
+    importedRows: number;
+    failedRows: number;
+    createdIds: string[];
+    errorsTruncated: boolean;
+    errors: MtwImportRowError[];
+}
+/** Picks the format from the file name, falling back to the MIME type. */
+export declare function detectImportFormat(fileName: string, mimeType?: string): MtwImportFormat | null;
+/** A CSV template: the header row, required columns first, then optional ones. */
+export declare function buildCsvTemplate(spec: MtwImportEntitySpec): string;
+/** One-line summary of an import result for the status banner. */
+export declare function summariseImport(result: MtwImportResult, noun: string): string;

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

@@ -0,0 +1,36 @@
+import { TrackingAlert, TrackingAlertSeverity } from '../types';
+export type RiskSignalCode = 'LEG_SLIP' | 'OPEN_LEG_OVERDUE' | 'ROUTE_DURATION_OVERRUN' | 'EXCESS_DWELL' | 'TRACKING_STALE' | 'VEHICLE_UNAVAILABLE' | 'CARRIER_LATE_HISTORY';
+export type TrackingAlertKind = 'DELAYED' | 'AT_RISK';
+export interface ApiTrackingAlert {
+    id: string;
+    shipmentId: string;
+    shipmentNumber: string;
+    alertType: string;
+    message: string;
+    riskScore?: number | null;
+    promisedDelivery?: string | null;
+    predictedDelivery?: string | null;
+    signals?: RiskSignalCode[] | null;
+    acknowledged: boolean;
+    acknowledgedAt?: string | null;
+}
+/** Risk score at or above which an AT_RISK alert is shown as high severity (matches the backend HIGH level). */
+export declare const HIGH_RISK_SCORE = 70;
+/**
+ * DELAYED is always high: the promise is already broken. AT_RISK follows the
+ * forecast's risk score; the backend only raises AT_RISK at MEDIUM or above,
+ * so anything below the HIGH band is medium.
+ */
+export declare function trackingAlertSeverity(alertType: string, riskScore: number | null | undefined): TrackingAlertSeverity;
+export declare function mapTrackingAlert(alert: ApiTrackingAlert): TrackingAlert;
+export declare function sortTrackingAlerts(alerts: TrackingAlert[]): TrackingAlert[];
+/** Translation key + English fallback for each risk signal code. */
+export declare const RISK_SIGNAL_LABELS: Record<RiskSignalCode, {
+    key: string;
+    fallback: string;
+}>;
+export declare function riskSignalLabel(code: string, t: (key: string, fallback: string) => string): string;
+/** Minutes between the promise and the predicted delivery, or null when unknown / not late. */
+export declare function predictedSlipMinutes(alert: Pick<TrackingAlert, 'promisedDelivery' | 'predictedDelivery'>): number | null;
+/** "45 min", "3 h 20 min", "2 d 4 h" — compact duration for alert cards. */
+export declare function formatSlip(minutes: number): string;

package/dist/node_modules/lucide-react/dist/esm/icons/arrow-down-up.js

@@ -0,0 +1,22 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/arrow-down-up.js
+var t = e("ArrowDownUp", [
+	["path", {
+		d: "m3 16 4 4 4-4",
+		key: "1co6wj"
+	}],
+	["path", {
+		d: "M7 20V4",
+		key: "1yoxec"
+	}],
+	["path", {
+		d: "m21 8-4-4-4 4",
+		key: "1c9v7m"
+	}],
+	["path", {
+		d: "M17 4v16",
+		key: "7dpous"
+	}]
+]);
+//#endregion
+export { t as ArrowDownUp };

package/dist/node_modules/lucide-react/dist/esm/icons/file-spreadsheet.js

@@ -0,0 +1,30 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/file-spreadsheet.js
+var t = e("FileSpreadsheet", [
+	["path", {
+		d: "M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z",
+		key: "1rqfz7"
+	}],
+	["path", {
+		d: "M14 2v4a2 2 0 0 0 2 2h4",
+		key: "tnqrlb"
+	}],
+	["path", {
+		d: "M8 13h2",
+		key: "yr2amv"
+	}],
+	["path", {
+		d: "M14 13h2",
+		key: "un5t4a"
+	}],
+	["path", {
+		d: "M8 17h2",
+		key: "2yhykz"
+	}],
+	["path", {
+		d: "M14 17h2",
+		key: "10kma7"
+	}]
+]);
+//#endregion
+export { t as FileSpreadsheet };

package/dist/node_modules/lucide-react/dist/esm/icons/file-up.js

@@ -0,0 +1,22 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/file-up.js
+var t = e("FileUp", [
+	["path", {
+		d: "M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z",
+		key: "1rqfz7"
+	}],
+	["path", {
+		d: "M14 2v4a2 2 0 0 0 2 2h4",
+		key: "tnqrlb"
+	}],
+	["path", {
+		d: "M12 12v6",
+		key: "3ahymv"
+	}],
+	["path", {
+		d: "m15 15-3-3-3 3",
+		key: "15xj92"
+	}]
+]);
+//#endregion
+export { t as FileUp };

package/dist/pages/CustomersPage.js

@@ -3,97 +3,106 @@ import { Download as t } from "../node_modules/lucide-react/dist/esm/icons/downl
 import { Plus as n } from "../node_modules/lucide-react/dist/esm/icons/plus.js";
 import { RefreshCw as r } from "../node_modules/lucide-react/dist/esm/icons/refresh-cw.js";
 import { Star as i } from "../node_modules/lucide-react/dist/esm/icons/star.js";
-import { Users as a } from "../node_modules/lucide-react/dist/esm/icons/users.js";
-import { joinPath as o } from "../utils/navigation.js";
-import { useMoveTheWheels as s } from "../providers/MoveTheWheelsProvider.js";
-import { useCustomerStats as c, useCustomers as l } from "../hooks/useCustomers.js";
-import { Avatar as u, AvatarFallback as d, Button as f } from "../components/ui.js";
-import { PageLayout as p } from "../components/PageLayout.js";
-import { MetricCard as m, MetricGrid as h } from "../components/MetricCard.js";
-import { TypeBadge as g } from "../components/StatusBadge.js";
-import { DataTable as _ } from "../components/DataTable.js";
-import { formatDate as v } from "../utils/formatters.js";
-import { useDebouncedValue as y } from "../hooks/useDebouncedValue.js";
-import { useEntityExport as b } from "../hooks/useEntityExport.js";
-import { ExportStatusBanner as x } from "../components/ExportStatusBanner.js";
-import { useState as S } from "react";
-import { jsx as C, jsxs as w } from "react/jsx-runtime";
-import { CTAOverflowMenu as T, PagePurpose as E } from "@burdenoff/fe-libs/ui";
+import { Upload as a } from "../node_modules/lucide-react/dist/esm/icons/upload.js";
+import { Users as o } from "../node_modules/lucide-react/dist/esm/icons/users.js";
+import { joinPath as s } from "../utils/navigation.js";
+import { useMoveTheWheels as c } from "../providers/MoveTheWheelsProvider.js";
+import { useCustomerStats as l, useCustomers as u } from "../hooks/useCustomers.js";
+import { Avatar as d, AvatarFallback as f, Button as p } from "../components/ui.js";
+import { PageLayout as m } from "../components/PageLayout.js";
+import { MetricCard as h, MetricGrid as g } from "../components/MetricCard.js";
+import { TypeBadge as _ } from "../components/StatusBadge.js";
+import { DataTable as v } from "../components/DataTable.js";
+import { formatDate as y } from "../utils/formatters.js";
+import { useDebouncedValue as b } from "../hooks/useDebouncedValue.js";
+import { useEntityExport as x } from "../hooks/useEntityExport.js";
+import { ExportStatusBanner as S } from "../components/ExportStatusBanner.js";
+import { useState as C } from "react";
+import { jsx as w, jsxs as T } from "react/jsx-runtime";
+import { CTAOverflowMenu as E, PagePurpose as D } from "@burdenoff/fe-libs/ui";
 //#region src/movethewheels/pages/CustomersPage.tsx
-function D() {
-	let { basePath: D, navigate: O } = s(), { state: k, isExporting: A, startExport: j, dismiss: M } = b("customers", "customer"), [N, P] = S(0), [F, I] = S(25), [L, R] = S(""), z = y(L), { customers: B, totalCustomers: V, hasMore: H, isLoading: U, error: W, refetch: G } = l({
-		limit: F,
-		offset: N * F,
-		filters: { search: z }
-	}), { stats: K } = c(), q = (e) => O?.(o(D, e));
-	return /* @__PURE__ */ w(p, {
+function O() {
+	let { basePath: O, navigate: k } = c(), { state: A, isExporting: j, startExport: M, dismiss: N } = x("customers", "customer"), [P, F] = C(0), [I, L] = C(25), [R, z] = C(""), B = b(R), { customers: V, totalCustomers: H, hasMore: U, isLoading: W, error: G, refetch: K } = u({
+		limit: I,
+		offset: P * I,
+		filters: { search: B }
+	}), { stats: q } = l(), J = (e) => k?.(s(O, e));
+	return /* @__PURE__ */ T(m, {
 		title: "Customers",
-		subtitle: `${K.total} customers`,
-		icon: /* @__PURE__ */ C(a, { size: 24 }),
-		headerActions: /* @__PURE__ */ C(T, {
+		subtitle: `${q.total} customers`,
+		icon: /* @__PURE__ */ w(o, { size: 24 }),
+		headerActions: /* @__PURE__ */ w(E, {
 			primary: {
 				label: "Add Customer",
-				icon: /* @__PURE__ */ C(n, { size: 16 }),
-				onSelect: () => q("customers/new")
+				icon: /* @__PURE__ */ w(n, { size: 16 }),
+				onSelect: () => J("customers/new")
 			},
-			actions: [{
-				label: "Refresh",
-				icon: /* @__PURE__ */ C(r, { size: 16 }),
-				onSelect: () => G()
-			}, {
-				label: A ? "Exporting…" : "Export",
-				icon: /* @__PURE__ */ C(t, { size: 16 }),
-				onSelect: j
-			}]
+			actions: [
+				{
+					label: "Refresh",
+					icon: /* @__PURE__ */ w(r, { size: 16 }),
+					onSelect: () => K()
+				},
+				{
+					label: "Import",
+					icon: /* @__PURE__ */ w(a, { size: 16 }),
+					onSelect: () => J("import-export?entity=CUSTOMER")
+				},
+				{
+					label: j ? "Exporting…" : "Export",
+					icon: /* @__PURE__ */ w(t, { size: 16 }),
+					onSelect: M
+				}
+			]
 		}),
 		children: [
-			/* @__PURE__ */ C(E, {
-				icon: /* @__PURE__ */ C(a, { size: 18 }),
+			/* @__PURE__ */ w(D, {
+				icon: /* @__PURE__ */ w(o, { size: 18 }),
 				children: "The businesses and individuals you deliver for. Keep contact details, locations and satisfaction ratings here, and open a customer to see their order history before booking the next shipment."
 			}),
-			/* @__PURE__ */ C(x, {
-				state: k,
-				onDismiss: M
+			/* @__PURE__ */ w(S, {
+				state: A,
+				onDismiss: N
 			}),
-			/* @__PURE__ */ w("div", { children: [/* @__PURE__ */ C("p", {
+			/* @__PURE__ */ T("div", { children: [/* @__PURE__ */ w("p", {
 				className: "mb-3 text-sm font-medium text-text-secondary",
 				children: "Customer base at a glance"
-			}), /* @__PURE__ */ w(h, {
+			}), /* @__PURE__ */ T(g, {
 				columns: 3,
 				children: [
-					/* @__PURE__ */ C(m, {
+					/* @__PURE__ */ w(h, {
 						label: "Total customers",
-						value: K.total,
-						icon: /* @__PURE__ */ C(a, { size: 20 }),
+						value: q.total,
+						icon: /* @__PURE__ */ w(o, { size: 20 }),
 						accent: "brand"
 					}),
-					/* @__PURE__ */ C(m, {
+					/* @__PURE__ */ w(h, {
 						label: "Avg. rating",
-						value: K.avgRating > 0 ? K.avgRating.toFixed(1) : "—",
-						icon: /* @__PURE__ */ C(i, { size: 20 }),
+						value: q.avgRating > 0 ? q.avgRating.toFixed(1) : "—",
+						icon: /* @__PURE__ */ w(i, { size: 20 }),
 						accent: "success",
 						subtitle: "Across all customers"
 					}),
-					/* @__PURE__ */ C(m, {
+					/* @__PURE__ */ w(h, {
 						label: "Business accounts",
-						value: K.b2b,
-						icon: /* @__PURE__ */ C(e, { size: 20 }),
+						value: q.b2b,
+						icon: /* @__PURE__ */ w(e, { size: 20 }),
 						accent: "blue",
 						subtitle: "B2B relationships"
 					})
 				]
 			})] }),
-			/* @__PURE__ */ C(_, {
+			/* @__PURE__ */ w(v, {
 				columns: [
 					{
 						id: "customer",
 						header: "Customer",
-						cell: (e) => /* @__PURE__ */ w("div", {
+						cell: (e) => /* @__PURE__ */ T("div", {
 							className: "flex items-center gap-3",
-							children: [/* @__PURE__ */ C(u, { children: /* @__PURE__ */ C(d, { children: e.name.split(" ").map((e) => e[0]).join("") }) }), /* @__PURE__ */ w("div", { children: [/* @__PURE__ */ C("p", {
+							children: [/* @__PURE__ */ w(d, { children: /* @__PURE__ */ w(f, { children: e.name.split(" ").map((e) => e[0]).join("") }) }), /* @__PURE__ */ T("div", { children: [/* @__PURE__ */ w("p", {
 								className: "font-medium",
 								children: e.name
-							}), /* @__PURE__ */ C("p", {
+							}), /* @__PURE__ */ w("p", {
 								className: "text-sm text-text-secondary",
 								children: e.email
 							})] })]
@@ -103,7 +112,7 @@ function D() {
 						id: "type",
 						header: "Type",
 						accessorKey: "type",
-						cell: (e) => /* @__PURE__ */ C(g, { type: e.type })
+						cell: (e) => /* @__PURE__ */ w(_, { type: e.type })
 					},
 					{
 						id: "company",
@@ -124,12 +133,12 @@ function D() {
 					{
 						id: "rating",
 						header: "Rating",
-						cell: (e) => /* @__PURE__ */ w("div", {
+						cell: (e) => /* @__PURE__ */ T("div", {
 							className: "flex items-center gap-1",
-							children: [/* @__PURE__ */ C(i, {
+							children: [/* @__PURE__ */ w(i, {
 								size: 14,
 								className: "text-status-warning-text fill-current"
-							}), /* @__PURE__ */ C("span", { children: e.rating === void 0 ? "Not provided" : e.rating.toFixed(1) })]
+							}), /* @__PURE__ */ w("span", { children: e.rating === void 0 ? "Not provided" : e.rating.toFixed(1) })]
 						})
 					},
 					{
@@ -137,13 +146,13 @@ function D() {
 						header: "Created",
 						accessorKey: "createdAt",
 						sortable: !0,
-						cell: (e) => v(e.createdAt, "short")
+						cell: (e) => y(e.createdAt, "short")
 					}
 				],
-				data: B,
-				isLoading: U,
-				error: W,
-				onRetry: G,
+				data: V,
+				isLoading: W,
+				error: G,
+				onRetry: K,
 				searchable: !0,
 				searchPlaceholder: "Search customers...",
 				searchFields: [
@@ -151,26 +160,26 @@ function D() {
 					"email",
 					"company"
 				],
-				searchQuery: L,
+				searchQuery: R,
 				onSearchQueryChange: (e) => {
-					R(e), P(0);
+					z(e), F(0);
 				},
-				onRowClick: (e) => q(`customers/${e.id}`),
+				onRowClick: (e) => J(`customers/${e.id}`),
 				getRowId: (e) => e.id,
-				pageIndex: N,
-				pageSize: F,
-				onPageChange: P,
+				pageIndex: P,
+				pageSize: I,
+				onPageChange: F,
 				onPageSizeChange: (e) => {
-					I(e), P(0);
+					L(e), F(0);
 				},
-				totalItems: V,
-				hasNextPage: H,
+				totalItems: H,
+				hasNextPage: U,
 				emptyIllustration: "empty-people",
 				emptyTitle: "No customers yet",
 				emptyDescription: "Add your first customer to start booking deliveries for them.",
-				emptyAction: /* @__PURE__ */ w(f, {
-					onClick: () => q("customers/new"),
-					children: [/* @__PURE__ */ C(n, {
+				emptyAction: /* @__PURE__ */ T(p, {
+					onClick: () => J("customers/new"),
+					children: [/* @__PURE__ */ w(n, {
 						size: 16,
 						className: "mr-1.5"
 					}), "Add Customer"]
@@ -180,4 +189,4 @@ function D() {
 	});
 }
 //#endregion
-export { D as default };
+export { O as default };