@realtimex/email-automator 2.1.0

package/api/src/utils/logger.ts

@@ -0,0 +1,142 @@
+import { config } from '../config/index.js';
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+
+interface LogMeta {
+    [key: string]: unknown;
+}
+
+const LOG_COLORS = {
+    debug: '\x1b[36m', // cyan
+    info: '\x1b[32m',  // green
+    warn: '\x1b[33m',  // yellow
+    error: '\x1b[31m', // red
+    reset: '\x1b[0m',
+};
+
+const LOG_LEVELS: Record<LogLevel, number> = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+
+export class Logger {
+    private minLevel: LogLevel;
+    private context?: string;
+    private static supabaseClient: any = null;
+    private static currentUserId: string | null = null;
+
+    constructor(context?: string) {
+        this.minLevel = config.isProduction ? 'info' : 'debug';
+        this.context = context;
+    }
+
+    /**
+     * Set the Supabase client and current user ID for DB persistence.
+     * This is called by the auth middleware or server initialization.
+     */
+    static setPersistence(client: any, userId: string | null = null): void {
+        Logger.supabaseClient = client;
+        Logger.currentUserId = userId;
+    }
+
+    private shouldLog(level: LogLevel): boolean {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.minLevel];
+    }
+
+    private async saveToSupabase(level: LogLevel, message: string, meta?: LogMeta): Promise<void> {
+        // Only persist warn and error levels to DB to prevent bloat
+        // unless explicitly forced via meta
+        const persistLevels: LogLevel[] = ['warn', 'error'];
+        const shouldPersist = persistLevels.includes(level) || meta?._persist === true;
+
+        if (shouldPersist && Logger.supabaseClient) {
+            try {
+                // Remove internal flags from meta before saving
+                const { _persist, ...cleanMeta } = meta || {};
+                
+                await Logger.supabaseClient.from('system_logs').insert({
+                    user_id: Logger.currentUserId,
+                    level,
+                    source: this.context || 'System',
+                    message,
+                    metadata: cleanMeta,
+                    created_at: new Date().toISOString()
+                });
+            } catch (err) {
+                // Fail silently to avoid infinite loops if logging fails
+                console.error('[Logger] Failed to persist log to Supabase:', err);
+            }
+        }
+    }
+
+    private formatMessage(level: LogLevel, message: string, meta?: LogMeta): string {
+        const timestamp = new Date().toISOString();
+        const contextStr = this.context ? `[${this.context}]` : '';
+        const { _persist, ...cleanMeta } = meta || {};
+        const metaStr = Object.keys(cleanMeta).length > 0 ? ` ${JSON.stringify(cleanMeta)}` : '';
+        
+        if (config.isProduction) {
+            return JSON.stringify({
+                timestamp,
+                level,
+                context: this.context,
+                message,
+                ...cleanMeta,
+            });
+        }
+        
+        const color = LOG_COLORS[level];
+        const reset = LOG_COLORS.reset;
+        return `${timestamp} ${color}${level.toUpperCase().padEnd(5)}${reset} ${contextStr} ${message}${metaStr}`;
+    }
+
+    debug(message: string, meta?: LogMeta): void {
+        if (this.shouldLog('debug')) {
+            console.debug(this.formatMessage('debug', message, meta));
+            this.saveToSupabase('debug', message, meta);
+        }
+    }
+
+    info(message: string, meta?: LogMeta): void {
+        if (this.shouldLog('info')) {
+            console.info(this.formatMessage('info', message, meta));
+            this.saveToSupabase('info', message, meta);
+        }
+    }
+
+    warn(message: string, meta?: LogMeta): void {
+        if (this.shouldLog('warn')) {
+            console.warn(this.formatMessage('warn', message, meta));
+            this.saveToSupabase('warn', message, meta);
+        }
+    }
+
+    error(message: string, error?: Error | unknown, meta?: LogMeta): void {
+        if (this.shouldLog('error')) {
+            const errorMeta: LogMeta = { ...meta };
+            if (error instanceof Error) {
+                errorMeta.errorName = error.name;
+                errorMeta.errorMessage = error.message;
+                errorMeta.stack = error.stack;
+            } else if (error) {
+                errorMeta.error = error;
+            }
+            console.error(this.formatMessage('error', message, errorMeta));
+            this.saveToSupabase('error', message, errorMeta);
+        }
+    }
+
+    child(context: string): Logger {
+        return new Logger(this.context ? `${this.context}:${context}` : context);
+    }
+}
+
+// Default logger instance
+export const logger = new Logger();
+
+// Factory for creating contextual loggers
+export function createLogger(context: string): Logger {
+    return new Logger(context);
+}

