@burdenoff/microfe-movethewheels 2026.1016.3 → 2026.1016.4

package/dist/generated/wspace-types.d.ts

@@ -1,24 +1,5 @@
 export type Maybe<T> = T | null;
 export type InputMaybe<T> = Maybe<T>;
-export type Exact<T extends {
-    [key: string]: unknown;
-}> = {
-    [K in keyof T]: T[K];
-};
-export type MakeOptional<T, K extends keyof T> = Omit<T, K> & {
-    [SubKey in K]?: Maybe<T[SubKey]>;
-};
-export type MakeMaybe<T, K extends keyof T> = Omit<T, K> & {
-    [SubKey in K]: Maybe<T[SubKey]>;
-};
-export type MakeEmpty<T extends {
-    [key: string]: unknown;
-}, K extends keyof T> = {
-    [_ in K]?: never;
-};
-export type Incremental<T> = T | {
-    [P in keyof T]?: P extends ' $fragmentName' | '__typename' ? T[P] : never;
-};
 /** All built-in and custom scalars, mapped to their actual values */
 export type Scalars = {
     ID: {
@@ -72,12 +53,12 @@ export type Scalars = {
         output: File;
     };
     _ScalarsPlaceholder: {
-        input: any;
-        output: any;
+        input: unknown;
+        output: unknown;
     };
     _SecurityMainPlaceholder: {
-        input: any;
-        output: any;
+        input: unknown;
+        output: unknown;
     };
 };
 export type A2AConnection = {

package/dist/hooks/useInvoiceComparisonRecovery.js

@@ -0,0 +1,118 @@
+import { useMoveTheWheels as e } from "../providers/MoveTheWheelsProvider.js";
+import { resolveGraphqlUrl as t } from "../utils/graphqlClient.js";
+import { useConditionApi as n } from "./useContainerCondition.js";
+import { INVOICE_RECOVERY_STORAGE as r, decodeInvoiceIntent as i, encodeInvoiceIntent as a, invoiceCanonical as o, invoiceRecordInput as s, matchesInvoiceReceipt as c, sameInvoiceScope as l } from "../utils/invoiceComparison.js";
+import { InvoiceComparisonExactDocument as u, RecordInvoiceComparisonDocument as d, RecoverInvoiceComparisonDocument as f } from "../src/generated/freight-invoice-operations.js";
+import { useLayoutEffect as p, useRef as m, useState as h } from "react";
+import { useActiveContext as g } from "@burdenoff/fe-libs/shared/providers/shell";
+//#region src/movethewheels/hooks/useInvoiceComparisonRecovery.ts
+function _() {
+	try {
+		let e = sessionStorage.getItem(r), t = i(e);
+		return {
+			intent: t,
+			blocked: e !== null && t === null
+		};
+	} catch {
+		return {
+			intent: null,
+			blocked: !0
+		};
+	}
+}
+function v(n) {
+	let r = e(), i = g();
+	return !n || !r.currentUser?.id || !r.workspaceId || i.workspaceId !== r.workspaceId || !i.organizationId || r.tenantId && i.tenantId !== r.tenantId ? null : {
+		actorId: r.currentUser.id,
+		workspaceId: r.workspaceId,
+		tenantId: i.tenantId,
+		organizationId: i.organizationId,
+		projectId: i.projectId,
+		gateway: t(r.apiGatewayUrl)
+	};
+}
+function y(e, t) {
+	let g = n("SINGLE_ATTEMPT"), [v] = h(_), [y, b] = h(v.intent), x = m(y), [S, C] = h(v.blocked), w = m(!1), [T, E] = h(!1), [D, O] = h(0), k = o(e), A = m(e), [j, M] = h(null);
+	p(() => (A.current = e, () => {
+		A.current = null;
+	}), [k]);
+	let N = (e, t = !0) => M({
+		scopeKey: k,
+		message: e,
+		error: t
+	}), P = (e, t) => {
+		if (!e || !c(e, t) || !l(t.scope, A.current)) throw Error("UNCONFIRMED");
+		let n = i(sessionStorage.getItem(r));
+		if (!n || o(n) !== o(t)) throw Error("RETAINED_INTENT_CHANGED");
+		return sessionStorage.removeItem(r), x.current = null, b(null), C(!1), O((e) => e + 1), N("The exact immutable comparison receipt is confirmed.", !1), e;
+	};
+	return {
+		run: async (n, c) => {
+			if (w.current || x.current || S) return N("Resolve the original request before starting another."), null;
+			if (!e || !l(e, A.current) || !t()) return N("Current shipment update permission and workspace context are required. Nothing was sent."), null;
+			let u;
+			try {
+				if (sessionStorage.getItem("movethewheels.freight-invoice.unresolved.v1") !== null) throw Error("EXISTING");
+				u = {
+					version: 1,
+					scope: structuredClone(e),
+					input: s({
+						...n,
+						idempotencyKey: crypto.randomUUID()
+					}),
+					estimate: structuredClone(c)
+				}, sessionStorage.setItem(r, a(u)), x.current = u, b(u);
+			} catch {
+				return N("The original request could not be retained safely. Nothing was sent; reload and inspect any retained request."), null;
+			}
+			w.current = !0, E(!0), M(null);
+			try {
+				if (!l(u.scope, A.current) || !t()) {
+					let e = i(sessionStorage.getItem(r));
+					return e && o(e) === o(u) && (sessionStorage.removeItem(r), x.current = null, b(null)), N("Context or permission changed before dispatch. Nothing was sent."), null;
+				}
+				return P((await g(d, { input: u.input })).compareMtwFreightInvoice, u);
+			} catch {
+				return N("Save outcome is UNKNOWN. Keep the original intent and use read-only recovery; do not resend it."), null;
+			} finally {
+				w.current = !1, E(!1);
+			}
+		},
+		reconcile: async () => {
+			let e = x.current;
+			if (w.current || !e) return null;
+			if (!l(e.scope, A.current)) return N("Return to the original account, organization, workspace and project to inspect its request."), null;
+			w.current = !0, E(!0), M(null);
+			try {
+				let t = (await g(f, {
+					shipmentId: e.input.shipmentId,
+					requestKey: e.input.idempotencyKey
+				})).mtwFreightInvoiceComparisonByRequestKey;
+				if (!t) return N("No original-context receipt was returned. This does not prove no effect; the request stays UNKNOWN and cannot be resent."), null;
+				if (!c(t, e)) throw Error("MISMATCH");
+				if (!l(e.scope, A.current)) throw Error("CONTEXT_CHANGED");
+				let n = await g(u, {
+					shipmentId: e.input.shipmentId,
+					id: t.id
+				});
+				if (!c(n.mtwFreightInvoiceComparison, e) || n.mtwFreightInvoiceComparison.requestFingerprint !== t.requestFingerprint || o(n.mtwFreightInvoiceComparison) !== o(t)) throw Error("MISMATCH");
+				return P(n.mtwFreightInvoiceComparison, e);
+			} catch {
+				return N("Read-only recovery could not confirm the exact original receipt. Keep the intent; no save was sent."), null;
+			} finally {
+				w.current = !1, E(!1);
+			}
+		},
+		busy: T,
+		pending: y,
+		blocked: S,
+		uncertain: y !== null || S,
+		revision: D,
+		scopeKey: k,
+		canReconcile: !!y && l(y.scope, e),
+		feedback: j?.scopeKey === k ? j : null,
+		refresh: () => O((e) => e + 1)
+	};
+}
+//#endregion
+export { y as useInvoiceComparisonRecovery, v as useInvoiceComparisonScope };

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

@@ -2,8 +2,9 @@ import { MtwContainerEvidenceInput } from '../../generated/container-condition-o
 export interface SelectedEvidence extends MtwContainerEvidenceInput {
     label: string;
 }
-export declare function ContainerEvidencePicker({ value, onChange, description, }: {
+export declare function ContainerEvidencePicker({ value, onChange, currentOnly, description, }: {
     value: SelectedEvidence[];
     onChange: (value: SelectedEvidence[]) => void;
     description?: string;
+    currentOnly?: boolean;
 }): import('react').JSX.Element;

package/dist/movethewheels/components/freight-invoice/InvoiceForm.d.ts

@@ -0,0 +1,19 @@
+import { CompareMtwFreightInvoiceInput, InvoiceEstimatePinFragment, InvoiceEstimateVersionQuery, InvoiceReceiptFragment, InvoiceStructuralPreviewQuery, MtwFreightInvoiceFactsInput } from '../../../generated/freight-invoice-operations';
+export type InvoiceEstimate = InvoiceEstimateVersionQuery['mtwFreightEstimateVersion'];
+export declare function invoiceEstimatePin(estimate: InvoiceEstimate): InvoiceEstimatePinFragment;
+export declare function InvoiceForm({ estimate, previous, disabled, canRecord, onPreview, onSave, }: {
+    estimate: InvoiceEstimate;
+    previous: InvoiceReceiptFragment | null;
+    disabled: boolean;
+    canRecord: boolean;
+    onPreview: (input: {
+        shipmentId: string;
+        estimateVersionId: string;
+        facts: MtwFreightInvoiceFactsInput;
+        evidence: {
+            fileId: string;
+            versionId: string;
+        }[];
+    }) => Promise<InvoiceStructuralPreviewQuery['previewMtwFreightInvoice']>;
+    onSave: (input: Omit<CompareMtwFreightInvoiceInput, 'idempotencyKey'>, pin: InvoiceEstimatePinFragment) => Promise<InvoiceReceiptFragment | null | undefined>;
+}): import('react').JSX.Element;

package/dist/movethewheels/components/freight-invoice/InvoiceResults.d.ts

@@ -0,0 +1,9 @@
+import { InvoiceReceiptFragment, InvoiceStructuralPreviewQuery } from '../../../generated/freight-invoice-operations';
+type Preview = InvoiceStructuralPreviewQuery['previewMtwFreightInvoice'];
+export declare function InvoiceResults({ value }: {
+    value: Preview | InvoiceReceiptFragment;
+}): import('react').JSX.Element;
+export declare function InvoiceHistoryRecord({ record }: {
+    record: InvoiceReceiptFragment;
+}): import('react').JSX.Element;
+export {};

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

@@ -32,7 +32,7 @@ export interface CreateDriverInput {
     phone?: string;
     licenseNumber?: string;
     licenseClass?: string;
-    licenseExpiry?: string;
+    licenseExpiry?: string | null;
     /** DriverStatus enum value, e.g. `AVAILABLE`, `OFF_DUTY`. */
     status?: string;
     vehicleId?: string | null;

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

@@ -5,7 +5,7 @@
  * All three sit on top of wspace-movethewheels-svc's fleet module; the ranking
  * and alert rules live server-side so every surface (web, CLI, MCP) agrees.
  */
-export type FleetAlertType = 'LICENSE_EXPIRED' | 'LICENSE_EXPIRING' | 'MAINTENANCE_OVERDUE' | 'MAINTENANCE_DUE_SOON';
+export type FleetAlertType = 'LICENSE_UNKNOWN' | 'LICENSE_EXPIRED' | 'LICENSE_EXPIRING' | 'MAINTENANCE_OVERDUE' | 'MAINTENANCE_DUE_SOON';
 export type FleetAlertSeverity = 'CRITICAL' | 'WARNING';
 export type FleetAlertSubjectType = 'VEHICLE' | 'DRIVER';
 export interface FleetAlert {

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

@@ -0,0 +1,22 @@
+import { CompareMtwFreightInvoiceInput, InvoiceEstimatePinFragment, InvoiceReceiptFragment } from '../../generated/freight-invoice-operations';
+import { InvoiceIntent, InvoiceScope } from '../utils/invoiceComparison';
+/** Canonical visible context only; never decode credentials or claim the full server context. */
+export declare function useInvoiceComparisonScope(canRead: boolean): InvoiceScope | null;
+/** One original business intent. UNKNOWN permits reads only, never a retry/new key or automatic resend. */
+export declare function useInvoiceComparisonRecovery(scope: InvoiceScope | null, allowsWrite: () => boolean): {
+    run: (supplied: Omit<CompareMtwFreightInvoiceInput, "idempotencyKey">, estimate: InvoiceEstimatePinFragment) => Promise<InvoiceReceiptFragment | null>;
+    reconcile: () => Promise<InvoiceReceiptFragment | null>;
+    busy: boolean;
+    pending: InvoiceIntent | null;
+    blocked: boolean;
+    uncertain: boolean;
+    revision: number;
+    scopeKey: string;
+    canReconcile: boolean;
+    feedback: {
+        scopeKey: string;
+        message: string;
+        error: boolean;
+    } | null;
+    refresh: () => void;
+};

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

@@ -22,15 +22,13 @@ export declare function useProcedureSelection(revision: number): {
         loading: boolean;
     };
     cycle: {
-        __typename?: "MtwContainerCycle";
         id: string;
         version: number;
         status: import('../../generated/logistics-procedure-operations').MtwContainerCycleStatus;
-        bookingReference?: string | null;
+        bookingReference: string | null;
         openedAt: string;
     } | null;
     proposal: {
-        __typename?: "MtwReuseProposal";
         id: string;
         proposalReference: string;
         revision: number;

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

@@ -0,0 +1,10 @@
+import { InvoiceIntent, InvoiceScope } from '../utils/invoiceComparison';
+export default function FreightInvoicePage(): import('react').JSX.Element;
+/** Retain the unresolved intent across context changes without displaying another context's source facts. */
+export declare function InvoiceRequestRecovery({ pending, scope, busy, canReconcile, onRead, }: {
+    pending: InvoiceIntent | null;
+    scope: InvoiceScope | null;
+    busy: boolean;
+    canReconcile: boolean;
+    onRead: () => void;
+}): import('react').JSX.Element;

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

@@ -0,0 +1,6 @@
+/** The expiry control is explicitly UTC, independent of the browser timezone. */
+export declare const driverLicenseExpiryInput: (recorded: Date | undefined) => string;
+/** Empty means unrecorded; never substitute noon, end of day or the current time. */
+export declare const parseDriverLicenseExpiry: (value: string) => string | null;
+/** Omit unchanged updates so even server precision beyond this display is retained. */
+export declare const driverLicenseExpiryUpdate: (value: string, recorded: Date | undefined) => string | null | undefined;

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

@@ -0,0 +1,32 @@
+import { CompareMtwFreightInvoiceInput, InvoiceEstimatePinFragment, InvoiceReceiptFragment, InvoiceStructuralPreviewQuery, MtwFreightInvoiceFactsInput } from '../../generated/freight-invoice-operations';
+export declare const INVOICE_RECOVERY_STORAGE = "movethewheels.freight-invoice.unresolved.v1";
+export interface InvoiceScope {
+    actorId: string;
+    workspaceId: string;
+    tenantId: string | null;
+    organizationId: string;
+    projectId: string | null;
+    gateway: string;
+}
+export interface InvoiceIntent {
+    version: 1;
+    scope: InvoiceScope;
+    input: CompareMtwFreightInvoiceInput;
+    estimate: InvoiceEstimatePinFragment;
+}
+export declare function invoiceCanonical(value: unknown): string;
+export declare function invoiceFactsInput(value: unknown): MtwFreightInvoiceFactsInput;
+export declare function invoiceRecordInput(value: unknown): CompareMtwFreightInvoiceInput;
+export declare function sameInvoiceScope(a: InvoiceScope, b: InvoiceScope | null): boolean;
+export declare function decodeInvoiceIntent(raw: string | null): InvoiceIntent | null;
+export declare function encodeInvoiceIntent(value: InvoiceIntent): string;
+/** Server owns full trusted context and fingerprint; validate visible business facts, never invent its hash. */
+export declare function matchesInvoiceReceipt(receipt: InvoiceReceiptFragment | null | undefined, intent: InvoiceIntent): boolean;
+/** Structural preview must match the selected exact version and current draft; it grants no save authority. */
+export declare function matchesInvoicePreview(value: InvoiceStructuralPreviewQuery['previewMtwFreightInvoice'], facts: MtwFreightInvoiceFactsInput, estimate: InvoiceEstimatePinFragment): boolean;
+/** Exact decimal display including signed differences; money never enters Number. */
+export declare function invoiceMoney(minor: string | null | undefined, currency: {
+    code: string;
+    minorUnitDigits: number;
+}): string;
+export declare function invoiceRowDifference(value: Pick<InvoiceReceiptFragment, 'facts' | 'outcome'>, rowId: string): string;