@cmdoss/memwal-sdk 0.6.0

package/dist/aggregation/AggregationService.js

@@ -0,0 +1,225 @@
+/**
+ * AggregationService - Cross-app data query with permission filtering
+ *
+ * Enables querying data across multiple app contexts while respecting
+ * OAuth-style permissions and access control policies.
+ */
+import { normalizeSuiAddress } from '@mysten/sui/utils';
+/**
+ * AggregationService handles cross-app queries with permission filtering
+ */
+export class AggregationService {
+    constructor(config) {
+        this.suiClient = config.suiClient;
+        this.packageId = config.packageId;
+        this.permissionService = config.permissionService;
+        this.capabilityService = config.capabilityService;
+        this.contextWalletService = config.contextWalletService;
+    }
+    /**
+     * Query data across multiple app contexts with permission enforcement
+     * @param options - Query options
+     * @returns Aggregated query results
+     */
+    async query(options) {
+        const startTime = Date.now();
+        const result = {
+            results: [],
+            totalResults: 0,
+            queriedContexts: [],
+            skippedContexts: [],
+            metrics: {
+                queryTime: 0,
+                contextsChecked: 0,
+                permissionChecks: 0
+            }
+        };
+        const normalizedRequester = normalizeSuiAddress(options.requestingWallet);
+        const normalizedTargets = options.targetWallets?.map(id => id.toLowerCase());
+        const userContexts = await this.contextWalletService.listUserContexts(options.userAddress);
+        const candidateContexts = normalizedTargets?.length
+            ? userContexts.filter(ctx => {
+                const contextIdLower = ctx.contextId.toLowerCase();
+                const walletIdLower = ctx.id.toLowerCase();
+                return normalizedTargets.includes(contextIdLower) || normalizedTargets.includes(walletIdLower);
+            })
+            : userContexts;
+        result.metrics.contextsChecked = candidateContexts.length;
+        // Check permissions and query allowed contexts
+        for (const context of candidateContexts) {
+            try {
+                // Check if the requesting entity has permission to access this context
+                const hasPermission = await this.permissionService.hasWalletPermission(normalizedRequester, context.id, options.scope);
+                result.metrics.permissionChecks++;
+                if (!hasPermission) {
+                    result.skippedContexts.push(context.id);
+                    continue;
+                }
+                // Query data from this context
+                const perContextLimit = options.limit
+                    ? Math.ceil(options.limit / Math.max(candidateContexts.length, 1))
+                    : undefined;
+                const contextData = await this.contextWalletService.listData(context.id, {
+                    limit: perContextLimit
+                });
+                // Filter results based on query
+                const filteredData = this.filterDataByQuery(contextData, options.query);
+                if (filteredData.length > 0) {
+                    result.results.push({
+                        contextId: context.contextId,
+                        targetWallet: context.id,
+                        appId: context.appId,
+                        data: filteredData,
+                        hasMore: false // TODO: Implement pagination
+                    });
+                    result.totalResults += filteredData.length;
+                    result.queriedContexts.push(context.id);
+                }
+            }
+            catch (error) {
+                console.error(`Error querying context ${context.id}:`, error);
+                result.skippedContexts.push(context.id);
+            }
+        }
+        // Apply global limit if specified
+        if (options.limit && result.totalResults > options.limit) {
+            result.results = this.applyGlobalLimit(result.results, options.limit);
+            result.totalResults = options.limit;
+        }
+        result.metrics.queryTime = Date.now() - startTime;
+        return result;
+    }
+    /**
+     * Query with scope-based filtering
+     * @param userAddress - User address
+     * @param query - Search query
+     * @param scopes - Required permission scopes
+     * @returns Filtered aggregated results
+     */
+    async queryWithScopes(requestingWallet, userAddress, query, scopes) {
+        // Get all user contexts
+        const userContexts = await this.contextWalletService.listUserContexts(userAddress);
+        // Filter contexts by permission scopes
+        const allowedWallets = [];
+        for (const context of userContexts) {
+            let hasAllScopes = true;
+            for (const scope of scopes) {
+                const hasScope = await this.permissionService.hasWalletPermission(requestingWallet, context.id, scope);
+                if (!hasScope) {
+                    hasAllScopes = false;
+                    break;
+                }
+            }
+            if (hasAllScopes) {
+                allowedWallets.push(context.id);
+            }
+        }
+        return await this.query({
+            requestingWallet,
+            userAddress,
+            query,
+            scope: scopes[0],
+            targetWallets: allowedWallets
+        });
+    }
+    /**
+     * Get aggregated statistics across contexts
+     * @param userAddress - User address
+     * @param appIds - Apps to include in statistics
+     * @returns Aggregated statistics
+     */
+    async getAggregatedStats(userAddress, targetWallets) {
+        const stats = {
+            totalContexts: 0,
+            totalItems: 0,
+            totalSize: 0,
+            categoryCounts: {},
+            contextBreakdown: {},
+            appBreakdown: {}
+        };
+        for (const walletId of targetWallets) {
+            try {
+                const contextStats = await this.contextWalletService.getContextStats(walletId);
+                stats.totalContexts++;
+                stats.totalItems += contextStats.itemCount;
+                stats.totalSize += contextStats.totalSize;
+                // Merge category counts
+                for (const [category, count] of Object.entries(contextStats.categories)) {
+                    stats.categoryCounts[category] = (stats.categoryCounts[category] || 0) + count;
+                }
+                // Context breakdown
+                stats.contextBreakdown[walletId] = {
+                    items: contextStats.itemCount,
+                    size: contextStats.totalSize,
+                    lastActivity: contextStats.lastActivity
+                };
+                // Legacy alias
+                stats.appBreakdown[walletId] = {
+                    items: contextStats.itemCount,
+                    size: contextStats.totalSize,
+                    lastActivity: contextStats.lastActivity
+                };
+            }
+            catch (error) {
+                console.error(`Error getting stats for wallet ${walletId}:`, error);
+            }
+        }
+        return stats;
+    }
+    /**
+     * Search across contexts with permission validation
+     * @param userAddress - User address
+     * @param searchQuery - Search query
+     * @param options - Search options
+     * @returns Search results
+     */
+    async search(requestingWallet, userAddress, searchQuery, options) {
+        const targetWallets = options?.targetWallets ? [...options.targetWallets] : [];
+        // If no contexts specified, get all user contexts
+        if (targetWallets.length === 0) {
+            const userContexts = await this.contextWalletService.listUserContexts(userAddress);
+            targetWallets.push(...userContexts.map(c => c.id));
+        }
+        return await this.query({
+            requestingWallet,
+            userAddress,
+            query: searchQuery,
+            scope: options?.minPermissionScope || 'read:memories',
+            limit: options?.limit,
+            targetWallets
+        });
+    }
+    /**
+     * Filter data by search query
+     * @private
+     */
+    filterDataByQuery(data, query) {
+        if (!query)
+            return data;
+        const lowerQuery = query.toLowerCase();
+        return data.filter(item => item.content.toLowerCase().includes(lowerQuery) ||
+            item.category?.toLowerCase().includes(lowerQuery) ||
+            Object.values(item.metadata || {}).some(value => String(value).toLowerCase().includes(lowerQuery)));
+    }
+    /**
+     * Apply global result limit across contexts
+     * @private
+     */
+    applyGlobalLimit(results, limit) {
+        let totalCount = 0;
+        const limitedResults = [];
+        for (const result of results) {
+            if (totalCount >= limit)
+                break;
+            const remainingLimit = limit - totalCount;
+            const limitedData = result.data.slice(0, remainingLimit);
+            limitedResults.push({
+                ...result,
+                data: limitedData
+            });
+            totalCount += limitedData.length;
+        }
+        return limitedResults;
+    }
+}
+//# sourceMappingURL=AggregationService.js.map

