@cmdoss/memwal-sdk 0.6.0

package/dist/errors/recovery.js

@@ -0,0 +1,320 @@
+/**
+ * Retry and Recovery Utilities for Personal Data Wallet SDK
+ *
+ * Provides automatic retry logic, circuit breaker patterns,
+ * and error recovery strategies for resilient operations.
+ */
+import { isPDWError, NetworkError, TimeoutError, ValidationError } from './index.js';
+export const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    initialDelay: 1000,
+    maxDelay: 10000,
+    backoffMultiplier: 2,
+    jitter: true,
+    shouldRetry: (error) => {
+        if (isPDWError(error)) {
+            return error.isRetryable();
+        }
+        // Retry network errors, timeouts, and temporary failures
+        return error?.code === 'ECONNRESET' ||
+            error?.code === 'ENOTFOUND' ||
+            error?.code === 'TIMEOUT' ||
+            error?.status >= 500;
+    },
+    onRetry: (error, attempt, delay) => {
+        console.warn(`Retry attempt ${attempt} after ${delay}ms due to:`, error.message);
+    },
+};
+// ==================== RETRY FUNCTION ====================
+/**
+ * Execute a function with automatic retry logic
+ */
+export async function withRetry(operation, config = {}) {
+    const finalConfig = { ...DEFAULT_RETRY_CONFIG, ...config };
+    let lastError;
+    for (let attempt = 1; attempt <= finalConfig.maxAttempts; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            // Check if we should retry
+            if (attempt >= finalConfig.maxAttempts ||
+                !finalConfig.shouldRetry(error, attempt)) {
+                throw error;
+            }
+            // Calculate delay with exponential backoff and jitter
+            const baseDelay = Math.min(finalConfig.initialDelay * Math.pow(finalConfig.backoffMultiplier, attempt - 1), finalConfig.maxDelay);
+            const jitter = finalConfig.jitter ?
+                Math.random() * 0.1 * baseDelay : 0;
+            const delay = Math.floor(baseDelay + jitter);
+            // Call retry callback
+            if (finalConfig.onRetry) {
+                finalConfig.onRetry(error, attempt, delay);
+            }
+            // Wait before retrying
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+    }
+    throw lastError;
+}
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (CircuitState = {}));
+export class CircuitBreaker {
+    constructor(config = {}) {
+        this.state = CircuitState.CLOSED;
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.totalCalls = 0;
+        this.lastFailureTime = 0;
+        this.config = {
+            failureThreshold: 5,
+            resetTimeout: 30000,
+            minimumCalls: 10,
+            successThreshold: 0.8,
+            ...config,
+        };
+    }
+    async execute(operation) {
+        if (this.state === CircuitState.OPEN) {
+            if (Date.now() - this.lastFailureTime > this.config.resetTimeout) {
+                this.state = CircuitState.HALF_OPEN;
+                this.successCount = 0;
+                this.totalCalls = 0;
+            }
+            else {
+                throw new NetworkError('Circuit breaker is open - service temporarily unavailable', 'CIRCUIT_BREAKER_OPEN');
+            }
+        }
+        try {
+            const result = await operation();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    onSuccess() {
+        this.successCount++;
+        this.totalCalls++;
+        if (this.state === CircuitState.HALF_OPEN) {
+            const successRatio = this.successCount / this.totalCalls;
+            if (this.totalCalls >= this.config.minimumCalls &&
+                successRatio >= this.config.successThreshold) {
+                this.reset();
+            }
+        }
+        else {
+            this.failureCount = 0;
+        }
+    }
+    onFailure() {
+        this.failureCount++;
+        this.totalCalls++;
+        this.lastFailureTime = Date.now();
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.state = CircuitState.OPEN;
+        }
+        else if (this.failureCount >= this.config.failureThreshold &&
+            this.totalCalls >= this.config.minimumCalls) {
+            this.state = CircuitState.OPEN;
+        }
+    }
+    reset() {
+        this.state = CircuitState.CLOSED;
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.totalCalls = 0;
+    }
+    getState() {
+        return this.state;
+    }
+    getMetrics() {
+        return {
+            state: this.state,
+            failureCount: this.failureCount,
+            successCount: this.successCount,
+            totalCalls: this.totalCalls,
+            lastFailureTime: this.lastFailureTime,
+        };
+    }
+}
+// ==================== RATE LIMITER ====================
+export class RateLimiter {
+    constructor(capacity, refillRate) {
+        this.capacity = capacity;
+        this.refillRate = refillRate;
+        this.tokens = capacity;
+        this.lastRefill = Date.now();
+    }
+    async acquire(tokens = 1) {
+        this.refill();
+        if (this.tokens >= tokens) {
+            this.tokens -= tokens;
+            return;
+        }
+        // Wait for tokens to be available
+        const tokensNeeded = tokens - this.tokens;
+        const waitTime = (tokensNeeded / this.refillRate) * 1000;
+        await new Promise(resolve => setTimeout(resolve, waitTime));
+        this.refill();
+        this.tokens -= tokens;
+    }
+    refill() {
+        const now = Date.now();
+        const timePassed = (now - this.lastRefill) / 1000;
+        const tokensToAdd = timePassed * this.refillRate;
+        this.tokens = Math.min(this.capacity, this.tokens + tokensToAdd);
+        this.lastRefill = now;
+    }
+    getTokens() {
+        this.refill();
+        return this.tokens;
+    }
+}
+export class FallbackRecovery {
+    constructor(fallbackOperation, canRecoverFn = () => true) {
+        this.fallbackOperation = fallbackOperation;
+        this.canRecoverFn = canRecoverFn;
+    }
+    canRecover(error) {
+        return this.canRecoverFn(error);
+    }
+    async recover(error) {
+        return this.fallbackOperation(error);
+    }
+}
+export class CacheRecovery {
+    constructor(keyGenerator, ttl = 300000 // 5 minutes
+    ) {
+        this.keyGenerator = keyGenerator;
+        this.ttl = ttl;
+        this.cache = new Map();
+    }
+    canRecover(error) {
+        return isPDWError(error) &&
+            (error.code === 'NETWORK_ERROR' ||
+                error.code === 'TIMEOUT_ERROR' ||
+                error.code === 'CONNECTION_ERROR');
+    }
+    async recover(error, originalOperation) {
+        // This is a simplified recovery - in practice, you'd need access to the original arguments
+        throw new Error('Cache recovery requires implementation context');
+    }
+    setCacheEntry(key, data) {
+        this.cache.set(key, {
+            data,
+            timestamp: Date.now(),
+        });
+    }
+    getCacheEntry(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        if (Date.now() - entry.timestamp > this.ttl) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.data;
+    }
+}
+export class ResilientOperation {
+    constructor(config = {}) {
+        this.retryConfig = { ...DEFAULT_RETRY_CONFIG, ...config.retry };
+        if (config.circuitBreaker) {
+            this.circuitBreaker = new CircuitBreaker(config.circuitBreaker);
+        }
+        if (config.rateLimiter) {
+            this.rateLimiter = new RateLimiter(config.rateLimiter.capacity, config.rateLimiter.refillRate);
+        }
+        this.recoveryStrategies = config.recoveryStrategies || [];
+    }
+    async execute(operation) {
+        // Apply rate limiting
+        if (this.rateLimiter) {
+            await this.rateLimiter.acquire();
+        }
+        const executeWithCircuitBreaker = this.circuitBreaker ?
+            () => this.circuitBreaker.execute(operation) :
+            operation;
+        try {
+            return await withRetry(executeWithCircuitBreaker, this.retryConfig);
+        }
+        catch (error) {
+            // Try recovery strategies
+            for (const strategy of this.recoveryStrategies) {
+                if (strategy.canRecover(error)) {
+                    try {
+                        return await strategy.recover(error, operation);
+                    }
+                    catch (recoveryError) {
+                        // If recovery fails, continue to next strategy
+                        continue;
+                    }
+                }
+            }
+            // If no recovery worked, throw the original error
+            throw error;
+        }
+    }
+}
+// ==================== UTILITY FUNCTIONS ====================
+/**
+ * Create a resilient version of an async function
+ */
+export function makeResilient(fn, config = {}) {
+    const resilientOp = new ResilientOperation(config);
+    return (...args) => {
+        return resilientOp.execute(() => fn(...args));
+    };
+}
+/**
+ * Delay execution for a specified time
+ */
+export function delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Create a timeout wrapper for promises
+ */
+export function withTimeout(promise, timeoutMs, timeoutMessage = 'Operation timed out') {
+    const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => {
+            reject(new TimeoutError('operation', timeoutMs));
+        }, timeoutMs);
+    });
+    return Promise.race([promise, timeoutPromise]);
+}
+/**
+ * Batch operations with concurrency control
+ */
+export async function batch(items, operation, concurrency = 5) {
+    const results = [];
+    const errors = [];
+    for (let i = 0; i < items.length; i += concurrency) {
+        const batch = items.slice(i, i + concurrency);
+        const promises = batch.map((item, batchIndex) => operation(item, i + batchIndex)
+            .catch(error => ({ error, index: i + batchIndex })));
+        const batchResults = await Promise.all(promises);
+        batchResults.forEach((result, batchIndex) => {
+            if (result && typeof result === 'object' && 'error' in result) {
+                errors.push(result);
+            }
+            else {
+                results[i + batchIndex] = result;
+            }
+        });
+    }
+    if (errors.length > 0) {
+        throw new ValidationError(`Batch operation failed for ${errors.length} items`, 'batch', { errors: errors.map(e => ({ index: e.index, message: e.error.message })) });
+    }
+    return results;
+}
+//# sourceMappingURL=recovery.js.map

