@burdenoff/microfe-movethewheels 2026.1030.1 → 2026.1031.1

package/dist/components/ExportStatusBanner.js

@@ -0,0 +1,53 @@
+import { CircleAlert as e } from "../node_modules/lucide-react/dist/esm/icons/circle-alert.js";
+import { CircleCheckBig as t } from "../node_modules/lucide-react/dist/esm/icons/circle-check-big.js";
+import { Info as n } from "../node_modules/lucide-react/dist/esm/icons/info.js";
+import { LoaderCircle as r } from "../node_modules/lucide-react/dist/esm/icons/loader-circle.js";
+import { X as i } from "../node_modules/lucide-react/dist/esm/icons/x.js";
+import { useMoveTheWheels as a } from "../providers/MoveTheWheelsProvider.js";
+import { Fragment as o, jsx as s, jsxs as c } from "react/jsx-runtime";
+//#region src/movethewheels/components/ExportStatusBanner.tsx
+var l = "/export";
+function u({ state: u, onDismiss: d }) {
+	let { navigate: f } = a();
+	if (u.phase === "idle") return null;
+	let p = u.phase === "error" ? "border-status-error-border bg-status-error-bg-subtle text-status-error-text" : u.phase === "ready" ? "border-status-success-border bg-status-success-bg-subtle text-status-success-text" : "border-status-info-border bg-status-info-bg-subtle text-status-info-text", m = u.phase === "error" ? /* @__PURE__ */ s(e, {
+		size: 18,
+		className: "mt-0.5 shrink-0"
+	}) : u.phase === "ready" ? /* @__PURE__ */ s(t, {
+		size: 18,
+		className: "mt-0.5 shrink-0"
+	}) : u.phase === "running" ? /* @__PURE__ */ s(r, {
+		size: 18,
+		className: "mt-0.5 shrink-0 animate-spin"
+	}) : /* @__PURE__ */ s(n, {
+		size: 18,
+		className: "mt-0.5 shrink-0"
+	});
+	return /* @__PURE__ */ c("div", {
+		role: u.phase === "error" ? "alert" : "status",
+		"data-testid": "mtw-export-status",
+		"data-phase": u.phase,
+		className: `flex items-start gap-2 rounded-lg border px-4 py-3 text-sm ${p}`,
+		children: [
+			m,
+			/* @__PURE__ */ c("span", {
+				className: "flex-1",
+				children: [u.message, u.phase === "pending" ? /* @__PURE__ */ c(o, { children: [" ", /* @__PURE__ */ s("button", {
+					type: "button",
+					className: "font-medium underline underline-offset-2",
+					onClick: () => f(`${l}/${u.jobId}`),
+					children: "Open Exports"
+				})] }) : null]
+			}),
+			u.phase === "running" ? null : /* @__PURE__ */ s("button", {
+				type: "button",
+				"aria-label": "Dismiss export status",
+				className: "shrink-0 opacity-70 hover:opacity-100",
+				onClick: d,
+				children: /* @__PURE__ */ s(i, { size: 16 })
+			})
+		]
+	});
+}
+//#endregion
+export { u as ExportStatusBanner };

package/dist/hooks/useEntityExport.js

