@realtimex/email-automator 2.2.0 → 2.3.0

package/src/lib/migration-check.ts

@@ -1,264 +0,0 @@
-/**
- * Migration Version Check Utility
- *
- * This module provides functions to detect if the database needs migration
- * by comparing the app version with the database schema version.
- */
-
-import type { SupabaseClient } from '@supabase/supabase-js';
-
-/**
- * Get the current app version from package.json
- */
-export const APP_VERSION = import.meta.env.VITE_APP_VERSION;
-
-/**
- * Get the latest migration timestamp bundled with this app
- * Format: YYYYMMDDHHMMSS (e.g., "20251229213735")
- */
-export const LATEST_MIGRATION_TIMESTAMP =
-    import.meta.env.VITE_LATEST_MIGRATION_TIMESTAMP;
-
-/**
- * Compare two semantic versions (e.g., "0.31.0" vs "0.30.0")
- * Returns:
- *   1 if v1 > v2
- *   0 if v1 === v2
- *  -1 if v1 < v2
- */
-export function compareSemver(v1: string, v2: string): number {
-    const parts1 = v1.split('.').map(Number);
-    const parts2 = v2.split('.').map(Number);
-
-    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
-        const num1 = parts1[i] || 0;
-        const num2 = parts2[i] || 0;
-
-        if (num1 > num2) return 1;
-        if (num1 < num2) return -1;
-    }
-
-    return 0;
-}
-
-/**
- * Database migration info
- */
-export interface DatabaseMigrationInfo {
-    version: string | null;
-    latestMigrationTimestamp: string | null;
-}
-
-/**
- * Get the latest applied migration info from the database
- * Uses Supabase's internal migration tracking via a database function
- */
-export async function getDatabaseMigrationInfo(
-    supabase: SupabaseClient,
-): Promise<DatabaseMigrationInfo> {
-    try {
-        // Call database function that queries Supabase's internal migration table
-        // This is automatically updated by `supabase db push`
-        const { data, error } = await supabase
-            .rpc('get_latest_migration_timestamp');
-
-        if (error) {
-            console.warn('Could not get latest migration timestamp:', error.message);
-            return { version: null, latestMigrationTimestamp: null };
-        }
-
-        // The returned value IS the migration timestamp (e.g., "20251230082455")
-        const latestTimestamp = data || null;
-
-        return {
-            version: APP_VERSION, // Use app version for display
-            latestMigrationTimestamp: latestTimestamp,
-        };
-    } catch (error) {
-        console.error('Error checking database migration info:', error);
-        return { version: null, latestMigrationTimestamp: null };
-    }
-}
-
-/**
- * Migration status result
- */
-export interface MigrationStatus {
-    /** Whether migration is needed */
-    needsMigration: boolean;
-    /** Current app version */
-    appVersion: string;
-    /** Database schema version (null if unknown) */
-    dbVersion: string | null;
-    /** Human-readable status message */
-    message: string;
-}
-
-/**
- * Check if database migration is needed
- *
- * Uses timestamp comparison for accurate migration detection:
- * - Compares app's latest migration timestamp with DB's latest migration timestamp
- * - If app timestamp > DB timestamp → new migrations available
- *
- * Fallback to SemVer comparison if DB lacks timestamp tracking (legacy schemas).
- *
- * @param supabase - Supabase client instance
- * @returns Promise<MigrationStatus>
- */
-export async function checkMigrationStatus(
-    supabase: SupabaseClient,
-): Promise<MigrationStatus> {
-    const appVersion = APP_VERSION;
-    const appMigrationTimestamp = LATEST_MIGRATION_TIMESTAMP;
-    const dbInfo = await getDatabaseMigrationInfo(supabase);
-
-    console.log('[Migration Check]', {
-        appVersion,
-        appMigrationTimestamp,
-        dbVersion: dbInfo.version,
-        dbMigrationTimestamp: dbInfo.latestMigrationTimestamp,
-    });
-
-    // 1. Critical failure to determine app state
-    if (appMigrationTimestamp === 'unknown') {
-        return {
-            needsMigration: true,
-            appVersion,
-            dbVersion: dbInfo.version,
-            message: `App migration info missing. Migration to v${appVersion} likely needed.`,
-        };
-    }
-
-    // 2. Database has timestamp tracking (Modern)
-    // Check for valid timestamp (not empty/whitespace)
-    if (
-        dbInfo.latestMigrationTimestamp &&
-        dbInfo.latestMigrationTimestamp.trim() !== ''
-    ) {
-        const appTimestamp = appMigrationTimestamp;
-        const dbTimestamp = dbInfo.latestMigrationTimestamp;
-
-        if (appTimestamp > dbTimestamp) {
-            return {
-                needsMigration: true,
-                appVersion,
-                dbVersion: dbInfo.version,
-                message: `New migrations available. Database is at ${dbTimestamp}, app has ${appTimestamp}.`,
-            };
-        } else if (appTimestamp < dbTimestamp) {
-            console.warn('[Migration Check] DB is ahead of app - possible downgrade');
-            return {
-                needsMigration: false,
-                appVersion,
-                dbVersion: dbInfo.version,
-                message: `Database (${dbTimestamp}) is ahead of app (${appTimestamp}).`,
-            };
-        } else {
-            console.log('[Migration Check] Timestamps match - database is up-to-date');
-            return {
-                needsMigration: false,
-                appVersion,
-                dbVersion: dbInfo.version,
-                message: `Database schema is up-to-date.`,
-            };
-        }
-    }
-
-    // 3. Database has version but NO timestamp (Legacy Schema)
-    // Fallback to SemVer comparison
-    if (dbInfo.version) {
-        console.log(
-            '[Migration Check] Legacy DB detected (no timestamp). Falling back to SemVer.',
-        );
-        const comparison = compareSemver(appVersion, dbInfo.version);
-
-        if (comparison > 0) {
-            // App version is newer - definitely needs migration
-            return {
-                needsMigration: true,
-                appVersion,
-                dbVersion: dbInfo.version,
-                message: `Database schema (v${dbInfo.version}) is outdated. Migration to v${appVersion} required.`,
-            };
-        } else if (comparison === 0) {
-            // Versions match BUT we can't verify migrations without timestamps
-            // Be pessimistic: force migration to upgrade to modern timestamp tracking
-            console.warn(
-                '[Migration Check] Legacy DB with matching version - forcing migration to add timestamp tracking',
-            );
-            return {
-                needsMigration: true,
-                appVersion,
-                dbVersion: dbInfo.version,
-                message: `Database lacks timestamp tracking. Please run migration to upgrade to modern schema (v${appVersion}).`,
-            };
-        } else {
-            // DB version is ahead of app version
-            return {
-                needsMigration: false,
-                appVersion,
-                dbVersion: dbInfo.version,
-                message: `Database version (v${dbInfo.version}) is ahead of app (v${appVersion}).`,
-            };
-        }
-    }
-
-    // 4. No DB info at all (Fresh DB or Error)
-    console.log('[Migration Check] No DB info found - assuming migration needed');
-    return {
-        needsMigration: true,
-        appVersion,
-        dbVersion: null,
-        message: `Database schema unknown. Migration required to v${appVersion}.`,
-    };
-}
-
-/**
- * LocalStorage key for migration reminder dismissal
- */
-const MIGRATION_REMINDER_KEY = 'email_automator_migration_reminder_dismissed_at';
-
-/**
- * Check if user has dismissed the migration reminder recently
- *
- * @param hoursToWait - Hours to wait before showing reminder again (default: 24)
- * @returns true if reminder was dismissed within the time window
- */
-export function isMigrationReminderDismissed(hoursToWait = 24): boolean {
-    try {
-        const dismissedAt = localStorage.getItem(MIGRATION_REMINDER_KEY);
-        if (!dismissedAt) return false;
-
-        const dismissedTime = new Date(dismissedAt).getTime();
-        const now = Date.now();
-        const hoursSinceDismissal = (now - dismissedTime) / (1000 * 60 * 60);
-
-        return hoursSinceDismissal < hoursToWait;
-    } catch (error) {
-        console.error('Error checking migration reminder:', error);
-        return false;
-    }
-}
-
-/**
- * Mark the migration reminder as dismissed
- */
-export function dismissMigrationReminder(): void {
-    try {
-        localStorage.setItem(MIGRATION_REMINDER_KEY, new Date().toISOString());
-    } catch (error) {
-        console.error('Error dismissing migration reminder:', error);
-    }
-}
-
-/**
- * Clear the migration reminder dismissal (useful after successful migration)
- */
-export function clearMigrationReminderDismissal(): void {
-    try {
-        localStorage.removeItem(MIGRATION_REMINDER_KEY);
-    } catch (error) {
-        console.error('Error clearing migration reminder:', error);
-    }
-}

