@reverbia/sdk 1.0.0-next.20260110155148 → 1.0.0-next.20260110210906

package/dist/react/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   BACKUP_DRIVE_ROOT_FOLDER: () => DEFAULT_ROOT_FOLDER,
   BACKUP_ICLOUD_FOLDER: () => DEFAULT_BACKUP_FOLDER2,
   BackupAuthProvider: () => BackupAuthProvider,
+  BlobUrlManager: () => BlobUrlManager,
   ChatConversation: () => Conversation,
   ChatMessage: () => Message,
   DEFAULT_BACKUP_FOLDER: () => DEFAULT_BACKUP_FOLDER,
@@ -71,9 +72,11 @@ __export(index_exports, {
   createMemoryContextSystemMessage: () => createMemoryContextSystemMessage,
   decryptData: () => decryptData,
   decryptDataBytes: () => decryptDataBytes,
+  deleteEncryptedFile: () => deleteEncryptedFile,
   encryptData: () => encryptData,
   exportPublicKey: () => exportPublicKey,
   extractConversationContext: () => extractConversationContext,
+  fileExists: () => fileExists,
   findFileIdBySourceUrl: () => findFileIdBySourceUrl,
   formatMemoriesForChat: () => formatMemoriesForChat,
   generateCompositeKey: () => generateCompositeKey,
@@ -85,6 +88,7 @@ __export(index_exports, {
   getAndClearDriveReturnUrl: () => getAndClearDriveReturnUrl,
   getCalendarAccessToken: () => getCalendarAccessToken,
   getDriveAccessToken: () => getDriveAccessToken,
+  getEncryptionKey: () => getEncryptionKey,
   getGoogleDriveStoredToken: () => getGoogleDriveStoredToken,
   getValidCalendarToken: () => getValidCalendarToken,
   getValidDriveToken: () => getValidDriveToken,
@@ -99,7 +103,9 @@ __export(index_exports, {
   hasKeyPair: () => hasKeyPair,
   isCalendarCallback: () => isCalendarCallback,
   isDriveCallback: () => isDriveCallback,
+  isOPFSSupported: () => isOPFSSupported,
   memoryStorageSchema: () => memoryStorageSchema,
+  readEncryptedFile: () => readEncryptedFile,
   refreshCalendarToken: () => refreshCalendarToken,
   refreshDriveToken: () => refreshDriveToken,
   replaceUrlWithMCPPlaceholder: () => replaceUrlWithMCPPlaceholder,
@@ -137,7 +143,8 @@ __export(index_exports, {
   usePdf: () => usePdf,
   useSearch: () => useSearch,
   useSettings: () => useSettings,
-  userPreferencesStorageSchema: () => userPreferencesStorageSchema
+  userPreferencesStorageSchema: () => userPreferencesStorageSchema,
+  writeEncryptedFile: () => writeEncryptedFile
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -2829,6 +2836,178 @@ async function searchMessagesOp(ctx, queryVector, options) {
   return resultsWithSimilarity.sort((a, b) => b.similarity - a.similarity).slice(0, limit);
 }
 
+// src/lib/storage/opfs.ts
+var FILE_PLACEHOLDER_PREFIX = "__SDKFILE__";
+var FILE_PLACEHOLDER_SUFFIX = "__";
+var FILE_PLACEHOLDER_REGEX = /__SDKFILE__([a-f0-9-]+)__/g;
+function createFilePlaceholder(fileId) {
+  return `${FILE_PLACEHOLDER_PREFIX}${fileId}${FILE_PLACEHOLDER_SUFFIX}`;
+}
+function extractFileIds(content) {
+  const matches = content.matchAll(FILE_PLACEHOLDER_REGEX);
+  return Array.from(matches, (m) => m[1]);
+}
+function isOPFSSupported() {
+  return typeof navigator !== "undefined" && "storage" in navigator && "getDirectory" in navigator.storage;
+}
+async function getSDKDirectory() {
+  const root = await navigator.storage.getDirectory();
+  return root.getDirectoryHandle("reverbia-sdk-files", { create: true });
+}
+function bytesToHex2(bytes) {
+  return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+function hexToBytes2(hex) {
+  const bytes = new Uint8Array(hex.length / 2);
+  for (let i = 0; i < hex.length; i += 2) {
+    bytes[i / 2] = parseInt(hex.slice(i, i + 2), 16);
+  }
+  return bytes;
+}
+async function encryptBlob(blob, encryptionKey) {
+  const arrayBuffer = await blob.arrayBuffer();
+  const plaintext = new Uint8Array(arrayBuffer);
+  const iv = crypto.getRandomValues(new Uint8Array(12));
+  const ciphertext = await crypto.subtle.encrypt(
+    { name: "AES-GCM", iv },
+    encryptionKey,
+    plaintext
+  );
+  const combined = new Uint8Array(iv.length + ciphertext.byteLength);
+  combined.set(iv, 0);
+  combined.set(new Uint8Array(ciphertext), iv.length);
+  return bytesToHex2(combined);
+}
+async function decryptToBytes(encryptedHex, encryptionKey) {
+  const combined = hexToBytes2(encryptedHex);
+  const iv = combined.slice(0, 12);
+  const ciphertext = combined.slice(12);
+  const decrypted = await crypto.subtle.decrypt(
+    { name: "AES-GCM", iv },
+    encryptionKey,
+    ciphertext
+  );
+  return new Uint8Array(decrypted);
+}
+async function writeEncryptedFile(fileId, blob, encryptionKey, metadata) {
+  if (!isOPFSSupported()) {
+    throw new Error("OPFS is not supported in this browser");
+  }
+  const dir = await getSDKDirectory();
+  const encryptedHex = await encryptBlob(blob, encryptionKey);
+  const contentHandle = await dir.getFileHandle(`${fileId}.enc`, {
+    create: true
+  });
+  const contentWritable = await contentHandle.createWritable();
+  await contentWritable.write(encryptedHex);
+  await contentWritable.close();
+  const fileMetadata = {
+    id: fileId,
+    name: metadata?.name || `file-${fileId}`,
+    type: blob.type || "application/octet-stream",
+    size: blob.size,
+    sourceUrl: metadata?.sourceUrl,
+    createdAt: Date.now()
+  };
+  const metaHandle = await dir.getFileHandle(`${fileId}.meta.json`, {
+    create: true
+  });
+  const metaWritable = await metaHandle.createWritable();
+  await metaWritable.write(JSON.stringify(fileMetadata));
+  await metaWritable.close();
+}
+async function readEncryptedFile(fileId, encryptionKey) {
+  if (!isOPFSSupported()) {
+    throw new Error("OPFS is not supported in this browser");
+  }
+  const dir = await getSDKDirectory();
+  try {
+    const contentHandle = await dir.getFileHandle(`${fileId}.enc`);
+    const contentFile = await contentHandle.getFile();
+    const encryptedHex = await contentFile.text();
+    const metaHandle = await dir.getFileHandle(`${fileId}.meta.json`);
+    const metaFile = await metaHandle.getFile();
+    const metadata = JSON.parse(await metaFile.text());
+    const decryptedBytes = await decryptToBytes(encryptedHex, encryptionKey);
+    const blob = new Blob([decryptedBytes.buffer], { type: metadata.type });
+    return { blob, metadata };
+  } catch (error) {
+    if (error instanceof DOMException && error.name === "NotFoundError") {
+      return null;
+    }
+    throw error;
+  }
+}
+async function deleteEncryptedFile(fileId) {
+  if (!isOPFSSupported()) {
+    throw new Error("OPFS is not supported in this browser");
+  }
+  const dir = await getSDKDirectory();
+  try {
+    await dir.removeEntry(`${fileId}.enc`);
+    await dir.removeEntry(`${fileId}.meta.json`);
+  } catch {
+  }
+}
+async function fileExists(fileId) {
+  if (!isOPFSSupported()) {
+    return false;
+  }
+  const dir = await getSDKDirectory();
+  try {
+    await dir.getFileHandle(`${fileId}.enc`);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var BlobUrlManager = class {
+  constructor() {
+    this.activeUrls = /* @__PURE__ */ new Map();
+  }
+  // fileId -> blobUrl
+  /**
+   * Creates a blob URL for a file and tracks it.
+   */
+  createUrl(fileId, blob) {
+    this.revokeUrl(fileId);
+    const url = URL.createObjectURL(blob);
+    this.activeUrls.set(fileId, url);
+    return url;
+  }
+  /**
+   * Gets the active blob URL for a file, if any.
+   */
+  getUrl(fileId) {
+    return this.activeUrls.get(fileId);
+  }
+  /**
+   * Revokes a blob URL and removes it from tracking.
+   */
+  revokeUrl(fileId) {
+    const url = this.activeUrls.get(fileId);
+    if (url) {
+      URL.revokeObjectURL(url);
+      this.activeUrls.delete(fileId);
+    }
+  }
+  /**
+   * Revokes all tracked blob URLs.
+   */
+  revokeAll() {
+    for (const url of this.activeUrls.values()) {
+      URL.revokeObjectURL(url);
+    }
+    this.activeUrls.clear();
+  }
+  /**
+   * Gets the count of active blob URLs.
+   */
+  get size() {
+    return this.activeUrls.size;
+  }
+};
+
 // src/react/useChatStorage.ts
 function replaceUrlWithMCPPlaceholder(content, url, fileId) {
   const escapedUrl = url.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -2850,20 +3029,69 @@ function replaceUrlWithMCPPlaceholder(content, url, fileId) {
 function findFileIdBySourceUrl(files, sourceUrl) {
   return files?.find((f) => f.sourceUrl === sourceUrl)?.id;
 }
-function storedToLlmapiMessage(stored) {
-  const content = [
-    { type: "text", text: stored.content }
-  ];
+async function isUrlValid(url, timeoutMs = 5e3) {
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    const response = await fetch(url, {
+      method: "GET",
+      headers: { Range: "bytes=0-0" },
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    return response.ok || response.status === 206;
+  } catch {
+    return false;
+  }
+}
+async function storedToLlmapiMessage(stored) {
+  let textContent = stored.content;
+  const fileUrlMap = /* @__PURE__ */ new Map();
+  const imageParts = [];
   if (stored.files?.length) {
     for (const file of stored.files) {
       if (file.url) {
-        content.push({
+        imageParts.push({
           type: "image_url",
           image_url: { url: file.url }
         });
+      } else if (file.sourceUrl) {
+        const isValid = await isUrlValid(file.sourceUrl);
+        if (isValid) {
+          imageParts.push({
+            type: "image_url",
+            image_url: { url: file.sourceUrl }
+          });
+          fileUrlMap.set(file.id, file.sourceUrl);
+        }
       }
     }
   }
+  textContent = textContent.replace(
+    /__SDKFILE__([a-f0-9-]+)__/g,
+    (match, fileId) => {
+      const sourceUrl = fileUrlMap.get(fileId);
+      if (sourceUrl) {
+        return `![image](${sourceUrl})`;
+      }
+      return "";
+    }
+  );
+  textContent = textContent.replace(
+    /!\[MCP_IMAGE:([a-f0-9-]+)\]/g,
+    (match, fileId) => {
+      const sourceUrl = fileUrlMap.get(fileId);
+      if (sourceUrl) {
+        return `![image](${sourceUrl})`;
+      }
+      return "";
+    }
+  );
+  textContent = textContent.replace(/\n{3,}/g, "\n\n").trim();
+  const content = [
+    { type: "text", text: textContent },
+    ...imageParts
+  ];
   return {
     role: stored.role,
     content
@@ -2880,9 +3108,17 @@ function useChatStorage(options) {
     onData,
     onFinish,
     onError,
-    apiType
+    apiType,
+    walletAddress
   } = options;
   const [currentConversationId, setCurrentConversationId] = (0, import_react2.useState)(initialConversationId || null);
+  const blobManagerRef = (0, import_react2.useRef)(new BlobUrlManager());
+  (0, import_react2.useEffect)(() => {
+    const manager = blobManagerRef.current;
+    return () => {
+      manager.revokeAll();
+    };
+  }, []);
   const messagesCollection = (0, import_react2.useMemo)(
     () => database.get("history"),
     [database]
@@ -2950,9 +3186,49 @@ function useChatStorage(options) {
   );
   const getMessages = (0, import_react2.useCallback)(
     async (convId) => {
-      return getMessagesOp(storageCtx, convId);
+      const messages = await getMessagesOp(storageCtx, convId);
+      if (walletAddress && hasEncryptionKey(walletAddress) && isOPFSSupported()) {
+        try {
+          const encryptionKey = await getEncryptionKey(walletAddress);
+          const blobManager = blobManagerRef.current;
+          const resolvedMessages = await Promise.all(
+            messages.map(async (msg) => {
+              const fileIds = extractFileIds(msg.content);
+              if (fileIds.length === 0) {
+                return msg;
+              }
+              let resolvedContent = msg.content;
+              for (const fileId of fileIds) {
+                let url = blobManager.getUrl(fileId);
+                if (!url) {
+                  const result = await readEncryptedFile(fileId, encryptionKey);
+                  if (result) {
+                    url = blobManager.createUrl(fileId, result.blob);
+                  }
+                }
+                if (url) {
+                  const placeholder = createFilePlaceholder(fileId);
+                  resolvedContent = resolvedContent.replace(
+                    new RegExp(
+                      placeholder.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"),
+                      "g"
+                    ),
+                    `![image](${url})`
+                  );
+                }
+              }
+              return { ...msg, content: resolvedContent };
+            })
+          );
+          return resolvedMessages;
+        } catch (error) {
+          console.error("[useChatStorage] Failed to resolve file placeholders:", error);
+          return messages;
+        }
+      }
+      return messages;
     },
-    [storageCtx]
+    [storageCtx, walletAddress]
   );
   const getMessageCount = (0, import_react2.useCallback)(
     async (convId) => {
@@ -3176,6 +3452,89 @@ function useChatStorage(options) {
     },
     []
   );
+  const extractAndStoreEncryptedMCPImages = (0, import_react2.useCallback)(
+    async (content, address) => {
+      try {
+        if (!isOPFSSupported()) {
+          console.warn("[extractAndStoreEncryptedMCPImages] OPFS not supported");
+          return { processedFiles: [], cleanedContent: content };
+        }
+        if (!hasEncryptionKey(address)) {
+          console.warn("[extractAndStoreEncryptedMCPImages] Encryption key not available");
+          return { processedFiles: [], cleanedContent: content };
+        }
+        const MCP_IMAGE_URL_PATTERN = new RegExp(
+          `https://${MCP_R2_DOMAIN.replace(/\./g, "\\.")}[^\\s)]*`,
+          "g"
+        );
+        const urlMatches = content.match(MCP_IMAGE_URL_PATTERN);
+        if (!urlMatches || urlMatches.length === 0) {
+          return { processedFiles: [], cleanedContent: content };
+        }
+        const uniqueUrls = [...new Set(urlMatches)];
+        const encryptionKey = await getEncryptionKey(address);
+        const processedFiles = [];
+        let cleanedContent = content;
+        const results = await Promise.allSettled(
+          uniqueUrls.map(async (imageUrl) => {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 3e4);
+            try {
+              const response = await fetch(imageUrl, {
+                signal: controller.signal,
+                cache: "no-store"
+              });
+              if (!response.ok) {
+                throw new Error(`Failed to fetch image: ${response.status}`);
+              }
+              const blob = await response.blob();
+              const fileId = crypto.randomUUID();
+              const urlPath = imageUrl.split("?")[0] ?? imageUrl;
+              const extension = urlPath.match(/\.([a-zA-Z0-9]+)$/)?.[1] || "png";
+              const mimeType = blob.type || `image/${extension}`;
+              const fileName = `mcp-image-${Date.now()}-${fileId.slice(0, 8)}.${extension}`;
+              await writeEncryptedFile(fileId, blob, encryptionKey, {
+                name: fileName,
+                sourceUrl: imageUrl
+              });
+              return { fileId, fileName, mimeType, size: blob.size, imageUrl };
+            } finally {
+              clearTimeout(timeoutId);
+            }
+          })
+        );
+        results.forEach((result, i) => {
+          const imageUrl = uniqueUrls[i];
+          if (result.status === "fulfilled") {
+            const { fileId, fileName, mimeType, size } = result.value;
+            processedFiles.push({
+              id: fileId,
+              name: fileName,
+              type: mimeType,
+              size,
+              sourceUrl: imageUrl
+            });
+            const placeholder = createFilePlaceholder(fileId);
+            const escapedUrl = imageUrl.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            const markdownImagePattern = new RegExp(
+              `!\\[[^\\]]*\\]\\([\\s]*${escapedUrl}[\\s]*\\)`,
+              "g"
+            );
+            cleanedContent = cleanedContent.replace(markdownImagePattern, placeholder);
+            cleanedContent = cleanedContent.replace(new RegExp(escapedUrl, "g"), placeholder);
+          } else {
+            console.error("[extractAndStoreEncryptedMCPImages] Failed:", result.reason);
+          }
+        });
+        cleanedContent = cleanedContent.replace(/\n{3,}/g, "\n\n").trim();
+        return { processedFiles, cleanedContent };
+      } catch (err) {
+        console.error("[extractAndStoreEncryptedMCPImages] Unexpected error:", err);
+        return { processedFiles: [], cleanedContent: content };
+      }
+    },
+    []
+  );
   const sendMessage = (0, import_react2.useCallback)(
     async (args) => {
       const {
@@ -3227,10 +3586,10 @@ function useChatStorage(options) {
         const storedMessages = await getMessages(convId);
         const validMessages = storedMessages.filter((msg) => !msg.error);
         const limitedMessages = validMessages.slice(-maxHistoryMessages);
-        messagesToSend = [
-          ...limitedMessages.map(storedToLlmapiMessage),
-          ...messages
-        ];
+        const historyMessages = await Promise.all(
+          limitedMessages.map(storedToLlmapiMessage)
+        );
+        messagesToSend = [...historyMessages, ...messages];
       } else {
         messagesToSend = [...messages];
       }
@@ -3368,7 +3727,14 @@ function useChatStorage(options) {
       let cleanedContent = assistantContent.replace(jsonSourcesBlockRegex, "").trim();
       cleanedContent = cleanedContent.replace(/\n{3,}/g, "\n\n");
       let processedFiles = [];
-      if (writeFile) {
+      if (walletAddress) {
+        const result2 = await extractAndStoreEncryptedMCPImages(
+          cleanedContent,
+          walletAddress
+        );
+        processedFiles = result2.processedFiles;
+        cleanedContent = result2.cleanedContent;
+      } else if (writeFile) {
         const result2 = await extractAndStoreMCPImages(
           cleanedContent,
           writeFile
@@ -3404,7 +3770,7 @@ function useChatStorage(options) {
         assistantMessage: storedAssistantMessage
       };
     },
-    [ensureConversation, getMessages, storageCtx, baseSendMessage]
+    [ensureConversation, getMessages, storageCtx, baseSendMessage, walletAddress, extractAndStoreEncryptedMCPImages]
   );
   const searchMessages = (0, import_react2.useCallback)(
     async (queryVector, options2) => {
@@ -9179,6 +9545,7 @@ function hasDriveCredentials() {
   BACKUP_DRIVE_ROOT_FOLDER,
   BACKUP_ICLOUD_FOLDER,
   BackupAuthProvider,
+  BlobUrlManager,
   ChatConversation,
   ChatMessage,
   DEFAULT_BACKUP_FOLDER,
@@ -9208,9 +9575,11 @@ function hasDriveCredentials() {
   createMemoryContextSystemMessage,
   decryptData,
   decryptDataBytes,
+  deleteEncryptedFile,
   encryptData,
   exportPublicKey,
   extractConversationContext,
+  fileExists,
   findFileIdBySourceUrl,
   formatMemoriesForChat,
   generateCompositeKey,
@@ -9222,6 +9591,7 @@ function hasDriveCredentials() {
   getAndClearDriveReturnUrl,
   getCalendarAccessToken,
   getDriveAccessToken,
+  getEncryptionKey,
   getGoogleDriveStoredToken,
   getValidCalendarToken,
   getValidDriveToken,
@@ -9236,7 +9606,9 @@ function hasDriveCredentials() {
   hasKeyPair,
   isCalendarCallback,
   isDriveCallback,
+  isOPFSSupported,
   memoryStorageSchema,
+  readEncryptedFile,
   refreshCalendarToken,
   refreshDriveToken,
   replaceUrlWithMCPPlaceholder,
@@ -9274,5 +9646,6 @@ function hasDriveCredentials() {
   usePdf,
   useSearch,
   useSettings,
-  userPreferencesStorageSchema
+  userPreferencesStorageSchema,
+  writeEncryptedFile
 });

package/dist/react/index.d.mts

@@ -1055,6 +1055,15 @@ declare function clearEncryptionKey(address: string): void;
  * Clears all encryption keys from memory
  */
 declare function clearAllEncryptionKeys(): void;
+/**
+ * Gets the encryption key from in-memory storage and imports it as a CryptoKey.
+ * The key must have been previously requested via requestEncryptionKey.
+ *
+ * @param address - The wallet address
+ * @returns The CryptoKey for AES-GCM encryption/decryption
+ * @throws Error if the key hasn't been requested yet
+ */
+declare function getEncryptionKey(address: string): Promise<CryptoKey>;
 /**
  * Encrypts data using AES-GCM with the stored encryption key.
  *
@@ -1816,6 +1825,18 @@ interface UseChatStorageOptions extends BaseUseChatStorageOptions {
      * - "completions": OpenAI Chat Completions API (wider model compatibility)
      */
     apiType?: ApiType;
+    /**
+     * Wallet address for encrypted file storage.
+     * When provided, MCP-generated images are automatically encrypted and stored
+     * in OPFS using wallet-derived keys. Messages are returned with working blob URLs.
+     *
+     * Requires:
+     * - OPFS browser support
+     * - Encryption key to be requested via `requestEncryptionKey` first
+     *
+     * When not provided, falls back to the `writeFile` callback in sendMessage args.
+     */
+    walletAddress?: string;
 }
 /**
  * Arguments for sendMessage with storage (React version)
@@ -1982,6 +2003,84 @@ interface UseChatStorageResult extends BaseUseChatStorageResult {
  */
 declare function useChatStorage(options: UseChatStorageOptions): UseChatStorageResult;
 
+/**
+ * Checks if the browser supports OPFS.
+ */
+declare function isOPFSSupported(): boolean;
+/**
+ * File metadata stored alongside encrypted content.
+ */
+interface StoredFileMetadata {
+    id: string;
+    name: string;
+    type: string;
+    size: number;
+    sourceUrl?: string;
+    createdAt: number;
+}
+/**
+ * Writes an encrypted file to OPFS.
+ *
+ * @param fileId - Unique identifier for the file
+ * @param blob - The file content
+ * @param encryptionKey - CryptoKey for encryption
+ * @param metadata - Optional metadata (name, type, sourceUrl)
+ */
+declare function writeEncryptedFile(fileId: string, blob: Blob, encryptionKey: CryptoKey, metadata?: {
+    name?: string;
+    sourceUrl?: string;
+}): Promise<void>;
+/**
+ * Reads and decrypts a file from OPFS.
+ *
+ * @param fileId - The file identifier
+ * @param encryptionKey - CryptoKey for decryption
+ * @returns The decrypted blob, or null if not found
+ */
+declare function readEncryptedFile(fileId: string, encryptionKey: CryptoKey): Promise<{
+    blob: Blob;
+    metadata: StoredFileMetadata;
+} | null>;
+/**
+ * Deletes a file from OPFS.
+ *
+ * @param fileId - The file identifier
+ */
+declare function deleteEncryptedFile(fileId: string): Promise<void>;
+/**
+ * Checks if a file exists in OPFS.
+ *
+ * @param fileId - The file identifier
+ */
+declare function fileExists(fileId: string): Promise<boolean>;
+/**
+ * Manager for blob URLs to prevent memory leaks.
+ * Tracks active blob URLs and provides cleanup functionality.
+ */
+declare class BlobUrlManager {
+    private activeUrls;
+    /**
+     * Creates a blob URL for a file and tracks it.
+     */
+    createUrl(fileId: string, blob: Blob): string;
+    /**
+     * Gets the active blob URL for a file, if any.
+     */
+    getUrl(fileId: string): string | undefined;
+    /**
+     * Revokes a blob URL and removes it from tracking.
+     */
+    revokeUrl(fileId: string): void;
+    /**
+     * Revokes all tracked blob URLs.
+     */
+    revokeAll(): void;
+    /**
+     * Gets the count of active blob URLs.
+     */
+    get size(): number;
+}
+
 /**
  * Combined WatermelonDB schema for all SDK storage modules.
  *
@@ -3801,4 +3900,4 @@ declare function storeDriveToken(accessToken: string, expiresIn?: number, refres
  */
 declare function hasDriveCredentials(): boolean;
 
-export { DEFAULT_CONVERSATIONS_FOLDER as BACKUP_DRIVE_CONVERSATIONS_FOLDER, DEFAULT_ROOT_FOLDER as BACKUP_DRIVE_ROOT_FOLDER, DEFAULT_BACKUP_FOLDER as BACKUP_ICLOUD_FOLDER, type BackupAuthContextValue, BackupAuthProvider, type BackupAuthProviderProps, type BackupOperationOptions, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, type CreateUserPreferenceOptions, DEFAULT_BACKUP_FOLDER$1 as DEFAULT_BACKUP_FOLDER, DEFAULT_CONVERSATIONS_FOLDER as DEFAULT_DRIVE_CONVERSATIONS_FOLDER, DEFAULT_ROOT_FOLDER as DEFAULT_DRIVE_ROOT_FOLDER, DEFAULT_BACKUP_FOLDER$1 as DEFAULT_DROPBOX_FOLDER, DEFAULT_BACKUP_FOLDER as DEFAULT_ICLOUD_BACKUP_FOLDER, DEFAULT_PERSONALITY_SETTINGS, type DropboxAuthContextValue, DropboxAuthProvider, type DropboxAuthProviderProps, type DropboxExportResult, type DropboxImportResult, type EmbeddedWalletSignerFn, type FileMetadata, type GoogleDriveAuthContextValue, GoogleDriveAuthProvider, type GoogleDriveAuthProviderProps, type GoogleDriveExportResult, type GoogleDriveImportResult, type ICloudAuthContextValue, ICloudAuthProvider, type ICloudAuthProviderProps, type ICloudExportResult, type ICloudImportResult, type MemoryItem, type MemoryType, type OCRFile, type PdfFile, type PersonalitySettings, type PersonalitySliders, type PersonalityStyle, type ProfileUpdate, type ProgressCallback, type ProviderAuthState, type ProviderBackupState, SLIDER_CONFIG, type SearchMessagesOptions, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type SignMessageFn, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, ModelPreference as StoredModelPreferenceModel, type StoredUserPreference, UserPreference as StoredUserPreferenceModel, type UpdateMemoryOptions, type UpdateModelPreferenceOptions, type UpdateUserPreferenceOptions, type UseBackupOptions, type UseBackupResult, type UseChatStorageOptions, type UseChatStorageResult, type UseDropboxBackupOptions, type UseDropboxBackupResult, type UseEncryptionResult, type UseGoogleDriveBackupOptions, type UseGoogleDriveBackupResult, type UseICloudBackupOptions, type UseICloudBackupResult, type UseImageGenerationResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseModelsResult, type UseOCRResult, type UsePdfResult, type UseSearchResult, type UseSettingsOptions, type UseSettingsResult, chatStorageMigrations, chatStorageSchema, clearAllEncryptionKeys, clearAllKeyPairs, clearCalendarToken, clearDriveToken, clearToken as clearDropboxToken, clearEncryptionKey, clearGoogleDriveToken, clearICloudAuth, clearKeyPair, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, exportPublicKey, extractConversationContext, findFileIdBySourceUrl, formatMemoriesForChat, generateCompositeKey, generateConversationId, generateUniqueKey, getAndClearCalendarPendingMessage, getAndClearCalendarReturnUrl, getAndClearDrivePendingMessage, getAndClearDriveReturnUrl, getCalendarAccessToken, getDriveAccessToken, getGoogleDriveStoredToken, getValidCalendarToken, getValidDriveToken, handleCalendarCallback, handleDriveCallback, hasCalendarCredentials, hasDriveCredentials, hasDropboxCredentials, hasEncryptionKey, hasGoogleDriveCredentials, hasICloudCredentials, hasKeyPair, isCalendarCallback, isDriveCallback, memoryStorageSchema, refreshCalendarToken, refreshDriveToken, replaceUrlWithMCPPlaceholder, requestEncryptionKey, requestKeyPair, revokeCalendarToken, revokeDriveToken, sdkMigrations, sdkModelClasses, sdkSchema, settingsStorageSchema, startCalendarAuth, startDriveAuth, storeCalendarPendingMessage, storeCalendarReturnUrl, storeCalendarToken, storeDrivePendingMessage, storeDriveReturnUrl, storeDriveToken, useBackup, useBackupAuth, useChat, useChatStorage, useDropboxAuth, useDropboxBackup, useEncryption, useGoogleDriveAuth, useGoogleDriveBackup, useICloudAuth, useICloudBackup, useImageGeneration, useMemoryStorage, useModels, useOCR, usePdf, useSearch, useSettings, userPreferencesStorageSchema };
+export { DEFAULT_CONVERSATIONS_FOLDER as BACKUP_DRIVE_CONVERSATIONS_FOLDER, DEFAULT_ROOT_FOLDER as BACKUP_DRIVE_ROOT_FOLDER, DEFAULT_BACKUP_FOLDER as BACKUP_ICLOUD_FOLDER, type BackupAuthContextValue, BackupAuthProvider, type BackupAuthProviderProps, type BackupOperationOptions, BlobUrlManager, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, type CreateUserPreferenceOptions, DEFAULT_BACKUP_FOLDER$1 as DEFAULT_BACKUP_FOLDER, DEFAULT_CONVERSATIONS_FOLDER as DEFAULT_DRIVE_CONVERSATIONS_FOLDER, DEFAULT_ROOT_FOLDER as DEFAULT_DRIVE_ROOT_FOLDER, DEFAULT_BACKUP_FOLDER$1 as DEFAULT_DROPBOX_FOLDER, DEFAULT_BACKUP_FOLDER as DEFAULT_ICLOUD_BACKUP_FOLDER, DEFAULT_PERSONALITY_SETTINGS, type DropboxAuthContextValue, DropboxAuthProvider, type DropboxAuthProviderProps, type DropboxExportResult, type DropboxImportResult, type EmbeddedWalletSignerFn, type FileMetadata, type GoogleDriveAuthContextValue, GoogleDriveAuthProvider, type GoogleDriveAuthProviderProps, type GoogleDriveExportResult, type GoogleDriveImportResult, type ICloudAuthContextValue, ICloudAuthProvider, type ICloudAuthProviderProps, type ICloudExportResult, type ICloudImportResult, type MemoryItem, type MemoryType, type OCRFile, type PdfFile, type PersonalitySettings, type PersonalitySliders, type PersonalityStyle, type ProfileUpdate, type ProgressCallback, type ProviderAuthState, type ProviderBackupState, SLIDER_CONFIG, type SearchMessagesOptions, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type SignMessageFn, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, ModelPreference as StoredModelPreferenceModel, type StoredUserPreference, UserPreference as StoredUserPreferenceModel, type UpdateMemoryOptions, type UpdateModelPreferenceOptions, type UpdateUserPreferenceOptions, type UseBackupOptions, type UseBackupResult, type UseChatStorageOptions, type UseChatStorageResult, type UseDropboxBackupOptions, type UseDropboxBackupResult, type UseEncryptionResult, type UseGoogleDriveBackupOptions, type UseGoogleDriveBackupResult, type UseICloudBackupOptions, type UseICloudBackupResult, type UseImageGenerationResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseModelsResult, type UseOCRResult, type UsePdfResult, type UseSearchResult, type UseSettingsOptions, type UseSettingsResult, chatStorageMigrations, chatStorageSchema, clearAllEncryptionKeys, clearAllKeyPairs, clearCalendarToken, clearDriveToken, clearToken as clearDropboxToken, clearEncryptionKey, clearGoogleDriveToken, clearICloudAuth, clearKeyPair, createMemoryContextSystemMessage, decryptData, decryptDataBytes, deleteEncryptedFile, encryptData, exportPublicKey, extractConversationContext, fileExists, findFileIdBySourceUrl, formatMemoriesForChat, generateCompositeKey, generateConversationId, generateUniqueKey, getAndClearCalendarPendingMessage, getAndClearCalendarReturnUrl, getAndClearDrivePendingMessage, getAndClearDriveReturnUrl, getCalendarAccessToken, getDriveAccessToken, getEncryptionKey, getGoogleDriveStoredToken, getValidCalendarToken, getValidDriveToken, handleCalendarCallback, handleDriveCallback, hasCalendarCredentials, hasDriveCredentials, hasDropboxCredentials, hasEncryptionKey, hasGoogleDriveCredentials, hasICloudCredentials, hasKeyPair, isCalendarCallback, isDriveCallback, isOPFSSupported, memoryStorageSchema, readEncryptedFile, refreshCalendarToken, refreshDriveToken, replaceUrlWithMCPPlaceholder, requestEncryptionKey, requestKeyPair, revokeCalendarToken, revokeDriveToken, sdkMigrations, sdkModelClasses, sdkSchema, settingsStorageSchema, startCalendarAuth, startDriveAuth, storeCalendarPendingMessage, storeCalendarReturnUrl, storeCalendarToken, storeDrivePendingMessage, storeDriveReturnUrl, storeDriveToken, useBackup, useBackupAuth, useChat, useChatStorage, useDropboxAuth, useDropboxBackup, useEncryption, useGoogleDriveAuth, useGoogleDriveBackup, useICloudAuth, useICloudBackup, useImageGeneration, useMemoryStorage, useModels, useOCR, usePdf, useSearch, useSettings, userPreferencesStorageSchema, writeEncryptedFile };