@cmdoss/memwal-sdk 0.6.0

package/dist/config/ConfigurationHelper.js

@@ -0,0 +1,283 @@
+/**
+ * Configuration Utilities for Personal Data Wallet SDK
+ *
+ * Provides helpers for managing API keys, environment variables,
+ * and configuration validation across the SDK.
+ */
+/**
+ * Configuration helper with environment variable support
+ */
+export class ConfigurationHelper {
+    constructor() {
+        // Instance constructor for backwards compatibility
+    }
+    /**
+     * Get Gemini API key from various sources
+     */
+    static getGeminiApiKey(providedKey) {
+        const apiKey = providedKey ||
+            process.env.GEMINI_API_KEY ||
+            process.env.GOOGLE_AI_API_KEY;
+        if (!apiKey) {
+            throw new Error('🔑 Gemini API key is required. Set it via:\n\n' +
+                '1. Direct configuration:\n' +
+                '   const pipeline = createQuickStartPipeline("BASIC", {\n' +
+                '     embedding: { apiKey: "your-api-key" }\n' +
+                '   });\n\n' +
+                '2. Environment variable:\n' +
+                '   export GEMINI_API_KEY="your-api-key"\n' +
+                '   # or\n' +
+                '   export GOOGLE_AI_API_KEY="your-api-key"\n\n' +
+                '3. .env file:\n' +
+                '   GEMINI_API_KEY=your-api-key\n\n' +
+                '📝 Get your free API key from: https://makersuite.google.com/app/apikey');
+        }
+        return apiKey;
+    }
+    /**
+     * Get Sui configuration from environment
+     */
+    static getSuiConfig() {
+        const network = process.env.SUI_NETWORK || 'testnet';
+        return {
+            network,
+            packageId: process.env.SUI_PACKAGE_ID,
+            adminPrivateKey: process.env.SUI_ADMIN_PRIVATE_KEY
+        };
+    }
+    /**
+     * Get Walrus configuration from environment
+     */
+    static getWalrusConfig() {
+        const network = process.env.WALRUS_NETWORK || 'testnet';
+        return {
+            network,
+            uploadRelay: process.env.WALRUS_UPLOAD_RELAY
+        };
+    }
+    /**
+     * Get SEAL key server configuration from environment
+     */
+    static getSealConfig() {
+        return {
+            keyServerUrl: process.env.SEAL_KEY_SERVER_URL || 'https://testnet.seal.mysten.app',
+            keyServerObjectId: process.env.SEAL_KEY_SERVER_OBJECT_ID,
+            sessionTTL: process.env.SEAL_SESSION_TTL ? parseInt(process.env.SEAL_SESSION_TTL) : 60,
+            enableBatch: process.env.SEAL_ENABLE_BATCH === 'true',
+            batchSize: process.env.SEAL_BATCH_SIZE ? parseInt(process.env.SEAL_BATCH_SIZE) : 10,
+            decryptionTimeout: process.env.SEAL_DECRYPTION_TIMEOUT ? parseInt(process.env.SEAL_DECRYPTION_TIMEOUT) : 30000,
+            verifyServers: process.env.SEAL_VERIFY_SERVERS !== 'false', // Default true
+            enableAudit: process.env.SEAL_ENABLE_AUDIT === 'true',
+            network: process.env.SEAL_NETWORK || 'testnet',
+            retryAttempts: process.env.SEAL_RETRY_ATTEMPTS ? parseInt(process.env.SEAL_RETRY_ATTEMPTS) : 3
+        };
+    }
+    /**
+     * Instance method for getSealConfig (for backwards compatibility)
+     */
+    getSealConfig() {
+        return ConfigurationHelper.getSealConfig();
+    }
+    /**
+     * Load configuration from environment variables
+     */
+    static loadFromEnvironment() {
+        return {
+            // AI Configuration
+            geminiApiKey: process.env.GEMINI_API_KEY || process.env.GOOGLE_AI_API_KEY,
+            embeddingModel: process.env.EMBEDDING_MODEL || 'text-embedding-004',
+            // Blockchain Configuration
+            suiNetwork: process.env.SUI_NETWORK || 'testnet',
+            suiPackageId: process.env.SUI_PACKAGE_ID,
+            suiAdminPrivateKey: process.env.SUI_ADMIN_PRIVATE_KEY,
+            // Storage Configuration
+            walrusNetwork: process.env.WALRUS_NETWORK || 'testnet',
+            walrusUploadRelay: process.env.WALRUS_UPLOAD_RELAY,
+            // Feature Flags
+            enableEncryption: this.parseBooleanEnv('PDW_ENABLE_ENCRYPTION', true),
+            enableBatching: this.parseBooleanEnv('PDW_ENABLE_BATCHING', true),
+            enableMonitoring: this.parseBooleanEnv('PDW_ENABLE_MONITORING', true)
+        };
+    }
+    /**
+     * Validate that required configuration is present
+     */
+    static validateConfig(config) {
+        const errors = [];
+        const warnings = [];
+        // Check for Gemini API key
+        try {
+            this.getGeminiApiKey(config.geminiApiKey);
+        }
+        catch (error) {
+            errors.push('Missing Gemini API key for AI embedding generation');
+        }
+        // Validate Sui configuration
+        if (config.suiPackageId && !config.suiPackageId.startsWith('0x')) {
+            errors.push('Invalid Sui package ID format (should start with 0x)');
+        }
+        if (config.suiAdminPrivateKey && config.suiAdminPrivateKey.length < 32) {
+            warnings.push('Sui admin private key seems too short');
+        }
+        // Network consistency check
+        if (config.suiNetwork !== config.walrusNetwork) {
+            warnings.push('Sui and Walrus networks should typically match');
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    /**
+     * Create a complete configuration with smart defaults
+     */
+    static createConfig(overrides = {}) {
+        const envConfig = this.loadFromEnvironment();
+        const merged = { ...envConfig, ...overrides };
+        // Validate the final configuration
+        const validation = this.validateConfig(merged);
+        if (!validation.isValid) {
+            throw new Error(`Configuration validation failed:\n${validation.errors.join('\n')}`);
+        }
+        if (validation.warnings.length > 0) {
+            console.warn('⚠️ Configuration warnings:', validation.warnings);
+        }
+        return merged;
+    }
+    /**
+     * Print current configuration (masking sensitive data)
+     */
+    static printConfig(config) {
+        const masked = {
+            ...config,
+            geminiApiKey: config.geminiApiKey ? this.maskApiKey(config.geminiApiKey) : undefined,
+            suiAdminPrivateKey: config.suiAdminPrivateKey ? this.maskPrivateKey(config.suiAdminPrivateKey) : undefined
+        };
+        console.log('📋 PDW SDK Configuration:');
+        console.table(masked);
+    }
+    /**
+     * Generate example .env file content
+     */
+    static generateEnvTemplate() {
+        return `# Personal Data Wallet SDK Configuration
+# Copy this to your .env file and fill in your values
+
+# 🧠 AI/Embedding Configuration (Required)
+GEMINI_API_KEY=your_gemini_api_key_here
+# Get your key from: https://makersuite.google.com/app/apikey
+
+# ⛓️ Sui Blockchain Configuration (Optional)
+SUI_NETWORK=testnet
+SUI_PACKAGE_ID=your_deployed_package_id_here
+SUI_ADMIN_PRIVATE_KEY=your_sui_private_key_here
+
+# 🗄️ Walrus Storage Configuration (Optional)
+WALRUS_NETWORK=testnet
+WALRUS_UPLOAD_RELAY=https://upload-relay.testnet.walrus.space
+
+# 🔐 SEAL Encryption Configuration (Optional)
+# Uses official Mysten Labs testnet servers by default
+# Configure custom key server if needed:
+SEAL_KEY_SERVER_URL=your_custom_key_server_url
+SEAL_KEY_SERVER_OBJECT_ID=your_custom_key_server_object_id
+SEAL_SESSION_TTL=60
+SEAL_ENABLE_BATCH=true
+SEAL_BATCH_SIZE=10
+SEAL_DECRYPTION_TIMEOUT=30000
+SEAL_VERIFY_SERVERS=true
+SEAL_ENABLE_AUDIT=false
+
+# 🎛️ Feature Flags (Optional)
+PDW_ENABLE_ENCRYPTION=true
+PDW_ENABLE_BATCHING=true
+PDW_ENABLE_MONITORING=true
+
+# 🔧 Advanced Settings (Optional)
+EMBEDDING_MODEL=text-embedding-004
+`;
+    }
+    /**
+     * Generate SEAL-specific environment template
+     */
+    static generateSealEnvTemplate() {
+        return `# SEAL Encryption Configuration for Personal Data Wallet SDK
+
+# 🔑 SEAL Key Server Configuration
+SEAL_KEY_SERVER_URL=https://testnet.seal.mysten.app
+SEAL_NETWORK=testnet
+
+# 🔧 SEAL Performance Settings
+SEAL_BATCH_SIZE=10
+SEAL_RETRY_ATTEMPTS=3
+SEAL_DECRYPTION_TIMEOUT=30000
+SEAL_SESSION_TTL=60
+
+# 🛡️ SEAL Security Settings
+SEAL_VERIFY_SERVERS=true
+SEAL_ENABLE_AUDIT=false
+SEAL_ENABLE_BATCH=true
+
+# 📦 Deployed Contract Configuration
+SUI_PACKAGE_ID=0x067706fc08339b715dab0383bd853b04d06ef6dff3a642c5e7056222da038bde
+SUI_NETWORK=testnet
+
+# 🔑 Testnet Key Servers (Official Mysten Labs)
+SEAL_KEY_SERVER_1_URL=https://seal-key-server-testnet-1.mystenlabs.com
+SEAL_KEY_SERVER_1_OBJECT=0x73d05d62c18d9374e3ea529e8e0ed6161da1a141a94d3f76ae3fe4e99356db75
+SEAL_KEY_SERVER_2_URL=https://seal-key-server-testnet-2.mystenlabs.com
+SEAL_KEY_SERVER_2_OBJECT=0xf5d14a81a982144ae441cd7d64b09027f116a468bd36e7eca494f750591623c8
+`;
+    }
+    /**
+     * Instance method for generateSealEnvTemplate (for backwards compatibility)
+     */
+    generateSealEnvTemplate() {
+        return ConfigurationHelper.generateSealEnvTemplate();
+    }
+    // Private helper methods
+    static parseBooleanEnv(key, defaultValue) {
+        const value = process.env[key];
+        if (value === undefined)
+            return defaultValue;
+        return value.toLowerCase() === 'true' || value === '1';
+    }
+    static maskApiKey(apiKey) {
+        if (apiKey.length <= 8)
+            return '*'.repeat(apiKey.length);
+        return apiKey.substring(0, 4) + '*'.repeat(apiKey.length - 8) + apiKey.substring(apiKey.length - 4);
+    }
+    static maskPrivateKey(privateKey) {
+        if (privateKey.length <= 16)
+            return '*'.repeat(privateKey.length);
+        return privateKey.substring(0, 6) + '*'.repeat(privateKey.length - 12) + privateKey.substring(privateKey.length - 6);
+    }
+}
+/**
+ * Quick configuration helpers
+ */
+export const Config = {
+    /**
+     * Create configuration from environment variables
+     */
+    fromEnv: () => ConfigurationHelper.loadFromEnvironment(),
+    /**
+     * Create configuration with validation
+     */
+    create: (overrides) => ConfigurationHelper.createConfig(overrides),
+    /**
+     * Validate existing configuration
+     */
+    validate: (config) => ConfigurationHelper.validateConfig(config),
+    /**
+     * Get Gemini API key with helpful error messages
+     */
+    getGeminiKey: (key) => ConfigurationHelper.getGeminiApiKey(key),
+    /**
+     * Generate .env template
+     */
+    generateEnvTemplate: () => ConfigurationHelper.generateEnvTemplate()
+};
+export default ConfigurationHelper;
+//# sourceMappingURL=ConfigurationHelper.js.map

package/dist/config/ConfigurationHelper.js.map

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

package/dist/config/defaults.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Default PDW Configuration
+ *
+ * Provides sensible defaults for different environments
+ */
+import type { PDWConfig } from '../types';
+export declare function createDefaultConfig(): PDWConfig;
+export declare function createTestnetConfig(overrides?: Partial<PDWConfig>): PDWConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,wBAAgB,mBAAmB,IAAI,SAAS,CAsB/C;AAED,wBAAgB,mBAAmB,CAAC,SAAS,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS,CAmBjF"}

package/dist/config/defaults.js

@@ -0,0 +1,49 @@
+/**
+ * Default PDW Configuration
+ *
+ * Provides sensible defaults for different environments
+ */
+export function createDefaultConfig() {
+    return {
+        // Updated October 3, 2025 - Dynamic Fields Implementation
+        packageId: '0x6dc2fe501926b17f441e46c3ac121ad0924da3aa7c5bc78781ddd7df1080694a',
+        accessRegistryId: '0x0',
+        encryptionConfig: {
+            enabled: true,
+            keyServers: [], // To be configured based on environment
+            policyConfig: {
+                threshold: 2, // 2-of-3 threshold by default
+            },
+        },
+        storageConfig: {
+            cacheEnabled: true,
+            encryptionEnabled: true,
+        },
+        // Walrus Storage Configuration
+        walrusPublisherUrl: 'https://publisher.walrus-testnet.walrus.space',
+        walrusAggregatorUrl: 'https://aggregator.walrus-testnet.walrus.space',
+        walrusMaxFileSize: 1024 * 1024 * 1024, // 1GB
+        walrusTimeout: 30000, // 30 seconds
+    };
+}
+export function createTestnetConfig(overrides = {}) {
+    return {
+        ...createDefaultConfig(),
+        accessRegistryId: overrides.accessRegistryId ?? '0x0',
+        encryptionConfig: {
+            enabled: true,
+            keyServers: [
+                // Testnet SEAL key servers
+                '0x0' // Placeholder - will be updated with actual testnet servers
+            ],
+            policyConfig: {
+                threshold: 2,
+            },
+        },
+        // Testnet Walrus endpoints (same as default for now)
+        walrusPublisherUrl: 'https://publisher.walrus-testnet.walrus.space',
+        walrusAggregatorUrl: 'https://aggregator.walrus-testnet.walrus.space',
+        ...overrides,
+    };
+}
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,0DAA0D;QAC1D,SAAS,EAAE,oEAAoE;QAC/E,gBAAgB,EAAE,KAAK;QACvB,gBAAgB,EAAE;YAChB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE,EAAE,wCAAwC;YACxD,YAAY,EAAE;gBACZ,SAAS,EAAE,CAAC,EAAE,8BAA8B;aAC7C;SACF;QACD,aAAa,EAAE;YACb,YAAY,EAAE,IAAI;YAClB,iBAAiB,EAAE,IAAI;SACxB;QACD,+BAA+B;QAC/B,kBAAkB,EAAE,+CAA+C;QACnE,mBAAmB,EAAE,gDAAgD;QACrE,iBAAiB,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,MAAM;QAC7C,aAAa,EAAE,KAAK,EAAE,aAAa;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,YAAgC,EAAE;IACpE,OAAO;QACL,GAAG,mBAAmB,EAAE;QACxB,gBAAgB,EAAE,SAAS,CAAC,gBAAgB,IAAI,KAAK;QACrD,gBAAgB,EAAE;YAChB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE;gBACV,2BAA2B;gBAC3B,KAAK,CAAC,4DAA4D;aACnE;YACD,YAAY,EAAE;gBACZ,SAAS,EAAE,CAAC;aACb;SACF;QACD,qDAAqD;QACrD,kBAAkB,EAAE,+CAA+C;QACnE,mBAAmB,EAAE,gDAAgD;QACrE,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Configuration Module
+ *
+ * Comprehensive configuration management for the PDW SDK,
+ * including environment variable support and validation.
+ */
+export { ConfigurationHelper, Config } from './ConfigurationHelper';
+export type { SDKConfig, EnvironmentConfig } from './ConfigurationHelper';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,8 @@
+/**
+ * Configuration Module
+ *
+ * Comprehensive configuration management for the PDW SDK,
+ * including environment variable support and validation.
+ */
+export { ConfigurationHelper, Config } from './ConfigurationHelper.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/config/validation.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Configuration Validation
+ *
+ * Validates PDW configuration and provides helpful error messages
+ */
+import type { PDWConfig } from '../types';
+export declare class ConfigurationError extends Error {
+    constructor(message: string);
+}
+export declare function validateConfig(config: Partial<PDWConfig>): PDWConfig;
+export declare function mergeConfigs(base: PDWConfig, overrides: Partial<PDWConfig>): PDWConfig;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/config/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAgCpE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAqBtF"}

package/dist/config/validation.js

@@ -0,0 +1,61 @@
+/**
+ * Configuration Validation
+ *
+ * Validates PDW configuration and provides helpful error messages
+ */
+export class ConfigurationError extends Error {
+    constructor(message) {
+        super(`PDW Configuration Error: ${message}`);
+        this.name = 'ConfigurationError';
+    }
+}
+export function validateConfig(config) {
+    const errors = [];
+    // Validate required fields
+    if (!config.packageId || config.packageId === '0x0') {
+        console.warn('PDW SDK: packageId not configured. Please set a valid deployed package ID.');
+    }
+    // Validate encryption config
+    if (config.encryptionConfig?.enabled &&
+        (!config.encryptionConfig.keyServers || config.encryptionConfig.keyServers.length === 0)) {
+        console.warn('PDW SDK: Encryption is enabled but no key servers configured. Some features may not work.');
+    }
+    // Validate threshold configuration
+    if (config.encryptionConfig?.policyConfig?.threshold) {
+        const threshold = config.encryptionConfig.policyConfig.threshold;
+        if (threshold < 1) {
+            errors.push('Encryption threshold must be at least 1');
+        }
+    }
+    // Validate storage config
+    if (config.storageConfig?.provider && !['walrus', 'local'].includes(config.storageConfig.provider)) {
+        errors.push('Storage provider must be either "walrus" or "local"');
+    }
+    if (errors.length > 0) {
+        throw new ConfigurationError(errors.join('; '));
+    }
+    return config;
+}
+export function mergeConfigs(base, overrides) {
+    return {
+        ...base,
+        ...overrides,
+        encryptionConfig: {
+            enabled: true,
+            ...base.encryptionConfig,
+            ...overrides.encryptionConfig,
+            policyConfig: {
+                ...base.encryptionConfig?.policyConfig,
+                ...overrides.encryptionConfig?.policyConfig,
+            },
+        },
+        storageConfig: {
+            provider: 'walrus',
+            cacheEnabled: true,
+            encryptionEnabled: true,
+            ...base.storageConfig,
+            ...overrides.storageConfig,
+        },
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/config/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/config/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,MAA0B;IACvD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,2BAA2B;IAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IAC7F,CAAC;IAED,6BAA6B;IAC7B,IAAI,MAAM,CAAC,gBAAgB,EAAE,OAAO;QAChC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,UAAU,IAAI,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC7F,OAAO,CAAC,IAAI,CAAC,2FAA2F,CAAC,CAAC;IAC5G,CAAC;IAED,mCAAmC;IACnC,IAAI,MAAM,CAAC,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,SAAS,CAAC;QACjE,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM,CAAC,aAAa,EAAE,QAAQ,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnG,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAe,EAAE,SAA6B;IACzE,OAAO;QACL,GAAG,IAAI;QACP,GAAG,SAAS;QACZ,gBAAgB,EAAE;YAChB,OAAO,EAAE,IAAI;YACb,GAAG,IAAI,CAAC,gBAAgB;YACxB,GAAG,SAAS,CAAC,gBAAgB;YAC7B,YAAY,EAAE;gBACZ,GAAG,IAAI,CAAC,gBAAgB,EAAE,YAAY;gBACtC,GAAG,SAAS,CAAC,gBAAgB,EAAE,YAAY;aAC5C;SACF;QACD,aAAa,EAAE;YACb,QAAQ,EAAE,QAAiB;YAC3B,YAAY,EAAE,IAAI;YAClB,iBAAiB,EAAE,IAAI;YACvB,GAAG,IAAI,CAAC,aAAa;YACrB,GAAG,SAAS,CAAC,aAAa;SAC3B;KACF,CAAC;AACJ,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Core Module - Barrel Export
+ *
+ * Re-exports all core types, interfaces, and base classes for the PDW SDK.
+ *
+ * All type definitions are in ./types/index.ts
+ * This file only provides re-exports for convenience.
+ */
+export * from './interfaces';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,13 @@
+/**
+ * Core Module - Barrel Export
+ *
+ * Re-exports all core types, interfaces, and base classes for the PDW SDK.
+ *
+ * All type definitions are in ./types/index.ts
+ * This file only provides re-exports for convenience.
+ */
+// Re-export core interfaces and base classes
+export * from './interfaces/index.js';
+// Re-export all types from the types module
+export * from './types/index.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6CAA6C;AAC7C,cAAc,cAAc,CAAC;AAE7B,4CAA4C;AAC5C,cAAc,SAAS,CAAC"}

package/dist/core/interfaces/IService.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Base Service Interface
+ *
+ * Defines the standard interface that all services in the PDW SDK should implement.
+ * Provides consistent lifecycle management, error handling, logging, and metrics.
+ */
+/**
+ * Service lifecycle states
+ */
+export declare enum ServiceState {
+    UNINITIALIZED = "uninitialized",
+    INITIALIZING = "initializing",
+    READY = "ready",
+    ERROR = "error",
+    DESTROYED = "destroyed"
+}
+/**
+ * Service configuration base interface
+ */
+export interface IServiceConfig {
+    /** Service name for logging and metrics */
+    name?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Enable metrics collection */
+    enableMetrics?: boolean;
+    /** Custom logger instance */
+    logger?: ILogger;
+}
+/**
+ * Logger interface for consistent logging across services
+ */
+export interface ILogger {
+    debug(message: string, context?: Record<string, any>): void;
+    info(message: string, context?: Record<string, any>): void;
+    warn(message: string, context?: Record<string, any>): void;
+    error(message: string, error?: Error, context?: Record<string, any>): void;
+}
+/**
+ * Service metrics interface
+ */
+export interface IServiceMetrics {
+    /** Total number of operations performed */
+    operationCount: number;
+    /** Total number of errors encountered */
+    errorCount: number;
+    /** Average operation duration in milliseconds */
+    averageDuration: number;
+    /** Last operation timestamp */
+    lastOperationTime?: number;
+    /** Service uptime in milliseconds */
+    uptime: number;
+    /** Custom metrics specific to the service */
+    custom?: Record<string, number>;
+}
+/**
+ * Base service interface that all services should implement
+ */
+export interface IService {
+    /**
+     * Service name for identification
+     */
+    readonly name: string;
+    /**
+     * Current service state
+     */
+    readonly state: ServiceState;
+    /**
+     * Initialize the service
+     * Should be called before using the service
+     * @returns Promise that resolves when initialization is complete
+     */
+    initialize?(): Promise<void>;
+    /**
+     * Destroy the service and cleanup resources
+     * Should be called when the service is no longer needed
+     * @returns Promise that resolves when cleanup is complete
+     */
+    destroy?(): Promise<void>;
+    /**
+     * Reset the service to initial state
+     * Useful for testing or recovering from errors
+     * @returns Promise that resolves when reset is complete
+     */
+    reset?(): Promise<void>;
+    /**
+     * Get service health status
+     * @returns Health check result
+     */
+    getHealth?(): Promise<ServiceHealth>;
+    /**
+     * Get service metrics
+     * @returns Current service metrics
+     */
+    getMetrics?(): IServiceMetrics;
+}
+/**
+ * Service health check result
+ */
+export interface ServiceHealth {
+    /** Whether the service is healthy */
+    healthy: boolean;
+    /** Service state */
+    state: ServiceState;
+    /** Health check timestamp */
+    timestamp: number;
+    /** Optional error message if unhealthy */
+    error?: string;
+    /** Additional health details */
+    details?: Record<string, any>;
+}
+/**
+ * Default console logger implementation
+ */
+export declare class ConsoleLogger implements ILogger {
+    private serviceName;
+    private debugEnabled;
+    constructor(serviceName: string, debugEnabled?: boolean);
+    debug(message: string, context?: Record<string, any>): void;
+    info(message: string, context?: Record<string, any>): void;
+    warn(message: string, context?: Record<string, any>): void;
+    error(message: string, error?: Error, context?: Record<string, any>): void;
+}
+/**
+ * Abstract base service class with common functionality
+ */
+export declare abstract class BaseService implements IService {
+    protected config: IServiceConfig;
+    protected _state: ServiceState;
+    protected _logger: ILogger;
+    protected _metrics: IServiceMetrics;
+    protected _startTime: number;
+    constructor(config: IServiceConfig);
+    get name(): string;
+    get state(): ServiceState;
+    initialize(): Promise<void>;
+    destroy(): Promise<void>;
+    reset(): Promise<void>;
+    getHealth(): Promise<ServiceHealth>;
+    getMetrics(): IServiceMetrics;
+    /**
+     * Track an operation for metrics
+     */
+    protected trackOperation<T>(operationName: string, operation: () => Promise<T>): Promise<T>;
+    /**
+     * Update metrics with operation duration
+     */
+    private updateMetrics;
+    /**
+     * Hook for service-specific initialization
+     */
+    protected abstract onInitialize(): Promise<void>;
+    /**
+     * Hook for service-specific destruction
+     */
+    protected abstract onDestroy(): Promise<void>;
+    /**
+     * Hook for service-specific reset
+     */
+    protected abstract onReset(): Promise<void>;
+}
+//# sourceMappingURL=IService.d.ts.map