@burdenoff/microfe-movethewheels 2026.1030.1 → 2026.1031.2

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/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/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 };