nestlens 0.1.0

package/dist/api/tag.controller.js

@@ -0,0 +1,149 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TagController = void 0;
+const common_1 = require("@nestjs/common");
+const tag_service_1 = require("../core/tag.service");
+const nestlens_config_1 = require("../nestlens.config");
+const api_guard_1 = require("./api.guard");
+let TagController = class TagController {
+    constructor(tagService) {
+        this.tagService = tagService;
+    }
+    /**
+     * Get all tags with their counts
+     */
+    async getAllTags() {
+        const tags = await this.tagService.getAllTags();
+        return { data: tags };
+    }
+    /**
+     * Get entries by tag(s)
+     */
+    async getEntriesByTags(tagsParam, logic, limit) {
+        const tags = tagsParam.split(',').map(t => t.trim()).filter(Boolean);
+        const entries = await this.tagService.findByTags(tags, logic || 'OR', limit ? parseInt(limit, 10) : 50);
+        return { data: entries };
+    }
+    /**
+     * Get tags for a specific entry
+     */
+    async getEntryTags(id) {
+        const tags = await this.tagService.getEntryTags(id);
+        return { data: tags };
+    }
+    /**
+     * Add tags to an entry
+     */
+    async addTagsToEntry(id, body) {
+        await this.tagService.addTags(id, body.tags);
+        const tags = await this.tagService.getEntryTags(id);
+        return { success: true, data: tags };
+    }
+    /**
+     * Remove tags from an entry
+     */
+    async removeTagsFromEntry(id, body) {
+        await this.tagService.removeTags(id, body.tags);
+        const tags = await this.tagService.getEntryTags(id);
+        return { success: true, data: tags };
+    }
+    // ==================== Monitored Tags ====================
+    /**
+     * Get all monitored tags
+     */
+    async getMonitoredTags() {
+        const tags = await this.tagService.getMonitoredTagsWithCounts();
+        return { data: tags };
+    }
+    /**
+     * Add a monitored tag
+     */
+    async addMonitoredTag(body) {
+        const tag = await this.tagService.addMonitoredTag(body.tag);
+        return { success: true, data: tag };
+    }
+    /**
+     * Remove a monitored tag
+     */
+    async removeMonitoredTag(tag) {
+        await this.tagService.removeMonitoredTag(tag);
+        return { success: true };
+    }
+};
+exports.TagController = TagController;
+__decorate([
+    (0, common_1.Get)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], TagController.prototype, "getAllTags", null);
+__decorate([
+    (0, common_1.Get)('entries'),
+    __param(0, (0, common_1.Query)('tags')),
+    __param(1, (0, common_1.Query)('logic')),
+    __param(2, (0, common_1.Query)('limit')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", Promise)
+], TagController.prototype, "getEntriesByTags", null);
+__decorate([
+    (0, common_1.Get)('entry/:id'),
+    __param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Number]),
+    __metadata("design:returntype", Promise)
+], TagController.prototype, "getEntryTags", null);
+__decorate([
+    (0, common_1.Post)('entry/:id'),
+    __param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Number, Object]),
+    __metadata("design:returntype", Promise)
+], TagController.prototype, "addTagsToEntry", null);
+__decorate([
+    (0, common_1.Delete)('entry/:id'),
+    __param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Number, Object]),
+    __metadata("design:returntype", Promise)
+], TagController.prototype, "removeTagsFromEntry", null);
+__decorate([
+    (0, common_1.Get)('monitored'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], TagController.prototype, "getMonitoredTags", null);
+__decorate([
+    (0, common_1.Post)('monitored'),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], TagController.prototype, "addMonitoredTag", null);
+__decorate([
+    (0, common_1.Delete)('monitored/:tag'),
+    __param(0, (0, common_1.Param)('tag')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], TagController.prototype, "removeMonitoredTag", null);
+exports.TagController = TagController = __decorate([
+    (0, common_1.Controller)(`${nestlens_config_1.NESTLENS_API_PREFIX}/api/tags`),
+    (0, common_1.UseGuards)(api_guard_1.NestLensGuard),
+    __metadata("design:paramtypes", [tag_service_1.TagService])
+], TagController);
+//# sourceMappingURL=tag.controller.js.map

package/dist/api/tag.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.controller.js","sourceRoot":"","sources":["../../src/api/tag.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAUwB;AACxB,qDAAiD;AACjD,wDAAyD;AACzD,2CAA4C;AAIrC,IAAM,aAAa,GAAnB,MAAM,aAAa;IACxB,YAA6B,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAEvD;;OAEG;IAEG,AAAN,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IAEG,AAAN,KAAK,CAAC,gBAAgB,CACL,SAAiB,EAChB,KAAoB,EACpB,KAAc;QAE9B,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAC9C,IAAI,EACJ,KAAK,IAAI,IAAI,EACb,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CACjC,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IAEG,AAAN,KAAK,CAAC,YAAY,CAA4B,EAAU;QACtD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IAEG,AAAN,KAAK,CAAC,cAAc,CACS,EAAU,EAC7B,IAAwB;QAEhC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED;;OAEG;IAEG,AAAN,KAAK,CAAC,mBAAmB,CACI,EAAU,EAC7B,IAAwB;QAEhC,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,2DAA2D;IAE3D;;OAEG;IAEG,AAAN,KAAK,CAAC,gBAAgB;QACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,0BAA0B,EAAE,CAAC;QAChE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IAEG,AAAN,KAAK,CAAC,eAAe,CAAS,IAAqB;QACjD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACtC,CAAC;IAED;;OAEG;IAEG,AAAN,KAAK,CAAC,kBAAkB,CAAe,GAAW;QAChD,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF,CAAA;AA7FY,sCAAa;AAOlB;IADL,IAAA,YAAG,GAAE;;;;+CAIL;AAMK;IADL,IAAA,YAAG,EAAC,SAAS,CAAC;IAEZ,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IACb,WAAA,IAAA,cAAK,EAAC,OAAO,CAAC,CAAA;IACd,WAAA,IAAA,cAAK,EAAC,OAAO,CAAC,CAAA;;;;qDAShB;AAMK;IADL,IAAA,YAAG,EAAC,WAAW,CAAC;IACG,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;;;;iDAG5C;AAMK;IADL,IAAA,aAAI,EAAC,WAAW,CAAC;IAEf,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;IACzB,WAAA,IAAA,aAAI,GAAE,CAAA;;;;mDAKR;AAMK;IADL,IAAA,eAAM,EAAC,WAAW,CAAC;IAEjB,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;IACzB,WAAA,IAAA,aAAI,GAAE,CAAA;;;;wDAKR;AAQK;IADL,IAAA,YAAG,EAAC,WAAW,CAAC;;;;qDAIhB;AAMK;IADL,IAAA,aAAI,EAAC,WAAW,CAAC;IACK,WAAA,IAAA,aAAI,GAAE,CAAA;;;;oDAG5B;AAMK;IADL,IAAA,eAAM,EAAC,gBAAgB,CAAC;IACC,WAAA,IAAA,cAAK,EAAC,KAAK,CAAC,CAAA;;;;uDAGrC;wBA5FU,aAAa;IAFzB,IAAA,mBAAU,EAAC,GAAG,qCAAmB,WAAW,CAAC;IAC7C,IAAA,kBAAS,EAAC,yBAAa,CAAC;qCAEkB,wBAAU;GADxC,aAAa,CA6FzB"}

package/dist/core/collector.service.d.ts

@@ -0,0 +1,80 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import { Entry, EntryType } from '../types';
+import { StorageInterface } from './storage/storage.interface';
+import { TagService } from './tag.service';
+import { FamilyHashService } from './family-hash.service';
+import { NestLensConfig } from '../nestlens.config';
+export declare class CollectorService implements OnModuleDestroy {
+    private readonly storage;
+    private readonly config;
+    private readonly tagService?;
+    private readonly familyHashService?;
+    private readonly logger;
+    private buffer;
+    private flushTimer;
+    private readonly BUFFER_SIZE;
+    private readonly FLUSH_INTERVAL;
+    private isPaused;
+    private pausedAt?;
+    private pauseReason?;
+    constructor(storage: StorageInterface, config: NestLensConfig, tagService?: TagService | undefined, familyHashService?: FamilyHashService | undefined);
+    /**
+     * Apply filter to an entry
+     */
+    private applyFilter;
+    /**
+     * Pause recording
+     */
+    pause(reason?: string): void;
+    /**
+     * Resume recording
+     */
+    resume(): void;
+    /**
+     * Get recording status
+     */
+    getRecordingStatus(): {
+        isPaused: boolean;
+        pausedAt?: Date;
+        pauseReason?: string;
+    };
+    /**
+     * Collect an entry
+     * Uses discriminated union pattern - the type parameter determines the expected payload type
+     */
+    collect<T extends EntryType>(type: T, payload: Extract<Entry, {
+        type: T;
+    }>['payload'], requestId?: string): Promise<void>;
+    /**
+     * Collect and save immediately (for critical entries like exceptions)
+     * Uses discriminated union pattern - the type parameter determines the expected payload type
+     */
+    collectImmediate<T extends EntryType>(type: T, payload: Extract<Entry, {
+        type: T;
+    }>['payload'], requestId?: string): Promise<Entry | null>;
+    /**
+     * Apply auto-tagging and family hash to a saved entry
+     */
+    private applyAutoTagging;
+    /**
+     * Save entries with retry logic
+     */
+    private saveWithRetry;
+    /**
+     * Flush buffer to storage
+     */
+    flush(): Promise<void>;
+    /**
+     * Start periodic flush timer
+     */
+    private startFlushTimer;
+    /**
+     * Stop flush timer and flush remaining entries
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Lifecycle hook - cleanup on module destroy
+     */
+    onModuleDestroy(): Promise<void>;
+}
+//# sourceMappingURL=collector.service.d.ts.map

package/dist/core/collector.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.service.d.ts","sourceRoot":"","sources":["../../src/core/collector.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,eAAe,EAAY,MAAM,gBAAgB,CAAC;AACvF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAW,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAmB,MAAM,oBAAoB,CAAC;AAErE,qBACa,gBAAiB,YAAW,eAAe;IAYpD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAjBrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAO;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAO;IACxB,OAAO,CAAC,WAAW,CAAC,CAAS;gBAIV,OAAO,EAAE,gBAAgB,EAEzB,MAAM,EAAE,cAAc,EAEtB,UAAU,CAAC,EAAE,UAAU,YAAA,EAEvB,iBAAiB,CAAC,EAAE,iBAAiB,YAAA;IAKxD;;OAEG;YACW,WAAW;IAWzB;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAS5B;;OAEG;IACH,MAAM,IAAI,IAAI;IASd;;OAEG;IACH,kBAAkB,IAAI;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAQlF;;;OAGG;IACG,OAAO,CAAC,CAAC,SAAS,SAAS,EAC/B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,SAAS,CAAC,EAC/C,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IA2BhB;;;OAGG;IACG,gBAAgB,CAAC,CAAC,SAAS,SAAS,EACxC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,SAAS,CAAC,EAC/C,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAgCxB;;OAEG;YACW,gBAAgB;IAuB9B;;OAEG;YACW,aAAa;IAiB3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC"}

package/dist/core/collector.service.js

@@ -0,0 +1,255 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var CollectorService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectorService = void 0;
+const common_1 = require("@nestjs/common");
+const storage_interface_1 = require("./storage/storage.interface");
+const tag_service_1 = require("./tag.service");
+const family_hash_service_1 = require("./family-hash.service");
+const nestlens_config_1 = require("../nestlens.config");
+let CollectorService = CollectorService_1 = class CollectorService {
+    constructor(storage, config, tagService, familyHashService) {
+        this.storage = storage;
+        this.config = config;
+        this.tagService = tagService;
+        this.familyHashService = familyHashService;
+        this.logger = new common_1.Logger(CollectorService_1.name);
+        this.buffer = [];
+        this.flushTimer = null;
+        this.BUFFER_SIZE = 100;
+        this.FLUSH_INTERVAL = 1000; // 1 second
+        this.isPaused = false;
+        this.startFlushTimer();
+    }
+    /**
+     * Apply filter to an entry
+     */
+    async applyFilter(entry) {
+        if (!this.config.filter)
+            return true;
+        try {
+            const result = this.config.filter(entry);
+            return result instanceof Promise ? await result : result;
+        }
+        catch (error) {
+            this.logger.warn(`Filter callback error: ${error}`);
+            return true; // Fail-open - don't block collection on filter errors
+        }
+    }
+    /**
+     * Pause recording
+     */
+    pause(reason) {
+        if (!this.isPaused) {
+            this.isPaused = true;
+            this.pausedAt = new Date();
+            this.pauseReason = reason;
+            this.logger.log(`Recording paused${reason ? `: ${reason}` : ''}`);
+        }
+    }
+    /**
+     * Resume recording
+     */
+    resume() {
+        if (this.isPaused) {
+            this.isPaused = false;
+            this.pausedAt = undefined;
+            this.pauseReason = undefined;
+            this.logger.log('Recording resumed');
+        }
+    }
+    /**
+     * Get recording status
+     */
+    getRecordingStatus() {
+        return {
+            isPaused: this.isPaused,
+            pausedAt: this.pausedAt,
+            pauseReason: this.pauseReason,
+        };
+    }
+    /**
+     * Collect an entry
+     * Uses discriminated union pattern - the type parameter determines the expected payload type
+     */
+    async collect(type, payload, requestId) {
+        // Skip collection if paused
+        if (this.isPaused) {
+            return;
+        }
+        // Entry construction is type-safe: type and payload are correlated via the generic constraint
+        const entry = {
+            type,
+            payload,
+            requestId,
+        };
+        // Apply filter
+        const shouldCollect = await this.applyFilter(entry);
+        if (!shouldCollect) {
+            return;
+        }
+        this.buffer.push(entry);
+        // Flush if buffer is full
+        if (this.buffer.length >= this.BUFFER_SIZE) {
+            await this.flush();
+        }
+    }
+    /**
+     * Collect and save immediately (for critical entries like exceptions)
+     * Uses discriminated union pattern - the type parameter determines the expected payload type
+     */
+    async collectImmediate(type, payload, requestId) {
+        // Skip collection if paused
+        if (this.isPaused) {
+            return null;
+        }
+        // Entry construction is type-safe: type and payload are correlated via the generic constraint
+        const entry = {
+            type,
+            payload,
+            requestId,
+        };
+        // Apply filter
+        const shouldCollect = await this.applyFilter(entry);
+        if (!shouldCollect) {
+            return null;
+        }
+        try {
+            const savedEntry = await this.storage.save(entry);
+            // Apply auto-tagging and family hash after saving
+            await this.applyAutoTagging(savedEntry);
+            return savedEntry;
+        }
+        catch (error) {
+            this.logger.error(`Failed to save entry: ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Apply auto-tagging and family hash to a saved entry
+     */
+    async applyAutoTagging(entry) {
+        if (!entry.id)
+            return;
+        try {
+            // Generate and save family hash
+            if (this.familyHashService) {
+                const familyHash = this.familyHashService.generateFamilyHash(entry);
+                if (familyHash) {
+                    await this.storage.updateFamilyHash(entry.id, familyHash);
+                    entry.familyHash = familyHash;
+                }
+            }
+            // Auto-tag the entry
+            if (this.tagService) {
+                await this.tagService.autoTag(entry);
+            }
+        }
+        catch (error) {
+            // Don't fail the save if tagging fails
+            this.logger.warn(`Failed to apply auto-tagging to entry ${entry.id}: ${error}`);
+        }
+    }
+    /**
+     * Save entries with retry logic
+     */
+    async saveWithRetry(entries, maxRetries = 3) {
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                return await this.storage.saveBatch(entries);
+            }
+            catch (error) {
+                if (attempt === maxRetries) {
+                    this.logger.error(`Failed to save entries after ${maxRetries} attempts`, error);
+                    throw error;
+                }
+                this.logger.warn(`Save attempt ${attempt} failed, retrying...`);
+                await new Promise(r => setTimeout(r, 100 * attempt));
+            }
+        }
+        // This should never be reached, but TypeScript needs it
+        throw new Error('Unreachable code');
+    }
+    /**
+     * Flush buffer to storage
+     */
+    async flush() {
+        if (this.buffer.length === 0)
+            return;
+        let entries = [...this.buffer];
+        this.buffer = [];
+        // Apply batch filter if configured
+        if (this.config.filterBatch) {
+            try {
+                const result = this.config.filterBatch(entries);
+                entries = result instanceof Promise ? await result : result;
+            }
+            catch (error) {
+                this.logger.warn(`Batch filter callback error: ${error}`);
+                // Fail-open - continue with original entries on filter error
+            }
+        }
+        // Skip if all entries were filtered out
+        if (entries.length === 0)
+            return;
+        try {
+            const savedEntries = await this.saveWithRetry(entries);
+            // Optimized: Apply auto-tagging in parallel instead of sequentially
+            await Promise.all(savedEntries.map(entry => this.applyAutoTagging(entry)));
+        }
+        catch (error) {
+            this.logger.error(`Failed to flush entries: ${error}`);
+            // Put entries back in buffer
+            this.buffer = [...entries, ...this.buffer];
+        }
+    }
+    /**
+     * Start periodic flush timer
+     */
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            this.flush().catch((err) => {
+                this.logger.error(`Flush timer error: ${err}`);
+            });
+        }, this.FLUSH_INTERVAL);
+    }
+    /**
+     * Stop flush timer and flush remaining entries
+     */
+    async shutdown() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush();
+    }
+    /**
+     * Lifecycle hook - cleanup on module destroy
+     */
+    async onModuleDestroy() {
+        await this.shutdown();
+    }
+};
+exports.CollectorService = CollectorService;
+exports.CollectorService = CollectorService = CollectorService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(storage_interface_1.STORAGE)),
+    __param(1, (0, common_1.Inject)(nestlens_config_1.NESTLENS_CONFIG)),
+    __param(2, (0, common_1.Optional)()),
+    __param(3, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [Object, Object, tag_service_1.TagService,
+        family_hash_service_1.FamilyHashService])
+], CollectorService);
+//# sourceMappingURL=collector.service.js.map

package/dist/core/collector.service.js.map

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

package/dist/core/family-hash.service.d.ts

@@ -0,0 +1,64 @@
+import { Entry } from '../types';
+/**
+ * Service for generating family hashes to group similar entries
+ *
+ * Family hashes allow grouping similar exceptions, queries, etc.
+ * to identify recurring issues and reduce noise in the dashboard.
+ */
+export declare class FamilyHashService {
+    private readonly logger;
+    /**
+     * Generate a family hash for an entry
+     * Returns undefined if no meaningful hash can be generated
+     */
+    generateFamilyHash(entry: Entry): string | undefined;
+    /**
+     * Hash an exception based on name, file, and line number
+     */
+    private hashException;
+    /**
+     * Hash a query based on normalized SQL
+     */
+    private hashQuery;
+    /**
+     * Hash a log entry based on context and message pattern
+     */
+    private hashLog;
+    /**
+     * Hash a command based on command name and handler
+     */
+    private hashCommand;
+    /**
+     * Hash a gate based on gate name, action, and subject type
+     */
+    private hashGate;
+    /**
+     * Hash a batch operation based on name and operation
+     */
+    private hashBatch;
+    /**
+     * Extract file and line information from stack trace
+     */
+    private extractStackInfo;
+    /**
+     * Normalize file path to remove node_modules and project root
+     */
+    private normalizeFilePath;
+    /**
+     * Normalize SQL query by removing specific values
+     */
+    private normalizeQuery;
+    /**
+     * Normalize error message by removing specific values
+     */
+    private normalizeErrorMessage;
+    /**
+     * Normalize subject by removing IDs and specific values
+     */
+    private normalizeSubject;
+    /**
+     * Create SHA256 hash of input, truncated to 16 characters
+     */
+    private hash;
+}
+//# sourceMappingURL=family-hash.service.d.ts.map

package/dist/core/family-hash.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-hash.service.d.ts","sourceRoot":"","sources":["../../src/core/family-hash.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC;;;;;GAKG;AACH,qBACa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAE7D;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS;IAmBpD;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAejB;;OAEG;IACH,OAAO,CAAC,OAAO;IAoBf;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgBhB;;OAEG;IACH,OAAO,CAAC,SAAS;IAYjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,IAAI;CAOb"}