package/src/lib/sounds.ts

@@ -1,120 +0,0 @@
-/**
- * Sound and Haptic Manager for Email Automator
- * Uses Web Audio API to synthesize sounds without external assets.
- */
-
-class SoundManager {
-    private ctx: AudioContext | null = null;
-    private enabled: boolean = false;
-
-    constructor() {
-        // Initialize enabled state from localStorage
-        this.enabled = localStorage.getItem('ea_sounds_enabled') === 'true';
-    }
-
-    setEnabled(enabled: boolean) {
-        this.enabled = enabled;
-        localStorage.setItem('ea_sounds_enabled', enabled ? 'true' : 'none');
-    }
-
-    isEnabled(): boolean {
-        return this.enabled;
-    }
-
-    private initCtx() {
-        if (!this.ctx) {
-            this.ctx = new (window.AudioContext || (window as any).webkitAudioContext)();
-        }
-        if (this.ctx.state === 'suspended') {
-            this.ctx.resume();
-        }
-        return this.ctx;
-    }
-
-    /**
-     * Subtle haptic feedback for supported devices
-     */
-    haptic(pattern: number | number[] = 10) {
-        if (typeof navigator !== 'undefined' && navigator.vibrate) {
-            navigator.vibrate(pattern);
-        }
-    }
-
-    /**
-     * Soft chime for new emails
-     */
-    playNotify() {
-        if (!this.enabled) return;
-        const ctx = this.initCtx();
-        const osc = ctx.createOscillator();
-        const gain = ctx.createGain();
-
-        osc.type = 'sine';
-        osc.frequency.setValueAtTime(880, ctx.currentTime); // A5
-        osc.frequency.exponentialRampToValueAtTime(440, ctx.currentTime + 0.1);
-
-        gain.gain.setValueAtTime(0, ctx.currentTime);
-        gain.gain.linearRampToValueAtTime(0.1, ctx.currentTime + 0.01);
-        gain.gain.exponentialRampToValueAtTime(0.001, ctx.currentTime + 0.3);
-
-        osc.connect(gain);
-        gain.connect(ctx.destination);
-
-        osc.start();
-        osc.stop(ctx.currentTime + 0.3);
-        this.haptic(10);
-    }
-
-    /**
-     * Distinct tone for High Priority emails
-     */
-    playAlert() {
-        if (!this.enabled) return;
-        const ctx = this.initCtx();
-        
-        const playTone = (freq: number, start: number) => {
-            const osc = ctx.createOscillator();
-            const gain = ctx.createGain();
-            osc.type = 'sine';
-            osc.frequency.setValueAtTime(freq, ctx.currentTime + start);
-            gain.gain.setValueAtTime(0, ctx.currentTime + start);
-            gain.gain.linearRampToValueAtTime(0.1, ctx.currentTime + start + 0.05);
-            gain.gain.exponentialRampToValueAtTime(0.001, ctx.currentTime + start + 0.4);
-            osc.connect(gain);
-            gain.connect(ctx.destination);
-            osc.start(ctx.currentTime + start);
-            osc.stop(ctx.currentTime + start + 0.4);
-        };
-
-        playTone(660, 0); // E5
-        playTone(880, 0.1); // A5
-        this.haptic([20, 50, 20]);
-    }
-
-    /**
-     * Soft success sound for completed actions
-     */
-    playSuccess() {
-        if (!this.enabled) return;
-        const ctx = this.initCtx();
-        const osc = ctx.createOscillator();
-        const gain = ctx.createGain();
-
-        osc.type = 'triangle';
-        osc.frequency.setValueAtTime(523.25, ctx.currentTime); // C5
-        osc.frequency.exponentialRampToValueAtTime(1046.50, ctx.currentTime + 0.1); // C6
-
-        gain.gain.setValueAtTime(0, ctx.currentTime);
-        gain.gain.linearRampToValueAtTime(0.05, ctx.currentTime + 0.02);
-        gain.gain.exponentialRampToValueAtTime(0.001, ctx.currentTime + 0.2);
-
-        osc.connect(gain);
-        gain.connect(ctx.destination);
-
-        osc.start();
-        osc.stop(ctx.currentTime + 0.2);
-        this.haptic(15);
-    }
-}
-
-export const sounds = new SoundManager();

