@burdenoff/microfe-movethewheels 2026.1031.2 → 2026.1031.3

package/dist/pages/WarehousesPage.js

@@ -3,22 +3,23 @@ import { Filter as t } from "../node_modules/lucide-react/dist/esm/icons/filter.
 import { Gauge as n } from "../node_modules/lucide-react/dist/esm/icons/gauge.js";
 import { Plus as r } from "../node_modules/lucide-react/dist/esm/icons/plus.js";
 import { RefreshCw as i } from "../node_modules/lucide-react/dist/esm/icons/refresh-cw.js";
-import { Warehouse as a } from "../node_modules/lucide-react/dist/esm/icons/warehouse.js";
-import { joinPath as o } from "../utils/navigation.js";
-import { useMoveTheWheels as s } from "../providers/MoveTheWheelsProvider.js";
-import { useTr as c } from "../shared/hooks/useTr.js";
-import { useWarehouseStats as l, useWarehouses as u } from "../hooks/useInventory.js";
+import { Upload as a } from "../node_modules/lucide-react/dist/esm/icons/upload.js";
+import { Warehouse as o } from "../node_modules/lucide-react/dist/esm/icons/warehouse.js";
+import { joinPath as s } from "../utils/navigation.js";
+import { useMoveTheWheels as c } from "../providers/MoveTheWheelsProvider.js";
+import { useTr as l } from "../shared/hooks/useTr.js";
+import { useWarehouseStats as u, useWarehouses as d } from "../hooks/useInventory.js";
 import "../hooks/index.js";
-import { Badge as d, Button as f, Card as p, CardContent as m, Progress as h, Select as g, SelectContent as _, SelectItem as v, SelectTrigger as y, SelectValue as b } from "../components/ui.js";
-import { PageLayout as x } from "../components/PageLayout.js";
-import { MetricCard as S, MetricGrid as C } from "../components/MetricCard.js";
-import { DataTable as w } from "../components/DataTable.js";
-import { useDebouncedValue as T } from "../hooks/useDebouncedValue.js";
-import { useState as E } from "react";
-import { jsx as D, jsxs as O } from "react/jsx-runtime";
-import { CTAOverflowMenu as k, PagePurpose as A } from "@burdenoff/fe-libs/ui";
+import { Badge as f, Button as p, Card as m, CardContent as h, Progress as g, Select as _, SelectContent as v, SelectItem as y, SelectTrigger as b, SelectValue as x } from "../components/ui.js";
+import { PageLayout as S } from "../components/PageLayout.js";
+import { MetricCard as C, MetricGrid as w } from "../components/MetricCard.js";
+import { DataTable as T } from "../components/DataTable.js";
+import { useDebouncedValue as E } from "../hooks/useDebouncedValue.js";
+import { useState as D } from "react";
+import { jsx as O, jsxs as k } from "react/jsx-runtime";
+import { CTAOverflowMenu as A, PagePurpose as j } from "@burdenoff/fe-libs/ui";
 //#region src/movethewheels/pages/WarehousesPage.tsx