@@ -0,0 +1,85 @@
+import { useMoveTheWheels as e } from "../providers/MoveTheWheelsProvider.js";
+import { executeGraphQL as t } from "../utils/graphqlClient.js";
+import { GET_MTW_EXPORT_JOB_QUERY as n, MTW_EXPORT_ENTITY_TYPES as r, START_MTW_EXPORT_MUTATION as i, triggerUrlDownload as a, waitForExportJob as o } from "../utils/entityExport.js";
+import { useCallback as s, useEffect as c, useMemo as l, useRef as u, useState as d } from "react";
+//#region src/movethewheels/hooks/useEntityExport.ts
+function f(f, p) {
+	let { apiGatewayUrl: m, authToken: h, workspaceToken: g, workspaceId: _, tenantId: v, currentUser: y } = e(), [b, x] = d({ phase: "idle" }), S = u(null), C = u(!1), w = l(() => ({
+		apiGatewayUrl: m,
+		authToken: h,
+		workspaceToken: g,
+		workspaceId: _,
+		tenantId: v,
+		actorId: y?.id
+	}), [
+		m,
+		h,
+		g,
+		_,
+		v,
+		y?.id
+	]);
+	c(() => () => S.current?.abort(), []);
+	let T = s(() => {
+		if (C.current) return;
+		if (!_) {
+			x({
+				phase: "error",
+				message: "Select a workspace before exporting."
+			});
+			return;
+		}
+		S.current?.abort();
+		let e = new AbortController();
+		S.current = e, x({
+			phase: "running",
+			message: `Preparing your ${p} export…`
+		}), (async () => {
+			C.current = !0;
+			try {
+				let s = await o((await t(w, i, { input: {
+					workspaceId: _,
+					entityTypes: [r[f]],
+					format: "CSV",
+					includeMetadata: !0
+				} }, "SINGLE_ATTEMPT")).exportMtwEntities, async (r) => (await t({
+					...w,
+					signal: e.signal
+				}, n, { id: r })).getExportJob, { signal: e.signal });
+				if (e.signal.aborted) return;
+				s.kind === "ready" ? (a(s.downloadUrl), x({
+					phase: "ready",
+					message: `Your ${p} export is downloading.`
+				})) : s.kind === "pending" ? x({
+					phase: "pending",
+					jobId: s.jobId,
+					message: `Your ${p} export is still being prepared. It will be available on the Exports page when it finishes.`
+				}) : x({
+					phase: "error",
+					message: `Export failed: ${s.message}`
+				});
+			} catch (t) {
+				if (e.signal.aborted) return;
+				x({
+					phase: "error",
+					message: t instanceof Error && t.message ? `Export failed: ${t.message}` : "Export failed. Please try again."
+				});
+			} finally {
+				C.current = !1;
+			}
+		})();
+	}, [
+		f,
+		w,
+		p,
+		_
+	]), E = s(() => x({ phase: "idle" }), []);
+	return {
+		state: b,
+		isExporting: b.phase === "running",
+		startExport: T,
+		dismiss: E
+	};
+}
+//#endregion
+export { f as useEntityExport };

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

@@ -0,0 +1,7 @@
+import { EntityExportState } from '../hooks/useEntityExport';
+interface ExportStatusBannerProps {
+    state: EntityExportState;
+    onDismiss: () => void;
+}
+export declare function ExportStatusBanner({ state, onDismiss }: ExportStatusBannerProps): import('react').JSX.Element | null;
+export {};

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

@@ -0,0 +1,32 @@
+import { MtwExportEntity } from '../utils/entityExport';
+export type EntityExportState = {
+    phase: 'idle';
+} | {
+    phase: 'running';
+    message: string;
+} | {
+    phase: 'ready';
+    message: string;
+} | {
+    phase: 'pending';
+    message: string;
+    jobId: string;
+} | {
+    phase: 'error';
+    message: string;
+};
+export interface UseEntityExportResult {
+    state: EntityExportState;
+    isExporting: boolean;
+    /** Start a CSV export of every record of this entity in the workspace. */
+    startExport: () => void;
+    dismiss: () => void;
+}
+/**
+ * Drives the list-page "Export" action: starts an `exportMtwEntities` job for
+ * the page's entity type, waits for wspace-export-svc to build the archive and
+ * starts the download. A job that takes longer than the wait budget keeps
+ * running and is reported as pending, with its id, so the user can collect it
+ * from the shared Exports page.
+ */
+export declare function useEntityExport(entity: MtwExportEntity, label: string): UseEntityExportResult;

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

