@quanticjs/metrics 2.0.0

package/dist/MetricsController.d.ts

@@ -0,0 +1,7 @@
+import { Response } from 'express';
+import { MetricsService } from './MetricsService';
+export declare class MetricsController {
+    private readonly metrics;
+    constructor(metrics: MetricsService);
+    getMetrics(res: Response): Promise<void>;
+}

package/dist/MetricsController.js

@@ -0,0 +1,42 @@
+"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.MetricsController = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@quanticjs/core");
+const MetricsService_1 = require("./MetricsService");
+let MetricsController = class MetricsController {
+    metrics;
+    constructor(metrics) {
+        this.metrics = metrics;
+    }
+    async getMetrics(res) {
+        const metricsOutput = await this.metrics.getMetrics();
+        res.set('Content-Type', this.metrics.getContentType());
+        res.end(metricsOutput);
+    }
+};
+exports.MetricsController = MetricsController;
+__decorate([
+    (0, common_1.Get)('metrics'),
+    __param(0, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], MetricsController.prototype, "getMetrics", null);
+exports.MetricsController = MetricsController = __decorate([
+    (0, core_1.Public)(),
+    (0, common_1.Controller)(),
+    __metadata("design:paramtypes", [MetricsService_1.MetricsService])
+], MetricsController);

package/dist/MetricsService.d.ts

@@ -0,0 +1,13 @@
+import { OnModuleInit } from '@nestjs/common';
+import { Registry, Counter, Histogram, Gauge } from 'prom-client';
+export declare class MetricsService implements OnModuleInit {
+    readonly registry: Registry<"text/plain; version=0.0.4; charset=utf-8">;
+    readonly buildTotal: Counter<"status" | "tech_stack">;
+    readonly stageDuration: Histogram<"status" | "stage_type">;
+    readonly promptCacheHits: Counter<string>;
+    readonly queueDepth: Gauge<"queue">;
+    readonly handlerDuration: Histogram<"handler" | "result">;
+    onModuleInit(): void;
+    getMetrics(): Promise<string>;
+    getContentType(): string;
+}

package/dist/MetricsService.js

@@ -0,0 +1,58 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsService = void 0;
+const common_1 = require("@nestjs/common");
+const prom_client_1 = require("prom-client");
+let MetricsService = class MetricsService {
+    registry = new prom_client_1.Registry();
+    buildTotal = new prom_client_1.Counter({
+        name: 'arex_build_total',
+        help: 'Total number of builds',
+        labelNames: ['status', 'tech_stack'],
+        registers: [this.registry],
+    });
+    stageDuration = new prom_client_1.Histogram({
+        name: 'arex_stage_duration_seconds',
+        help: 'Duration of pipeline stages in seconds',
+        labelNames: ['stage_type', 'status'],
+        buckets: [0.5, 1, 2, 5, 10, 30, 60, 120, 300],
+        registers: [this.registry],
+    });
+    promptCacheHits = new prom_client_1.Counter({
+        name: 'arex_prompt_cache_hits_total',
+        help: 'Total prompt cache hits',
+        registers: [this.registry],
+    });
+    queueDepth = new prom_client_1.Gauge({
+        name: 'arex_queue_depth',
+        help: 'Current depth of Bull job queue',
+        labelNames: ['queue'],
+        registers: [this.registry],
+    });
+    handlerDuration = new prom_client_1.Histogram({
+        name: 'arex_handler_duration_seconds',
+        help: 'Duration of command/query handlers in seconds',
+        labelNames: ['handler', 'result'],
+        buckets: [0.01, 0.05, 0.1, 0.25, 0.5, 1, 2, 5],
+        registers: [this.registry],
+    });
+    onModuleInit() {
+        (0, prom_client_1.collectDefaultMetrics)({ register: this.registry });
+    }
+    async getMetrics() {
+        return this.registry.metrics();
+    }
+    getContentType() {
+        return this.registry.contentType;
+    }
+};
+exports.MetricsService = MetricsService;
+exports.MetricsService = MetricsService = __decorate([
+    (0, common_1.Injectable)()
+], MetricsService);

package/dist/PerformanceBehavior.d.ts

@@ -0,0 +1,10 @@
+import { Result, PipelineBehavior, PipelineScope } from '@quanticjs/core';
+import { MetricsService } from './MetricsService';
+export declare class PerformanceBehavior implements PipelineBehavior {
+    private readonly metrics?;
+    readonly order: 20;
+    readonly scope: PipelineScope;
+    private readonly logger;
+    constructor(metrics?: MetricsService | undefined);
+    execute<T>(command: object, next: () => Promise<Result<T>>): Promise<Result<T>>;
+}

package/dist/PerformanceBehavior.js

@@ -0,0 +1,53 @@
+"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.PerformanceBehavior = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@quanticjs/core");
+const MetricsService_1 = require("./MetricsService");
+const SLOW_THRESHOLD_MS = 500;
+let PerformanceBehavior = class PerformanceBehavior {
+    metrics;
+    order = core_1.BehaviorOrder.PERFORMANCE;
+    scope = 'both';
+    logger = new common_1.Logger('PerformanceBehavior');
+    constructor(metrics) {
+        this.metrics = metrics;
+    }
+    async execute(command, next) {
+        const handlerName = command.constructor.name;
+        const startTime = Date.now();
+        const result = await next();
+        const durationMs = Date.now() - startTime;
+        const durationSec = durationMs / 1000;
+        const resultLabel = result.isSuccess ? 'success' : 'failure';
+        this.metrics?.handlerDuration
+            .labels(handlerName, resultLabel)
+            .observe(durationSec);
+        if (durationMs > SLOW_THRESHOLD_MS) {
+            this.logger.warn({
+                msg: `Slow handler detected: ${handlerName} took ${durationMs}ms`,
+                handler: handlerName,
+                durationMs,
+            });
+        }
+        return result;
+    }
+};
+exports.PerformanceBehavior = PerformanceBehavior;
+exports.PerformanceBehavior = PerformanceBehavior = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [MetricsService_1.MetricsService])
+], PerformanceBehavior);

