@fias/arche-sdk 2.19.2 → 2.21.0

package/dist/index.mjs

@@ -876,6 +876,7 @@ var PLUGIN_STORE_ENTITY_ID = "ent_intg_plugin_store_0000000000";
 var VAULT_USER_DOCUMENTS_ENTITY_ID = "ent_intg_vault_documents_0000000";
 var VAULT_ARCHE_DOCUMENTS_ENTITY_ID = "ent_intg_vault_arche_docs_000000";
 var COMMUNITY_ASSETS_ENTITY_ID = "ent_intg_community_assets_000000";
+var DOCUMENT_SIGN_ENTITY_ID = "ent_intg_document_sign_000000000";
 var COMMUNITY_ASSET_MAX_URL_BATCH = 50;
 var COMMUNITY_ASSET_MAX_PUBLISH_BATCH = 20;
 async function invokeEntityOp(bridge, entityId, op, args = {}) {
@@ -1840,17 +1841,6 @@ function useVaultDocuments() {
     },
     [bridge]
   );
-  const promoteToUserFiles = useCallback(
-    async (documentId) => {
-      const res = await bridge.request("vault_documents_update", {
-        documentId,
-        userVisible: true
-      });
-      downloadUrlCache.delete(documentId);
-      return res;
-    },
-    [bridge]
-  );
   const deleteDocument = useCallback(
     async (documentId) => {
       await bridge.request("vault_documents_delete", { documentId });
@@ -1921,15 +1911,25 @@ function useVaultDocuments() {
         sensitivity: params.sensitivity,
         folderPath: params.folderPath,
         replacesDocumentId: params.replacesDocumentId,
-        // Opt-in user-visible save. The host turns this into a confirmation
-        // the user sees and the iframe cannot script; the server independently
-        // requires `vault:user-documents:write` plus a registered folder for
-        // this arche. Omitted (the common case) keeps the arche-private default.
+        // A save into the user's Documents. The host turns this into its Save
+        // dialog, which the iframe cannot see or script, and performs the
+        // write itself from the user's session. Omitted (the common case)
+        // keeps the arche-private default.
+        destination: params.destination,
         userVisible: params.userVisible
       });
     },
     [bridge]
   );