package/src/lib/supabase-config.ts

@@ -1,117 +0,0 @@
-import { createClient } from '@supabase/supabase-js';
-
-const STORAGE_KEY = 'email_automator_supabase_config';
-
-export interface SupabaseConfig {
-    url: string;
-    anonKey: string;
-}
-
-export function getSupabaseConfig(): SupabaseConfig | null {
-    try {
-        const stored = localStorage.getItem(STORAGE_KEY);
-        if (stored) {
-            return JSON.parse(stored);
-        }
-    } catch (error) {
-        console.error('Error reading Supabase config:', error);
-    }
-
-    // Fallback to env vars
-    const url = import.meta.env.VITE_SUPABASE_URL;
-    const anonKey = import.meta.env.VITE_SUPABASE_ANON_KEY;
-
-    if (
-        url && 
-        anonKey && 
-        url !== 'your_supabase_url' && 
-        anonKey !== 'your_supabase_anon_key' &&
-        url.startsWith('http')
-    ) {
-        return { url, anonKey };
-    }
-
-    return null;
-}
-
-export function saveSupabaseConfig(config: SupabaseConfig): void {
-    try {
-        localStorage.setItem(STORAGE_KEY, JSON.stringify(config));
-    } catch (error) {
-        console.error('Error saving Supabase config:', error);
-    }
-}
-
-export function clearSupabaseConfig(): void {
-    try {
-        localStorage.removeItem(STORAGE_KEY);
-    } catch (error) {
-        console.error('Error clearing Supabase config:', error);
-    }
-}
-
-/**
- * Validate Supabase connection
- */
-export async function validateSupabaseConnection(
-    url: string,
-    anonKey: string
-): Promise<{ valid: boolean; error?: string }> {
-    try {
-        // Basic URL validation
-        if (!url.startsWith('http://') && !url.startsWith('https://')) {
-            return { valid: false, error: 'Invalid URL format' };
-        }
-
-        // Basic API key validation (supports both JWT anon keys and publishable keys)
-        const isJwtKey = anonKey.startsWith('eyJ');
-        const isPublishableKey = anonKey.startsWith('sb_publishable_');
-
-        if (!isJwtKey && !isPublishableKey) {
-            return { valid: false, error: 'Invalid API key format (must be anon or publishable key)' };
-        }
-
-        // Skip network validation for publishable keys as they might not be standard JWTs
-        // compatible with the Postgrest root endpoint check
-        if (isPublishableKey) {
-            return { valid: true };
-        }
-
-        // Test connection by making a simple request
-        const response = await fetch(`${url}/rest/v1/`, {
-            method: 'GET',
-            headers: {
-                apikey: anonKey,
-                Authorization: `Bearer ${anonKey}`,
-            },
-        });
-
-        if (!response.ok) {
-            if (response.status === 401 || response.status === 403) {
-                return { valid: false, error: 'Invalid API key' };
-            }
-            return { valid: false, error: `Connection failed: ${response.statusText}` };
-        }
-
-        return { valid: true };
-    } catch (error) {
-        return {
-            valid: false,
-            error: error instanceof Error ? error.message : 'Connection failed',
-        };
-    }
-}
-
-/**
- * Get Supabase config source (for display purposes)
- */
-export function getConfigSource(): 'ui' | 'env' | 'none' {
-    const stored = localStorage.getItem(STORAGE_KEY);
-    if (stored) return 'ui';
-
-    const url = import.meta.env.VITE_SUPABASE_URL;
-    const anonKey = import.meta.env.VITE_SUPABASE_ANON_KEY;
-    if (url && anonKey) return 'env';
-
-    return 'none';
-}

