@burdenoff/fe-libs 2026.812.1 → 2026.813.1

package/dist/storage/uploadBlob.d.ts

@@ -17,5 +17,16 @@ export interface UploadedFile {
     name: string;
     folderId: string | null;
 }
+/**
+ * Best-effort message extraction, preferring the first GraphQL error's message
+ * (Apollo v4 CombinedGraphQLErrors `.errors`, or v3 `.graphQLErrors`) so we surface
+ * the real reason a completeUpload failed instead of a generic error envelope.
+ *
+ * Exported because every `client.mutate` call in this module faces the same
+ * problem: under `errorPolicy: 'all'` the failure arrives in-band on
+ * `result.error` and the caller's own "that didn't work" string is the LEAST
+ * informative thing it could report. See `useSaveToFiles`.
+ */
+export declare function extractErrorMessage(err: unknown): string | undefined;
 export declare function uploadBlobToFiles(params: UploadBlobParams): Promise<UploadedFile>;
 //# sourceMappingURL=uploadBlob.d.ts.map

package/dist/storage/uploadBlob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploadBlob.d.ts","sourceRoot":"","sources":["../../src/storage/uploadBlob.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAyBxD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,UAKpC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA6CD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8HvF"}
+{"version":3,"file":"uploadBlob.d.ts","sourceRoot":"","sources":["../../src/storage/uploadBlob.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAyBxD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,UAKpC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAWpE;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8HvF"}

package/dist/storage/uploadBlob.js

@@ -99,4 +99,4 @@ async function o(e) {
 	return d?.(100), _;
 }
 //#endregion
-export { r as FILES_AFTER_SAVE_REFETCH, o as uploadBlobToFiles };
+export { r as FILES_AFTER_SAVE_REFETCH, a as extractErrorMessage, o as uploadBlobToFiles };

package/dist/storage/useSaveToFiles.d.ts

@@ -1,3 +1,4 @@
+import { ApolloClient } from '@apollo/client';
 import { SaveToFilesSource } from './SaveToFilesButton';
 export interface SavedFile {
     id: string;
@@ -13,5 +14,32 @@ export interface UseSaveToFilesResult {
     error: Error | null;
     progress: number;
 }
+/** The Apollo surface `resolveFolderIdByPath` needs — kept narrow so it is trivial to fake. */
+type FolderMutatingClient = Pick<ApolloClient, 'mutate'>;
+/**
+ * Resolve (creating if needed) the destination folder for a path, returning its id.
+ *
+ * Split out of the hook so it is unit-testable the same way `uploadBlobToFiles`
+ * is: pure modulo the injected Apollo client.
+ *
+ * `ensureFolderByPath` is declared `Folder!` in wspace-files-svc, and its
+ * resolver creates any missing ancestors and collapses concurrent calls for the
+ * same path onto a single row (partial unique index on
+ * `(workspace_id, parent_folder_id, name)`). It therefore never resolves to
+ * null: a null here means the operation FAILED and GraphQL non-null propagation
+ * blanked the field.
+ *
+ * That distinction is the whole point of this function. The shared Apollo client
+ * runs `errorPolicy: 'all'`, so those failures come back IN-BAND on
+ * `result.error` rather than being thrown — exactly as `uploadBlobToFiles`
+ * already documents for initiateUpload/completeUpload. Reading only `data` and
+ * blaming the path turned a gateway OPERATION_TIMEOUT into "Could not resolve
+ * folder for path: /HealthyBowl/AI Assistant/Attachments", which reads like a
+ * bad path or a missing folder and sent people looking at file-storage quota
+ * they had plenty of. Surface the real reason; keep the path as a last resort
+ * for the genuinely inexplicable case.
+ */
+export declare function resolveFolderIdByPath(client: FolderMutatingClient, folderPath: string): Promise<string>;
 export declare function useSaveToFiles(): UseSaveToFilesResult;
+export {};
 //# sourceMappingURL=useSaveToFiles.d.ts.map

package/dist/storage/useSaveToFiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSaveToFiles.d.ts","sourceRoot":"","sources":["../../src/storage/useSaveToFiles.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAuB7D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxF,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,IAAI,oBAAoB,CAmErD"}
+{"version":3,"file":"useSaveToFiles.d.ts","sourceRoot":"","sources":["../../src/storage/useSaveToFiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAIxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAuB7D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxF,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+FAA+F;AAC/F,KAAK,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAgB,cAAc,IAAI,oBAAoB,CAqErD"}

package/dist/storage/useSaveToFiles.js

@@ -1,9 +1,9 @@
-import { FILES_AFTER_SAVE_REFETCH as e, uploadBlobToFiles as t } from "./uploadBlob.js";
-import { useState as n } from "react";
-import { gql as r } from "@apollo/client";
-import { useApolloClient as i } from "@apollo/client/react";
+import { FILES_AFTER_SAVE_REFETCH as e, extractErrorMessage as t, uploadBlobToFiles as n } from "./uploadBlob.js";
+import { useState as r } from "react";
+import { gql as i } from "@apollo/client";
+import { useApolloClient as a } from "@apollo/client/react";
 //#region src/storage/useSaveToFiles.ts
-var a = r`
+var o = i`
   mutation SaveToFiles_EnsureFolderByPath($path: String!) {
     ensureFolderByPath(path: $path) {
       id
@@ -11,7 +11,7 @@ var a = r`
       path
     }
   }
-`, o = r`
+`, s = i`
   mutation SaveToFiles_SaveSandboxArtifact($input: SaveSandboxArtifactInput!) {
     saveSandboxArtifactToFiles(input: $input) {
       id
@@ -20,54 +20,58 @@ var a = r`
     }
   }
 `;
-function s() {
-	let r = i(), [s, c] = n(!1), [l, u] = n(null), [d, f] = n(0);
+async function c(e, n) {
+	let r = await e.mutate({
+		mutation: o,
+		variables: { path: n }
+	}), i = r.data?.ensureFolderByPath?.id;
+	if (i) return i;
+	throw Error(t(r.error) ?? `Could not resolve folder for path: ${n}`);
+}
+function l() {
+	let i = a(), [o, l] = r(!1), [u, d] = r(null), [f, p] = r(0);
 	return {
-		save: async (n) => {
-			c(!0), u(null), f(0);
+		save: async (r) => {
+			l(!0), d(null), p(0);
 			try {
-				let i = (await r.mutate({
-					mutation: a,
-					variables: { path: n.folderPath }
-				})).data?.ensureFolderByPath?.id;
-				if (!i) throw Error(`Could not resolve folder for path: ${n.folderPath}`);
-				if (n.source.kind === "sandbox-artifact") {
-					let t = (await r.mutate({
-						mutation: o,
+				let a = await c(i, r.folderPath);
+				if (r.source.kind === "sandbox-artifact") {
+					let n = await i.mutate({
+						mutation: s,
 						variables: { input: {
-							sandboxId: n.source.sandboxId,
-							sessionId: n.source.sessionId,
-							path: n.source.path,
-							folderId: i,
-							filename: n.source.filename ?? null
+							sandboxId: r.source.sandboxId,
+							sessionId: r.source.sessionId,
+							path: r.source.path,
+							folderId: a,
+							filename: r.source.filename ?? null
 						} },
 						refetchQueries: e
-					})).data?.saveSandboxArtifactToFiles;
-					if (!t) throw Error("saveSandboxArtifactToFiles returned no file");
-					return f(100), t;
+					}), o = n.data?.saveSandboxArtifactToFiles;
+					if (!o) throw Error(t(n.error) ?? "saveSandboxArtifactToFiles returned no file");
+					return p(100), o;
 				}
-				let s = await n.source.getBlob();
-				if (!s) throw Error("Cancelled: no bytes to save");
-				let c = s.blob;
-				return await t({
-					client: r,
-					blob: c,
-					filename: s.filename ?? n.source.filename,
-					mimeType: s.mimeType ?? n.source.mimeType,
-					folderId: i,
-					onProgress: f
+				let o = await r.source.getBlob();
+				if (!o) throw Error("Cancelled: no bytes to save");
+				let l = o.blob;
+				return await n({
+					client: i,
+					blob: l,
+					filename: o.filename ?? r.source.filename,
+					mimeType: o.mimeType ?? r.source.mimeType,
+					folderId: a,
+					onProgress: p
 				});
 			} catch (e) {
 				let t = e instanceof Error ? e : Error(String(e));
-				throw u(t), t;
+				throw d(t), t;
 			} finally {
-				c(!1);
+				l(!1);
 			}
 		},
-		isPending: s,
-		error: l,
-		progress: d
+		isPending: o,
+		error: u,
+		progress: f
 	};
 }
 //#endregion
-export { s as useSaveToFiles };
+export { l as useSaveToFiles };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fe-libs",
-  "version": "2026.812.1",
+  "version": "2026.813.1",
   "description": "Burdenoff frontend primitives and domain libraries",
   "type": "module",
   "bin": {