@burdenoff/fe-libs 2026.521.4 → 2026.521.5

package/dist/storage/SaveToFilesButton.d.ts

@@ -0,0 +1,55 @@
+import { SavedFile } from './useSaveToFiles';
+/** Two shapes — pick one based on where the bytes come from. */
+export type SaveToFilesSource = {
+    kind: 'blob';
+    /**
+     * Producer thunk. Returning `null` cleanly aborts the save (e.g. user
+     * cancelled a downstream confirm). Producers MAY override the filename
+     * and mime type at runtime (useful when the bytes carry metadata only
+     * known after a slow GraphQL call resolves).
+     */
+    getBlob: () => Promise<{
+        blob: Blob;
+        filename?: string;
+        mimeType?: string;
+    } | null>;
+    /** Default filename — used by the browser-download path. */
+    filename: string;
+    /** Default MIME type — used by the browser-download path. */
+    mimeType: string;
+} | {
+    kind: 'sandbox-artifact';
+    sandboxId: string;
+    sessionId: string;
+    /** Artifact path inside the sandbox session. */
+    path: string;
+    /** Optional override; otherwise the sandbox's reported filename wins. */
+    filename?: string;
+};
+interface Props {
+    source: SaveToFilesSource;
+    /**
+     * Pre-selected destination folder path. The dialog will lazily create
+     * missing ancestors via `ensureFolderByPath` on submit. The user can edit
+     * the path in the dialog.
+     */
+    defaultFolderPath?: string;
+    /**
+     * Browser-download action. Called when the user clicks the primary button.
+     * SaveToFilesButton does not implement the download itself — callers may
+     * have specialised tracking, anti-flood, or transformation logic.
+     */
+    onDownload: () => void | Promise<void>;
+    /** Called after a successful Save to Files. */
+    onSaved?: (file: SavedFile) => void;
+    /** Primary button label. Default "Download". */
+    label?: string;
+    disabled?: boolean;
+    /** ARIA-style test ID prefix; defaults to `save-to-files`. */
+    testId?: string;
+    /** Pass-through className for the outer wrapper. */
+    className?: string;
+}
+export declare function SaveToFilesButton({ source, defaultFolderPath, onDownload, onSaved, label, disabled, testId, className, }: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=SaveToFilesButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SaveToFilesButton.d.ts","sourceRoot":"","sources":["../../src/storage/SaveToFilesButton.tsx"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACpF,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN,UAAU,KAAK;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,UAAU,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,iBAAiB,EACjB,UAAU,EACV,OAAO,EACP,KAAkB,EAClB,QAAQ,EACR,MAAwB,EACxB,SAAS,GACV,EAAE,KAAK,2CAsDP"}

package/dist/storage/SaveToFilesButton.js

@@ -0,0 +1,56 @@
+import { Button as e } from "../ui/button.js";
+import { DropdownMenu as t, DropdownMenuContent as n, DropdownMenuItem as r, DropdownMenuTrigger as i } from "../ui/dropdown-menu.js";
+import { SaveToFilesDialog as a } from "./SaveToFilesDialog.js";
+import { useState as o } from "react";
+import { Download as s, FolderInput as c } from "lucide-react";
+import { Fragment as l, jsx as u, jsxs as d } from "react/jsx-runtime";
+//#region src/storage/SaveToFilesButton.tsx
+function f(e) {
+	return e.kind === "blob" ? e.filename : e.filename ?? e.path.split("/").filter(Boolean).pop() ?? "artifact";
+}
+function p({ source: p, defaultFolderPath: m, onDownload: h, onSaved: g, label: _ = "Download", disabled: v, testId: y = "save-to-files", className: b }) {
+	let [x, S] = o(!1), C = f(p);
+	return /* @__PURE__ */ d(l, { children: [/* @__PURE__ */ d("div", {
+		className: `inline-flex items-center ${b ?? ""}`,
+		children: [/* @__PURE__ */ d(e, {
+			variant: "outline",
+			size: "sm",
+			disabled: v,
+			onClick: () => void h(),
+			"data-testid": `${y}-download`,
+			className: "rounded-r-none",
+			children: [/* @__PURE__ */ u(s, { className: "mr-1.5 h-3.5 w-3.5" }), _]
+		}), /* @__PURE__ */ d(t, { children: [/* @__PURE__ */ u(i, {
+			asChild: !0,
+			children: /* @__PURE__ */ u(e, {
+				variant: "outline",
+				size: "sm",
+				disabled: v,
+				"aria-label": "More save actions",
+				"data-testid": `${y}-menu`,
+				className: "rounded-l-none border-l-0 px-2",
+				children: "▾"
+			})
+		}), /* @__PURE__ */ d(n, {
+			align: "end",
+			children: [/* @__PURE__ */ d(r, {
+				onSelect: () => void h(),
+				"data-testid": `${y}-menu-download`,
+				children: [/* @__PURE__ */ u(s, { className: "mr-2 h-3.5 w-3.5" }), "Download"]
+			}), /* @__PURE__ */ d(r, {
+				onSelect: () => S(!0),
+				"data-testid": `${y}-menu-save`,
+				children: [/* @__PURE__ */ u(c, { className: "mr-2 h-3.5 w-3.5" }), "Save to Files…"]
+			})]
+		})] })]
+	}), /* @__PURE__ */ u(a, {
+		open: x,
+		onOpenChange: S,
+		source: p,
+		defaultFolderPath: m,
+		filename: C,
+		onSaved: g
+	})] });
+}
+//#endregion
+export { p as SaveToFilesButton };

