@cmdoss/memwal-sdk 0.6.0

package/dist/errors/index.js

@@ -0,0 +1,301 @@
+/**
+ * Error Handling System for Personal Data Wallet SDK
+ *
+ * Provides structured error types, validation, and user-friendly messages
+ * for all SDK operations including blockchain, storage, and encryption errors.
+ */
+// ==================== BASE ERROR CLASSES ====================
+/**
+ * Base error class for all Personal Data Wallet SDK errors
+ */
+export class PDWError extends Error {
+    constructor(message, code, category, severity = 'error', context, originalError) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.category = category;
+        this.severity = severity;
+        this.context = context;
+        this.timestamp = new Date();
+        this.originalError = originalError;
+        // Maintain proper stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Convert error to a structured object for logging/reporting
+     */
+    toObject() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            category: this.category,
+            severity: this.severity,
+            context: this.context,
+            timestamp: this.timestamp.toISOString(),
+            stack: this.stack,
+            originalError: this.originalError ? {
+                name: this.originalError.name,
+                message: this.originalError.message,
+                stack: this.originalError.stack,
+            } : undefined,
+        };
+    }
+    /**
+     * Get user-friendly error message
+     */
+    getUserMessage() {
+        return ERROR_MESSAGES[this.code] || this.message;
+    }
+    /**
+     * Check if error is retryable
+     */
+    isRetryable() {
+        return RETRYABLE_ERROR_CODES.includes(this.code);
+    }
+}
+// ==================== VALIDATION ERRORS ====================
+export class ValidationError extends PDWError {
+    constructor(message, field, value, originalError) {
+        super(message, 'VALIDATION_ERROR', 'validation', 'error', { field, value }, originalError);
+    }
+}
+export class ConfigurationError extends PDWError {
+    constructor(message, configKey, originalError) {
+        super(message, 'CONFIGURATION_ERROR', 'configuration', 'error', { configKey }, originalError);
+    }
+}
+export class InvalidParameterError extends PDWError {
+    constructor(parameter, expected, received) {
+        super(`Invalid parameter '${parameter}': expected ${expected}, received ${typeof received}`, 'INVALID_PARAMETER', 'validation', 'error', { field: parameter, value: received });
+    }
+}
+export class MissingParameterError extends PDWError {
+    constructor(parameter) {
+        super(`Missing required parameter: ${parameter}`, 'MISSING_PARAMETER', 'validation', 'error', { field: parameter });
+    }
+}
+// ==================== BLOCKCHAIN ERRORS ====================
+export class BlockchainError extends PDWError {
+    constructor(message, code, context, originalError) {
+        super(message, code, 'blockchain', 'error', context, originalError);
+    }
+}
+export class TransactionError extends BlockchainError {
+    constructor(message, transactionId, originalError) {
+        super(message, 'TRANSACTION_ERROR', { transactionId }, originalError);
+    }
+}
+export class InsufficientGasError extends BlockchainError {
+    constructor(required, available) {
+        super(`Insufficient gas: required ${required}, available ${available}`, 'INSUFFICIENT_GAS', { required, available });
+    }
+}
+export class ContractExecutionError extends BlockchainError {
+    constructor(contractFunction, reason, originalError) {
+        super(`Contract execution failed: ${contractFunction} - ${reason}`, 'CONTRACT_EXECUTION_ERROR', { contractFunction, reason }, originalError);
+    }
+}
+export class ObjectNotFoundError extends BlockchainError {
+    constructor(objectId, objectType) {
+        super(`Object not found: ${objectId}${objectType ? ` (${objectType})` : ''}`, 'OBJECT_NOT_FOUND', { objectId, objectType });
+    }
+}
+// ==================== STORAGE ERRORS ====================
+export class StorageError extends PDWError {
+    constructor(message, code, context, originalError) {
+        super(message, code, 'storage', 'error', context, originalError);
+    }
+}
+export class WalrusError extends StorageError {
+    constructor(message, blobId, originalError) {
+        super(message, 'WALRUS_ERROR', { blobId }, originalError);
+    }
+}
+export class StorageUploadError extends StorageError {
+    constructor(reason, fileSize, originalError) {
+        super(`Storage upload failed: ${reason}`, 'STORAGE_UPLOAD_ERROR', { fileSize }, originalError);
+    }
+}
+export class StorageRetrievalError extends StorageError {
+    constructor(blobId, reason, originalError) {
+        super(`Storage retrieval failed for ${blobId}: ${reason}`, 'STORAGE_RETRIEVAL_ERROR', { blobId }, originalError);
+    }
+}
+export class StorageQuotaExceededError extends StorageError {
+    constructor(currentUsage, limit) {
+        super(`Storage quota exceeded: ${currentUsage}/${limit} bytes`, 'STORAGE_QUOTA_EXCEEDED', { currentUsage, limit });
+    }
+}
+// ==================== ENCRYPTION ERRORS ====================
+export class EncryptionError extends PDWError {
+    constructor(message, code, context, originalError) {
+        super(message, code, 'encryption', 'error', context, originalError);
+    }
+}
+export class SealInitializationError extends EncryptionError {
+    constructor(reason, originalError) {
+        super(`SEAL client initialization failed: ${reason}`, 'SEAL_INITIALIZATION_ERROR', { reason }, originalError);
+    }
+}
+export class EncryptionFailedError extends EncryptionError {
+    constructor(userAddress, reason, originalError) {
+        super(`Encryption failed for ${userAddress}: ${reason}`, 'ENCRYPTION_FAILED', { userAddress, reason }, originalError);
+    }
+}
+export class DecryptionFailedError extends EncryptionError {
+    constructor(reason, contentId, originalError) {
+        super(`Decryption failed: ${reason}`, 'DECRYPTION_FAILED', { contentId, reason }, originalError);
+    }
+}
+export class AccessDeniedError extends EncryptionError {
+    constructor(userAddress, contentId, reason) {
+        super(`Access denied for user ${userAddress} to content ${contentId}${reason ? `: ${reason}` : ''}`, 'ACCESS_DENIED', { userAddress, contentId, reason });
+    }
+}
+export class SessionKeyError extends EncryptionError {
+    constructor(operation, reason, originalError) {
+        super(`Session key ${operation} failed: ${reason}`, 'SESSION_KEY_ERROR', { operation, reason }, originalError);
+    }
+}
+// ==================== NETWORK ERRORS ====================
+export class NetworkError extends PDWError {
+    constructor(message, code, context, originalError) {
+        super(message, code, 'network', 'error', context, originalError);
+    }
+}
+export class ConnectionError extends NetworkError {
+    constructor(endpoint, originalError) {
+        super(`Failed to connect to ${endpoint}`, 'CONNECTION_ERROR', { endpoint }, originalError);
+    }
+}
+export class TimeoutError extends NetworkError {
+    constructor(operation, timeoutMs) {
+        super(`Operation '${operation}' timed out after ${timeoutMs}ms`, 'TIMEOUT_ERROR', { operation, timeoutMs });
+    }
+}
+export class RateLimitError extends NetworkError {
+    constructor(service, retryAfter) {
+        super(`Rate limit exceeded for ${service}${retryAfter ? `, retry after ${retryAfter}s` : ''}`, 'RATE_LIMIT_ERROR', { service, retryAfter });
+    }
+}
+// ==================== AUTHENTICATION ERRORS ====================
+export class AuthenticationError extends PDWError {
+    constructor(message, code, context, originalError) {
+        super(message, code, 'authentication', 'error', context, originalError);
+    }
+}
+export class InvalidSignatureError extends AuthenticationError {
+    constructor(expectedAddress, actualAddress) {
+        super(`Invalid signature: expected from ${expectedAddress}${actualAddress ? `, got from ${actualAddress}` : ''}`, 'INVALID_SIGNATURE', { expectedAddress, actualAddress });
+    }
+}
+export class WalletNotConnectedError extends AuthenticationError {
+    constructor() {
+        super('Wallet not connected. Please connect your wallet to continue.', 'WALLET_NOT_CONNECTED');
+    }
+}
+// ==================== USER-FRIENDLY ERROR MESSAGES ====================
+export const ERROR_MESSAGES = {
+    // Validation
+    'VALIDATION_ERROR': 'The provided information is invalid. Please check your input and try again.',
+    'CONFIGURATION_ERROR': 'There is an issue with the SDK configuration. Please check your settings.',
+    'INVALID_PARAMETER': 'One of the provided values is invalid. Please check your input.',
+    'MISSING_PARAMETER': 'Required information is missing. Please provide all necessary details.',
+    // Blockchain
+    'TRANSACTION_ERROR': 'The blockchain transaction failed. Please try again.',
+    'INSUFFICIENT_GAS': 'Not enough gas to complete the transaction. Please add more SUI to your wallet.',
+    'CONTRACT_EXECUTION_ERROR': 'The smart contract operation failed. Please try again later.',
+    'OBJECT_NOT_FOUND': 'The requested item could not be found on the blockchain.',
+    // Storage
+    'WALRUS_ERROR': 'There was an issue with decentralized storage. Please try again.',
+    'STORAGE_UPLOAD_ERROR': 'Failed to save your data. Please check your connection and try again.',
+    'STORAGE_RETRIEVAL_ERROR': 'Failed to retrieve your data. Please try again later.',
+    'STORAGE_QUOTA_EXCEEDED': 'You have reached your storage limit. Please free up space or upgrade your plan.',
+    // Encryption
+    'SEAL_INITIALIZATION_ERROR': 'Encryption service is currently unavailable. Please try again later.',
+    'ENCRYPTION_FAILED': 'Failed to encrypt your data. Please try again.',
+    'DECRYPTION_FAILED': 'Failed to decrypt the requested content. Please check your permissions.',
+    'ACCESS_DENIED': 'You do not have permission to access this content.',
+    'SESSION_KEY_ERROR': 'Authentication session expired. Please reconnect and try again.',
+    // Network
+    'CONNECTION_ERROR': 'Unable to connect to the service. Please check your internet connection.',
+    'TIMEOUT_ERROR': 'The operation took too long to complete. Please try again.',
+    'RATE_LIMIT_ERROR': 'Too many requests. Please wait a moment before trying again.',
+    // Authentication
+    'INVALID_SIGNATURE': 'The signature verification failed. Please sign the transaction again.',
+    'WALLET_NOT_CONNECTED': 'Please connect your wallet to use this feature.',
+};
+// ==================== RETRYABLE ERROR CODES ====================
+export const RETRYABLE_ERROR_CODES = [
+    'CONNECTION_ERROR',
+    'TIMEOUT_ERROR',
+    'WALRUS_ERROR',
+    'STORAGE_RETRIEVAL_ERROR',
+    'NETWORK_ERROR',
+    'SEAL_INITIALIZATION_ERROR',
+];
+// ==================== ERROR UTILITIES ====================
+/**
+ * Check if an error is a PDW SDK error
+ */
+export function isPDWError(error) {
+    return error instanceof PDWError;
+}
+/**
+ * Wrap unknown errors in a PDWError
+ */
+export function wrapError(error, category = 'unknown', context) {
+    if (isPDWError(error)) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new ValidationError(error.message, undefined, undefined, error);
+    }
+    return new ValidationError('An unknown error occurred', undefined, error);
+}
+/**
+ * Create error from Sui/blockchain errors
+ */
+export function createBlockchainError(error, context) {
+    const message = error?.message || 'Unknown blockchain error';
+    // Check for specific Sui error patterns
+    if (message.includes('InsufficientGas')) {
+        const gasMatch = message.match(/required: (\d+), available: (\d+)/);
+        if (gasMatch) {
+            return new InsufficientGasError(parseInt(gasMatch[1]), parseInt(gasMatch[2]));
+        }
+        return new InsufficientGasError(0, 0);
+    }
+    if (message.includes('ObjectNotExists') || message.includes('not found')) {
+        const objectId = context?.objectId || 'unknown';
+        return new ObjectNotFoundError(objectId);
+    }
+    if (message.includes('execution_failure') || message.includes('MoveAbort')) {
+        return new ContractExecutionError(context?.function || 'unknown', message, error);
+    }
+    return new BlockchainError(message, 'BLOCKCHAIN_ERROR', context, error);
+}
+/**
+ * Create error from network/HTTP errors
+ */
+export function createNetworkError(error, endpoint) {
+    const message = error?.message || 'Network error occurred';
+    if (error?.code === 'ECONNREFUSED' || error?.code === 'ENOTFOUND') {
+        return new ConnectionError(endpoint || 'unknown endpoint', error);
+    }
+    if (error?.code === 'TIMEOUT' || message.includes('timeout')) {
+        return new TimeoutError('network request', error?.timeout || 30000);
+    }
+    if (error?.status === 429 || message.includes('rate limit')) {
+        return new RateLimitError(endpoint || 'unknown service', error?.retryAfter);
+    }
+    return new NetworkError(message, 'NETWORK_ERROR', { endpoint }, error);
+}
+// Re-export validation utilities
+export * from './validation.js';
+// Re-export recovery utilities
+export * from './recovery.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/errors/recovery.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Retry and Recovery Utilities for Personal Data Wallet SDK
+ *
+ * Provides automatic retry logic, circuit breaker patterns,
+ * and error recovery strategies for resilient operations.
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts */
+    maxAttempts: number;
+    /** Initial delay between retries in milliseconds */
+    initialDelay: number;
+    /** Maximum delay between retries in milliseconds */
+    maxDelay: number;
+    /** Backoff multiplier for exponential backoff */
+    backoffMultiplier: number;
+    /** Whether to add random jitter to delays */
+    jitter: boolean;
+    /** Function to determine if error should be retried */
+    shouldRetry?: (error: any, attempt: number) => boolean;
+    /** Function called before each retry attempt */
+    onRetry?: (error: any, attempt: number, delay: number) => void;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Execute a function with automatic retry logic
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+export interface CircuitBreakerConfig {
+    /** Number of failures before opening circuit */
+    failureThreshold: number;
+    /** Time in milliseconds to wait before attempting to close circuit */
+    resetTimeout: number;
+    /** Minimum number of calls before circuit can open */
+    minimumCalls: number;
+    /** Success ratio threshold to close circuit (0-1) */
+    successThreshold: number;
+}
+export declare enum CircuitState {
+    CLOSED = "CLOSED",
+    OPEN = "OPEN",
+    HALF_OPEN = "HALF_OPEN"
+}
+export declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private successCount;
+    private totalCalls;
+    private lastFailureTime;
+    private readonly config;
+    constructor(config?: Partial<CircuitBreakerConfig>);
+    execute<T>(operation: () => Promise<T>): Promise<T>;
+    private onSuccess;
+    private onFailure;
+    private reset;
+    getState(): CircuitState;
+    getMetrics(): {
+        state: CircuitState;
+        failureCount: number;
+        successCount: number;
+        totalCalls: number;
+        lastFailureTime: number;
+    };
+}
+export declare class RateLimiter {
+    private tokens;
+    private lastRefill;
+    private readonly capacity;
+    private readonly refillRate;
+    constructor(capacity: number, refillRate: number);
+    acquire(tokens?: number): Promise<void>;
+    private refill;
+    getTokens(): number;
+}
+export interface RecoveryStrategy<T> {
+    canRecover(error: any): boolean;
+    recover(error: any, originalOperation: () => Promise<T>): Promise<T>;
+}
+export declare class FallbackRecovery<T> implements RecoveryStrategy<T> {
+    private fallbackOperation;
+    private canRecoverFn;
+    constructor(fallbackOperation: (error: any) => Promise<T>, canRecoverFn?: (error: any) => boolean);
+    canRecover(error: any): boolean;
+    recover(error: any): Promise<T>;
+}
+export declare class CacheRecovery<T> implements RecoveryStrategy<T> {
+    private keyGenerator;
+    private ttl;
+    private cache;
+    constructor(keyGenerator: (...args: any[]) => string, ttl?: number);
+    canRecover(error: any): boolean;
+    recover(error: any, originalOperation: () => Promise<T>): Promise<T>;
+    setCacheEntry(key: string, data: T): void;
+    getCacheEntry(key: string): T | null;
+}
+export interface ResilienceConfig {
+    retry?: Partial<RetryConfig>;
+    circuitBreaker?: Partial<CircuitBreakerConfig>;
+    rateLimiter?: {
+        capacity: number;
+        refillRate: number;
+    };
+    recoveryStrategies?: RecoveryStrategy<any>[];
+}
+export declare class ResilientOperation<T> {
+    private circuitBreaker?;
+    private rateLimiter?;
+    private retryConfig;
+    private recoveryStrategies;
+    constructor(config?: ResilienceConfig);
+    execute(operation: () => Promise<T>): Promise<T>;
+}
+/**
+ * Create a resilient version of an async function
+ */
+export declare function makeResilient<T extends any[], R>(fn: (...args: T) => Promise<R>, config?: ResilienceConfig): (...args: T) => Promise<R>;
+/**
+ * Delay execution for a specified time
+ */
+export declare function delay(ms: number): Promise<void>;
+/**
+ * Create a timeout wrapper for promises
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, timeoutMessage?: string): Promise<T>;
+/**
+ * Batch operations with concurrency control
+ */
+export declare function batch<T, R>(items: T[], operation: (item: T, index: number) => Promise<R>, concurrency?: number): Promise<R[]>;
+//# sourceMappingURL=recovery.d.ts.map

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

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