@dofe/infra-prisma 0.1.1

package/dist/db-metrics/index.d.ts

@@ -0,0 +1,2 @@
+export * from './src';
+//# sourceMappingURL=index.d.ts.map

package/dist/db-metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db-metrics/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/dist/db-metrics/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./src"), exports);
+//# sourceMappingURL=index.js.map

package/dist/db-metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db-metrics/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB"}

package/dist/db-metrics/src/db-metrics.module.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Database Metrics Module
+ * 数据库指标模块
+ *
+ * Provides database query and transaction metrics collection
+ * with Prometheus integration and Winston logging.
+ *
+ * 提供数据库查询和事务指标收集，
+ * 集成 Prometheus 和 Winston 日志。
+ *
+ * @example
+ * ```typescript
+ * // Import in AppModule
+ * @Module({
+ *   imports: [DbMetricsModule],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class DbMetricsModule {
+}
+//# sourceMappingURL=db-metrics.module.d.ts.map

package/dist/db-metrics/src/db-metrics.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-metrics.module.d.ts","sourceRoot":"","sources":["../../../src/db-metrics/src/db-metrics.module.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBA+Ga,eAAe;CAAG"}

package/dist/db-metrics/src/db-metrics.module.js

@@ -0,0 +1,140 @@
+"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.DbMetricsModule = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_prometheus_1 = require("@willsoto/nestjs-prometheus");
+const config_1 = require("@nestjs/config");
+const prometheus_1 = require("../../prometheus");
+const db_metrics_service_1 = require("./db-metrics.service");
+/**
+ * Database Metrics Module
+ * 数据库指标模块
+ *
+ * Provides database query and transaction metrics collection
+ * with Prometheus integration and Winston logging.
+ *
+ * 提供数据库查询和事务指标收集，
+ * 集成 Prometheus 和 Winston 日志。
+ *
+ * @example
+ * ```typescript
+ * // Import in AppModule
+ * @Module({
+ *   imports: [DbMetricsModule],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+let DbMetricsModule = class DbMetricsModule {
+};
+exports.DbMetricsModule = DbMetricsModule;
+exports.DbMetricsModule = DbMetricsModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        imports: [
+            config_1.ConfigModule,
+            // 导入 PrometheusConfigModule 而不是自己注册 PrometheusModule
+            // 这样可以避免重复注册 /metrics 路由
+            // PrometheusConfigModule 已经全局注册了 Prometheus 模块和 /metrics 路由
+            prometheus_1.PrometheusConfigModule,
+        ],
+        providers: [
+            db_metrics_service_1.DbMetricsService,
+            // =====================================================================
+            // Query Metrics
+            // 查询指标
+            // =====================================================================
+            /**
+             * Query duration histogram
+             * 查询时长直方图
+             *
+             * Buckets are chosen to capture typical database query latencies:
+             * - 10ms-100ms: Fast queries
+             * - 100ms-500ms: Normal queries
+             * - 500ms-1s: Slow queries
+             * - 1s+: Very slow queries requiring optimization
+             */
+            (0, nestjs_prometheus_1.makeHistogramProvider)({
+                name: 'prisma_query_duration_seconds',
+                help: 'Duration of Prisma queries in seconds',
+                labelNames: ['model', 'action', 'db_type', 'status'],
+                buckets: [0.01, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],
+            }),
+            /**
+             * Total query counter
+             * 查询总数计数器
+             */
+            (0, nestjs_prometheus_1.makeCounterProvider)({
+                name: 'prisma_query_total',
+                help: 'Total number of Prisma queries',
+                labelNames: ['model', 'action', 'db_type', 'status'],
+            }),
+            /**
+             * Slow query counter by threshold level
+             * 按阈值级别的慢查询计数器
+             */
+            (0, nestjs_prometheus_1.makeCounterProvider)({
+                name: 'prisma_slow_query_total',
+                help: 'Total number of slow queries by threshold level',
+                labelNames: ['model', 'action', 'db_type', 'threshold_level'],
+            }),
+            // =====================================================================
+            // Transaction Metrics
+            // 事务指标
+            // =====================================================================
+            /**
+             * Transaction duration histogram
+             * 事务时长直方图
+             *
+             * Buckets are chosen for typical transaction durations:
+             * - 100ms-1s: Fast transactions
+             * - 1s-10s: Normal transactions
+             * - 10s+: Long-running transactions
+             */
+            (0, nestjs_prometheus_1.makeHistogramProvider)({
+                name: 'prisma_transaction_duration_seconds',
+                help: 'Duration of Prisma transactions in seconds',
+                labelNames: ['status', 'retry_count', 'isolation_level'],
+                buckets: [0.1, 0.5, 1, 2.5, 5, 10, 30, 60],
+            }),
+            /**
+             * Total transaction counter
+             * 事务总数计数器
+             */
+            (0, nestjs_prometheus_1.makeCounterProvider)({
+                name: 'prisma_transaction_total',
+                help: 'Total number of transactions',
+                labelNames: ['status', 'retry_count', 'isolation_level'],
+            }),
+            /**
+             * Active transactions gauge
+             * 活跃事务数仪表
+             */
+            (0, nestjs_prometheus_1.makeGaugeProvider)({
+                name: 'prisma_active_transactions',
+                help: 'Number of currently active transactions',
+            }),
+            // =====================================================================
+            // Connection Pool Metrics
+            // 连接池指标
+            // =====================================================================
+            /**
+             * Active connections gauge
+             * 活跃连接数仪表
+             */
+            (0, nestjs_prometheus_1.makeGaugeProvider)({
+                name: 'prisma_pool_connections_active',
+                help: 'Number of active connections in the pool',
+                labelNames: ['db_type'],
+            }),
+        ],
+        exports: [db_metrics_service_1.DbMetricsService],
+    })
+], DbMetricsModule);
+//# sourceMappingURL=db-metrics.module.js.map