@@ -0,0 +1,64 @@
+/**
+ * Entity export — starts a MoveTheWheels export job and waits for its archive.
+ *
+ * `exportMtwEntities` hands the request to wspace-export-svc, which builds a
+ * ZIP of the workspace's records in the background. The job is read back with
+ * `getExportJob` until it reports COMPLETED (with a presigned `downloadUrl`),
+ * FAILED/CANCELLED/EXPIRED, or the wait budget runs out. A job that is still
+ * running when the budget is spent keeps going server side and stays
+ * downloadable from the shared Exports page.
+ *
+ * Kept free of React so the polling contract can be unit-tested.
+ */
+/** List pages that offer an export, mapped to wspace-export-svc entity types. */
+export declare const MTW_EXPORT_ENTITY_TYPES: {
+    readonly customers: "movethewheels_customers";
+    readonly drivers: "movethewheels_drivers";
+    readonly orders: "movethewheels_delivery_jobs";
+    readonly products: "movethewheels_cargo_items";
+    readonly vehicles: "movethewheels_vehicles";
+};
+export type MtwExportEntity = keyof typeof MTW_EXPORT_ENTITY_TYPES;
+export declare const START_MTW_EXPORT_MUTATION = "\n  mutation StartMovethewheelsEntityExport($input: ExportMtwEntitiesInput!) {\n    exportMtwEntities(input: $input) {\n      id\n      status\n      downloadUrl\n    }\n  }\n";
+export declare const GET_MTW_EXPORT_JOB_QUERY = "\n  query GetMovethewheelsExportJob($id: ID!) {\n    getExportJob(id: $id) {\n      id\n      status\n      progress\n      downloadUrl\n      errorMessage\n    }\n  }\n";
+export interface ExportJobSnapshot {
+    id: string;
+    status: string;
+    progress?: number | null;
+    downloadUrl?: string | null;
+    errorMessage?: string | null;
+}
+export type ExportJobOutcome = {
+    kind: 'ready';
+    jobId: string;
+    downloadUrl: string;
+} | {
+    kind: 'failed';
+    jobId: string;
+    message: string;
+} | {
+    kind: 'pending';
+    jobId: string;
+};
+/** Classify one job snapshot; `null` means keep waiting. */
+export declare function classifyExportJob(job: ExportJobSnapshot): ExportJobOutcome | null;
+export interface WaitForExportOptions {
+    /** Delay between reads of the job. */
+    intervalMs?: number;
+    /** Total time to wait before reporting the job as still pending. */
+    timeoutMs?: number;
+    /** Injectable for tests. */
+    sleep?: (ms: number) => Promise<void>;
+    /** Injectable for tests. */
+    now?: () => number;
+    /** Stops waiting (e.g. the page unmounted); resolves as pending. */
+    signal?: AbortSignal;
+}
+/**
+ * Read the job until it settles or the wait budget is spent. `initial` is the
+ * snapshot returned by the start mutation, so an already-finished job resolves
+ * without another round trip.
+ */
+export declare function waitForExportJob(initial: ExportJobSnapshot, fetchJob: (id: string) => Promise<ExportJobSnapshot | null>, { intervalMs, timeoutMs, sleep, now, signal, }?: WaitForExportOptions): Promise<ExportJobOutcome>;
+/** Start the archive download in the current tab without navigating away. */
+export declare function triggerUrlDownload(url: string): void;

package/dist/pages/CustomersPage.js

@@ -14,80 +14,86 @@ 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 { useState as b } from "react";
-import { jsx as x, jsxs as S } from "react/jsx-runtime";
-import { CTAOverflowMenu as C, PagePurpose as w } from "@burdenoff/fe-libs/ui";
+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";
 //#region src/movethewheels/pages/CustomersPage.tsx
