@johnboxcodes/boxlogger 0.1.0

package/dist/stores/memory.js

@@ -0,0 +1,284 @@
+/**
+ * Memory Store Provider
+ *
+ * In-memory storage implementation for development, testing, or ephemeral logging.
+ *
+ * @module stores/memory
+ * @packageDocumentation
+ */
+import { BaseStoreProvider } from './base.js';
+/**
+ * In-memory store provider
+ *
+ * @remarks
+ * Fast read/write operations with no persistence.
+ * Data is lost when the process exits.
+ * Ideal for testing, development, or caching scenarios.
+ *
+ * @example
+ * ```typescript
+ * import { MemoryStoreProvider } from '@nodelogger/core/memory';
+ *
+ * const store = new MemoryStoreProvider({ maxLogs: 5000 });
+ * await store.init();
+ *
+ * await store.saveLog({
+ *   id: '1',
+ *   timestamp: new Date().toISOString(),
+ *   level: 'info',
+ *   message: 'Hello world'
+ * });
+ * ```
+ */
+export class MemoryStoreProvider extends BaseStoreProvider {
+    name = 'memory';
+    logs = [];
+    sessions = new Map();
+    constructor(config) {
+        super({
+            ...config,
+            maxLogs: config?.maxLogs ?? 10000,
+            maxSessions: config?.maxSessions ?? 1000,
+        });
+    }
+    /**
+     * Initialize the memory store
+     */
+    async init() {
+        this._ready = true;
+        this.startCleanupTimer();
+    }
+    /**
+     * Close the memory store and clear all data
+     */
+    async close() {
+        this.stopCleanupTimer();
+        this.logs = [];
+        this.sessions.clear();
+        this._ready = false;
+    }
+    // =========================================================================
+    // Log Operations
+    // =========================================================================
+    /**
+     * Save a log entry to memory
+     * @param entry - Log entry to save
+     */
+    async saveLog(entry) {
+        this.ensureReady();
+        const logEntry = {
+            ...entry,
+            id: entry.id || this.generateId(),
+            timestamp: entry.timestamp || this.now(),
+        };
+        this.logs.push(logEntry);
+        // Enforce max logs limit (FIFO eviction)
+        if (this.logs.length > this.config.maxLogs) {
+            this.logs = this.logs.slice(-this.config.maxLogs);
+        }
+    }
+    /**
+     * Get log entries matching filter
+     * @param filter - Query filter
+     * @returns Matching log entries
+     */
+    async getLogs(filter) {
+        this.ensureReady();
+        if (!filter) {
+            return this.logs.map((log) => this.clone(log));
+        }
+        return this.filterLogs(this.logs, filter).map((log) => this.clone(log));
+    }
+    /**
+     * Delete log entries matching filter
+     * @param filter - Query filter
+     * @returns Number of deleted entries
+     */
+    async deleteLogs(filter) {
+        this.ensureReady();
+        if (!filter) {
+            const count = this.logs.length;
+            this.logs = [];
+            return count;
+        }
+        const toDelete = new Set(this.filterLogs(this.logs, filter).map((l) => l.id));
+        const before = this.logs.length;
+        this.logs = this.logs.filter((log) => !toDelete.has(log.id));
+        return before - this.logs.length;
+    }
+    /**
+     * Count log entries matching filter
+     * @param filter - Query filter
+     * @returns Count of matching entries
+     */
+    async countLogs(filter) {
+        this.ensureReady();
+        if (!filter) {
+            return this.logs.length;
+        }
+        return this.filterLogs(this.logs, filter).length;
+    }
+    // =========================================================================
+    // Session Operations
+    // =========================================================================
+    /**
+     * Create a new session
+     * @param session - Session to create
+     */
+    async createSession(session) {
+        this.ensureReady();
+        const sessionEntry = {
+            ...session,
+            id: session.id || this.generateId(),
+            startedAt: session.startedAt || this.now(),
+            status: session.status || 'active',
+            errorCount: session.errorCount || 0,
+        };
+        this.sessions.set(sessionEntry.id, sessionEntry);
+        // Enforce max sessions limit
+        if (this.sessions.size > this.config.maxSessions) {
+            const sorted = Array.from(this.sessions.values()).sort((a, b) => this.parseTimestamp(a.startedAt).getTime() -
+                this.parseTimestamp(b.startedAt).getTime());
+            const toRemove = sorted.slice(0, this.sessions.size - this.config.maxSessions);
+            for (const s of toRemove) {
+                this.sessions.delete(s.id);
+            }
+        }
+    }
+    /**
+     * Update an existing session
+     * @param sessionId - Session ID
+     * @param updates - Partial session data
+     */
+    async updateSession(sessionId, updates) {
+        this.ensureReady();
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        this.sessions.set(sessionId, {
+            ...session,
+            ...updates,
+            id: session.id, // Don't allow ID change
+        });
+    }
+    /**
+     * Get a session by ID
+     * @param sessionId - Session ID
+     * @returns Session or null
+     */
+    async getSession(sessionId) {
+        this.ensureReady();
+        const session = this.sessions.get(sessionId);
+        return session ? this.clone(session) : null;
+    }
+    /**
+     * Get sessions matching filter
+     * @param filter - Query filter
+     * @returns Matching sessions
+     */
+    async getSessions(filter) {
+        this.ensureReady();
+        const sessions = Array.from(this.sessions.values());
+        if (!filter) {
+            return sessions
+                .sort((a, b) => this.parseTimestamp(b.startedAt).getTime() -
+                this.parseTimestamp(a.startedAt).getTime())
+                .map((s) => this.clone(s));
+        }
+        return this.filterSessions(sessions, filter).map((s) => this.clone(s));
+    }
+    /**
+     * Delete a session and its associated logs
+     * @param sessionId - Session ID
+     */
+    async deleteSession(sessionId) {
+        this.ensureReady();
+        this.sessions.delete(sessionId);
+        this.logs = this.logs.filter((log) => log.sessionId !== sessionId);
+    }
+    // =========================================================================
+    // Maintenance Operations
+    // =========================================================================
+    /**
+     * Clean up old data
+     * @param olderThan - Delete entries older than this date
+     * @returns Number of deleted entries
+     */
+    async cleanup(olderThan) {
+        this.ensureReady();
+        const cutoff = olderThan.getTime();
+        let deleted = 0;
+        // Clean logs
+        const logsBefore = this.logs.length;
+        this.logs = this.logs.filter((log) => this.parseTimestamp(log.timestamp).getTime() > cutoff);
+        deleted += logsBefore - this.logs.length;
+        // Clean ended sessions
+        for (const [id, session] of this.sessions) {
+            if (session.status !== 'active' &&
+                session.endedAt &&
+                this.parseTimestamp(session.endedAt).getTime() <= cutoff) {
+                this.sessions.delete(id);
+                deleted++;
+            }
+        }
+        return deleted;
+    }
+    /**
+     * Get storage statistics
+     * @returns Storage stats
+     */
+    async getStats() {
+        this.ensureReady();
+        const logsByLevel = {
+            fatal: 0,
+            error: 0,
+            warn: 0,
+            info: 0,
+            debug: 0,
+            trace: 0,
+        };
+        let oldest;
+        let newest;
+        for (const log of this.logs) {
+            logsByLevel[log.level]++;
+            if (!oldest || log.timestamp < oldest) {
+                oldest = log.timestamp;
+            }
+            if (!newest || log.timestamp > newest) {
+                newest = log.timestamp;
+            }
+        }
+        const activeSessions = Array.from(this.sessions.values()).filter((s) => s.status === 'active').length;
+        return {
+            totalLogs: this.logs.length,
+            totalSessions: this.sessions.size,
+            activeSessions,
+            logsByLevel,
+            oldestLog: oldest,
+            newestLog: newest,
+        };
+    }
+    // =========================================================================
+    // Additional Memory Store Methods
+    // =========================================================================
+    /**
+     * Clear all data from the store
+     */
+    async clear() {
+        this.ensureReady();
+        this.logs = [];
+        this.sessions.clear();
+    }
+    /**
+     * Get raw storage arrays (for debugging)
+     * @returns Internal storage references
+     */
+    getRawData() {
+        return {
+            logs: this.logs,
+            sessions: this.sessions,
+        };
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/stores/memory.js.map

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

package/dist/stores/sqlite.d.ts

@@ -0,0 +1,204 @@
+/**
+ * SQLite Store Provider
+ *
+ * Persistent storage using better-sqlite3 - the most reliable SQLite library for Node.js.
+ *
+ * @module stores/sqlite
+ * @packageDocumentation
+ */
+import Database, { type Database as DatabaseType } from 'better-sqlite3';
+import { BaseStoreProvider } from './base.js';
+import type { StoreProviderConfig, LogEntry, Session, LogFilter, SessionFilter, StoreStats } from '../types.js';
+/**
+ * Configuration options for SQLite store
+ */
+export interface SQLiteStoreConfig extends StoreProviderConfig {
+    /**
+     * Path to SQLite database file
+     * @default ':memory:' for in-memory database
+     */
+    filename?: string;
+    /**
+     * Enable WAL mode for better concurrent read performance
+     * @default true
+     */
+    walMode?: boolean;
+    /**
+     * Cache size in KB (negative for number of pages)
+     * @default -2000 (2000 pages)
+     */
+    cacheSize?: number;
+    /**
+     * Enable foreign keys
+     * @default true
+     */
+    foreignKeys?: boolean;
+    /**
+     * Create indexes for common queries
+     * @default true
+     */
+    createIndexes?: boolean;
+}
+/**
+ * SQLite store provider using better-sqlite3
+ *
+ * @remarks
+ * Uses synchronous better-sqlite3 for maximum performance and reliability.
+ * Supports both file-based and in-memory databases.
+ *
+ * Features:
+ * - WAL mode for concurrent reads
+ * - Automatic schema creation and migration
+ * - Full-text search on message field
+ * - Efficient indexes for common query patterns
+ * - Transaction support for bulk operations
+ *
+ * @example
+ * ```typescript
+ * import { SQLiteStoreProvider } from '@nodelogger/core/sqlite';
+ *
+ * // File-based persistent storage
+ * const store = new SQLiteStoreProvider({
+ *   filename: './logs.db',
+ *   walMode: true
+ * });
+ * await store.init();
+ *
+ * // In-memory (fast, non-persistent)
+ * const memStore = new SQLiteStoreProvider();
+ * await memStore.init();
+ * ```
+ */
+export declare class SQLiteStoreProvider extends BaseStoreProvider {
+    readonly name = "sqlite";
+    private db;
+    private sqliteConfig;
+    constructor(config?: SQLiteStoreConfig);
+    /**
+     * Initialize the SQLite database
+     */
+    init(): Promise<void>;
+    /**
+     * Close the database connection
+     */
+    close(): Promise<void>;
+    /**
+     * Create database schema
+     */
+    private createSchema;
+    /**
+     * Save a log entry
+     * @param entry - Log entry to save
+     */
+    saveLog(entry: LogEntry): Promise<void>;
+    /**
+     * Save multiple log entries in a transaction
+     * @param entries - Log entries to save
+     */
+    saveLogs(entries: LogEntry[]): Promise<void>;
+    /**
+     * Get log entries matching filter
+     * @param filter - Query filter
+     * @returns Matching log entries
+     */
+    getLogs(filter?: LogFilter): Promise<LogEntry[]>;
+    /**
+     * Delete log entries matching filter
+     * @param filter - Query filter
+     * @returns Number of deleted entries
+     */
+    deleteLogs(filter?: LogFilter): Promise<number>;
+    /**
+     * Count log entries matching filter
+     * @param filter - Query filter
+     * @returns Count of matching entries
+     */
+    countLogs(filter?: LogFilter): Promise<number>;
+    /**
+     * Enforce maximum log limit by deleting oldest entries
+     */
+    private enforceLogLimit;
+    /**
+     * Create a new session
+     * @param session - Session to create
+     */
+    createSession(session: Session): Promise<void>;
+    /**
+     * Update an existing session
+     * @param sessionId - Session ID
+     * @param updates - Partial session data
+     */
+    updateSession(sessionId: string, updates: Partial<Session>): Promise<void>;
+    /**
+     * Get a session by ID
+     * @param sessionId - Session ID
+     * @returns Session or null
+     */
+    getSession(sessionId: string): Promise<Session | null>;
+    /**
+     * Get sessions matching filter
+     * @param filter - Query filter
+     * @returns Matching sessions
+     */
+    getSessions(filter?: SessionFilter): Promise<Session[]>;
+    /**
+     * Delete a session and its logs
+     * @param sessionId - Session ID
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Enforce maximum session limit
+     */
+    private enforceSessionLimit;
+    /**
+     * Clean up old data
+     * @param olderThan - Delete entries older than this date
+     * @returns Number of deleted entries
+     */
+    cleanup(olderThan: Date): Promise<number>;
+    /**
+     * Get storage statistics
+     * @returns Storage stats
+     */
+    getStats(): Promise<StoreStats>;
+    /**
+     * Build WHERE clause from filter
+     */
+    private buildWhereClause;
+    /**
+     * Build complete SELECT query from filter
+     */
+    private buildLogQuery;
+    /**
+     * Convert SQLite row to LogEntry
+     */
+    private rowToLogEntry;
+    /**
+     * Convert SQLite row to Session
+     */
+    private rowToSession;
+    /**
+     * Execute raw SQL query
+     * @param sql - SQL query
+     * @param params - Query parameters
+     * @returns Query results
+     */
+    query<T>(sql: string, ...params: unknown[]): T[];
+    /**
+     * Execute raw SQL statement
+     * @param sql - SQL statement
+     * @param params - Statement parameters
+     * @returns Run result
+     */
+    execute(sql: string, ...params: unknown[]): Database.RunResult;
+    /**
+     * Run VACUUM to optimize database
+     */
+    vacuum(): void;
+    /**
+     * Get the underlying better-sqlite3 database instance
+     * @returns Database instance or null
+     */
+    getDatabase(): DatabaseType | null;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/stores/sqlite.d.ts.map

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