@burdenoff/microfe-brainyrich 2026.525.1 → 2026.706.1

package/dist/brainyrich/components/reuse/DocumentsPanel.js

@@ -0,0 +1,237 @@
+import { useBrainyRich as e } from "../../providers/BrainyRichProvider.js";
+import { formatDate as t } from "../../pages/_shared.js";
+import { wspaceFetch as n, wspaceMutate as r } from "./transport.js";
+import { useCallback as i, useRef as a, useState as o } from "react";
+import { Download as s, FileText as c, Upload as l } from "lucide-react";
+import { useMutation as u, useQuery as d, useQueryClient as f } from "@tanstack/react-query";
+import { jsx as p, jsxs as m } from "react/jsx-runtime";
+import { Button as h, Card as g, CardContent as _, Skeleton as v } from "@burdenoff/fe-libs/ui";
+//#region src/brainyrich/components/reuse/DocumentsPanel.tsx
+var y = 21600, b = "id name extension mimeType size createdAt", x = (e, t) => `BrainyRich · ${e} · ${t}`, S = (e, t) => [
+	"brainyrich",
+	"entity-folder",
+	e,
+	t
+], C = (e) => [
+	"brainyrich",
+	"folder-files",
+	e ?? "none"
+], w = (t, r) => {
+	let { apiGatewayUrl: i } = e(), a = r ? x(t, r) : "";
+	return d({
+		queryKey: S(t, r ?? ""),
+		enabled: !!r,
+		queryFn: async () => (await n("query BraGetFolders($pagination: PaginationInput) {\n          getFolders(pagination: $pagination) { folders { id name } }\n        }", { pagination: {
+			limit: 200,
+			offset: 0
+		} }, i)).getFolders.folders.find((e) => e.name === a) ?? null
+	});
+}, T = (t) => {
+	let { apiGatewayUrl: r } = e();
+	return d({
+		queryKey: C(t),
+		enabled: !!t,
+		queryFn: async () => (await n(`query BraGetFilesInFolder($folderId: ID, $pagination: PaginationInput) {
+          getFilesInFolder(folderId: $folderId, pagination: $pagination) {
+            files { ${b} }
+          }
+        }`, {
+			folderId: t,
+			pagination: {
+				limit: 100,
+				offset: 0
+			}
+		}, r)).getFilesInFolder.files
+	});
+};
+function E(e, t, n, r) {
+	return new Promise((i, a) => {
+		let o = new XMLHttpRequest();
+		o.open("PUT", e), o.setRequestHeader("Content-Type", n), o.upload.onprogress = (e) => {
+			e.lengthComputable && r(Math.round(e.loaded / e.total * 100));
+		}, o.onload = () => o.status >= 200 && o.status < 300 ? i() : a(/* @__PURE__ */ Error(`File storage rejected the upload (HTTP ${o.status}).`)), o.onerror = () => a(/* @__PURE__ */ Error("Network error while uploading the file.")), o.onabort = () => a(/* @__PURE__ */ Error("The upload was cancelled.")), o.send(t);
+	});
+}
+var D = (t, i) => {
+	let { apiGatewayUrl: a } = e(), s = f(), [c, l] = o(0);
+	return {
+		...u({
+			mutationFn: async (e) => {
+				l(0);
+				let o = await n("query BraResolveFolder($pagination: PaginationInput) {\n          getFolders(pagination: $pagination) { folders { id name } }\n        }", { pagination: {
+					limit: 200,
+					offset: 0
+				} }, a).then((e) => e.getFolders.folders.find((e) => e.name === x(t, i)));
+				o ||= (await r("mutation BraCreateFolder($input: CreateFolderInput!) {\n            createFolder(input: $input) { id name }\n          }", { input: {
+					name: x(t, i),
+					description: `Documents attached to ${t} ${i}.`,
+					visibility: "WORKSPACE"
+				} }, a)).createFolder;
+				let s = o.id, c = e.name.lastIndexOf("."), u = c > -1 ? e.name.slice(c + 1) : "", d = e.type || "application/octet-stream", f = String(e.size), p = await r("mutation BraInitiateUpload($input: InitiateUploadInput!) {\n          initiateUpload(input: $input) { uploadUrl session { id } }\n        }", { input: {
+					fileName: e.name,
+					extension: u,
+					mimeType: d,
+					fileSize: f,
+					folderId: s,
+					visibility: "WORKSPACE"
+				} }, a), { uploadUrl: m } = p.initiateUpload, h = p.initiateUpload.session.id;
+				if (!m) throw Error("The file service did not return an upload URL.");
+				return await E(m, e, d, l), await r("mutation BraCompleteUpload($input: CompleteUploadInput!) {\n          completeUpload(input: $input) { fileId }\n        }", { input: {
+					sessionId: h,
+					fileSize: f,
+					folderId: s
+				} }, a), l(100), s;
+			},
+			onSuccess: (e) => {
+				s.invalidateQueries({ queryKey: S(t, i) }), s.invalidateQueries({ queryKey: C(e) });
+			}
+		}),
+		progress: c
+	};
+}, O = () => {
+	let { apiGatewayUrl: t } = e();
+	return u({ mutationFn: async (e) => (await n("query BraGetFileDownloadUrl($id: ID!, $expiresIn: Int) {\n          getFileDownloadUrl(id: $id, expiresIn: $expiresIn)\n        }", {
+		id: e,
+		expiresIn: y
+	}, t)).getFileDownloadUrl });
+}, k = (e) => {
+	let t = Number(e);
+	return !Number.isFinite(t) || t <= 0 ? "—" : t < 1024 ? `${t} B` : t < 1024 * 1024 ? `${(t / 1024).toFixed(0)} KB` : `${(t / (1024 * 1024)).toFixed(1)} MB`;
+};
+function A({ entityType: e, entityId: n, heading: r = "Documents", hideHeading: o = !1 }) {
+	let u = a(null), d = w(e, n), f = T(d.data?.id), y = D(e, n), b = O(), x = i((e) => {
+		let t = e.target.files?.[0];
+		t && y.mutate(t), e.target.value = "";
+	}, [y]), S = async (e) => {
+		let t = await b.mutateAsync(e);
+		t && window.open(t, "_blank", "noopener,noreferrer");
+	}, C = d.isLoading || !!d.data && f.isLoading, E = f.data ?? [];
+	return /* @__PURE__ */ m("div", {
+		className: "space-y-3",
+		children: [
+			/* @__PURE__ */ m("div", {
+				className: "flex items-center justify-between",
+				children: [!o && /* @__PURE__ */ m("h3", {
+					className: "flex items-center gap-2 text-sm font-semibold text-text-primary",
+					children: [/* @__PURE__ */ p(c, {
+						className: "size-4",
+						"aria-hidden": "true"
+					}), r]
+				}), /* @__PURE__ */ m("div", {
+					className: "ml-auto",
+					children: [/* @__PURE__ */ p("input", {
+						ref: u,
+						type: "file",
+						className: "sr-only",
+						"aria-hidden": "true",
+						tabIndex: -1,
+						onChange: x
+					}), /* @__PURE__ */ m(h, {
+						type: "button",
+						size: "sm",
+						variant: "outline",
+						onClick: () => u.current?.click(),
+						disabled: y.isPending,
+						children: [/* @__PURE__ */ p(l, {
+							className: "size-4",
+							"aria-hidden": "true"
+						}), y.isPending ? `Uploading ${y.progress}%` : "Upload"]
+					})]
+				})]
+			}),
+			y.isPending && /* @__PURE__ */ p("div", {
+				className: "h-1.5 w-full overflow-hidden rounded-full bg-bg-sunken",
+				role: "progressbar",
+				"aria-label": "Upload progress",
+				"aria-valuenow": y.progress,
+				"aria-valuemin": 0,
+				"aria-valuemax": 100,
+				children: /* @__PURE__ */ p("div", {
+					className: "h-full rounded-full bg-primary motion-safe:transition-[width] motion-safe:duration-200",
+					style: { width: `${y.progress}%` }
+				})
+			}),
+			C ? /* @__PURE__ */ m("div", {
+				className: "space-y-2",
+				"aria-busy": "true",
+				children: [/* @__PURE__ */ p(v, { className: "h-12 w-full rounded-md" }), /* @__PURE__ */ p(v, { className: "h-12 w-full rounded-md" })]
+			}) : f.isError ? /* @__PURE__ */ m("p", {
+				className: "text-sm text-status-error-text",
+				children: [
+					"Could not load documents.",
+					" ",
+					/* @__PURE__ */ p("button", {
+						type: "button",
+						className: "underline underline-offset-2",
+						onClick: () => f.refetch(),
+						children: "Retry"
+					})
+				]
+			}) : E.length === 0 ? /* @__PURE__ */ m("div", {
+				className: "rounded-lg border border-dashed border-border-subtle bg-bg-surface px-4 py-8 text-center",
+				children: [
+					/* @__PURE__ */ p(c, {
+						className: "mx-auto mb-2 size-6 text-text-secondary",
+						"aria-hidden": "true"
+					}),
+					/* @__PURE__ */ p("p", {
+						className: "text-sm text-text-primary",
+						children: "No documents yet"
+					}),
+					/* @__PURE__ */ p("p", {
+						className: "mt-0.5 text-xs text-text-secondary",
+						children: "Upload statements, KYC or tax documents for this record."
+					})
+				]
+			}) : /* @__PURE__ */ p("ul", {
+				className: "space-y-2",
+				children: E.map((e) => /* @__PURE__ */ p("li", { children: /* @__PURE__ */ p(g, { children: /* @__PURE__ */ m(_, {
+					className: "flex items-center gap-3 p-3",
+					children: [
+						/* @__PURE__ */ p("div", {
+							className: "flex size-9 shrink-0 items-center justify-center rounded-md bg-bg-sunken text-text-secondary",
+							children: /* @__PURE__ */ p(c, {
+								className: "size-4",
+								"aria-hidden": "true"
+							})
+						}),
+						/* @__PURE__ */ m("div", {
+							className: "min-w-0 flex-1",
+							children: [/* @__PURE__ */ p("p", {
+								className: "truncate text-sm font-medium text-text-primary",
+								children: e.name
+							}), /* @__PURE__ */ m("p", {
+								className: "text-xs text-text-secondary",
+								children: [
+									k(e.size),
+									" · ",
+									t(e.createdAt)
+								]
+							})]
+						}),
+						/* @__PURE__ */ p(h, {
+							type: "button",
+							size: "sm",
+							variant: "ghost",
+							"aria-label": `Download ${e.name}`,
+							disabled: b.isPending,
+							onClick: () => S(e.id),
+							children: /* @__PURE__ */ p(s, {
+								className: "size-4",
+								"aria-hidden": "true"
+							})
+						})
+					]
+				}) }) }, e.id))
+			}),
+			(y.isError || b.isError) && /* @__PURE__ */ p("p", {
+				className: "text-sm text-status-error-text",
+				children: y.error instanceof Error ? y.error.message : b.error instanceof Error ? "Could not open the document. Please try again." : "Something went wrong. Please try again."
+			})
+		]
+	});
+}
+//#endregion
+export { A as DocumentsPanel };
+
+//# sourceMappingURL=DocumentsPanel.js.map

