seo-testing-tool 1.0.0

package/dist/notifications/NotificationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationService.d.ts","sourceRoot":"","sources":["../../src/notifications/NotificationService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,iBAAiB,CAA0B;IAEnD;;OAEG;IACG,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IActE;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAgCnE;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAiC7F;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACG,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAI3F"}

package/dist/notifications/NotificationService.js

@@ -0,0 +1,115 @@
+/**
+ * NotificationService
+ *
+ * Gestisce l'invio di notifiche agli utenti:
+ * - Alert per test statisticamente significativi
+ * - Digest settimanali per utenti con test multipli
+ * - Prevenzione alert fatigue
+ */
+export class NotificationService {
+    notificationsSent = new Set();
+    /**
+     * Test 6.1 - Determina se inviare alert vittoria
+     */
+    async shouldSendVictoryAlert(testResult) {
+        // Regola 1: p-value deve essere < 0.05 (statisticamente significativo)
+        if (testResult.pValue >= 0.05) {
+            return false;
+        }
+        // Regola 2: Miglioramento deve essere >= 5% (evita alert fatigue per miglioramenti minimi)
+        if (testResult.improvement < 0.05) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Test 6.1 - Invia alert vittoria
+     */
+    async sendVictoryAlert(testResult) {
+        // Previeni invio duplicati
+        const notificationKey = `victory-${testResult.testId}`;
+        if (this.notificationsSent.has(notificationKey)) {
+            return {
+                sent: false,
+                reason: 'already_notified',
+            };
+        }
+        // Verifica se deve inviare
+        const shouldSend = await this.shouldSendVictoryAlert(testResult);
+        if (!shouldSend) {
+            return {
+                sent: false,
+                reason: 'not_significant',
+            };
+        }
+        // Marca come inviata
+        this.notificationsSent.add(notificationKey);
+        // Qui invieremmo realmente l'email
+        // await emailService.send(...)
+        return {
+            sent: true,
+        };
+    }
+    /**
+     * Test 6.2 - Genera digest settimanale
+     */
+    async generateWeeklyDigest(_userId, activeTests) {
+        // Ordina test per priorità (significativi prima)
+        const sortedTests = [...activeTests].sort((a, b) => {
+            // Test con p-value < 0.05 hanno priorità
+            const aSignificant = a.currentProgress.pValue < 0.05;
+            const bSignificant = b.currentProgress.pValue < 0.05;
+            if (aSignificant && !bSignificant)
+                return -1;
+            if (!aSignificant && bSignificant)
+                return 1;
+            // Altrimenti ordina per improvement
+            return b.currentProgress.improvement - a.currentProgress.improvement;
+        });
+        // Genera riepilogo complessivo
+        const significantTests = activeTests.filter(t => t.currentProgress.pValue < 0.05);
+        const summary = `${activeTests.length} test attivi. ${significantTests.length} statisticamente significativi.`;
+        // Genera body con sezioni per ogni test
+        let body = `Riepilogo Settimanale\n\n${summary}\n\n`;
+        for (const test of sortedTests) {
+            body += this.formatTestSection(test);
+        }
+        return {
+            tests: sortedTests,
+            userEmail: 'user@example.com', // TODO: recuperare email reale da userId
+            subject: 'Report Settimanale - I Tuoi Test SEO',
+            body,
+        };
+    }
+    /**
+     * Formatta sezione test nel digest
+     */
+    formatTestSection(test) {
+        const improvement = Math.round(test.currentProgress.improvement * 100);
+        const confidence = Math.round(test.currentProgress.confidenceLevel * 100);
+        let section = `\n--- ${test.testName} ---\n`;
+        section += `Durata: ${test.daysRunning} giorni\n`;
+        section += `Miglioramento: +${improvement}%\n`;
+        section += `Confidenza: ${confidence}%\n`;
+        // Azioni consigliate
+        if (test.currentProgress.pValue < 0.05) {
+            section += `✅ Azione: Pronto per applicare - Test statisticamente significativo!\n`;
+        }
+        else if (test.daysRunning < 10) {
+            section += `⏳ Azione: Continua a monitorare - Test ancora troppo giovane\n`;
+        }
+        else {
+            section += `👀 Azione: Continua a monitorare\n`;
+        }
+        section += '\n';
+        return section;
+    }
+    /**
+     * Test 6.2 - Determina se inviare digest settimanale
+     */
+    async shouldSendWeeklyDigest(_userId, activeTests) {
+        // NON inviare se non ci sono test attivi
+        return activeTests.length > 0;
+    }
+}
+//# sourceMappingURL=NotificationService.js.map

package/dist/notifications/NotificationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationService.js","sourceRoot":"","sources":["../../src/notifications/NotificationService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqCH,MAAM,OAAO,mBAAmB;IACtB,iBAAiB,GAAgB,IAAI,GAAG,EAAE,CAAC;IAEnD;;OAEG;IACH,KAAK,CAAC,sBAAsB,CAAC,UAAsB;QACjD,uEAAuE;QACvE,IAAI,UAAU,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,2FAA2F;QAC3F,IAAI,UAAU,CAAC,WAAW,GAAG,IAAI,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,UAAsB;QAC3C,2BAA2B;QAC3B,MAAM,eAAe,GAAG,WAAW,UAAU,CAAC,MAAM,EAAE,CAAC;QAEvD,IAAI,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;YAChD,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,kBAAkB;aAC3B,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAEjE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,iBAAiB;aAC1B,CAAC;QACJ,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAE5C,mCAAmC;QACnC,+BAA+B;QAE/B,OAAO;YACL,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,OAAe,EAAE,WAAyB;QACnE,iDAAiD;QACjD,MAAM,WAAW,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACjD,yCAAyC;YACzC,MAAM,YAAY,GAAG,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC;YACrD,MAAM,YAAY,GAAG,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC;YAErD,IAAI,YAAY,IAAI,CAAC,YAAY;gBAAE,OAAO,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,YAAY,IAAI,YAAY;gBAAE,OAAO,CAAC,CAAC;YAE5C,oCAAoC;YACpC,OAAO,CAAC,CAAC,eAAe,CAAC,WAAW,GAAG,CAAC,CAAC,eAAe,CAAC,WAAW,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,+BAA+B;QAC/B,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAClF,MAAM,OAAO,GAAG,GAAG,WAAW,CAAC,MAAM,iBAAiB,gBAAgB,CAAC,MAAM,iCAAiC,CAAC;QAE/G,wCAAwC;QACxC,IAAI,IAAI,GAAG,4BAA4B,OAAO,MAAM,CAAC;QAErD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAED,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,SAAS,EAAE,kBAAkB,EAAE,yCAAyC;YACxE,OAAO,EAAE,sCAAsC;YAC/C,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,IAAgB;QACxC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC;QAE1E,IAAI,OAAO,GAAG,SAAS,IAAI,CAAC,QAAQ,QAAQ,CAAC;QAC7C,OAAO,IAAI,WAAW,IAAI,CAAC,WAAW,WAAW,CAAC;QAClD,OAAO,IAAI,mBAAmB,WAAW,KAAK,CAAC;QAC/C,OAAO,IAAI,eAAe,UAAU,KAAK,CAAC;QAE1C,qBAAqB;QACrB,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YACvC,OAAO,IAAI,wEAAwE,CAAC;QACtF,CAAC;aAAM,IAAI,IAAI,CAAC,WAAW,GAAG,EAAE,EAAE,CAAC;YACjC,OAAO,IAAI,gEAAgE,CAAC;QAC9E,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,oCAAoC,CAAC;QAClD,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;QAEhB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB,CAAC,OAAe,EAAE,WAAyB;QACrE,yCAAyC;QACzC,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/orchestrator/SEOExperimentOrchestrator.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SEOExperimentOrchestrator
+ *
+ * Orchestra il flusso completo di un esperimento SEO:
+ * - Fetch dati da GSC tramite GSCDataFetcher
+ * - Salvataggio dati tramite TimeSeriesService
+ * - Analisi statistica tramite StatisticalEngine
+ * - Aggiornamento stato test nel database
+ * - Notifiche tramite NotificationService
+ * - Audit logging per tracciabilità
+ */
+import { type DrizzleDB } from '../database/db.js';
+import { GSCDataFetcher } from '../gsc/GSCDataFetcher.js';
+import { StatisticalEngine } from '../stats/StatisticalEngine.js';
+import { TimeSeriesService } from '../database/TimeSeriesService.js';
+import { NotificationService } from '../notifications/NotificationService.js';
+import { TokenManager } from '../auth/TokenManager.js';
+export interface ExperimentResult {
+    testId: string;
+    status: 'updated' | 'completed' | 'insufficient_data' | 'error';
+    pValue: number | null;
+    percentageChange: number | null;
+    isSignificant: boolean;
+    message: string;
+    dataPointsBefore: number;
+    dataPointsAfter: number;
+    notificationSent: boolean;
+}
+export interface SyncResult {
+    totalTests: number;
+    successCount: number;
+    errorCount: number;
+    results: ExperimentResult[];
+    errors: Array<{
+        testId: string;
+        error: string;
+    }>;
+}
+export interface OrchestratorDeps {
+    db?: DrizzleDB;
+    gscFetcher?: GSCDataFetcher;
+    statisticalEngine?: StatisticalEngine;
+    timeSeriesService?: TimeSeriesService;
+    notificationService?: NotificationService;
+    tokenManager?: TokenManager;
+}
+export declare class SEOExperimentOrchestrator {
+    private db;
+    private gscFetcher;
+    private statisticalEngine;
+    private timeSeriesService;
+    private notificationService;
+    private tokenManager;
+    constructor(deps?: OrchestratorDeps);
+    /**
+     * Esegue il flusso completo per un singolo esperimento SEO.
+     */
+    runExperiment(testId: string): Promise<ExperimentResult>;
+    /**
+     * Sincronizza tutti i test con status 'running'.
+     * Resiliente: se un test fallisce, logga l'errore e continua.
+     */
+    syncAllActiveTests(): Promise<SyncResult>;
+    /**
+     * Aggiorna lo stato di un test e registra nel log.
+     */
+    private updateTestStatus;
+}
+//# sourceMappingURL=SEOExperimentOrchestrator.d.ts.map

package/dist/orchestrator/SEOExperimentOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SEOExperimentOrchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/SEOExperimentOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,mBAAmB,GAAG,OAAO,CAAC;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,YAAY,CAAe;gBAEvB,IAAI,CAAC,EAAE,gBAAgB;IASnC;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsI9D;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,UAAU,CAAC;IA6B/C;;OAEG;YACW,gBAAgB;CAgB/B"}

package/dist/orchestrator/SEOExperimentOrchestrator.js

@@ -0,0 +1,199 @@
+/**
+ * SEOExperimentOrchestrator
+ *
+ * Orchestra il flusso completo di un esperimento SEO:
+ * - Fetch dati da GSC tramite GSCDataFetcher
+ * - Salvataggio dati tramite TimeSeriesService
+ * - Analisi statistica tramite StatisticalEngine
+ * - Aggiornamento stato test nel database
+ * - Notifiche tramite NotificationService
+ * - Audit logging per tracciabilità
+ */
+import { eq } from 'drizzle-orm';
+import { db as defaultDb } from '../database/db.js';
+import { tests, metrics, auditLogs, users } from '../database/schema.js';
+import { GSCDataFetcher } from '../gsc/GSCDataFetcher.js';
+import { StatisticalEngine } from '../stats/StatisticalEngine.js';
+import { TimeSeriesService } from '../database/TimeSeriesService.js';
+import { NotificationService } from '../notifications/NotificationService.js';
+import { TokenManager } from '../auth/TokenManager.js';
+export class SEOExperimentOrchestrator {
+    db;
+    gscFetcher;
+    statisticalEngine;
+    timeSeriesService;
+    notificationService;
+    tokenManager;
+    constructor(deps) {
+        this.db = deps?.db ?? defaultDb;
+        this.gscFetcher = deps?.gscFetcher ?? new GSCDataFetcher();
+        this.statisticalEngine = deps?.statisticalEngine ?? new StatisticalEngine();
+        this.timeSeriesService = deps?.timeSeriesService ?? new TimeSeriesService(deps?.db);
+        this.notificationService = deps?.notificationService ?? new NotificationService();
+        this.tokenManager = deps?.tokenManager ?? new TokenManager({ clientId: '', clientSecret: '' });
+    }
+    /**
+     * Esegue il flusso completo per un singolo esperimento SEO.
+     */
+    async runExperiment(testId) {
+        // 1. Carica test dal database
+        const test = this.db
+            .select()
+            .from(tests)
+            .where(eq(tests.id, testId))
+            .get();
+        if (!test) {
+            throw new Error(`Test ${testId} non trovato.`);
+        }
+        if (test.status !== 'running') {
+            throw new Error(`Test ${testId} non è in esecuzione (stato: ${test.status}).`);
+        }
+        // Carica user per email notifica
+        const user = this.db
+            .select()
+            .from(users)
+            .where(eq(users.id, test.userId))
+            .get();
+        // 2. Ottieni access token
+        const tokenResult = await this.tokenManager.getValidAccessToken(test.userId);
+        if (!tokenResult.success || !tokenResult.token) {
+            await this.updateTestStatus(testId, 'failed', test.userId);
+            throw new Error(`Token non valido per utente ${test.userId}: ${tokenResult.error}`);
+        }
+        // 3. Fetch nuovi dati da GSC
+        const today = new Date().toISOString().split('T')[0];
+        const startDateStr = test.startDate.split('T')[0];
+        const gscData = await this.gscFetcher.fetchSearchAnalytics(tokenResult.token, test.siteUrl, { startDate: startDateStr, endDate: today });
+        // 4. Salva nuovi dati nel database
+        if (gscData.rows && gscData.rows.length > 0) {
+            const timeSeriesData = gscData.rows.map((row) => ({
+                date: row.date || row.keys[0],
+                clicks: row.clicks,
+                impressions: row.impressions,
+            }));
+            await this.timeSeriesService.saveData(testId, timeSeriesData);
+        }
+        // 5. Ricarica tutte le metriche dal database (incluse le nuove)
+        const allMetrics = this.db
+            .select()
+            .from(metrics)
+            .where(eq(metrics.testId, testId))
+            .orderBy(metrics.date)
+            .all();
+        // 6. Dividi metriche in before/after alla splitDate
+        const splitDateStr = test.splitDate;
+        const beforeMetrics = allMetrics.filter((m) => m.date < splitDateStr);
+        const afterMetrics = allMetrics.filter((m) => m.date >= splitDateStr);
+        const beforeClicks = beforeMetrics.map((m) => m.clicks);
+        const afterClicks = afterMetrics.map((m) => m.clicks);
+        // 7. Esegui analisi statistica
+        const analysisResult = this.statisticalEngine.analyze({
+            before: beforeClicks,
+            after: afterClicks,
+        });
+        // 8. Determina nuovo stato
+        const newStatus = analysisResult.isSignificant ? 'completed' : 'running';
+        // 9. Aggiorna test nel database
+        this.db
+            .update(tests)
+            .set({
+            lastSyncAt: new Date().toISOString(),
+            lastPValue: analysisResult.pValue,
+            lastImprovement: analysisResult.percentageChange,
+            status: newStatus,
+            updatedAt: new Date().toISOString(),
+        })
+            .where(eq(tests.id, testId))
+            .run();
+        // 10. Registra nell'audit log
+        this.db
+            .insert(auditLogs)
+            .values({
+            testId,
+            action: 'experiment_synced',
+            userId: test.userId,
+        })
+            .run();
+        // 11. Gestisci notifiche (solo se significativo)
+        let notificationSent = false;
+        if (analysisResult.isSignificant && user?.email) {
+            const testResult = {
+                testId,
+                testName: test.name,
+                pValue: analysisResult.pValue,
+                improvement: analysisResult.percentageChange / 100,
+                confidenceLevel: 1 - analysisResult.pValue,
+                metricType: 'clicks',
+                userId: test.userId,
+                userEmail: user.email,
+            };
+            const sendResult = await this.notificationService.sendVictoryAlert(testResult);
+            notificationSent = sendResult.sent;
+        }
+        // 12. Restituisci risultato
+        return {
+            testId,
+            status: analysisResult.hasInsufficientData
+                ? 'insufficient_data'
+                : analysisResult.isSignificant
+                    ? 'completed'
+                    : 'updated',
+            pValue: analysisResult.pValue,
+            percentageChange: analysisResult.percentageChange,
+            isSignificant: analysisResult.isSignificant,
+            message: analysisResult.message,
+            dataPointsBefore: beforeClicks.length,
+            dataPointsAfter: afterClicks.length,
+            notificationSent,
+        };
+    }
+    /**
+     * Sincronizza tutti i test con status 'running'.
+     * Resiliente: se un test fallisce, logga l'errore e continua.
+     */
+    async syncAllActiveTests() {
+        const activeTests = this.db
+            .select()
+            .from(tests)
+            .where(eq(tests.status, 'running'))
+            .all();
+        const results = [];
+        const errors = [];
+        for (const test of activeTests) {
+            try {
+                const result = await this.runExperiment(test.id);
+                results.push(result);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Errore sconosciuto';
+                errors.push({ testId: test.id, error: errorMessage });
+            }
+        }
+        return {
+            totalTests: activeTests.length,
+            successCount: results.length,
+            errorCount: errors.length,
+            results,
+            errors,
+        };
+    }
+    /**
+     * Aggiorna lo stato di un test e registra nel log.
+     */
+    async updateTestStatus(testId, status, userId) {
+        this.db
+            .update(tests)
+            .set({ status, updatedAt: new Date().toISOString() })
+            .where(eq(tests.id, testId))
+            .run();
+        this.db
+            .insert(auditLogs)
+            .values({
+            testId,
+            action: `status_changed_to_${status}`,
+            userId,
+        })
+            .run();
+    }
+}
+//# sourceMappingURL=SEOExperimentOrchestrator.js.map

package/dist/orchestrator/SEOExperimentOrchestrator.js.map

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

package/dist/services/ExportService.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ExportService
+ *
+ * Genera report professionali in formato Excel (.xlsx) e CSV
+ * a partire dai dati di un test SEO (metadata + metriche giornaliere).
+ */
+export interface TestReportData {
+    id: string;
+    name: string;
+    siteUrl: string;
+    urls: string[];
+    startDate: string;
+    splitDate: string;
+    status: string;
+    lastPValue: number | null;
+    lastImprovement: number | null;
+}
+export interface MetricRow {
+    date: string;
+    clicks: number;
+    impressions: number;
+    gapFilled: boolean;
+}
+export interface ExportInput {
+    test: TestReportData;
+    metrics: MetricRow[];
+}
+export interface ExportResult {
+    buffer: Buffer;
+    fileName: string;
+    format: 'xlsx' | 'csv';
+    rowCount: number;
+}
+export declare class ReportExportService {
+    /**
+     * Genera un file Excel professionale con due fogli:
+     * - Riepilogo (metadata + analisi)
+     * - Dati Giornalieri (tabella metriche)
+     */
+    exportToExcel(input: ExportInput): Promise<ExportResult>;
+    /**
+     * Genera un file CSV piatto con le metriche giornaliere.
+     */
+    exportToCSV(input: ExportInput): Promise<ExportResult>;
+    private buildRiepilogoSheet;
+    private buildDatiSheet;
+    private addSectionHeader;
+    private addLabelValueRow;
+    buildFileName(testName: string, ext: 'xlsx' | 'csv'): string;
+    private formatDate;
+}
+//# sourceMappingURL=ExportService.d.ts.map

package/dist/services/ExportService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportService.d.ts","sourceRoot":"","sources":["../../src/services/ExportService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAmBD,qBAAa,mBAAmB;IAC9B;;;;OAIG;IACG,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAqB9D;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA0B5D,OAAO,CAAC,mBAAmB;IAqG3B,OAAO,CAAC,cAAc;IAyDtB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,gBAAgB;IAkBxB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM;IAM5D,OAAO,CAAC,UAAU;CAWnB"}