package/dist/db-metrics/src/db-metrics.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-metrics.module.js","sourceRoot":"","sources":["../../../src/db-metrics/src/db-metrics.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,mEAIqC;AACrC,2CAA8C;AAC9C,iDAA0D;AAC1D,6DAAwD;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AAgHI,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IA/G3B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,qBAAY;YACZ,qDAAqD;YACrD,yBAAyB;YACzB,4DAA4D;YAC5D,mCAAsB;SACvB;QACD,SAAS,EAAE;YACT,qCAAgB;YAEhB,wEAAwE;YACxE,gBAAgB;YAChB,OAAO;YACP,wEAAwE;YAExE;;;;;;;;;eASG;YACH,IAAA,yCAAqB,EAAC;gBACpB,IAAI,EAAE,+BAA+B;gBACrC,IAAI,EAAE,uCAAuC;gBAC7C,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC;gBACpD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;aACrD,CAAC;YAEF;;;eAGG;YACH,IAAA,uCAAmB,EAAC;gBAClB,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,gCAAgC;gBACtC,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC;aACrD,CAAC;YAEF;;;eAGG;YACH,IAAA,uCAAmB,EAAC;gBAClB,IAAI,EAAE,yBAAyB;gBAC/B,IAAI,EAAE,iDAAiD;gBACvD,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,CAAC;aAC9D,CAAC;YAEF,wEAAwE;YACxE,sBAAsB;YACtB,OAAO;YACP,wEAAwE;YAExE;;;;;;;;eAQG;YACH,IAAA,yCAAqB,EAAC;gBACpB,IAAI,EAAE,qCAAqC;gBAC3C,IAAI,EAAE,4CAA4C;gBAClD,UAAU,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,iBAAiB,CAAC;gBACxD,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;aAC3C,CAAC;YAEF;;;eAGG;YACH,IAAA,uCAAmB,EAAC;gBAClB,IAAI,EAAE,0BAA0B;gBAChC,IAAI,EAAE,8BAA8B;gBACpC,UAAU,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,iBAAiB,CAAC;aACzD,CAAC;YAEF;;;eAGG;YACH,IAAA,qCAAiB,EAAC;gBAChB,IAAI,EAAE,4BAA4B;gBAClC,IAAI,EAAE,yCAAyC;aAChD,CAAC;YAEF,wEAAwE;YACxE,0BAA0B;YAC1B,QAAQ;YACR,wEAAwE;YAExE;;;eAGG;YACH,IAAA,qCAAiB,EAAC;gBAChB,IAAI,EAAE,gCAAgC;gBACtC,IAAI,EAAE,0CAA0C;gBAChD,UAAU,EAAE,CAAC,SAAS,CAAC;aACxB,CAAC;SACH;QACD,OAAO,EAAE,CAAC,qCAAgB,CAAC;KAC5B,CAAC;GACW,eAAe,CAAG"}

package/dist/db-metrics/src/db-metrics.service.d.ts