package/dist/errors/recovery.js.map

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

package/dist/errors/validation.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Validation Utilities for Personal Data Wallet SDK
+ *
+ * Provides input validation, type checking, and data sanitization
+ * with automatic error throwing using the error handling system.
+ */
+export declare function isString(value: any): value is string;
+export declare function isNumber(value: any): value is number;
+export declare function isBoolean(value: any): value is boolean;
+export declare function isObject(value: any): value is Record<string, any>;
+export declare function isArray(value: any): value is any[];
+export declare function isUint8Array(value: any): value is Uint8Array;
+export declare function isValidAddress(address: string): boolean;
+export declare function isValidObjectId(objectId: string): boolean;
+export declare function isValidPackageId(packageId: string): boolean;
+export declare function isValidBlobId(blobId: string): boolean;
+export declare function isValidCategory(category: string): boolean;
+export declare function isValidImportance(importance: number): boolean;
+/**
+ * Validate required parameter exists and is not null/undefined
+ */
+export declare function validateRequired<T>(value: T | null | undefined, parameterName: string): T;
+/**
+ * Validate parameter is a non-empty string
+ */
+export declare function validateString(value: any, parameterName: string, options?: {
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: RegExp;
+}): string;
+/**
+ * Validate parameter is a valid number
+ */
+export declare function validateNumber(value: any, parameterName: string, options?: {
+    required?: boolean;
+    min?: number;
+    max?: number;
+    integer?: boolean;
+}): number;
+/**
+ * Validate parameter is a boolean
+ */
+export declare function validateBoolean(value: any, parameterName: string, required?: boolean): boolean;
+/**
+ * Validate parameter is an object
+ */
+export declare function validateObject<T extends Record<string, any>>(value: any, parameterName: string, required?: boolean): T;
+/**
+ * Validate parameter is an array
+ */
+export declare function validateArray<T>(value: any, parameterName: string, options?: {
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    itemValidator?: (item: any, index: number) => T;
+}): T[];
+/**
+ * Validate Sui address format
+ */
+export declare function validateSuiAddress(address: any, parameterName: string, required?: boolean): string;
+/**
+ * Validate Sui object ID format
+ */
+export declare function validateObjectId(objectId: any, parameterName: string, required?: boolean): string;
+/**
+ * Validate memory category
+ */
+export declare function validateMemoryCategory(category: any, parameterName?: string, required?: boolean): string;
+/**
+ * Validate memory importance (1-10)
+ */
+export declare function validateMemoryImportance(importance: any, parameterName?: string, required?: boolean): number;
+/**
+ * Validate Walrus blob ID format
+ */
+export declare function validateBlobId(blobId: any, parameterName: string, required?: boolean): string;
+/**
+ * Validate access level
+ */
+export declare function validateAccessLevel(accessLevel: any, parameterName?: string, required?: boolean): 'read' | 'write';
+/**
+ * Validate PDW SDK configuration
+ */
+export declare function validatePDWConfig(config: any): void;
+/**
+ * Validate encryption configuration
+ */
+export declare function validateEncryptionConfig(config: any): void;
+/**
+ * Validate storage configuration
+ */
+export declare function validateStorageConfig(config: any): void;
+/**
+ * Sanitize user input to prevent common issues
+ */
+export declare function sanitizeString(input: string): string;
+/**
+ * Validate and normalize Sui address
+ */
+export declare function normalizeSuiAddress(address: string): string;
+/**
+ * Create validation wrapper for functions
+ */
+export declare function withValidation<T extends any[], R>(fn: (...args: T) => R, validators: Array<(arg: any, index: number) => any>): (...args: T) => R;
+//# sourceMappingURL=validation.d.ts.map

package/dist/errors/validation.d.ts.map

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