package/dist/brainyrich/components/reuse/DocumentsPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentsPanel.js","names":[],"sources":["../../../../src/brainyrich/components/reuse/DocumentsPanel.tsx"],"sourcesContent":["/**\n * DocumentsPanel — REUSE of `wspace-files-svc` for statement / KYC / tax-doc\n * attachments on Accounts + Households.\n * @module brainyrich/components/reuse/DocumentsPanel\n *\n * A wealth product needs to attach documents (statements, KYC, tax packs) to\n * accounts and households. `wspace-files-svc` has no native entity-owned link on\n * `File`, so we scope documents to an entity via a dedicated, stably-named\n * FOLDER per `(entityType, entityId)` and list its contents. All ops route\n * through the workspace supergraph the MFE already uses.\n *\n * Flow:\n *   - resolve folder → `getFolders(filter)` matched by name (created lazily on\n *     first upload via `createFolder`); no side-effects on read.\n *   - list           → `getFilesInFolder(folderId, pagination)`\n *   - upload (3-step) → `initiateUpload` → S3 `PUT` (byte-progress) → `completeUpload`\n *   - download        → `getFileDownloadUrl(id, expiresIn)` capped at 21600s to\n *     avoid the >604800 fleet bug (S3 7-day cap → 500).\n *\n * Presentational + self-contained: owns its hooks, reads the gateway base URL\n * from `useBrainyRich()`, uses fe-libs/ui primitives + semantic tokens.\n */\n\nimport { useCallback, useRef, useState } from 'react';\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';\nimport { Download, FileText, Upload } from 'lucide-react';\nimport { Button, Card, CardContent, Skeleton } from '@burdenoff/fe-libs/ui';\n\nimport { useBrainyRich } from '../../providers/BrainyRichProvider';\nimport { formatDate } from '../../pages/_shared';\nimport { wspaceFetch, wspaceMutate } from './transport';\n\n// Presigned-URL TTL: cap at 21600s (6h). >604800 (S3 7-day) → INTERNAL_SERVER_ERROR.\nconst DOWNLOAD_URL_TTL_SECONDS = 21600;\n\ninterface FilesFolder {\n  id: string;\n  name: string;\n}\n\ninterface FilesFile {\n  id: string;\n  name: string;\n  extension: string;\n  mimeType: string;\n  size: string;\n  createdAt: string;\n}\n\nconst FILE_FIELDS = 'id name extension mimeType size createdAt';\n\nconst folderName = (entityType: string, entityId: string) =>\n  `BrainyRich · ${entityType} · ${entityId}`;\n\nconst folderKey = (entityType: string, entityId: string) =>\n  ['brainyrich', 'entity-folder', entityType, entityId] as const;\n\nconst filesKey = (folderId: string | null | undefined) =>\n  ['brainyrich', 'folder-files', folderId ?? 'none'] as const;\n\n// ============================================================================\n// Folder resolution (read-only — no lazy creation here)\n// ============================================================================\n\nconst useEntityFolder = (entityType: string, entityId: string | undefined) => {\n  const { apiGatewayUrl } = useBrainyRich();\n  const wanted = entityId ? folderName(entityType, entityId) : '';\n  return useQuery({\n    queryKey: folderKey(entityType, entityId ?? ''),\n    enabled: Boolean(entityId),\n    queryFn: async () => {\n      const data = await wspaceFetch<{ getFolders: { folders: FilesFolder[] } }>(\n        `query BraGetFolders($pagination: PaginationInput) {\n          getFolders(pagination: $pagination) { folders { id name } }\n        }`,\n        { pagination: { limit: 200, offset: 0 } },\n        apiGatewayUrl\n      );\n      return data.getFolders.folders.find((f) => f.name === wanted) ?? null;\n    },\n  });\n};\n\nconst useFolderFiles = (folderId: string | null | undefined) => {\n  const { apiGatewayUrl } = useBrainyRich();\n  return useQuery({\n    queryKey: filesKey(folderId),\n    enabled: Boolean(folderId),\n    queryFn: async () => {\n      const data = await wspaceFetch<{ getFilesInFolder: { files: FilesFile[] } }>(\n        `query BraGetFilesInFolder($folderId: ID, $pagination: PaginationInput) {\n          getFilesInFolder(folderId: $folderId, pagination: $pagination) {\n            files { ${FILE_FIELDS} }\n          }\n        }`,\n        { folderId, pagination: { limit: 100, offset: 0 } },\n        apiGatewayUrl\n      );\n      return data.getFilesInFolder.files;\n    },\n  });\n};\n\n// ============================================================================\n// Upload (3-step platform flow, with lazy folder creation)\n// ============================================================================\n\nfunction putWithProgress(\n  url: string,\n  file: File,\n  contentType: string,\n  onProgress: (percent: number) => void\n): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const xhr = new XMLHttpRequest();\n    xhr.open('PUT', url);\n    xhr.setRequestHeader('Content-Type', contentType);\n    xhr.upload.onprogress = (event) => {\n      if (event.lengthComputable) {\n        onProgress(Math.round((event.loaded / event.total) * 100));\n      }\n    };\n    xhr.onload = () =>\n      xhr.status >= 200 && xhr.status < 300\n        ? resolve()\n        : reject(new Error(`File storage rejected the upload (HTTP ${xhr.status}).`));\n    xhr.onerror = () => reject(new Error('Network error while uploading the file.'));\n    xhr.onabort = () => reject(new Error('The upload was cancelled.'));\n    xhr.send(file);\n  });\n}\n\nconst useDocumentUpload = (entityType: string, entityId: string) => {\n  const { apiGatewayUrl } = useBrainyRich();\n  const qc = useQueryClient();\n  const [progress, setProgress] = useState(0);\n\n  const mutation = useMutation({\n    mutationFn: async (file: File) => {\n      setProgress(0);\n\n      // 0. resolve or create the entity folder\n      let folder = await wspaceFetch<{ getFolders: { folders: FilesFolder[] } }>(\n        `query BraResolveFolder($pagination: PaginationInput) {\n          getFolders(pagination: $pagination) { folders { id name } }\n        }`,\n        { pagination: { limit: 200, offset: 0 } },\n        apiGatewayUrl\n      ).then((d) => d.getFolders.folders.find((f) => f.name === folderName(entityType, entityId)));\n\n      if (!folder) {\n        const created = await wspaceMutate<{ createFolder: FilesFolder }>(\n          `mutation BraCreateFolder($input: CreateFolderInput!) {\n            createFolder(input: $input) { id name }\n          }`,\n          {\n            input: {\n              name: folderName(entityType, entityId),\n              description: `Documents attached to ${entityType} ${entityId}.`,\n              visibility: 'WORKSPACE',\n            },\n          },\n          apiGatewayUrl\n        );\n        folder = created.createFolder;\n      }\n      const folderId = folder.id;\n\n      const dotIndex = file.name.lastIndexOf('.');\n      const extension = dotIndex > -1 ? file.name.slice(dotIndex + 1) : '';\n      const mimeType = file.type || 'application/octet-stream';\n      const fileSize = String(file.size);\n\n      // 1. initiate\n      const initiated = await wspaceMutate<{\n        initiateUpload: { uploadUrl: string | null; session: { id: string } };\n      }>(\n        `mutation BraInitiateUpload($input: InitiateUploadInput!) {\n          initiateUpload(input: $input) { uploadUrl session { id } }\n        }`,\n        {\n          input: { fileName: file.name, extension, mimeType, fileSize, folderId, visibility: 'WORKSPACE' },\n        },\n        apiGatewayUrl\n      );\n      const { uploadUrl } = initiated.initiateUpload;\n      const sessionId = initiated.initiateUpload.session.id;\n      if (!uploadUrl) throw new Error('The file service did not return an upload URL.');\n\n      // 2. PUT the bytes\n      await putWithProgress(uploadUrl, file, mimeType, setProgress);\n\n      // 3. complete\n      await wspaceMutate<{ completeUpload: { fileId: string } }>(\n        `mutation BraCompleteUpload($input: CompleteUploadInput!) {\n          completeUpload(input: $input) { fileId }\n        }`,\n        { input: { sessionId, fileSize, folderId } },\n        apiGatewayUrl\n      );\n      setProgress(100);\n      return folderId;\n    },\n    onSuccess: (folderId) => {\n      qc.invalidateQueries({ queryKey: folderKey(entityType, entityId) });\n      qc.invalidateQueries({ queryKey: filesKey(folderId) });\n    },\n  });\n\n  return { ...mutation, progress };\n};\n\nconst useDownloadFile = () => {\n  const { apiGatewayUrl } = useBrainyRich();\n  return useMutation({\n    mutationFn: async (id: string) => {\n      const data = await wspaceFetch<{ getFileDownloadUrl: string }>(\n        `query BraGetFileDownloadUrl($id: ID!, $expiresIn: Int) {\n          getFileDownloadUrl(id: $id, expiresIn: $expiresIn)\n        }`,\n        { id, expiresIn: DOWNLOAD_URL_TTL_SECONDS },\n        apiGatewayUrl\n      );\n      return data.getFileDownloadUrl;\n    },\n  });\n};\n\n// ============================================================================\n// Component\n// ============================================================================\n\nconst formatSize = (bytes: string): string => {\n  const n = Number(bytes);\n  if (!Number.isFinite(n) || n <= 0) return '—';\n  if (n < 1024) return `${n} B`;\n  if (n < 1024 * 1024) return `${(n / 1024).toFixed(0)} KB`;\n  return `${(n / (1024 * 1024)).toFixed(1)} MB`;\n};\n\nexport interface DocumentsPanelProps {\n  /** Polymorphic entity type, e.g. \"brainyrich-account\" | \"brainyrich-household\". */\n  entityType: string;\n  /** The bra entity's id (an ID scalar). */\n  entityId: string;\n  /** Optional heading; hide with `hideHeading`. */\n  heading?: string;\n  hideHeading?: boolean;\n}\n\nexport function DocumentsPanel({\n  entityType,\n  entityId,\n  heading = 'Documents',\n  hideHeading = false,\n}: DocumentsPanelProps) {\n  const inputRef = useRef<HTMLInputElement>(null);\n  const folder = useEntityFolder(entityType, entityId);\n  const files = useFolderFiles(folder.data?.id);\n  const upload = useDocumentUpload(entityType, entityId);\n  const download = useDownloadFile();\n\n  const onPick = useCallback(\n    (e: React.ChangeEvent<HTMLInputElement>) => {\n      const file = e.target.files?.[0];\n      if (file) upload.mutate(file);\n      e.target.value = '';\n    },\n    [upload]\n  );\n\n  const onDownload = async (id: string) => {\n    const url = await download.mutateAsync(id);\n    if (url) window.open(url, '_blank', 'noopener,noreferrer');\n  };\n\n  const loading = folder.isLoading || (Boolean(folder.data) && files.isLoading);\n  const list = files.data ?? [];\n\n  return (\n    <div className=\"space-y-3\">\n      <div className=\"flex items-center justify-between\">\n        {!hideHeading && (\n          <h3 className=\"flex items-center gap-2 text-sm font-semibold text-text-primary\">\n            <FileText className=\"size-4\" aria-hidden=\"true\" />\n            {heading}\n          </h3>\n        )}\n        <div className=\"ml-auto\">\n          <input\n            ref={inputRef}\n            type=\"file\"\n            className=\"sr-only\"\n            aria-hidden=\"true\"\n            tabIndex={-1}\n            onChange={onPick}\n          />\n          <Button\n            type=\"button\"\n            size=\"sm\"\n            variant=\"outline\"\n            onClick={() => inputRef.current?.click()}\n            disabled={upload.isPending}\n          >\n            <Upload className=\"size-4\" aria-hidden=\"true\" />\n            {upload.isPending ? `Uploading ${upload.progress}%` : 'Upload'}\n          </Button>\n        </div>\n      </div>\n\n      {upload.isPending && (\n        <div\n          className=\"h-1.5 w-full overflow-hidden rounded-full bg-bg-sunken\"\n          role=\"progressbar\"\n          aria-label=\"Upload progress\"\n          aria-valuenow={upload.progress}\n          aria-valuemin={0}\n          aria-valuemax={100}\n        >\n          <div\n            className=\"h-full rounded-full bg-primary motion-safe:transition-[width] motion-safe:duration-200\"\n            style={{ width: `${upload.progress}%` }}\n          />\n        </div>\n      )}\n\n      {loading ? (\n        <div className=\"space-y-2\" aria-busy=\"true\">\n          <Skeleton className=\"h-12 w-full rounded-md\" />\n          <Skeleton className=\"h-12 w-full rounded-md\" />\n        </div>\n      ) : files.isError ? (\n        <p className=\"text-sm text-status-error-text\">\n          Could not load documents.{' '}\n          <button\n            type=\"button\"\n            className=\"underline underline-offset-2\"\n            onClick={() => files.refetch()}\n          >\n            Retry\n          </button>\n        </p>\n      ) : list.length === 0 ? (\n        <div className=\"rounded-lg border border-dashed border-border-subtle bg-bg-surface px-4 py-8 text-center\">\n          <FileText className=\"mx-auto mb-2 size-6 text-text-secondary\" aria-hidden=\"true\" />\n          <p className=\"text-sm text-text-primary\">No documents yet</p>\n          <p className=\"mt-0.5 text-xs text-text-secondary\">\n            Upload statements, KYC or tax documents for this record.\n          </p>\n        </div>\n      ) : (\n        <ul className=\"space-y-2\">\n          {list.map((file) => (\n            <li key={file.id}>\n              <Card>\n                <CardContent className=\"flex items-center gap-3 p-3\">\n                  <div className=\"flex size-9 shrink-0 items-center justify-center rounded-md bg-bg-sunken text-text-secondary\">\n                    <FileText className=\"size-4\" aria-hidden=\"true\" />\n                  </div>\n                  <div className=\"min-w-0 flex-1\">\n                    <p className=\"truncate text-sm font-medium text-text-primary\">{file.name}</p>\n                    <p className=\"text-xs text-text-secondary\">\n                      {formatSize(file.size)} · {formatDate(file.createdAt)}\n                    </p>\n                  </div>\n                  <Button\n                    type=\"button\"\n                    size=\"sm\"\n                    variant=\"ghost\"\n                    aria-label={`Download ${file.name}`}\n                    disabled={download.isPending}\n                    onClick={() => onDownload(file.id)}\n                  >\n                    <Download className=\"size-4\" aria-hidden=\"true\" />\n                  </Button>\n                </CardContent>\n              </Card>\n            </li>\n          ))}\n        </ul>\n      )}\n\n      {(upload.isError || download.isError) && (\n        <p className=\"text-sm text-status-error-text\">\n          {upload.error instanceof Error\n            ? upload.error.message\n            : download.error instanceof Error\n              ? 'Could not open the document. Please try again.'\n              : 'Something went wrong. Please try again.'}\n        </p>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/brainyrich/components/reuse/TagField.js

@@ -0,0 +1,206 @@
+import { useBrainyRich as e } from "../../providers/BrainyRichProvider.js";
+import { wspaceFetch as t, wspaceMutate as n } from "./transport.js";
+import { useState as r } from "react";
+import { Plus as i, Tag as a, X as o } from "lucide-react";
+import { useMutation as s, useQuery as c, useQueryClient as l } from "@tanstack/react-query";
+import { jsx as u, jsxs as d } from "react/jsx-runtime";
+import { Badge as f, Button as p, Input as m, Label as h, Skeleton as g } from "@burdenoff/fe-libs/ui";
+//#region src/brainyrich/components/reuse/TagField.tsx
+var _ = "id label color key", v = "brainyrich", y = (e, t) => [
+	"brainyrich",
+	"entity-tags",
+	e,
+	t
+], b = (e) => e.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48) || "tag", x = (n, r) => {
+	let { apiGatewayUrl: i } = e();
+	return c({
+		queryKey: y(n, r ?? ""),
+		enabled: !!r,
+		queryFn: async () => (await t(`query BraGetEntityTags($entityType: String!, $entityId: ID!) {
+          getEntityTags(entityType: $entityType, entityId: $entityId) {
+            id
+            tag { ${_} }
+          }
+        }`, {
+			entityType: n,
+			entityId: r
+		}, i)).getEntityTags
+	});
+}, S = (n) => {
+	let { apiGatewayUrl: r } = e(), i = n.trim();
+	return c({
+		queryKey: [
+			"brainyrich",
+			"tag-search",
+			i
+		],
+		enabled: i.length > 0,
+		queryFn: async () => (await t(`query BraSearchTags($query: String!, $limit: Int) {
+          searchTags(query: $query, limit: $limit) { ${_} }
+        }`, {
+			query: i,
+			limit: 8
+		}, r)).searchTags
+	});
+}, C = async (e) => {
+	let r = await t("query BraGetVocabulary($key: String!) {\n      getVocabularyByKey(key: $key) { id }\n    }", { key: v }, e);
+	return r.getVocabularyByKey?.id ? r.getVocabularyByKey.id : (await n("mutation BraCreateVocabulary($input: CreateVocabularyInput!) {\n      createVocabulary(input: $input) { id }\n    }", { input: {
+		key: v,
+		name: "BrainyRich",
+		description: "Tags for BrainyRich households, portfolios and goals.",
+		allowCustomTags: !0
+	} }, e)).createVocabulary.id;
+}, w = (t, r) => {
+	let { apiGatewayUrl: i } = e(), a = l();
+	return s({
+		mutationFn: async (e) => (await n("mutation BraAssignTag($input: AssignTagInput!) {\n          assignTag(input: $input) { id }\n        }", { input: {
+			entityType: t,
+			entityId: r,
+			tagId: e
+		} }, i)).assignTag,
+		onSuccess: () => a.invalidateQueries({ queryKey: y(t, r) })
+	});
+}, T = (t, r) => {
+	let { apiGatewayUrl: i } = e(), a = l();
+	return s({
+		mutationFn: async (e) => {
+			let a = e.trim();
+			if (!a) throw Error("A tag label is required.");
+			let o = await n("mutation BraCreateTag($input: CreateTagInput!) {\n          createTag(input: $input) { id }\n        }", { input: {
+				vocabularyId: await C(i),
+				key: `${b(a)}-${Math.random().toString(36).slice(2, 6)}`,
+				label: a
+			} }, i);
+			return await n("mutation BraAssignCreatedTag($input: AssignTagInput!) {\n          assignTag(input: $input) { id }\n        }", { input: {
+				entityType: t,
+				entityId: r,
+				tagId: o.createTag.id
+			} }, i), o.createTag;
+		},
+		onSuccess: () => a.invalidateQueries({ queryKey: y(t, r) })
+	});
+}, E = (t, r) => {
+	let { apiGatewayUrl: i } = e(), a = l();
+	return s({
+		mutationFn: async (e) => (await n("mutation BraRemoveTagAssignment($id: ID!) { removeTagAssignment(id: $id) }", { id: e }, i)).removeTagAssignment,
+		onSuccess: () => a.invalidateQueries({ queryKey: y(t, r) })
+	});
+};
+function D({ entityType: e, entityId: t, label: n = "Tags", hideLabel: s = !1 }) {
+	let [c, l] = r(""), _ = x(e, t), v = S(c), y = w(e, t), b = T(e, t), C = E(e, t), D = y.isPending || b.isPending, O = _.data ?? [], k = new Set(O.map((e) => e.tag.id)), A = (v.data ?? []).filter((e) => !k.has(e.id)), j = c.trim(), M = A.some((e) => e.label.toLowerCase() === j.toLowerCase()), N = `tagfield-${e}-${t}`, P = async () => {
+		!j || D || (await b.mutateAsync(j), l(""));
+	}, F = async (e) => {
+		D || (await y.mutateAsync(e), l(""));
+	};
+	return /* @__PURE__ */ d("div", {
+		className: "space-y-2",
+		children: [
+			!s && /* @__PURE__ */ u(h, {
+				htmlFor: N,
+				className: "text-text-primary",
+				children: n
+			}),
+			_.isLoading ? /* @__PURE__ */ d("div", {
+				className: "flex flex-wrap gap-2",
+				"aria-busy": "true",
+				children: [
+					/* @__PURE__ */ u(g, { className: "h-6 w-16 rounded-full" }),
+					/* @__PURE__ */ u(g, { className: "h-6 w-20 rounded-full" }),
+					/* @__PURE__ */ u(g, { className: "h-6 w-12 rounded-full" })
+				]
+			}) : _.isError ? /* @__PURE__ */ d("p", {
+				className: "text-sm text-status-error-text",
+				children: [
+					"Could not load tags.",
+					" ",
+					/* @__PURE__ */ u("button", {
+						type: "button",
+						className: "underline underline-offset-2",
+						onClick: () => _.refetch(),
+						children: "Retry"
+					})
+				]
+			}) : O.length === 0 ? /* @__PURE__ */ d("p", {
+				className: "flex items-center gap-1.5 text-sm text-text-secondary",
+				children: [/* @__PURE__ */ u(a, {
+					className: "size-3.5",
+					"aria-hidden": "true"
+				}), "No tags yet — add one below."]
+			}) : /* @__PURE__ */ u("div", {
+				className: "flex flex-wrap gap-2",
+				children: O.map((e) => /* @__PURE__ */ d(f, {
+					variant: "secondary",
+					className: "gap-1 pr-1",
+					children: [/* @__PURE__ */ u("span", { children: e.tag.label }), /* @__PURE__ */ u("button", {
+						type: "button",
+						"aria-label": `Remove tag ${e.tag.label}`,
+						className: "rounded-full p-0.5 text-text-secondary hover:bg-bg-sunken hover:text-text-primary focus-visible:outline focus-visible:outline-2 focus-visible:outline-border-focus disabled:opacity-50",
+						disabled: C.isPending,
+						onClick: () => C.mutate(e.id),
+						children: /* @__PURE__ */ u(o, {
+							className: "size-3",
+							"aria-hidden": "true"
+						})
+					})]
+				}, e.id))
+			}),
+			/* @__PURE__ */ d("div", {
+				className: "relative",
+				children: [/* @__PURE__ */ d("div", {
+					className: "flex gap-2",
+					children: [/* @__PURE__ */ u(m, {
+						id: N,
+						value: c,
+						onChange: (e) => l(e.target.value),
+						onKeyDown: (e) => {
+							e.key === "Enter" && (e.preventDefault(), P());
+						},
+						placeholder: "Search or create a tag…",
+						"aria-label": "Search or create a tag",
+						autoComplete: "off",
+						disabled: D
+					}), /* @__PURE__ */ d(p, {
+						type: "button",
+						variant: "outline",
+						size: "sm",
+						onClick: P,
+						disabled: !j || D || M,
+						children: [/* @__PURE__ */ u(i, {
+							className: "size-4",
+							"aria-hidden": "true"
+						}), "Create"]
+					})]
+				}), j.length > 0 && (A.length > 0 || v.isFetching) && /* @__PURE__ */ u("ul", {
+					className: "absolute z-10 mt-1 w-full overflow-hidden rounded-md border border-border-subtle bg-bg-surface shadow-md",
+					role: "listbox",
+					"aria-label": "Tag suggestions",
+					children: v.isFetching && A.length === 0 ? /* @__PURE__ */ u("li", {
+						className: "px-3 py-2 text-sm text-text-secondary",
+						children: "Searching…"
+					}) : A.map((e) => /* @__PURE__ */ u("li", {
+						role: "option",
+						"aria-selected": "false",
+						children: /* @__PURE__ */ d("button", {
+							type: "button",
+							className: "flex w-full items-center gap-2 px-3 py-2 text-left text-sm text-text-primary hover:bg-bg-sunken focus-visible:bg-bg-sunken focus-visible:outline-none disabled:opacity-50",
+							disabled: D,
+							onClick: () => F(e.id),
+							children: [/* @__PURE__ */ u(a, {
+								className: "size-3.5 text-text-secondary",
+								"aria-hidden": "true"
+							}), e.label]
+						})
+					}, e.id))
+				})]
+			}),
+			(y.isError || b.isError || C.isError) && /* @__PURE__ */ u("p", {
+				className: "text-sm text-status-error-text",
+				children: "Could not update tags. Please try again."
+			})
+		]
+	});
+}
+//#endregion
+export { D as TagField };
+
+//# sourceMappingURL=TagField.js.map

package/dist/brainyrich/components/reuse/TagField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TagField.js","names":[],"sources":["../../../../src/brainyrich/components/reuse/TagField.tsx"],"sourcesContent":["/**\n * TagField — REUSE of `wspace-tags-svc` UniversalTag (polymorphic-by-entity).\n * @module brainyrich/components/reuse/TagField\n *\n * Drop-in replacement for the free-text tag string inputs on Households /\n * Portfolios / Goals. Instead of writing a `tags` scalar on the bra entity,\n * this manages REAL `UniversalTag` assignments keyed by `(entityType, entityId)`\n * against the platform tag store — no bra-svc change required. The bra `tags`\n * scalar stays as legacy; this component is the canonical tag surface.\n *\n * Ops (all on the workspace supergraph):\n *   - `getEntityTags(entityType, entityId)`  → current assignments (chips)\n *   - `searchTags(query, limit)`             → typeahead over existing tags\n *   - `assignTag(input)`                     → link an existing tag\n *   - `createTag(input)` + `assignTag(...)`  → create-from-label then link\n *   - `removeTagAssignment(id)`              → unlink a chip\n *\n * `createTag` needs a `vocabularyId`; we resolve a stable, workspace-scoped\n * \"brainyrich\" vocabulary via `getVocabularyByKey` (creating it on first use).\n *\n * Presentational + self-contained: owns its react-query hooks, reads the gateway\n * base URL from `useBrainyRich()`, uses fe-libs/ui primitives + semantic tokens.\n */\n\nimport { useState, type KeyboardEvent } from 'react';\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';\nimport { Plus, Tag as TagIcon, X } from 'lucide-react';\nimport { Badge, Button, Input, Label, Skeleton } from '@burdenoff/fe-libs/ui';\n\nimport { useBrainyRich } from '../../providers/BrainyRichProvider';\nimport { wspaceFetch, wspaceMutate } from './transport';\n\n// ============================================================================\n// Types (mirror the UniversalTag SDL fields we select)\n// ============================================================================\n\ninterface UniversalTag {\n  id: string;\n  label: string;\n  color: string | null;\n  key: string;\n}\n\ninterface UniversalTagAssignment {\n  id: string;\n  tag: UniversalTag;\n}\n\nconst TAG_FIELDS = 'id label color key';\nconst BRAINYRICH_VOCABULARY_KEY = 'brainyrich';\n\nconst entityTagsKey = (entityType: string, entityId: string) =>\n  ['brainyrich', 'entity-tags', entityType, entityId] as const;\n\nconst slugify = (value: string): string =>\n  value\n    .toLowerCase()\n    .trim()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, 48) || 'tag';\n\n// ============================================================================\n// Hooks (co-located; reuse the shared workspace transport)\n// ============================================================================\n\nconst useEntityTags = (entityType: string, entityId: string | undefined) => {\n  const { apiGatewayUrl } = useBrainyRich();\n  return useQuery({\n    queryKey: entityTagsKey(entityType, entityId ?? ''),\n    enabled: Boolean(entityId),\n    queryFn: async () => {\n      const data = await wspaceFetch<{ getEntityTags: UniversalTagAssignment[] }>(\n        `query BraGetEntityTags($entityType: String!, $entityId: ID!) {\n          getEntityTags(entityType: $entityType, entityId: $entityId) {\n            id\n            tag { ${TAG_FIELDS} }\n          }\n        }`,\n        { entityType, entityId },\n        apiGatewayUrl\n      );\n      return data.getEntityTags;\n    },\n  });\n};\n\nconst useTagSearch = (query: string) => {\n  const { apiGatewayUrl } = useBrainyRich();\n  const trimmed = query.trim();\n  return useQuery({\n    queryKey: ['brainyrich', 'tag-search', trimmed],\n    enabled: trimmed.length > 0,\n    queryFn: async () => {\n      const data = await wspaceFetch<{ searchTags: UniversalTag[] }>(\n        `query BraSearchTags($query: String!, $limit: Int) {\n          searchTags(query: $query, limit: $limit) { ${TAG_FIELDS} }\n        }`,\n        { query: trimmed, limit: 8 },\n        apiGatewayUrl\n      );\n      return data.searchTags;\n    },\n  });\n};\n\n/** Resolve (creating on first use) the workspace-scoped \"brainyrich\" vocabulary. */\nconst resolveVocabularyId = async (baseUrl?: string): Promise<string> => {\n  const existing = await wspaceFetch<{ getVocabularyByKey: { id: string } | null }>(\n    `query BraGetVocabulary($key: String!) {\n      getVocabularyByKey(key: $key) { id }\n    }`,\n    { key: BRAINYRICH_VOCABULARY_KEY },\n    baseUrl\n  );\n  if (existing.getVocabularyByKey?.id) return existing.getVocabularyByKey.id;\n\n  const created = await wspaceMutate<{ createVocabulary: { id: string } }>(\n    `mutation BraCreateVocabulary($input: CreateVocabularyInput!) {\n      createVocabulary(input: $input) { id }\n    }`,\n    {\n      input: {\n        key: BRAINYRICH_VOCABULARY_KEY,\n        name: 'BrainyRich',\n        description: 'Tags for BrainyRich households, portfolios and goals.',\n        allowCustomTags: true,\n      },\n    },\n    baseUrl\n  );\n  return created.createVocabulary.id;\n};\n\nconst useAssignTag = (entityType: string, entityId: string) => {\n  const { apiGatewayUrl } = useBrainyRich();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (tagId: string) => {\n      const data = await wspaceMutate<{ assignTag: { id: string } }>(\n        `mutation BraAssignTag($input: AssignTagInput!) {\n          assignTag(input: $input) { id }\n        }`,\n        { input: { entityType, entityId, tagId } },\n        apiGatewayUrl\n      );\n      return data.assignTag;\n    },\n    onSuccess: () => qc.invalidateQueries({ queryKey: entityTagsKey(entityType, entityId) }),\n  });\n};\n\nconst useCreateAndAssignTag = (entityType: string, entityId: string) => {\n  const { apiGatewayUrl } = useBrainyRich();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (label: string) => {\n      const trimmed = label.trim();\n      if (!trimmed) throw new Error('A tag label is required.');\n      const vocabularyId = await resolveVocabularyId(apiGatewayUrl);\n      // Unique key avoids collisions inside the vocabulary; the label is the display text.\n      const key = `${slugify(trimmed)}-${Math.random().toString(36).slice(2, 6)}`;\n      const created = await wspaceMutate<{ createTag: { id: string } }>(\n        `mutation BraCreateTag($input: CreateTagInput!) {\n          createTag(input: $input) { id }\n        }`,\n        { input: { vocabularyId, key, label: trimmed } },\n        apiGatewayUrl\n      );\n      await wspaceMutate<{ assignTag: { id: string } }>(\n        `mutation BraAssignCreatedTag($input: AssignTagInput!) {\n          assignTag(input: $input) { id }\n        }`,\n        { input: { entityType, entityId, tagId: created.createTag.id } },\n        apiGatewayUrl\n      );\n      return created.createTag;\n    },\n    onSuccess: () => qc.invalidateQueries({ queryKey: entityTagsKey(entityType, entityId) }),\n  });\n};\n\nconst useRemoveTagAssignment = (entityType: string, entityId: string) => {\n  const { apiGatewayUrl } = useBrainyRich();\n  const qc = useQueryClient();\n  return useMutation({\n    mutationFn: async (assignmentId: string) => {\n      const data = await wspaceMutate<{ removeTagAssignment: boolean }>(\n        `mutation BraRemoveTagAssignment($id: ID!) { removeTagAssignment(id: $id) }`,\n        { id: assignmentId },\n        apiGatewayUrl\n      );\n      return data.removeTagAssignment;\n    },\n    onSuccess: () => qc.invalidateQueries({ queryKey: entityTagsKey(entityType, entityId) }),\n  });\n};\n\n// ============================================================================\n// Component\n// ============================================================================\n\nexport interface TagFieldProps {\n  /** Polymorphic entity type, e.g. \"brainyrich-household\". */\n  entityType: string;\n  /** The bra entity's id (an ID scalar). */\n  entityId: string;\n  /** Optional field label (hidden visually when `hideLabel`). */\n  label?: string;\n  hideLabel?: boolean;\n}\n\nexport function TagField({\n  entityType,\n  entityId,\n  label = 'Tags',\n  hideLabel = false,\n}: TagFieldProps) {\n  const [draft, setDraft] = useState('');\n  const assignments = useEntityTags(entityType, entityId);\n  const search = useTagSearch(draft);\n  const assign = useAssignTag(entityType, entityId);\n  const createAndAssign = useCreateAndAssignTag(entityType, entityId);\n  const remove = useRemoveTagAssignment(entityType, entityId);\n\n  const busy = assign.isPending || createAndAssign.isPending;\n  const assigned = assignments.data ?? [];\n  const assignedTagIds = new Set(assigned.map((a) => a.tag.id));\n  const suggestions = (search.data ?? []).filter((t) => !assignedTagIds.has(t.id));\n  const trimmed = draft.trim();\n  const exactExists = suggestions.some((t) => t.label.toLowerCase() === trimmed.toLowerCase());\n\n  const inputId = `tagfield-${entityType}-${entityId}`;\n\n  const commitCreate = async () => {\n    if (!trimmed || busy) return;\n    await createAndAssign.mutateAsync(trimmed);\n    setDraft('');\n  };\n\n  const commitAssign = async (tagId: string) => {\n    if (busy) return;\n    await assign.mutateAsync(tagId);\n    setDraft('');\n  };\n\n  const onKeyDown = (event: KeyboardEvent<HTMLInputElement>) => {\n    if (event.key === 'Enter') {\n      event.preventDefault();\n      void commitCreate();\n    }\n  };\n\n  return (\n    <div className=\"space-y-2\">\n      {!hideLabel && (\n        <Label htmlFor={inputId} className=\"text-text-primary\">\n          {label}\n        </Label>\n      )}\n\n      {/* Current assignments */}\n      {assignments.isLoading ? (\n        <div className=\"flex flex-wrap gap-2\" aria-busy=\"true\">\n          <Skeleton className=\"h-6 w-16 rounded-full\" />\n          <Skeleton className=\"h-6 w-20 rounded-full\" />\n          <Skeleton className=\"h-6 w-12 rounded-full\" />\n        </div>\n      ) : assignments.isError ? (\n        <p className=\"text-sm text-status-error-text\">\n          Could not load tags.{' '}\n          <button\n            type=\"button\"\n            className=\"underline underline-offset-2\"\n            onClick={() => assignments.refetch()}\n          >\n            Retry\n          </button>\n        </p>\n      ) : assigned.length === 0 ? (\n        <p className=\"flex items-center gap-1.5 text-sm text-text-secondary\">\n          <TagIcon className=\"size-3.5\" aria-hidden=\"true\" />\n          No tags yet — add one below.\n        </p>\n      ) : (\n        <div className=\"flex flex-wrap gap-2\">\n          {assigned.map((a) => (\n            <Badge key={a.id} variant=\"secondary\" className=\"gap-1 pr-1\">\n              <span>{a.tag.label}</span>\n              <button\n                type=\"button\"\n                aria-label={`Remove tag ${a.tag.label}`}\n                className=\"rounded-full p-0.5 text-text-secondary hover:bg-bg-sunken hover:text-text-primary focus-visible:outline focus-visible:outline-2 focus-visible:outline-border-focus disabled:opacity-50\"\n                disabled={remove.isPending}\n                onClick={() => remove.mutate(a.id)}\n              >\n                <X className=\"size-3\" aria-hidden=\"true\" />\n              </button>\n            </Badge>\n          ))}\n        </div>\n      )}\n\n      {/* Add control */}\n      <div className=\"relative\">\n        <div className=\"flex gap-2\">\n          <Input\n            id={inputId}\n            value={draft}\n            onChange={(e) => setDraft(e.target.value)}\n            onKeyDown={onKeyDown}\n            placeholder=\"Search or create a tag…\"\n            aria-label=\"Search or create a tag\"\n            autoComplete=\"off\"\n            disabled={busy}\n          />\n          <Button\n            type=\"button\"\n            variant=\"outline\"\n            size=\"sm\"\n            onClick={commitCreate}\n            disabled={!trimmed || busy || exactExists}\n          >\n            <Plus className=\"size-4\" aria-hidden=\"true\" />\n            Create\n          </Button>\n        </div>\n\n        {/* Typeahead suggestions */}\n        {trimmed.length > 0 && (suggestions.length > 0 || search.isFetching) && (\n          <ul\n            className=\"absolute z-10 mt-1 w-full overflow-hidden rounded-md border border-border-subtle bg-bg-surface shadow-md\"\n            role=\"listbox\"\n            aria-label=\"Tag suggestions\"\n          >\n            {search.isFetching && suggestions.length === 0 ? (\n              <li className=\"px-3 py-2 text-sm text-text-secondary\">Searching…</li>\n            ) : (\n              suggestions.map((t) => (\n                <li key={t.id} role=\"option\" aria-selected=\"false\">\n                  <button\n                    type=\"button\"\n                    className=\"flex w-full items-center gap-2 px-3 py-2 text-left text-sm text-text-primary hover:bg-bg-sunken focus-visible:bg-bg-sunken focus-visible:outline-none disabled:opacity-50\"\n                    disabled={busy}\n                    onClick={() => commitAssign(t.id)}\n                  >\n                    <TagIcon className=\"size-3.5 text-text-secondary\" aria-hidden=\"true\" />\n                    {t.label}\n                  </button>\n                </li>\n              ))\n            )}\n          </ul>\n        )}\n      </div>\n\n      {(assign.isError || createAndAssign.isError || remove.isError) && (\n        <p className=\"text-sm text-status-error-text\">\n          Could not update tags. Please try again.\n        </p>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/brainyrich/components/reuse/transport.js

@@ -0,0 +1,24 @@
+import { graphqlFetch as e } from "@burdenoff/fe-libs/shared/graphql";
+//#region src/brainyrich/components/reuse/transport.ts
+var t = () => {
+	let e = globalThis;
+	e.__graphqlFetchResponseCache?.clear(), e.__graphqlFetchPendingResponses?.clear(), e.__boffGraphQLResponseCache?.clear();
+}, n = async (t, n, r) => {
+	let i = await e({
+		gateway: "workspace",
+		baseUrl: r,
+		query: t,
+		variables: n,
+		workspaceToken: !0
+	});
+	if (i.errors?.length) throw Error(i.errors[0]?.message ?? "GraphQL request failed");
+	if (!i.data) throw Error("GraphQL response did not include data");
+	return i.data;
+}, r = async (e, r, i) => {
+	let a = await n(e, r, i);
+	return t(), a;
+};
+//#endregion
+export { n as wspaceFetch, r as wspaceMutate };
+
+//# sourceMappingURL=transport.js.map

package/dist/brainyrich/components/reuse/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","names":[],"sources":["../../../../src/brainyrich/components/reuse/transport.ts"],"sourcesContent":["/**\n * Shared workspace-gateway transport for the BrainyRich REUSE components.\n * @module brainyrich/components/reuse/transport\n *\n * The four reuse components (TagField, DocumentsPanel, CommentThread,\n * ReviewReminders) consume PLATFORM subgraphs — `wspace-tags-svc`,\n * `wspace-files-svc`, `wspace-conversations-svc`, `wspace-calendar-svc` —\n * that are composed into the SAME workspace supergraph the BrainyRich MFE\n * already talks to. So every call routes through the identical transport the\n * `bra*` hooks use: `graphqlFetch({ gateway: 'workspace', workspaceToken: true })`.\n *\n * This file only contains the transport primitive; each component owns its own\n * react-query hooks (kept co-located so a page can drop one component into a\n * Sheet/tab without pulling in the others).\n */\n\nimport { graphqlFetch } from '@burdenoff/fe-libs/shared/graphql';\n\n/**\n * fe-libs `graphqlFetch` coalesces `query` responses in a short-lived in-memory\n * cache keyed by operationName+variables (~15s); mutations are never cached. A\n * read issued right after a write (the react-query refetch our `invalidateQueries`\n * triggers) would otherwise return the PRE-mutation response until the TTL lapses,\n * hiding just-created rows. fe-libs' documented remedy is that write-performing\n * callers clear those caches — we do exactly that after every reuse mutation.\n */\ntype GraphqlReadCacheGlobals = {\n  __graphqlFetchResponseCache?: { clear: () => void };\n  __graphqlFetchPendingResponses?: { clear: () => void };\n  __boffGraphQLResponseCache?: { clear: () => void };\n};\n\nconst clearGraphqlReadCaches = (): void => {\n  const g = globalThis as GraphqlReadCacheGlobals;\n  g.__graphqlFetchResponseCache?.clear();\n  g.__graphqlFetchPendingResponses?.clear();\n  g.__boffGraphQLResponseCache?.clear();\n};\n\n/** Execute a workspace-gateway GraphQL operation with the workspace token. */\nexport const wspaceFetch = async <TData>(\n  query: string,\n  variables: Record<string, unknown>,\n  baseUrl?: string\n): Promise<TData> => {\n  const response = await graphqlFetch<TData>({\n    gateway: 'workspace',\n    baseUrl,\n    query,\n    variables,\n    workspaceToken: true,\n  });\n\n  if (response.errors?.length) {\n    throw new Error(response.errors[0]?.message ?? 'GraphQL request failed');\n  }\n  if (!response.data) {\n    throw new Error('GraphQL response did not include data');\n  }\n  return response.data;\n};\n\n/** Mutation transport — identical to `wspaceFetch` but clears read caches after. */\nexport const wspaceMutate = async <TData>(\n  query: string,\n  variables: Record<string, unknown>,\n  baseUrl?: string\n): Promise<TData> => {\n  const data = await wspaceFetch<TData>(query, variables, baseUrl);\n  clearGraphqlReadCaches();\n  return data;\n};\n"],"mappings":";;AAgCA,IAAM,UAAqC;CACzC,IAAM,IAAI;AAGV,CAFA,EAAE,6BAA6B,OAAO,EACtC,EAAE,gCAAgC,OAAO,EACzC,EAAE,4BAA4B,OAAO;GAI1B,IAAc,OACzB,GACA,GACA,MACmB;CACnB,IAAM,IAAW,MAAM,EAAoB;EACzC,SAAS;EACT;EACA;EACA;EACA,gBAAgB;EACjB,CAAC;AAEF,KAAI,EAAS,QAAQ,OACnB,OAAU,MAAM,EAAS,OAAO,IAAI,WAAW,yBAAyB;AAE1E,KAAI,CAAC,EAAS,KACZ,OAAU,MAAM,wCAAwC;AAE1D,QAAO,EAAS;GAIL,IAAe,OAC1B,GACA,GACA,MACmB;CACnB,IAAM,IAAO,MAAM,EAAmB,GAAO,GAAW,EAAQ;AAEhE,QADA,GAAwB,EACjB"}