@@ -0,0 +1,183 @@
+import { OnModuleInit } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { Logger } from 'winston';
+import { Counter, Histogram, Gauge } from 'prom-client';
+/**
+ * Slow query threshold levels
+ * 慢查询阈值级别
+ */
+export interface SlowQueryThresholds {
+    /**
+     * Queries >= info threshold will be logged at INFO level (ms)
+     * 达到此阈值的查询将以 INFO 级别记录
+     */
+    info: number;
+    /**
+     * Queries >= warn threshold will be logged at WARN level (ms)
+     * 达到此阈值的查询将以 WARN 级别记录
+     */
+    warn: number;
+    /**
+     * Queries >= error threshold will be logged at ERROR level (ms)
+     * 达到此阈值的查询将以 ERROR 级别记录
+     */
+    error: number;
+}
+/**
+ * Database metrics configuration
+ * 数据库指标配置
+ */
+export interface DbMetricsConfig {
+    /**
+     * Enable or disable metrics collection
+     * 启用或禁用指标收集
+     */
+    enabled: boolean;
+    /**
+     * Slow query thresholds
+     * 慢查询阈值
+     */
+    slowQueryThresholds: SlowQueryThresholds;
+    /**
+     * Whether to log query parameters
+     * 是否记录查询参数
+     */
+    logQueryParams: boolean;
+    /**
+     * Whether to log query results
+     * 是否记录查询结果
+     */
+    logQueryResult: boolean;
+    /**
+     * Maximum length of parameters to log
+     * 记录参数的最大长度
+     */
+    maxParamLogLength: number;
+}
+/**
+ * Query context for tracking
+ * 查询跟踪上下文
+ */
+export interface QueryContext {
+    startTime: number;
+    traceId: string;
+}
+/**
+ * Query parameters for metrics
+ * 查询指标参数
+ */
+export interface QueryParams {
+    model: string;
+    action: string;
+    dbType: 'read' | 'write';
+}
+/**
+ * Transaction context for tracking
+ * 事务跟踪上下文
+ */
+export interface TransactionContext {
+    startTime: number;
+    traceId: string;
+    sqlCount: number;
+    tablesInvolved: Set<string>;
+}
+/**
+ * Transaction metadata for logging
+ * 事务日志元数据
+ */
+export interface TransactionMetadata {
+    retryCount?: number;
+    isolationLevel?: string;
+    sqlCount?: number;
+    tablesInvolved?: string[];
+    lockWaitTime?: number;
+    errorType?: string;
+    errorMessage?: string;
+    methodName?: string;
+}
+/**
+ * Database Metrics Service
+ * 数据库指标服务
+ *
+ * Provides unified metrics collection and logging for database operations.
+ * 为数据库操作提供统一的指标收集和日志记录。
+ */
+export declare class DbMetricsService implements OnModuleInit {
+    private readonly configService?;
+    private readonly logger?;
+    private readonly queryDuration?;
+    private readonly queryTotal?;
+    private readonly slowQueryTotal?;
+    private readonly txDuration?;
+    private readonly txTotal?;
+    private readonly activeTx?;
+    private config;
+    constructor(configService?: ConfigService, logger?: Logger, queryDuration?: Histogram<string>, queryTotal?: Counter<string>, slowQueryTotal?: Counter<string>, txDuration?: Histogram<string>, txTotal?: Counter<string>, activeTx?: Gauge<string>);
+    onModuleInit(): void;
+    /**
+     * Get current configuration
+     * 获取当前配置
+     */
+    getConfig(): DbMetricsConfig;
+    /**
+     * Check if metrics collection is enabled
+     * 检查指标收集是否启用
+     */
+    isEnabled(): boolean;
+    /**
+     * Start tracking a query
+     * 开始跟踪查询
+     */
+    recordQueryStart(): QueryContext;
+    /**
+     * Record query completion
+     * 记录查询完成
+     */
+    recordQueryEnd(ctx: QueryContext, params: QueryParams, status: 'success' | 'error', args?: unknown, error?: Error): void;
+    /**
+     * Determine the threshold level based on query duration
+     * 根据查询时长确定阈值级别
+     */
+    private getThresholdLevel;
+    /**
+     * Log query information with appropriate level
+     * 以适当的级别记录查询信息
+     */
+    private logQuery;
+    /**
+     * Start tracking a transaction
+     * 开始跟踪事务
+     */
+    recordTransactionStart(): TransactionContext;
+    /**
+     * Increment SQL count in transaction context
+     * 增加事务上下文中的 SQL 计数
+     */
+    incrementSqlCount(ctx: TransactionContext, model?: string): void;
+    /**
+     * Record transaction completion
+     * 记录事务完成
+     */
+    recordTransactionEnd(ctx: TransactionContext, status: 'success' | 'error' | 'rollback', metadata?: TransactionMetadata): void;
+    /**
+     * Log transaction information
+     * 记录事务信息
+     */
+    private logTransaction;
+    /**
+     * Get current trace ID from CLS namespace
+     * 从 CLS 命名空间获取当前 traceId
+     */
+    private getTraceId;
+    /**
+     * Create a fallback context when metrics service is not available
+     * 当指标服务不可用时创建回退上下文
+     */
+    static createFallbackQueryContext(): QueryContext;
+    /**
+     * Create a fallback transaction context
+     * 创建回退事务上下文
+     */
+    static createFallbackTransactionContext(): TransactionContext;
+}
+//# sourceMappingURL=db-metrics.service.d.ts.map

package/dist/db-metrics/src/db-metrics.service.d.ts.map

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