@ai4b-team/fsaos-gateway-sdk 3.26.2 → 3.27.1

package/dist/iife/ui.js

@@ -1,3 +1,3 @@
-/* @fsaos/ui v2.0.0 — FSAOS UI Primitives — 2026-09-06T15:05:48.892Z */
+/* @fsaos/ui v2.0.0 — FSAOS UI Primitives — 2026-09-09T23:15:43.750Z */
 "use strict";var __FSAOS_UI__=(()=>{var m=Object.create;var r=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var f=Object.getPrototypeOf,h=Object.prototype.hasOwnProperty;var y=(e,i)=>()=>(i||e((i={exports:{}}).exports,i),i.exports),N=(e,i)=>{for(var a in i)r(e,a,{get:i[a],enumerable:!0})},s=(e,i,a,l)=>{if(i&&typeof i=="object"||typeof i=="function")for(let t of u(i))!h.call(e,t)&&t!==a&&r(e,t,{get:()=>i[t],enumerable:!(l=g(i,t))||l.enumerable});return e};var x=(e,i,a)=>(a=e!=null?m(f(e)):{},s(i||!e||!e.__esModule?r(a,"default",{value:e,enumerable:!0}):a,e)),b=e=>s(r({},"__esModule",{value:!0}),e);var d=y((V,c)=>{c.exports=React});var P={};N(P,{Badge:()=>z,Breadcrumbs:()=>A,Button:()=>D,Card:()=>w,DataView:()=>R,Detail:()=>_,Empty:()=>I,FilePreview:()=>O,Form:()=>F,Grid:()=>k,Image:()=>G,Link:()=>E,Page:()=>v,Router:()=>T,Sidebar:()=>S,Spinner:()=>B,Stack:()=>C,Table:()=>j,Tabs:()=>W,Video:()=>H});var n=x(d(),1);function o(){return(typeof window<"u"&&window.__FSAOS_CONFIG__||{}).edgeBaseUrl||""}function v(e){return(0,n.createElement)("div",{style:{minHeight:"100vh",display:"flex",flexDirection:"column"},className:e.className||""},e.children)}function C(e){let i=e.direction||"vertical";return(0,n.createElement)("div",{style:{display:"flex",flexDirection:i==="horizontal"?"row":"column",gap:e.gap||"0.5rem",padding:e.padding||"0",alignItems:e.align||"stretch",justifyContent:e.justify||"flex-start",flex:e.flex||"initial"},className:e.className||""},e.children)}function k(e){return(0,n.createElement)("div",{style:{display:"grid",gridTemplateColumns:"repeat("+(e.columns||3)+", 1fr)",gap:e.gap||"1rem",padding:e.padding||"0"},className:e.className||""},e.children)}function S(e){return(0,n.createElement)("div",{style:{display:"flex",flexDirection:"row",minHeight:"100vh"},className:e.className||""},e.children)}function w(e){return(0,n.createElement)("div",{style:{border:"1px solid var(--color-border, #e5e7eb)",borderRadius:"var(--border-radius, 0.5rem)",padding:e.padding||"1rem",background:"var(--color-surface, #fff)"},className:e.className||"",onClick:e.onClick},e.children)}function z(e){return(0,n.createElement)("span",{style:{display:"inline-flex",alignItems:"center",padding:"0.125rem 0.5rem",fontSize:"0.75rem",fontWeight:"500",borderRadius:"9999px",background:e.color||"#e5e7eb",color:e.textColor||"#374151"},className:e.className||""},e.children||e.label)}function B(e){let i=e.size||"1.5rem";return(0,n.createElement)("div",{style:{width:i,height:i,border:"2px solid #e5e7eb",borderTopColor:"var(--color-primary, #3b82f6)",borderRadius:"50%",animation:"fsaos-spin 0.6s linear infinite"}})}function D(e){return(0,n.createElement)("button",{style:{display:"inline-flex",alignItems:"center",justifyContent:"center",padding:"0.5rem 1rem",fontSize:"0.875rem",fontWeight:"500",borderRadius:"var(--border-radius, 0.375rem)",border:e.variant==="outline"?"1px solid var(--color-border, #d1d5db)":"none",background:e.variant==="outline"||e.variant==="ghost"?"transparent":"var(--color-primary, #3b82f6)",color:e.variant==="outline"||e.variant==="ghost"?"var(--color-text, #1a1a1a)":"#fff",cursor:e.disabled?"not-allowed":"pointer",opacity:e.disabled?"0.5":"1",gap:"0.5rem"},className:e.className||"",onClick:e.onClick,disabled:e.disabled},e.children||e.label)}function I(e){return(0,n.createElement)("div",{style:{display:"flex",flexDirection:"column",alignItems:"center",justifyContent:"center",padding:"3rem",color:"var(--color-text-secondary, #6b7280)",textAlign:"center"}},e.icon?(0,n.createElement)("div",{style:{fontSize:"2rem",marginBottom:"0.5rem"}},e.icon):null,(0,n.createElement)("div",{style:{fontWeight:500,marginBottom:"0.25rem"}},e.title||e.message||e.children||"No items"),e.description?(0,n.createElement)("div",{style:{fontSize:"0.875rem",opacity:.7}},e.description):null)}function R(e){return(0,n.createElement)("div",{className:e.className||""},e.children)}function j(e){return(0,n.createElement)("table",{className:e.className||""},e.children)}function F(e){return(0,n.createElement)("form",{className:e.className||"",onSubmit:e.onSubmit},e.children)}function _(e){return(0,n.createElement)("div",{className:e.className||""},e.children)}function T(e){return(0,n.createElement)("div",null,e.children)}function E(e){return(0,n.createElement)("a",{href:e.href||e.to,className:e.className||"",onClick:e.onClick},e.children)}function W(e){return(0,n.createElement)("div",{className:e.className||""},e.children)}function A(e){return(0,n.createElement)("nav",{className:e.className||""},e.children)}function G(e){return(0,n.createElement)("img",{src:e.src||(e.path?o()+e.path:""),alt:e.alt||"",className:e.className||"",style:e.style})}function H(e){return(0,n.createElement)("video",{src:e.src||(e.path?o()+e.path:""),controls:!0,className:e.className||""})}function O(e){return(0,n.createElement)("div",{className:e.className||""},e.children||"File preview")}return b(P);})();
 //# sourceMappingURL=ui.js.map

