@reverbia/sdk 1.0.0-next.20251125084024 → 1.0.0-next.20251125084053

package/dist/react/index.cjs

@@ -31,9 +31,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   createMemoryContextSystemMessage: () => createMemoryContextSystemMessage,
+  decryptData: () => decryptData,
+  decryptDataBytes: () => decryptDataBytes,
+  encryptData: () => encryptData,
   extractConversationContext: () => extractConversationContext,
   formatMemoriesForChat: () => formatMemoriesForChat,
   useChat: () => useChat,
+  useEncryption: () => useEncryption,
   useMemory: () => useMemory
 });
 module.exports = __toCommonJS(index_exports);
@@ -1007,8 +1011,166 @@ function useChat(options) {
   };
 }
 
-// src/react/useMemory.ts
+// src/react/useEncryption.ts
 var import_react2 = require("react");
+var import_react_auth = require("@privy-io/react-auth");
+var SIGN_MESSAGE = "The app is asking you to sign this message to generate a key, which will be used to encrypt data.";
+var SIGNATURE_STORAGE_KEY = "privy_encryption_key";
+function getStorageItem(key) {
+  if (typeof window === "undefined" || !window.localStorage) {
+    return null;
+  }
+  try {
+    return localStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+function setStorageItem(key, value) {
+  if (typeof window === "undefined" || !window.localStorage) {
+    return false;
+  }
+  try {
+    localStorage.setItem(key, value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function hexToBytes(hex) {
+  const cleanHex = hex.startsWith("0x") ? hex.slice(2) : hex;
+  const bytes = new Uint8Array(cleanHex.length / 2);
+  for (let i = 0; i < cleanHex.length; i += 2) {
+    bytes[i / 2] = parseInt(cleanHex.slice(i, i + 2), 16);
+  }
+  return bytes;
+}
+function bytesToHex(bytes) {
+  return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function deriveKeyFromSignature(signature) {
+  const sigBytes = hexToBytes(signature);
+  const hashBuffer = await crypto.subtle.digest(
+    "SHA-256",
+    sigBytes.buffer
+  );
+  const hashBytes = new Uint8Array(hashBuffer);
+  return bytesToHex(hashBytes);
+}
+async function getEncryptionKey() {
+  const keyHex = getStorageItem(SIGNATURE_STORAGE_KEY);
+  if (!keyHex) {
+    throw new Error("Encryption key not found. Please sign in first.");
+  }
+  const keyBytes = hexToBytes(keyHex);
+  return crypto.subtle.importKey(
+    "raw",
+    keyBytes.buffer,
+    { name: "AES-GCM" },
+    false,
+    ["encrypt", "decrypt"]
+  );
+}
+async function encryptData(plaintext) {
+  const key = await getEncryptionKey();
+  const plaintextBytes = typeof plaintext === "string" ? new TextEncoder().encode(plaintext) : plaintext;
+  const iv = crypto.getRandomValues(new Uint8Array(12));
+  const encryptedData = await crypto.subtle.encrypt(
+    {
+      name: "AES-GCM",
+      iv
+    },
+    key,
+    plaintextBytes.buffer
+  );
+  const encryptedBytes = new Uint8Array(encryptedData);
+  const combined = new Uint8Array(iv.length + encryptedBytes.length);
+  combined.set(iv, 0);
+  combined.set(encryptedBytes, iv.length);
+  return bytesToHex(combined);
+}
+async function decryptData(encryptedHex) {
+  const key = await getEncryptionKey();
+  const combined = hexToBytes(encryptedHex);
+  const iv = combined.slice(0, 12);
+  const encryptedData = combined.slice(12);
+  const decryptedData = await crypto.subtle.decrypt(
+    {
+      name: "AES-GCM",
+      iv
+    },
+    key,
+    encryptedData
+  );
+  return new TextDecoder().decode(decryptedData);
+}
+async function decryptDataBytes(encryptedHex) {
+  const key = await getEncryptionKey();
+  const combined = hexToBytes(encryptedHex);
+  const iv = combined.slice(0, 12);
+  const encryptedData = combined.slice(12);
+  const decryptedData = await crypto.subtle.decrypt(
+    {
+      name: "AES-GCM",
+      iv
+    },
+    key,
+    encryptedData
+  );
+  return new Uint8Array(decryptedData);
+}
+function useEncryption(authenticated) {
+  const { signMessage } = (0, import_react_auth.useSignMessage)();
+  const { wallets } = (0, import_react_auth.useWallets)();
+  const hasRequestedSignature = (0, import_react2.useRef)(false);
+  const hasCheckedStorage = (0, import_react2.useRef)(false);
+  (0, import_react2.useEffect)(() => {
+    if (!authenticated || wallets.length === 0) {
+      return;
+    }
+    const existingKey = getStorageItem(SIGNATURE_STORAGE_KEY);
+    if (existingKey) {
+      if (!hasCheckedStorage.current) {
+        hasCheckedStorage.current = true;
+      }
+      return;
+    }
+    const requestSignature = async () => {
+      if (!hasRequestedSignature.current) {
+        hasRequestedSignature.current = true;
+        try {
+          const { signature } = await signMessage(
+            { message: SIGN_MESSAGE },
+            {
+              address: wallets[0].address
+            }
+          );
+          const encryptionKey = await deriveKeyFromSignature(signature);
+          const stored = setStorageItem(SIGNATURE_STORAGE_KEY, encryptionKey);
+          if (!stored) {
+            throw new Error("Failed to store encryption key in localStorage");
+          }
+        } catch (error) {
+          hasRequestedSignature.current = false;
+        }
+      }
+    };
+    requestSignature();
+  }, [
+    authenticated,
+    wallets.length > 0 ? wallets[0]?.address : null,
+    signMessage
+  ]);
+  (0, import_react2.useEffect)(() => {
+    if (!authenticated) {
+      hasRequestedSignature.current = false;
+      hasCheckedStorage.current = false;
+    }
+  }, [authenticated]);
+}
+
+// src/react/useMemory.ts
+var import_react3 = require("react");
 var import_client6 = require("@reverbia/sdk");
 
 // src/lib/memory/service.ts
@@ -1341,8 +1503,8 @@ function useMemory(options = {}) {
     onFactsExtracted,
     getToken
   } = options;
-  const extractionInProgressRef = (0, import_react2.useRef)(false);
-  const extractMemoriesFromMessage = (0, import_react2.useCallback)(
+  const extractionInProgressRef = (0, import_react3.useRef)(false);
+  const extractMemoriesFromMessage = (0, import_react3.useCallback)(
     async (options2) => {
       const { messages, model } = options2;
       if (!getToken || extractionInProgressRef.current) {
@@ -1511,7 +1673,7 @@ function useMemory(options = {}) {
       onFactsExtracted
     ]
   );
-  const searchMemories = (0, import_react2.useCallback)(
+  const searchMemories = (0, import_react3.useCallback)(
     async (query, limit = 10, minSimilarity = 0.6) => {
       if (!getToken || !embeddingModel) {
         console.warn(
@@ -1613,8 +1775,12 @@ var extractConversationContext = (messages, maxMessages = 3) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createMemoryContextSystemMessage,
+  decryptData,
+  decryptDataBytes,
+  encryptData,
   extractConversationContext,
   formatMemoriesForChat,
   useChat,
+  useEncryption,
   useMemory
 });

package/dist/react/index.d.mts

@@ -190,6 +190,26 @@ type UseChatResult = {
  */
 declare function useChat(options?: UseChatOptions): UseChatResult;
 
+/**
+ * Encrypts data using AES-GCM with the stored encryption key
+ * @param plaintext - The data to encrypt (string or Uint8Array)
+ * @returns Encrypted data as hex string (IV + ciphertext + auth tag)
+ */
+declare function encryptData(plaintext: string | Uint8Array): Promise<string>;
+/**
+ * Decrypts data using AES-GCM with the stored encryption key
+ * @param encryptedHex - Encrypted data as hex string (IV + ciphertext + auth tag)
+ * @returns Decrypted data as string
+ */
+declare function decryptData(encryptedHex: string): Promise<string>;
+/**
+ * Decrypts data and returns as Uint8Array (for binary data)
+ * @param encryptedHex - Encrypted data as hex string (IV + ciphertext + auth tag)
+ * @returns Decrypted data as Uint8Array
+ */
+declare function decryptDataBytes(encryptedHex: string): Promise<Uint8Array>;
+declare function useEncryption(authenticated: boolean): void;
+
 interface MemoryItem {
     type: "identity" | "preference" | "project" | "skill" | "constraint";
     namespace: string;
@@ -295,4 +315,4 @@ declare const extractConversationContext: (messages: Array<{
     content: string;
 }>, maxMessages?: number) => string;
 
-export { createMemoryContextSystemMessage, extractConversationContext, formatMemoriesForChat, useChat, useMemory };
+export { createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, extractConversationContext, formatMemoriesForChat, useChat, useEncryption, useMemory };

package/dist/react/index.d.ts

@@ -190,6 +190,26 @@ type UseChatResult = {
  */
 declare function useChat(options?: UseChatOptions): UseChatResult;
 
+/**
+ * Encrypts data using AES-GCM with the stored encryption key
+ * @param plaintext - The data to encrypt (string or Uint8Array)
+ * @returns Encrypted data as hex string (IV + ciphertext + auth tag)
+ */
+declare function encryptData(plaintext: string | Uint8Array): Promise<string>;
+/**
+ * Decrypts data using AES-GCM with the stored encryption key
+ * @param encryptedHex - Encrypted data as hex string (IV + ciphertext + auth tag)
+ * @returns Decrypted data as string
+ */
+declare function decryptData(encryptedHex: string): Promise<string>;
+/**
+ * Decrypts data and returns as Uint8Array (for binary data)
+ * @param encryptedHex - Encrypted data as hex string (IV + ciphertext + auth tag)
+ * @returns Decrypted data as Uint8Array
+ */
+declare function decryptDataBytes(encryptedHex: string): Promise<Uint8Array>;
+declare function useEncryption(authenticated: boolean): void;
+
 interface MemoryItem {
     type: "identity" | "preference" | "project" | "skill" | "constraint";
     namespace: string;
@@ -295,4 +315,4 @@ declare const extractConversationContext: (messages: Array<{
     content: string;
 }>, maxMessages?: number) => string;
 
-export { createMemoryContextSystemMessage, extractConversationContext, formatMemoriesForChat, useChat, useMemory };
+export { createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, extractConversationContext, formatMemoriesForChat, useChat, useEncryption, useMemory };

package/dist/react/index.mjs

@@ -967,8 +967,166 @@ function useChat(options) {
   };
 }
 
+// src/react/useEncryption.ts
+import { useEffect as useEffect2, useRef as useRef2 } from "react";
+import { useSignMessage, useWallets } from "@privy-io/react-auth";
+var SIGN_MESSAGE = "The app is asking you to sign this message to generate a key, which will be used to encrypt data.";
+var SIGNATURE_STORAGE_KEY = "privy_encryption_key";
+function getStorageItem(key) {
+  if (typeof window === "undefined" || !window.localStorage) {
+    return null;
+  }
+  try {
+    return localStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+function setStorageItem(key, value) {
+  if (typeof window === "undefined" || !window.localStorage) {
+    return false;
+  }
+  try {
+    localStorage.setItem(key, value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function hexToBytes(hex) {
+  const cleanHex = hex.startsWith("0x") ? hex.slice(2) : hex;
+  const bytes = new Uint8Array(cleanHex.length / 2);
+  for (let i = 0; i < cleanHex.length; i += 2) {
+    bytes[i / 2] = parseInt(cleanHex.slice(i, i + 2), 16);
+  }
+  return bytes;
+}
+function bytesToHex(bytes) {
+  return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function deriveKeyFromSignature(signature) {
+  const sigBytes = hexToBytes(signature);
+  const hashBuffer = await crypto.subtle.digest(
+    "SHA-256",
+    sigBytes.buffer
+  );
+  const hashBytes = new Uint8Array(hashBuffer);
+  return bytesToHex(hashBytes);
+}
+async function getEncryptionKey() {
+  const keyHex = getStorageItem(SIGNATURE_STORAGE_KEY);
+  if (!keyHex) {
+    throw new Error("Encryption key not found. Please sign in first.");
+  }
+  const keyBytes = hexToBytes(keyHex);
+  return crypto.subtle.importKey(
+    "raw",
+    keyBytes.buffer,
+    { name: "AES-GCM" },
+    false,
+    ["encrypt", "decrypt"]
+  );
+}
+async function encryptData(plaintext) {
+  const key = await getEncryptionKey();
+  const plaintextBytes = typeof plaintext === "string" ? new TextEncoder().encode(plaintext) : plaintext;
+  const iv = crypto.getRandomValues(new Uint8Array(12));
+  const encryptedData = await crypto.subtle.encrypt(
+    {
+      name: "AES-GCM",
+      iv
+    },
+    key,
+    plaintextBytes.buffer
+  );
+  const encryptedBytes = new Uint8Array(encryptedData);
+  const combined = new Uint8Array(iv.length + encryptedBytes.length);
+  combined.set(iv, 0);
+  combined.set(encryptedBytes, iv.length);
+  return bytesToHex(combined);
+}
+async function decryptData(encryptedHex) {
+  const key = await getEncryptionKey();
+  const combined = hexToBytes(encryptedHex);
+  const iv = combined.slice(0, 12);
+  const encryptedData = combined.slice(12);
+  const decryptedData = await crypto.subtle.decrypt(
+    {
+      name: "AES-GCM",
+      iv
+    },
+    key,
+    encryptedData
+  );
+  return new TextDecoder().decode(decryptedData);
+}
+async function decryptDataBytes(encryptedHex) {
+  const key = await getEncryptionKey();
+  const combined = hexToBytes(encryptedHex);
+  const iv = combined.slice(0, 12);
+  const encryptedData = combined.slice(12);
+  const decryptedData = await crypto.subtle.decrypt(
+    {
+      name: "AES-GCM",
+      iv
+    },
+    key,
+    encryptedData
+  );
+  return new Uint8Array(decryptedData);
+}
+function useEncryption(authenticated) {
+  const { signMessage } = useSignMessage();
+  const { wallets } = useWallets();
+  const hasRequestedSignature = useRef2(false);
+  const hasCheckedStorage = useRef2(false);
+  useEffect2(() => {
+    if (!authenticated || wallets.length === 0) {
+      return;
+    }
+    const existingKey = getStorageItem(SIGNATURE_STORAGE_KEY);
+    if (existingKey) {
+      if (!hasCheckedStorage.current) {
+        hasCheckedStorage.current = true;
+      }
+      return;
+    }
+    const requestSignature = async () => {
+      if (!hasRequestedSignature.current) {
+        hasRequestedSignature.current = true;
+        try {
+          const { signature } = await signMessage(
+            { message: SIGN_MESSAGE },
+            {
+              address: wallets[0].address
+            }
+          );
+          const encryptionKey = await deriveKeyFromSignature(signature);
+          const stored = setStorageItem(SIGNATURE_STORAGE_KEY, encryptionKey);
+          if (!stored) {
+            throw new Error("Failed to store encryption key in localStorage");
+          }
+        } catch (error) {
+          hasRequestedSignature.current = false;
+        }
+      }
+    };
+    requestSignature();
+  }, [
+    authenticated,
+    wallets.length > 0 ? wallets[0]?.address : null,
+    signMessage
+  ]);
+  useEffect2(() => {
+    if (!authenticated) {
+      hasRequestedSignature.current = false;
+      hasCheckedStorage.current = false;
+    }
+  }, [authenticated]);
+}
+
 // src/react/useMemory.ts
-import { useCallback as useCallback2, useRef as useRef2 } from "react";
+import { useCallback as useCallback2, useRef as useRef3 } from "react";
 import { postApiV1ChatCompletions } from "@reverbia/sdk";
 
 // src/lib/memory/service.ts
@@ -1301,7 +1459,7 @@ function useMemory(options = {}) {
     onFactsExtracted,
     getToken
   } = options;
-  const extractionInProgressRef = useRef2(false);
+  const extractionInProgressRef = useRef3(false);
   const extractMemoriesFromMessage = useCallback2(
     async (options2) => {
       const { messages, model } = options2;
@@ -1572,8 +1730,12 @@ var extractConversationContext = (messages, maxMessages = 3) => {
 };
 export {
   createMemoryContextSystemMessage,
+  decryptData,
+  decryptDataBytes,
+  encryptData,
   extractConversationContext,
   formatMemoriesForChat,
   useChat,
+  useEncryption,
   useMemory
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reverbia/sdk",
-  "version": "1.0.0-next.20251125084024",
+  "version": "1.0.0-next.20251125084053",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -55,6 +55,7 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "0.87.2",
+    "@privy-io/react-auth": "^3.7.0",
     "@types/react": "^19.2.6",
     "tsup": "^8.5.1",
     "typedoc": "^0.28.14",
@@ -63,6 +64,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
+    "@privy-io/react-auth": "^3.7.0",
     "dexie": "^4.2.1",
     "react": "^18.0.0 || ^19.0.0"
   }