@bloomneo/appkit 1.2.9

package/dist/storage/strategies/s3.js

@@ -0,0 +1,461 @@
+/**
+ * S3-compatible storage strategy with automatic connection management and multi-provider support
+ * @module @bloomneo/appkit/storage
+ * @file src/storage/strategies/s3.ts
+ *
+ * @llm-rule WHEN: App has AWS_S3_BUCKET or S3_ENDPOINT env vars for distributed cloud storage
+ * @llm-rule AVOID: Manual S3 setup - this handles AWS, Wasabi, MinIO, DigitalOcean Spaces automatically
+ * @llm-rule NOTE: Production-ready with retry logic, signed URLs, CDN support, automatic MIME detection
+ */
+/**
+ * S3-compatible storage strategy with multi-provider support and reliability features
+ */
+export class S3Strategy {
+    config;
+    s3Client = null;
+    connected = false;
+    bucket;
+    region;
+    endpoint;
+    cdnUrl;
+    /**
+     * Creates S3 strategy with direct environment access (like auth pattern)
+     * @llm-rule WHEN: Storage initialization with S3-compatible environment variables detected
+     * @llm-rule AVOID: Manual S3 configuration - environment detection handles AWS/Wasabi/MinIO
+     */
+    constructor(config) {
+        this.config = config;
+        if (!config.s3) {
+            throw new Error('S3 storage configuration missing');
+        }
+        this.bucket = config.s3.bucket;
+        this.region = config.s3.region;
+        this.endpoint = config.s3.endpoint;
+        this.cdnUrl = config.s3.cdnUrl;
+    }
+    /**
+     * Connects to S3-compatible service with automatic retry and provider detection
+     * @llm-rule WHEN: Storage initialization or reconnection after failure
+     * @llm-rule AVOID: Manual S3 client setup - this handles all provider configurations
+     */
+    async connect() {
+        if (this.connected)
+            return;
+        try {
+            // Dynamic import for S3 client
+            const { S3Client } = await import('@aws-sdk/client-s3');
+            const s3Config = this.config.s3;
+            // Build S3 client configuration
+            const clientConfig = {
+                region: this.region,
+                credentials: {
+                    accessKeyId: s3Config.accessKeyId,
+                    secretAccessKey: s3Config.secretAccessKey,
+                },
+                maxAttempts: 3, // Built-in retry logic
+            };
+            // Configure for S3-compatible services (Wasabi, MinIO, etc.)
+            if (this.endpoint) {
+                clientConfig.endpoint = this.endpoint;
+                clientConfig.forcePathStyle = s3Config.forcePathStyle;
+            }
+            // Create S3 client
+            this.s3Client = new S3Client(clientConfig);
+            // Test connection by checking if bucket exists
+            await this.testConnection();
+            this.connected = true;
+            if (this.config.environment.isDevelopment) {
+                const provider = this.detectProvider();
+                console.log(`✅ [AppKit] S3 storage connected (provider: ${provider}, bucket: ${this.bucket})`);
+            }
+        }
+        catch (error) {
+            this.connected = false;
+            this.s3Client = null;
+            throw new Error(`S3 storage connection failed: ${error.message}`);
+        }
+    }
+    /**
+     * Tests S3 connection by checking bucket access
+     */
+    async testConnection() {
+        const { HeadBucketCommand } = await import('@aws-sdk/client-s3');
+        try {
+            await this.s3Client.send(new HeadBucketCommand({ Bucket: this.bucket }));
+        }
+        catch (error) {
+            if (error.name === 'NotFound') {
+                throw new Error(`S3 bucket not found: ${this.bucket}`);
+            }
+            if (error.name === 'Forbidden') {
+                throw new Error(`S3 bucket access denied: ${this.bucket}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Detects S3 provider from configuration
+     */
+    detectProvider() {
+        if (!this.endpoint)
+            return 'AWS S3';
+        const hostname = new URL(this.endpoint).hostname.toLowerCase();
+        if (hostname.includes('wasabi'))
+            return 'Wasabi';
+        if (hostname.includes('digitalocean'))
+            return 'DigitalOcean Spaces';
+        if (hostname.includes('minio') || hostname.includes('localhost'))
+            return 'MinIO';
+        if (hostname.includes('backblaze'))
+            return 'Backblaze B2';
+        return 'S3-Compatible';
+    }
+    /**
+     * Stores file to S3 with automatic content type detection and metadata
+     * @llm-rule WHEN: Uploading files to S3-compatible cloud storage
+     * @llm-rule AVOID: Manual S3 operations - this handles multipart uploads and metadata
+     */
+    async put(key, data, options) {
+        if (!this.connected || !this.s3Client) {
+            throw new Error('S3 storage not connected');
+        }
+        try {
+            const { PutObjectCommand } = await import('@aws-sdk/client-s3');
+            // Build S3 put parameters
+            const params = {
+                Bucket: this.bucket,
+                Key: key,
+                Body: data,
+                ContentType: options?.contentType || this.detectContentType(key, data),
+            };
+            // Add optional parameters
+            if (options?.cacheControl) {
+                params.CacheControl = options.cacheControl;
+            }
+            if (options?.expires) {
+                params.Expires = options.expires;
+            }
+            if (options?.metadata) {
+                params.Metadata = options.metadata;
+            }
+            // Execute upload
+            await this.s3Client.send(new PutObjectCommand(params));
+            if (this.config.environment.isDevelopment) {
+                console.log(`☁️ [AppKit] S3 file uploaded: ${key} (${data.length} bytes)`);
+            }
+            return key;
+        }
+        catch (error) {
+            throw new Error(`S3 upload failed: ${error.message}`);
+        }
+    }
+    /**
+     * Retrieves file from S3 with streaming support
+     * @llm-rule WHEN: Downloading files from S3-compatible storage
+     * @llm-rule AVOID: Manual S3 operations - this handles streaming and errors
+     */
+    async get(key) {
+        if (!this.connected || !this.s3Client) {
+            throw new Error('S3 storage not connected');
+        }
+        try {
+            const { GetObjectCommand } = await import('@aws-sdk/client-s3');
+            const params = {
+                Bucket: this.bucket,
+                Key: key,
+            };
+            const result = await this.s3Client.send(new GetObjectCommand(params));
+            if (!result.Body) {
+                throw new Error(`S3 object has no body: ${key}`);
+            }
+            // Convert stream to buffer
+            const buffer = await this.streamToBuffer(result.Body);
+            if (this.config.environment.isDevelopment) {
+                console.log(`☁️ [AppKit] S3 file downloaded: ${key} (${buffer.length} bytes)`);
+            }
+            return buffer;
+        }
+        catch (error) {
+            if (error.name === 'NoSuchKey') {
+                throw new Error(`File not found: ${key}`);
+            }
+            throw new Error(`S3 download failed: ${error.message}`);
+        }
+    }
+    /**
+     * Deletes file from S3 with confirmation
+     * @llm-rule WHEN: Removing files from S3-compatible storage
+     * @llm-rule AVOID: Silent failures - this confirms deletion success
+     */
+    async delete(key) {
+        if (!this.connected || !this.s3Client) {
+            console.error('S3 storage not connected');
+            return false;
+        }
+        try {
+            const { DeleteObjectCommand } = await import('@aws-sdk/client-s3');
+            const params = {
+                Bucket: this.bucket,
+                Key: key,
+            };
+            await this.s3Client.send(new DeleteObjectCommand(params));
+            if (this.config.environment.isDevelopment) {
+                console.log(`🗑️ [AppKit] S3 file deleted: ${key}`);
+            }
+            return true;
+        }
+        catch (error) {
+            console.error(`[AppKit] S3 delete error for "${key}":`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Lists files with prefix filtering and pagination
+     * @llm-rule WHEN: Browsing S3 files or implementing file managers
+     * @llm-rule AVOID: Loading all objects - use prefix filtering and pagination
+     */
+    async list(prefix = '') {
+        if (!this.connected || !this.s3Client) {
+            throw new Error('S3 storage not connected');
+        }
+        try {
+            const { ListObjectsV2Command } = await import('@aws-sdk/client-s3');
+            const params = {
+                Bucket: this.bucket,
+                MaxKeys: 1000, // Limit results for performance
+            };
+            if (prefix) {
+                params.Prefix = prefix;
+            }
+            const result = await this.s3Client.send(new ListObjectsV2Command(params));
+            const files = [];
+            if (result.Contents) {
+                for (const object of result.Contents) {
+                    if (object.Key) {
+                        files.push({
+                            key: object.Key,
+                            size: object.Size || 0,
+                            lastModified: object.LastModified || new Date(),
+                            etag: object.ETag?.replace(/"/g, ''), // Remove quotes from ETag
+                            contentType: await this.getObjectContentType(object.Key),
+                        });
+                    }
+                }
+            }
+            if (this.config.environment.isDevelopment) {
+                console.log(`☁️ [AppKit] S3 files listed: ${prefix}* (${files.length} files)`);
+            }
+            return files;
+        }
+        catch (error) {
+            console.error(`[AppKit] S3 list error for prefix "${prefix}":`, error.message);
+            return [];
+        }
+    }
+    /**
+     * Gets public or CDN URL for S3 object
+     * @llm-rule WHEN: Generating URLs for S3 file access with CDN support
+     * @llm-rule AVOID: Hardcoded URLs - this handles CDN and region-specific URLs
+     */
+    url(key) {
+        // Use CDN URL if configured
+        if (this.cdnUrl) {
+            const baseUrl = this.cdnUrl.endsWith('/') ? this.cdnUrl : this.cdnUrl + '/';
+            const cleanKey = key.startsWith('/') ? key.slice(1) : key;
+            return baseUrl + cleanKey;
+        }
+        // Generate S3 public URL
+        if (this.endpoint) {
+            // Custom endpoint (Wasabi, MinIO, etc.)
+            const baseUrl = this.endpoint.endsWith('/') ? this.endpoint : this.endpoint + '/';
+            return `${baseUrl}${this.bucket}/${key}`;
+        }
+        // AWS S3 URL
+        return `https://${this.bucket}.s3.${this.region}.amazonaws.com/${key}`;
+    }
+    /**
+     * Generates signed URL for temporary S3 object access
+     * @llm-rule WHEN: Creating temporary download/upload links for S3 objects
+     * @llm-rule AVOID: Permanent URLs for private files - use signed URLs with expiration
+     */
+    async signedUrl(key, expiresIn = 3600) {
+        if (!this.connected || !this.s3Client) {
+            throw new Error('S3 storage not connected');
+        }
+        try {
+            const { GetObjectCommand } = await import('@aws-sdk/client-s3');
+            const { getSignedUrl } = await import('@aws-sdk/s3-request-presigner');
+            const command = new GetObjectCommand({
+                Bucket: this.bucket,
+                Key: key,
+            });
+            const signedUrl = await getSignedUrl(this.s3Client, command, {
+                expiresIn,
+            });
+            if (this.config.environment.isDevelopment) {
+                console.log(`🔐 [AppKit] S3 signed URL generated: ${key} (expires in ${expiresIn}s)`);
+            }
+            return signedUrl;
+        }
+        catch (error) {
+            throw new Error(`S3 signed URL generation failed: ${error.message}`);
+        }
+    }
+    /**
+     * Checks if S3 object exists without downloading
+     * @llm-rule WHEN: Validating S3 object existence efficiently
+     * @llm-rule AVOID: Downloading objects just to check existence
+     */
+    async exists(key) {
+        if (!this.connected || !this.s3Client) {
+            return false;
+        }
+        try {
+            const { HeadObjectCommand } = await import('@aws-sdk/client-s3');
+            const params = {
+                Bucket: this.bucket,
+                Key: key,
+            };
+            await this.s3Client.send(new HeadObjectCommand(params));
+            return true;
+        }
+        catch (error) {
+            if (error.name === 'NotFound' || error.name === 'NoSuchKey') {
+                return false;
+            }
+            console.error(`[AppKit] S3 exists check error for "${key}":`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Copies S3 object efficiently using server-side copy
+     * @llm-rule WHEN: Duplicating S3 objects without downloading/uploading
+     * @llm-rule AVOID: Download and upload - S3 server-side copy is much faster
+     */
+    async copy(sourceKey, destKey) {
+        if (!this.connected || !this.s3Client) {
+            throw new Error('S3 storage not connected');
+        }
+        try {
+            const { CopyObjectCommand } = await import('@aws-sdk/client-s3');
+            const params = {
+                Bucket: this.bucket,
+                Key: destKey,
+                CopySource: `${this.bucket}/${sourceKey}`,
+            };
+            await this.s3Client.send(new CopyObjectCommand(params));
+            if (this.config.environment.isDevelopment) {
+                console.log(`☁️ [AppKit] S3 file copied: ${sourceKey} → ${destKey}`);
+            }
+            return destKey;
+        }
+        catch (error) {
+            throw new Error(`S3 copy failed: ${error.message}`);
+        }
+    }
+    /**
+     * Disconnects S3 strategy gracefully
+     * @llm-rule WHEN: App shutdown or storage cleanup
+     * @llm-rule AVOID: Abrupt disconnection - graceful shutdown prevents connection issues
+     */
+    async disconnect() {
+        if (!this.connected)
+            return;
+        try {
+            // S3 client doesn't need explicit disconnection
+            // Could implement connection pooling cleanup here if needed
+            this.connected = false;
+            this.s3Client = null;
+            if (this.config.environment.isDevelopment) {
+                console.log(`👋 [AppKit] S3 storage strategy disconnected`);
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] S3 disconnect error:`, error.message);
+        }
+    }
+    // Private helper methods
+    /**
+     * Converts readable stream to buffer
+     */
+    async streamToBuffer(stream) {
+        const chunks = [];
+        return new Promise((resolve, reject) => {
+            stream.on('data', (chunk) => chunks.push(chunk));
+            stream.on('error', reject);
+            stream.on('end', () => resolve(Buffer.concat(chunks)));
+        });
+    }
+    /**
+     * Detects content type from file extension and buffer
+     */
+    detectContentType(key, buffer) {
+        // Get extension from key
+        const ext = key.split('.').pop()?.toLowerCase();
+        // Common MIME types
+        const mimeTypes = {
+            'jpg': 'image/jpeg',
+            'jpeg': 'image/jpeg',
+            'png': 'image/png',
+            'gif': 'image/gif',
+            'webp': 'image/webp',
+            'svg': 'image/svg+xml',
+            'pdf': 'application/pdf',
+            'txt': 'text/plain',
+            'json': 'application/json',
+            'csv': 'text/csv',
+            'zip': 'application/zip',
+            'mp4': 'video/mp4',
+            'webm': 'video/webm',
+            'mp3': 'audio/mpeg',
+            'wav': 'audio/wav',
+        };
+        if (ext && mimeTypes[ext]) {
+            return mimeTypes[ext];
+        }
+        // Simple buffer-based detection for images
+        const magic = buffer.subarray(0, 4);
+        if (magic[0] === 0xFF && magic[1] === 0xD8 && magic[2] === 0xFF) {
+            return 'image/jpeg';
+        }
+        if (magic[0] === 0x89 && magic[1] === 0x50 && magic[2] === 0x4E && magic[3] === 0x47) {
+            return 'image/png';
+        }
+        if (magic[0] === 0x47 && magic[1] === 0x49 && magic[2] === 0x46) {
+            return 'image/gif';
+        }
+        return 'application/octet-stream';
+    }
+    /**
+     * Gets content type for existing S3 object
+     */
+    async getObjectContentType(key) {
+        try {
+            const { HeadObjectCommand } = await import('@aws-sdk/client-s3');
+            const params = {
+                Bucket: this.bucket,
+                Key: key,
+            };
+            const result = await this.s3Client.send(new HeadObjectCommand(params));
+            return result.ContentType;
+        }
+        catch (error) {
+            // If we can't get content type, return undefined
+            return undefined;
+        }
+    }
+    /**
+     * Gets S3 connection info for debugging
+     */
+    getConnectionInfo() {
+        return {
+            connected: this.connected,
+            bucket: this.bucket,
+            region: this.region,
+            endpoint: this.endpoint,
+            provider: this.detectProvider(),
+            cdnEnabled: !!this.cdnUrl,
+        };
+    }
+}
+//# sourceMappingURL=s3.js.map

package/dist/storage/strategies/s3.js.map

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

package/dist/util/defaults.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Smart defaults and environment validation for utilities
+ * @module @bloomneo/appkit/util
+ * @file src/util/defaults.ts
+ *
+ * @llm-rule WHEN: App startup - need to configure utility behavior and performance settings
+ * @llm-rule AVOID: Calling multiple times - expensive environment parsing, use lazy loading in get()
+ * @llm-rule NOTE: Called once at startup, cached globally for performance like other modules
+ */
+export interface CacheConfig {
+    enabled: boolean;
+    maxSize: number;
+    ttl: number;
+}
+export interface PerformanceConfig {
+    enabled: boolean;
+    memoization: boolean;
+    largeArrayThreshold: number;
+    chunkSizeLimit: number;
+}
+export interface DebugConfig {
+    enabled: boolean;
+    logOperations: boolean;
+    trackPerformance: boolean;
+}
+export interface SlugifyConfig {
+    lowercase: boolean;
+    strict: boolean;
+    locale: string;
+    replacement: string;
+}
+export interface FormatConfig {
+    locale: string;
+    currency: string;
+    dateFormat: string;
+    numberPrecision: number;
+}
+export interface EnvironmentConfig {
+    isDevelopment: boolean;
+    isProduction: boolean;
+    isTest: boolean;
+    nodeEnv: string;
+}
+export interface UtilConfig {
+    version: string;
+    cache: CacheConfig;
+    performance: PerformanceConfig;
+    debug: DebugConfig;
+    slugify: SlugifyConfig;
+    format: FormatConfig;
+    environment: EnvironmentConfig;
+}
+/**
+ * Gets smart defaults using VOILA_UTIL_* environment variables
+ * @llm-rule WHEN: App startup to get production-ready utility configuration
+ * @llm-rule AVOID: Calling repeatedly - expensive validation, cache the result
+ * @llm-rule NOTE: Called once at startup, cached globally for performance
+ */
+export declare function getSmartDefaults(): UtilConfig;
+/**
+ * Creates utility error with helpful context
+ * @llm-rule WHEN: Creating errors in utility functions for better debugging
+ * @llm-rule AVOID: Using generic Error objects - utility errors need context
+ */
+export declare function createUtilityError(message: string, operation?: string, input?: any): Error;
+/**
+ * Default configuration constants for reference
+ */
+export declare const DEFAULT_CACHE_SIZE = 1000;
+export declare const DEFAULT_CACHE_TTL = 300000;
+export declare const DEFAULT_ARRAY_THRESHOLD = 10000;
+export declare const DEFAULT_CHUNK_LIMIT = 100000;
+export declare const DEFAULT_NUMBER_PRECISION = 2;
+export declare const DEFAULT_LOCALE = "en-US";
+export declare const DEFAULT_CURRENCY = "USD";
+export declare const DEFAULT_SLUGIFY_REPLACEMENT = "-";
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/util/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAyD7C;AA6ID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,GAAG,GACV,KAAK,CAYP;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,iBAAiB,SAAS,CAAC;AACxC,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAC1C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,2BAA2B,MAAM,CAAC"}