-var j = [
+var M = [
 	{
 		value: "all",
 		label: "All statuses"
@@ -32,114 +33,122 @@ var j = [
 		label: "Inactive"
 	}
 ];
-function M() {
-	let M = c(), { basePath: N, navigate: P } = s(), [F, I] = E(0), [L, R] = E(25), [z, B] = E(""), [V, H] = E("all"), U = T(z), { warehouses: W, totalWarehouses: G, hasMore: K, isLoading: q, error: J, refetch: Y } = u({
-		limit: L,
-		offset: F * L,
-		search: U,
-		status: V === "all" ? void 0 : V
-	}), X = V !== "all" || z.length > 0, { stats: Z } = l(), Q = (e) => P?.(o(N, e));
-	return /* @__PURE__ */ O(x, {
+function N() {
+	let N = l(), { basePath: P, navigate: F } = c(), [I, L] = D(0), [R, z] = D(25), [B, V] = D(""), [H, U] = D("all"), W = E(B), { warehouses: G, totalWarehouses: K, hasMore: q, isLoading: J, error: Y, refetch: X } = d({
+		limit: R,
+		offset: I * R,
+		search: W,
+		status: H === "all" ? void 0 : H
+	}), Z = H !== "all" || B.length > 0, { stats: Q } = u(), $ = (e) => F?.(s(P, e));
+	return /* @__PURE__ */ k(S, {
 		title: "Warehouses",
-		subtitle: `${Z.total} warehouses`,
-		icon: /* @__PURE__ */ D(a, { size: 24 }),
-		headerActions: /* @__PURE__ */ D(k, {
+		subtitle: `${Q.total} warehouses`,
+		icon: /* @__PURE__ */ O(o, { size: 24 }),
+		headerActions: /* @__PURE__ */ O(A, {
 			primary: {
 				label: "Add Warehouse",
-				icon: /* @__PURE__ */ D(r, { size: 16 }),
-				onSelect: () => Q("inventory/warehouses/new")
+				icon: /* @__PURE__ */ O(r, { size: 16 }),
+				onSelect: () => $("inventory/warehouses/new")
 			},
-			actions: [{
-				label: M("movethewheels.palletPreview.title", "Pallet preview"),
-				onSelect: () => Q("inventory/warehouses/pallet-preview")
-			}, {
-				label: "Refresh",
-				icon: /* @__PURE__ */ D(i, { size: 16 }),
-				onSelect: () => Y()
-			}]
+			actions: [
+				{
+					label: N("movethewheels.palletPreview.title", "Pallet preview"),
+					onSelect: () => $("inventory/warehouses/pallet-preview")
+				},
+				{
+					label: "Refresh",
+					icon: /* @__PURE__ */ O(i, { size: 16 }),
+					onSelect: () => X()
+				},
+				{
+					label: "Import",
+					icon: /* @__PURE__ */ O(a, { size: 16 }),
+					onSelect: () => $("import-export?entity=WAREHOUSE")
+				}
+			]
 		}),
 		children: [
-			/* @__PURE__ */ D(A, {
-				icon: /* @__PURE__ */ D(a, { size: 18 }),
+			/* @__PURE__ */ O(j, {
+				icon: /* @__PURE__ */ O(o, { size: 18 }),
 				children: "Your storage and fulfilment sites. Watch space and pallet utilization across each warehouse to balance stock, spot capacity crunches, and decide where to fulfil an order from."
 			}),
-			/* @__PURE__ */ O("div", { children: [/* @__PURE__ */ D("p", {
+			/* @__PURE__ */ k("div", { children: [/* @__PURE__ */ O("p", {
 				className: "mb-3 text-sm font-medium text-text-secondary",
 				children: "Network at a glance"
-			}), /* @__PURE__ */ O(C, {
+			}), /* @__PURE__ */ k(w, {
 				columns: 3,
 				children: [
-					/* @__PURE__ */ D(S, {
+					/* @__PURE__ */ O(C, {
 						label: "Total sites",
-						value: Z.total,
-						icon: /* @__PURE__ */ D(a, { size: 20 }),
+						value: Q.total,
+						icon: /* @__PURE__ */ O(o, { size: 20 }),
 						accent: "brand"
 					}),
-					/* @__PURE__ */ D(S, {
+					/* @__PURE__ */ O(C, {
 						label: "Active",
-						value: Z.active,
-						icon: /* @__PURE__ */ D(e, { size: 20 }),
+						value: Q.active,
+						icon: /* @__PURE__ */ O(e, { size: 20 }),
 						accent: "success",
 						subtitle: "Fulfilling orders"
 					}),
-					/* @__PURE__ */ D(S, {
+					/* @__PURE__ */ O(C, {
 						label: "Avg utilization",
-						value: Z.total > 0 ? `${Math.round(Z.avgUtilization * 100)}%` : "—",
-						icon: /* @__PURE__ */ D(n, { size: 20 }),
+						value: Q.total > 0 ? `${Math.round(Q.avgUtilization * 100)}%` : "—",
+						icon: /* @__PURE__ */ O(n, { size: 20 }),
 						accent: "blue"
 					})
 				]
 			})] }),
-			/* @__PURE__ */ D(p, { children: /* @__PURE__ */ D(m, {
+			/* @__PURE__ */ O(m, { children: /* @__PURE__ */ O(h, {
 				className: "p-4",
-				children: /* @__PURE__ */ O("div", {
+				children: /* @__PURE__ */ k("div", {
 					className: "flex flex-wrap items-center gap-4",
 					children: [
-						/* @__PURE__ */ O("div", {
+						/* @__PURE__ */ k("div", {
 							className: "flex items-center gap-2",
-							children: [/* @__PURE__ */ D(t, {
+							children: [/* @__PURE__ */ O(t, {
 								size: 16,
 								className: "text-text-secondary"
-							}), /* @__PURE__ */ D("span", {
+							}), /* @__PURE__ */ O("span", {
 								className: "text-sm font-medium",
 								children: "Filters:"
 							})]
 						}),
-						/* @__PURE__ */ O(g, {
-							value: V,
+						/* @__PURE__ */ k(_, {
+							value: H,
 							onValueChange: (e) => {
-								H(e), I(0);
+								U(e), L(0);
 							},
-							children: [/* @__PURE__ */ D(y, {
+							children: [/* @__PURE__ */ O(b, {
 								className: "w-[180px]",
-								children: /* @__PURE__ */ D(b, { placeholder: "Status" })
-							}), /* @__PURE__ */ D(_, { children: j.map((e) => /* @__PURE__ */ D(v, {
+								children: /* @__PURE__ */ O(x, { placeholder: "Status" })
+							}), /* @__PURE__ */ O(v, { children: M.map((e) => /* @__PURE__ */ O(y, {
 								value: e.value,
 								children: e.label
 							}, e.value)) })]
 						}),
-						X && /* @__PURE__ */ D(f, {
+						Z && /* @__PURE__ */ O(p, {
 							variant: "ghost",
 							size: "sm",
 							onClick: () => {
-								H("all"), B(""), I(0);
+								U("all"), V(""), L(0);
 							},
 							children: "Clear filters"
 						})
 					]
 				})
 			}) }),
-			/* @__PURE__ */ D(w, {
+			/* @__PURE__ */ O(T, {
 				columns: [
 					{
 						id: "name",
 						header: "Warehouse",
 						accessorKey: "name",
 						sortable: !0,
-						cell: (e) => /* @__PURE__ */ O("div", { children: [/* @__PURE__ */ D("p", {
+						cell: (e) => /* @__PURE__ */ k("div", { children: [/* @__PURE__ */ O("p", {
 							className: "font-medium",
 							children: e.name
-						}), /* @__PURE__ */ D("p", {
+						}), /* @__PURE__ */ O("p", {
 							className: "text-sm text-text-secondary",
 							children: e.code
 						})] })
@@ -147,7 +156,7 @@ function M() {
 					{
 						id: "location",
 						header: "Location",
-						cell: (e) => /* @__PURE__ */ O("div", { children: [/* @__PURE__ */ D("p", { children: [e.address.city, e.address.state].filter(Boolean).join(", ") || "Not provided" }), /* @__PURE__ */ D("p", {
+						cell: (e) => /* @__PURE__ */ k("div", { children: [/* @__PURE__ */ O("p", { children: [e.address.city, e.address.state].filter(Boolean).join(", ") || "Not provided" }), /* @__PURE__ */ O("p", {
 							className: "text-sm text-text-secondary",
 							children: e.address.country || "Not provided"
 						})] })
@@ -156,7 +165,7 @@ function M() {
 						id: "type",
 						header: "Type",
 						accessorKey: "type",
-						cell: (e) => /* @__PURE__ */ D(d, {
+						cell: (e) => /* @__PURE__ */ O(f, {
 							variant: "outline",
 							className: "capitalize",
 							children: e.type.replace("_", " ")
@@ -167,15 +176,15 @@ function M() {
 						header: "Utilization",
 						cell: (e) => {
 							let { totalSpace: t, usedSpace: n } = e.capacity, r = typeof t == "number" && t > 0 && typeof n == "number" ? n / t * 100 : void 0;
-							return r === void 0 ? /* @__PURE__ */ D("span", {
+							return r === void 0 ? /* @__PURE__ */ O("span", {
 								className: "text-sm text-text-secondary",
 								children: "Not provided"
-							}) : /* @__PURE__ */ O("div", {
+							}) : /* @__PURE__ */ k("div", {
 								className: "flex items-center gap-2",
-								children: [/* @__PURE__ */ D(h, {
+								children: [/* @__PURE__ */ O(g, {
 									value: r,
 									className: "w-16 h-2"
-								}), /* @__PURE__ */ O("span", {
+								}), /* @__PURE__ */ k("span", {
 									className: "text-sm",
 									children: [r.toFixed(0), "%"]
 								})]
@@ -187,7 +196,7 @@ function M() {
 						header: "Capacity",
 						cell: (e) => {
 							let { totalSpace: t, usedSpace: n } = e.capacity;
-							return typeof n == "number" && typeof t == "number" ? /* @__PURE__ */ O("p", {
+							return typeof n == "number" && typeof t == "number" ? /* @__PURE__ */ k("p", {
 								className: "text-sm",
 								children: [
 									n.toLocaleString(),
@@ -195,7 +204,7 @@ function M() {
 									t.toLocaleString(),
 									" sq ft"
 								]
-							}) : /* @__PURE__ */ D("span", {
+							}) : /* @__PURE__ */ O("span", {
 								className: "text-sm text-text-secondary",
 								children: "Not provided"
 							});
@@ -206,37 +215,37 @@ function M() {
 						header: "Status",
 						cell: (e) => {
 							let t = e.status?.toUpperCase() === "ACTIVE";
-							return e.status ? /* @__PURE__ */ D(d, {
+							return e.status ? /* @__PURE__ */ O(f, {
 								variant: t ? "default" : "secondary",
 								children: t ? "Active" : "Inactive"
-							}) : /* @__PURE__ */ D("span", {
+							}) : /* @__PURE__ */ O("span", {
 								className: "text-sm text-text-secondary",
 								children: "Not provided"
 							});
 						}
 					}
 				],
-				data: W,
-				isLoading: q,
-				error: J,
-				onRetry: Y,
+				data: G,
+				isLoading: J,
+				error: Y,
+				onRetry: X,
 				searchable: !0,
 				searchPlaceholder: "Search warehouses...",
 				searchFields: ["name", "code"],
-				searchQuery: z,
+				searchQuery: B,
 				onSearchQueryChange: (e) => {
-					B(e), I(0);
+					V(e), L(0);
 				},
-				onRowClick: (e) => Q(`inventory/warehouses/${e.id}`),
+				onRowClick: (e) => $(`inventory/warehouses/${e.id}`),
 				getRowId: (e) => e.id,
-				pageIndex: F,
-				pageSize: L,
-				onPageChange: I,
+				pageIndex: I,
+				pageSize: R,
+				onPageChange: L,
 				onPageSizeChange: (e) => {
-					R(e), I(0);
+					z(e), L(0);
 				},
-				totalItems: G,
-				hasNextPage: K,
+				totalItems: K,
+				hasNextPage: q,
 				emptyIllustration: "empty-data",
 				emptyTitle: "No warehouses yet",
 				emptyDescription: "Add a warehouse to store inventory and fulfil orders from it."
@@ -245,4 +254,4 @@ function M() {
 	});
 }
 //#endregion
-export { M as default };
+export { N as default };

package/dist/utils/entityImport.js

@@ -0,0 +1,73 @@
+//#region src/movethewheels/utils/entityImport.ts
+var e = [
+	{
+		entityType: "CUSTOMER",
+		label: "Customers",
+		noun: "customer",
+		field: "importMtwCustomers"
+	},
+	{
+		entityType: "VEHICLE",
+		label: "Vehicles",
+		noun: "vehicle",
+		field: "importMtwVehicles"
+	},
+	{
+		entityType: "DRIVER",
+		label: "Drivers",
+		noun: "driver",
+		field: "importMtwDrivers"
+	},
+	{
+		entityType: "WAREHOUSE",
+		label: "Warehouses",
+		noun: "warehouse",
+		field: "importMtwWarehouses"
+	},
+	{
+		entityType: "CARGO_ITEM",
+		label: "Products",
+		noun: "product",
+		field: "importMtwCargoItems"
+	}
+], t = 2 * 1024 * 1024, n = 1e3;
+function r(t) {
+	return e.some((e) => e.entityType === t);
+}
+function i(t) {
+	let n = e.find((e) => e.entityType === t);
+	if (!n) throw Error(`Unknown import entity ${t}`);
+	return n;
+}
+var a = {
+	CUSTOMER: "\n    mutation ImportMtwCustomers($input: MtwImportInput!) {\n      importMtwCustomers(input: $input) {\n        entityType\n        status\n        dryRun\n        totalRows\n        validRows\n        importedRows\n        failedRows\n        createdIds\n        errorsTruncated\n        errors {\n          row\n          field\n          message\n        }\n      }\n    }\n  ",
+	VEHICLE: "\n    mutation ImportMtwVehicles($input: MtwImportInput!) {\n      importMtwVehicles(input: $input) {\n        entityType\n        status\n        dryRun\n        totalRows\n        validRows\n        importedRows\n        failedRows\n        createdIds\n        errorsTruncated\n        errors {\n          row\n          field\n          message\n        }\n      }\n    }\n  ",
+	DRIVER: "\n    mutation ImportMtwDrivers($input: MtwImportInput!) {\n      importMtwDrivers(input: $input) {\n        entityType\n        status\n        dryRun\n        totalRows\n        validRows\n        importedRows\n        failedRows\n        createdIds\n        errorsTruncated\n        errors {\n          row\n          field\n          message\n        }\n      }\n    }\n  ",
+	WAREHOUSE: "\n    mutation ImportMtwWarehouses($input: MtwImportInput!) {\n      importMtwWarehouses(input: $input) {\n        entityType\n        status\n        dryRun\n        totalRows\n        validRows\n        importedRows\n        failedRows\n        createdIds\n        errorsTruncated\n        errors {\n          row\n          field\n          message\n        }\n      }\n    }\n  ",
+	CARGO_ITEM: "\n    mutation ImportMtwCargoItems($input: MtwImportInput!) {\n      importMtwCargoItems(input: $input) {\n        entityType\n        status\n        dryRun\n        totalRows\n        validRows\n        importedRows\n        failedRows\n        createdIds\n        errorsTruncated\n        errors {\n          row\n          field\n          message\n        }\n      }\n    }\n  "
+};
+function o(e) {
+	return a[i(e).entityType];
+}
+var s = "\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";
+function c(e, t = "") {
+	let n = e.toLowerCase();
+	return n.endsWith(".csv") ? "CSV" : n.endsWith(".json") ? "JSON" : t.includes("csv") ? "CSV" : t.includes("json") ? "JSON" : null;
+}
+function l(e) {
+	return /[",\r\n]/.test(e) ? `"${e.replace(/"/g, "\"\"")}"` : e;
+}
+function u(e) {
+	return `${[...e.columns.filter((e) => e.required), ...e.columns.filter((e) => !e.required)].map((e) => l(e.name)).join(",")}\n`;
+}
+function d(e, t) {
+	let n = (e) => `${e} ${t}${e === 1 ? "" : "s"}`;
+	switch (e.status) {
+		case "DRY_RUN": return e.failedRows === 0 ? `All ${n(e.totalRows)} are valid. Nothing was imported yet.` : `${e.validRows} of ${n(e.totalRows)} are valid; ${e.failedRows} need fixing. Nothing was imported.`;
+		case "COMPLETED": return `Imported ${n(e.importedRows)}.`;
+		case "PARTIAL": return `Imported ${n(e.importedRows)}; ${e.failedRows} row${e.failedRows === 1 ? "" : "s"} failed.`;
+		case "REJECTED": return `Nothing was imported: ${e.failedRows} of ${e.totalRows} rows have problems. Fix them, or allow a partial import.`;
+	}
+}
+//#endregion
+export { e as MTW_IMPORT_ENTITIES, t as MTW_IMPORT_MAX_BYTES, n as MTW_IMPORT_MAX_ROWS, s as MTW_IMPORT_SPEC_QUERY, u as buildCsvTemplate, c as detectImportFormat, i as importEntity, o as importMutation, r as isImportEntityType, d as summariseImport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/microfe-movethewheels",
-  "version": "2026.1031.2",
+  "version": "2026.1031.3",
   "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: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: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",
@@ -73,6 +73,7 @@
     "verify:tracking-alerts": "bun test scripts/check-tracking-alerts.test.ts",
     "verify:core-codegen": "bun test scripts/codegen.test.ts && node --test scripts/check-package-types.test.mjs",
     "verify:entity-export": "bun test scripts/check-entity-export.test.ts",
+    "verify:entity-import": "bun test scripts/check-entity-import.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

@@ -2443,6 +2443,91 @@ export type MtwFuelVolumeObservationInput = {
   sourceRevision?: InputMaybe<Scalars['String']['input']>;
 };
 
+export type MtwImportColumn = {
+  __typename?: 'MtwImportColumn';
+  allowedValues?: Maybe<Array<Scalars['String']['output']>>;
+  description: Scalars['String']['output'];
+  max?: Maybe<Scalars['Float']['output']>;
+  maxLength?: Maybe<Scalars['Int']['output']>;
+  min?: Maybe<Scalars['Float']['output']>;
+  name: Scalars['String']['output'];
+  required: Scalars['Boolean']['output'];
+  type: MtwImportColumnType;
+};
+
+export type MtwImportColumnType =
+  | 'BOOLEAN'
+  | 'DATE'
+  | 'EMAIL'
+  | 'ENUM'
+  | 'INTEGER'
+  | 'JSON'
+  | 'NUMBER'
+  | 'STRING';
+
+export type MtwImportEntitySpec = {
+  __typename?: 'MtwImportEntitySpec';
+  columns: Array<MtwImportColumn>;
+  entityType: MtwImportEntityType;
+  /** Column that must be unique in the workspace, if any. */
+  keyColumn?: Maybe<Scalars['String']['output']>;
+};
+
+export type MtwImportEntityType =
+  | 'CARGO_ITEM'
+  | 'CUSTOMER'
+  | 'DRIVER'
+  | 'VEHICLE'
+  | 'WAREHOUSE';
+
+export type MtwImportFormat =
+  | 'CSV'
+  | 'JSON';
+
+export type MtwImportInput = {
+  /** Import the valid rows even when other rows are invalid. */
+  allowPartial?: InputMaybe<Scalars['Boolean']['input']>;
+  /** The CSV (with a header row) or JSON (array of objects) document, at most 2 MB and 1000 rows. */
+  content: Scalars['String']['input'];
+  /** Validate every row without writing anything. */
+  dryRun?: InputMaybe<Scalars['Boolean']['input']>;
+  format: MtwImportFormat;
+};
+
+export type MtwImportResult = {
+  __typename?: 'MtwImportResult';
+  createdIds: Array<Scalars['ID']['output']>;
+  dryRun: Scalars['Boolean']['output'];
+  entityType: MtwImportEntityType;
+  errors: Array<MtwImportRowError>;
+  /** True when more row errors exist than are returned (the first 500 are returned). */
+  errorsTruncated: Scalars['Boolean']['output'];
+  failedRows: Scalars['Int']['output'];
+  importedRows: Scalars['Int']['output'];
+  status: MtwImportStatus;
+  totalRows: Scalars['Int']['output'];
+  validRows: Scalars['Int']['output'];
+};
+
+export type MtwImportRowError = {
+  __typename?: 'MtwImportRowError';
+  field?: Maybe<Scalars['String']['output']>;
+  message: Scalars['String']['output'];
+  /** 1-based data row number (the CSV header is not counted). */
+  row: Scalars['Int']['output'];
+};
+
+/**
+ * DRY_RUN: validated only, nothing written. COMPLETED: every row imported.
+ * PARTIAL: allowPartial was set and some rows failed. REJECTED: some rows were
+ * invalid and allowPartial was not set, so nothing was written.
+ */
+export type MtwImportStatus =
+  | 'COMPLETED'
+  | 'DRY_RUN'
+  | 'PARTIAL'
+  | 'REJECTED';
+
 /** A recorded manual issuer review; workspace privileges do not establish professional qualifications. */
 export type MtwInspectorQualification = {
   __typename?: 'MtwInspectorQualification';
@@ -4523,6 +4608,11 @@ export type Mutation = {
   deleteWarehouse: Scalars['Boolean']['output'];
   exportMtwEntities: MtwExportJob;
   holdMtwContainer: MtwContainerHold;
+  importMtwCargoItems: MtwImportResult;
+  importMtwCustomers: MtwImportResult;
+  importMtwDrivers: MtwImportResult;
+  importMtwVehicles: MtwImportResult;
+  importMtwWarehouses: MtwImportResult;
   openMtwContainerCycle: MtwContainerCycle;
   openMtwFreeTimeClock: MtwFreeTimeClock;
   optimizeRoute: MtwRoute;
@@ -4791,6 +4881,31 @@ export type MutationHoldMtwContainerArgs = {
 };
 
 
+export type MutationImportMtwCargoItemsArgs = {
+  input: MtwImportInput;
+};
+
+
+export type MutationImportMtwCustomersArgs = {
+  input: MtwImportInput;
+};
+
+
+export type MutationImportMtwDriversArgs = {
+  input: MtwImportInput;
+};
+
+
+export type MutationImportMtwVehiclesArgs = {
+  input: MtwImportInput;
+};
+
+
+export type MutationImportMtwWarehousesArgs = {
+  input: MtwImportInput;
+};
+
+
 export type MutationOpenMtwContainerCycleArgs = {
   input: OpenMtwContainerCycleInput;
 };
@@ -5253,6 +5368,13 @@ export type Query = {
   /** Null is not proof of no effect and never authorizes resubmission. Exact original actor/context only. */
   mtwFreightInvoiceComparisonByRequestKey?: Maybe<MtwFreightInvoiceComparison>;
   mtwFreightInvoiceComparisonPage: MtwFreightInvoiceComparisonPage;
+  /**
+   * Columns accepted by each import, for building templates and showing guidance.
+   * This is static reference metadata with no workspace data in it, so it only
+   * needs an authenticated caller; every import mutation enforces its own
+   * entity create permission.
+   */
+  mtwImportSpec: Array<MtwImportEntitySpec>;
   mtwPalletGeometryPreview: MtwPalletGeometryPreview;
   mtwPickPreparation: MtwPickPreparation;
   mtwPickReview: MtwPickReview;

package/src/movethewheels/MoveTheWheelsRoot.tsx

@@ -23,6 +23,7 @@ import {
   DollarSign,
   Bot,
   Store,
+  ArrowDownUp,
 } from 'lucide-react';
 import { MoveTheWheelsProvider } from './providers/MoveTheWheelsProvider';
 import { FeatureFlagProvider } from '@burdenoff/fe-libs/shared/feature-flags';
@@ -241,6 +242,13 @@ const NavRegistrar: FC<Pick<MoveTheWheelsRootProps, 'registerNavItems' | 'basePa
           icon: <Store size={16} />,
           order: 6,
         },
+        {
+          id: 'mtw-import-export',
+          label: tr('movethewheels.root.nav.importExport', 'Import / Export'),
+          path: joinPath(basePath, 'import-export'),
+          icon: <ArrowDownUp size={16} />,
+          order: 6,
+        },
         {
           id: 'mtw-routes',
           label: tr('movethewheels.root.nav.routes', 'Routes'),

package/src/movethewheels/MoveTheWheelsRoutes.tsx

@@ -72,6 +72,7 @@ const WarehouseDetailsPage = lazy(() => import('./pages/WarehouseDetailsPage'));
 const CustomersPage = lazy(() => import('./pages/CustomersPage'));
 const CustomerDetailsPage = lazy(() => import('./pages/CustomerDetailsPage'));
 const MarketplacePage = lazy(() => import('./pages/MarketplacePage'));
+const ImportExportPage = lazy(() => import('./pages/ImportExportPage'));
 const RoutesPage = lazy(() => import('./pages/RoutesPage'));
 const RouteDetailsPage = lazy(() => import('./pages/RouteDetailsPage'));
 const AnalyticsPage = lazy(() => import('./pages/AnalyticsPage'));
@@ -160,6 +161,9 @@ export function MoveTheWheelsRoutes() {
         {/* Marketplace — service providers and offerings (BOFF-3988) */}
         <Route path="marketplace" element={<MarketplacePage />} />
 
+        {/* Bulk CSV/JSON import and dataset export (BOFF-3990) */}
+        <Route path="import-export" element={<ImportExportPage />} />
+
         {/* Routes */}
         <Route path="routes" element={<RoutesPage />} />
         <Route path="routes/trip-utilization" element={<TripUtilizationPage />} />