adonisjs-server-stats 1.10.0 → 1.10.3

package/dist/src/dashboard/knex_factory.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Knex/SQLite connection factory and PRAGMA configuration.
+ *
+ * Extracted from DashboardStore to reduce initKnex line count
+ * and keep the main store file focused on business logic.
+ */
+import type { Knex } from 'knex';
+export declare const SQLITE_PRAGMAS: string[];
+/**
+ * Apply all SQLite PRAGMAs via db.raw() calls.
+ * This is the fallback if afterCreate didn't work.
+ */
+export declare function applyPragmas(db: Knex): Promise<void>;
+/**
+ * Import knex and better-sqlite3 from the host app, then create
+ * a standalone Knex connection to SQLite.
+ */
+export declare function createKnexConnection(dbFilePath: string): Promise<Knex>;

package/dist/src/dashboard/knex_factory.js

@@ -0,0 +1,91 @@
+/**
+ * Knex/SQLite connection factory and PRAGMA configuration.
+ *
+ * Extracted from DashboardStore to reduce initKnex line count
+ * and keep the main store file focused on business logic.
+ */
+import { log } from '../utils/logger.js';
+// ---------------------------------------------------------------------------
+// PRAGMA constants
+// ---------------------------------------------------------------------------
+export const SQLITE_PRAGMAS = [
+    'journal_mode=WAL',
+    'foreign_keys=ON',
+    'synchronous=NORMAL',
+    'cache_size=-64000',
+    'mmap_size=268435456',
+    'temp_store=MEMORY',
+];
+const PRAGMA_STATEMENTS_FOR_POOL = [
+    'journal_mode = WAL',
+    'foreign_keys = ON',
+    'synchronous = NORMAL',
+    'cache_size = -64000',
+    'mmap_size = 268435456',
+    'temp_store = MEMORY',
+];
+// ---------------------------------------------------------------------------
+// PRAGMA application via db.raw()
+// ---------------------------------------------------------------------------
+/**
+ * Apply all SQLite PRAGMAs via db.raw() calls.
+ * This is the fallback if afterCreate didn't work.
+ */
+export async function applyPragmas(db) {
+    log.info('dashboard: setting PRAGMA...');
+    for (const pragma of SQLITE_PRAGMAS) {
+        await db.raw(`PRAGMA ${pragma}`);
+    }
+    log.info('dashboard: PRAGMA set');
+}
+// ---------------------------------------------------------------------------
+// Knex connection creation
+// ---------------------------------------------------------------------------
+/**
+ * Import knex and better-sqlite3 from the host app, then create
+ * a standalone Knex connection to SQLite.
+ */
+export async function createKnexConnection(dbFilePath) {
+    log.info('dashboard: loading knex...');
+    const { appImportWithPath } = await import('../utils/app_import.js');
+    const { module: knexModule, resolvedPath: knexPath } = await importWithError(appImportWithPath, 'knex', 'Install it with: npm install knex better-sqlite3');
+    const { resolvedPath: sqlite3Path } = await importWithError(appImportWithPath, 'better-sqlite3', 'Install it with: npm install better-sqlite3');
+    log.info(`dashboard: knex resolved from ${knexPath}`);
+    log.info(`dashboard: better-sqlite3 resolved from ${sqlite3Path}`);
+    const knexFactory = knexModule.default ?? knexModule;
+    log.info(`dashboard: opening SQLite database at ${dbFilePath}`);
+    return knexFactory({
+        client: 'better-sqlite3',
+        connection: { filename: dbFilePath },
+        useNullAsDefault: true,
+        pool: {
+            min: 1,
+            max: 1,
+            acquireTimeoutMillis: 10_000,
+            afterCreate: afterCreateHandler,
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+async function importWithError(appImportWithPath, moduleName, installHint) {
+    try {
+        return await appImportWithPath(moduleName);
+    }
+    catch (err) {
+        throw new Error(`Could not load ${moduleName}: ${err?.message}. ${installHint}`);
+    }
+}
+function afterCreateHandler(conn, done) {
+    const raw = conn;
+    try {
+        for (const pragma of PRAGMA_STATEMENTS_FOR_POOL) {
+            raw.pragma(pragma);
+        }
+    }
+    catch {
+        // Fallback: PRAGMAs will be set via db.raw() below
+    }
+    done(null, conn);
+}

package/dist/src/dashboard/migrator.js

@@ -1,13 +1,4 @@
-/**
- * Yield control back to the event loop so Node.js can process pending
- * I/O (incoming HTTP requests, timers, etc.).
- *
- * `better-sqlite3` is fully synchronous — when Knex wraps it, each
- * `await db.raw(...)` resolves via the microtask queue, never actually
- * yielding to the I/O phase. Without explicit yields, 25+ sequential
- * migration statements block the event loop for their entire duration.
- */
-const yieldToEventLoop = () => new Promise((resolve) => setImmediate(resolve));
+import { yieldToEventLoop, migrateRequests, migrateQueries, migrateEvents, migrateEmails, migrateLogs, migrateTraces, migrateMetrics, migrateSavedFilters, } from './migrator_tables.js';
 /**
  * Auto-migrate all dashboard SQLite tables.
  *
@@ -19,145 +10,21 @@ const yieldToEventLoop = () => new Promise((resolve) => setImmediate(resolve));
  * continue processing HTTP requests during migration.
  */
 export async function autoMigrate(db) {
-    // -- server_stats_requests --------------------------------------------------
-    await db.raw(`
-    CREATE TABLE IF NOT EXISTS server_stats_requests (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      method TEXT NOT NULL,
-      url TEXT NOT NULL,
-      status_code INTEGER NOT NULL,
-      duration REAL NOT NULL,
-      span_count INTEGER DEFAULT 0,
-      warning_count INTEGER DEFAULT 0,
-      http_request_id TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    )
-  `);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_created ON server_stats_requests(created_at)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_url ON server_stats_requests(url)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_duration ON server_stats_requests(duration)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_status ON server_stats_requests(status_code)`);
-    try {
-        await db.raw('ALTER TABLE server_stats_requests ADD COLUMN http_request_id TEXT');
-    }
-    catch { }
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_http_req ON server_stats_requests(http_request_id)`);
+    await migrateRequests(db);
     await yieldToEventLoop();
-    // -- server_stats_queries ---------------------------------------------------
-    await db.raw(`
-    CREATE TABLE IF NOT EXISTS server_stats_queries (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      request_id INTEGER REFERENCES server_stats_requests(id) ON DELETE CASCADE,
-      sql_text TEXT NOT NULL,
-      sql_normalized TEXT NOT NULL,
-      bindings TEXT,
-      duration REAL NOT NULL,
-      method TEXT,
-      model TEXT,
-      connection TEXT,
-      in_transaction INTEGER DEFAULT 0,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    )
-  `);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_created ON server_stats_queries(created_at)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_normalized ON server_stats_queries(sql_normalized)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_request ON server_stats_queries(request_id)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_duration ON server_stats_queries(duration)`);
+    await migrateQueries(db);
     await yieldToEventLoop();
-    // -- server_stats_events ----------------------------------------------------
-    await db.raw(`
-    CREATE TABLE IF NOT EXISTS server_stats_events (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      request_id INTEGER REFERENCES server_stats_requests(id) ON DELETE CASCADE,
-      event_name TEXT NOT NULL,
-      data TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    )
-  `);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_events_created ON server_stats_events(created_at)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_events_name ON server_stats_events(event_name)`);
+    await migrateEvents(db);
     await yieldToEventLoop();
-    // -- server_stats_emails ----------------------------------------------------
-    await db.raw(`
-    CREATE TABLE IF NOT EXISTS server_stats_emails (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      from_addr TEXT NOT NULL,
-      to_addr TEXT NOT NULL,
-      cc TEXT,
-      bcc TEXT,
-      subject TEXT NOT NULL,
-      html TEXT,
-      text_body TEXT,
-      mailer TEXT NOT NULL,
-      status TEXT NOT NULL,
-      message_id TEXT,
-      attachment_count INTEGER DEFAULT 0,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    )
-  `);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_emails_created ON server_stats_emails(created_at)`);
+    await migrateEmails(db);
     await yieldToEventLoop();
-    // -- server_stats_logs ------------------------------------------------------
-    await db.raw(`
-    CREATE TABLE IF NOT EXISTS server_stats_logs (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      level TEXT NOT NULL,
-      message TEXT NOT NULL,
-      request_id TEXT,
-      data TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    )
-  `);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_logs_created ON server_stats_logs(created_at)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_logs_level ON server_stats_logs(level)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_logs_request ON server_stats_logs(request_id)`);
+    await migrateLogs(db);
     await yieldToEventLoop();
-    // -- server_stats_traces ----------------------------------------------------
-    await db.raw(`
-    CREATE TABLE IF NOT EXISTS server_stats_traces (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      request_id INTEGER REFERENCES server_stats_requests(id) ON DELETE CASCADE,
-      method TEXT NOT NULL,
-      url TEXT NOT NULL,
-      status_code INTEGER NOT NULL,
-      total_duration REAL NOT NULL,
-      span_count INTEGER DEFAULT 0,
-      spans TEXT NOT NULL,
-      warnings TEXT,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    )
-  `);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_traces_created ON server_stats_traces(created_at)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_traces_request ON server_stats_traces(request_id)`);
+    await migrateTraces(db);
     await yieldToEventLoop();
-    // -- server_stats_metrics ---------------------------------------------------
-    await db.raw(`
-    CREATE TABLE IF NOT EXISTS server_stats_metrics (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      bucket TEXT NOT NULL,
-      request_count INTEGER DEFAULT 0,
-      avg_duration REAL DEFAULT 0,
-      p95_duration REAL DEFAULT 0,
-      error_count INTEGER DEFAULT 0,
-      query_count INTEGER DEFAULT 0,
-      avg_query_duration REAL DEFAULT 0,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    )
-  `);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_metrics_bucket ON server_stats_metrics(bucket)`);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_metrics_created ON server_stats_metrics(created_at)`);
+    await migrateMetrics(db);
     await yieldToEventLoop();
-    // -- server_stats_saved_filters ---------------------------------------------
-    await db.raw(`
-    CREATE TABLE IF NOT EXISTS server_stats_saved_filters (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      name TEXT NOT NULL,
-      section TEXT NOT NULL,
-      filter_config TEXT NOT NULL,
-      created_at TEXT NOT NULL DEFAULT (datetime('now'))
-    )
-  `);
-    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_filters_section ON server_stats_saved_filters(section)`);
+    await migrateSavedFilters(db);
 }
 /**
  * Delete records older than `retentionDays` from all tables.
@@ -176,28 +43,15 @@ export async function runRetentionCleanup(db, retentionDays) {
     const days = Math.max(1, Math.floor(retentionDays));
     const cutoff = `datetime('now', '-${days} days')`;
     try {
-        // Batch deletes to avoid blocking the event loop for large tables.
-        // Each batch deletes up to 1000 rows, yielding between batches.
-        const batchDelete = async (table) => {
-            let hasMore = true;
-            while (hasMore) {
-                await db.raw(`DELETE FROM ${table} WHERE rowid IN (SELECT rowid FROM ${table} WHERE created_at < ${cutoff} LIMIT 1000)`);
-                const remaining = await db.raw(`SELECT COUNT(*) as cnt FROM ${table} WHERE created_at < ${cutoff} LIMIT 1`);
-                const cnt = remaining?.[0]?.cnt ?? 0;
-                hasMore = cnt > 0;
-                if (hasMore)
-                    await yieldToEventLoop();
-            }
-        };
         // Cascade deletes queries, events, traces via FK ON DELETE CASCADE
-        await batchDelete('server_stats_requests');
+        await batchDelete(db, 'server_stats_requests', cutoff);
         await yieldToEventLoop();
         // Standalone tables
-        await batchDelete('server_stats_logs');
+        await batchDelete(db, 'server_stats_logs', cutoff);
         await yieldToEventLoop();
-        await batchDelete('server_stats_emails');
+        await batchDelete(db, 'server_stats_emails', cutoff);
         await yieldToEventLoop();
-        await batchDelete('server_stats_metrics');
+        await batchDelete(db, 'server_stats_metrics', cutoff);
         await yieldToEventLoop();
         // Reclaim space and update query planner statistics
         await db.raw('PRAGMA optimize');
@@ -208,3 +62,20 @@ export async function runRetentionCleanup(db, retentionDays) {
         log.warn(`dashboard: retention cleanup error — ${err?.message}`);
     }
 }
+/**
+ * Batch-delete old rows from a table, yielding between batches.
+ *
+ * Each batch deletes up to 1000 rows to avoid blocking the event loop
+ * for large tables.
+ */
+async function batchDelete(db, table, cutoff) {
+    let hasMore = true;
+    while (hasMore) {
+        await db.raw(`DELETE FROM ${table} WHERE rowid IN (SELECT rowid FROM ${table} WHERE created_at < ${cutoff} LIMIT 1000)`);
+        const remaining = await db.raw(`SELECT COUNT(*) as cnt FROM ${table} WHERE created_at < ${cutoff} LIMIT 1`);
+        const cnt = remaining?.[0]?.cnt ?? 0;
+        hasMore = cnt > 0;
+        if (hasMore)
+            await yieldToEventLoop();
+    }
+}