package/bin/email-automator-deploy.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+/**
+ * Email Automator Deploy CLI
+ * Deploy Edge Functions to Supabase
+ */
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { existsSync } from 'fs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+console.log('🚀 Email Automator - Edge Functions Deployment');
+console.log('===============================================');
+console.log('');
+
+// Check if supabase CLI is available
+const checkSupabase = spawn('supabase', ['--version'], { stdio: 'pipe' });
+
+checkSupabase.on('error', () => {
+  console.error('❌ Supabase CLI not found');
+  console.error('');
+  console.error('Install it with:');
+  console.error('  npm install -g supabase');
+  console.error('');
+  console.error('Or via Homebrew (macOS):');
+  console.error('  brew install supabase/tap/supabase');
+  console.error('');
+  process.exit(1);
+});
+
+checkSupabase.on('close', (code) => {
+  if (code !== 0) {
+    console.error('❌ Supabase CLI check failed');
+    process.exit(1);
+  }
+
+  console.log('✅ Supabase CLI detected');
+  console.log('');
+
+  // Run deployment script
+  const deployScript = join(__dirname, '..', 'scripts', 'deploy-functions.sh');
+
+  if (!existsSync(deployScript)) {
+    console.error('❌ Deployment script not found:', deployScript);
+    process.exit(1);
+  }
+
+  console.log('📦 Deploying Edge Functions...');
+  console.log('');
+
+  const deploy = spawn('bash', [deployScript], {
+    stdio: 'inherit',
+    cwd: join(__dirname, '..'),
+  });
+
+  deploy.on('error', (error) => {
+    console.error('❌ Deployment failed:', error.message);
+    process.exit(1);
+  });
+
+  deploy.on('close', (code) => {
+    if (code !== 0) {
+      console.error('\n❌ Deployment failed with code', code);
+      process.exit(code);
+    }
+
+    console.log('');
+    console.log('✅ Deployment complete!');
+    console.log('');
+    console.log('🔐 Don\'t forget to configure secrets in Supabase Dashboard:');
+    console.log('   Settings → Edge Functions → Add secrets');
+    console.log('');
+    process.exit(0);
+  });
+});

