lettactl 0.2.1 → 0.3.1

package/dist/lib/storage-backend.js.map

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

package/dist/lib/storage-error-handler.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Centralized error handling for storage backends
+ * Provides consistent error messages and handling across different cloud providers
+ */
+export interface StorageErrorContext {
+    provider: string;
+    operation: string;
+    bucket?: string;
+    filePath?: string;
+    pattern?: string;
+}
+export declare class StorageErrorHandler {
+    /**
+     * Handle HTTP status-based errors with provider-specific context
+     */
+    static handleHttpError(error: any, context: StorageErrorContext, statusCode?: number): never;
+    /**
+     * Handle provider-specific errors with fallback to generic handling
+     */
+    static handleProviderError(error: any, context: StorageErrorContext): never;
+    /**
+     * Handle Supabase-specific error patterns
+     */
+    private static handleSupabaseError;
+    /**
+     * Handle AWS S3-specific error patterns
+     * TODO: Implement when S3 backend is added
+     */
+    private static handleS3Error;
+    /**
+     * Handle Google Cloud Storage-specific error patterns
+     * TODO: Implement when GCS backend is added
+     */
+    private static handleGCSError;
+    /**
+     * Generic error handling for unknown or unexpected errors
+     */
+    private static handleGenericError;
+    /**
+     * Wrap async storage operations with consistent error handling
+     */
+    static wrapStorageOperation<T>(operation: () => Promise<T>, context: StorageErrorContext): Promise<T>;
+}
+//# sourceMappingURL=storage-error-handler.d.ts.map

package/dist/lib/storage-error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-error-handler.d.ts","sourceRoot":"","sources":["../../src/lib/storage-error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,mBAAmB;IAE9B;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE,mBAAmB,EAC5B,UAAU,CAAC,EAAE,MAAM,GAClB,KAAK;IAwDR;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE,mBAAmB,GAC3B,KAAK;IAeR;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA6ClC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAM5B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA4BjC;;OAEG;WACU,oBAAoB,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;CAOd"}

