@johnboxcodes/boxlogger 0.1.0

package/dist/stores/base.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Base Store Provider
+ *
+ * Abstract base class providing common utilities for store implementations.
+ *
+ * @module stores/base
+ * @packageDocumentation
+ */
+import type { StoreProvider, StoreProviderConfig, LogEntry, Session, LogFilter, SessionFilter, StoreStats } from '../types.js';
+/**
+ * Default configuration values for store providers
+ */
+export declare const DEFAULT_STORE_CONFIG: Required<StoreProviderConfig>;
+/**
+ * Abstract base class for store providers
+ *
+ * @remarks
+ * Provides common functionality like ID generation, timestamp handling,
+ * and filtering utilities. Extend this class to create new store providers.
+ *
+ * @example
+ * ```typescript
+ * class MyStoreProvider extends BaseStoreProvider {
+ *   readonly name = 'mystore';
+ *
+ *   async init(): Promise<void> {
+ *     // Initialize your store
+ *     this._ready = true;
+ *   }
+ *   // ... implement other abstract methods
+ * }
+ * ```
+ */
+export declare abstract class BaseStoreProvider implements StoreProvider {
+    abstract readonly name: string;
+    protected _ready: boolean;
+    protected config: Required<StoreProviderConfig>;
+    protected cleanupTimer?: ReturnType<typeof setInterval>;
+    constructor(config?: StoreProviderConfig);
+    /**
+     * Check if the provider is ready for operations
+     */
+    isReady(): boolean;
+    /**
+     * Start automatic cleanup if configured
+     */
+    protected startCleanupTimer(): void;
+    /**
+     * Stop automatic cleanup
+     */
+    protected stopCleanupTimer(): void;
+    abstract init(): Promise<void>;
+    abstract close(): Promise<void>;
+    abstract saveLog(entry: LogEntry): Promise<void>;
+    abstract getLogs(filter?: LogFilter): Promise<LogEntry[]>;
+    abstract deleteLogs(filter?: LogFilter): Promise<number>;
+    abstract countLogs(filter?: LogFilter): Promise<number>;
+    abstract createSession(session: Session): Promise<void>;
+    abstract updateSession(sessionId: string, updates: Partial<Session>): Promise<void>;
+    abstract getSession(sessionId: string): Promise<Session | null>;
+    abstract getSessions(filter?: SessionFilter): Promise<Session[]>;
+    abstract deleteSession(sessionId: string): Promise<void>;
+    abstract cleanup(olderThan: Date): Promise<number>;
+    abstract getStats(): Promise<StoreStats>;
+    /**
+     * Generate a UUID v4
+     * @returns UUID string
+     */
+    protected generateId(): string;
+    /**
+     * Generate a short hex ID
+     * @param length - ID length (default 16)
+     * @returns Hex string ID
+     */
+    protected generateShortId(length?: number): string;
+    /**
+     * Get current ISO 8601 timestamp
+     * @returns ISO timestamp string
+     */
+    protected now(): string;
+    /**
+     * Parse a timestamp to Date
+     * @param timestamp - ISO string or Date
+     * @returns Date object
+     */
+    protected parseTimestamp(timestamp: string | Date): Date;
+    /**
+     * Calculate duration between timestamps in milliseconds
+     * @param start - Start timestamp
+     * @param end - End timestamp
+     * @returns Duration in ms
+     */
+    protected calculateDuration(start: string | Date, end: string | Date): number;
+    /**
+     * Filter log entries in memory
+     * @param logs - Log entries to filter
+     * @param filter - Filter criteria
+     * @returns Filtered entries
+     */
+    protected filterLogs(logs: LogEntry[], filter: LogFilter): LogEntry[];
+    /**
+     * Sort log entries
+     * @param logs - Logs to sort
+     * @param orderBy - Sort field
+     * @param direction - Sort direction
+     * @returns Sorted logs
+     */
+    private sortLogs;
+    /**
+     * Filter sessions in memory
+     * @param sessions - Sessions to filter
+     * @param filter - Filter criteria
+     * @returns Filtered sessions
+     */
+    protected filterSessions(sessions: Session[], filter: SessionFilter): Session[];
+    /**
+     * Deep clone an object
+     * @param obj - Object to clone
+     * @returns Cloned object
+     */
+    protected clone<T>(obj: T): T;
+    /**
+     * Ensure the store is ready, throw if not
+     */
+    protected ensureReady(): void;
+}
+//# sourceMappingURL=base.d.ts.map

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

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

