@burdenoff/microfe-movethewheels 2026.725.1 → 2026.726.1

package/dist/hooks/useEntityDocuments.js

@@ -2,7 +2,7 @@ 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";
 //#region src/movethewheels/hooks/useEntityDocuments.ts
-var o = "\n  query ListEntityDocuments($filter: FileFilterInput, $pagination: PaginationInput) {\n    files(filter: $filter, pagination: $pagination) {\n      id\n      name\n      size\n      mimeType\n      createdAt\n      downloadUrl\n    }\n  }\n";
+var o = "\n  query ListEntityDocuments($filter: FileFilterInput, $pagination: PaginationInput) {\n    getFiles(filter: $filter, pagination: $pagination) {\n      files {\n        id\n        name\n        size\n        mimeType\n        createdAt\n        downloadUrl\n      }\n    }\n  }\n";
 function s(e) {
 	return {
 		id: e.id,
@@ -38,16 +38,16 @@ function c(c, l) {
 			_(((await t(S, o, {
 				filter: { tags: [{
 					key: "mtwEntityType",
-					value: c
+					label: c
 				}, {
 					key: "mtwEntityId",
-					value: l
+					label: l
 				}] },
 				pagination: {
 					limit: 50,
 					offset: 0
 				}
-			})).files ?? []).map(s));
+			})).getFiles?.files ?? []).map(s));
 		} catch (e) {
 			x(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to load documents")), _([]);
 		} finally {

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

@@ -5,10 +5,26 @@
  * driver or order live in the platform Files module (wspace-files-svc), which
  * federates into the same workspace gateway. We tag each uploaded file with two
  * marqueue entity tags — `mtwEntityType` and `mtwEntityId` — and list them back
- * here through the federated `files(filter:{ tags:[...] })` query.
+ * here through `getFiles(filter:{ tags:[...] })`.
  *
  * There is no upload UI here (out of scope): uploading/managing happens in the
  * Files module, deep-linked from DocumentsCard. This hook is read-only.
+ *
+ * BOFF-3922 fix (2026-07-26): this previously called a non-existent root field
+ * `files(...)` — the wspace gateway only exposes `Workspace.files` (nested) and
+ * root fields `getFiles`/`searchFiles`/`ownedFiles`/`uploadedFiles`, none named
+ * bare `files`. Fixed to `getFiles(...): FileList!` (unwrapping `.files`), the
+ * root field whose `folderId` arg is optional so it supports a workspace-wide
+ * filter-only lookup. Caught by the new graphql-schema-drift CI guard, which
+ * had zero prior coverage on this repo — this bug would otherwise have shipped
+ * to prod undetected, same as BOFF-3915/BOFF-4703/BOFF-3529.
+ *
+ * NOT verified by this fix: whether `TagFilterInput.label` (renamed here from
+ * the nonexistent `.value`) actually produces the intended
+ * mtwEntityType+mtwEntityId AND-filter semantics against wspace-files-svc's
+ * tag-matching resolver — that's a wspace-files-svc/wspace-tags-svc business-
+ * logic question outside a schema-shape validator's reach (it operates on
+ * runtime variable values, not the query document). Flagged as follow-up.
  */
 export type EntityDocumentType = 'vehicle' | 'driver' | 'order';
 export interface EntityDocument {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/microfe-movethewheels",
-  "version": "2026.725.1",
+  "version": "2026.726.1",
   "description": "Burdenoff MoveTheWheels Microfrontend - Logistics & Supply Chain Management Platform",
   "type": "module",
   "files": [
@@ -31,7 +31,8 @@
     "lint:sanity": "if [ \"${CI:-}\" = \"true\" ]; then bun run lint; else bun run lint -- --cache --cache-location .eslintcache; fi",
     "format": "prettier --write \"src/**/*.{ts,tsx}\"",
     "type:check": "tsc --noEmit",
-    "sanity": "bun run codegen && bun run lint:sanity && bun run format && bun run type:check && bun run build && bun run build-storybook",
+    "validate:schema-drift": "graphql-schema-drift",
+    "sanity": "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",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build",
     "test:storybook": "test-storybook",
@@ -47,7 +48,7 @@
   },
   "dependencies": {
     "@apollo/client": "^4.0.11",
-    "@burdenoff/fe-libs": "2026.713.6",
+    "@burdenoff/fe-libs": "2026.726.1",
     "@react-leaflet/core": "^3.0.0",
     "@tanstack/react-query": "^5.90.16",
     "clsx": "^2.1.1",

package/src/movethewheels/hooks/useEntityDocuments.ts

@@ -5,10 +5,26 @@
  * driver or order live in the platform Files module (wspace-files-svc), which
  * federates into the same workspace gateway. We tag each uploaded file with two
  * marqueue entity tags — `mtwEntityType` and `mtwEntityId` — and list them back
- * here through the federated `files(filter:{ tags:[...] })` query.
+ * here through `getFiles(filter:{ tags:[...] })`.
  *
  * There is no upload UI here (out of scope): uploading/managing happens in the
  * Files module, deep-linked from DocumentsCard. This hook is read-only.
+ *
+ * BOFF-3922 fix (2026-07-26): this previously called a non-existent root field
+ * `files(...)` — the wspace gateway only exposes `Workspace.files` (nested) and
+ * root fields `getFiles`/`searchFiles`/`ownedFiles`/`uploadedFiles`, none named
+ * bare `files`. Fixed to `getFiles(...): FileList!` (unwrapping `.files`), the
+ * root field whose `folderId` arg is optional so it supports a workspace-wide
+ * filter-only lookup. Caught by the new graphql-schema-drift CI guard, which
+ * had zero prior coverage on this repo — this bug would otherwise have shipped
+ * to prod undetected, same as BOFF-3915/BOFF-4703/BOFF-3529.
+ *
+ * NOT verified by this fix: whether `TagFilterInput.label` (renamed here from
+ * the nonexistent `.value`) actually produces the intended
+ * mtwEntityType+mtwEntityId AND-filter semantics against wspace-files-svc's
+ * tag-matching resolver — that's a wspace-files-svc/wspace-tags-svc business-
+ * logic question outside a schema-shape validator's reach (it operates on
+ * runtime variable values, not the query document). Flagged as follow-up.
  */
 
 import { useCallback, useEffect, useMemo, useState } from 'react';
@@ -46,13 +62,15 @@ interface UseEntityDocumentsResult {
 
 const LIST_ENTITY_FILES_QUERY = `
   query ListEntityDocuments($filter: FileFilterInput, $pagination: PaginationInput) {
-    files(filter: $filter, pagination: $pagination) {
-      id
-      name
-      size
-      mimeType
-      createdAt
-      downloadUrl
+    getFiles(filter: $filter, pagination: $pagination) {
+      files {
+        id
+        name
+        size
+        mimeType
+        createdAt
+        downloadUrl
+      }
     }
   }
 `;
@@ -98,20 +116,20 @@ export function useEntityDocuments(
     setIsLoading(true);
     setError(null);
     try {
-      const data = await executeGraphQL<{ files: ApiFile[] }>(
+      const data = await executeGraphQL<{ getFiles: { files: ApiFile[] } }>(
         graphQLOptions,
         LIST_ENTITY_FILES_QUERY,
         {
           filter: {
             tags: [
-              { key: 'mtwEntityType', value: entityType },
-              { key: 'mtwEntityId', value: entityId },
+              { key: 'mtwEntityType', label: entityType },
+              { key: 'mtwEntityId', label: entityId },
             ],
           },
           pagination: { limit: 50, offset: 0 },
         }
       );
-      setDocuments((data.files ?? []).map(mapFile));
+      setDocuments((data.getFiles?.files ?? []).map(mapFile));
     } catch (fetchError) {
       setError(fetchError instanceof Error ? fetchError : new Error('Failed to load documents'));
       setDocuments([]);