@burdenoff/microfe-movethewheels 2026.1010.2 → 2026.1011.2

package/dist/hooks/useEpod.js

@@ -1,24 +1,26 @@
 import { useMoveTheWheels as e } from "../providers/MoveTheWheelsProvider.js";
 import { executeGraphQL as t } from "../utils/graphqlClient.js";
-import { useCallback as n, useEffect as r, useMemo as i, useState as a } from "react";
+import { useShipmentStatusCommand as n } from "./useShipmentStatusAuthority.js";
+import { useCallback as r, useEffect as i, useMemo as a, useState as o } from "react";
+import { parse as s } from "graphql";
 //#region src/movethewheels/hooks/useEpod.ts
-var o = "\n  id\n  deliveryJobId\n  shipmentId\n  recipientName\n  signatureType\n  signatureData\n  photoFileIds\n  latitude\n  longitude\n  locationAccuracy\n  deliveredAt\n  capturedByDriverId\n  notes\n", s = `
+var c = "\n  id\n  deliveryJobId\n  shipmentId\n  recipientName\n  signatureType\n  signatureData\n  photoFileIds\n  latitude\n  longitude\n  locationAccuracy\n  deliveredAt\n  capturedByDriverId\n  notes\n", l = `
   query GetEpod($deliveryJobId: ID!) {
     epod(deliveryJobId: $deliveryJobId) {
-      ${o}
+      ${c}
     }
   }
-`, c = "\n  query MyPendingEpodDeliveryJobs($pagination: PaginationInput) {\n    myPendingEpodDeliveryJobs(pagination: $pagination) {\n      id\n      deliveryJobNumber\n      status\n      priority\n      deliveryAddress\n      scheduledDelivery\n      customer {\n        name\n        phone\n      }\n    }\n    myPendingEpodDeliveryJobsCount\n  }\n", l = `
+`, u = "\n  query MyPendingEpodDeliveryJobs($pagination: PaginationInput) {\n    myPendingEpodDeliveryJobs(pagination: $pagination) {\n      id\n      deliveryJobNumber\n      status\n      priority\n      deliveryAddress\n      scheduledDelivery\n      customer {\n        name\n        phone\n      }\n    }\n    myPendingEpodDeliveryJobsCount\n  }\n", d = s(`
   mutation CaptureEpod($input: CaptureEpodInput!) {
     captureEpod(input: $input) {
-      ${o}
+      ${c}
     }
   }
-`, u = "\n  mutation EpodInitiateUpload($input: InitiateUploadInput!) {\n    initiateUpload(input: $input) {\n      uploadUrl\n      session { id }\n    }\n  }\n", d = "\n  mutation EpodCompleteUpload($input: CompleteUploadInput!) {\n    completeUpload(input: $input) {\n      fileId\n    }\n  }\n", f = "\n  query EpodFileUrl($id: ID!, $expiresIn: Int) {\n    getFileDownloadUrl(id: $id, expiresIn: $expiresIn)\n  }\n", p = 21600;
-function m(e) {
+`), f = "\n  mutation EpodInitiateUpload($input: InitiateUploadInput!) {\n    initiateUpload(input: $input) {\n      uploadUrl\n      session { id }\n    }\n  }\n", p = "\n  mutation EpodCompleteUpload($input: CompleteUploadInput!) {\n    completeUpload(input: $input) {\n      fileId\n    }\n  }\n", m = "\n  query EpodFileUrl($id: ID!, $expiresIn: Int) {\n    getFileDownloadUrl(id: $id, expiresIn: $expiresIn)\n  }\n", h = 21600;
+function g(e) {
 	return e === "typed" ? "TYPED" : "DRAWN";
 }