package/dist/stores/base.js

@@ -0,0 +1,288 @@
+/**
+ * Base Store Provider
+ *
+ * Abstract base class providing common utilities for store implementations.
+ *
+ * @module stores/base
+ * @packageDocumentation
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Default configuration values for store providers
+ */
+export const DEFAULT_STORE_CONFIG = {
+    maxLogs: 100000,
+    maxSessions: 10000,
+    cleanupInterval: 0,
+    retentionPeriod: 30 * 24 * 60 * 60 * 1000, // 30 days
+};
+/**
+ * Log level numeric values for comparison
+ */
+const LEVEL_VALUES = {
+    fatal: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+    trace: 5,
+};
+/**
+ * Abstract base class for store providers
+ *
+ * @remarks
+ * Provides common functionality like ID generation, timestamp handling,
+ * and filtering utilities. Extend this class to create new store providers.
+ *
+ * @example
+ * ```typescript
+ * class MyStoreProvider extends BaseStoreProvider {
+ *   readonly name = 'mystore';
+ *
+ *   async init(): Promise<void> {
+ *     // Initialize your store
+ *     this._ready = true;
+ *   }
+ *   // ... implement other abstract methods
+ * }
+ * ```
+ */
+export class BaseStoreProvider {
+    _ready = false;
+    config;
+    cleanupTimer;
+    constructor(config) {
+        this.config = { ...DEFAULT_STORE_CONFIG, ...config };
+    }
+    /**
+     * Check if the provider is ready for operations
+     */
+    isReady() {
+        return this._ready;
+    }
+    /**
+     * Start automatic cleanup if configured
+     */
+    startCleanupTimer() {
+        if (this.config.cleanupInterval > 0) {
+            this.cleanupTimer = setInterval(async () => {
+                const cutoff = new Date(Date.now() - this.config.retentionPeriod);
+                await this.cleanup(cutoff);
+            }, this.config.cleanupInterval);
+            // Don't keep the process alive just for cleanup
+            if (this.cleanupTimer.unref) {
+                this.cleanupTimer.unref();
+            }
+        }
+    }
+    /**
+     * Stop automatic cleanup
+     */
+    stopCleanupTimer() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+    }
+    // =========================================================================
+    // ID Generation Utilities
+    // =========================================================================
+    /**
+     * Generate a UUID v4
+     * @returns UUID string
+     */
+    generateId() {
+        return randomUUID();
+    }
+    /**
+     * Generate a short hex ID
+     * @param length - ID length (default 16)
+     * @returns Hex string ID
+     */
+    generateShortId(length = 16) {
+        const bytes = new Uint8Array(Math.ceil(length / 2));
+        crypto.getRandomValues(bytes);
+        return Array.from(bytes)
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('')
+            .slice(0, length);
+    }
+    // =========================================================================
+    // Timestamp Utilities
+    // =========================================================================
+    /**
+     * Get current ISO 8601 timestamp
+     * @returns ISO timestamp string
+     */
+    now() {
+        return new Date().toISOString();
+    }
+    /**
+     * Parse a timestamp to Date
+     * @param timestamp - ISO string or Date
+     * @returns Date object
+     */
+    parseTimestamp(timestamp) {
+        return timestamp instanceof Date ? timestamp : new Date(timestamp);
+    }
+    /**
+     * Calculate duration between timestamps in milliseconds
+     * @param start - Start timestamp
+     * @param end - End timestamp
+     * @returns Duration in ms
+     */
+    calculateDuration(start, end) {
+        return this.parseTimestamp(end).getTime() - this.parseTimestamp(start).getTime();
+    }
+    // =========================================================================
+    // Filtering Utilities (for in-memory filtering)
+    // =========================================================================
+    /**
+     * Filter log entries in memory
+     * @param logs - Log entries to filter
+     * @param filter - Filter criteria
+     * @returns Filtered entries
+     */
+    filterLogs(logs, filter) {
+        let result = [...logs];
+        // Filter by level
+        if (filter.level) {
+            const levels = Array.isArray(filter.level) ? filter.level : [filter.level];
+            result = result.filter((log) => levels.includes(log.level));
+        }
+        // Filter by session
+        if (filter.sessionId) {
+            result = result.filter((log) => log.sessionId === filter.sessionId);
+        }
+        // Filter by logger name
+        if (filter.logger) {
+            result = result.filter((log) => log.logger === filter.logger);
+        }
+        // Filter by time range
+        if (filter.startTime) {
+            const start = this.parseTimestamp(filter.startTime);
+            result = result.filter((log) => this.parseTimestamp(log.timestamp) >= start);
+        }
+        if (filter.endTime) {
+            const end = this.parseTimestamp(filter.endTime);
+            result = result.filter((log) => this.parseTimestamp(log.timestamp) <= end);
+        }
+        // Filter by search text
+        if (filter.search) {
+            const searchLower = filter.search.toLowerCase();
+            result = result.filter((log) => log.message.toLowerCase().includes(searchLower) ||
+                log.metadata?.error?.message?.toLowerCase().includes(searchLower));
+        }
+        // Filter by tags
+        if (filter.tags && Object.keys(filter.tags).length > 0) {
+            result = result.filter((log) => {
+                if (!log.metadata?.tags)
+                    return false;
+                return Object.entries(filter.tags).every(([key, value]) => log.metadata?.tags?.[key] === value);
+            });
+        }
+        // Filter by trace ID
+        if (filter.traceId) {
+            result = result.filter((log) => log.metadata?.traceId === filter.traceId);
+        }
+        // Filter by service
+        if (filter.service) {
+            result = result.filter((log) => log.service === filter.service);
+        }
+        // Filter by environment
+        if (filter.environment) {
+            result = result.filter((log) => log.environment === filter.environment);
+        }
+        // Sort
+        const orderBy = filter.orderBy || 'timestamp';
+        const direction = filter.orderDirection || 'desc';
+        result = this.sortLogs(result, orderBy, direction);
+        // Pagination
+        if (filter.offset) {
+            result = result.slice(filter.offset);
+        }
+        if (filter.limit) {
+            result = result.slice(0, filter.limit);
+        }
+        return result;
+    }
+    /**
+     * Sort log entries
+     * @param logs - Logs to sort
+     * @param orderBy - Sort field
+     * @param direction - Sort direction
+     * @returns Sorted logs
+     */
+    sortLogs(logs, orderBy, direction) {
+        return logs.sort((a, b) => {
+            let comparison;
+            if (orderBy === 'level') {
+                comparison = LEVEL_VALUES[a.level] - LEVEL_VALUES[b.level];
+            }
+            else {
+                comparison =
+                    this.parseTimestamp(a.timestamp).getTime() -
+                        this.parseTimestamp(b.timestamp).getTime();
+            }
+            return direction === 'desc' ? -comparison : comparison;
+        });
+    }
+    /**
+     * Filter sessions in memory
+     * @param sessions - Sessions to filter
+     * @param filter - Filter criteria
+     * @returns Filtered sessions
+     */
+    filterSessions(sessions, filter) {
+        let result = [...sessions];
+        // Filter by status
+        if (filter.status) {
+            const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+            result = result.filter((s) => statuses.includes(s.status));
+        }
+        // Filter by user ID
+        if (filter.userId !== undefined) {
+            result = result.filter((s) => s.user?.id === filter.userId);
+        }
+        // Filter by time range
+        if (filter.startTime) {
+            const start = this.parseTimestamp(filter.startTime);
+            result = result.filter((s) => this.parseTimestamp(s.startedAt) >= start);
+        }
+        if (filter.endTime) {
+            const end = this.parseTimestamp(filter.endTime);
+            result = result.filter((s) => this.parseTimestamp(s.startedAt) <= end);
+        }
+        // Sort by startedAt descending
+        result.sort((a, b) => this.parseTimestamp(b.startedAt).getTime() -
+            this.parseTimestamp(a.startedAt).getTime());
+        // Pagination
+        if (filter.offset) {
+            result = result.slice(filter.offset);
+        }
+        if (filter.limit) {
+            result = result.slice(0, filter.limit);
+        }
+        return result;
+    }
+    // =========================================================================
+    // Utility Methods
+    // =========================================================================
+    /**
+     * Deep clone an object
+     * @param obj - Object to clone
+     * @returns Cloned object
+     */
+    clone(obj) {
+        return JSON.parse(JSON.stringify(obj));
+    }
+    /**
+     * Ensure the store is ready, throw if not
+     */
+    ensureReady() {
+        if (!this._ready) {
+            throw new Error(`${this.name} store is not initialized. Call init() first.`);
+        }
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/stores/base.js.map

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

package/dist/stores/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Store Providers
+ *
+ * Export all available store provider implementations.
+ *
+ * @module stores
+ * @packageDocumentation
+ */
+export { BaseStoreProvider, DEFAULT_STORE_CONFIG } from './base.js';
+export { MemoryStoreProvider, type MemoryStoreConfig } from './memory.js';
+export { SQLiteStoreProvider, type SQLiteStoreConfig } from './sqlite.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/stores/index.js

@@ -0,0 +1,12 @@
+/**
+ * Store Providers
+ *
+ * Export all available store provider implementations.
+ *
+ * @module stores
+ * @packageDocumentation
+ */
+export { BaseStoreProvider, DEFAULT_STORE_CONFIG } from './base.js';
+export { MemoryStoreProvider } from './memory.js';
+export { SQLiteStoreProvider } from './sqlite.js';
+//# sourceMappingURL=index.js.map

package/dist/stores/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAA0B,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAA0B,MAAM,aAAa,CAAC"}

package/dist/stores/memory.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Memory Store Provider
+ *
+ * In-memory storage implementation for development, testing, or ephemeral logging.
+ *
+ * @module stores/memory
+ * @packageDocumentation
+ */
+import { BaseStoreProvider } from './base.js';
+import type { StoreProviderConfig, LogEntry, Session, LogFilter, SessionFilter, StoreStats } from '../types.js';
+/**
+ * Configuration options for the memory store
+ */
+export interface MemoryStoreConfig extends StoreProviderConfig {
+    /** Maximum log entries to retain (default: 10000) */
+    maxLogs?: number;
+    /** Maximum sessions to retain (default: 1000) */
+    maxSessions?: number;
+}
+/**
+ * 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 declare class MemoryStoreProvider extends BaseStoreProvider {
+    readonly name = "memory";
+    private logs;
+    private sessions;
+    constructor(config?: MemoryStoreConfig);
+    /**
+     * Initialize the memory store
+     */
+    init(): Promise<void>;
+    /**
+     * Close the memory store and clear all data
+     */
+    close(): Promise<void>;
+    /**
+     * Save a log entry to memory
+     * @param entry - Log entry to save
+     */
+    saveLog(entry: 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>;
+    /**
+     * 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 associated logs
+     * @param sessionId - Session ID
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * 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>;
+    /**
+     * Clear all data from the store
+     */
+    clear(): Promise<void>;
+    /**
+     * Get raw storage arrays (for debugging)
+     * @returns Internal storage references
+     */
+    getRawData(): {
+        logs: LogEntry[];
+        sessions: Map<string, Session>;
+    };
+}
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/stores/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACR,OAAO,EACP,SAAS,EACT,aAAa,EACb,UAAU,EAEX,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAmC;gBAEvC,MAAM,CAAC,EAAE,iBAAiB;IAQtC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7C;;;;OAIG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUtD;;;;OAIG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAerD;;;;OAIG;IACG,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAcpD;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BpD;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAehF;;;;OAIG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAO5D;;;;OAIG;IACG,WAAW,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkB7D;;;OAGG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD;;;;OAIG;IACG,OAAO,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IA4B/C;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IA4CrC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;OAGG;IACH,UAAU,IAAI;QAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;CAMnE"}