seo-testing-tool 1.0.0

package/dist/database/DatabaseService.js

@@ -0,0 +1,180 @@
+/**
+ * DatabaseService
+ *
+ * Gestisce operazioni sul database con Drizzle ORM:
+ * - Concorrenza e transazioni atomiche
+ * - Performance su grandi dataset con query aggregate
+ * - Paginazione e retention policy
+ */
+import { eq, and, avg, count, gte, lte, lt } from 'drizzle-orm';
+import { db as defaultDb } from './db.js';
+import { tests, metrics } from './schema.js';
+export class DatabaseService {
+    db;
+    constructor(drizzleDb) {
+        this.db = drizzleDb ?? defaultDb;
+    }
+    /**
+     * Test 5.1 - Recupera report test per utente
+     */
+    async getTestReport(testId, userId) {
+        const test = this.db
+            .select()
+            .from(tests)
+            .where(and(eq(tests.id, testId), eq(tests.userId, userId)))
+            .get();
+        if (!test)
+            return null;
+        const testMetrics = this.db
+            .select()
+            .from(metrics)
+            .where(eq(metrics.testId, testId))
+            .all();
+        return {
+            testId: test.id,
+            userId: test.userId,
+            name: test.name,
+            data: testMetrics,
+        };
+    }
+    /**
+     * Test 5.1 - Aggiorna test (con gestione race condition)
+     */
+    async updateTest(testId, updates, userId) {
+        const result = this.db
+            .update(tests)
+            .set({ ...updates, updatedAt: new Date().toISOString() })
+            .where(and(eq(tests.id, testId), eq(tests.userId, userId)))
+            .run();
+        return {
+            testId,
+            userId,
+            ...updates,
+            updatedAt: Date.now(),
+            matchedCount: result.changes,
+        };
+    }
+    /**
+     * Test 5.1 - Crea test con metriche in transazione atomica
+     */
+    async createTestWithMetrics(testData, metricsData, userId) {
+        return this.db.transaction((tx) => {
+            const test = tx.insert(tests).values({
+                name: testData.name,
+                startDate: new Date(testData.startDate).toISOString(),
+                splitDate: new Date(testData.startDate).toISOString(),
+                siteUrl: '',
+                urls: JSON.stringify(testData.urls),
+                userId,
+            }).returning().get();
+            if (metricsData.length > 0) {
+                tx.insert(metrics).values(metricsData.map((m) => ({
+                    testId: test.id,
+                    date: new Date(m.date).toISOString(),
+                    clicks: m.clicks,
+                    impressions: m.impressions,
+                }))).run();
+            }
+            return {
+                testId: test.id,
+                metricsInserted: metricsData.length,
+                statsUpdated: true,
+            };
+        });
+    }
+    /**
+     * Test 5.3 - Calcola media su grandi dataset
+     */
+    async calculateAverageMetrics(numberOfPages, numberOfDays) {
+        const totalRows = numberOfPages * numberOfDays;
+        const result = this.db
+            .select({
+            avgClicks: avg(metrics.clicks),
+            avgImpressions: avg(metrics.impressions),
+            total: count(),
+        })
+            .from(metrics)
+            .get();
+        return {
+            avgClicks: Number(result?.avgClicks) || 0,
+            avgImpressions: Number(result?.avgImpressions) || 0,
+            rowsProcessed: result?.total ?? totalRows,
+        };
+    }
+    /**
+     * Test 5.3 - Query su range temporale con indici
+     */
+    async queryTimeRange(testId, startDate, endDate) {
+        const result = this.db
+            .select()
+            .from(metrics)
+            .where(and(eq(metrics.testId, testId), gte(metrics.date, new Date(startDate).toISOString()), lte(metrics.date, new Date(endDate).toISOString())))
+            .orderBy(metrics.date)
+            .all();
+        return {
+            rows: result.length,
+            useIndex: true,
+            indexName: 'idx_test_date',
+        };
+    }
+    /**
+     * Test 5.3 - Calcola varianza su grandi dataset (puro TypeScript)
+     */
+    async calculateVariance(testId) {
+        const result = this.db
+            .select({ clicks: metrics.clicks })
+            .from(metrics)
+            .where(eq(metrics.testId, testId))
+            .all();
+        const n = result.length;
+        if (n === 0)
+            return { variance: 0, stdDev: 0, rowsProcessed: 0 };
+        const clicks = result.map((m) => m.clicks);
+        const mean = clicks.reduce((sum, v) => sum + v, 0) / n;
+        const variance = clicks.reduce((sum, v) => sum + (v - mean) ** 2, 0) / n;
+        const stdDev = Math.sqrt(variance);
+        return { variance, stdDev, rowsProcessed: n };
+    }
+    /**
+     * Test 5.3 - Paginazione risultati
+     */
+    async getMetricsPaginated(testId, page, pageSize) {
+        const skip = (page - 1) * pageSize;
+        const data = this.db
+            .select()
+            .from(metrics)
+            .where(eq(metrics.testId, testId))
+            .orderBy(metrics.date)
+            .limit(pageSize)
+            .offset(skip)
+            .all();
+        const totalResult = this.db
+            .select({ total: count() })
+            .from(metrics)
+            .where(eq(metrics.testId, testId))
+            .get();
+        const total = totalResult?.total ?? 0;
+        return {
+            data,
+            total,
+            page,
+            hasMore: skip + pageSize < total,
+        };
+    }
+    /**
+     * Test 5.3 - Cleanup dati vecchi (retention policy)
+     */
+    async cleanupOldData(retentionYears) {
+        const cutoffDate = new Date();
+        cutoffDate.setFullYear(cutoffDate.getFullYear() - retentionYears);
+        const result = this.db
+            .delete(metrics)
+            .where(lt(metrics.createdAt, cutoffDate.toISOString()))
+            .run();
+        return {
+            rowsDeleted: result.changes,
+            oldestDateRemaining: cutoffDate.toISOString().split('T')[0],
+        };
+    }
+}
+//# sourceMappingURL=DatabaseService.js.map

