@burdenoff/microfe-movethewheels 2026.1031.2 → 2026.1031.3

package/src/movethewheels/pages/WarehousesPage.tsx

@@ -4,7 +4,7 @@
 
 import { useState } from 'react';
 import { useTr } from '../hooks';
-import { Warehouse, Plus, RefreshCw, CircleCheck, Gauge, Filter } from 'lucide-react';
+import { Warehouse, Plus, RefreshCw, CircleCheck, Gauge, Filter, Upload } from 'lucide-react';
 import { PageLayout } from '../components/PageLayout';
 import { MetricCard, MetricGrid } from '../components/MetricCard';
 import { DataTable, type Column } from '../components/DataTable';
@@ -154,6 +154,11 @@ export default function WarehousesPage() {
               onSelect: () => goTo('inventory/warehouses/pallet-preview'),
             },
             { label: 'Refresh', icon: <RefreshCw size={16} />, onSelect: () => refetch() },
+            {
+              label: 'Import',
+              icon: <Upload size={16} />,
+              onSelect: () => goTo('import-export?entity=WAREHOUSE'),
+            },
           ]}
         />
       }

package/src/movethewheels/utils/entityImport.ts

@@ -0,0 +1,239 @@
+/**
+ * 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 const MTW_IMPORT_ENTITIES = [
+  { 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' },
+] as const;
+
+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 const MTW_IMPORT_MAX_BYTES = 2 * 1024 * 1024;
+export const MTW_IMPORT_MAX_ROWS = 1000;
+
+export function isImportEntityType(value: string | null | undefined): value is MtwImportEntityType {
+  return MTW_IMPORT_ENTITIES.some((entity) => entity.entityType === value);
+}
+
+export function importEntity(entityType: MtwImportEntityType) {
+  const entity = MTW_IMPORT_ENTITIES.find((candidate) => candidate.entityType === entityType);
+  if (!entity) throw new Error(`Unknown import entity ${entityType}`);
+  return entity;
+}
+
+// One static document per entity so graphql-schema-drift can validate each
+// against the subgraph schema; the selection sets are identical.
+export const IMPORT_MUTATIONS: Record<MtwImportEntityType, string> = {
+  CUSTOMER: `
+    mutation ImportMtwCustomers($input: MtwImportInput!) {
+      importMtwCustomers(input: $input) {
+        entityType
+        status
+        dryRun
+        totalRows
+        validRows
+        importedRows
+        failedRows
+        createdIds
+        errorsTruncated
+        errors {
+          row
+          field
+          message
+        }
+      }
+    }
+  `,
+  VEHICLE: `
+    mutation ImportMtwVehicles($input: MtwImportInput!) {
+      importMtwVehicles(input: $input) {
+        entityType
+        status
+        dryRun
+        totalRows
+        validRows
+        importedRows
+        failedRows
+        createdIds
+        errorsTruncated
+        errors {
+          row
+          field
+          message
+        }
+      }
+    }
+  `,
+  DRIVER: `
+    mutation ImportMtwDrivers($input: MtwImportInput!) {
+      importMtwDrivers(input: $input) {
+        entityType
+        status
+        dryRun
+        totalRows
+        validRows
+        importedRows
+        failedRows
+        createdIds
+        errorsTruncated
+        errors {
+          row
+          field
+          message
+        }
+      }
+    }
+  `,
+  WAREHOUSE: `
+    mutation ImportMtwWarehouses($input: MtwImportInput!) {
+      importMtwWarehouses(input: $input) {
+        entityType
+        status
+        dryRun
+        totalRows
+        validRows
+        importedRows
+        failedRows
+        createdIds
+        errorsTruncated
+        errors {
+          row
+          field
+          message
+        }
+      }
+    }
+  `,
+  CARGO_ITEM: `
+    mutation ImportMtwCargoItems($input: MtwImportInput!) {
+      importMtwCargoItems(input: $input) {
+        entityType
+        status
+        dryRun
+        totalRows
+        validRows
+        importedRows
+        failedRows
+        createdIds
+        errorsTruncated
+        errors {
+          row
+          field
+          message
+        }
+      }
+    }
+  `,
+};
+
+/** The mutation document for one entity's import. */
+export function importMutation(entityType: MtwImportEntityType): string {
+  return IMPORT_MUTATIONS[importEntity(entityType).entityType];
+}
+
+export const MTW_IMPORT_SPEC_QUERY = `
+  query MtwImportSpec {
+    mtwImportSpec {
+      entityType
+      keyColumn
+      columns {
+        name
+        type
+        required
+        description
+        allowedValues
+        maxLength
+        min
+        max
+      }
+    }
+  }
+`;
+
+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 function detectImportFormat(fileName: string, mimeType = ''): MtwImportFormat | null {
+  const lower = fileName.toLowerCase();
+  if (lower.endsWith('.csv')) return 'CSV';
+  if (lower.endsWith('.json')) return 'JSON';
+  if (mimeType.includes('csv')) return 'CSV';
+  if (mimeType.includes('json')) return 'JSON';
+  return null;
+}
+
+function csvCell(value: string): string {
+  return /[",\r\n]/.test(value) ? `"${value.replace(/"/g, '""')}"` : value;
+}
+
+/** A CSV template: the header row, required columns first, then optional ones. */
+export function buildCsvTemplate(spec: MtwImportEntitySpec): string {
+  const ordered = [
+    ...spec.columns.filter((column) => column.required),
+    ...spec.columns.filter((column) => !column.required),
+  ];
+  return `${ordered.map((column) => csvCell(column.name)).join(',')}\n`;
+}
+
+/** One-line summary of an import result for the status banner. */
+export function summariseImport(result: MtwImportResult, noun: string): string {
+  const rows = (count: number) => `${count} ${noun}${count === 1 ? '' : 's'}`;
+  switch (result.status) {
+    case 'DRY_RUN':
+      return result.failedRows === 0
+        ? `All ${rows(result.totalRows)} are valid. Nothing was imported yet.`
+        : `${result.validRows} of ${rows(result.totalRows)} are valid; ${result.failedRows} need fixing. Nothing was imported.`;
+    case 'COMPLETED':
+      return `Imported ${rows(result.importedRows)}.`;
+    case 'PARTIAL':
+      return `Imported ${rows(result.importedRows)}; ${result.failedRows} row${result.failedRows === 1 ? '' : 's'} failed.`;
+    case 'REJECTED':
+      return `Nothing was imported: ${result.failedRows} of ${result.totalRows} rows have problems. Fix them, or allow a partial import.`;
+  }
+}