package/dist/storage/SaveToFilesDialog.d.ts

@@ -0,0 +1,13 @@
+import { SaveToFilesSource } from './SaveToFilesButton';
+import { SavedFile } from './useSaveToFiles';
+interface Props {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    source: SaveToFilesSource;
+    defaultFolderPath?: string;
+    filename: string;
+    onSaved?: (file: SavedFile) => void;
+}
+export declare function SaveToFilesDialog({ open, onOpenChange, source, defaultFolderPath, filename, onSaved }: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=SaveToFilesDialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SaveToFilesDialog.d.ts","sourceRoot":"","sources":["../../src/storage/SaveToFilesDialog.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElE,UAAU,KAAK;IACb,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACrC;AAED,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,2CAqF5G"}

package/dist/storage/SaveToFilesDialog.js

@@ -0,0 +1,88 @@
+import { Button as e } from "../ui/button.js";
+import { Dialog as t, DialogContent as n, DialogDescription as r, DialogFooter as i, DialogHeader as a, DialogTitle as o } from "../ui/dialog.js";
+import { Input as s } from "../ui/input.js";
+import { Label as c } from "../ui/label.js";
+import { Spinner as l } from "../ui/spinner.js";
+import { useSaveToFiles as u } from "./useSaveToFiles.js";
+import { useEffect as d, useState as f } from "react";
+import { Fragment as p, jsx as m, jsxs as h } from "react/jsx-runtime";
+//#region src/storage/SaveToFilesDialog.tsx
+function g({ open: g, onOpenChange: _, source: v, defaultFolderPath: y, filename: b, onSaved: x }) {
+	let [S, C] = f(y ?? "/Saved"), { save: w, isPending: T, error: E, progress: D } = u();
+	return d(() => {
+		g && C(y ?? "/Saved");
+	}, [g, y]), /* @__PURE__ */ m(t, {
+		open: g,
+		onOpenChange: _,
+		children: /* @__PURE__ */ h(n, { children: [
+			/* @__PURE__ */ h(a, { children: [/* @__PURE__ */ m(o, { children: "Save to Files" }), /* @__PURE__ */ h(r, { children: [
+				"Save ",
+				/* @__PURE__ */ m("span", {
+					className: "font-medium",
+					children: b
+				}),
+				" into a folder in this workspace."
+			] })] }),
+			/* @__PURE__ */ h("div", {
+				className: "space-y-3 py-2",
+				children: [
+					/* @__PURE__ */ h("div", { children: [
+						/* @__PURE__ */ m(c, {
+							htmlFor: "save-to-files-folder",
+							children: "Folder"
+						}),
+						/* @__PURE__ */ m(s, {
+							id: "save-to-files-folder",
+							value: S,
+							onChange: (e) => C(e.target.value),
+							placeholder: "/Vibecontrols/AI Assistant/Artifacts",
+							disabled: T,
+							"data-testid": "save-to-files-folder-input"
+						}),
+						/* @__PURE__ */ m("p", {
+							className: "mt-1 text-xs text-muted-foreground",
+							children: "Missing parent folders are created automatically."
+						})
+					] }),
+					v.kind === "blob" && T && /* @__PURE__ */ m("div", {
+						className: "h-1 w-full overflow-hidden rounded bg-muted",
+						role: "progressbar",
+						"aria-valuenow": D,
+						"aria-valuemin": 0,
+						"aria-valuemax": 100,
+						children: /* @__PURE__ */ m("div", {
+							className: "h-full bg-primary transition-[width]",
+							style: { width: `${D}%` }
+						})
+					}),
+					E && /* @__PURE__ */ m("p", {
+						className: "text-xs text-destructive",
+						"data-testid": "save-to-files-error",
+						children: E.message
+					})
+				]
+			}),
+			/* @__PURE__ */ h(i, { children: [/* @__PURE__ */ m(e, {
+				variant: "ghost",
+				disabled: T,
+				onClick: () => _(!1),
+				children: "Cancel"
+			}), /* @__PURE__ */ m(e, {
+				disabled: T || S.trim().length === 0,
+				onClick: async () => {
+					try {
+						let e = await w({
+							source: v,
+							folderPath: S
+						});
+						x?.(e), _(!1);
+					} catch {}
+				},
+				"data-testid": "save-to-files-save",
+				children: T ? /* @__PURE__ */ h(p, { children: [/* @__PURE__ */ m(l, { className: "mr-2 h-3 w-3" }), "Saving…"] }) : "Save"
+			})] })
+		] })
+	});
+}
+//#endregion
+export { g as SaveToFilesDialog };

package/dist/storage/StorageFolderPicker.js

@@ -0,0 +1,134 @@
+import { useEffect as e, useState as t } from "react";
+import { jsx as n, jsxs as r } from "react/jsx-runtime";
+import { gql as i } from "@apollo/client";
+import { useApolloClient as a } from "@apollo/client/react";
+//#region src/storage/StorageFolderPicker.tsx
+var o = i`
+  query StorageFolderPicker_ListFolders($context: ContextInput!, $parentId: ID) {
+    listFiles(context: $context, parentId: $parentId, kind: FOLDER) {
+      items {
+        id
+        name
+        path
+        parentId
+      }
+    }
+  }
+`, s = i`
+  mutation StorageFolderPicker_CreateFolder($input: CreateFolderInput!) {
+    createFolder(input: $input) {
+      id
+      name
+      path
+      parentId
+    }
+  }
+`;
+function c({ workspaceId: i, value: c, onChange: l, operations: u, initialParentId: d, disabled: f }) {
+	let p = a(), [m, h] = t(null), [g, _] = t(!1), [v, y] = t(""), [b, x] = t(null), S = u?.list ?? o, C = u?.create ?? s;
+	return e(() => {
+		let e = !1;
+		return h(null), x(null), p.query({
+			query: S,
+			variables: {
+				context: { workspaceId: i },
+				parentId: d ?? null
+			},
+			fetchPolicy: "network-only"
+		}).then((t) => {
+			e || h((t.data?.listFiles?.items ?? []).map(({ __typename: e, ...t }) => t));
+		}).catch((t) => {
+			e || x(t instanceof Error ? t.message : String(t));
+		}), () => {
+			e = !0;
+		};
+	}, [
+		p,
+		S,
+		i,
+		d
+	]), /* @__PURE__ */ r("div", {
+		className: "space-y-2",
+		children: [
+			/* @__PURE__ */ n("label", {
+				className: "block text-xs font-medium text-text-secondary",
+				children: "Save to folder"
+			}),
+			b && /* @__PURE__ */ n("p", {
+				className: "text-xs text-status-error-text",
+				children: b
+			}),
+			m == null ? /* @__PURE__ */ n("p", {
+				className: "text-xs text-text-tertiary",
+				children: "Loading folders…"
+			}) : m.length === 0 ? /* @__PURE__ */ n("p", {
+				className: "text-xs text-text-tertiary",
+				children: "No folders yet — create one."
+			}) : /* @__PURE__ */ r("select", {
+				disabled: f,
+				value: c?.id ?? "",
+				onChange: (e) => {
+					l(m.find((t) => t.id === e.target.value) ?? null);
+				},
+				className: "w-full rounded-md border border-border-subtle bg-bg-surface px-2 py-1.5 text-sm",
+				"aria-label": "Folder",
+				children: [/* @__PURE__ */ n("option", {
+					value: "",
+					children: "— Pick a folder —"
+				}), m.map((e) => /* @__PURE__ */ n("option", {
+					value: e.id,
+					children: e.path
+				}, e.id))]
+			}),
+			g ? /* @__PURE__ */ r("div", {
+				className: "flex items-center gap-2",
+				children: [
+					/* @__PURE__ */ n("input", {
+						type: "text",
+						value: v,
+						onChange: (e) => y(e.target.value),
+						placeholder: "New folder name",
+						className: "flex-1 rounded-md border border-border-subtle bg-bg-surface px-2 py-1.5 text-sm"
+					}),
+					/* @__PURE__ */ n("button", {
+						type: "button",
+						onClick: async () => {
+							let e = v.trim();
+							if (e) try {
+								let t = (await p.mutate({
+									mutation: C,
+									variables: { input: {
+										name: e,
+										parentId: d ?? null,
+										context: { workspaceId: i }
+									} }
+								})).data?.createFolder;
+								t && (h((e) => e ? [...e, t] : [t]), y(""), _(!1), l(t));
+							} catch (e) {
+								x(e instanceof Error ? e.message : String(e));
+							}
+						},
+						className: "rounded-md bg-status-info-bg-default px-2.5 py-1.5 text-xs text-status-info-text-inverse",
+						children: "Create"
+					}),
+					/* @__PURE__ */ n("button", {
+						type: "button",
+						onClick: () => {
+							_(!1), y("");
+						},
+						className: "rounded-md border border-border-subtle px-2.5 py-1.5 text-xs text-text-secondary",
+						children: "Cancel"
+					})
+				]
+			}) : /* @__PURE__ */ n("button", {
+				type: "button",
+				onClick: () => _(!0),
+				disabled: f,
+				className: "text-xs text-status-info-text hover:underline disabled:opacity-50",
+				children: "+ New folder"
+			})
+		]
+	});
+}
+//#endregion
+export { c as StorageFolderPicker };

package/dist/storage/index.d.ts

@@ -1,3 +1,10 @@
 export { StorageFolderPicker } from './StorageFolderPicker';
 export type { StorageFolder } from './StorageFolderPicker';
+export { SaveToFilesButton } from './SaveToFilesButton';
+export type { SaveToFilesSource } from './SaveToFilesButton';
+export { SaveToFilesDialog } from './SaveToFilesDialog';
+export { useSaveToFiles } from './useSaveToFiles';
+export type { SavedFile, UseSaveToFilesResult } from './useSaveToFiles';
+export { uploadBlobToFiles, FILES_AFTER_SAVE_REFETCH } from './uploadBlob';
+export type { UploadBlobParams, UploadedFile } from './uploadBlob';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,6 @@
+import { StorageFolderPicker as e } from "./StorageFolderPicker.js";
+import { FILES_AFTER_SAVE_REFETCH as t, uploadBlobToFiles as n } from "./uploadBlob.js";
+import { useSaveToFiles as r } from "./useSaveToFiles.js";
+import { SaveToFilesDialog as i } from "./SaveToFilesDialog.js";
+import { SaveToFilesButton as a } from "./SaveToFilesButton.js";
+export { t as FILES_AFTER_SAVE_REFETCH, a as SaveToFilesButton, i as SaveToFilesDialog, e as StorageFolderPicker, n as uploadBlobToFiles, r as useSaveToFiles };

package/dist/storage/uploadBlob.d.ts

@@ -0,0 +1,21 @@
+import { ApolloClient } from '@apollo/client';
+/**
+ * Apollo invalidations every "Save to Files" caller benefits from — pulled
+ * from microfe-files' useUploadFile to keep the browse views in sync.
+ */
+export declare const FILES_AFTER_SAVE_REFETCH: string[];
+export interface UploadBlobParams {
+    client: ApolloClient;
+    blob: Blob;
+    filename: string;
+    mimeType: string;
+    folderId: string;
+    onProgress?: (pct: number) => void;
+}
+export interface UploadedFile {
+    id: string;
+    name: string;
+    folderId: string | null;
+}
+export declare function uploadBlobToFiles(params: UploadBlobParams): Promise<UploadedFile>;
+//# sourceMappingURL=uploadBlob.d.ts.map

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

@@ -0,0 +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;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoEvF"}

package/dist/storage/uploadBlob.js

@@ -0,0 +1,65 @@
+import { gql as e } from "@apollo/client";
+//#region src/storage/uploadBlob.ts
+var t = e`
+  mutation SaveToFiles_InitiateUpload($input: InitiateUploadInput!) {
+    initiateUpload(input: $input) {
+      session {
+        id
+      }
+      uploadUrl
+    }
+  }
+`, n = e`
+  mutation SaveToFiles_CompleteUpload($input: CompleteUploadInput!) {
+    completeUpload(input: $input) {
+      file {
+        id
+        name
+        folderId
+      }
+    }
+  }
+`, r = [
+	"GetFilesRootBrowsePage",
+	"GetFilesFolderBrowsePage",
+	"GetFilesRecentPage",
+	"GetFiles"
+];
+async function i(e) {
+	let { client: i, blob: a, filename: o, mimeType: s, folderId: c, onProgress: l } = e, u = o.includes(".") ? o.substring(o.lastIndexOf(".") + 1) : "";
+	l?.(0);
+	let d = await i.mutate({
+		mutation: t,
+		variables: { input: {
+			fileName: o,
+			fileSize: String(a.size),
+			mimeType: s,
+			extension: u,
+			folderId: c
+		} }
+	}), f = d.data?.initiateUpload?.session, p = d.data?.initiateUpload?.uploadUrl;
+	if (!f || !p) throw Error("initiateUpload did not return a presigned URL");
+	l?.(10), await new Promise((e, t) => {
+		let n = new XMLHttpRequest();
+		n.upload.addEventListener("progress", (e) => {
+			if (e.lengthComputable) {
+				let t = 10 + Math.round(e.loaded / e.total * 80);
+				l?.(t);
+			}
+		}), n.addEventListener("load", () => {
+			n.status >= 200 && n.status < 300 ? (l?.(90), e()) : t(/* @__PURE__ */ Error(`Upload PUT failed with status ${n.status}`));
+		}), n.addEventListener("error", () => t(/* @__PURE__ */ Error("Upload PUT network error"))), n.addEventListener("abort", () => t(/* @__PURE__ */ Error("Upload PUT aborted"))), n.open("PUT", p), n.setRequestHeader("Content-Type", s), n.send(a);
+	});
+	let m = (await i.mutate({
+		mutation: n,
+		variables: { input: {
+			sessionId: f.id,
+			folderId: c
+		} },
+		refetchQueries: r
+	})).data?.completeUpload?.file;
+	if (!m) throw Error("completeUpload did not return a file");
+	return l?.(100), m;
+}
+//#endregion
+export { r as FILES_AFTER_SAVE_REFETCH, i as uploadBlobToFiles };

package/dist/storage/useSaveToFiles.d.ts

@@ -0,0 +1,17 @@
+import { SaveToFilesSource } from './SaveToFilesButton';
+export interface SavedFile {
+    id: string;
+    name: string;
+    folderId: string | null;
+}
+export interface UseSaveToFilesResult {
+    save: (params: {
+        source: SaveToFilesSource;
+        folderPath: string;
+    }) => Promise<SavedFile>;
+    isPending: boolean;
+    error: Error | null;
+    progress: number;
+}
+export declare function useSaveToFiles(): UseSaveToFilesResult;
+//# sourceMappingURL=useSaveToFiles.d.ts.map

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

@@ -0,0 +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,CAgErD"}

package/dist/storage/useSaveToFiles.js

@@ -0,0 +1,73 @@
+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";
+//#region src/storage/useSaveToFiles.ts
+var a = r`
+  mutation SaveToFiles_EnsureFolderByPath($path: String!) {
+    ensureFolderByPath(path: $path) {
+      id
+      name
+      path
+    }
+  }
+`, o = r`
+  mutation SaveToFiles_SaveSandboxArtifact($input: SaveSandboxArtifactInput!) {
+    saveSandboxArtifactToFiles(input: $input) {
+      id
+      name
+      folderId
+    }
+  }
+`;
+function s() {
+	let r = i(), [s, c] = n(!1), [l, u] = n(null), [d, f] = n(0);
+	return {
+		save: async (n) => {
+			c(!0), u(null), f(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,
+						variables: { input: {
+							sandboxId: n.source.sandboxId,
+							sessionId: n.source.sessionId,
+							path: n.source.path,
+							folderId: i,
+							filename: n.source.filename ?? null
+						} },
+						refetchQueries: e
+					})).data?.saveSandboxArtifactToFiles;
+					if (!t) throw Error("saveSandboxArtifactToFiles returned no file");
+					return f(100), t;
+				}
+				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
+				});
+			} catch (e) {
+				let t = e instanceof Error ? e : Error(String(e));
+				throw u(t), t;
+			} finally {
+				c(!1);
+			}
+		},
+		isPending: s,
+		error: l,
+		progress: d
+	};
+}
+//#endregion
+export { s as useSaveToFiles };

package/package.json

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