package/dist/lib/storage-error-handler.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Centralized error handling for storage backends
+ * Provides consistent error messages and handling across different cloud providers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageErrorHandler = void 0;
+class StorageErrorHandler {
+    /**
+     * Handle HTTP status-based errors with provider-specific context
+     */
+    static handleHttpError(error, context, statusCode) {
+        const { provider, operation, bucket, filePath } = context;
+        const resource = bucket && filePath ? `${bucket}/${filePath}` : bucket || filePath || 'resource';
+        let errorMessage = `Failed to ${operation} ${resource} (${provider})`;
+        const status = statusCode || error.status || error.originalError?.status;
+        switch (status) {
+            case 400:
+                if (provider.toLowerCase() === 'supabase') {
+                    // Check if error indicates bucket doesn't exist
+                    if (error.message && (error.message.includes('bucket') || error.message.includes('not found'))) {
+                        errorMessage += `: Bucket '${bucket}' not found. Check: 1) bucket name is spelled correctly, 2) bucket exists in your Supabase project, 3) you're connected to the right project.`;
+                    }
+                    else {
+                        errorMessage += `: Bad request - this could be: 1) bucket '${bucket}' doesn't exist, 2) file '${filePath}' doesn't exist, 3) bucket is private (needs RLS policy or make bucket public), 4) wrong RLS policy configuration, 5) invalid file path '${filePath}', 6) malformed request, or 7) something else (Supabase error messages aren't clear here). Check: bucket exists, file exists, is public or has proper RLS, and file path is correct.`;
+                    }
+                }
+                else {
+                    errorMessage += `: Bad request - this could be: 1) bucket '${bucket}' doesn't exist, 2) invalid file path '${filePath}', or 3) malformed request. Check bucket exists and path is correct.`;
+                }
+                break;
+            case 401:
+                errorMessage += `: Unauthorized. Please check your ${provider} credentials.`;
+                break;
+            case 403:
+                errorMessage += `: Access denied. Please check your ${provider} credentials and bucket permissions.`;
+                break;
+            case 404:
+                if (filePath) {
+                    errorMessage += `: File not found. Please check that '${filePath}' exists in the '${bucket}' bucket.`;
+                }
+                else {
+                    errorMessage += `: Resource not found. Please check the bucket or path exists.`;
+                }
+                break;
+            case 429:
+                errorMessage += `: Rate limit exceeded. Please try again later.`;
+                break;
+            case 500:
+            case 502:
+            case 503:
+            case 504:
+                errorMessage += `: ${provider} service outage or maintenance (HTTP ${status}). This is a server-side issue. Please try again in a few minutes or check ${provider} status page.`;
+                break;
+            default:
+                if (status >= 500 && status < 600) {
+                    errorMessage += `: ${provider} server error (HTTP ${status}). Please try again or contact ${provider} support.`;
+                }
+                else if (status) {
+                    errorMessage += `: HTTP ${status} error. Check ${provider} Storage configuration.`;
+                }
+                else {
+                    errorMessage += `: Unknown error. Check ${provider} Storage configuration and network connectivity.`;
+                }
+        }
+        throw new Error(errorMessage);
+    }
+    /**
+     * Handle provider-specific errors with fallback to generic handling
+     */
+    static handleProviderError(error, context) {
+        const { provider } = context;
+        switch (provider.toLowerCase()) {
+            case 'supabase':
+                return this.handleSupabaseError(error, context);
+            case 's3':
+                return this.handleS3Error(error, context);
+            case 'gcs':
+                return this.handleGCSError(error, context);
+            default:
+                return this.handleGenericError(error, context);
+        }
+    }
+    /**
+     * Handle Supabase-specific error patterns
+     */
+    static handleSupabaseError(error, context) {
+        // Handle StorageUnknownError - check status to differentiate bucket vs auth issues
+        if (error.__isStorageError && error.name === 'StorageUnknownError') {
+            const status = error.originalError?.status;
+            if (status === 400) {
+                throw new Error(`Failed to ${context.operation} ${context.bucket}/${context.filePath} (supabase): ` +
+                    `Bucket '${context.bucket}' doesn't exist. Check: 1) bucket name is spelled correctly, ` +
+                    `2) bucket exists in your Supabase project, 3) you're connected to the right project.`);
+            }
+            else if (!error.originalError || Object.keys(error.originalError).length === 0) {
+                throw new Error(`Failed to ${context.operation} ${context.bucket}/${context.filePath} (supabase): ` +
+                    'Authentication error. Please check your SUPABASE_ANON_KEY is correct and not expired. ' +
+                    'Get a new one from Supabase Dashboard > Settings > API.');
+            }
+        }
+        // Handle Supabase StorageError with originalError
+        if (error.__isStorageError && error.originalError && error.originalError.status) {
+            return this.handleHttpError(error, context, error.originalError.status);
+        }
+        // Handle direct Supabase error messages
+        if (error.message) {
+            if (error.message.includes('Object not found')) {
+                context.operation = 'download';
+                return this.handleHttpError(error, context, 404);
+            }
+            if (error.message.includes('Bucket not found') || error.message.includes('The resource you requested could not be found')) {
+                throw new Error(`Failed to ${context.operation} ${context.bucket}/${context.filePath} (supabase): ` +
+                    `Bucket '${context.bucket}' doesn't exist. Check: 1) bucket name is spelled correctly, ` +
+                    `2) bucket exists in your Supabase project, 3) you're connected to the right project.`);
+            }
+        }
+        // Fallback to generic handling
+        return this.handleGenericError(error, context);
+    }
+    /**
+     * Handle AWS S3-specific error patterns
+     * TODO: Implement when S3 backend is added
+     */
+    static handleS3Error(error, context) {
+        // S3-specific error handling will go here
+        // e.g., NoSuchBucket, NoSuchKey, AccessDenied, etc.
+        return this.handleGenericError(error, context);
+    }
+    /**
+     * Handle Google Cloud Storage-specific error patterns
+     * TODO: Implement when GCS backend is added
+     */
+    static handleGCSError(error, context) {
+        // GCS-specific error handling will go here
+        return this.handleGenericError(error, context);
+    }
+    /**
+     * Generic error handling for unknown or unexpected errors
+     */
+    static handleGenericError(error, context) {
+        const { provider, operation, bucket, filePath } = context;
+        const resource = bucket && filePath ? `${bucket}/${filePath}` : bucket || filePath || 'resource';
+        // Handle SSL/certificate issues common in corporate environments
+        if (error.code === 'UNABLE_TO_VERIFY_LEAF_SIGNATURE' ||
+            error.code === 'CERT_UNTRUSTED' ||
+            error.code === 'SELF_SIGNED_CERT_IN_CHAIN' ||
+            error.message?.includes('certificate') ||
+            error.message?.includes('SSL') ||
+            error.message?.includes('TLS')) {
+            throw new Error(`SSL/Certificate error connecting to ${provider}: ${error.message}. ` +
+                `If you're on a corporate network, try: 1) disconnect/reconnect VPN, 2) check with IT about certificate issues, 3) try from a different network.`);
+        }
+        let errorMessage = `${provider} storage error while trying to ${operation} ${resource}`;
+        if (error.message) {
+            errorMessage += `: ${error.message}`;
+        }
+        else {
+            errorMessage += `: ${JSON.stringify(error)}`;
+        }
+        throw new Error(errorMessage);
+    }
+    /**
+     * Wrap async storage operations with consistent error handling
+     */
+    static async wrapStorageOperation(operation, context) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            this.handleProviderError(error, context);
+        }
+    }
+}
+exports.StorageErrorHandler = StorageErrorHandler;
+//# sourceMappingURL=storage-error-handler.js.map

package/dist/lib/storage-error-handler.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lettactl",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "kubectl-style CLI for managing Letta AI agent fleets",
   "main": "dist/index.js",
   "bin": {
@@ -44,9 +44,11 @@
   ],
   "dependencies": {
     "@letta-ai/letta-client": "^1.3.2",
+    "@supabase/supabase-js": "^2.86.2",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.2",
+    "glob": "^13.0.0",
     "js-yaml": "^4.1.1",
     "ora": "^9.0.0"
   },