@cmdoss/memwal-sdk 0.8.0 → 1.0.0

package/src/langchain/index.ts

@@ -1,47 +1,47 @@
-/**
- * LangChain Integration for Personal Data Wallet SDK
- *
- * Provides standard LangChain interfaces for PDW's decentralized storage,
- * SEAL encryption, and Sui blockchain integration.
- *
- * @module langchain
- *
- * @example
- * ```typescript
- * import { PDWEmbeddings, PDWVectorStore } from 'personal-data-wallet-sdk/langchain';
- *
- * // Initialize embeddings
- * const embeddings = new PDWEmbeddings({
- *   geminiApiKey: process.env.GEMINI_API_KEY!
- * });
- *
- * // Initialize vector store
- * const vectorStore = new PDWVectorStore(embeddings, {
- *   userAddress: '0x...',
- *   packageId: '0x...',
- *   walrusAggregator: 'https://...'
- * });
- *
- * // Use with LangChain
- * const results = await vectorStore.similaritySearch('query', 5);
- * ```
- */
-
-// Embeddings
-export { PDWEmbeddings } from './PDWEmbeddings';
-export type { PDWEmbeddingsParams } from './PDWEmbeddings';
-
-// VectorStore
-export { PDWVectorStore } from './PDWVectorStore';
-export type { PDWVectorStoreConfig, PDWAddDocumentOptions } from './PDWVectorStore';
-
-// RAG Helpers
-export {
-  createPDWRAG,
-  createPDWRAGWithSources,
-  createConversationalPDWRAG
-} from './createPDWRAG';
-export type {
-  PDWRAGConfig,
-  PDWRAGResult
-} from './createPDWRAG';
+/**
+ * LangChain Integration for Personal Data Wallet SDK
+ *
+ * Provides standard LangChain interfaces for PDW's decentralized storage,
+ * SEAL encryption, and Sui blockchain integration.
+ *
+ * @module langchain
+ *
+ * @example
+ * ```typescript
+ * import { PDWEmbeddings, PDWVectorStore } from 'personal-data-wallet-sdk/langchain';
+ *
+ * // Initialize embeddings
+ * const embeddings = new PDWEmbeddings({
+ *   geminiApiKey: process.env.GEMINI_API_KEY!
+ * });
+ *
+ * // Initialize vector store
+ * const vectorStore = new PDWVectorStore(embeddings, {
+ *   userAddress: '0x...',
+ *   packageId: '0x...',
+ *   walrusAggregator: 'https://...'
+ * });
+ *
+ * // Use with LangChain
+ * const results = await vectorStore.similaritySearch('query', 5);
+ * ```
+ */
+
+// Embeddings
+export { PDWEmbeddings } from './PDWEmbeddings';
+export type { PDWEmbeddingsParams } from './PDWEmbeddings';
+
+// VectorStore
+export { PDWVectorStore } from './PDWVectorStore';
+export type { PDWVectorStoreConfig, PDWAddDocumentOptions } from './PDWVectorStore';
+
+// RAG Helpers
+export {
+  createPDWRAG,
+  createPDWRAGWithSources,
+  createConversationalPDWRAG
+} from './createPDWRAG';
+export type {
+  PDWRAGConfig,
+  PDWRAGResult
+} from './createPDWRAG';

package/src/permissions/ConsentRepository.browser.ts

