@burdenoff/microfe-movethewheels 2026.1011.1 → 2026.1011.2

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

@@ -0,0 +1,45 @@
+export interface ShipmentSourceDraft {
+    integrationId: string;
+    basisTrackingEventId: string;
+    maxSourceAgeSeconds: string;
+    maxFutureSkewSeconds: string;
+    reason: string;
+}
+export declare function statusDecisionReason(value: string): string;
+export declare function shipmentSourceInput(draft: ShipmentSourceDraft, expectedStatusRevision: number): {
+    expectedStatusRevision: number;
+    integrationId: string;
+    basisTrackingEventId: string;
+    maxSourceAgeSeconds: number;
+    maxFutureSkewSeconds: number;
+    reason: string;
+};
+interface StatusAcknowledgement {
+    id: string;
+    status: string;
+    statusRevision: number;
+    statusAuthority: string;
+    statusAuthorityEpoch: number;
+    designatedIntegrationId?: string | null;
+    statusBasisEventId?: string | null;
+    statusBasisSourceTime?: string | null;
+    maxSourceAgeSeconds?: number | null;
+    maxFutureSkewSeconds?: number | null;
+}
+export declare function sourceStatusAcknowledged(actual: StatusAcknowledgement | null | undefined, expected: {
+    id: string;
+    epoch: number;
+    input: ReturnType<typeof shipmentSourceInput>;
+    basis: {
+        id: string;
+        eventType: string;
+        providerEventTime?: string | null;
+    } | undefined;
+}): boolean;
+export declare function manualStatusAcknowledged(actual: StatusAcknowledgement | null | undefined, expected: {
+    id: string;
+    revision: number;
+    epoch: number;
+    status: string;
+}): boolean;
+export {};

package/dist/pages/DeliveryCapturePage.js

@@ -8,19 +8,22 @@ import { PenLine as o } from "../node_modules/lucide-react/dist/esm/icons/pen-li
 import { Truck as s } from "../node_modules/lucide-react/dist/esm/icons/truck.js";
 import { Type as c } from "../node_modules/lucide-react/dist/esm/icons/type.js";
 import { Upload as l } from "../node_modules/lucide-react/dist/esm/icons/upload.js";
-import { mapOrderPriority as u, mapOrderStatus as d } from "../hooks/useOrders.js";
-import { useCaptureEpod as f, useEpodPhotoUpload as p, useMyPendingEpodDeliveryJobs as m } from "../hooks/useEpod.js";
-import { Button as h, Card as g, CardContent as _, CardHeader as v, CardTitle as y, Input as b, Label as x, Textarea as S } from "../components/ui.js";
-import { PageLayout as C } from "../components/PageLayout.js";
-import { PriorityBadge as w, StatusBadge as T } from "../components/StatusBadge.js";
-import { FormError as E } from "../components/FormError.js";
-import { Notice as D, useNotice as O } from "../components/Notice.js";
-import { formatAddress as k, formatDate as A } from "../utils/formatters.js";
-import { SignaturePad as j } from "../components/SignaturePad.js";
-import { useRef as M, useState as N } from "react";
-import { Fragment as P, jsx as F, jsxs as I } from "react/jsx-runtime";
+import { useMoveTheWheels as u } from "../providers/MoveTheWheelsProvider.js";
+import { mapOrderPriority as d, mapOrderStatus as f } from "../hooks/useOrders.js";
+import { useShipmentStatusQuery as p } from "../hooks/useShipmentStatusAuthority.js";
+import { useCaptureEpod as m, useEpodPhotoUpload as h, useMyPendingEpodDeliveryJobs as g } from "../hooks/useEpod.js";
+import { Button as _, Card as v, CardContent as y, CardHeader as b, CardTitle as x, Input as S, Label as C, Textarea as w } from "../components/ui.js";
+import { PageLayout as T } from "../components/PageLayout.js";
+import { PriorityBadge as E, StatusBadge as D } from "../components/StatusBadge.js";
+import { FormError as O } from "../components/FormError.js";
+import { Notice as k, useNotice as A } from "../components/Notice.js";
+import { formatAddress as j, formatDate as M } from "../utils/formatters.js";
+import { SignaturePad as N } from "../components/SignaturePad.js";
+import { StatusAuthorityOwnedDeliveryDocument as P } from "../src/generated/shipment-status-authority-operations.js";
+import { useEffect as ee, useRef as F, useState as I } from "react";
+import { Fragment as te, jsx as L, jsxs as R } from "react/jsx-runtime";
 //#region src/movethewheels/pages/DeliveryCapturePage.tsx
