adonisjs-server-stats 1.5.3 → 1.6.1

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

@@ -1,5 +1,22 @@
 import type { DevToolbarConfig } from '../debug/types.js';
 import type { QueryRecord, EventRecord, EmailRecord, TraceRecord } from '../debug/types.js';
+import type { Knex } from 'knex';
+interface EventEmitter {
+    on(event: string, handler: (...args: unknown[]) => void): void;
+    off(event: string, handler: (...args: unknown[]) => void): void;
+}
+export interface RequestInput {
+    method: string;
+    url: string;
+    statusCode: number;
+    duration: number;
+    spanCount?: number;
+    warningCount?: number;
+}
+export interface PersistRequestInput extends RequestInput {
+    queries: QueryRecord[];
+    trace: TraceRecord | null;
+}
 export interface RequestFilters {
     method?: string;
     url?: string;
@@ -8,6 +25,8 @@ export interface RequestFilters {
     statusMax?: number;
     durationMin?: number;
     durationMax?: number;
+    /** General text search across method and url */
+    search?: string;
 }
 export interface QueryFilters {
     method?: string;
@@ -16,11 +35,17 @@ export interface QueryFilters {
     durationMin?: number;
     durationMax?: number;
     requestId?: number;
+    /** General text search across sql_text, model, and connection */
+    search?: string;
 }
 export interface EventFilters {
     eventName?: string;
+    /** General text search across event_name */
+    search?: string;
 }
 export interface EmailFilters {
+    /** General text search across from_addr, to_addr, and subject */
+    search?: string;
     from?: string;
     to?: string;
     subject?: string;
@@ -43,6 +68,8 @@ export interface TraceFilters {
     url?: string;
     statusMin?: number;
     statusMax?: number;
+    /** General text search across method and url */
+    search?: string;
 }
 export interface PaginatedResult<T> {
     data: T[];
@@ -66,23 +93,38 @@ export declare class DashboardStore {
     private retentionTimer;
     private chartAggregator;
     private handlers;
+    private dbFilePath;
+    private lastCleanupAt;
     constructor(config: DevToolbarConfig);
     /**
      * Initialize the SQLite connection, run migrations and retention
      * cleanup, start chart aggregation, and wire event listeners.
      */
-    start(_lucidDb: any, emitter: any, appRoot: string): Promise<void>;
+    start(_lucidDb: unknown, emitter: EventEmitter | null, appRoot: string): Promise<void>;
     /** Shut down timers, event listeners, and database connection. */
     stop(): Promise<void>;
     /** Get the raw Knex database connection (for DashboardController). */
-    getDb(): any;
+    getDb(): Knex | null;
     /** Whether the store is initialized and ready. */
     isReady(): boolean;
+    /** Get SQLite storage statistics for the diagnostics endpoint. */
+    getStorageStats(): Promise<{
+        ready: boolean;
+        dbPath: string;
+        fileSizeMb: number;
+        walSizeMb: number;
+        retentionDays: number;
+        tables: Array<{
+            name: string;
+            rowCount: number;
+        }>;
+        lastCleanupAt: number | null;
+    }>;
     /**
      * Record a completed request. Returns the inserted row ID, or null
      * if the request was self-excluded or an error occurred.
      */
-    recordRequest(method: string, url: string, statusCode: number, duration: number, spanCount?: number, warningCount?: number): Promise<number | null>;
+    recordRequest(input: RequestInput): Promise<number | null>;
     /** Batch-insert queries for a request. Filters out server_stats connection queries. */
     recordQueries(requestId: number, queries: QueryRecord[]): Promise<void>;
     /** Batch-insert events for a request. */
@@ -97,20 +139,20 @@ export declare class DashboardStore {
      * Convenience: persist a full request with associated queries and trace.
      * Calls recordRequest, recordQueries, and recordTrace in sequence.
      */
-    persistRequest(method: string, url: string, statusCode: number, duration: number, queries: QueryRecord[], trace: TraceRecord | null): Promise<number | null>;
+    persistRequest(input: PersistRequestInput): Promise<number | null>;
     /** Paginated request history with optional filters. */
-    getRequests(page?: number, perPage?: number, filters?: RequestFilters): Promise<PaginatedResult<any>>;
+    getRequests(page?: number, perPage?: number, filters?: RequestFilters): Promise<PaginatedResult<Record<string, unknown>>>;
     /** Paginated query history with optional filters. */
-    getQueries(page?: number, perPage?: number, filters?: QueryFilters): Promise<PaginatedResult<any>>;
+    getQueries(page?: number, perPage?: number, filters?: QueryFilters): Promise<PaginatedResult<Record<string, unknown>>>;
     /**
      * Grouped query patterns: aggregated by sql_normalized
      * with count, avg/min/max/total duration.
      */
-    getQueriesGrouped(limit?: number, sort?: string): Promise<any[]>;
+    getQueriesGrouped(limit?: number, sort?: string, search?: string): Promise<Record<string, unknown>[]>;
     /** Paginated event history with optional filters. */
-    getEvents(page?: number, perPage?: number, filters?: EventFilters): Promise<PaginatedResult<any>>;
+    getEvents(page?: number, perPage?: number, filters?: EventFilters): Promise<PaginatedResult<Record<string, unknown>>>;
     /** Paginated email history with optional filters. */
-    getEmails(page?: number, perPage?: number, filters?: EmailFilters, excludeBody?: boolean): Promise<PaginatedResult<any>>;
+    getEmails(page?: number, perPage?: number, filters?: EmailFilters, excludeBody?: boolean): Promise<PaginatedResult<Record<string, unknown>>>;
     /** Get email HTML body for preview (falls back to text_body). */
     getEmailHtml(id: number): Promise<string | null>;
     /**
@@ -119,25 +161,25 @@ export declare class DashboardStore {
      * Structured filters query into the JSON `data` column using
      * SQLite's `json_extract()`.
      */
-    getLogs(page?: number, perPage?: number, filters?: LogFilters): Promise<PaginatedResult<any>>;
+    getLogs(page?: number, perPage?: number, filters?: LogFilters): Promise<PaginatedResult<Record<string, unknown>>>;
     /** Paginated trace history with optional filters. */
-    getTraces(page?: number, perPage?: number, filters?: TraceFilters): Promise<PaginatedResult<any>>;
+    getTraces(page?: number, perPage?: number, filters?: TraceFilters): Promise<PaginatedResult<Record<string, unknown>>>;
     /** Single trace with full span data. */
-    getTraceDetail(id: number): Promise<any | null>;
+    getTraceDetail(id: number): Promise<Record<string, unknown> | null>;
     /** Single request with associated queries, events, and trace. */
-    getRequestDetail(id: number): Promise<any | null>;
+    getRequestDetail(id: number): Promise<Record<string, unknown> | null>;
     /**
      * Aggregated overview metrics for the dashboard cards.
      *
      * @param range — '1h' | '6h' | '24h' | '7d'
      */
-    getOverviewMetrics(range?: string): Promise<any>;
+    getOverviewMetrics(range?: string): Promise<Record<string, unknown> | null>;
     /**
      * Time-series chart data from server_stats_metrics.
      *
      * @param range — '1h' | '6h' | '24h' | '7d'
      */
-    getChartData(range?: string): Promise<any[]>;
+    getChartData(range?: string): Promise<Record<string, unknown>[]>;
     /**
      * Widget data for the dashboard overview.
      *
@@ -172,9 +214,9 @@ export declare class DashboardStore {
         }[];
     }>;
     /** Get sparkline data points from pre-aggregated metrics. */
-    getSparklineData(range: string): Promise<any[]>;
-    getSavedFilters(section?: string): Promise<any[]>;
-    createSavedFilter(name: string, section: string, filterConfig: Record<string, any>): Promise<any>;
+    getSparklineData(range: string): Promise<Record<string, unknown>[]>;
+    getSavedFilters(section?: string): Promise<Record<string, unknown>[]>;
+    createSavedFilter(name: string, section: string, filterConfig: Record<string, unknown>): Promise<Record<string, unknown> | null>;
     deleteSavedFilter(id: number): Promise<boolean>;
     /**
      * Run EXPLAIN on a stored query using the app's default database connection.
@@ -183,7 +225,7 @@ export declare class DashboardStore {
      * @param queryId — ID from server_stats_queries
      * @param appDb — The application's Lucid database manager
      */
-    runExplain(queryId: number, appDb: any): Promise<any>;
+    runExplain(queryId: number, appDb: unknown): Promise<Record<string, unknown> | null>;
     /** Generic paginated query with filter callback. */
     private paginate;
     /**
@@ -191,4 +233,5 @@ export declare class DashboardStore {
      */
     private wireEventListeners;
 }
+export {};
 //# sourceMappingURL=dashboard_store.d.ts.map

package/dist/src/dashboard/dashboard_store.d.ts.map

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

package/dist/src/dashboard/dashboard_store.js

@@ -1,12 +1,18 @@
-import { mkdir } from 'node:fs/promises';
+import { mkdir, stat as fsStat } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import { safeParseJson, safeParseJsonArray } from '../utils/json_helpers.js';
+import { log } from '../utils/logger.js';
 import { extractAddresses } from '../utils/mail_helpers.js';
 import { round } from '../utils/math_helpers.js';
 import { rangeToCutoff, rangeToMinutes, roundBucket } from '../utils/time_helpers.js';
 import { ChartAggregator } from './chart_aggregator.js';
 import { autoMigrate, runRetentionCleanup } from './migrator.js';
 // ---------------------------------------------------------------------------
+// Warn-once tracking for write-path and overview catch blocks
+// ---------------------------------------------------------------------------
+const warnedWritePaths = new Set();
+let overviewWidgetWarned = false;
+// ---------------------------------------------------------------------------
 // DashboardStore
 // ---------------------------------------------------------------------------
 /**
@@ -24,6 +30,8 @@ export class DashboardStore {
     retentionTimer = null;
     chartAggregator = null;
     handlers = [];
+    dbFilePath = '';
+    lastCleanupAt = null;
     constructor(config) {
         this.config = config;
         this.dashboardPath = config.dashboardPath;
@@ -37,7 +45,8 @@ export class DashboardStore {
      */
     async start(_lucidDb, emitter, appRoot) {
         this.emitter = emitter;
-        const dbFilePath = appRoot + '/' + this.config.dbPath;
+        this.dbFilePath = appRoot + '/' + this.config.dbPath;
+        const dbFilePath = this.dbFilePath;
         await mkdir(dirname(dbFilePath), { recursive: true });
         // Create a standalone Knex connection to SQLite — bypasses Lucid's
         // connection manager entirely so we never pollute the app's pool.
@@ -52,13 +61,17 @@ export class DashboardStore {
         await this.db.raw('PRAGMA foreign_keys=ON');
         await autoMigrate(this.db);
         await runRetentionCleanup(this.db, this.config.retentionDays);
+        this.lastCleanupAt = Date.now();
         // Hourly retention cleanup
         this.retentionTimer = setInterval(async () => {
             try {
-                await runRetentionCleanup(this.db, this.config.retentionDays);
+                if (this.db) {
+                    await runRetentionCleanup(this.db, this.config.retentionDays);
+                    this.lastCleanupAt = Date.now();
+                }
             }
-            catch {
-                // Silently ignore
+            catch (err) {
+                log.warn('dashboard: retention cleanup failed — ' + err?.message);
             }
         }, 60 * 60 * 1000);
         // Start chart aggregation (every 60s)
@@ -86,8 +99,8 @@ export class DashboardStore {
             try {
                 await this.db.destroy();
             }
-            catch {
-                // Ignore
+            catch (err) {
+                log.warn('dashboard: error closing SQLite — ' + err?.message);
             }
         }
         this.db = null;
@@ -100,6 +113,65 @@ export class DashboardStore {
     isReady() {
         return this.db !== null;
     }
+    /** Get SQLite storage statistics for the diagnostics endpoint. */
+    async getStorageStats() {
+        if (!this.db) {
+            return {
+                ready: false,
+                dbPath: this.config.dbPath,
+                fileSizeMb: 0,
+                walSizeMb: 0,
+                retentionDays: this.config.retentionDays,
+                tables: [],
+                lastCleanupAt: null,
+            };
+        }
+        let fileSizeMb = 0;
+        let walSizeMb = 0;
+        try {
+            const s = await fsStat(this.dbFilePath);
+            fileSizeMb = Math.round((s.size / (1024 * 1024)) * 100) / 100;
+        }
+        catch {
+            // File may not exist yet
+        }
+        try {
+            const ws = await fsStat(this.dbFilePath + '-wal');
+            walSizeMb = Math.round((ws.size / (1024 * 1024)) * 100) / 100;
+        }
+        catch {
+            // WAL file may not exist
+        }
+        const tableNames = [
+            'server_stats_requests',
+            'server_stats_queries',
+            'server_stats_events',
+            'server_stats_emails',
+            'server_stats_logs',
+            'server_stats_traces',
+            'server_stats_metrics',
+            'server_stats_saved_filters',
+        ];
+        const tables = [];
+        for (const name of tableNames) {
+            try {
+                const [row] = await this.db(name).count('* as count');
+                tables.push({ name, rowCount: Number(row.count) });
+            }
+            catch {
+                tables.push({ name, rowCount: 0 });
+            }
+        }
+        return {
+            ready: true,
+            dbPath: this.config.dbPath,
+            fileSizeMb,
+            walSizeMb,
+            retentionDays: this.config.retentionDays,
+            tables,
+            lastCleanupAt: this.lastCleanupAt,
+        };
+    }
     // =========================================================================
     // Write methods — persist data from collectors
     // =========================================================================
@@ -107,23 +179,28 @@ export class DashboardStore {
      * Record a completed request. Returns the inserted row ID, or null
      * if the request was self-excluded or an error occurred.
      */
-    async recordRequest(method, url, statusCode, duration, spanCount = 0, warningCount = 0) {
+    async recordRequest(input) {
         if (!this.db)
             return null;
-        if (url.startsWith(this.dashboardPath))
+        if (input.url.startsWith(this.dashboardPath))
             return null;
         try {
             const [id] = await this.db('server_stats_requests').insert({
-                method,
-                url,
-                status_code: statusCode,
-                duration: round(duration),
-                span_count: spanCount,
-                warning_count: warningCount,
+                method: input.method,
+                url: input.url,
+                status_code: input.statusCode,
+                duration: round(input.duration),
+                span_count: input.spanCount ?? 0,
+                warning_count: input.warningCount ?? 0,
             });
             return id;
         }
-        catch {
+        catch (err) {
+            const method_ = 'recordRequest';
+            if (!warnedWritePaths.has(method_)) {
+                warnedWritePaths.add(method_);
+                log.warn(`dashboard: ${method_} failed — ${err?.message}`);
+            }
             return null;
         }
     }
@@ -151,8 +228,12 @@ export class DashboardStore {
                 await this.db('server_stats_queries').insert(rows.slice(i, i + 50));
             }
         }
-        catch {
-            // Silently ignore
+        catch (err) {
+            const method = 'recordQueries';
+            if (!warnedWritePaths.has(method)) {
+                warnedWritePaths.add(method);
+                log.warn(`dashboard: ${method} failed — ${err?.message}`);
+            }
         }
     }
     /** Batch-insert events for a request. */
@@ -169,8 +250,12 @@ export class DashboardStore {
                 await this.db('server_stats_events').insert(rows.slice(i, i + 50));
             }
         }
-        catch {
-            // Silently ignore
+        catch (err) {
+            const method = 'recordEvents';
+            if (!warnedWritePaths.has(method)) {
+                warnedWritePaths.add(method);
+                log.warn(`dashboard: ${method} failed — ${err?.message}`);
+            }
         }
     }
     /** Record a single email. */
@@ -192,8 +277,12 @@ export class DashboardStore {
                 attachment_count: record.attachmentCount,
             });
         }
-        catch {
-            // Silently ignore
+        catch (err) {
+            const method = 'recordEmail';
+            if (!warnedWritePaths.has(method)) {
+                warnedWritePaths.add(method);
+                log.warn(`dashboard: ${method} failed — ${err?.message}`);
+            }
         }
     }
     /** Record a single log entry (from LogStreamService). */
@@ -205,12 +294,18 @@ export class DashboardStore {
             await this.db('server_stats_logs').insert({
                 level: levelName,
                 message: String(entry.msg || entry.message || ''),
-                request_id: entry.requestId ? String(entry.requestId) : null,
+                request_id: entry.request_id || entry.requestId || entry['x-request-id']
+                    ? String(entry.request_id || entry.requestId || entry['x-request-id'])
+                    : null,
                 data: JSON.stringify(entry),
             });
         }
-        catch {
-            // Silently ignore
+        catch (err) {
+            const method = 'recordLog';
+            if (!warnedWritePaths.has(method)) {
+                warnedWritePaths.add(method);
+                log.warn(`dashboard: ${method} failed — ${err?.message}`);
+            }
         }
     }
     /** Record a trace for a request. */
@@ -229,21 +324,32 @@ export class DashboardStore {
                 warnings: trace.warnings.length > 0 ? JSON.stringify(trace.warnings) : null,
             });
         }
-        catch {
-            // Silently ignore
+        catch (err) {
+            const method = 'recordTrace';
+            if (!warnedWritePaths.has(method)) {
+                warnedWritePaths.add(method);
+                log.warn(`dashboard: ${method} failed — ${err?.message}`);
+            }
         }
     }
     /**
      * Convenience: persist a full request with associated queries and trace.
      * Calls recordRequest, recordQueries, and recordTrace in sequence.
      */
-    async persistRequest(method, url, statusCode, duration, queries, trace) {
-        const requestId = await this.recordRequest(method, url, statusCode, duration, trace?.spanCount ?? 0, trace?.warnings?.length ?? 0);
+    async persistRequest(input) {
+        const requestId = await this.recordRequest({
+            method: input.method,
+            url: input.url,
+            statusCode: input.statusCode,
+            duration: input.duration,
+            spanCount: input.trace?.spanCount ?? 0,
+            warningCount: input.trace?.warnings?.length ?? 0,
+        });
         if (requestId === null)
             return null;
-        await this.recordQueries(requestId, queries);
-        if (trace) {
-            await this.recordTrace(requestId, trace);
+        await this.recordQueries(requestId, input.queries);
+        if (input.trace) {
+            await this.recordTrace(requestId, input.trace);
         }
         return requestId;
     }
@@ -267,6 +373,12 @@ export class DashboardStore {
                 query.where('duration', '>=', filters.durationMin);
             if (filters?.durationMax)
                 query.where('duration', '<=', filters.durationMax);
+            if (filters?.search) {
+                const term = `%${filters.search}%`;
+                query.where((qb) => {
+                    qb.where('url', 'like', term).orWhere('method', 'like', term);
+                });
+            }
         });
     }
     /** Paginated query history with optional filters. */
@@ -284,13 +396,21 @@ export class DashboardStore {
                 query.where('duration', '<=', filters.durationMax);
             if (filters?.requestId)
                 query.where('request_id', filters.requestId);
+            if (filters?.search) {
+                const term = `%${filters.search}%`;
+                query.where((qb) => {
+                    qb.where('sql_text', 'like', term)
+                        .orWhere('model', 'like', term)
+                        .orWhere('connection', 'like', term);
+                });
+            }
         });
     }
     /**
      * Grouped query patterns: aggregated by sql_normalized
      * with count, avg/min/max/total duration.
      */
-    async getQueriesGrouped(limit = 200, sort = 'total_duration') {
+    async getQueriesGrouped(limit = 200, sort = 'total_duration', search) {
         if (!this.db)
             return [];
         const validSorts = {
@@ -299,22 +419,38 @@ export class DashboardStore {
             total_duration: 'total_duration',
         };
         const orderCol = validSorts[sort] || 'total_duration';
-        return this.db('server_stats_queries')
+        const query = this.db('server_stats_queries')
             .select('sql_normalized', this.db.raw('COUNT(*) as count'), this.db.raw('ROUND(AVG(duration), 2) as avg_duration'), this.db.raw('ROUND(MIN(duration), 2) as min_duration'), this.db.raw('ROUND(MAX(duration), 2) as max_duration'), this.db.raw('ROUND(SUM(duration), 2) as total_duration'))
             .groupBy('sql_normalized')
             .orderBy(orderCol, 'desc')
             .limit(limit);
+        if (search) {
+            query.where('sql_normalized', 'like', `%${search}%`);
+        }
+        return query;
     }
     /** Paginated event history with optional filters. */
     async getEvents(page = 1, perPage = 50, filters) {
         return this.paginate('server_stats_events', page, perPage, (query) => {
             if (filters?.eventName)
                 query.where('event_name', 'like', `%${filters.eventName}%`);
+            if (filters?.search) {
+                query.where('event_name', 'like', `%${filters.search}%`);
+            }
         });
     }
     /** Paginated email history with optional filters. */
     async getEmails(page = 1, perPage = 50, filters, excludeBody = false) {
         return this.paginate('server_stats_emails', page, perPage, (query) => {
+            if (filters?.search) {
+                const term = `%${filters.search}%`;
+                query.where((sub) => {
+                    sub
+                        .where('from_addr', 'like', term)
+                        .orWhere('to_addr', 'like', term)
+                        .orWhere('subject', 'like', term);
+                });
+            }
             if (filters?.from)
                 query.where('from_addr', 'like', `%${filters.from}%`);
             if (filters?.to)
@@ -386,6 +522,12 @@ export class DashboardStore {
                 query.where('status_code', '>=', filters.statusMin);
             if (filters?.statusMax)
                 query.where('status_code', '<=', filters.statusMax);
+            if (filters?.search) {
+                const term = `%${filters.search}%`;
+                query.where((qb) => {
+                    qb.where('url', 'like', term).orWhere('method', 'like', term);
+                });
+            }
         });
     }
     /** Single trace with full span data. */
@@ -613,12 +755,13 @@ export class DashboardStore {
             const emailActivity = { sent: 0, queued: 0, failed: 0 };
             for (const row of emailStatusRaw || []) {
                 const status = row.status;
+                const count = row.count;
                 if (status === 'sent')
-                    emailActivity.sent = row.count;
+                    emailActivity.sent = count;
                 else if (status === 'queued')
-                    emailActivity.queued = row.count;
+                    emailActivity.queued = count;
                 else if (status === 'failed')
-                    emailActivity.failed = row.count;
+                    emailActivity.failed = count;
             }
             // Map log level breakdown
             const logLevelBreakdown = { error: 0, warn: 0, info: 0, debug: 0 };
@@ -643,7 +786,11 @@ export class DashboardStore {
             }));
             return { topEvents, emailActivity, logLevelBreakdown, statusDistribution, slowestQueries };
         }
-        catch {
+        catch (err) {
+            if (!overviewWidgetWarned) {
+                overviewWidgetWarned = true;
+                log.warn('dashboard: getOverviewWidgets query failed — ' + err?.message);
+            }
             return empty;
         }
     }
@@ -724,7 +871,8 @@ export class DashboardStore {
         const countQuery = this.db(table);
         if (applyFilters)
             applyFilters(countQuery);
-        const [{ count: total }] = await countQuery.count('* as count');
+        const [{ count: totalRaw }] = await countQuery.count('* as count');
+        const total = Number(totalRaw);
         // Fetch page
         const offset = (page - 1) * perPage;
         const dataQuery = this.db(table).orderBy('created_at', 'desc').limit(perPage).offset(offset);
@@ -746,7 +894,8 @@ export class DashboardStore {
         if (!this.emitter || typeof this.emitter.on !== 'function')
             return;
         const buildAndPersistEmail = (data, status) => {
-            const msg = data?.message || data;
+            const d = data;
+            const msg = (d?.message || d);
             const record = {
                 id: 0,
                 from: extractAddresses(msg?.from) || 'unknown',
@@ -756,10 +905,14 @@ export class DashboardStore {
                 subject: msg?.subject || '(no subject)',
                 html: msg?.html || null,
                 text: msg?.text || null,
-                mailer: data?.mailerName || data?.mailer || 'unknown',
+                mailer: d?.mailerName || d?.mailer || 'unknown',
                 status,
-                messageId: data?.response?.messageId || data?.messageId || null,
-                attachmentCount: Array.isArray(msg?.attachments) ? msg.attachments.length : 0,
+                messageId: d?.response?.messageId ||
+                    d?.messageId ||
+                    null,
+                attachmentCount: Array.isArray(msg?.attachments)
+                    ? msg.attachments.length
+                    : 0,
                 timestamp: Date.now(),
             };
             this.recordEmail(record);