@@ -1,249 +1,249 @@
-/**
- * Browser-safe Consent Repository implementations
- *
- * This file contains only browser-compatible implementations.
- * FileSystemConsentRepository is excluded as it requires Node.js fs/promises.
- */
-
-import {
-  ConsentRequestRecord,
-  ConsentStatus,
-} from '../core/types/wallet.js';
-import { normalizeSuiAddress } from '@mysten/sui/utils';
-
-export interface ConsentRepository {
-  save(request: ConsentRequestRecord): Promise<void>;
-  updateStatus(requestId: string, status: ConsentStatus, updatedAt: number): Promise<void>;
-  getById(requestId: string): Promise<ConsentRequestRecord | null>;
-  listByTarget(targetWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]>;
-  listByRequester(requesterWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]>;
-  delete(requestId: string): Promise<void>;
-}
-
-interface StoredConsentRecord extends ConsentRequestRecord {}
-
-function normalizeRecord(record: ConsentRequestRecord): StoredConsentRecord {
-  return {
-    ...record,
-    requesterWallet: normalizeSuiAddress(record.requesterWallet),
-    targetWallet: normalizeSuiAddress(record.targetWallet),
-  };
-}
-
-export class InMemoryConsentRepository implements ConsentRepository {
-  private store = new Map<string, StoredConsentRecord>();
-
-  async save(request: ConsentRequestRecord): Promise<void> {
-    const normalized = normalizeRecord(request);
-    this.store.set(normalized.requestId, normalized);
-  }
-
-  async updateStatus(requestId: string, status: ConsentStatus, updatedAt: number): Promise<void> {
-    const record = this.store.get(requestId);
-    if (!record) {
-      return;
-    }
-    this.store.set(requestId, {
-      ...record,
-      status,
-      updatedAt,
-    });
-  }
-
-  async getById(requestId: string): Promise<ConsentRequestRecord | null> {
-    const record = this.store.get(requestId);
-    return record ? { ...record } : null;
-  }
-
-  async listByTarget(targetWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]> {
-    const normalizedTarget = normalizeSuiAddress(targetWallet);
-    return Array.from(this.store.values())
-      .filter((record) => record.targetWallet === normalizedTarget)
-      .filter((record) => (status ? record.status === status : true))
-      .map((record) => ({ ...record }));
-  }
-
-  async listByRequester(requesterWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]> {
-    const normalizedRequester = normalizeSuiAddress(requesterWallet);
-    return Array.from(this.store.values())
-      .filter((record) => record.requesterWallet === normalizedRequester)
-      .filter((record) => (status ? record.status === status : true))
-      .map((record) => ({ ...record }));
-  }
-
-  async delete(requestId: string): Promise<void> {
-    this.store.delete(requestId);
-  }
-}
-
-/**
- * IndexedDBConsentRepository - Browser-compatible implementation
- * Uses IndexedDB for persistent storage in browser environments.
- */
-export class IndexedDBConsentRepository implements ConsentRepository {
-  private dbName = 'pdw-consent-store';
-  private storeName = 'consent-requests';
-  private dbVersion = 1;
-  private db: IDBDatabase | null = null;
-
-  constructor(options?: { dbName?: string }) {
-    if (options?.dbName) {
-      this.dbName = options.dbName;
-    }
-  }
-
-  private async getDB(): Promise<IDBDatabase> {
-    if (this.db) {
-      return this.db;
-    }
-
-    return new Promise((resolve, reject) => {
-      const request = indexedDB.open(this.dbName, this.dbVersion);
-
-      request.onerror = () => reject(request.error);
-      request.onsuccess = () => {
-        this.db = request.result;
-        resolve(request.result);
-      };
-
-      request.onupgradeneeded = (event) => {
-        const db = (event.target as IDBOpenDBRequest).result;
-        if (!db.objectStoreNames.contains(this.storeName)) {
-          const store = db.createObjectStore(this.storeName, { keyPath: 'requestId' });
-          store.createIndex('targetWallet', 'targetWallet', { unique: false });
-          store.createIndex('requesterWallet', 'requesterWallet', { unique: false });
-          store.createIndex('status', 'status', { unique: false });
-        }
-      };
-    });
-  }
-
-  async save(request: ConsentRequestRecord): Promise<void> {
-    const db = await this.getDB();
-    const normalized = normalizeRecord(request);
-
-    return new Promise((resolve, reject) => {
-      const tx = db.transaction(this.storeName, 'readwrite');
-      const store = tx.objectStore(this.storeName);
-      const req = store.put(normalized);
-
-      req.onerror = () => reject(req.error);
-      req.onsuccess = () => resolve();
-    });
-  }
-
-  async updateStatus(requestId: string, status: ConsentStatus, updatedAt: number): Promise<void> {
-    const record = await this.getById(requestId);
-    if (!record) {
-      return;
-    }
-
-    await this.save({
-      ...record,
-      status,
-      updatedAt,
-    });
-  }
-
-  async getById(requestId: string): Promise<ConsentRequestRecord | null> {
-    const db = await this.getDB();
-
-    return new Promise((resolve, reject) => {
-      const tx = db.transaction(this.storeName, 'readonly');
-      const store = tx.objectStore(this.storeName);
-      const req = store.get(requestId);
-
-      req.onerror = () => reject(req.error);
-      req.onsuccess = () => {
-        const record = req.result as StoredConsentRecord | undefined;
-        resolve(record ? { ...record } : null);
-      };
-    });
-  }
-
-  async listByTarget(targetWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]> {
-    const normalizedTarget = normalizeSuiAddress(targetWallet);
-    const db = await this.getDB();
-
-    return new Promise((resolve, reject) => {
-      const tx = db.transaction(this.storeName, 'readonly');
-      const store = tx.objectStore(this.storeName);
-      const index = store.index('targetWallet');
-      const req = index.getAll(normalizedTarget);
-
-      req.onerror = () => reject(req.error);
-      req.onsuccess = () => {
-        let records = req.result as StoredConsentRecord[];
-        if (status) {
-          records = records.filter((r) => r.status === status);
-        }
-        resolve(records.map((r) => ({ ...r })));
-      };
-    });
-  }
-
-  async listByRequester(requesterWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]> {
-    const normalizedRequester = normalizeSuiAddress(requesterWallet);
-    const db = await this.getDB();
-
-    return new Promise((resolve, reject) => {
-      const tx = db.transaction(this.storeName, 'readonly');
-      const store = tx.objectStore(this.storeName);
-      const index = store.index('requesterWallet');
-      const req = index.getAll(normalizedRequester);
-
-      req.onerror = () => reject(req.error);
-      req.onsuccess = () => {
-        let records = req.result as StoredConsentRecord[];
-        if (status) {
-          records = records.filter((r) => r.status === status);
-        }
-        resolve(records.map((r) => ({ ...r })));
-      };
-    });
-  }
-
-  async delete(requestId: string): Promise<void> {
-    const db = await this.getDB();
-
-    return new Promise((resolve, reject) => {
-      const tx = db.transaction(this.storeName, 'readwrite');
-      const store = tx.objectStore(this.storeName);
-      const req = store.delete(requestId);
-
-      req.onerror = () => reject(req.error);
-      req.onsuccess = () => resolve();
-    });
-  }
-
-  /**
-   * Close the database connection
-   */
-  close(): void {
-    if (this.db) {
-      this.db.close();
-      this.db = null;
-    }
-  }
-}
-
-/**
- * Factory function to create the appropriate ConsentRepository for browser
- */
-export function createBrowserConsentRepository(options?: {
-  dbName?: string;
-  forceInMemory?: boolean;
-}): ConsentRepository {
-  // Force in-memory for testing
-  if (options?.forceInMemory) {
-    return new InMemoryConsentRepository();
-  }
-
-  // Browser environment - use IndexedDB
-  if (typeof window !== 'undefined' && typeof indexedDB !== 'undefined') {
-    return new IndexedDBConsentRepository({ dbName: options?.dbName });
-  }
-
-  // Fallback to in-memory
-  return new InMemoryConsentRepository();
-}
+/**
+ * Browser-safe Consent Repository implementations
+ *
+ * This file contains only browser-compatible implementations.
+ * FileSystemConsentRepository is excluded as it requires Node.js fs/promises.
+ */
+
+import {
+  ConsentRequestRecord,
+  ConsentStatus,
+} from '../core/types/wallet.js';
+import { normalizeSuiAddress } from '@mysten/sui/utils';
+
+export interface ConsentRepository {
+  save(request: ConsentRequestRecord): Promise<void>;
+  updateStatus(requestId: string, status: ConsentStatus, updatedAt: number): Promise<void>;
+  getById(requestId: string): Promise<ConsentRequestRecord | null>;
+  listByTarget(targetWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]>;
+  listByRequester(requesterWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]>;
+  delete(requestId: string): Promise<void>;
+}
+
+interface StoredConsentRecord extends ConsentRequestRecord {}
+
+function normalizeRecord(record: ConsentRequestRecord): StoredConsentRecord {
+  return {
+    ...record,
+    requesterWallet: normalizeSuiAddress(record.requesterWallet),
+    targetWallet: normalizeSuiAddress(record.targetWallet),
+  };
+}
+
+export class InMemoryConsentRepository implements ConsentRepository {
+  private store = new Map<string, StoredConsentRecord>();
+
+  async save(request: ConsentRequestRecord): Promise<void> {
+    const normalized = normalizeRecord(request);
+    this.store.set(normalized.requestId, normalized);
+  }
+
+  async updateStatus(requestId: string, status: ConsentStatus, updatedAt: number): Promise<void> {
+    const record = this.store.get(requestId);
+    if (!record) {
+      return;
+    }
+    this.store.set(requestId, {
+      ...record,
+      status,
+      updatedAt,
+    });
+  }
+
+  async getById(requestId: string): Promise<ConsentRequestRecord | null> {
+    const record = this.store.get(requestId);
+    return record ? { ...record } : null;
+  }
+
+  async listByTarget(targetWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]> {
+    const normalizedTarget = normalizeSuiAddress(targetWallet);
+    return Array.from(this.store.values())
+      .filter((record) => record.targetWallet === normalizedTarget)
+      .filter((record) => (status ? record.status === status : true))
+      .map((record) => ({ ...record }));
+  }
+
+  async listByRequester(requesterWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]> {
+    const normalizedRequester = normalizeSuiAddress(requesterWallet);
+    return Array.from(this.store.values())
+      .filter((record) => record.requesterWallet === normalizedRequester)
+      .filter((record) => (status ? record.status === status : true))
+      .map((record) => ({ ...record }));
+  }
+
+  async delete(requestId: string): Promise<void> {
+    this.store.delete(requestId);
+  }
+}
+
+/**
+ * IndexedDBConsentRepository - Browser-compatible implementation
+ * Uses IndexedDB for persistent storage in browser environments.
+ */
+export class IndexedDBConsentRepository implements ConsentRepository {
+  private dbName = 'pdw-consent-store';
+  private storeName = 'consent-requests';
+  private dbVersion = 1;
+  private db: IDBDatabase | null = null;
+
+  constructor(options?: { dbName?: string }) {
+    if (options?.dbName) {
+      this.dbName = options.dbName;
+    }
+  }
+
+  private async getDB(): Promise<IDBDatabase> {
+    if (this.db) {
+      return this.db;
+    }
+
+    return new Promise((resolve, reject) => {
+      const request = indexedDB.open(this.dbName, this.dbVersion);
+
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => {
+        this.db = request.result;
+        resolve(request.result);
+      };
+
+      request.onupgradeneeded = (event) => {
+        const db = (event.target as IDBOpenDBRequest).result;
+        if (!db.objectStoreNames.contains(this.storeName)) {
+          const store = db.createObjectStore(this.storeName, { keyPath: 'requestId' });
+          store.createIndex('targetWallet', 'targetWallet', { unique: false });
+          store.createIndex('requesterWallet', 'requesterWallet', { unique: false });
+          store.createIndex('status', 'status', { unique: false });
+        }
+      };
+    });
+  }
+
+  async save(request: ConsentRequestRecord): Promise<void> {
+    const db = await this.getDB();
+    const normalized = normalizeRecord(request);
+
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(this.storeName, 'readwrite');
+      const store = tx.objectStore(this.storeName);
+      const req = store.put(normalized);
+
+      req.onerror = () => reject(req.error);
+      req.onsuccess = () => resolve();
+    });
+  }
+
+  async updateStatus(requestId: string, status: ConsentStatus, updatedAt: number): Promise<void> {
+    const record = await this.getById(requestId);
+    if (!record) {
+      return;
+    }
+
+    await this.save({
+      ...record,
+      status,
+      updatedAt,
+    });
+  }
+
+  async getById(requestId: string): Promise<ConsentRequestRecord | null> {
+    const db = await this.getDB();
+
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(this.storeName, 'readonly');
+      const store = tx.objectStore(this.storeName);
+      const req = store.get(requestId);
+
+      req.onerror = () => reject(req.error);
+      req.onsuccess = () => {
+        const record = req.result as StoredConsentRecord | undefined;
+        resolve(record ? { ...record } : null);
+      };
+    });
+  }
+
+  async listByTarget(targetWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]> {
+    const normalizedTarget = normalizeSuiAddress(targetWallet);
+    const db = await this.getDB();
+
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(this.storeName, 'readonly');
+      const store = tx.objectStore(this.storeName);
+      const index = store.index('targetWallet');
+      const req = index.getAll(normalizedTarget);
+
+      req.onerror = () => reject(req.error);
+      req.onsuccess = () => {
+        let records = req.result as StoredConsentRecord[];
+        if (status) {
+          records = records.filter((r) => r.status === status);
+        }
+        resolve(records.map((r) => ({ ...r })));
+      };
+    });
+  }
+
+  async listByRequester(requesterWallet: string, status?: ConsentStatus): Promise<ConsentRequestRecord[]> {
+    const normalizedRequester = normalizeSuiAddress(requesterWallet);
+    const db = await this.getDB();
+
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(this.storeName, 'readonly');
+      const store = tx.objectStore(this.storeName);
+      const index = store.index('requesterWallet');
+      const req = index.getAll(normalizedRequester);
+
+      req.onerror = () => reject(req.error);
+      req.onsuccess = () => {
+        let records = req.result as StoredConsentRecord[];
+        if (status) {
+          records = records.filter((r) => r.status === status);
+        }
+        resolve(records.map((r) => ({ ...r })));
+      };
+    });
+  }
+
+  async delete(requestId: string): Promise<void> {
+    const db = await this.getDB();
+
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(this.storeName, 'readwrite');
+      const store = tx.objectStore(this.storeName);
+      const req = store.delete(requestId);
+
+      req.onerror = () => reject(req.error);
+      req.onsuccess = () => resolve();
+    });
+  }
+
+  /**
+   * Close the database connection
+   */
+  close(): void {
+    if (this.db) {
+      this.db.close();
+      this.db = null;
+    }
+  }
+}
+
+/**
+ * Factory function to create the appropriate ConsentRepository for browser
+ */
+export function createBrowserConsentRepository(options?: {
+  dbName?: string;
+  forceInMemory?: boolean;
+}): ConsentRepository {
+  // Force in-memory for testing
+  if (options?.forceInMemory) {
+    return new InMemoryConsentRepository();
+  }
+
+  // Browser environment - use IndexedDB
+  if (typeof window !== 'undefined' && typeof indexedDB !== 'undefined') {
+    return new IndexedDBConsentRepository({ dbName: options?.dbName });
+  }
+
+  // Fallback to in-memory
+  return new InMemoryConsentRepository();
+}