-function L() {
+function ne() {
 	return new Promise((e) => {
 		if (!navigator.geolocation) {
 			e(null);
@@ -33,242 +36,304 @@ function L() {
 		});
 	});
 }
-function R({ job: e, onCaptured: t, onCancel: a }) {
-	let { captureEpod: u, isSubmitting: d, error: m } = f(), { upload: C, isUploading: w, error: T } = p(), D = M(null), [O, A] = N(""), [R, z] = N("drawn"), [B, V] = N(""), [H, U] = N(null), [W, G] = N(""), [K, q] = N(null), J = async () => {
-		q(null);
-		let n = O.trim();
+function z({ job: e, onCaptured: t, onCancel: a }) {
+	let { captureEpod: u, isSubmitting: d, error: f, captureFeedback: g } = m(), [T, E] = I(0), D = p(P, { deliveryJobId: e.id }, T), [k, A] = I(!1), M = F(null), z = F(!1), B = F(!0);
+	ee(() => (B.current = !0, () => {
+		B.current = !1;
+	}), []);
+	let [re, V] = I(!1), [H, ie] = I(0), { upload: ae, isUploading: oe, error: U } = h(), W = F(null), [G, se] = I(""), [K, q] = I("drawn"), [J, ce] = I(""), [Y, le] = I(null), [X, ue] = I(""), [Z, Q] = I(null), de = async () => {
+		if (z.current) return;
+		if (Q(null), D.loading || D.error || !D.data || T < H || !k || g?.kind === "UNKNOWN") {
+			Q("Review the current linked shipment status and confirm completion before capture. Do not resend an uncertain capture.");
+			return;
+		}
+		let n = G.trim();
 		if (!n) {
-			q("Recipient name is required.");
+			Q("Recipient name is required.");
 			return;
 		}
-		let r = R === "typed" ? B.trim() : D.current?.toDataUrl() ?? null;
+		let r = K === "typed" ? J.trim() : W.current?.toDataUrl() ?? null;
 		if (!r) {
-			q(R === "typed" ? "Type the recipient full name as their signature." : "A signature is required.");
+			Q(K === "typed" ? "Type the recipient full name as their signature." : "A signature is required.");
 			return;
 		}
+		z.current = !0, V(!0);
 		try {
 			let i;
-			H && (i = [(await C(H)).fileId]);
-			let a = await L();
+			if (Y) if (M.current?.file === Y) i = [M.current.id];
+			else {
+				let e = await ae(Y);
+				M.current = {
+					file: Y,
+					id: e.fileId
+				}, i = [e.fileId];
+			}
+			if (!B.current) return;
+			let a = await ne();
+			if (!B.current) return;
 			await u({
+				expectedShipmentId: D.data.myEpodShipmentStatus?.id ?? null,
+				expectedShipmentStatusRevision: D.data.myEpodShipmentStatus?.statusRevision,
+				completionAttestation: k,
 				deliveryJobId: e.id,
 				recipientName: n,
-				signatureType: R,
+				signatureType: K,
 				signatureData: r,
 				photoFileIds: i,
 				latitude: a?.coords.latitude,
 				longitude: a?.coords.longitude,
 				locationAccuracy: a?.coords.accuracy,
-				notes: W.trim() || void 0
+				notes: X.trim() || void 0
 			}), t();
-		} catch {}
-	}, Y = d || w;
-	return /* @__PURE__ */ I(g, { children: [/* @__PURE__ */ F(v, { children: /* @__PURE__ */ I(y, {
+		} catch {
+			A(!1), ie(T + 1);
+		} finally {
+			z.current = !1, V(!1);
+		}
+	}, $ = d || oe || re;
+	return /* @__PURE__ */ R(v, { children: [/* @__PURE__ */ L(b, { children: /* @__PURE__ */ R(x, {
 		className: "flex items-center gap-2",
 		children: [
-			/* @__PURE__ */ F(s, { size: 18 }),
+			/* @__PURE__ */ L(s, { size: 18 }),
 			" Capture delivery for ",
 			e.deliveryJobNumber
 		]
-	}) }), /* @__PURE__ */ I(_, {
+	}) }), /* @__PURE__ */ R(y, {
 		className: "space-y-4",
 		children: [
-			/* @__PURE__ */ I("div", {
+			/* @__PURE__ */ R("div", {
 				className: "text-sm text-text-secondary space-y-1",
-				children: [e.customerName && /* @__PURE__ */ I("p", { children: ["Recipient on file: ", e.customerName] }), e.deliveryAddress && /* @__PURE__ */ F("p", { children: k(e.deliveryAddress) })]
+				children: [e.customerName && /* @__PURE__ */ R("p", { children: ["Recipient on file: ", e.customerName] }), e.deliveryAddress && /* @__PURE__ */ L("p", { children: j(e.deliveryAddress) })]
+			}),
+			/* @__PURE__ */ R("section", {
+				"aria-label": "Linked shipment status",
+				className: "space-y-2",
+				children: [
+					/* @__PURE__ */ R("p", { children: [
+						"Recorded shipment:",
+						" ",
+						D.data?.myEpodShipmentStatus ? `${D.data.myEpodShipmentStatus.status.toLowerCase().replaceAll("_", " ")} · revision ${D.data.myEpodShipmentStatus.statusRevision}` : D.data ? "No linked shipment" : "Loading current record"
+					] }),
+					D.error && /* @__PURE__ */ L("p", {
+						role: "alert",
+						children: D.error
+					}),
+					/* @__PURE__ */ L(_, {
+						variant: "outline",
+						disabled: D.loading || $,
+						onClick: () => {
+							A(!1), E((e) => e + 1);
+						},
+						children: "Refresh linked status"
+					}),
+					/* @__PURE__ */ R("label", {
+						className: "flex items-start gap-2",
+						children: [/* @__PURE__ */ L("input", {
+							type: "checkbox",
+							checked: k,
+							disabled: D.loading || !!D.error || $ || T < H || g?.kind === "UNKNOWN",
+							onChange: (e) => A(e.target.checked)
+						}), "I reviewed the recorded linked status and attest to this delivery completion."]
+					}),
+					/* @__PURE__ */ L("p", { children: "This records an assigned driver's attestation; it does not independently verify physical freight movement." }),
+					g && /* @__PURE__ */ L("p", {
+						role: "status",
+						children: g.message
+					})
+				]
 			}),
-			/* @__PURE__ */ I("div", {
+			/* @__PURE__ */ R("div", {
 				className: "space-y-1.5",
-				children: [/* @__PURE__ */ F(x, {
+				children: [/* @__PURE__ */ L(C, {
 					htmlFor: "epod-recipient-name",
 					children: "Recipient name"
-				}), /* @__PURE__ */ F(b, {
+				}), /* @__PURE__ */ L(S, {
 					id: "epod-recipient-name",
-					value: O,
-					onChange: (e) => A(e.target.value),
+					value: G,
+					onChange: (e) => se(e.target.value),
 					placeholder: "Who received the delivery?"
 				})]
 			}),
-			/* @__PURE__ */ I("div", {
+			/* @__PURE__ */ R("div", {
 				className: "space-y-1.5",
 				children: [
-					/* @__PURE__ */ F(x, { children: "Signature" }),
-					/* @__PURE__ */ I("div", {
+					/* @__PURE__ */ L(C, { children: "Signature" }),
+					/* @__PURE__ */ R("div", {
 						className: "flex gap-2",
-						children: [/* @__PURE__ */ I(h, {
+						children: [/* @__PURE__ */ R(_, {
 							type: "button",
-							variant: R === "drawn" ? "default" : "outline",
+							variant: K === "drawn" ? "default" : "outline",
 							size: "sm",
-							onClick: () => z("drawn"),
-							children: [/* @__PURE__ */ F(o, { size: 14 }), " Draw"]
-						}), /* @__PURE__ */ I(h, {
+							onClick: () => q("drawn"),
+							children: [/* @__PURE__ */ L(o, { size: 14 }), " Draw"]
+						}), /* @__PURE__ */ R(_, {
 							type: "button",
-							variant: R === "typed" ? "default" : "outline",
+							variant: K === "typed" ? "default" : "outline",
 							size: "sm",
-							onClick: () => z("typed"),
-							children: [/* @__PURE__ */ F(c, { size: 14 }), " Type name instead"]
+							onClick: () => q("typed"),
+							children: [/* @__PURE__ */ L(c, { size: 14 }), " Type name instead"]
 						})]
 					}),
-					R === "drawn" ? /* @__PURE__ */ F(j, { ref: D }) : /* @__PURE__ */ F(b, {
-						value: B,
-						onChange: (e) => V(e.target.value),
+					K === "drawn" ? /* @__PURE__ */ L(N, { ref: W }) : /* @__PURE__ */ L(S, {
+						value: J,
+						onChange: (e) => ce(e.target.value),
 						placeholder: "Type full name as signature"
 					})
 				]
 			}),
-			/* @__PURE__ */ I("div", {
+			/* @__PURE__ */ R("div", {
 				className: "space-y-1.5",
 				children: [
-					/* @__PURE__ */ F(x, {
+					/* @__PURE__ */ L(C, {
 						htmlFor: "epod-photo",
 						children: "Delivery photo (optional)"
 					}),
-					/* @__PURE__ */ I("div", {
+					/* @__PURE__ */ R("div", {
 						className: "flex items-center gap-2",
-						children: [/* @__PURE__ */ F("input", {
+						children: [/* @__PURE__ */ L("input", {
 							id: "epod-photo",
 							type: "file",
 							accept: "image/*",
 							capture: "environment",
-							onChange: (e) => U(e.target.files?.[0] ?? null),
+							onChange: (e) => le(e.target.files?.[0] ?? null),
 							className: "text-sm"
-						}), H && /* @__PURE__ */ F(l, {
+						}), Y && /* @__PURE__ */ L(l, {
 							size: 14,
 							className: "text-text-secondary"
 						})]
 					}),
-					H && /* @__PURE__ */ F("p", {
+					Y && /* @__PURE__ */ L("p", {
 						className: "text-xs text-text-secondary",
-						children: H.name
+						children: Y.name
 					})
 				]
 			}),
-			/* @__PURE__ */ I("div", {
+			/* @__PURE__ */ R("div", {
 				className: "space-y-1.5",
-				children: [/* @__PURE__ */ F(x, {
+				children: [/* @__PURE__ */ L(C, {
 					htmlFor: "epod-notes",
 					children: "Notes (optional)"
-				}), /* @__PURE__ */ F(S, {
+				}), /* @__PURE__ */ L(w, {
 					id: "epod-notes",
-					value: W,
-					onChange: (e) => G(e.target.value),
+					value: X,
+					onChange: (e) => ue(e.target.value),
 					placeholder: "e.g. Left with front desk, gate code used, etc.",
 					rows: 2
 				})]
 			}),
-			/* @__PURE__ */ I("p", {
+			/* @__PURE__ */ R("p", {
 				className: "flex items-center gap-1.5 text-xs text-text-secondary",
-				children: [/* @__PURE__ */ F(i, { size: 12 }), " Device GPS is captured automatically when permitted by the browser."]
+				children: [/* @__PURE__ */ L(i, { size: 12 }), " Device GPS is captured automatically when permitted by the browser."]
 			}),
-			K && /* @__PURE__ */ F(E, { message: K }),
-			m && /* @__PURE__ */ F(E, { message: m.message }),
-			T && /* @__PURE__ */ F(E, { message: T.message }),
-			/* @__PURE__ */ I("div", {
+			Z && /* @__PURE__ */ L(O, { message: Z }),
+			f && /* @__PURE__ */ L(O, { message: f.message }),
+			U && /* @__PURE__ */ L(O, { message: U.message }),
+			/* @__PURE__ */ R("div", {
 				className: "flex gap-2 justify-end",
-				children: [/* @__PURE__ */ F(h, {
+				children: [/* @__PURE__ */ L(_, {
 					type: "button",
 					variant: "outline",
 					onClick: a,
-					disabled: Y,
+					disabled: $,
 					children: "Cancel"
-				}), /* @__PURE__ */ F(h, {
+				}), /* @__PURE__ */ L(_, {
 					type: "button",
-					onClick: () => void J(),
-					disabled: Y,
-					children: Y ? /* @__PURE__ */ I(P, { children: [/* @__PURE__ */ F(r, {
+					onClick: () => void de(),
+					disabled: $ || D.loading || !!D.error || !D.data || T < H || !k || g?.kind === "UNKNOWN",
+					children: $ ? /* @__PURE__ */ R(te, { children: [/* @__PURE__ */ L(r, {
 						size: 14,
 						className: "animate-spin"
-					}), " Submitting…"] }) : /* @__PURE__ */ I(P, { children: [/* @__PURE__ */ F(n, { size: 14 }), " Confirm delivery"] })
+					}), " Submitting…"] }) : /* @__PURE__ */ R(te, { children: [/* @__PURE__ */ L(n, { size: 14 }), " Confirm delivery"] })
 				})]
 			})
 		]
 	})] });
 }
-function z() {
-	let [r, i] = N(0), { jobs: o, hasMore: c, isLoading: l, error: f, refetch: p } = m({
+function B() {
+	let { workspaceId: r, tenantId: i, currentUser: o, apiGatewayUrl: c } = u(), [l, p] = I(0), { jobs: m, hasMore: h, isLoading: b, error: x, refetch: S } = g({
 		limit: 20,
-		offset: r * 20
-	}), [v, y] = N(null), { message: b, notify: x } = O();
-	return /* @__PURE__ */ F(C, {
+		offset: l * 20
+	}), [C, w] = I(null), { message: N, notify: P } = A();
+	return /* @__PURE__ */ L(T, {
 		title: "My Deliveries",
 		subtitle: "Capture proof of delivery for your assigned stops",
-		icon: /* @__PURE__ */ F(s, { size: 24 }),
-		children: /* @__PURE__ */ I("div", {
+		icon: /* @__PURE__ */ L(s, { size: 24 }),
+		children: /* @__PURE__ */ R("div", {
 			className: "space-y-4",
-			children: [/* @__PURE__ */ F(D, { message: b }), v ? /* @__PURE__ */ F(R, {
-				job: v,
+			children: [/* @__PURE__ */ L(k, { message: N }), C ? /* @__PURE__ */ L(z, {
+				job: C,
 				onCaptured: () => {
-					x("Proof of delivery captured — delivery marked complete."), y(null), i(0), p();
+					P("Proof of delivery captured — delivery marked complete."), w(null), p(0), S();
 				},
-				onCancel: () => y(null)
-			}) : l ? /* @__PURE__ */ F("p", {
+				onCancel: () => w(null)
+			}, `${r}:${i}:${o?.id}:${c}:${C.id}`) : b ? /* @__PURE__ */ L("p", {
 				className: "text-text-secondary text-center py-8",
 				children: "Loading your deliveries…"
-			}) : f ? /* @__PURE__ */ F(E, { message: f.message }) : o.length > 0 ? /* @__PURE__ */ I("div", {
+			}) : x ? /* @__PURE__ */ L(O, { message: x.message }) : m.length > 0 ? /* @__PURE__ */ R("div", {
 				className: "space-y-3",
-				children: [o.map((e) => /* @__PURE__ */ F(g, { children: /* @__PURE__ */ I(_, {
+				children: [m.map((e) => /* @__PURE__ */ L(v, { children: /* @__PURE__ */ R(y, {
 					className: "flex items-center justify-between gap-3 py-4",
-					children: [/* @__PURE__ */ I("div", {
+					children: [/* @__PURE__ */ R("div", {
 						className: "min-w-0",
 						children: [
-							/* @__PURE__ */ I("p", {
+							/* @__PURE__ */ R("p", {
 								className: "font-medium flex items-center gap-2",
 								children: [
-									/* @__PURE__ */ F(a, { size: 16 }),
+									/* @__PURE__ */ L(a, { size: 16 }),
 									" ",
 									e.deliveryJobNumber
 								]
 							}),
-							/* @__PURE__ */ I("div", {
+							/* @__PURE__ */ R("div", {
 								className: "flex flex-wrap items-center gap-1.5 py-1",
-								children: [/* @__PURE__ */ F(T, {
-									status: d(e.status),
+								children: [/* @__PURE__ */ L(D, {
+									status: f(e.status),
 									type: "order",
 									size: "sm"
-								}), /* @__PURE__ */ F(w, {
-									priority: u(e.priority),
+								}), /* @__PURE__ */ L(E, {
+									priority: d(e.priority),
 									size: "sm"
 								})]
 							}),
-							e.deliveryAddress && /* @__PURE__ */ F("p", {
+							e.deliveryAddress && /* @__PURE__ */ L("p", {
 								className: "text-sm text-text-secondary truncate",
-								children: k(e.deliveryAddress)
+								children: j(e.deliveryAddress)
 							}),
-							e.scheduledDelivery && /* @__PURE__ */ I("p", {
+							e.scheduledDelivery && /* @__PURE__ */ R("p", {
 								className: "text-xs text-text-secondary",
-								children: ["Scheduled ", A(e.scheduledDelivery, "short")]
+								children: ["Scheduled ", M(e.scheduledDelivery, "short")]
 							})
 						]
-					}), /* @__PURE__ */ F(h, {
+					}), /* @__PURE__ */ L(_, {
 						type: "button",
 						size: "sm",
-						onClick: () => y(e),
+						onClick: () => w(e),
 						children: "Capture"
 					})]
-				}) }, e.id)), (r > 0 || c) && /* @__PURE__ */ I("div", {
+				}) }, e.id)), (l > 0 || h) && /* @__PURE__ */ R("div", {
 					className: "flex justify-end gap-2 pt-2",
-					children: [/* @__PURE__ */ I(h, {
+					children: [/* @__PURE__ */ R(_, {
 						type: "button",
 						variant: "outline",
 						size: "sm",
-						disabled: r === 0 || l,
-						onClick: () => i((e) => Math.max(0, e - 1)),
-						children: [/* @__PURE__ */ F(e, { size: 16 }), " Previous"]
-					}), /* @__PURE__ */ I(h, {
+						disabled: l === 0 || b,
+						onClick: () => p((e) => Math.max(0, e - 1)),
+						children: [/* @__PURE__ */ L(e, { size: 16 }), " Previous"]
+					}), /* @__PURE__ */ R(_, {
 						type: "button",
 						variant: "outline",
 						size: "sm",
-						disabled: !c || l,
-						onClick: () => i((e) => e + 1),
-						children: ["Next ", /* @__PURE__ */ F(t, { size: 16 })]
+						disabled: !h || b,
+						onClick: () => p((e) => e + 1),
+						children: ["Next ", /* @__PURE__ */ L(t, { size: 16 })]
 					})]
 				})]
-			}) : /* @__PURE__ */ I("div", {
+			}) : /* @__PURE__ */ R("div", {
 				className: "text-center py-12",
-				children: [/* @__PURE__ */ F(n, {
+				children: [/* @__PURE__ */ L(n, {
 					size: 40,
 					className: "mx-auto mb-3 text-text-secondary opacity-50"
-				}), /* @__PURE__ */ F("p", {
+				}), /* @__PURE__ */ L("p", {
 					className: "text-text-secondary",
 					children: "No deliveries awaiting proof of delivery."
 				})]
@@ -277,4 +342,4 @@ function z() {
 	});
 }
 //#endregion
-export { z as default };
+export { B as default };