-function h(e) {
+function _(e) {
 	return {
 		id: e.id,
 		deliveryJobId: e.deliveryJobId,
@@ -35,58 +37,58 @@ function h(e) {
 		notes: e.notes ?? void 0
 	};
 }
-function g() {
-	let { apiGatewayUrl: t, authToken: n, workspaceToken: r, workspaceId: a, tenantId: o, currentUser: s } = e();
-	return i(() => ({
+function v() {
+	let { apiGatewayUrl: t, authToken: n, workspaceToken: r, workspaceId: i, tenantId: o, currentUser: s } = e();
+	return a(() => ({
 		apiGatewayUrl: t,
 		authToken: n,
 		workspaceToken: r,
-		workspaceId: a,
+		workspaceId: i,
 		tenantId: o,
 		actorId: s?.id
 	}), [
 		t,
 		n,
 		r,
-		a,
+		i,
 		o,
 		s?.id
 	]);
 }
-function _(e) {
-	let i = g(), [o, c] = a(null), [l, u] = a(!1), [d, f] = a(null), p = n(async () => {
+function y(e) {
+	let n = v(), [a, s] = o(null), [c, u] = o(!1), [d, f] = o(null), p = r(async () => {
 		if (!e) {
-			c(null);
+			s(null);
 			return;
 		}
 		u(!0), f(null);
 		try {
-			let n = await t(i, s, { deliveryJobId: e });
-			c(n.epod ? h(n.epod) : null);
+			let r = await t(n, l, { deliveryJobId: e });
+			s(r.epod ? _(r.epod) : null);
 		} catch (e) {
-			f(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to load proof of delivery")), c(null);
+			f(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to load proof of delivery")), s(null);
 		} finally {
 			u(!1);
 		}
-	}, [e, i]);
-	return r(() => {
+	}, [e, n]);
+	return i(() => {
 		p();
 	}, [p]), {
-		epod: o,
-		isLoading: l,
+		epod: a,
+		isLoading: c,
 		error: d,
 		refetch: p
 	};
 }
-function v(e = {}) {
-	let { limit: i = 20, offset: o = 0 } = e, s = g(), [l, u] = a([]), [d, f] = a(0), [p, m] = a(!1), [h, _] = a(!1), [v, y] = a(null), b = n(async () => {
-		_(!0), y(null);
+function b(e = {}) {
+	let { limit: n = 20, offset: a = 0 } = e, s = v(), [c, l] = o([]), [d, f] = o(0), [p, m] = o(!1), [h, g] = o(!1), [_, y] = o(null), b = r(async () => {
+		g(!0), y(null);
 		try {
-			let e = await t(s, c, { pagination: {
-				limit: i,
-				offset: o
+			let e = await t(s, u, { pagination: {
+				limit: n,
+				offset: a
 			} });
-			f(e.myPendingEpodDeliveryJobsCount ?? 0), m(o + e.myPendingEpodDeliveryJobs.length < e.myPendingEpodDeliveryJobsCount), u(e.myPendingEpodDeliveryJobs.map((e) => ({
+			f(e.myPendingEpodDeliveryJobsCount ?? 0), m(a + e.myPendingEpodDeliveryJobs.length < e.myPendingEpodDeliveryJobsCount), l(e.myPendingEpodDeliveryJobs.map((e) => ({
 				id: e.id,
 				deliveryJobNumber: e.deliveryJobNumber,
 				status: e.status,
@@ -97,61 +99,67 @@ function v(e = {}) {
 				customerPhone: e.customer?.phone ?? void 0
 			})));
 		} catch (e) {
-			y(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to load pending deliveries")), u([]);
+			y(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to load pending deliveries")), l([]);
 		} finally {
-			_(!1);
+			g(!1);
 		}
 	}, [
 		s,
-		i,
-		o
+		n,
+		a
 	]);
-	return r(() => {
+	return i(() => {
 		b();
 	}, [b]), {
-		jobs: l,
+		jobs: c,
 		totalJobs: d,
 		hasMore: p,
 		isLoading: h,
-		error: v,
+		error: _,
 		refetch: b
 	};
 }
-function y() {
-	let e = g(), [r, i] = a(!1), [o, s] = a(null);
+function x(e, t) {
+	return !!e && typeof e.id == "string" && e.id.trim().length > 0 && e.deliveryJobId === t.deliveryJobId && e.shipmentId === t.expectedShipmentId && e.recipientName === t.recipientName && e.signatureType === g(t.signatureType) && e.signatureData === t.signatureData && typeof e.capturedByDriverId == "string" && e.capturedByDriverId.trim().length > 0 && typeof e.deliveredAt == "string" && Number.isFinite(Date.parse(e.deliveredAt)) && Array.isArray(e.photoFileIds) && e.photoFileIds.length === (t.photoFileIds ?? []).length && e.photoFileIds.every((e, n) => e === (t.photoFileIds ?? [])[n]) && e.latitude === (t.latitude ?? null) && e.longitude === (t.longitude ?? null) && e.locationAccuracy === (t.locationAccuracy ?? null) && e.notes === (t.notes ?? null);
+}
+function S() {
+	let e = n(), [t, i] = o(null);
 	return {
-		captureEpod: n(async (n) => {
-			i(!0), s(null);
+		captureEpod: r(async (t) => {
+			i(null);
 			try {
-				return h((await t(e, l, { input: {
-					deliveryJobId: n.deliveryJobId,
-					recipientName: n.recipientName,
-					signatureType: m(n.signatureType),
-					signatureData: n.signatureData,
-					photoFileIds: n.photoFileIds,
-					latitude: n.latitude,
-					longitude: n.longitude,
-					locationAccuracy: n.locationAccuracy,
-					notes: n.notes
-				} })).captureEpod);
+				let n = await e.run(d, { input: {
+					expectedShipmentStatusRevision: t.expectedShipmentStatusRevision,
+					completionAttestation: t.completionAttestation,
+					deliveryJobId: t.deliveryJobId,
+					recipientName: t.recipientName,
+					signatureType: g(t.signatureType),
+					signatureData: t.signatureData,
+					photoFileIds: t.photoFileIds,
+					latitude: t.latitude,
+					longitude: t.longitude,
+					locationAccuracy: t.locationAccuracy,
+					notes: t.notes
+				} }, (e) => x(e.captureEpod, t));
+				if (!n) throw Error("Capture was not acknowledged. Review the recorded status and the capture message before taking further action.");
+				return _(n.captureEpod);
 			} catch (e) {
 				let t = e instanceof Error ? e : /* @__PURE__ */ Error("Failed to capture proof of delivery");
-				throw s(t), t;
-			} finally {
-				i(!1);
+				throw i(t), t;
 			}
 		}, [e]),
-		isSubmitting: r,
-		error: o
+		isSubmitting: e.busy,
+		error: t,
+		captureFeedback: e.feedback
 	};
 }
-function b() {
-	let e = g(), [r, i] = a(!1), [o, s] = a(0), [c, l] = a(null);
+function C() {
+	let e = v(), [n, i] = o(!1), [a, s] = o(0), [c, l] = o(null);
 	return {
-		upload: n(async (n) => {
+		upload: r(async (n) => {
 			i(!0), s(0), l(null);
 			try {
-				let r = n.name.lastIndexOf("."), i = r > -1 ? n.name.slice(r + 1) : "", a = n.type || "application/octet-stream", o = await t(e, u, { input: {
+				let r = n.name.lastIndexOf("."), i = r > -1 ? n.name.slice(r + 1) : "", a = n.type || "application/octet-stream", o = await t(e, f, { input: {
 					fileName: n.name,
 					extension: i,
 					mimeType: a,
@@ -160,18 +168,18 @@ function b() {
 				} }), { uploadUrl: c } = o.initiateUpload, l = o.initiateUpload.session.id;
 				if (!c) throw Error("The file service did not return an upload URL.");
 				s(50);
-				let f = await fetch(c, {
+				let u = await fetch(c, {
 					method: "PUT",
 					headers: { "Content-Type": a },
 					body: n
 				});
-				if (!f.ok) throw Error(`File storage rejected the upload (HTTP ${f.status}).`);
-				let p = await t(e, d, { input: {
+				if (!u.ok) throw Error(`File storage rejected the upload (HTTP ${u.status}).`);
+				let d = await t(e, p, { input: {
 					sessionId: l,
 					fileSize: String(n.size)
 				} });
 				return s(100), {
-					fileId: p.completeUpload.fileId,
+					fileId: d.completeUpload.fileId,
 					fileName: n.name
 				};
 			} catch (e) {
@@ -181,35 +189,35 @@ function b() {
 				i(!1);
 			}
 		}, [e]),
-		isUploading: r,
-		progress: o,
+		isUploading: n,
+		progress: a,
 		error: c
 	};
 }
-function x(e) {
-	let n = g(), [i, o] = a(null), [s, c] = a(!1);
-	return r(() => {
+function w(e) {
+	let n = v(), [r, a] = o(null), [s, c] = o(!1);
+	return i(() => {
 		if (!e) {
-			o(null);
+			a(null);
 			return;
 		}
 		let r = !1;
-		return c(!0), t(n, f, {
+		return c(!0), t(n, m, {
 			id: e,
-			expiresIn: p
+			expiresIn: h
 		}).then((e) => {
-			r || o(e.getFileDownloadUrl ?? null);
+			r || a(e.getFileDownloadUrl ?? null);
 		}).catch(() => {
-			r || o(null);
+			r || a(null);
 		}).finally(() => {
 			r || c(!1);
 		}), () => {
 			r = !0;
 		};
 	}, [e, n]), {
-		url: i,
+		url: r,
 		isLoading: s
 	};
 }
 //#endregion
-export { y as useCaptureEpod, _ as useEpod, b as useEpodPhotoUpload, x as useEpodPhotoUrl, v as useMyPendingEpodDeliveryJobs };
+export { S as useCaptureEpod, y as useEpod, C as useEpodPhotoUpload, w as useEpodPhotoUrl, b as useMyPendingEpodDeliveryJobs };

package/dist/hooks/useShipmentStatusAuthority.js

@@ -0,0 +1,127 @@
+import { useMoveTheWheels as e } from "../providers/MoveTheWheelsProvider.js";
+import { useCallback as t, useEffect as n, useMemo as r, useRef as i, useState as a } from "react";
+import { print as o } from "graphql";
+import { clearGraphqlFetchResponseCache as s, graphqlFetch as c } from "@burdenoff/fe-libs/shared/graphql";
+//#region src/movethewheels/hooks/useShipmentStatusAuthority.ts
+var l = new Set([
+	"STATUS_REVISION_CONFLICT",
+	"BAD_USER_INPUT",
+	"FORBIDDEN",
+	"UNAUTHENTICATED",
+	"NOT_FOUND"
+]), u = class extends Error {
+	code;
+	constructor(e, t) {
+		super(e), this.code = t, this.name = "ShipmentStatusRequestError";
+	}
+};
+function d() {
+	let { apiGatewayUrl: n, authToken: i, workspaceToken: a, workspaceId: s, tenantId: l } = e(), d = r(() => ({
+		apiGatewayUrl: n,
+		authToken: i,
+		workspaceToken: a,
+		workspaceId: s,
+		tenantId: l
+	}), [
+		n,
+		i,
+		a,
+		s,
+		l
+	]);
+	return t(async (e, t, n = !1, r) => {
+		let i = await c({
+			gateway: "workspace",
+			query: o(e),
+			variables: t,
+			baseUrl: d.apiGatewayUrl,
+			authToken: d.authToken,
+			workspaceToken: d.workspaceToken || !0,
+			workspaceId: d.workspaceId || !0,
+			tenantId: d.tenantId || !0,
+			organizationId: !0,
+			signal: r,
+			skipAuthRetry: n
+		});
+		if (i.errors?.length) {
+			let e = i.errors[0], t = i.data === null && i.errors.length === 1 && typeof e?.extensions?.code == "string" ? e.extensions.code : null;
+			throw new u(e?.message ?? "Unable to load the recorded status.", t);
+		}
+		if (i.data == null) throw new u("No acknowledgement was received.", null);
+		return i.data;
+	}, [d]);
+}
+function f(e, t, r = 0) {
+	let i = d(), o = JSON.stringify(t), [c, l] = a(null);
+	n(() => {
+		let t = new AbortController(), n = {
+			request: i,
+			key: o,
+			revision: r
+		};
+		if (l({
+			...n,
+			data: null,
+			error: null,
+			loading: o !== "null"
+		}), o !== "null") return r > 0 && s(), i(e, JSON.parse(o), !1, t.signal).then((e) => {
+			t.signal.aborted || l({
+				...n,
+				data: e,
+				error: null,
+				loading: !1
+			});
+		}).catch((e) => {
+			t.signal.aborted || l({
+				...n,
+				data: null,
+				error: e instanceof Error ? e.message : "Unable to load recorded status.",
+				loading: !1
+			});
+		}), () => t.abort();
+	}, [
+		e,
+		i,
+		o,
+		r
+	]);
+	let u = c?.request === i && c.key === o && c.revision === r;
+	return {
+		data: u ? c.data : null,
+		error: u ? c.error : null,
+		loading: u ? c.loading : o !== "null"
+	};
+}
+function p() {
+	let e = d(), t = i(!1), n = i(!1), [r, o] = a(!1), [s, c] = a(null), [f, p] = a(0);
+	return {
+		run: async (r, i, a) => {
+			if (t.current || n.current) return null;
+			t.current = !0, o(!0), c(null);
+			try {
+				let t = await e(r, i, !0);
+				if (!a(t)) throw new u("The returned acknowledgement does not identify this decision.", null);
+				return c({
+					kind: "APPLIED",
+					message: "Decision recorded. Review the refreshed status and history."
+				}), p((e) => e + 1), t;
+			} catch (e) {
+				let t = e instanceof u && e.code !== null && l.has(e.code);
+				return n.current = !t, c({
+					kind: t ? "REJECTED" : "UNKNOWN",
+					message: t ? `${e.message} Your input is preserved; refresh and review the recorded status before another action.` : "Acknowledgement is uncertain. Do not resend this action. Refresh the recorded status and review its decisions before beginning a separate new action."
+				}), null;
+			} finally {
+				t.current = !1, o(!1);
+			}
+		},
+		busy: r,
+		feedback: s,
+		revision: f,
+		beginSeparateAction: () => {
+			n.current = !1, c(null);
+		}
+	};
+}
+//#endregion
+export { p as useShipmentStatusCommand, f as useShipmentStatusQuery };

package/dist/hooks/useTracking.js

@@ -4,7 +4,7 @@ import { mapOrder as n, useOrder as r } from "./useOrders.js";
 import { mapDriver as i, mapVehicle as a, useDriver as o, useDrivers as s, useVehicle as c, useVehicles as l } from "./useFleet.js";
 import { useCallback as u, useEffect as d, useMemo as f, useState as p } from "react";
 //#region src/movethewheels/hooks/useTracking.ts
-var m = "\n  query ListShipments($filter: ShipmentFilterInput, $pagination: PaginationInput) {\n    shipments(filter: $filter, pagination: $pagination) {\n      id\n      shipmentNumber\n      deliveryJobId\n      status\n      trackingNumber\n      estimatedDelivery\n    }\n  }\n", h = "\n  query LookupDeliveryJob($id: ID!) {\n    deliveryJob(id: $id) {\n      id\n    }\n  }\n", g = "\n  query LookupDeliveryJobs($filter: DeliveryJobFilterInput, $pagination: PaginationInput) {\n    deliveryJobs(filter: $filter, pagination: $pagination) {\n      id\n      deliveryJobNumber\n      trackingNumber\n    }\n  }\n", _ = "\n  query GetDeliveryJobTracking($deliveryJobId: ID!, $pagination: PaginationInput) {\n    deliveryJobTracking(deliveryJobId: $deliveryJobId, pagination: $pagination) {\n      id\n      shipmentId\n      eventType\n      location\n      details\n      timestamp\n    }\n  }\n", v = "\n  query GetActiveDeliveries($pagination: PaginationInput) {\n    activeDeliveries(pagination: $pagination) {\n      id\n      shipmentNumber\n      deliveryJobId\n      status\n      estimatedDelivery\n      trackingEvents(pagination: { limit: 1, offset: 0 }) {\n        id\n        shipmentId\n        eventType\n        location\n        details\n        timestamp\n      }\n      deliveryJob {\n        id\n        deliveryJobNumber\n        customerId\n        status\n        priority\n        pickupAddress\n        deliveryAddress\n        cargoItems\n        pricing\n        trackingNumber\n        specialInstructions\n        scheduledDelivery\n        vehicleId\n        driverId\n        createdAt\n        updatedAt\n        customer {\n          name\n          email\n          phone\n          company\n        }\n        vehicle {\n          id\n          vehicleNumber\n          type\n          make\n          model\n          licensePlate\n          ownershipType\n          year\n          capacity\n          status\n          currentLocation\n          fuelLevel\n          mileage\n          lastServiceDate\n          nextServiceDueDate\n          nextServiceDueMileage\n          createdAt\n        }\n        driver {\n          id\n          userId\n          firstName\n          lastName\n          email\n          phone\n          employeeId\n          licenseNumber\n          licenseClass\n          licenseExpiry\n          status\n          currentLocation\n          rating\n          vehicleId\n          createdAt\n        }\n      }\n    }\n  }\n", y = "\n  query GetTrackingAlerts {\n    trackingAlerts {\n      shipmentId\n      shipmentNumber\n      alertType\n      message\n    }\n  }\n";
+var m = "\n  query ListShipments($filter: ShipmentFilterInput, $pagination: PaginationInput) {\n    shipments(filter: $filter, pagination: $pagination) {\n      id\n      shipmentNumber\n      deliveryJobId\n      status\n      trackingNumber\n      estimatedDelivery\n    }\n  }\n", h = "\n  query LookupDeliveryJob($id: ID!) {\n    deliveryJob(id: $id) {\n      id\n    }\n  }\n", g = "\n  query LookupDeliveryJobs($filter: DeliveryJobFilterInput, $pagination: PaginationInput) {\n    deliveryJobs(filter: $filter, pagination: $pagination) {\n      id\n      deliveryJobNumber\n      trackingNumber\n    }\n  }\n", _ = "\n  query GetDeliveryJobTracking($deliveryJobId: ID!, $pagination: PaginationInput) {\n    shipments(filter: { deliveryJobId: $deliveryJobId }, pagination: { limit: 2, offset: 0 }) {\n      id\n      status\n    }\n    deliveryJobTracking(deliveryJobId: $deliveryJobId, pagination: $pagination) {\n      id\n      shipmentId\n      eventType\n      location\n      details\n      timestamp\n    }\n  }\n", v = "\n  query GetActiveDeliveries($pagination: PaginationInput) {\n    activeDeliveries(pagination: $pagination) {\n      id\n      shipmentNumber\n      deliveryJobId\n      status\n      estimatedDelivery\n      trackingEvents(pagination: { limit: 1, offset: 0 }) {\n        id\n        shipmentId\n        eventType\n        location\n        details\n        timestamp\n      }\n      deliveryJob {\n        id\n        deliveryJobNumber\n        customerId\n        status\n        priority\n        pickupAddress\n        deliveryAddress\n        cargoItems\n        pricing\n        trackingNumber\n        specialInstructions\n        scheduledDelivery\n        vehicleId\n        driverId\n        createdAt\n        updatedAt\n        customer {\n          name\n          email\n          phone\n          company\n        }\n        vehicle {\n          id\n          vehicleNumber\n          type\n          make\n          model\n          licensePlate\n          ownershipType\n          year\n          capacity\n          status\n          currentLocation\n          fuelLevel\n          mileage\n          lastServiceDate\n          nextServiceDueDate\n          nextServiceDueMileage\n          createdAt\n        }\n        driver {\n          id\n          userId\n          firstName\n          lastName\n          email\n          phone\n          employeeId\n          licenseNumber\n          licenseClass\n          licenseExpiry\n          status\n          currentLocation\n          rating\n          vehicleId\n          createdAt\n        }\n      }\n    }\n  }\n", y = "\n  query GetTrackingAlerts {\n    trackingAlerts {\n      shipmentId\n      shipmentNumber\n      alertType\n      message\n    }\n  }\n";
 function b(e) {
 	let t = e.location;
 	if (!t) return null;
@@ -16,21 +16,21 @@ function b(e) {
 		timestamp: new Date(e.timestamp)
 	};
 }
-function x(e, t) {
-	let n = e[0];
-	if (!n) return null;
-	let r = e.map(b).filter((e) => e !== null), i = r[0];
+function x(e, t, n) {
+	let r = e[0];
+	if (!r) return null;
+	let i = e.map(b).filter((e) => e !== null), a = i[0];
 	return {
-		id: n.id,
+		id: r.id,
 		entityId: t,
 		entityType: "order",
-		currentLocation: i,
-		locationHistory: r,
-		status: n.eventType.toLowerCase(),
+		currentLocation: a,
+		locationHistory: i,
+		status: n?.toLowerCase() ?? "unknown",
 		estimatedArrival: void 0,
-		nextCheckpoint: n.details ?? void 0,
+		nextCheckpoint: r.details ?? void 0,
 		alerts: [],
-		lastUpdated: new Date(n.timestamp)
+		lastUpdated: new Date(r.timestamp)
 	};
 }
 function S() {
@@ -161,13 +161,14 @@ function D(e) {
 		}
 		D(!0), k(null);
 		try {
-			C(x([...(await t(n, _, {
+			let e = await t(n, _, {
 				deliveryJobId: i,
 				pagination: {
 					limit: 50,
 					offset: 0
 				}
-			})).deliveryJobTracking].sort((e, t) => Date.parse(t.timestamp) - Date.parse(e.timestamp)), i));
+			});
+			C(x([...e.deliveryJobTracking].sort((e, t) => Date.parse(t.timestamp) - Date.parse(e.timestamp)), i, e.shipments.length === 1 ? e.shipments[0]?.status : void 0));
 		} catch (e) {
 			k(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to load order tracking"));
 		} finally {
@@ -237,7 +238,7 @@ function A() {
 					order: n(t),
 					driver: t.driver ? i(t.driver) : null,
 					vehicle: t.vehicle ? a(t.vehicle) : null,
-					tracking: x(e.trackingEvents ?? [], t.id),
+					tracking: x(e.trackingEvents ?? [], t.id, e.status),
 					estimatedArrival: e.estimatedDelivery ? new Date(e.estimatedDelivery) : void 0
 				} : null;
 			}).filter((e) => e !== null));

package/dist/hooks/useTrackingEventQuality.js

@@ -0,0 +1,60 @@
+import "../src/generated/tracking-quality-operations.js";
+//#region src/movethewheels/hooks/useTrackingEventQuality.ts
+var e = new Set([
+	"ACCEPTED",
+	"DUPLICATE",
+	"CONFLICT",
+	"REJECTED"
+]), t = new Set([
+	"LEGACY_AUTHORITY",
+	"MANUAL_AUTHORITY",
+	"NON_DESIGNATED_SOURCE",
+	"UNKNOWN_SOURCE_TIME",
+	"OLDER_SOURCE_TIME",
+	"EQUAL_SOURCE_TIME",
+	"SOURCE_TIME_TOO_OLD",
+	"SOURCE_TIME_IN_FUTURE",
+	"UNMAPPED_EVENT_TYPE",
+	"UNRECEIPTED_EVIDENCE"
+]), n = new Set([
+	"KEY_CONFLICT",
+	"BUDGET_EXHAUSTED",
+	"INTEGRATION_UNAVAILABLE",
+	"SHIPMENT_UNAVAILABLE",
+	"UPDATE_REJECTED"
+]), r = (e, t) => typeof e == "string" && e.length <= t, i = (e, t) => e === null || r(e, t);
+function a(a) {
+	if (!Array.isArray(a) || a.length > 5) return null;
+	let o = [];
+	for (let s of a) {
+		if (typeof s != "object" || !s || Array.isArray(s)) return null;
+		let a = s;
+		if (!Number.isInteger(a.index) || typeof a.index != "number" || a.index !== o.length || a.index < 0 || a.index > 4 || !i(a.externalEventId, 255) || !r(a.shipmentReference, 255) || !i(a.shipmentId, 255) || typeof a.status != "string" || !e.has(a.status) || a.status === "CONFLICT" && a.shipmentId !== null || !(a.errorCode === null || typeof a.errorCode == "string" && n.has(a.errorCode))) return null;
+		let c = null, l = a.projectionStatus, u = a.projectionDecisionId ?? null, d = a.projectionHeldReason ?? null;
+		if (l != null) {
+			if (a.status !== "ACCEPTED" && a.status !== "DUPLICATE") return null;
+			if (l === "LEGACY_NO_DECISION") {
+				if (a.status !== "DUPLICATE" || u !== null || d !== null) return null;
+			} else if (l === "APPLIED" || l === "HELD") {
+				if (!r(u, 255) || !u || (l === "APPLIED" ? d !== null : typeof d != "string" || !t.has(d))) return null;
+			} else return null;
+			c = {
+				status: l,
+				decisionId: u,
+				heldReason: d
+			};
+		} else if (u !== null || d !== null) return null;
+		o.push({
+			index: a.index,
+			externalEventId: a.externalEventId,
+			shipmentReference: a.shipmentReference,
+			shipmentId: a.shipmentId,
+			status: a.status,
+			errorCode: a.errorCode,
+			projection: c
+		});
+	}
+	return o;
+}
+//#endregion
+export { a as trackingOutcomes };

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

@@ -1,5 +1,20 @@
 import { Order, ProofOfDelivery, SignatureType } from '../types';
 
+export interface ApiProofOfDelivery {
+    id: string;
+    deliveryJobId: string;
+    shipmentId?: string | null;
+    recipientName: string;
+    signatureType: 'DRAWN' | 'TYPED';
+    signatureData: string;
+    photoFileIds?: string[] | null;
+    latitude?: number | null;
+    longitude?: number | null;
+    locationAccuracy?: number | null;
+    deliveredAt: string;
+    capturedByDriverId: string;
+    notes?: string | null;
+}
 /** The shipper/customer-facing view: the completed ePOD record for a delivery job (or null if not yet captured). */
 export declare function useEpod(deliveryJobId: string | undefined): {
     epod: ProofOfDelivery | null;
@@ -30,6 +45,9 @@ export declare function useMyPendingEpodDeliveryJobs(options?: {
     refetch: () => Promise<void>;
 };
 export interface CaptureEpodArgs {
+    expectedShipmentId: string | null;
+    expectedShipmentStatusRevision?: number;
+    completionAttestation: boolean;
     deliveryJobId: string;
     recipientName: string;
     signatureType: SignatureType;
@@ -40,11 +58,16 @@ export interface CaptureEpodArgs {
     locationAccuracy?: number;
     notes?: string;
 }
+export declare function epodAcknowledged(actual: ApiProofOfDelivery | null | undefined, expected: CaptureEpodArgs): boolean;
 /** Driver-facing capture mutation. Identity/ownership is enforced server-side — this never sends a driver id. */
 export declare function useCaptureEpod(): {
     captureEpod: (args: CaptureEpodArgs) => Promise<ProofOfDelivery>;
     isSubmitting: boolean;
     error: Error | null;
+    captureFeedback: {
+        kind: "APPLIED" | "REJECTED" | "UNKNOWN";
+        message: string;
+    } | null;
 };
 export interface UploadedEpodPhoto {
     fileId: string;

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

@@ -0,0 +1,23 @@
+import { DocumentNode } from 'graphql';
+
+export declare class ShipmentStatusRequestError extends Error {
+    readonly code: string | null;
+    constructor(message: string, code: string | null);
+}
+/** Normal shared gateway transport; mutation acknowledgements are never automatically retried. */
+export declare function useShipmentStatusApi(): <T>(document: DocumentNode, variables: Record<string, unknown>, mutation?: boolean, signal?: AbortSignal) => Promise<T>;
+export declare function useShipmentStatusQuery<T>(document: DocumentNode, variables: Record<string, unknown> | null, revision?: number): {
+    data: T | null;
+    error: string | null;
+    loading: boolean;
+};
+export declare function useShipmentStatusCommand(): {
+    run: <T>(document: DocumentNode, variables: Record<string, unknown>, acknowledged: (result: T) => boolean) => Promise<T | null>;
+    busy: boolean;
+    feedback: {
+        kind: "APPLIED" | "REJECTED" | "UNKNOWN";
+        message: string;
+    } | null;
+    revision: number;
+    beginSeparateAction: () => void;
+};

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

@@ -0,0 +1,18 @@
+import { TrackingQualityIntegrationsDocument, TrackingQualityDeliveriesDocument, TrackingQualityShipmentDocument } from '../../generated/tracking-quality-operations';
+
+export { TrackingQualityIntegrationsDocument as QualityIntegrationsDocument, TrackingQualityDeliveriesDocument as QualityDeliveriesDocument, TrackingQualityShipmentDocument as QualityShipmentDocument, };
+export interface TrackingUpdateOutcome {
+    index: number;
+    externalEventId: string | null;
+    shipmentReference: string;
+    shipmentId: string | null;
+    status: 'ACCEPTED' | 'DUPLICATE' | 'CONFLICT' | 'REJECTED';
+    errorCode: string | null;
+    projection: {
+        status: 'APPLIED' | 'HELD' | 'LEGACY_NO_DECISION';
+        decisionId: string | null;
+        heldReason: string | null;
+    } | null;
+}
+/** JSON scalar decoding fails closed; legacy delivery history has no outcomes. */
+export declare function trackingOutcomes(value: unknown): TrackingUpdateOutcome[] | null;

package/dist/movethewheels/pages/ShipmentStatusAuthorityPage.d.ts

@@ -0,0 +1 @@
+export default function ShipmentStatusAuthorityPage(): import("react").JSX.Element;

package/dist/movethewheels/pages/TrackingEventQualityPage.d.ts

@@ -0,0 +1 @@
+export default function TrackingEventQualityPage(): import("react").JSX.Element;