@burdenoff/microfe-movethewheels 2026.725.1 → 2026.728.1

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

@@ -0,0 +1,59 @@
+import { Order, ProofOfDelivery, SignatureType } from '../types';
+
+/** 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;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+export interface PendingEpodDeliveryJob {
+    id: string;
+    deliveryJobNumber: string;
+    status: string;
+    priority: string;
+    deliveryAddress: Order['deliveryAddress'] | null;
+    scheduledDelivery?: Date;
+    customerName?: string;
+    customerPhone?: string;
+}
+/** Type C self-list: the CALLING driver's own jobs still awaiting ePOD capture — feeds the capture flow's job picker. */
+export declare function useMyPendingEpodDeliveryJobs(): {
+    jobs: PendingEpodDeliveryJob[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+export interface CaptureEpodArgs {
+    deliveryJobId: string;
+    recipientName: string;
+    signatureType: SignatureType;
+    signatureData: string;
+    photoFileIds?: string[];
+    latitude?: number;
+    longitude?: number;
+    locationAccuracy?: number;
+    notes?: string;
+}
+/** 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;
+};
+export interface UploadedEpodPhoto {
+    fileId: string;
+    fileName: string;
+}
+/** Uploads a delivery photo via the platform 3-step file flow and resolves to its `fileId`. */
+export declare function useEpodPhotoUpload(): {
+    upload: (file: File) => Promise<UploadedEpodPhoto>;
+    isUploading: boolean;
+    progress: number;
+    error: Error | null;
+};
+/** Resolves a TTL-safe download URL for a captured delivery photo, for display/download. */
+export declare function useEpodPhotoUrl(fileId: string | null | undefined): {
+    url: string | null;
+    isLoading: boolean;
+};

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

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

package/dist/movethewheels/types/index.d.ts

@@ -230,6 +230,24 @@ export interface Order {
     createdAt: Date;
     updatedAt: Date;
 }
+export type SignatureType = 'drawn' | 'typed';
+export interface ProofOfDelivery {
+    id: string;
+    deliveryJobId: string;
+    shipmentId?: string;
+    recipientName: string;
+    signatureType: SignatureType;
+    /** Drawn: a `data:image/png;base64,...` capture. Typed: the typed full name. */
+    signatureData: string;
+    /** wspace-files-svc File ids for any attached delivery photos. */
+    photoFileIds: string[];
+    latitude?: number;
+    longitude?: number;
+    locationAccuracy?: number;
+    deliveredAt: Date;
+    capturedByDriverId: string;
+    notes?: string;
+}
 export type VehicleType = 'van' | 'truck' | 'motorcycle' | 'bicycle' | 'car';
 export type VehicleStatus = 'available' | 'assigned' | 'maintenance' | 'out_of_service';
 export interface VehicleDocument {

package/dist/node_modules/lucide-react/dist/esm/icons/loader-circle.js

@@ -0,0 +1,8 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/loader-circle.js
+var t = e("LoaderCircle", [["path", {
+	d: "M21 12a9 9 0 1 1-6.219-8.56",
+	key: "13zald"
+}]]);
+//#endregion
+export { t as LoaderCircle };

package/dist/node_modules/lucide-react/dist/esm/icons/pen-line.js

@@ -0,0 +1,11 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/pen-line.js
+var t = e("PenLine", [["path", {
+	d: "M12 20h9",
+	key: "t2du7b"
+}], ["path", {
+	d: "M16.376 3.622a1 1 0 0 1 3.002 3.002L7.368 18.635a2 2 0 0 1-.855.506l-2.872.838a.5.5 0 0 1-.62-.62l.838-2.872a2 2 0 0 1 .506-.854z",
+	key: "1ykcvy"
+}]]);
+//#endregion
+export { t as PenLine };

package/dist/node_modules/lucide-react/dist/esm/icons/type.js

@@ -0,0 +1,24 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/type.js
+var t = e("Type", [
+	["polyline", {
+		points: "4 7 4 4 20 4 20 7",
+		key: "1nosan"
+	}],
+	["line", {
+		x1: "9",
+		x2: "15",
+		y1: "20",
+		y2: "20",
+		key: "swin9y"
+	}],
+	["line", {
+		x1: "12",
+		x2: "12",
+		y1: "4",
+		y2: "20",
+		key: "1tx1rr"
+	}]
+]);
+//#endregion
+export { t as Type };

package/dist/pages/DeliveryCapturePage.js

@@ -0,0 +1,245 @@
+import { CircleCheck as e } from "../node_modules/lucide-react/dist/esm/icons/circle-check.js";
+import { LoaderCircle as t } from "../node_modules/lucide-react/dist/esm/icons/loader-circle.js";
+import { MapPin as n } from "../node_modules/lucide-react/dist/esm/icons/map-pin.js";
+import { Package as r } from "../node_modules/lucide-react/dist/esm/icons/package.js";
+import { PenLine as i } from "../node_modules/lucide-react/dist/esm/icons/pen-line.js";
+import { Truck as a } from "../node_modules/lucide-react/dist/esm/icons/truck.js";
+import { Type as o } from "../node_modules/lucide-react/dist/esm/icons/type.js";
+import { Upload as s } from "../node_modules/lucide-react/dist/esm/icons/upload.js";
+import { useCaptureEpod as c, useEpodPhotoUpload as l, useMyPendingEpodDeliveryJobs as u } from "../hooks/useEpod.js";
+import { Button as d, Card as f, CardContent as p, CardHeader as m, CardTitle as h, Input as g, Label as _, Textarea as v } from "../components/ui.js";
+import { PageLayout as y } from "../components/PageLayout.js";
+import { FormError as b } from "../components/FormError.js";
+import { Notice as x, useNotice as S } from "../components/Notice.js";
+import { formatAddress as C, formatDate as w } from "../utils/formatters.js";
+import { SignaturePad as T } from "../components/SignaturePad.js";
+import { useRef as E, useState as D } from "react";
+import { Fragment as O, jsx as k, jsxs as A } from "react/jsx-runtime";
+//#region src/movethewheels/pages/DeliveryCapturePage.tsx
+function j() {
+	return new Promise((e) => {
+		if (!navigator.geolocation) {
+			e(null);
+			return;
+		}
+		navigator.geolocation.getCurrentPosition((t) => e(t), () => e(null), {
+			enableHighAccuracy: !0,
+			timeout: 8e3,
+			maximumAge: 3e4
+		});
+	});
+}
+function M({ job: r, onCaptured: u, onCancel: y }) {
+	let { captureEpod: x, isSubmitting: S, error: w } = c(), { upload: M, isUploading: N, error: P } = l(), F = E(null), [I, L] = D(""), [R, z] = D("drawn"), [B, V] = D(""), [H, U] = D(null), [W, G] = D(""), [K, q] = D(null), J = async () => {
+		q(null);
+		let e = I.trim();
+		if (!e) {
+			q("Recipient name is required.");
+			return;
+		}
+		let t = R === "typed" ? B.trim() : F.current?.toDataUrl() ?? null;
+		if (!t) {
+			q(R === "typed" ? "Type the recipient full name as their signature." : "A signature is required.");
+			return;
+		}
+		try {
+			let n;
+			H && (n = [(await M(H)).fileId]);
+			let i = await j();
+			await x({
+				deliveryJobId: r.id,
+				recipientName: e,
+				signatureType: R,
+				signatureData: t,
+				photoFileIds: n,
+				latitude: i?.coords.latitude,
+				longitude: i?.coords.longitude,
+				locationAccuracy: i?.coords.accuracy,
+				notes: W.trim() || void 0
+			}), u();
+		} catch {}
+	}, Y = S || N;
+	return /* @__PURE__ */ A(f, { children: [/* @__PURE__ */ k(m, { children: /* @__PURE__ */ A(h, {
+		className: "flex items-center gap-2",
+		children: [
+			/* @__PURE__ */ k(a, { size: 18 }),
+			" Capture delivery for ",
+			r.deliveryJobNumber
+		]
+	}) }), /* @__PURE__ */ A(p, {
+		className: "space-y-4",
+		children: [
+			/* @__PURE__ */ A("div", {
+				className: "text-sm text-text-secondary space-y-1",
+				children: [r.customerName && /* @__PURE__ */ A("p", { children: ["Recipient on file: ", r.customerName] }), r.deliveryAddress && /* @__PURE__ */ k("p", { children: C(r.deliveryAddress) })]
+			}),
+			/* @__PURE__ */ A("div", {
+				className: "space-y-1.5",
+				children: [/* @__PURE__ */ k(_, {
+					htmlFor: "epod-recipient-name",
+					children: "Recipient name"
+				}), /* @__PURE__ */ k(g, {
+					id: "epod-recipient-name",
+					value: I,
+					onChange: (e) => L(e.target.value),
+					placeholder: "Who received the delivery?"
+				})]
+			}),
+			/* @__PURE__ */ A("div", {
+				className: "space-y-1.5",
+				children: [
+					/* @__PURE__ */ k(_, { children: "Signature" }),
+					/* @__PURE__ */ A("div", {
+						className: "flex gap-2",
+						children: [/* @__PURE__ */ A(d, {
+							type: "button",
+							variant: R === "drawn" ? "default" : "outline",
+							size: "sm",
+							onClick: () => z("drawn"),
+							children: [/* @__PURE__ */ k(i, { size: 14 }), " Draw"]
+						}), /* @__PURE__ */ A(d, {
+							type: "button",
+							variant: R === "typed" ? "default" : "outline",
+							size: "sm",
+							onClick: () => z("typed"),
+							children: [/* @__PURE__ */ k(o, { size: 14 }), " Type name instead"]
+						})]
+					}),
+					R === "drawn" ? /* @__PURE__ */ k(T, { ref: F }) : /* @__PURE__ */ k(g, {
+						value: B,
+						onChange: (e) => V(e.target.value),
+						placeholder: "Type full name as signature"
+					})
+				]
+			}),
+			/* @__PURE__ */ A("div", {
+				className: "space-y-1.5",
+				children: [
+					/* @__PURE__ */ k(_, {
+						htmlFor: "epod-photo",
+						children: "Delivery photo (optional)"
+					}),
+					/* @__PURE__ */ A("div", {
+						className: "flex items-center gap-2",
+						children: [/* @__PURE__ */ k("input", {
+							id: "epod-photo",
+							type: "file",
+							accept: "image/*",
+							capture: "environment",
+							onChange: (e) => U(e.target.files?.[0] ?? null),
+							className: "text-sm"
+						}), H && /* @__PURE__ */ k(s, {
+							size: 14,
+							className: "text-text-secondary"
+						})]
+					}),
+					H && /* @__PURE__ */ k("p", {
+						className: "text-xs text-text-secondary",
+						children: H.name
+					})
+				]
+			}),
+			/* @__PURE__ */ A("div", {
+				className: "space-y-1.5",
+				children: [/* @__PURE__ */ k(_, {
+					htmlFor: "epod-notes",
+					children: "Notes (optional)"
+				}), /* @__PURE__ */ k(v, {
+					id: "epod-notes",
+					value: W,
+					onChange: (e) => G(e.target.value),
+					placeholder: "e.g. Left with front desk, gate code used, etc.",
+					rows: 2
+				})]
+			}),
+			/* @__PURE__ */ A("p", {
+				className: "flex items-center gap-1.5 text-xs text-text-secondary",
+				children: [/* @__PURE__ */ k(n, { size: 12 }), " Device GPS is captured automatically when permitted by the browser."]
+			}),
+			K && /* @__PURE__ */ k(b, { message: K }),
+			w && /* @__PURE__ */ k(b, { message: w.message }),
+			P && /* @__PURE__ */ k(b, { message: P.message }),
+			/* @__PURE__ */ A("div", {
+				className: "flex gap-2 justify-end",
+				children: [/* @__PURE__ */ k(d, {
+					type: "button",
+					variant: "outline",
+					onClick: y,
+					disabled: Y,
+					children: "Cancel"
+				}), /* @__PURE__ */ k(d, {
+					type: "button",
+					onClick: () => void J(),
+					disabled: Y,
+					children: Y ? /* @__PURE__ */ A(O, { children: [/* @__PURE__ */ k(t, {
+						size: 14,
+						className: "animate-spin"
+					}), " Submitting…"] }) : /* @__PURE__ */ A(O, { children: [/* @__PURE__ */ k(e, { size: 14 }), " Confirm delivery"] })
+				})]
+			})
+		]
+	})] });
+}
+function N() {
+	let { jobs: t, isLoading: n, error: i, refetch: o } = u(), [s, c] = D(null), { message: l, notify: m } = S();
+	return /* @__PURE__ */ k(y, {
+		title: "My Deliveries",
+		subtitle: "Capture proof of delivery for your assigned stops",
+		icon: /* @__PURE__ */ k(a, { size: 24 }),
+		children: /* @__PURE__ */ A("div", {
+			className: "space-y-4",
+			children: [/* @__PURE__ */ k(x, { message: l }), s ? /* @__PURE__ */ k(M, {
+				job: s,
+				onCaptured: () => {
+					m("Proof of delivery captured — delivery marked complete."), c(null), o();
+				},
+				onCancel: () => c(null)
+			}) : n ? /* @__PURE__ */ k("p", {
+				className: "text-text-secondary text-center py-8",
+				children: "Loading your deliveries…"
+			}) : i ? /* @__PURE__ */ k(b, { message: i.message }) : t.length > 0 ? /* @__PURE__ */ k("div", {
+				className: "space-y-3",
+				children: t.map((e) => /* @__PURE__ */ k(f, { children: /* @__PURE__ */ A(p, {
+					className: "flex items-center justify-between gap-3 py-4",
+					children: [/* @__PURE__ */ A("div", {
+						className: "min-w-0",
+						children: [
+							/* @__PURE__ */ A("p", {
+								className: "font-medium flex items-center gap-2",
+								children: [
+									/* @__PURE__ */ k(r, { size: 16 }),
+									" ",
+									e.deliveryJobNumber
+								]
+							}),
+							e.deliveryAddress && /* @__PURE__ */ k("p", {
+								className: "text-sm text-text-secondary truncate",
+								children: C(e.deliveryAddress)
+							}),
+							e.scheduledDelivery && /* @__PURE__ */ A("p", {
+								className: "text-xs text-text-secondary",
+								children: ["Scheduled ", w(e.scheduledDelivery, "short")]
+							})
+						]
+					}), /* @__PURE__ */ k(d, {
+						type: "button",
+						size: "sm",
+						onClick: () => c(e),
+						children: "Capture"
+					})]
+				}) }, e.id))
+			}) : /* @__PURE__ */ A("div", {
+				className: "text-center py-12",
+				children: [/* @__PURE__ */ k(e, {
+					size: 40,
+					className: "mx-auto mb-3 text-text-secondary opacity-50"
+				}), /* @__PURE__ */ k("p", {
+					className: "text-text-secondary",
+					children: "No deliveries awaiting proof of delivery."
+				})]
+			})]
+		})
+	});
+}
+//#endregion
+export { N as default };

package/dist/pages/OrderDetailsPage.js

@@ -25,10 +25,11 @@ import { FormError as xe } from "../components/FormError.js";
 import { Notice as Se, useNotice as T } from "../components/Notice.js";
 import { formatAddress as E, formatCurrency as D, formatDate as O } from "../utils/formatters.js";
 import { DocumentsCard as Ce } from "../components/DocumentsCard.js";
+import { ProofOfDeliveryCard as we } from "../components/ProofOfDeliveryCard.js";
 import { useState as k } from "react";
-import { useParams as we } from "react-router-dom";
+import { useParams as Te } from "react-router-dom";
 import { jsx as A, jsxs as j } from "react/jsx-runtime";
-import { EmphasisPanel as Te, NextSteps as Ee, PagePurpose as De } from "@burdenoff/fe-libs/ui";
+import { EmphasisPanel as Ee, NextSteps as De, PagePurpose as Oe } from "@burdenoff/fe-libs/ui";
 //#region src/movethewheels/pages/OrderDetailsPage.tsx
 var M = [
 	"pending",
@@ -49,19 +50,19 @@ var M = [
 	cancelled: "Cancelled",
 	failed: "Failed"
 };
-function Oe(e) {
+function ke(e) {
 	let t = M.indexOf(e);
 	return t === -1 || t >= M.length - 1 ? null : M[t + 1];
 }
 function P() {
-	let { orderId: M } = we(), { basePath: P, navigate: F } = le(), { order: I, isLoading: ke, error: Ae, refetch: L } = ue(M), { updateOrder: je, updateOrderStatus: Me } = de(), { vehicles: Ne, drivers: Pe } = fe(), { message: R, notify: z } = T(), [B, V] = k(""), [H, U] = k(""), [W, G] = k(!1), [K, q] = k(!1), [J, Y] = k(null), X = Ne.filter((e) => e.status === "available" || e.id === I?.vehicleId), Z = Pe.filter((e) => e.status === "available" || e.id === I?.driverId), Fe = async () => {
+	let { orderId: M } = Te(), { basePath: P, navigate: F } = le(), { order: I, isLoading: Ae, error: je, refetch: L } = ue(M), { updateOrder: Me, updateOrderStatus: Ne } = de(), { vehicles: Pe, drivers: Fe } = fe(), { message: R, notify: z } = T(), [B, V] = k(""), [H, U] = k(""), [W, G] = k(!1), [K, q] = k(!1), [J, Y] = k(null), X = Pe.filter((e) => e.status === "available" || e.id === I?.vehicleId), Z = Fe.filter((e) => e.status === "available" || e.id === I?.driverId), Ie = async () => {
 		if (!M || !B && !H) {
 			Y("Pick a vehicle and/or a driver to assign.");
 			return;
 		}
 		G(!0), Y(null);
 		try {
-			await je(M, {
+			await Me(M, {
 				vehicleId: B || void 0,
 				driverId: H || void 0
 			}), z("Assignment updated."), V(""), U(""), L();
@@ -74,7 +75,7 @@ function P() {
 		if (M) {
 			q(!0), Y(null);
 			try {
-				await Me(M, e), z(t), L();
+				await Ne(M, e), z(t), L();
 			} catch (e) {
 				Y(e instanceof Error ? e.message : "Failed to update status.");
 			} finally {
@@ -84,7 +85,7 @@ function P() {
 	}, $ = (e) => {
 		F && F(s(P, e));
 	};
-	return ke ? /* @__PURE__ */ A(_e, { message: "Loading order details..." }) : Ae || !I ? /* @__PURE__ */ A(ge, {
+	return Ae ? /* @__PURE__ */ A(_e, { message: "Loading order details..." }) : je || !I ? /* @__PURE__ */ A(ge, {
 		title: "Order not found",
 		message: "The order you're looking for doesn't exist or has been removed.",
 		onRetry: L
@@ -124,11 +125,11 @@ function P() {
 			]
 		}),
 		children: [
-			/* @__PURE__ */ A(De, {
+			/* @__PURE__ */ A(Oe, {
 				icon: /* @__PURE__ */ A(i, { size: 18 }),
 				children: "Everything about this one delivery in a single place — who it's for, where it's going, what's inside, the running cost and the full status history. Use this page to review the order, hand it to a driver, print the docket, or jump into live tracking."
 			}),
-			/* @__PURE__ */ A(Ee, {
+			/* @__PURE__ */ A(De, {
 				storageKey: "movethewheels-order-details",
 				steps: [
 					{
@@ -358,7 +359,7 @@ function P() {
 				}), /* @__PURE__ */ j("div", {
 					className: "space-y-6",
 					children: [
-						/* @__PURE__ */ j(Te, { children: [/* @__PURE__ */ j("h2", {
+						/* @__PURE__ */ j(Ee, { children: [/* @__PURE__ */ j("h2", {
 							className: "flex items-center gap-2 text-base font-semibold text-text-primary mb-4",
 							children: [/* @__PURE__ */ A(ne, { size: 18 }), "Order Summary"]
 						}), /* @__PURE__ */ j("div", {
@@ -492,7 +493,7 @@ function P() {
 										}),
 										/* @__PURE__ */ j(l, {
 											className: "w-full",
-											onClick: Fe,
+											onClick: Ie,
 											disabled: W || !B && !H,
 											children: [/* @__PURE__ */ A(se, { size: 16 }), W ? "Assigning…" : "Assign driver & vehicle"]
 										})
@@ -514,7 +515,7 @@ function P() {
 											]
 										}),
 										(() => {
-											let e = Oe(I.status);
+											let e = ke(I.status);
 											return e ? /* @__PURE__ */ j(l, {
 												variant: "outline",
 												className: "w-full",
@@ -544,6 +545,7 @@ function P() {
 							entityType: "order",
 							entityId: I.id
 						}),
+						/* @__PURE__ */ A(we, { deliveryJobId: I.id }),
 						I.specialInstructions && /* @__PURE__ */ j(u, { children: [/* @__PURE__ */ A(f, { children: /* @__PURE__ */ j(p, {
 							className: "flex items-center gap-2",
 							children: [/* @__PURE__ */ A(re, { size: 18 }), "Special Instructions"]