@nanocollective/nanocoder 1.17.3 → 1.19.0

package/dist/utils/logging/log-query.d.ts

@@ -0,0 +1,275 @@
+/**
+ * Log query interface for searching and analyzing log data
+ * Provides powerful filtering, searching, and analytics capabilities
+ */
+/**
+ * Log entry structure for querying
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: string;
+    message: string;
+    correlationId?: string;
+    source?: string;
+    requestId?: string;
+    userId?: string;
+    sessionId?: string;
+    tags?: string[];
+    metadata?: Record<string, any>;
+    error?: {
+        name?: string;
+        message?: string;
+        stack?: string;
+        type?: string;
+    };
+    performance?: {
+        duration?: number;
+        memory?: Record<string, any>;
+        cpu?: number;
+    };
+    request?: {
+        method?: string;
+        url?: string;
+        statusCode?: number;
+        duration?: number;
+        size?: number;
+    };
+}
+/**
+ * Query filters for log searching
+ */
+export interface LogQuery {
+    startTime?: Date;
+    endTime?: Date;
+    levels?: string[];
+    excludeLevels?: string[];
+    messageContains?: string;
+    messageRegex?: RegExp;
+    messageStartsWith?: string;
+    messageEndsWith?: string;
+    correlationIds?: string[];
+    requestIds?: string[];
+    userIds?: string[];
+    sessionIds?: string[];
+    sources?: string[];
+    excludeSources?: string[];
+    tags?: string[];
+    excludeTags?: string[];
+    hasTags?: boolean;
+    metadataKey?: string;
+    metadataValue?: any;
+    metadataExists?: string;
+    durationMin?: number;
+    durationMax?: number;
+    memoryThreshold?: number;
+    hasErrors?: boolean;
+    errorTypes?: string[];
+    requestMethods?: string[];
+    requestStatusCodes?: number[];
+    requestDurationMin?: number;
+    requestDurationMax?: number;
+    limit?: number;
+    offset?: number;
+    sortBy?: 'timestamp' | 'level' | 'duration' | 'memory';
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Query result with metadata
+ */
+export interface QueryResult {
+    entries: LogEntry[];
+    totalCount: number;
+    filteredCount: number;
+    queryTime: number;
+    hasMore: boolean;
+    facets?: {
+        levels: Record<string, number>;
+        sources: Record<string, number>;
+        tags: Record<string, number>;
+        errorTypes: Record<string, number>;
+        hours: Record<string, number>;
+    };
+}
+/**
+ * Log aggregation options
+ */
+export interface AggregationOptions {
+    groupBy: 'hour' | 'day' | 'level' | 'source' | 'correlationId' | 'errorType';
+    aggregations: ('count' | 'avgDuration' | 'maxDuration' | 'minDuration' | 'sumDuration' | 'errorRate' | 'memoryUsage')[];
+    timeRange?: {
+        startTime: Date;
+        endTime: Date;
+    };
+}
+/**
+ * Log aggregation result
+ */
+export interface AggregationResult {
+    groups: Record<string, {
+        count: number;
+        avgDuration?: number;
+        maxDuration?: number;
+        minDuration?: number;
+        sumDuration?: number;
+        errorRate?: number;
+        memoryUsage?: {
+            avgHeapUsed: number;
+            maxHeapUsed: number;
+            minHeapUsed: number;
+        };
+        samples?: LogEntry[];
+    }>;
+    totalGroups: number;
+    queryTime: number;
+}
+/**
+ * In-memory log storage for querying (in production, this would connect to a log database)
+ */
+declare class LogStorage {
+    private entries;
+    private head;
+    private tail;
+    private count;
+    private maxEntries;
+    private indexes;
+    constructor(maxEntries?: number);
+    /**
+     * Add a log entry - O(1) instead of O(n)
+     */
+    addEntry(entry: LogEntry): void;
+    /**
+     * Get all entries as array (oldest to newest)
+     */
+    private getEntriesArray;
+    /**
+     * Query log entries
+     */
+    query(query: LogQuery): QueryResult;
+    /**
+     * Aggregate log entries
+     */
+    aggregate(options: AggregationOptions): AggregationResult;
+    /**
+     * Get entry count
+     */
+    getEntryCount(): number;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    private matchesQuery;
+    private getSortValue;
+    private getLevelPriority;
+    private getGroupKey;
+    private generateFacets;
+    private updateIndexes;
+}
+/**
+ * Global log storage instance
+ */
+export declare const globalLogStorage: LogStorage;
+/**
+ * Log query builder for fluent query construction
+ */
+export declare class LogQueryBuilder {
+    private query;
+    /**
+     * Set time range
+     */
+    timeRange(startTime: Date, endTime: Date): this;
+    /**
+     * Set log levels
+     */
+    levels(...levels: string[]): this;
+    /**
+     * Exclude log levels
+     */
+    excludeLevels(...levels: string[]): this;
+    /**
+     * Filter by message content
+     */
+    messageContains(text: string): this;
+    /**
+     * Filter by message regex
+     */
+    messageRegex(regex: RegExp): this;
+    /**
+     * Filter by correlation IDs
+     */
+    correlationIds(...ids: string[]): this;
+    /**
+     * Filter by sources
+     */
+    sources(...sources: string[]): this;
+    /**
+     * Filter by tags
+     */
+    tags(...tags: string[]): this;
+    /**
+     * Require tags
+     */
+    hasTags(): this;
+    /**
+     * Set pagination
+     */
+    limit(limit: number): this;
+    /**
+     * Set offset
+     */
+    offset(offset: number): this;
+    /**
+     * Set sorting
+     */
+    sortBy(field: 'timestamp' | 'level' | 'duration' | 'memory', order?: 'asc' | 'desc'): this;
+    /**
+     * Filter by minimum performance duration
+     */
+    durationMin(min: number): this;
+    /**
+     * Filter by memory usage threshold
+     */
+    memoryThreshold(threshold: number): this;
+    /**
+     * Execute the query
+     */
+    execute(): QueryResult;
+    /**
+     * Get query as JSON
+     */
+    toJSON(): LogQuery;
+}
+/**
+ * Create a new log query builder
+ */
+export declare function createLogQuery(): LogQueryBuilder;
+/**
+ * Quick query functions for common use cases
+ */
+export declare const logQueries: {
+    /**
+     * Get all error logs
+     */
+    errors: (limit?: number) => QueryResult;
+    /**
+     * Get logs by correlation ID
+     */
+    byCorrelation: (correlationId: string, limit?: number) => QueryResult;
+    /**
+     * Get logs by source
+     */
+    bySource: (source: string, limit?: number) => QueryResult;
+    /**
+     * Get logs with specific tag
+     */
+    byTag: (tag: string, limit?: number) => QueryResult;
+    /**
+     * Get slow requests
+     */
+    slowRequests: (minDuration?: number, limit?: number) => QueryResult;
+    /**
+     * Get memory-intensive operations
+     */
+    memoryIntensive: (minMemory?: number, limit?: number) => QueryResult;
+};
+export default LogStorage;
+//# sourceMappingURL=log-query.d.ts.map

package/dist/utils/logging/log-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-query.d.ts","sourceRoot":"","sources":["../../../source/utils/logging/log-query.ts"],"names":[],"mappings":"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"}