@cmdoss/memwal-sdk 0.6.0

package/dist/ai-sdk/types.d.ts

@@ -0,0 +1,336 @@
+/**
+ * AI SDK Integration Types
+ *
+ * Type definitions for the PDW Vector Store adapter designed for
+ * seamless integration with Vercel AI SDK and other AI frameworks.
+ *
+ * Provides a familiar API similar to Pinecone/Chroma while leveraging
+ * PDW's full capabilities: Walrus storage, Sui blockchain, knowledge graphs,
+ * and optional SEAL encryption.
+ *
+ * @module ai-sdk/types
+ */
+import type { SuiClient } from '@mysten/sui/client';
+import type { Signer } from '@mysten/sui/cryptography';
+import type { SealService } from '../infrastructure/seal/SealService';
+/**
+ * Configuration for initializing PDWVectorStore
+ */
+export interface PDWVectorStoreConfig {
+    /**
+     * Walrus storage configuration
+     */
+    walrus: {
+        /** Walrus aggregator URL for reading blobs */
+        aggregator: string;
+        /** Walrus publisher URL for writing blobs (optional, defaults to aggregator) */
+        publisher?: string;
+    };
+    /**
+     * Sui blockchain configuration
+     */
+    sui: {
+        /** Network to use: 'testnet', 'mainnet', or 'devnet' */
+        network: 'testnet' | 'mainnet' | 'devnet';
+        /** PDW package ID deployed on Sui */
+        packageId: string;
+        /** Optional: Pre-configured SuiClient (created automatically if not provided) */
+        client?: SuiClient;
+    };
+    /**
+     * User identity and signing
+     */
+    signer: Signer;
+    userAddress: string;
+    /**
+     * Vector configuration
+     */
+    dimensions: number;
+    distanceMetric?: 'cosine' | 'euclidean' | 'ip';
+    /**
+     * Optional features
+     */
+    features?: {
+        /** Enable SEAL encryption for stored content (default: false) */
+        encryption?: boolean;
+        /** Automatically extract knowledge graphs from text (default: true) */
+        extractKnowledgeGraph?: boolean;
+        /** Enable batch processing for better performance (default: true) */
+        enableBatching?: boolean;
+    };
+    /**
+     * Optional: SEAL encryption service (required if features.encryption = true)
+     */
+    sealService?: SealService;
+    /**
+     * Optional: Gemini API key for knowledge graph extraction
+     * (required if features.extractKnowledgeGraph = true)
+     */
+    geminiApiKey?: string;
+    /**
+     * Storage configuration
+     */
+    storage?: {
+        /** Number of epochs to store data on Walrus (default: 3) */
+        epochs?: number;
+        /** Enable deletable blobs (default: true) */
+        deletable?: boolean;
+    };
+    /**
+     * Index configuration
+     */
+    index?: {
+        /** HNSW ef construction parameter (default: 200) */
+        efConstruction?: number;
+        /** HNSW M parameter (default: 16) */
+        M?: number;
+        /** Max elements in index (default: 10000) */
+        maxElements?: number;
+    };
+}
+/**
+ * Parameters for adding a vector to the store
+ */
+export interface AddVectorParams {
+    /** Unique identifier for this vector/document */
+    id: string;
+    /** The embedding vector (from AI SDK or any embedding provider) */
+    vector: number[];
+    /** Original text content that was embedded */
+    text: string;
+    /** Optional metadata for filtering and retrieval */
+    metadata?: Record<string, any>;
+    /** Optional: Category for organization (default: 'general') */
+    category?: string;
+    /** Optional: Importance score 1-10 (default: 5) */
+    importance?: number;
+    /** Optional: Topic/tag for grouping */
+    topic?: string;
+}
+/**
+ * Batch add parameters for multiple vectors
+ */
+export interface AddVectorBatchParams {
+    vectors: AddVectorParams[];
+    /** Optional: Progress callback for batch operations */
+    onProgress?: (progress: {
+        current: number;
+        total: number;
+        stage: 'uploading' | 'indexing' | 'blockchain';
+        message: string;
+    }) => void;
+}
+/**
+ * Parameters for searching vectors
+ */
+export interface SearchParams {
+    /** Query embedding vector */
+    vector: number[];
+    /** Number of results to return (default: 5) */
+    limit?: number;
+    /** Metadata filters (AND logic) */
+    filters?: {
+        category?: string | string[];
+        topic?: string | string[];
+        importance?: {
+            min?: number;
+            max?: number;
+        };
+        tags?: string[];
+        [key: string]: any;
+    };
+    /** Minimum similarity score (0-1, default: 0) */
+    minScore?: number;
+    /** Include related entities from knowledge graph (default: false) */
+    includeGraph?: boolean;
+    /** Include full text content in results (default: true) */
+    includeContent?: boolean;
+}
+/**
+ * Search result item
+ */
+export interface SearchResult {
+    /** Document ID */
+    id: string;
+    /** Original text content (if includeContent = true) */
+    text: string;
+    /** Metadata associated with this vector */
+    metadata: Record<string, any>;
+    /** Similarity score (0-1, higher is more similar) */
+    score: number;
+    /** Distance from query vector (lower is more similar) */
+    distance: number;
+    /** Walrus blob ID for the stored content */
+    blobId: string;
+    /** Sui transaction digest for blockchain record */
+    txDigest?: string;
+    /** Related entities from knowledge graph (if includeGraph = true) */
+    relatedEntities?: Array<{
+        id: string;
+        name: string;
+        type: string;
+        confidence: number;
+    }>;
+    /** Related relationships (if includeGraph = true) */
+    relatedRelationships?: Array<{
+        source: string;
+        target: string;
+        type: string;
+        confidence: number;
+    }>;
+}
+/**
+ * Result from adding a vector
+ */
+export interface AddVectorResult {
+    /** Document ID */
+    id: string;
+    /** Walrus blob ID */
+    blobId: string;
+    /** Sui transaction digest */
+    txDigest: string;
+    /** Vector ID in HNSW index */
+    vectorId: number;
+    /** Whether knowledge graph was extracted */
+    graphExtracted: boolean;
+    /** Whether content was encrypted */
+    encrypted: boolean;
+    /** Upload time in milliseconds */
+    uploadTimeMs: number;
+}
+/**
+ * Result from batch add operation
+ */
+export interface AddVectorBatchResult {
+    /** Successfully added vectors */
+    successful: AddVectorResult[];
+    /** Failed vectors with error messages */
+    failed: Array<{
+        id: string;
+        error: string;
+    }>;
+    /** Total processing time in milliseconds */
+    totalTimeMs: number;
+    /** Quilt ID if batch was uploaded as a Walrus Quilt */
+    quiltId?: string;
+}
+/**
+ * Parameters for retrieving a vector by ID
+ */
+export interface GetVectorParams {
+    /** Document ID to retrieve */
+    id: string;
+    /** Include full text content (default: true) */
+    includeContent?: boolean;
+    /** Include knowledge graph data (default: false) */
+    includeGraph?: boolean;
+}
+/**
+ * Result from getting a vector by ID
+ */
+export interface GetVectorResult {
+    /** Document ID */
+    id: string;
+    /** The embedding vector */
+    vector: number[];
+    /** Original text content */
+    text: string;
+    /** Metadata */
+    metadata: Record<string, any>;
+    /** Walrus blob ID */
+    blobId: string;
+    /** Knowledge graph data (if includeGraph = true) */
+    graph?: {
+        entities: Array<{
+            id: string;
+            name: string;
+            type: string;
+            confidence: number;
+        }>;
+        relationships: Array<{
+            source: string;
+            target: string;
+            type: string;
+            confidence: number;
+        }>;
+    };
+    /** Whether content is encrypted */
+    encrypted: boolean;
+    /** Timestamp when created */
+    createdAt: number;
+}
+/**
+ * Parameters for deleting vectors
+ */
+export interface DeleteVectorParams {
+    /** Document IDs to delete */
+    ids: string[];
+}
+/**
+ * Result from delete operation
+ */
+export interface DeleteVectorResult {
+    /** Successfully deleted IDs */
+    deleted: string[];
+    /** Failed deletions with error messages */
+    failed: Array<{
+        id: string;
+        error: string;
+    }>;
+}
+/**
+ * Statistics about the vector store
+ */
+export interface VectorStoreStats {
+    /** Total number of vectors stored */
+    totalVectors: number;
+    /** Total storage used in bytes */
+    storageBytes: number;
+    /** Number of blockchain transactions */
+    blockchainTxCount: number;
+    /** Knowledge graph statistics */
+    graph?: {
+        totalEntities: number;
+        totalRelationships: number;
+        entityTypes: Record<string, number>;
+        relationshipTypes: Record<string, number>;
+    };
+    /** Index statistics */
+    index: {
+        dimensions: number;
+        distanceMetric: string;
+        indexSize: number;
+    };
+}
+/**
+ * Progress callback for long-running operations
+ */
+export interface ProgressCallback {
+    (progress: {
+        stage: 'embedding' | 'encrypting' | 'uploading' | 'blockchain' | 'indexing' | 'graph';
+        message: string;
+        percent: number;
+        current?: number;
+        total?: number;
+    }): void;
+}
+/**
+ * Error types for PDW operations
+ */
+export declare enum PDWErrorType {
+    NETWORK_ERROR = "NETWORK_ERROR",
+    STORAGE_ERROR = "STORAGE_ERROR",
+    BLOCKCHAIN_ERROR = "BLOCKCHAIN_ERROR",
+    ENCRYPTION_ERROR = "ENCRYPTION_ERROR",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    INDEX_ERROR = "INDEX_ERROR"
+}
+/**
+ * Custom error class for PDW operations
+ */
+export declare class PDWVectorStoreError extends Error {
+    type: PDWErrorType;
+    originalError?: Error | undefined;
+    constructor(type: PDWErrorType, message: string, originalError?: Error | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ai-sdk/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai-sdk/types.ts"],"names":[],"mappings":"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"}

package/dist/ai-sdk/types.js

@@ -0,0 +1,36 @@
+/**
+ * AI SDK Integration Types
+ *
+ * Type definitions for the PDW Vector Store adapter designed for
+ * seamless integration with Vercel AI SDK and other AI frameworks.
+ *
+ * Provides a familiar API similar to Pinecone/Chroma while leveraging
+ * PDW's full capabilities: Walrus storage, Sui blockchain, knowledge graphs,
+ * and optional SEAL encryption.
+ *
+ * @module ai-sdk/types
+ */
+/**
+ * Error types for PDW operations
+ */
+export var PDWErrorType;
+(function (PDWErrorType) {
+    PDWErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
+    PDWErrorType["STORAGE_ERROR"] = "STORAGE_ERROR";
+    PDWErrorType["BLOCKCHAIN_ERROR"] = "BLOCKCHAIN_ERROR";
+    PDWErrorType["ENCRYPTION_ERROR"] = "ENCRYPTION_ERROR";
+    PDWErrorType["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    PDWErrorType["INDEX_ERROR"] = "INDEX_ERROR";
+})(PDWErrorType || (PDWErrorType = {}));
+/**
+ * Custom error class for PDW operations
+ */
+export class PDWVectorStoreError extends Error {
+    constructor(type, message, originalError) {
+        super(message);
+        this.type = type;
+        this.originalError = originalError;
+        this.name = 'PDWVectorStoreError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/ai-sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ai-sdk/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgXH;;GAEG;AACH,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,+CAA+B,CAAA;IAC/B,+CAA+B,CAAA;IAC/B,qDAAqC,CAAA;IACrC,qDAAqC,CAAA;IACrC,qDAAqC,CAAA;IACrC,2CAA2B,CAAA;AAC7B,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YACS,IAAkB,EACzB,OAAe,EACR,aAAqB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAc;QAElB,kBAAa,GAAb,aAAa,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/api/client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * API Client for Personal Data Wallet Backend
+ *
+ * Handles HTTP communication with the NestJS backend API
+ */
+import type { APIResponse, MemoryCreateOptions, MemorySearchOptions, MemorySearchResult, MemoryContext, MemoryContextOptions, ChatOptions, ChatSession, CreateSessionOptions, MemoryStatsResponse } from '../types';
+import type { BatchStats } from '../core';
+export declare class PDWApiClient {
+    private baseUrl;
+    private headers;
+    get baseURL(): string;
+    get defaultHeaders(): Record<string, string>;
+    constructor(apiUrl: string);
+    private request;
+    createMemory(options: MemoryCreateOptions): Promise<APIResponse<{
+        memoryId: string;
+    }>>;
+    getUserMemories(userAddress: string): Promise<APIResponse<{
+        memories: MemorySearchResult[];
+    }>>;
+    searchMemories(options: MemorySearchOptions): Promise<APIResponse<{
+        results: MemorySearchResult[];
+    }>>;
+    getMemoryContext(options: MemoryContextOptions): Promise<APIResponse<MemoryContext>>;
+    getMemoryStats(userAddress: string): Promise<APIResponse<MemoryStatsResponse>>;
+    deleteMemory(memoryId: string, userAddress: string): Promise<APIResponse<void>>;
+    getBatchStats(): Promise<APIResponse<BatchStats>>;
+    getChatSessions(userAddress: string): Promise<APIResponse<{
+        sessions: ChatSession[];
+    }>>;
+    getChatSession(sessionId: string, userAddress: string): Promise<APIResponse<ChatSession>>;
+    createChatSession(options: CreateSessionOptions): Promise<APIResponse<ChatSession>>;
+    deleteChatSession(sessionId: string, userAddress: string): Promise<APIResponse<void>>;
+    sendChatMessage(options: ChatOptions): Promise<APIResponse<any>>;
+    updateChatSessionTitle(sessionId: string, userAddress: string, title: string): Promise<APIResponse<void>>;
+    addMessageToSession(sessionId: string, content: string, type: string, userAddress: string): Promise<APIResponse<void>>;
+    saveChatSummary(sessionId: string, summary: string, userAddress: string): Promise<APIResponse<void>>;
+    /**
+     * Create EventSource for streaming chat responses
+     */
+    createChatStream(options: ChatOptions): EventSource;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAyB;IAExC,IAAI,OAAO,WAA2B;IACtC,IAAI,cAAc,2BAA2B;gBAEjC,MAAM,EAAE,MAAM;YAOZ,OAAO;IAwBf,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IActF,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC,CAAC;IAI9F,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC,CAAC;IAOrG,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAOpF,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAI9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAO/E,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAMjD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,CAAC;IAIvF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAIzF,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAOnF,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAOrF,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAchE,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAOzG,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAOtH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAO1G;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW;CAYpD"}

package/dist/api/client.js

@@ -0,0 +1,136 @@
+/**
+ * API Client for Personal Data Wallet Backend
+ *
+ * Handles HTTP communication with the NestJS backend API
+ */
+export class PDWApiClient {
+    get baseURL() { return this.baseUrl; }
+    get defaultHeaders() { return this.headers; }
+    constructor(apiUrl) {
+        this.baseUrl = apiUrl.endsWith('/') ? apiUrl.slice(0, -1) : apiUrl;
+        this.headers = {
+            'Content-Type': 'application/json',
+        };
+    }
+    async request(endpoint, options = {}) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                ...this.headers,
+                ...options.headers,
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API request failed: ${response.status} ${errorText}`);
+        }
+        return response.json();
+    }
+    // ==================== MEMORY API ====================
+    async createMemory(options) {
+        return this.request('/memories', {
+            method: 'POST',
+            body: JSON.stringify({
+                content: options.content,
+                category: options.category,
+                userAddress: options.userAddress,
+                topic: options.topic,
+                importance: options.importance,
+                customMetadata: options.customMetadata,
+            }),
+        });
+    }
+    async getUserMemories(userAddress) {
+        return this.request(`/memories?user=${encodeURIComponent(userAddress)}`);
+    }
+    async searchMemories(options) {
+        return this.request('/memories/search', {
+            method: 'POST',
+            body: JSON.stringify(options),
+        });
+    }
+    async getMemoryContext(options) {
+        return this.request('/memories/context', {
+            method: 'POST',
+            body: JSON.stringify(options),
+        });
+    }
+    async getMemoryStats(userAddress) {
+        return this.request(`/memories/stats?userAddress=${encodeURIComponent(userAddress)}`);
+    }
+    async deleteMemory(memoryId, userAddress) {
+        return this.request(`/memories/${memoryId}`, {
+            method: 'DELETE',
+            body: JSON.stringify({ userAddress }),
+        });
+    }
+    async getBatchStats() {
+        return this.request('/memories/batch-stats');
+    }
+    // ==================== CHAT API ====================
+    async getChatSessions(userAddress) {
+        return this.request(`/chat/sessions?userAddress=${encodeURIComponent(userAddress)}`);
+    }
+    async getChatSession(sessionId, userAddress) {
+        return this.request(`/chat/sessions/${sessionId}?userAddress=${encodeURIComponent(userAddress)}`);
+    }
+    async createChatSession(options) {
+        return this.request('/chat/sessions', {
+            method: 'POST',
+            body: JSON.stringify(options),
+        });
+    }
+    async deleteChatSession(sessionId, userAddress) {
+        return this.request(`/chat/sessions/${sessionId}`, {
+            method: 'DELETE',
+            body: JSON.stringify({ userAddress }),
+        });
+    }
+    async sendChatMessage(options) {
+        return this.request('/chat', {
+            method: 'POST',
+            body: JSON.stringify({
+                text: options.text,
+                userId: options.userId,
+                sessionId: options.sessionId,
+                model: options.model,
+                userAddress: options.userAddress,
+                memoryContext: options.memoryContext,
+            }),
+        });
+    }
+    async updateChatSessionTitle(sessionId, userAddress, title) {
+        return this.request(`/chat/sessions/${sessionId}/title`, {
+            method: 'PUT',
+            body: JSON.stringify({ userAddress, title }),
+        });
+    }
+    async addMessageToSession(sessionId, content, type, userAddress) {
+        return this.request(`/chat/sessions/${sessionId}/messages`, {
+            method: 'POST',
+            body: JSON.stringify({ content, type, userAddress }),
+        });
+    }
+    async saveChatSummary(sessionId, summary, userAddress) {
+        return this.request('/chat/summary', {
+            method: 'POST',
+            body: JSON.stringify({ sessionId, summary, userAddress }),
+        });
+    }
+    /**
+     * Create EventSource for streaming chat responses
+     */
+    createChatStream(options) {
+        const params = new URLSearchParams({
+            text: options.text,
+            userId: options.userId,
+            ...(options.sessionId && { sessionId: options.sessionId }),
+            ...(options.model && { model: options.model }),
+            ...(options.userAddress && { userAddress: options.userAddress }),
+            ...(options.memoryContext && { memoryContext: options.memoryContext }),
+        });
+        return new EventSource(`${this.baseUrl}/chat/stream?${params.toString()}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}