@cmdoss/memwal-sdk 0.6.0

package/dist/services/BatchService.d.ts

@@ -0,0 +1,109 @@
+/**
+ * BatchService - Unified Batch Processing & Caching
+ *
+ * Consolidated service combining intelligent batch processing, caching,
+ * and coordination for all PDW SDK operations.
+ *
+ * Replaces: BatchingService + BatchManager
+ */
+import EventEmitter from 'eventemitter3';
+import type { BatchStats } from '../core';
+export interface BatchItem<T = any> {
+    id: string;
+    data: T;
+    timestamp: Date;
+    priority?: number;
+    metadata?: any;
+}
+export interface BatchProcessor<T = any> {
+    process(items: BatchItem<T>[]): Promise<void>;
+}
+export interface CacheConfig {
+    maxSize?: number;
+    ttlMs?: number;
+    cleanupIntervalMs?: number;
+    enableMetrics?: boolean;
+}
+export interface CacheItem<T = any> {
+    key: string;
+    value: T;
+    timestamp: Date;
+    expiresAt?: Date;
+    accessCount: number;
+    lastAccessed: Date;
+}
+export interface BatchServiceConfig {
+    embedding?: {
+        batchSize?: number;
+        delayMs?: number;
+    };
+    indexing?: {
+        batchSize?: number;
+        delayMs?: number;
+    };
+    storage?: {
+        batchSize?: number;
+        delayMs?: number;
+    };
+    cache?: CacheConfig;
+    enableMetrics?: boolean;
+}
+/**
+ * BatchService provides unified batch processing including:
+ * - Intelligent batching with configurable delays and sizes
+ * - LRU cache with TTL support
+ * - Event-driven batch coordination
+ * - Performance metrics and monitoring
+ */
+export declare class BatchService extends EventEmitter {
+    private config;
+    private queues;
+    private processors;
+    private timers;
+    private cache;
+    private stats;
+    constructor(config?: BatchServiceConfig);
+    /**
+     * Register a batch processor for a specific operation type
+     */
+    registerProcessor<T>(type: string, processor: BatchProcessor<T>): void;
+    /**
+     * Add item to batch queue
+     */
+    addToBatch<T>(type: string, item: BatchItem<T>): Promise<void>;
+    /**
+     * Process batch immediately
+     */
+    processBatch(type: string): Promise<void>;
+    /**
+     * Cache operations
+     */
+    setCache<T>(key: string, value: T, ttlMs?: number): void;
+    getCache<T>(key: string): T | null;
+    hasCache(key: string): boolean;
+    deleteCache(key: string): boolean;
+    clearCache(): void;
+    /**
+     * Get batch statistics
+     */
+    getStats(type?: string): BatchStats | Map<string, BatchStats>;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        totalAccess: number;
+        hitRate: number;
+        oldestItem?: Date;
+        newestItem?: Date;
+    };
+    /**
+     * Clean up resources
+     */
+    cleanup(): Promise<void>;
+    private getBatchConfig;
+    private scheduleProcessing;
+    private enforceMaxCacheSize;
+    private setupCleanupTimer;
+}
+//# sourceMappingURL=BatchService.d.ts.map

package/dist/services/BatchService.d.ts.map

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

package/dist/services/BatchService.js