package/dist/aggregation/AggregationService.js.map

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

package/dist/aggregation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Aggregation Module
+ *
+ * Cross-app data query with permission filtering.
+ */
+export { AggregationService } from './AggregationService';
+export type { AggregationServiceConfig } from './AggregationService';
+//# sourceMappingURL=index.d.ts.map

package/dist/aggregation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/aggregation/index.js

@@ -0,0 +1,7 @@
+/**
+ * Aggregation Module
+ *
+ * Cross-app data query with permission filtering.
+ */
+export { AggregationService } from './AggregationService.js';
+//# sourceMappingURL=index.js.map

package/dist/aggregation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,124 @@
+/**
+ * PDWVectorStore - AI SDK Integration
+ *
+ * A vector store implementation designed for Vercel AI SDK and other AI frameworks.
+ * Provides a familiar API (similar to Pinecone/Chroma) while leveraging PDW's full
+ * capabilities: Walrus decentralized storage, Sui blockchain, knowledge graphs,
+ * and optional SEAL encryption.
+ *
+ * @module ai-sdk/PDWVectorStore
+ *
+ * @example
+ * ```typescript
+ * import { embed } from 'ai';
+ * import { PDWVectorStore } from 'pdw-sdk/ai-sdk';
+ *
+ * const store = new PDWVectorStore(config);
+ * await store.initialize();
+ *
+ * // Add vector from AI SDK
+ * const { embedding } = await embed({ model, value: text });
+ * await store.add({ id, vector: embedding, text });
+ *
+ * // Search
+ * const results = await store.search(queryVector, { limit: 5 });
+ * ```
+ */
+import type { PDWVectorStoreConfig, AddVectorParams, AddVectorBatchParams, SearchParams, SearchResult, AddVectorResult, AddVectorBatchResult, GetVectorParams, GetVectorResult, DeleteVectorParams, DeleteVectorResult, VectorStoreStats, PDWErrorType, PDWVectorStoreError as PDWVectorStoreErrorType } from './types';
+/**
+ * Custom error class for PDW Vector Store operations
+ */
+export declare class PDWVectorStoreError extends Error implements PDWVectorStoreErrorType {
+    type: PDWErrorType;
+    originalError?: Error | undefined;
+    constructor(type: PDWErrorType, message: string, originalError?: Error | undefined);
+}
+/**
+ * PDW Vector Store - Full-featured vector database with decentralized storage
+ */
+export declare class PDWVectorStore {
+    private config;
+    private storageService;
+    private vectorService;
+    private vectorServicePromise;
+    private graphService?;
+    private embeddingService?;
+    private suiClient;
+    private initialized;
+    private initPromise;
+    private vectorIdMap;
+    constructor(config: PDWVectorStoreConfig);
+    /**
+     * Get vector service (waits for initialization if needed)
+     */
+    private getVectorService;
+    /**
+     * Initialize the vector store (HNSW service creation, index setup)
+     */
+    private initialize;
+    /**
+     * Initialize knowledge graph service
+     */
+    private initializeGraphService;
+    /**
+     * Wait for initialization to complete
+     */
+    private ensureInitialized;
+    /**
+     * Add a vector with text and metadata to the store
+     *
+     * Performs full PDW pipeline:
+     * 1. Optional: Encrypt content with SEAL
+     * 2. Upload to Walrus decentralized storage
+     * 3. Register on Sui blockchain
+     * 4. Index vector in HNSW
+     * 5. Optional: Extract knowledge graph
+     *
+     * @param params - Vector parameters
+     * @returns Result with blob ID, transaction digest, and vector ID
+     */
+    add(params: AddVectorParams): Promise<AddVectorResult>;
+    /**
+     * Add multiple vectors in batch
+     *
+     * @param params - Batch parameters with progress callback
+     * @returns Batch result with successful and failed items
+     */
+    addBatch(params: AddVectorBatchParams): Promise<AddVectorBatchResult>;
+    /**
+     * Search for similar vectors
+     *
+     * @param params - Search parameters
+     * @returns Array of search results sorted by similarity
+     */
+    search(params: SearchParams): Promise<SearchResult[]>;
+    /**
+     * Get a vector by ID
+     *
+     * @param params - Get parameters
+     * @returns Vector data with metadata
+     */
+    get(params: GetVectorParams): Promise<GetVectorResult | null>;
+    /**
+     * Delete vectors by IDs
+     *
+     * @param params - Delete parameters
+     * @returns Delete result
+     */
+    delete(params: DeleteVectorParams): Promise<DeleteVectorResult>;
+    /**
+     * Get statistics about the vector store
+     *
+     * @returns Store statistics
+     */
+    stats(): Promise<VectorStoreStats>;
+    /**
+     * Helper: Hash string to numeric ID
+     */
+    private hashString;
+    /**
+     * Helper: Check if a value matches a filter
+     */
+    private matchesFilter;
+}
+//# sourceMappingURL=PDWVectorStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PDWVectorStore.d.ts","sourceRoot":"","sources":["../../src/ai-sdk/PDWVectorStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAQH,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,IAAI,uBAAuB,EAC/C,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAM,YAAW,uBAAuB;IAEtE,IAAI,EAAE,YAAY;IAElB,aAAa,CAAC,EAAE,KAAK;gBAFrB,IAAI,EAAE,YAAY,EACzB,OAAO,EAAE,MAAM,EACR,aAAa,CAAC,EAAE,KAAK,YAAA;CAK/B;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,oBAAoB,CAAsC;IAClE,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,WAAW,CAA8B;IAGjD,OAAO,CAAC,WAAW,CAAgE;gBAEvE,MAAM,EAAE,oBAAoB;IA4CxC;;OAEG;YACW,gBAAgB;IAU9B;;OAEG;YACW,UAAU;IAwCxB;;OAEG;YACW,sBAAsB;IAapC;;OAEG;YACW,iBAAiB;IAM/B;;;;;;;;;;;;OAYG;IACG,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAuI5D;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAwC3E;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA4I3D;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAsEnE;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0BrE;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA8BxC;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,aAAa;CAMtB"}