package/dist/src/dashboard/migrator_tables.d.ts

@@ -0,0 +1,19 @@
+import type { Knex } from 'knex';
+/**
+ * Yield control back to the event loop so Node.js can process pending
+ * I/O (incoming HTTP requests, timers, etc.).
+ *
+ * `better-sqlite3` is fully synchronous — when Knex wraps it, each
+ * `await db.raw(...)` resolves via the microtask queue, never actually
+ * yielding to the I/O phase. Without explicit yields, 25+ sequential
+ * migration statements block the event loop for their entire duration.
+ */
+export declare const yieldToEventLoop: () => Promise<void>;
+export declare function migrateRequests(db: Knex): Promise<void>;
+export declare function migrateQueries(db: Knex): Promise<void>;
+export declare function migrateEvents(db: Knex): Promise<void>;
+export declare function migrateEmails(db: Knex): Promise<void>;
+export declare function migrateLogs(db: Knex): Promise<void>;
+export declare function migrateTraces(db: Knex): Promise<void>;
+export declare function migrateMetrics(db: Knex): Promise<void>;
+export declare function migrateSavedFilters(db: Knex): Promise<void>;

package/dist/src/dashboard/migrator_tables.js

@@ -0,0 +1,153 @@
+/**
+ * Yield control back to the event loop so Node.js can process pending
+ * I/O (incoming HTTP requests, timers, etc.).
+ *
+ * `better-sqlite3` is fully synchronous — when Knex wraps it, each
+ * `await db.raw(...)` resolves via the microtask queue, never actually
+ * yielding to the I/O phase. Without explicit yields, 25+ sequential
+ * migration statements block the event loop for their entire duration.
+ */
+export const yieldToEventLoop = () => new Promise((resolve) => setImmediate(resolve));
+// ---------------------------------------------------------------------------
+// Per-table migration functions
+// ---------------------------------------------------------------------------
+export async function migrateRequests(db) {
+    await db.raw(`
+    CREATE TABLE IF NOT EXISTS server_stats_requests (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      method TEXT NOT NULL,
+      url TEXT NOT NULL,
+      status_code INTEGER NOT NULL,
+      duration REAL NOT NULL,
+      span_count INTEGER DEFAULT 0,
+      warning_count INTEGER DEFAULT 0,
+      http_request_id TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_created ON server_stats_requests(created_at)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_url ON server_stats_requests(url)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_duration ON server_stats_requests(duration)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_status ON server_stats_requests(status_code)`);
+    try {
+        await db.raw('ALTER TABLE server_stats_requests ADD COLUMN http_request_id TEXT');
+    }
+    catch { }
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_http_req ON server_stats_requests(http_request_id)`);
+}
+export async function migrateQueries(db) {
+    await db.raw(`
+    CREATE TABLE IF NOT EXISTS server_stats_queries (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      request_id INTEGER REFERENCES server_stats_requests(id) ON DELETE CASCADE,
+      sql_text TEXT NOT NULL,
+      sql_normalized TEXT NOT NULL,
+      bindings TEXT,
+      duration REAL NOT NULL,
+      method TEXT,
+      model TEXT,
+      connection TEXT,
+      in_transaction INTEGER DEFAULT 0,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_created ON server_stats_queries(created_at)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_normalized ON server_stats_queries(sql_normalized)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_request ON server_stats_queries(request_id)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_duration ON server_stats_queries(duration)`);
+}
+export async function migrateEvents(db) {
+    await db.raw(`
+    CREATE TABLE IF NOT EXISTS server_stats_events (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      request_id INTEGER REFERENCES server_stats_requests(id) ON DELETE CASCADE,
+      event_name TEXT NOT NULL,
+      data TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_events_created ON server_stats_events(created_at)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_events_name ON server_stats_events(event_name)`);
+}
+export async function migrateEmails(db) {
+    await db.raw(`
+    CREATE TABLE IF NOT EXISTS server_stats_emails (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      from_addr TEXT NOT NULL,
+      to_addr TEXT NOT NULL,
+      cc TEXT,
+      bcc TEXT,
+      subject TEXT NOT NULL,
+      html TEXT,
+      text_body TEXT,
+      mailer TEXT NOT NULL,
+      status TEXT NOT NULL,
+      message_id TEXT,
+      attachment_count INTEGER DEFAULT 0,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_emails_created ON server_stats_emails(created_at)`);
+}
+export async function migrateLogs(db) {
+    await db.raw(`
+    CREATE TABLE IF NOT EXISTS server_stats_logs (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      level TEXT NOT NULL,
+      message TEXT NOT NULL,
+      request_id TEXT,
+      data TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_logs_created ON server_stats_logs(created_at)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_logs_level ON server_stats_logs(level)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_logs_request ON server_stats_logs(request_id)`);
+}
+export async function migrateTraces(db) {
+    await db.raw(`
+    CREATE TABLE IF NOT EXISTS server_stats_traces (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      request_id INTEGER REFERENCES server_stats_requests(id) ON DELETE CASCADE,
+      method TEXT NOT NULL,
+      url TEXT NOT NULL,
+      status_code INTEGER NOT NULL,
+      total_duration REAL NOT NULL,
+      span_count INTEGER DEFAULT 0,
+      spans TEXT NOT NULL,
+      warnings TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_traces_created ON server_stats_traces(created_at)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_traces_request ON server_stats_traces(request_id)`);
+}
+export async function migrateMetrics(db) {
+    await db.raw(`
+    CREATE TABLE IF NOT EXISTS server_stats_metrics (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      bucket TEXT NOT NULL,
+      request_count INTEGER DEFAULT 0,
+      avg_duration REAL DEFAULT 0,
+      p95_duration REAL DEFAULT 0,
+      error_count INTEGER DEFAULT 0,
+      query_count INTEGER DEFAULT 0,
+      avg_query_duration REAL DEFAULT 0,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_metrics_bucket ON server_stats_metrics(bucket)`);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_metrics_created ON server_stats_metrics(created_at)`);
+}
+export async function migrateSavedFilters(db) {
+    await db.raw(`
+    CREATE TABLE IF NOT EXISTS server_stats_saved_filters (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      name TEXT NOT NULL,
+      section TEXT NOT NULL,
+      filter_config TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_filters_section ON server_stats_saved_filters(section)`);
+}

package/dist/src/dashboard/overview_queries.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Pure data-mapping helpers for dashboard overview and chart queries.
+ *
+ * These functions transform raw database rows into the shapes
+ * expected by the dashboard API. No I/O — just mapping and math.
+ */
+/**
+ * Build the overview metrics response from raw aggregated data.
+ * Pure function — no database access.
+ */
+interface OverviewInput {
+    total: number;
+    stats: Record<string, unknown> | null | undefined;
+    range: string;
+    slowestEndpoints: Record<string, unknown>[];
+    queryStats: Record<string, unknown> | null | undefined;
+    recentErrors: Record<string, unknown>[];
+}
+export declare function buildOverviewResult(input: OverviewInput): Record<string, unknown>;
+/**
+ * Map raw top events rows to the widget shape.
+ */
+export declare function mapTopEvents(raw: Record<string, unknown>[] | null | undefined): {
+    eventName: string;
+    count: number;
+}[];
+/**
+ * Aggregate email status rows into sent/queued/failed counts.
+ */
+export declare function mapEmailActivity(raw: Record<string, unknown>[] | null | undefined): {
+    sent: number;
+    queued: number;
+    failed: number;
+};
+/**
+ * Map log level rows to the breakdown shape.
+ */
+export declare function mapLogLevelBreakdown(raw: Record<string, unknown>[] | null | undefined): {
+    error: number;
+    warn: number;
+    info: number;
+    debug: number;
+};
+/**
+ * Map status distribution row to the widget shape.
+ */
+export declare function mapStatusDistribution(row: Record<string, unknown> | null | undefined): {
+    '2xx': number;
+    '3xx': number;
+    '4xx': number;
+    '5xx': number;
+};
+/**
+ * Map slowest query rows to the widget shape.
+ */
+export declare function mapSlowestQueries(raw: Record<string, unknown>[] | null | undefined): {
+    sqlNormalized: string;
+    avgDuration: number;
+    count: number;
+}[];
+/**
+ * Aggregate per-minute metrics into larger buckets for 24h/7d ranges.
+ * For 1h/6h, rows are returned as-is.
+ */
+export declare function aggregateChartBuckets(rows: Record<string, unknown>[], range: string): Record<string, unknown>[];
+export {};