package/dist/QuanticMetricsModule.d.ts

@@ -0,0 +1,4 @@
+import { DynamicModule } from '@nestjs/common';
+export declare class QuanticMetricsModule {
+    static forRoot(): DynamicModule;
+}

package/dist/QuanticMetricsModule.js

@@ -0,0 +1,37 @@
+"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 QuanticMetricsModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuanticMetricsModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@quanticjs/core");
+const MetricsService_1 = require("./MetricsService");
+const MetricsController_1 = require("./MetricsController");
+const PerformanceBehavior_1 = require("./PerformanceBehavior");
+let QuanticMetricsModule = QuanticMetricsModule_1 = class QuanticMetricsModule {
+    static forRoot() {
+        return {
+            module: QuanticMetricsModule_1,
+            controllers: [MetricsController_1.MetricsController],
+            providers: [
+                MetricsService_1.MetricsService,
+                PerformanceBehavior_1.PerformanceBehavior,
+                { provide: core_1.PIPELINE_BEHAVIOR, useExisting: PerformanceBehavior_1.PerformanceBehavior, multi: true },
+            ],
+            exports: [
+                MetricsService_1.MetricsService,
+                PerformanceBehavior_1.PerformanceBehavior,
+            ],
+        };
+    }
+};
+exports.QuanticMetricsModule = QuanticMetricsModule;
+exports.QuanticMetricsModule = QuanticMetricsModule = QuanticMetricsModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], QuanticMetricsModule);

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { MetricsService } from './MetricsService';
+export { MetricsController } from './MetricsController';
+export { PerformanceBehavior } from './PerformanceBehavior';
+export { QuanticMetricsModule } from './QuanticMetricsModule';

package/dist/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuanticMetricsModule = exports.PerformanceBehavior = exports.MetricsController = exports.MetricsService = void 0;
+var MetricsService_1 = require("./MetricsService");
+Object.defineProperty(exports, "MetricsService", { enumerable: true, get: function () { return MetricsService_1.MetricsService; } });
+var MetricsController_1 = require("./MetricsController");
+Object.defineProperty(exports, "MetricsController", { enumerable: true, get: function () { return MetricsController_1.MetricsController; } });
+var PerformanceBehavior_1 = require("./PerformanceBehavior");
+Object.defineProperty(exports, "PerformanceBehavior", { enumerable: true, get: function () { return PerformanceBehavior_1.PerformanceBehavior; } });
+var QuanticMetricsModule_1 = require("./QuanticMetricsModule");
+Object.defineProperty(exports, "QuanticMetricsModule", { enumerable: true, get: function () { return QuanticMetricsModule_1.QuanticMetricsModule; } });

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@quanticjs/metrics",
+  "version": "2.0.0",
+  "description": "Prometheus metrics for quanticjs — handler duration, custom counters",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "jest --passWithNoTests",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@quanticjs/core": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "prom-client": "^15.0.0"
+  }
+}