-function T() {
-	let { basePath: T, navigate: E } = s(), [D, O] = b(0), [k, A] = b(25), [j, M] = b(""), N = y(j), { customers: P, totalCustomers: F, hasMore: I, isLoading: L, error: R, refetch: z } = l({
-		limit: k,
-		offset: D * k,
-		filters: { search: N }
-	}), { stats: B } = c(), V = (e) => E?.(o(T, e));
-	return /* @__PURE__ */ S(p, {
+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, {
 		title: "Customers",
-		subtitle: `${B.total} customers`,
-		icon: /* @__PURE__ */ x(a, { size: 24 }),
-		headerActions: /* @__PURE__ */ x(C, {
+		subtitle: `${K.total} customers`,
+		icon: /* @__PURE__ */ C(a, { size: 24 }),
+		headerActions: /* @__PURE__ */ C(T, {
 			primary: {
 				label: "Add Customer",
-				icon: /* @__PURE__ */ x(n, { size: 16 }),
-				onSelect: () => V("customers/new")
+				icon: /* @__PURE__ */ C(n, { size: 16 }),
+				onSelect: () => q("customers/new")
 			},
 			actions: [{
 				label: "Refresh",
-				icon: /* @__PURE__ */ x(r, { size: 16 }),
-				onSelect: () => z()
+				icon: /* @__PURE__ */ C(r, { size: 16 }),
+				onSelect: () => G()
 			}, {
-				label: "Export",
-				icon: /* @__PURE__ */ x(t, { size: 16 }),
-				onSelect: () => V("import-export")
+				label: A ? "Exporting…" : "Export",
+				icon: /* @__PURE__ */ C(t, { size: 16 }),
+				onSelect: j
 			}]
 		}),
 		children: [
-			/* @__PURE__ */ x(w, {
-				icon: /* @__PURE__ */ x(a, { size: 18 }),
+			/* @__PURE__ */ C(E, {
+				icon: /* @__PURE__ */ C(a, { 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__ */ S("div", { children: [/* @__PURE__ */ x("p", {
+			/* @__PURE__ */ C(x, {
+				state: k,
+				onDismiss: M
+			}),
+			/* @__PURE__ */ w("div", { children: [/* @__PURE__ */ C("p", {
 				className: "mb-3 text-sm font-medium text-text-secondary",
 				children: "Customer base at a glance"
-			}), /* @__PURE__ */ S(h, {
+			}), /* @__PURE__ */ w(h, {
 				columns: 3,
 				children: [
-					/* @__PURE__ */ x(m, {
+					/* @__PURE__ */ C(m, {
 						label: "Total customers",
-						value: B.total,
-						icon: /* @__PURE__ */ x(a, { size: 20 }),
+						value: K.total,
+						icon: /* @__PURE__ */ C(a, { size: 20 }),
 						accent: "brand"
 					}),
-					/* @__PURE__ */ x(m, {
+					/* @__PURE__ */ C(m, {
 						label: "Avg. rating",
-						value: B.avgRating > 0 ? B.avgRating.toFixed(1) : "—",
-						icon: /* @__PURE__ */ x(i, { size: 20 }),
+						value: K.avgRating > 0 ? K.avgRating.toFixed(1) : "—",
+						icon: /* @__PURE__ */ C(i, { size: 20 }),
 						accent: "success",
 						subtitle: "Across all customers"
 					}),
-					/* @__PURE__ */ x(m, {
+					/* @__PURE__ */ C(m, {
 						label: "Business accounts",
-						value: B.b2b,
-						icon: /* @__PURE__ */ x(e, { size: 20 }),
+						value: K.b2b,
+						icon: /* @__PURE__ */ C(e, { size: 20 }),
 						accent: "blue",
 						subtitle: "B2B relationships"
 					})
 				]
 			})] }),
-			/* @__PURE__ */ x(_, {
+			/* @__PURE__ */ C(_, {
 				columns: [
 					{
 						id: "customer",
 						header: "Customer",
-						cell: (e) => /* @__PURE__ */ S("div", {
+						cell: (e) => /* @__PURE__ */ w("div", {
 							className: "flex items-center gap-3",
-							children: [/* @__PURE__ */ x(u, { children: /* @__PURE__ */ x(d, { children: e.name.split(" ").map((e) => e[0]).join("") }) }), /* @__PURE__ */ S("div", { children: [/* @__PURE__ */ x("p", {
+							children: [/* @__PURE__ */ C(u, { children: /* @__PURE__ */ C(d, { children: e.name.split(" ").map((e) => e[0]).join("") }) }), /* @__PURE__ */ w("div", { children: [/* @__PURE__ */ C("p", {
 								className: "font-medium",
 								children: e.name
-							}), /* @__PURE__ */ x("p", {
+							}), /* @__PURE__ */ C("p", {
 								className: "text-sm text-text-secondary",
 								children: e.email
 							})] })]
@@ -97,7 +103,7 @@ function T() {
 						id: "type",
 						header: "Type",
 						accessorKey: "type",
-						cell: (e) => /* @__PURE__ */ x(g, { type: e.type })
+						cell: (e) => /* @__PURE__ */ C(g, { type: e.type })
 					},
 					{
 						id: "company",
@@ -118,12 +124,12 @@ function T() {
 					{
 						id: "rating",
 						header: "Rating",
-						cell: (e) => /* @__PURE__ */ S("div", {
+						cell: (e) => /* @__PURE__ */ w("div", {
 							className: "flex items-center gap-1",
-							children: [/* @__PURE__ */ x(i, {
+							children: [/* @__PURE__ */ C(i, {
 								size: 14,
 								className: "text-status-warning-text fill-current"
-							}), /* @__PURE__ */ x("span", { children: e.rating === void 0 ? "Not provided" : e.rating.toFixed(1) })]
+							}), /* @__PURE__ */ C("span", { children: e.rating === void 0 ? "Not provided" : e.rating.toFixed(1) })]
 						})
 					},
 					{
@@ -134,10 +140,10 @@ function T() {
 						cell: (e) => v(e.createdAt, "short")
 					}
 				],
-				data: P,
-				isLoading: L,
-				error: R,
-				onRetry: z,
+				data: B,
+				isLoading: U,
+				error: W,
+				onRetry: G,
 				searchable: !0,
 				searchPlaceholder: "Search customers...",
 				searchFields: [
@@ -145,26 +151,26 @@ function T() {
 					"email",
 					"company"
 				],
-				searchQuery: j,
+				searchQuery: L,
 				onSearchQueryChange: (e) => {
-					M(e), O(0);
+					R(e), P(0);
 				},
-				onRowClick: (e) => V(`customers/${e.id}`),
+				onRowClick: (e) => q(`customers/${e.id}`),
 				getRowId: (e) => e.id,
-				pageIndex: D,
-				pageSize: k,
-				onPageChange: O,
+				pageIndex: N,
+				pageSize: F,
+				onPageChange: P,
 				onPageSizeChange: (e) => {
-					A(e), O(0);
+					I(e), P(0);
 				},
-				totalItems: F,
-				hasNextPage: I,
+				totalItems: V,
+				hasNextPage: H,
 				emptyIllustration: "empty-people",
 				emptyTitle: "No customers yet",
 				emptyDescription: "Add your first customer to start booking deliveries for them.",
-				emptyAction: /* @__PURE__ */ S(f, {
-					onClick: () => V("customers/new"),
-					children: [/* @__PURE__ */ x(n, {
+				emptyAction: /* @__PURE__ */ w(f, {
+					onClick: () => q("customers/new"),
+					children: [/* @__PURE__ */ C(n, {
 						size: 16,
 						className: "mr-1.5"
 					}), "Add Customer"]
@@ -174,4 +180,4 @@ function T() {
 	});
 }
 //#endregion
-export { T as default };
+export { D as default };