+  const saveCopy = useCallback(
+    async (documentId, options) => {
+      return bridge.request("vault_documents_update", {
+        documentId,
+        saveCopy: { ...options?.suggestedName ? { suggestedName: options.suggestedName } : {} }
+      });
+    },
+    [bridge]
+  );
   return useMemo2(
     () => ({
       list,
@@ -1939,12 +1939,12 @@ function useVaultDocuments() {
       getDownloadUrl,
       write,
       update,
-      promoteToUserFiles,
       delete: deleteDocument,
       search,
       attach,
       detach,
       upload,
+      saveCopy,
       uploadInit,
       uploadFinalize
     }),
@@ -1956,12 +1956,12 @@ function useVaultDocuments() {
       getDownloadUrl,
       write,
       update,
-      promoteToUserFiles,
       deleteDocument,
       search,
       attach,
       detach,
       upload,
+      saveCopy,
       uploadInit,
       uploadFinalize
     ]
@@ -2043,6 +2043,123 @@ function useArcheAssets() {
   );
   return useMemo2(() => ({ list, index, getUrl }), [list, index, getUrl]);
 }
+var PLUGIN_CONTENT_ENTITY_ID = "ent_intg_plugin_content_00000000";
+var FiasContentError = class extends Error {
+  constructor(message, code, path) {
+    super(message);
+    this.code = code;
+    this.path = path;
+    this.name = "FiasContentError";
+  }
+};
+function toContentError(err) {
+  if (err instanceof FiasContentError) return err;
+  const message = err instanceof Error ? err.message : String(err);
+  const code = err?.code;
+  if (/permission denied/i.test(message)) return new FiasContentError(message, "PERMISSION_DENIED");
+  if (code === "RATE_LIMITED" || /rate limit/i.test(message)) {
+    return new FiasContentError(message, "RATE_LIMIT");
+  }
+  return new FiasContentError(message, "CONTENT_UNAVAILABLE");
+}
+function fileResult(results, path) {
+  const result = results?.[path];
+  if (!result) {
+    throw new FiasContentError(`No result for content/${path}`, "CONTENT_UNAVAILABLE", path);
+  }
+  if ("error" in result) throw new FiasContentError(result.error.message, result.error.code, path);
+  return result;
+}
+var contentObjectUrls = /* @__PURE__ */ new Map();
+function useFiasContent() {
+  const bridge = useBridge();
+  const call = useCallback(
+    async (input) => {
+      let response;
+      try {
+        response = await bridge.request(
+          "client_entity_invoke",
+          { entityId: PLUGIN_CONTENT_ENTITY_ID, input },
+          CLIENT_ENTITY_INVOKE_TIMEOUT_MS
+        );
+      } catch (err) {
+        throw toContentError(err);
+      }
+      if (response?.error) {
+        throw new FiasContentError(response.error.message, response.error.code);
+      }
+      return response ?? {};
+    },
+    [bridge]
+  );
+  const list = useCallback(
+    async (prefix) => (await call({ verb: "list", ...prefix !== void 0 ? { prefix } : {} })).files ?? [],
+    [call]
+  );
+  const getText = useCallback(
+    async (path) => {
+      const { results } = await call({ verb: "read", paths: [path], as: "text" });
+      return fileResult(results, path).text;
+    },
+    [call]
+  );
+  const getJson = useCallback(
+    async (path) => JSON.parse(await getText(path)),
+    [getText]
+  );
+  const readBytes = useCallback(
+    async (path) => {
+      const { results } = await call({ verb: "read", paths: [path], as: "bytes" });
+      return fileResult(results, path);
+    },
+    [call]
+  );
+  const getBytes = useCallback(
+    async (path) => (await readBytes(path)).bytes,
+    [readBytes]
+  );
+  const getMany = useCallback(
+    async (paths, as) => {
+      const { results } = await call({ verb: "read", paths, as });
+      const out = {};
+      for (const path of paths) {
+        try {
+          const result = fileResult(results, path);
+          out[path] = as === "text" ? result.text : result.bytes;
+        } catch (err) {
+          out[path] = toContentError(err);
+        }
+      }
+      return out;
+    },
+    [call]
+  );
+  const getObjectUrl = useCallback(
+    async (path) => {
+      const cached = contentObjectUrls.get(path);
+      if (cached) return cached;
+      const pending = readBytes(path).then(
+        ({ bytes, mimeType }) => URL.createObjectURL(new Blob([bytes], { type: mimeType }))
+      );
+      contentObjectUrls.set(path, pending);
+      pending.catch(() => contentObjectUrls.delete(path));
+      return pending;
+    },
+    [readBytes]
+  );
+  const getUrl = useCallback(
+    async (path) => {
+      const { results } = await call({ verb: "url", paths: [path] });
+      const { url, expiresAt } = fileResult(results, path);
+      return { url, expiresAt };
+    },
+    [call]
+  );
+  return useMemo2(
+    () => ({ list, getText, getJson, getBytes, getMany, getObjectUrl, getUrl }),
+    [list, getText, getJson, getBytes, getMany, getObjectUrl, getUrl]
+  );
+}
 function useFiasPreviewState(key, getState, onRestore) {
   const bridge = useBridge();
   const getStateRef = useRef(getState);
@@ -2133,7 +2250,8 @@ function useVaultUserDocuments() {
     async (options) => {
       return bridge.request("vault_documents_pick", {
         maxDocuments: options?.maxDocuments,
-        access: options?.access
+        access: options?.access,
+        ...options?.accept ? { accept: [...options.accept] } : {}
       });
     },
     [bridge]
@@ -2406,6 +2524,33 @@ function useArcheHandoff(onHandoff) {
     return () => bridge.clearHandoffHandler(handler);
   }, [bridge]);
 }
+function useDocumentSign() {
+  const bridge = useBridge();
+  const getEnvelope = useCallback(
+    async (envelopeId) => {
+      const res = await invokeEntityOp(
+        bridge,
+        DOCUMENT_SIGN_ENTITY_ID,
+        "get_consented_envelope",
+        { envelopeId }
+      );
+      return res.envelope;
+    },
+    [bridge]
+  );
+  const listEvents = useCallback(
+    async (envelopeId, options) => {
+      return invokeEntityOp(
+        bridge,
+        DOCUMENT_SIGN_ENTITY_ID,
+        "list_consented_envelope_events",
+        { envelopeId, limit: options?.limit, offset: options?.offset }
+      );
+    },
+    [bridge]
+  );
+  return useMemo2(() => ({ getEnvelope, listEvents }), [getEnvelope, listEvents]);
+}
 function useFiasAIActions(config) {
   const bridge = useBridge();
   const onActionRef = useRef(config?.onAction ?? null);
@@ -2524,6 +2669,7 @@ var VALID_PLUGIN_PERMISSIONS = [
   "data:search",
   "data:store",
   "data:workspace",
+  "docsign:envelopes:read",
   "entities:audio_generate",
   "entities:client_invoke",
   "entities:image_edit",
@@ -2536,6 +2682,7 @@ var VALID_PLUGIN_PERMISSIONS = [
   "store:purchase",
   "theme:read",
   "user:profile:read",
+  "vault:arche-saves:write",
   "vault:documents:read",
   "vault:documents:write",
   "vault:user-documents:edit",
@@ -2546,13 +2693,14 @@ function isValidPluginPermission(perm) {
   return VALID_PLUGIN_PERMISSIONS.includes(perm);
 }
 var PLUGIN_PERMISSION_DESCRIPTIONS = {
-  "ai:actions": "Let Fias AI operate this app for you \u2014 only actions you could do yourself in its interface, and risky ones ask you first.",
-  "assets:community:publish": "Share images you made here so other people using this app can see them, and manage what you have shared.",
-  "assets:community:read": "Show you images that other people using this app have shared. Everything shared is checked before anyone can see it.",
-  "assets:read": "Show images from this app's published asset library.",
-  "data:search": "Search this app's own data semantically \u2014 costs credits per search.",
-  "data:store": "Save structured data in this app's own private database.",
+  "ai:actions": "Let Fias AI operate this arche for you \u2014 only actions you could do yourself in its interface, and risky ones ask you first.",
+  "assets:community:publish": "Share images you made here so other people using this arche can see them, and manage what you have shared.",
+  "assets:community:read": "Show you images that other people using this arche have shared. Everything shared is checked before anyone can see it.",
+  "assets:read": "Show images from this arche's published asset library.",
+  "data:search": "Search this arche's own data semantically \u2014 costs credits per search.",
+  "data:store": "Save structured data in this arche's own private database.",
   "data:workspace": "Create team workspaces and manage their members.",
+  "docsign:envelopes:read": "Check on signature requests it started for you \u2014 who has signed, and what is still outstanding.",
   "entities:audio_generate": "Generate audio with platform AI \u2014 costs credits.",
   "entities:client_invoke": "Use free on-device tools (grammar check, translation) in your browser.",
   "entities:image_edit": "Edit images with platform AI \u2014 costs credits.",
@@ -2561,15 +2709,16 @@ var PLUGIN_PERMISSION_DESCRIPTIONS = {
   "entities:web_search": "Search the live web on your behalf \u2014 costs credits.",
   "navigation:open_arche": "Open other arches for you (navigation only).",
   "sandbox:vendored-libraries": "Load platform-hosted libraries (like the PDF renderer) from the trusted CDN.",
-  "storage:sandbox": "Save files in this app's own private storage.",
-  "store:purchase": "Offer in-app purchases (you approve each purchase).",
+  "storage:sandbox": "Save files in this arche's own private storage.",
+  "store:purchase": "Offer purchases inside the arche (you approve each purchase).",
   "theme:read": "Match your platform theme.",
   "user:profile:read": "See your display name and avatar.",
-  "vault:documents:read": "Read documents this app itself created in your Vault.",
-  "vault:documents:write": "Create and manage its own documents in your Vault.",
-  "vault:user-documents:edit": "Save changes to files of yours that you let it edit \u2014 you choose each file, earlier versions are kept, and you can remove access any time in Vault \u2192 App Access.",
-  "vault:user-documents:read": "Read documents YOU choose to share with it from your Vault \u2014 you pick each document, and you can remove access any time in Vault \u2192 App Access.",
-  "vault:user-documents:write": "Save its work to your Fias files, where you can find and reuse it. You confirm each save."
+  "vault:arche-saves:write": "Saves files to your Arche Saves automatically.",
+  "vault:documents:read": "Read files this arche itself created, in its own folders of your Vault.",
+  "vault:documents:write": "Create and manage its own files, in its own folder of your Vault.",
+  "vault:user-documents:edit": "Save changes to files of yours that you let it edit \u2014 you choose each file, earlier versions are kept unless you turned version history off, and you can remove access any time in Vault \u2192 Arche Access.",
+  "vault:user-documents:read": "Read documents YOU choose to share with it from your Vault \u2014 you pick each document, and you can remove access any time in Vault \u2192 Arche Access.",
+  "vault:user-documents:write": "Save its work to your Documents \u2014 you choose the folder and the name each time."
 };
 
 // src/fias.ts
@@ -5056,6 +5205,7 @@ export {
   FONT_PAIRINGS,
   FiasBridge,
   FiasBridgeError,
+  FiasContentError,
   FiasProvider,
   GRAMMAR_CHECK_ENTITY_ID,
   IMAGE_SMART_CONTROL_SURFACE_KEY,
@@ -5088,6 +5238,7 @@ export {
   PANEL_THEME_LENGTH_MAX_INTEGER_DIGITS,
   PANEL_THEME_Z_MAX,
   PANEL_TITLE_MAX_LENGTH,
+  PLUGIN_CONTENT_ENTITY_ID,
   PLUGIN_PERMISSION_DESCRIPTIONS,
   SDK_BRIDGE_PROTOCOL_VERSION,
   SDK_REQUIRES_HOST_PROTOCOL_VERSION,
@@ -5108,6 +5259,7 @@ export {
   useClientEntity,
   useCommunityAssets,
   useDataSubscription,
+  useDocumentSign,
   useElevenLabsAudioIsolation,
   useElevenLabsForcedAlignment,
   useElevenLabsMusic,
@@ -5118,6 +5270,7 @@ export {
   useElevenLabsVoiceDesign,
   useEntityInvocation,
   useFiasAIActions,
+  useFiasContent,
   useFiasDataStore,
   useFiasFonts,
   useFiasNavigation,