package/dist/index.cjs

@@ -173,6 +173,7 @@ __export(src_exports, {
   useLink: () => useLink,
   useList: () => useList,
   useMemberFocus: () => useMemberFocus,
+  useMintedAsset: () => useMintedAsset,
   useMounts: () => useMounts,
   useMove: () => useMove,
   useMutation: () => useMutation,
@@ -1775,7 +1776,29 @@ function pathSubscriptionMatches(subscribedPath, eventPath) {
 }
 var typedListeners = [];
 var activeScopes = /* @__PURE__ */ new Map();
+var scopeLeases = /* @__PURE__ */ new Map();
 var activePaths = /* @__PURE__ */ new Map();
+function scopeEventTypes(scopeId) {
+  const leases = scopeLeases.get(scopeId);
+  if (!leases) return [];
+  return Array.from(
+    new Set(Array.from(leases.values()).flatMap((lease) => lease.event_types))
+  ).sort();
+}
+function sameEventTypes(a, b) {
+  if (!a) return false;
+  return a.length === b.length && a.every((eventType, index) => eventType === b[index]);
+}
+function refreshScopeSubscription(scopeId) {
+  const eventTypes = scopeEventTypes(scopeId);
+  if (eventTypes.length === 0) {
+    activeScopes.delete(scopeId);
+    return null;
+  }
+  const subscription = { scope_id: scopeId, event_types: eventTypes };
+  activeScopes.set(scopeId, subscription);
+  return subscription;
+}
 var pathStates = /* @__PURE__ */ new Map();
 var pathReadyWaiters = /* @__PURE__ */ new Map();
 var connectionState = "disconnected";
@@ -2035,15 +2058,47 @@ function subscribeToEvents(eventType, callback, filter) {
   };
 }
 function subscribeToScope(scopeId, eventTypes = ["vfs_change", "ccm_change"]) {
-  log("subscribeToScope:", scopeId, eventTypes);
-  activeScopes.set(scopeId, { scope_id: scopeId, event_types: eventTypes });
-  if (ws && ws.readyState === WebSocket.OPEN) {
-    sendMessage({ type: "subscribe", scope_id: scopeId, event_types: eventTypes });
+  const leaseId = Symbol(scopeId);
+  const normalizedEventTypes = Array.from(new Set(eventTypes)).sort();
+  if (normalizedEventTypes.length === 0) return () => {
+  };
+  const leases = scopeLeases.get(scopeId) ?? /* @__PURE__ */ new Map();
+  const previousEventTypes = activeScopes.get(scopeId)?.event_types;
+  leases.set(leaseId, { event_types: normalizedEventTypes });
+  scopeLeases.set(scopeId, leases);
+  const subscription = refreshScopeSubscription(scopeId);
+  if (!subscription) return () => {
+  };
+  log("subscribeToScope:", scopeId, subscription.event_types);
+  if (ws && ws.readyState === WebSocket.OPEN && !sameEventTypes(previousEventTypes, subscription.event_types)) {
+    sendMessage({
+      type: "subscribe",
+      scope_id: scopeId,
+      event_types: subscription.event_types
+    });
   }
   ensureConnection();
+  let active = true;
   return () => {
-    activeScopes.delete(scopeId);
-    sendMessage({ type: "unsubscribe", scope_id: scopeId });
+    if (!active) return;
+    active = false;
+    const currentLeases = scopeLeases.get(scopeId);
+    if (!currentLeases?.delete(leaseId)) return;
+    const previous = activeScopes.get(scopeId)?.event_types;
+    if (currentLeases.size === 0) {
+      scopeLeases.delete(scopeId);
+      activeScopes.delete(scopeId);
+      sendMessage({ type: "unsubscribe", scope_id: scopeId });
+    } else {
+      const next = refreshScopeSubscription(scopeId);
+      if (next && ws && ws.readyState === WebSocket.OPEN && !sameEventTypes(previous, next.event_types)) {
+        sendMessage({
+          type: "subscribe",
+          scope_id: scopeId,
+          event_types: next.event_types
+        });
+      }
+    }
     maybeDisconnect();
   };
 }
@@ -2070,6 +2125,7 @@ function disconnectSSE() {
   }
   typedListeners.length = 0;
   activeScopes.clear();
+  scopeLeases.clear();
   activePaths.clear();
   pathStates.clear();
   pathReadyWaiters.clear();
@@ -4066,6 +4122,168 @@ function useArrangement(paramsOrPath) {
     applyTo
   };
 }
+function useMintedAsset(params) {
+  const { origin, originField, fallbackUrl, mintError, scopeId, scopePath } = params;
+  const sdkGeneration = useScopeKey();
+  const session = getSessionEntry();
+  const resolvedScopeId = scopeId ?? session?.scope_id ?? null;
+  const originAccountScope = React.useMemo(() => {
+    if (!origin) return null;
+    const marker = "/accounts/";
+    const markerIndex = origin.indexOf(marker);
+    if (markerIndex === -1) return null;
+    const accountEnd = origin.indexOf("/", markerIndex + marker.length);
+    return accountEnd === -1 ? origin : origin.slice(0, accountEnd);
+  }, [origin]);
+  const resolvedScopePath = scopePath ?? originAccountScope ?? session?.scope_path ?? null;
+  const resolvedOriginField = originField?.trim() || null;
+  const correlationKey = `${sdkGeneration}
+${resolvedScopeId ?? ""}
+${resolvedScopePath ?? ""}
+${resolvedOriginField ?? ""}
+${origin ?? ""}`;
+  const [found, setFound] = React.useState(null);
+  const activeRef = React.useRef({
+    key: correlationKey,
+    found: null,
+    earlyContentPaths: /* @__PURE__ */ new Set()
+  });
+  const currentFound = found?.key === correlationKey ? found : null;
+  React.useLayoutEffect(() => {
+    activeRef.current = {
+      key: correlationKey,
+      found: currentFound,
+      earlyContentPaths: /* @__PURE__ */ new Set()
+    };
+  }, [correlationKey]);
+  const recovery = reactQuery.useQuery({
+    queryKey: [
+      "vfs",
+      resolvedScopePath ?? "__unscoped__",
+      "minted-asset",
+      resolvedOriginField ?? "",
+      origin ?? ""
+    ],
+    queryFn: async () => {
+      const response = await gatewayCall("query", {
+        scope_path: resolvedScopePath,
+        filters: { [`field.${resolvedOriginField}`]: origin },
+        limit: 1
+      });
+      const rawItems = response.content?.items ?? response.items ?? [];
+      const asset = rawItems[0] ? normalizeItem(rawItems[0]) : null;
+      if (!asset) return null;
+      const children = await fetchVfsChildren(asset.path);
+      const hasBytes = children.some(
+        (child) => child.item_type === "file" && Boolean(child.type_data?.file_ref)
+      );
+      return { asset, hasBytes };
+    },
+    enabled: Boolean(origin && resolvedScopePath && resolvedOriginField && !mintError),
+    refetchInterval: (query) => {
+      if (activeRef.current.key === correlationKey && activeRef.current.found?.hasBytes) {
+        return false;
+      }
+      return query.state.data?.hasBytes ? false : 1500;
+    }
+  });
+  React.useEffect(() => {
+    const recovered = recovery.data;
+    if (!recovered || activeRef.current.key !== correlationKey) return;
+    const previous = activeRef.current.found;
+    const next = {
+      key: correlationKey,
+      itemId: recovered.asset.id,
+      itemPath: recovered.asset.path,
+      displayName: typeof recovered.asset.type_data?.display_name === "string" ? recovered.asset.type_data.display_name : recovered.asset.name,
+      hasBytes: recovered.hasBytes || Boolean(previous?.itemId === recovered.asset.id && previous.hasBytes)
+    };
+    activeRef.current.found = next;
+    setFound(next);
+  }, [recovery.data, correlationKey]);
+  const waiting = Boolean(origin && resolvedScopeId) && !mintError && !currentFound?.hasBytes;
+  React.useEffect(() => {
+    if (!waiting || !resolvedScopeId) return;
+    return subscribeToScope(
+      resolvedScopeId,
+      ["asset.materialized", "content.written"]
+    );
+  }, [waiting, resolvedScopeId]);
+  React.useEffect(() => {
+    if (!waiting || !origin || !resolvedScopeId) return;
+    const generationKey = correlationKey;
+    const payload = (data) => data?.payload ?? data;
+    const eventScope = (data) => {
+      const p = payload(data);
+      const value = p?.scope_id ?? data?.scope_id;
+      return typeof value === "string" ? value : void 0;
+    };
+    const contentPath = (data) => {
+      const p = payload(data);
+      const value = p?.item_path ?? data?.item_path;
+      return typeof value === "string" && value ? value : void 0;
+    };
+    const belongsToAsset = (itemPath, assetPath) => {
+      const normalizedAssetPath = assetPath.replace(/\/+$/, "");
+      return itemPath === normalizedAssetPath || itemPath.startsWith(`${normalizedAssetPath}/`);
+    };
+    const unsubscribes = [
+      subscribeToEvents("asset.materialized", (data) => {
+        if (activeRef.current.key !== generationKey) return;
+        const p = payload(data);
+        if (typeof p?.item_id !== "string" || !p.item_id) return;
+        const previous = activeRef.current.found;
+        const itemPath = typeof p.item_path === "string" ? p.item_path : void 0;
+        const hasBytes = Boolean(p.has_bytes) || Boolean(
+          itemPath && Array.from(activeRef.current.earlyContentPaths).some((path) => belongsToAsset(path, itemPath))
+        ) || Boolean(previous && previous.itemId === p.item_id && previous.hasBytes);
+        const next = {
+          key: generationKey,
+          itemId: p.item_id,
+          itemPath,
+          displayName: typeof p.display_name === "string" ? p.display_name : void 0,
+          hasBytes
+        };
+        activeRef.current.found = next;
+        setFound(next);
+      }, (data) => {
+        const scope = eventScope(data);
+        return (!scope || scope === resolvedScopeId) && payload(data)?.origin === origin;
+      }),
+      subscribeToEvents("content.written", (data) => {
+        if (activeRef.current.key !== generationKey) return;
+        const itemPath = contentPath(data);
+        if (!itemPath) return;
+        const previous = activeRef.current.found;
+        if (!previous?.itemPath || !belongsToAsset(itemPath, previous.itemPath)) {
+          activeRef.current.earlyContentPaths.add(itemPath);
+          if (activeRef.current.earlyContentPaths.size > 128) {
+            const oldest = activeRef.current.earlyContentPaths.values().next().value;
+            if (oldest) activeRef.current.earlyContentPaths.delete(oldest);
+          }
+          return;
+        }
+        if (previous.hasBytes) return;
+        const next = { ...previous, hasBytes: true };
+        activeRef.current.found = next;
+        setFound(next);
+      }, (data) => {
+        const scope = eventScope(data);
+        return (!scope || scope === resolvedScopeId) && Boolean(contentPath(data));
+      })
+    ];
+    return () => unsubscribes.forEach((fn) => fn());
+  }, [waiting, origin, resolvedScopeId, correlationKey]);
+  const state = mintError ? "failed" : !origin ? "idle" : currentFound ? currentFound.hasBytes ? "ready" : "materializing" : "pending";
+  return {
+    state,
+    itemId: currentFound?.itemId,
+    itemPath: currentFound?.itemPath,
+    displayName: currentFound?.displayName,
+    fallbackUrl: fallbackUrl ?? void 0,
+    error: mintError ?? void 0
+  };
+}
 
 // src/schema-utils.ts
 function keyToLabel(key) {
@@ -4863,6 +5081,7 @@ exports.useItems = useItems;
 exports.useLink = useLink;
 exports.useList = useList;
 exports.useMemberFocus = useMemberFocus;
+exports.useMintedAsset = useMintedAsset;
 exports.useMounts = useMounts;
 exports.useMove = useMove;
 exports.useMutation = useMutation;