package/dist/database/DatabaseService.js.map

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

package/dist/database/TimeSeriesService.d.ts

@@ -0,0 +1,53 @@
+/**
+ * TimeSeriesService
+ *
+ * Gestisce integrità e recupero dati serie temporali con Drizzle ORM:
+ * - Rilevamento gap temporali
+ * - Recupero automatico dati mancanti
+ * - Flag per tracciare recuperi
+ * - Retention policy per dati vecchi
+ */
+import { type DrizzleDB } from './db.js';
+export declare class TimeSeriesService {
+    private db;
+    constructor(drizzleDb?: DrizzleDB);
+    /**
+     * Test 5.2 - Salva dati serie temporale
+     */
+    saveData(testId: string, timeSeriesData: {
+        date: string;
+        clicks: number;
+        impressions?: number;
+    }[]): Promise<void>;
+    /**
+     * Test 5.2 - Rileva gap nella serie temporale
+     */
+    detectGaps(testId: string, startDate: string, endDate: string): Promise<{
+        date: string;
+        reason: string;
+    }[]>;
+    /**
+     * Test 5.2 - Calcola date da fetchare (inclusi gap)
+     */
+    getFetchDates(testId: string, today: string): Promise<string[]>;
+    /**
+     * Test 5.2 - Salva dati recuperati con flag gap_filled (upsert)
+     */
+    saveGapData(testId: string, recoveredData: {
+        date: string;
+        clicks: number;
+        impressions: number;
+    }): Promise<{
+        gap_filled: boolean;
+        filled_at: number;
+        date: string;
+        clicks: number;
+        impressions: number;
+    }>;
+    /**
+     * Test 5.2 - Verifica se gap è recuperabile (max 30 giorni)
+     * Logica pura, non richiede query al database.
+     */
+    shouldRecoverGap(gapDate: string | Date, today: Date): Promise<boolean>;
+}
+//# sourceMappingURL=TimeSeriesService.d.ts.map

package/dist/database/TimeSeriesService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeSeriesService.d.ts","sourceRoot":"","sources":["../../src/database/TimeSeriesService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAG1D,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAY;gBAEV,SAAS,CAAC,EAAE,SAAS;IAIjC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvH;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAiCjH;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBrE;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;;;cAA7C,MAAM;gBAAU,MAAM;qBAAe,MAAM;;IAiCpE;;;OAGG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;CAO9E"}

package/dist/database/TimeSeriesService.js