@@ -0,0 +1,259 @@
+/**
+ * BatchService - Unified Batch Processing & Caching
+ *
+ * Consolidated service combining intelligent batch processing, caching,
+ * and coordination for all PDW SDK operations.
+ *
+ * Replaces: BatchingService + BatchManager
+ */
+import EventEmitter from 'eventemitter3';
+/**
+ * BatchService provides unified batch processing including:
+ * - Intelligent batching with configurable delays and sizes
+ * - LRU cache with TTL support
+ * - Event-driven batch coordination
+ * - Performance metrics and monitoring
+ */
+export class BatchService extends EventEmitter {
+    constructor(config = {}) {
+        super();
+        this.config = config;
+        this.queues = new Map();
+        this.processors = new Map();
+        this.timers = new Map();
+        this.cache = new Map();
+        this.stats = new Map();
+        this.setupCleanupTimer();
+    }
+    /**
+     * Register a batch processor for a specific operation type
+     */
+    registerProcessor(type, processor) {
+        this.processors.set(type, processor);
+        this.queues.set(type, []);
+        this.stats.set(type, {
+            totalBatches: 0,
+            totalItems: 0,
+            averageBatchSize: 0,
+            totalProcessingTime: 0,
+            averageProcessingTime: 0,
+            successCount: 0,
+            errorCount: 0,
+            lastProcessed: new Date(),
+            pendingBatches: 0,
+            processedToday: 0
+        });
+    }
+    /**
+     * Add item to batch queue
+     */
+    async addToBatch(type, item) {
+        const queue = this.queues.get(type);
+        const processor = this.processors.get(type);
+        if (!queue || !processor) {
+            throw new Error(`No processor registered for type: ${type}`);
+        }
+        queue.push(item);
+        this.emit('itemAdded', { type, item, queueSize: queue.length });
+        // Check if we should process immediately
+        const config = this.getBatchConfig(type);
+        if (queue.length >= config.batchSize) {
+            await this.processBatch(type);
+        }
+        else {
+            this.scheduleProcessing(type, config.delayMs);
+        }
+    }
+    /**
+     * Process batch immediately
+     */
+    async processBatch(type) {
+        const queue = this.queues.get(type);
+        const processor = this.processors.get(type);
+        const stats = this.stats.get(type);
+        if (!queue || !processor || !stats || queue.length === 0) {
+            return;
+        }
+        // Clear any pending timer
+        const timer = this.timers.get(type);
+        if (timer) {
+            clearTimeout(timer);
+            this.timers.delete(type);
+        }
+        // Take items from queue
+        const items = queue.splice(0);
+        const startTime = Date.now();
+        try {
+            await processor.process(items);
+            // Update stats
+            stats.totalBatches++;
+            stats.totalItems += items.length;
+            stats.successCount += items.length;
+            stats.averageBatchSize = stats.totalItems / stats.totalBatches;
+            const processingTime = Date.now() - startTime;
+            stats.totalProcessingTime += processingTime;
+            stats.averageProcessingTime = stats.totalProcessingTime / stats.totalBatches;
+            stats.lastProcessed = new Date();
+            this.emit('batchProcessed', {
+                type,
+                itemCount: items.length,
+                processingTime,
+                success: true
+            });
+        }
+        catch (error) {
+            // Update error stats
+            stats.errorCount += items.length;
+            this.emit('batchError', {
+                type,
+                itemCount: items.length,
+                error,
+                success: false
+            });
+            throw error;
+        }
+    }
+    /**
+     * Cache operations
+     */
+    setCache(key, value, ttlMs) {
+        const now = new Date();
+        const item = {
+            key,
+            value,
+            timestamp: now,
+            expiresAt: ttlMs ? new Date(now.getTime() + ttlMs) : undefined,
+            accessCount: 0,
+            lastAccessed: now
+        };
+        this.cache.set(key, item);
+        this.enforceMaxCacheSize();
+    }
+    getCache(key) {
+        const item = this.cache.get(key);
+        if (!item) {
+            return null;
+        }
+        // Check expiration
+        if (item.expiresAt && item.expiresAt < new Date()) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Update access stats
+        item.accessCount++;
+        item.lastAccessed = new Date();
+        return item.value;
+    }
+    hasCache(key) {
+        return this.getCache(key) !== null;
+    }
+    deleteCache(key) {
+        return this.cache.delete(key);
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Get batch statistics
+     */
+    getStats(type) {
+        if (type) {
+            return this.stats.get(type) || {
+                totalBatches: 0,
+                totalItems: 0,
+                averageBatchSize: 0,
+                totalProcessingTime: 0,
+                averageProcessingTime: 0,
+                successCount: 0,
+                errorCount: 0,
+                lastProcessed: new Date(),
+                pendingBatches: 0,
+                processedToday: 0
+            };
+        }
+        return new Map(this.stats);
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        const items = Array.from(this.cache.values());
+        const totalAccess = items.reduce((sum, item) => sum + item.accessCount, 0);
+        return {
+            size: this.cache.size,
+            totalAccess,
+            hitRate: totalAccess > 0 ? totalAccess / (totalAccess + 1) : 0, // Simplified calculation
+            oldestItem: items.length > 0 ? new Date(Math.min(...items.map(i => i.timestamp.getTime()))) : undefined,
+            newestItem: items.length > 0 ? new Date(Math.max(...items.map(i => i.timestamp.getTime()))) : undefined
+        };
+    }
+    /**
+     * Clean up resources
+     */
+    async cleanup() {
+        // Process remaining items
+        for (const type of this.queues.keys()) {
+            await this.processBatch(type);
+        }
+        // Clear timers
+        for (const timer of this.timers.values()) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
+        // Clear cache
+        this.clearCache();
+    }
+    // Private helper methods
+    getBatchConfig(type) {
+        const defaults = { batchSize: 10, delayMs: 1000 };
+        switch (type) {
+            case 'embedding':
+                return { ...defaults, ...this.config.embedding };
+            case 'indexing':
+                return { ...defaults, ...this.config.indexing };
+            case 'storage':
+                return { ...defaults, ...this.config.storage };
+            default:
+                return defaults;
+        }
+    }
+    scheduleProcessing(type, delayMs) {
+        // Clear existing timer
+        const existingTimer = this.timers.get(type);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        // Schedule new processing
+        const timer = setTimeout(() => {
+            this.processBatch(type).catch(error => {
+                this.emit('error', error);
+            });
+        }, delayMs);
+        this.timers.set(type, timer);
+    }
+    enforceMaxCacheSize() {
+        const maxSize = this.config.cache?.maxSize || 1000;
+        if (this.cache.size <= maxSize) {
+            return;
+        }
+        // Remove oldest items (LRU)
+        const items = Array.from(this.cache.entries())
+            .sort(([, a], [, b]) => a.lastAccessed.getTime() - b.lastAccessed.getTime());
+        const itemsToRemove = items.slice(0, this.cache.size - maxSize);
+        for (const [key] of itemsToRemove) {
+            this.cache.delete(key);
+        }
+    }
+    setupCleanupTimer() {
+        const cleanupInterval = this.config.cache?.cleanupIntervalMs || 60000; // 1 minute
+        setInterval(() => {
+            const now = new Date();
+            for (const [key, item] of this.cache.entries()) {
+                if (item.expiresAt && item.expiresAt < now) {
+                    this.cache.delete(key);
+                }
+            }
+        }, cleanupInterval);
+    }
+}
+//# sourceMappingURL=BatchService.js.map

package/dist/services/BatchService.js.map

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

package/dist/services/CapabilityService.d.ts

@@ -0,0 +1,141 @@
+/**
+ * CapabilityService - Capability-based access control for Personal Data Wallet
+ *
+ * This service implements the SEAL PrivateData pattern for simplified access control
+ * using Move's capability pattern. It replaces the old HD wallet + allowlist architecture.
+ *
+ * Key benefits:
+ * - 1 user wallet instead of N HD wallets
+ * - Object ownership = access permission (SEAL idiomatic)
+ * - No global registry needed
+ * - 60% gas savings vs allowlist pattern
+ * - Type-safe access control
+ *
+ * @see CAPABILITY-ARCHITECTURE-SUMMARY.md
+ */
+import { SuiClient } from '@mysten/sui/client';
+import { Transaction } from '@mysten/sui/transactions';
+import type { MemoryCap, CreateMemoryCapOptions, TransferCapOptions, BurnCapOptions, ListCapsOptions, GetOrCreateCapOptions, ComputeKeyIdOptions } from '../core/types/capability';
+/**
+ * Configuration for CapabilityService
+ */
+export interface CapabilityServiceConfig {
+    /** Sui client instance */
+    suiClient: SuiClient;
+    /** Package ID for Move contracts */
+    packageId: string;
+}
+/**
+ * CapabilityService handles MemoryCap object operations
+ *
+ * Implements the SEAL PrivateData pattern for simplified access control.
+ */
+export declare class CapabilityService {
+    private suiClient;
+    private packageId;
+    constructor(config: CapabilityServiceConfig);
+    /**
+     * Create a new MemoryCap for an app context
+     *
+     * @param options - Creation options
+     * @param signer - Transaction signer
+     * @returns Created MemoryCap
+     */
+    create(options: CreateMemoryCapOptions, signer: any): Promise<MemoryCap>;
+    /**
+     * Get a MemoryCap by app ID for a user
+     *
+     * @param userAddress - User's Sui address
+     * @param appId - Application identifier
+     * @returns MemoryCap or null if not found
+     */
+    get(userAddress: string, appId: string): Promise<MemoryCap | null>;
+    /**
+     * Get or create a MemoryCap for an app context
+     *
+     * @param options - Get or create options
+     * @param signer - Transaction signer (required for creation)
+     * @returns Existing or newly created MemoryCap
+     */
+    getOrCreate(options: GetOrCreateCapOptions, signer: any): Promise<MemoryCap>;
+    /**
+     * List all MemoryCaps owned by a user
+     *
+     * @param options - List options (filter by appId, userAddress)
+     * @returns Array of MemoryCaps
+     */
+    list(options?: ListCapsOptions): Promise<MemoryCap[]>;
+    /**
+     * Transfer a MemoryCap to another address
+     *
+     * After transfer:
+     * - New owner can call seal_approve
+     * - New owner can decrypt memories
+     * - Original owner loses access
+     *
+     * @param options - Transfer options
+     * @param signer - Transaction signer
+     */
+    transfer(options: TransferCapOptions, signer: any): Promise<void>;
+    /**
+     * Burn (revoke) a MemoryCap
+     *
+     * This permanently revokes the capability.
+     * After burning:
+     * - No one can decrypt memories for this context
+     * - Object is permanently deleted
+     *
+     * @param options - Burn options
+     * @param signer - Transaction signer
+     */
+    burn(options: BurnCapOptions, signer: any): Promise<void>;
+    /**
+     * Compute SEAL key ID for a capability
+     *
+     * key_id = keccak256(owner || nonce)
+     *
+     * @param cap - MemoryCap object
+     * @returns Key ID as hex string
+     */
+    computeKeyId(cap: MemoryCap): string;
+    /**
+     * Compute SEAL key ID from owner and nonce
+     *
+     * @param options - Owner address and nonce
+     * @returns Key ID as hex string
+     */
+    computeKeyIdFromParts(options: ComputeKeyIdOptions): string;
+    /**
+     * Get MemoryCap object by ID
+     *
+     * @param capId - Capability object ID
+     * @returns MemoryCap or null
+     */
+    getById(capId: string): Promise<MemoryCap | null>;
+    /**
+     * Check if user has capability for an app context
+     *
+     * @param userAddress - User's Sui address
+     * @param appId - Application identifier
+     * @returns True if capability exists
+     */
+    hasCapability(userAddress: string, appId: string): Promise<boolean>;
+    /**
+     * Build transaction for creating MemoryCap (for PTB composition)
+     *
+     * @param tx - Transaction to add call to
+     * @param appId - Application identifier
+     */
+    buildCreateCall(tx: Transaction, appId: string): void;
+    /**
+     * Build seal_approve transaction argument
+     *
+     * @param tx - Transaction to add call to
+     * @param capId - Capability object ID
+     * @param keyId - SEAL key ID (as hex string)
+     */
+    buildSealApproveCall(tx: Transaction, capId: string, keyId: string): void;
+    private addressToBytes;
+    private hexToBytes;
+}
+//# sourceMappingURL=CapabilityService.d.ts.map

package/dist/services/CapabilityService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapabilityService.d.ts","sourceRoot":"","sources":["../../src/services/CapabilityService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,OAAO,KAAK,EACV,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,qBAAqB,EAErB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,uBAAuB;IAK3C;;;;;;OAMG;IACG,MAAM,CACV,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,SAAS,CAAC;IAiDrB;;;;;;OAMG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAKxE;;;;;;OAMG;IACG,WAAW,CACf,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,SAAS,CAAC;IAarB;;;;;OAKG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAmD3D;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BvE;;;;;;;;;;OAUG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B/D;;;;;;;OAOG;IACH,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM;IAOpC;;;;;OAKG;IACH,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM;IAqB3D;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IA4CvD;;;;;;OAMG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKzE;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASrD;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAczE,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,UAAU;CAUnB"}