package/bin/email-automator-setup.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+
+/**
+ * Email Automator Setup CLI
+ * Interactive setup for Email Automator
+ */
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import readline from 'readline';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+function question(query) {
+  return new Promise((resolve) => {
+    rl.question(query, resolve);
+  });
+}
+
+async function setup() {
+  console.log('');
+  console.log('🎯 Email Automator Setup');
+  console.log('========================');
+  console.log('');
+
+  const envPath = join(__dirname, '..', '.env');
+  const envExamplePath = join(__dirname, '..', '.env.example');
+
+  // Check if .env already exists
+  if (existsSync(envPath)) {
+    const overwrite = await question('⚠️  .env file already exists. Overwrite? (y/N): ');
+    if (overwrite.toLowerCase() !== 'y') {
+      console.log('Setup cancelled.');
+      rl.close();
+      return;
+    }
+  }
+
+  console.log('');
+  console.log('📝 Let\'s configure your Email Automator...');
+  console.log('');
+
+  // Supabase Configuration
+  console.log('1️⃣  Supabase Configuration');
+  console.log('   (Get these from: https://supabase.com/dashboard/project/_/settings/api)');
+  console.log('');
+  const supabaseUrl = await question('   Supabase URL: ');
+  const supabaseAnonKey = await question('   Supabase Anon Key: ');
+
+  // API Configuration
+  console.log('');
+  console.log('2️⃣  API Configuration');
+  const port = await question('   API Port [3004]: ') || '3004';
+
+  // LLM Configuration
+  console.log('');
+  console.log('3️⃣  LLM Configuration');
+  const llmApiKey = await question('   OpenAI API Key: ');
+  const llmModel = await question('   Model [gpt-4o-mini]: ') || 'gpt-4o-mini';
+
+  // OAuth Configuration (optional)
+  console.log('');
+  console.log('4️⃣  OAuth Configuration (Optional - skip for now if not ready)');
+  const gmailClientId = await question('   Gmail Client ID [skip]: ') || 'your_gmail_client_id';
+  const gmailClientSecret = await question('   Gmail Client Secret [skip]: ') || 'your_gmail_client_secret';
+
+  // Generate encryption key
+  const encryptionKey = Array.from({ length: 32 }, () =>
+    Math.random().toString(36).substring(2, 3)
+  ).join('');
+
+  // Create .env content
+  const envContent = `# Supabase Configuration
+VITE_SUPABASE_URL=${supabaseUrl}
+VITE_SUPABASE_ANON_KEY=${supabaseAnonKey}
+
+# API Configuration
+VITE_API_URL=http://localhost:${port}
+PORT=${port}
+
+# OpenAI / LLM Configuration
+LLM_API_KEY=${llmApiKey}
+LLM_BASE_URL=https://api.openai.com/v1
+LLM_MODEL=${llmModel}
+
+# Security
+JWT_SECRET="dev-secret-change-in-production"
+TOKEN_ENCRYPTION_KEY="${encryptionKey}"
+
+# Development
+DISABLE_AUTH=true
+
+# Gmail OAuth (optional)
+GMAIL_CLIENT_ID=${gmailClientId}
+GMAIL_CLIENT_SECRET=${gmailClientSecret}
+
+# Microsoft Graph (optional)
+MS_GRAPH_CLIENT_ID=your_ms_graph_client_id
+MS_GRAPH_TENANT_ID=common
+MS_GRAPH_CLIENT_SECRET=your_ms_graph_client_secret
+
+# Processing
+EMAIL_BATCH_SIZE=20
+SYNC_INTERVAL_MS=300000
+`;
+
+  // Write .env file
+  writeFileSync(envPath, envContent);
+
+  console.log('');
+  console.log('✅ Configuration saved to .env');
+  console.log('');
+  console.log('📚 Next Steps:');
+  console.log('');
+  console.log('   1. Deploy Edge Functions:');
+  console.log('      $ supabase login');
+  console.log('      $ ./scripts/deploy-functions.sh');
+  console.log('');
+  console.log('   2. Configure Edge Function secrets in Supabase Dashboard:');
+  console.log('      Settings → Edge Functions → Add secrets');
+  console.log('');
+  console.log('   3. Start Email Automator:');
+  console.log('      $ npx email-automator');
+  console.log('      or');
+  console.log('      $ npm run dev:api');
+  console.log('');
+  console.log('📖 Documentation: https://github.com/therealtimex/email-automator');
+  console.log('');
+
+  rl.close();
+}
+
+setup().catch((error) => {
+  console.error('❌ Setup failed:', error.message);
+  rl.close();
+  process.exit(1);
+});

package/bin/email-automator.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * Email Automator CLI
+ * Main command to run the Email Automator API server
+ */
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+
+// Default port
+let port = '3004';
+const portIndex = args.indexOf('--port');
+if (portIndex !== -1 && args[portIndex + 1]) {
+  port = args[portIndex + 1];
+}
+
+const noUi = args.includes('--no-ui');
+
+console.log('🚀 Starting Email Automator...');
+console.log(`📡 Port: ${port}`);
+if (noUi) console.log('🖥️  Mode: No-UI');
+console.log('');
+
+// Path to server
+const serverPath = join(__dirname, '..', 'api', 'server.ts');
+
+// Start server with tsx
+const server = spawn('npx', ['tsx', serverPath, ...args], {
+  stdio: 'inherit',
+  env: { ...process.env, PORT: port },
+});
+
+server.on('error', (error) => {
+  console.error('❌ Failed to start Email Automator:', error.message);
+  process.exit(1);
+});
+
+server.on('close', (code) => {
+  if (code !== 0) {
+    console.log(`\n⚠️  Email Automator stopped with code ${code}`);
+  }
+  process.exit(code || 0);
+});
+
+// Handle graceful shutdown
+process.on('SIGINT', () => {
+  console.log('\n\n⏹️  Shutting down Email Automator...');
+  server.kill('SIGINT');
+});
+
+process.on('SIGTERM', () => {
+  server.kill('SIGTERM');
+});