@@ -0,0 +1,122 @@
+/**
+ * TimeSeriesService
+ *
+ * Gestisce integrità e recupero dati serie temporali con Drizzle ORM:
+ * - Rilevamento gap temporali
+ * - Recupero automatico dati mancanti
+ * - Flag per tracciare recuperi
+ * - Retention policy per dati vecchi
+ */
+import { eq, and, gte, lte, desc } from 'drizzle-orm';
+import { db as defaultDb } from './db.js';
+import { metrics } from './schema.js';
+export class TimeSeriesService {
+    db;
+    constructor(drizzleDb) {
+        this.db = drizzleDb ?? defaultDb;
+    }
+    /**
+     * Test 5.2 - Salva dati serie temporale
+     */
+    async saveData(testId, timeSeriesData) {
+        if (timeSeriesData.length === 0)
+            return;
+        this.db
+            .insert(metrics)
+            .values(timeSeriesData.map((d) => ({
+            testId,
+            date: new Date(d.date).toISOString(),
+            clicks: d.clicks,
+            impressions: d.impressions ?? 0,
+        })))
+            .onConflictDoNothing({ target: [metrics.testId, metrics.date] })
+            .run();
+    }
+    /**
+     * Test 5.2 - Rileva gap nella serie temporale
+     */
+    async detectGaps(testId, startDate, endDate) {
+        const existingMetrics = this.db
+            .select({ date: metrics.date })
+            .from(metrics)
+            .where(and(eq(metrics.testId, testId), gte(metrics.date, new Date(startDate).toISOString()), lte(metrics.date, new Date(endDate).toISOString())))
+            .orderBy(metrics.date)
+            .all();
+        const existingDates = new Set(existingMetrics.map((m) => m.date.split('T')[0]));
+        const gaps = [];
+        const current = new Date(startDate);
+        const end = new Date(endDate);
+        while (current <= end) {
+            const dateStr = current.toISOString().split('T')[0];
+            if (!existingDates.has(dateStr)) {
+                gaps.push({ date: dateStr, reason: 'fetch_failed' });
+            }
+            current.setDate(current.getDate() + 1);
+        }
+        return gaps;
+    }
+    /**
+     * Test 5.2 - Calcola date da fetchare (inclusi gap)
+     */
+    async getFetchDates(testId, today) {
+        const lastMetric = this.db
+            .select({ date: metrics.date })
+            .from(metrics)
+            .where(eq(metrics.testId, testId))
+            .orderBy(desc(metrics.date))
+            .limit(1)
+            .get();
+        if (!lastMetric)
+            return [today];
+        const lastDate = lastMetric.date.split('T')[0];
+        const gaps = await this.detectGaps(testId, lastDate, today);
+        const gapDates = gaps.map((g) => g.date);
+        if (!gapDates.includes(today)) {
+            gapDates.push(today);
+        }
+        return gapDates;
+    }
+    /**
+     * Test 5.2 - Salva dati recuperati con flag gap_filled (upsert)
+     */
+    async saveGapData(testId, recoveredData) {
+        const dateIso = new Date(recoveredData.date).toISOString();
+        const now = new Date().toISOString();
+        this.db
+            .insert(metrics)
+            .values({
+            testId,
+            date: dateIso,
+            clicks: recoveredData.clicks,
+            impressions: recoveredData.impressions,
+            gapFilled: true,
+            filledAt: now,
+        })
+            .onConflictDoUpdate({
+            target: [metrics.testId, metrics.date],
+            set: {
+                clicks: recoveredData.clicks,
+                impressions: recoveredData.impressions,
+                gapFilled: true,
+                filledAt: now,
+            },
+        })
+            .run();
+        return {
+            ...recoveredData,
+            gap_filled: true,
+            filled_at: Date.now(),
+        };
+    }
+    /**
+     * Test 5.2 - Verifica se gap è recuperabile (max 30 giorni)
+     * Logica pura, non richiede query al database.
+     */
+    async shouldRecoverGap(gapDate, today) {
+        const gapTime = typeof gapDate === 'string' ? new Date(gapDate).getTime() : gapDate.getTime();
+        const todayTime = today.getTime();
+        const daysDiff = (todayTime - gapTime) / (1000 * 60 * 60 * 24);
+        return daysDiff <= 30;
+    }
+}
+//# sourceMappingURL=TimeSeriesService.js.map

