@burdenoff/microfe-movethewheels 2026.930.4 → 2026.1010.1

package/dist/utils/reuseRecovery.js

@@ -0,0 +1,71 @@
+import { resolveGraphqlUrl as e } from "./graphqlClient.js";
+import { Kind as t, parse as n, print as r } from "graphql";
+//#region src/movethewheels/utils/reuseRecovery.ts
+var i = "movethewheels.empty-reuse.unresolved.v1", a = 2e5, o = new Set([
+	"RecordReturnInstruction",
+	"RecordReuseProposal",
+	"RecordReuseApproval",
+	"AcceptReuseReservation",
+	"TerminateReuseReservation"
+]);
+function s(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+function c(t, n, r, i, a) {
+	if (!t || !n || !a) return null;
+	try {
+		let o = a.split(".")[1], c = JSON.parse(atob(o.replace(/-/g, "+").replace(/_/g, "/")));
+		if (!s(c) || c.sub !== t || c.workspaceId !== n || typeof c.organizationId != "string" || !c.organizationId || !Object.hasOwn(c, "projectId")) return null;
+		let l = c.projectId;
+		return l != null && typeof l != "string" ? null : {
+			actorId: t,
+			workspaceId: n,
+			tenantId: r ?? "",
+			organizationId: c.organizationId,
+			gateway: e(i),
+			projectId: l ?? null
+		};
+	} catch {
+		return null;
+	}
+}
+function l(e) {
+	return JSON.stringify(e);
+}
+function u(e, t) {
+	return t !== null && e.actorId === t.actorId && e.workspaceId === t.workspaceId && e.tenantId === t.tenantId && e.organizationId === t.organizationId && e.gateway === t.gateway && e.projectId === t.projectId;
+}
+function d(e, i) {
+	if (!e || new TextEncoder().encode(e).byteLength > a) return null;
+	try {
+		let a = JSON.parse(e);
+		if (!s(a) || a.version !== 1 || !s(a.scope) || !s(a.input)) return null;
+		let c = a.scope;
+		if (typeof c.actorId != "string" || typeof c.workspaceId != "string" || typeof c.tenantId != "string" || typeof c.organizationId != "string" || typeof c.gateway != "string" || !c.actorId || !c.workspaceId || c.projectId !== null && typeof c.projectId != "string" || typeof a.operation != "string" || !i.some((e) => r(e) === a.operation)) return null;
+		let l = n(a.operation).definitions.find((e) => e.kind === t.OPERATION_DEFINITION);
+		return !l || l.kind !== t.OPERATION_DEFINITION || l.operation !== "mutation" || !l.name || !o.has(l.name.value) || typeof a.key != "string" || !a.key || a.key.length > 200 || typeof a.success != "string" || a.success.length > 500 ? null : {
+			version: 1,
+			scope: {
+				actorId: c.actorId,
+				workspaceId: c.workspaceId,
+				tenantId: c.tenantId,
+				organizationId: c.organizationId,
+				gateway: c.gateway,
+				projectId: c.projectId
+			},
+			operation: a.operation,
+			input: a.input,
+			key: a.key,
+			success: a.success
+		};
+	} catch {
+		return null;
+	}
+}
+function f(e) {
+	let t = JSON.stringify(e);
+	if (new TextEncoder().encode(t).byteLength > a) throw Error("This request is too large to retain safely.");
+	return t;
+}
+//#endregion
+export { i as REUSE_RECOVERY_STORAGE, d as decodeReuseRecovery, f as encodeReuseRecovery, l as reuseRecoveryContextKey, c as reuseRecoveryScope, u as sameReuseRecoveryScope };

package/dist/utils/stockBindingForm.js

@@ -0,0 +1,142 @@
+import { freeTimeIso as e } from "./freeTimeDate.js";
+//#region src/movethewheels/utils/stockBindingForm.ts
+function t(e) {
+	return `${e.warehouse?.name ?? "Warehouse unavailable"} (${e.warehouse?.code ?? "unknown code"}) / ${e.cargoItem?.name ?? "Cargo unavailable"} (${e.cargoItem?.sku ?? "unknown SKU"}) / ${e.locationId === null ? "Unbinned" : e.location?.locationCode ?? "Bin unavailable"}`;
+}
+function n(e, n) {
+	if (!e.cargoItem || !e.warehouse || e.cargoItem.id !== e.cargoItemId || e.warehouse.id !== e.warehouseId || (e.locationId === null ? e.location != null : !e.location || e.location.id !== e.locationId || e.location.warehouseId !== e.warehouseId)) throw Error("This stock line is missing a current owner. Refresh and review it before recording.");
+	if (!Number.isInteger(e.compositionEpoch) || e.compositionEpoch < 0 || e.compositionEpoch > 2147483647) throw Error("The current continuity revision is unavailable. Refresh and review this stock line.");
+	if (n && n.inventoryItemId !== e.id) throw Error("The previous assessment belongs to another stock line.");
+	return {
+		inventoryItemId: e.id,
+		expectedCompositionEpoch: e.compositionEpoch,
+		expectedCargoItemId: e.cargoItemId,
+		expectedWarehouseId: e.warehouseId,
+		expectedLocationId: e.locationId ?? null,
+		expectedInventoryUpdatedAt: e.updatedAt,
+		expectedCargoUpdatedAt: e.cargoItem.updatedAt,
+		expectedWarehouseUpdatedAt: e.warehouse.updatedAt,
+		expectedLocationUpdatedAt: e.location?.updatedAt ?? null,
+		expectedPreviousAssessmentId: n?.id ?? null,
+		expectedVersion: n?.version ?? 0,
+		label: t(e)
+	};
+}
+function r(e, t, r) {
+	if (!t) return !1;
+	try {
+		let i = n(t, r);
+		return Object.entries(i).every(([t, n]) => t === "label" || e[t] === n);
+	} catch {
+		return !1;
+	}
+}
+function i(e, t, n, i) {
+	if (!r(t, n, i)) throw Error("This stock line or its recorded history changed. Refresh and review a new draft.");
+	return {
+		inventoryItemId: t.inventoryItemId,
+		expectedCompositionEpoch: t.expectedCompositionEpoch,
+		expectedCargoItemId: t.expectedCargoItemId,
+		expectedWarehouseId: t.expectedWarehouseId,
+		expectedLocationId: t.expectedLocationId,
+		expectedInventoryUpdatedAt: t.expectedInventoryUpdatedAt,
+		expectedCargoUpdatedAt: t.expectedCargoUpdatedAt,
+		expectedWarehouseUpdatedAt: t.expectedWarehouseUpdatedAt,
+		expectedLocationUpdatedAt: t.expectedLocationUpdatedAt,
+		expectedPreviousAssessmentId: t.expectedPreviousAssessmentId,
+		expectedVersion: t.expectedVersion,
+		...e
+	};
+}
+function a(e, t, n = 255) {
+	let r = e.get(t);
+	if (r === null || r === "") return null;
+	if (typeof r != "string") throw Error("Enter text source facts.");
+	let i = r.trim();
+	if (!i) return null;
+	if (i.length > n) throw Error(`${t} exceeds ${n} characters.`);
+	return i;
+}
+function o(t, n) {
+	let r = a(t, n);
+	return r === null ? null : e(r);
+}
+function s(e, t, n) {
+	let r = n.find((n) => n === e.get(t));
+	if (!r) throw Error(`Choose a declared ${t}.`);
+	return r;
+}
+function c(t, n) {
+	let r = s(t, "validityPolicy", [
+		"UNKNOWN",
+		"TIME_BOUNDED",
+		"NO_REQUIRED_EXPIRY"
+	]), i = o(t, "validityFrom"), c = o(t, "validityUntil");
+	if (r === "NO_REQUIRED_EXPIRY" && c !== null || i && c && Date.parse(i) >= Date.parse(c)) throw Error("Source validity cutoff or chronology contradicts its declaration.");
+	let l = s(t, "lotPresent", ["UNKNOWN", "REPORTED"]) === "REPORTED", u = l ? s(t, "expiryPolicy", [
+		"UNKNOWN",
+		"TIME_BOUNDED",
+		"NO_REQUIRED_EXPIRY"
+	]) : "UNKNOWN", d = o(t, "expiresAt");
+	if (l && u === "NO_REQUIRED_EXPIRY" && d !== null) throw Error("No-required-expiry lot cannot have a cutoff.");
+	if (!n.length || n.length > 10) throw Error("Choose 1–10 exact evidence versions from shared Files.");
+	return {
+		effectiveAt: e(a(t, "effectiveAt") ?? ""),
+		evidence: n.map(({ fileId: e, versionId: t }) => ({
+			fileId: e,
+			versionId: t
+		})),
+		facts: {
+			scope: s(t, "scope", [
+				"UNKNOWN",
+				"WHOLE_LINE",
+				"UNSUPPORTED_MIXED_LOT"
+			]),
+			source: {
+				reference: a(t, "sourceReference"),
+				revision: a(t, "sourceRevision", 120)
+			},
+			countUnit: s(t, "unitPresent", ["UNKNOWN", "COUNT_UNIT"]) === "COUNT_UNIT" ? {
+				kind: "COUNT_UNIT",
+				reference: a(t, "unitReference"),
+				revision: a(t, "unitRevision", 120)
+			} : null,
+			scanMapping: {
+				reportedItemLabel: a(t, "itemLabel"),
+				reportedBinLabel: a(t, "binLabel"),
+				mappingReference: a(t, "mappingReference"),
+				mappingRevision: a(t, "mappingRevision", 120)
+			},
+			declaredLotPolicy: s(t, "lotPolicy", [
+				"UNKNOWN",
+				"REQUIRED",
+				"NOT_REQUIRED"
+			]),
+			lot: l ? {
+				reference: a(t, "lotReference"),
+				revision: a(t, "lotRevision", 120),
+				declaredDisposition: s(t, "lotDisposition", [
+					"UNKNOWN",
+					"RELEASED",
+					"HELD",
+					"EXPIRED"
+				]),
+				expiry: {
+					policy: u,
+					expiresAt: d,
+					sourceReference: a(t, "expiryReference"),
+					sourceRevision: a(t, "expiryRevision", 120)
+				}
+			} : null,
+			sourceValidity: {
+				policy: r,
+				from: i,
+				until: c,
+				sourceReference: a(t, "validityReference"),
+				sourceRevision: a(t, "validityRevision", 120)
+			}
+		}
+	};
+}
+//#endregion
+export { i as inputForStockDraft, c as readStockFactDraft, t as stockContextLabel, r as stockContextMatches, n as stockDraftPin };

package/dist/utils/stockBindingLabels.js

@@ -0,0 +1,23 @@
+//#region src/movethewheels/utils/stockBindingLabels.ts
+function e(e) {
+	return e === "SOURCE_FACTS_ONLY" ? "Reported facts" : e === "INCOMPLETE" ? "Missing facts" : e === "UNSUPPORTED_MIXED_LOT" ? "Mixed lots need separate handling" : "Unknown";
+}
+function t(e) {
+	if (!e || e === "UNKNOWN") return "Unknown";
+	if (e === "NO_REQUIRED_EXPIRY") return "Source reports no required expiry";
+	if (e === "COUNT_UNIT") return "Explicit count unit";
+	if (e === "UNSUPPORTED_MIXED_LOT") return "Mixed lots need separate handling";
+	let t = e.toLowerCase().replaceAll("_", " ");
+	return t.charAt(0).toUpperCase() + t.slice(1);
+}
+function n(e) {
+	let t = e.toLowerCase().replaceAll("_", " ").replace(/^declared /, "Reported ").replace(/ unknown$/, " is unknown");
+	return t.charAt(0).toUpperCase() + t.slice(1);
+}
+function r(e, t) {
+	if (e.capturedCompositionEpoch == null) return "Continuity revision not recorded.";
+	let n = `Recorded continuity revision: ${e.capturedCompositionEpoch}.`;
+	return !t || t.id !== e.inventoryItemId || !Number.isInteger(t.compositionEpoch) || t.compositionEpoch < 0 || t.compositionEpoch > 2147483647 ? `${n} Current comparison unavailable.` : t.compositionEpoch === e.capturedCompositionEpoch ? `${n} Matches the displayed stock revision.` : `${n} Stock context changed since this record.`;
+}
+//#endregion
+export { e as stockCompletenessLabel, r as stockContinuityLabel, t as stockFactLabel, n as stockMissingFactLabel };

package/dist/utils/stockObservationForm.js

@@ -0,0 +1,55 @@
+//#region src/movethewheels/utils/stockObservationForm.ts
+function e(e, t, n, r = !1) {
+	let i = e.get(t);
+	if (typeof i != "string") throw Error("Reported field is missing.");
+	let a = i.trim();
+	if (a.length > n || r && !a) throw Error("Check the reported field length.");
+	return a || null;
+}
+function t(e) {
+	let t = e.trim();
+	if (!t) return null;
+	if (!/^\d+$/.test(t)) throw Error("Reported count must be a whole number or blank.");
+	let n = Number(t);
+	if (!Number.isSafeInteger(n) || n > 2147483647) throw Error("Reported count is outside the supported range.");
+	return n;
+}
+function n(e) {
+	if (!e) return null;
+	let t = new Date(e);
+	if (!Number.isFinite(t.getTime()) || t.getTime() > Date.now()) throw Error("Reported observation time must be valid and no later than now.");
+	return t.toISOString();
+}
+function r(r, i) {
+	let a = e(i, "kind", 40, !0), o = e(i, "countScope", 40, !0);
+	if (a !== "COUNT_DISCREPANCY" && a !== "DAMAGE" && a !== "IDENTITY_UNCERTAIN" && a !== "OTHER") throw Error("Choose a supported issue.");
+	if (o !== "WHOLE_LINE" && o !== "UNKNOWN") throw Error("Choose a supported count scope.");
+	let s = e(i, "fileId", 255), c = e(i, "versionId", 255);
+	if (!!s != !!c) throw Error("Enter both exact file and version references, or leave both blank.");
+	let l = e(i, "unitReference", 255), u = e(i, "unitRevision", 255), d = e(i, "sourceReference", 255), f = e(i, "sourceRevision", 255), p = i.get("countUnit");
+	if (p !== "COUNT_UNIT" && p !== "UNKNOWN") throw Error("Choose a supported reported unit.");
+	if (p === "UNKNOWN" && (l || u)) throw Error("Select count unit before supplying its references.");
+	return {
+		inventoryItemId: r,
+		kind: a,
+		countScope: o,
+		observedCount: t(e(i, "observedCount", 32) ?? ""),
+		reportedCountUnit: p === "COUNT_UNIT" ? {
+			kind: "COUNT_UNIT",
+			reference: l,
+			revision: u
+		} : null,
+		source: d || f ? {
+			reference: d,
+			revision: f
+		} : null,
+		reportedObservedAt: n(e(i, "reportedObservedAt", 50) ?? ""),
+		reason: e(i, "reason", 1e3, !0) ?? "",
+		evidenceDeclarations: s && c ? [{
+			fileId: s,
+			versionId: c
+		}] : []
+	};
+}
+//#endregion
+export { r as stockObservationInput };

package/dist/utils/tripDraftContext.js

@@ -0,0 +1,19 @@
+//#region src/movethewheels/utils/tripDraftContext.ts
+function e(e, t) {
+	return !!t && t.id === e.routeId && t.updatedAt === e.routeUpdatedAt && t.vehicleId === e.vehicleId;
+}
+function t(t, n, r) {
+	return e(t, n) && !!r && r.id === t.vehicleId && r.updatedAt === t.vehicleUpdatedAt;
+}
+function n(e, n, r, i) {
+	if (!t(n, r, i)) throw Error("Route assignment or revision changed since this draft began. Refresh context, review the route and vehicle, and start a new report; the entered measurements will not be reassigned automatically.");
+	return {
+		...e,
+		routeId: n.routeId,
+		vehicleId: n.vehicleId,
+		expectedRouteUpdatedAt: n.routeUpdatedAt,
+		expectedVehicleUpdatedAt: n.vehicleUpdatedAt
+	};
+}
+//#endregion
+export { n as inputForTripDraft, t as tripContextStillMatches, e as tripRouteStillMatches };

package/dist/utils/tripUtilizationForm.js

@@ -0,0 +1,60 @@
+import { freeTimeIso as e } from "./freeTimeDate.js";
+import { reuseText as t } from "./reuseForm.js";
+//#region src/movethewheels/utils/tripUtilizationForm.ts
+function n(e, t, n = !1) {
+	if (!e.trim()) return null;
+	if (!/^(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/.test(e.trim())) throw Error("Enter a nonnegative measurement, or leave it blank for UNKNOWN.");
+	let r = Number(e);
+	if (!Number.isFinite(r) || r > t || r === 0 && /[1-9]/.test(e.trim().split(/[eE]/)[0] ?? "") || (n ? r <= 0 : r < 0)) throw Error(`Measurement must be ${n ? "positive" : "nonnegative"}, finite and no greater than ${t}.`);
+	return r;
+}
+function r(e, t, n) {
+	let r = t.find((t) => t === e);
+	if (!r) throw Error(`Choose ${n}.`);
+	return r;
+}
+function i(i, a, o, s, c) {
+	if (!c.length) throw Error("Select exact readable evidence versions for the report.");
+	let l = e(t(i, "intervalFrom")), u = e(t(i, "intervalUntil"));
+	if (l > u) throw Error("The report interval must end at or after its start.");
+	let d = a.map((a, s) => {
+		let c = (e) => t(i, `${a}.${e}`), d = c("observedAt"), f = d ? e(d) : null;
+		if (o === "OBSERVED" && (!f || f < l || f > u)) throw Error(`Segment ${s + 1}: observation time must be within the reported interval.`);
+		return {
+			segmentId: a,
+			sequence: s + 1,
+			loadedState: r(c("loadedState"), [
+				"EMPTY",
+				"LOADED",
+				"UNKNOWN"
+			], "explicit load state"),
+			distanceKm: n(c("distanceKm"), 1e7),
+			payloadKg: n(c("payloadKg"), 1e9),
+			payloadCapacityKg: n(c("payloadCapacityKg"), 1e9, !0),
+			cubeM3: n(c("cubeM3"), 1e9),
+			cubeCapacityM3: n(c("cubeCapacityM3"), 1e9, !0),
+			source: {
+				reference: c("reference"),
+				revision: c("revision"),
+				observedAt: f,
+				distanceBasis: r(c("distanceBasis"), o === "OBSERVED" ? ["MEASURED"] : ["PROVIDER_ESTIMATE", "OPERATOR_ESTIMATE"], "distance source basis"),
+				loadBasis: r(c("loadBasis"), o === "OBSERVED" ? ["MEASURED"] : ["MEASURED", "SOURCE_CONFIRMED_PLAN"], "load source basis"),
+				capacityBasis: r(c("capacityBasis"), ["RATED", "MEASURED"], "capacity source basis")
+			}
+		};
+	});
+	return {
+		tripId: t(i, "tripReference"),
+		basis: o,
+		declaredCoverage: s,
+		intervalFrom: l,
+		intervalUntil: u,
+		segments: d,
+		evidence: c.map(({ fileId: e, versionId: t }) => ({
+			fileId: e,
+			versionId: t
+		}))
+	};
+}
+//#endregion
+export { i as readTripDraft };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/microfe-movethewheels",
-  "version": "2026.930.4",
+  "version": "2026.1010.1",
   "description": "Burdenoff MoveTheWheels Microfrontend - Logistics & Supply Chain Management Platform",
   "type": "module",
   "files": [
@@ -25,6 +25,7 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
+    "verify:live-logistics-contract": "bun test scripts/check-logistics-live-contract.test.mjs scripts/fetch-logistics-live-schema.test.mjs",
     "dev": "vite --port 5191",
     "build": "tsc && bash scripts/build-limits.sh --gate vite build",
     "lint": "eslint .",
@@ -32,21 +33,32 @@
     "format": "prettier --write \"src/**/*.{ts,tsx}\"",
     "type:check": "bash scripts/build-limits.sh tsc --noEmit",
     "validate:schema-drift": "graphql-schema-drift",
-    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run codegen && bun run validate:schema-drift && bun run lint:sanity && bun run format && bun run type:check && bun run build && bun run build-storybook'",
+    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run codegen && bun run validate:schema-drift && bun run lint:sanity && bun run format && bun run type:check && bun run verify:live-logistics-contract && bun run verify:empty-reuse-retry && bun run verify:empty-reuse-recovery && bun run verify:trip-utilization-input && bun run verify:trip-draft-context && bun run verify:stock-binding-input && bun run verify:stock-observation-input && bun run verify:pending-pick-input && bun run verify:freight-input && bun run verify:freight-recovery && bun run verify:procedure-input && bun run verify:consolidation && bun run build && bun run build-storybook'",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build",
     "test:storybook": "test-storybook",
     "schema:pull": "bash scripts/schema-pull.sh",
     "schema:pull:introspect": "bash scripts/schema-pull.sh --mode introspect",
     "schema:check": "bash scripts/schema-pull.sh --check",
-    "codegen": "graphql-codegen --project wspace",
+    "verify:stock-binding-input": "bun scripts/verify-stock-binding-input.mjs",
+    "codegen": "graphql-codegen --project wspace && graphql-codegen --project container-foundation && graphql-codegen --project container-condition && graphql-codegen --project free-time && graphql-codegen --project empty-reuse && graphql-codegen --project trip-utilization && graphql-codegen --project stock-binding && graphql-codegen --project stock-observation && graphql-codegen --project pending-pick && graphql-codegen --project freight-cost && graphql-codegen --project logistics-procedure && graphql-codegen --project consolidation",
     "codegen:all": "bun run schema:pull && bun run codegen",
     "switch:status": "bun scripts/deps-mode.ts status",
     "switch:remote": "bun scripts/deps-mode.ts remote",
     "switch:local": "bun scripts/deps-mode.ts local",
     "switch:check": "bun scripts/deps-mode.ts check",
     "prepare": "lefthook install || true",
-    "format:check": "prettier --check \"src/**/*.{ts,tsx}\""
+    "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
+    "verify:empty-reuse-retry": "bun scripts/verify-empty-reuse-retry.mjs",
+    "verify:trip-utilization-input": "bun scripts/verify-trip-utilization-input.mjs",
+    "verify:trip-draft-context": "bun scripts/verify-trip-draft-context.mjs",
+    "verify:stock-observation-input": "bun scripts/verify-stock-observation-input.mjs",
+    "verify:pending-pick-input": "bun scripts/verify-pending-pick-input.mjs",
+    "verify:empty-reuse-recovery": "bun scripts/verify-empty-reuse-recovery.mjs && bun scripts/verify-empty-reuse-recovery-hook.mjs",
+    "verify:freight-input": "bun scripts/verify-freight-input.mjs",
+    "verify:freight-recovery": "bun scripts/verify-freight-recovery-hook.mjs",
+    "verify:procedure-input": "bun scripts/verify-procedure-input.mjs && bun scripts/verify-procedure-recovery-hook.mjs",
+    "verify:consolidation": "bun scripts/verify-consolidation-input.mjs && bun scripts/verify-consolidation-recovery-hook.mjs && bun scripts/verify-consolidation-mounted-hook.mjs"
   },
   "dependencies": {
     "@apollo/client": "^4.0.11",
@@ -66,6 +78,7 @@
     "zustand": "^5.0.3"
   },
   "devDependencies": {
+    "@escape.tech/graphql-armor-cost-limit": "2.4.3",
     "@eslint/js": "^9.39.2",
     "@graphql-codegen/add": "^5.0.0",
     "@graphql-codegen/cli": "^5.0.0",
@@ -94,11 +107,12 @@
     "lefthook": "^2.1.1",
     "postcss": "^8.4.49",
     "prettier": "^3.4.2",
+    "react-test-renderer": "19.3.0",
     "storybook": "^8.6.0",
     "tailwindcss": "^4.0.0",
     "typescript": "^5.9.0",
     "typescript-eslint": "^8.54.0",
-    "vite": "8.0.8",
+    "vite": "8.0.16",
     "vite-plugin-dts": "3.9.1"
   },
   "peerDependencies": {