package/src/lib/supabase.ts

@@ -1,28 +0,0 @@
-import { createClient, type SupabaseClient } from '@supabase/supabase-js';
-import { getSupabaseConfig } from './supabase-config';
-
-// Create client immediately to ensure session restoration happens early
-// This is critical for auth session persistence across page refreshes
-function createSupabaseClient(): SupabaseClient {
-    const config = getSupabaseConfig();
-
-    if (!config || !config.url?.startsWith('http')) {
-        // Return a placeholder client that will never be used
-        // (App.tsx will show setup wizard before this is accessed)
-        console.info('[Supabase] Setup required: Waiting for configuration...');
-        return createClient('https://placeholder.supabase.co', 'placeholder-key');
-    }
-
-    return createClient(config.url, config.anonKey, {
-        auth: {
-            // Ensure session is persisted and restored from localStorage
-            persistSession: true,
-            autoRefreshToken: true,
-            detectSessionInUrl: true,
-        },
-    });
-}
-
-// Create client immediately on module load (not lazy!)
-// This ensures session restoration from localStorage happens before any auth checks
-export const supabase = createSupabaseClient();

package/src/lib/types.ts

@@ -1,166 +0,0 @@
-// Database types
-export interface Profile {
-    id: string;
-    first_name: string | null;
-    last_name: string | null;
-    email: string | null;
-    avatar_url: string | null;
-    is_admin: boolean;
-    created_at: string;
-    updated_at: string;
-}
-
-export interface EmailAccount {
-    id: string;
-    user_id: string;
-    provider: 'gmail' | 'outlook';
-    email_address: string;
-    is_active: boolean;
-    last_sync_checkpoint?: string | null;
-    sync_start_date?: string | null;
-    sync_max_emails_per_run?: number;
-    last_sync_at?: string | null;
-    last_sync_status?: 'idle' | 'syncing' | 'success' | 'error';
-    last_sync_error?: string | null;
-    created_at: string;
-    updated_at: string;
-}
-
-export interface Email {
-    id: string;
-    account_id: string;
-    external_id: string;
-    subject: string | null;
-    sender: string | null;
-    recipient: string | null;
-    date: string | null;
-    body_snippet: string | null;
-    category: EmailCategory | null;
-    is_useless: boolean;
-    ai_analysis: EmailAnalysis | null;
-    suggested_action?: EmailAction | null; // Deprecated
-    suggested_actions?: EmailAction[];
-    action_taken?: EmailAction | null; // Deprecated
-    actions_taken?: EmailAction[];
-    created_at: string;
-    email_accounts?: EmailAccount;
-}
-
-export interface Rule {
-    id: string;
-    user_id: string;
-    name: string;
-    condition: RuleCondition;
-    action: 'delete' | 'archive' | 'draft' | 'read' | 'star';
-    instructions?: string;
-    attachments?: RuleAttachment[];
-    is_enabled: boolean;
-    is_system?: boolean; // New flag for pre-defined rules
-    created_at: string;
-}
-
-export interface RuleCondition {
-    category?: EmailCategory;
-    is_useless?: boolean;
-    sender_contains?: string;
-    sender_domain?: string;
-    sender_email?: string;
-    subject_contains?: string;
-    body_contains?: string;
-    older_than_days?: number;
-    priority?: Priority;
-    sentiment?: Sentiment;
-    suggested_actions?: EmailAction[];
-}
-
-export interface RuleAttachment {
-    name: string;
-    path: string;
-    type: string;
-    size: number;
-}
-
-export interface UserSettings {
-    id?: string;
-    user_id?: string;
-    llm_model: string | null;
-    llm_base_url: string | null;
-    llm_api_key: string | null;
-    sync_interval_minutes: number;
-    preferences?: Record<string, any>;
-}
-
-export interface Integration {
-    id: string;
-    user_id: string;
-    provider: 'google' | 'microsoft' | 'openai';
-    credentials: Record<string, any>;
-    is_enabled: boolean;
-    created_at: string;
-    updated_at: string;
-}
-
-export interface ProcessingLog {
-    id: string;
-    user_id: string;
-    status: 'running' | 'success' | 'failed';
-    started_at: string;
-    completed_at: string | null;
-    emails_processed: number;
-    emails_deleted: number;
-    emails_drafted: number;
-    error_message: string | null;
-}
-
-export interface ProcessingEvent {
-    id: string;
-    run_id: string;
-    email_id?: string | null;
-    event_type: 'info' | 'analysis' | 'action' | 'error';
-    agent_state: string;
-    details?: any;
-    created_at: string;
-}
-
-// Enums
-export type EmailCategory = 'spam' | 'newsletter' | 'support' | 'client' | 'internal' | 'personal' | 'other';
-export type EmailAction = 'none' | 'delete' | 'archive' | 'reply' | 'flag' | 'draft';
-export type Sentiment = 'Positive' | 'Neutral' | 'Negative';
-export type Priority = 'High' | 'Medium' | 'Low';
-
-// AI Analysis
-export interface EmailAnalysis {
-    summary: string;
-    category: EmailCategory;
-    sentiment: Sentiment;
-    is_useless: boolean;
-    suggested_action: EmailAction;
-    draft_response?: string;
-    priority: Priority;
-    key_points?: string[];
-    action_items?: string[];
-}
-
-// Stats
-export interface Stats {
-    totalEmails: number;
-    categoryCounts: Record<string, number>;
-    actionCounts: Record<string, number>;
-    uselessCount: number;
-    accountCount: number;
-    accountsByProvider: Record<string, number>;
-    recentSyncs: ProcessingLog[];
-}
-
-// API Response types
-export interface ApiError {
-    code: string;
-    message: string;
-}
-
-export interface PaginatedResponse<T> {
-    data: T[];
-    total: number;
-    limit: number;
-    offset: number;
-}

package/src/lib/utils.ts

@@ -1,6 +0,0 @@
-import { type ClassValue, clsx } from "clsx"
-import { twMerge } from "tailwind-merge"
-
-export function cn(...inputs: ClassValue[]) {
-    return twMerge(clsx(inputs))
-}