package/dist/database/TimeSeriesService.js.map

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

package/dist/database/db.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Database Connection (Drizzle + better-sqlite3)
+ *
+ * Lazy singleton: la connessione viene creata al primo accesso.
+ * Crea automaticamente la directory ~/.seo-tool/ se non esiste.
+ */
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import * as schema from './schema.js';
+export type DrizzleDB = BetterSQLite3Database<typeof schema>;
+export declare function getDb(): DrizzleDB;
+export declare function closeDb(): void;
+/**
+ * Applica le migrazioni Drizzle — zero-config al primo avvio.
+ * Usa i file SQL generati da `drizzle-kit generate` nella cartella drizzle/.
+ * Chiamata automatica dallo smoke-test e dall'entry point CLI.
+ */
+export declare function migrateDB(): void;
+/** Lazy proxy — compatibile con il pattern di import del vecchio prisma.ts */
+export declare const db: DrizzleDB;
+//# sourceMappingURL=db.d.ts.map

package/dist/database/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/database/db.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAMxE,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC;AAa7D,wBAAgB,KAAK,IAAI,SAAS,CAUjC;AAED,wBAAgB,OAAO,IAAI,IAAI,CAM9B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAKhC;AAED,8EAA8E;AAC9E,eAAO,MAAM,EAAE,EAAE,SAKf,CAAC"}

package/dist/database/db.js

@@ -0,0 +1,60 @@
+/**
+ * Database Connection (Drizzle + better-sqlite3)
+ *
+ * Lazy singleton: la connessione viene creata al primo accesso.
+ * Crea automaticamente la directory ~/.seo-tool/ se non esiste.
+ */
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import { migrate } from 'drizzle-orm/better-sqlite3/migrator';
+import { mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import * as schema from './schema.js';
+function getDbPath() {
+    const envUrl = process.env['DATABASE_URL'];
+    if (envUrl) {
+        return envUrl.startsWith('file:') ? envUrl.replace('file:', '') : envUrl;
+    }
+    return join(homedir(), '.seo-tool', 'data.db');
+}
+let _sqlite = null;
+let _db = null;
+export function getDb() {
+    if (!_db) {
+        const dbPath = getDbPath();
+        mkdirSync(dirname(dbPath), { recursive: true });
+        _sqlite = new Database(dbPath);
+        _sqlite.pragma('journal_mode = WAL');
+        _sqlite.pragma('foreign_keys = ON');
+        _db = drizzle(_sqlite, { schema });
+    }
+    return _db;
+}
+export function closeDb() {
+    if (_sqlite) {
+        _sqlite.close();
+        _sqlite = null;
+        _db = null;
+    }
+}
+/**
+ * Applica le migrazioni Drizzle — zero-config al primo avvio.
+ * Usa i file SQL generati da `drizzle-kit generate` nella cartella drizzle/.
+ * Chiamata automatica dallo smoke-test e dall'entry point CLI.
+ */
+export function migrateDB() {
+    const instance = getDb();
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const migrationsFolder = join(__dirname, '..', '..', 'drizzle');
+    migrate(instance, { migrationsFolder });
+}
+/** Lazy proxy — compatibile con il pattern di import del vecchio prisma.ts */
+export const db = new Proxy({}, {
+    get(_target, prop) {
+        const instance = getDb();
+        return instance[prop];
+    },
+});
+//# sourceMappingURL=db.js.map

package/dist/database/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/database/db.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAItC,SAAS,SAAS;IAChB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AACjD,CAAC;AAED,IAAI,OAAO,GAA6B,IAAI,CAAC;AAC7C,IAAI,GAAG,GAAqB,IAAI,CAAC;AAEjC,MAAM,UAAU,KAAK;IACnB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACpC,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,GAAG,IAAI,CAAC;QACf,GAAG,GAAG,IAAI,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC;IACzB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAChE,OAAO,CAAC,QAAQ,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,EAAE,GAAc,IAAI,KAAK,CAAC,EAAe,EAAE;IACtD,GAAG,CAAC,OAAO,EAAE,IAAI;QACf,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC;QACzB,OAAQ,QAAgB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF,CAAC,CAAC"}