@rsdk/core 0.14.0

package/dist/tracing/tracing.config.js

@@ -0,0 +1,36 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracingModuleConfig = void 0;
+const config_1 = require("../config");
+let TracingModuleConfig = class TracingModuleConfig extends config_1.Config {
+    enabled;
+    collectorUrl;
+};
+__decorate([
+    (0, config_1.Property)('TRACING_ENABLED', new config_1.BoolParser(), {
+        defaultValue: false,
+        description: 'Enable application tracing',
+    }),
+    __metadata("design:type", Boolean)
+], TracingModuleConfig.prototype, "enabled", void 0);
+__decorate([
+    (0, config_1.Property)('TRACING_COLLECTOR_URL', new config_1.UrlParser(), {
+        defaultValue: new URL('http://localhost:4318/v1/traces'),
+        description: 'Url to jaeger/zipkin/otlp collector etc.',
+    }),
+    __metadata("design:type", URL)
+], TracingModuleConfig.prototype, "collectorUrl", void 0);
+TracingModuleConfig = __decorate([
+    (0, config_1.ConfigSection)()
+], TracingModuleConfig);
+exports.TracingModuleConfig = TracingModuleConfig;
+//# sourceMappingURL=tracing.config.js.map

package/dist/tracing/tracing.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.config.js","sourceRoot":"","sources":["../../src/tracing/tracing.config.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,sCAMmB;AAGZ,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,eAAM;IAK7C,OAAO,CAAW;IAMlB,YAAY,CAAO;CACpB,CAAA;AAXC;IAAC,IAAA,iBAAQ,EAAC,iBAAiB,EAAE,IAAI,mBAAU,EAAE,EAAE;QAC7C,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,4BAA4B;KAC1C,CAAC;;oDACgB;AAElB;IAAC,IAAA,iBAAQ,EAAC,uBAAuB,EAAE,IAAI,kBAAS,EAAE,EAAE;QAClD,YAAY,EAAE,IAAI,GAAG,CAAC,iCAAiC,CAAC;QACxD,WAAW,EAAE,0CAA0C;KACxD,CAAC;8BACa,GAAG;yDAAC;AAXR,mBAAmB;IAD/B,IAAA,sBAAa,GAAE;GACH,mBAAmB,CAY/B;AAZY,kDAAmB"}

package/dist/tracing/tracing.module.d.ts

@@ -0,0 +1,22 @@
+import type { DynamicModule } from '@nestjs/common';
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import type { SpanExporter } from '@opentelemetry/sdk-trace-base';
+import { ILogger } from '@rsdk/logging';
+import { InstrumentationService } from './services/instrumentation.service';
+import { TracingModuleConfig } from './tracing.config';
+export interface TracingModuleOptions {
+    appName: string;
+    processing: 'simple' | 'batch';
+    exporter?: SpanExporter;
+}
+export declare class TracingModule {
+    private readonly logger;
+    private readonly instrumentations;
+    private readonly sdk;
+    private readonly config;
+    constructor(logger: ILogger, instrumentations: InstrumentationService, sdk: NodeSDK, config: TracingModuleConfig);
+    static forRoot(options: TracingModuleOptions): DynamicModule;
+    private static createSDKProvider;
+    onModuleInit(): Promise<void>;
+    beforeApplicationShutdown(): Promise<void>;
+}

package/dist/tracing/tracing.module.js

@@ -0,0 +1,118 @@
+"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 TracingModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracingModule = void 0;
+const common_1 = require("@nestjs/common");
+const api_1 = require("@opentelemetry/api");
+const context_async_hooks_1 = require("@opentelemetry/context-async-hooks");
+const core_1 = require("@opentelemetry/core");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const propagator_b3_1 = require("@opentelemetry/propagator-b3");
+const resources_1 = require("@opentelemetry/resources");
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const logging_1 = require("@rsdk/logging");
+const config_1 = require("../config");
+const logging_2 = require("../logging");
+const instrumentation_service_1 = require("./services/instrumentation.service");
+const metadata_scanner_1 = require("./services/metadata.scanner");
+const auto_instrumentations_config_1 = require("./auto-instrumentations.config");
+const tracing_config_1 = require("./tracing.config");
+let TracingModule = TracingModule_1 = class TracingModule {
+    logger;
+    instrumentations;
+    sdk;
+    config;
+    constructor(logger, instrumentations, sdk, config) {
+        this.logger = logger;
+        this.instrumentations = instrumentations;
+        this.sdk = sdk;
+        this.config = config;
+    }
+    static forRoot(options) {
+        return {
+            module: TracingModule_1,
+            imports: [config_1.PlatformConfigModule.forFeature(tracing_config_1.TracingModuleConfig)],
+            providers: [
+                metadata_scanner_1.ExtendedMetadataScanner,
+                instrumentation_service_1.InstrumentationService,
+                this.createSDKProvider(options),
+            ],
+        };
+    }
+    static createSDKProvider(options) {
+        return {
+            provide: sdk_node_1.NodeSDK,
+            inject: [tracing_config_1.TracingModuleConfig],
+            useFactory: (config) => {
+                const exporter = options.exporter ||
+                    new exporter_trace_otlp_http_1.OTLPTraceExporter({
+                        url: config.collectorUrl?.toString(),
+                    });
+                const processor = options.processing === 'simple'
+                    ? new sdk_trace_base_1.SimpleSpanProcessor(exporter)
+                    : new sdk_trace_base_1.BatchSpanProcessor(exporter);
+                return new sdk_node_1.NodeSDK({
+                    autoDetectResources: true,
+                    contextManager: new context_async_hooks_1.AsyncLocalStorageContextManager(),
+                    instrumentations: [auto_instrumentations_config_1.autoInstumentationOptions],
+                    resource: new resources_1.Resource({
+                        [semantic_conventions_1.SemanticResourceAttributes.SERVICE_NAME]: options.appName,
+                    }),
+                    spanProcessor: processor,
+                    textMapPropagator: new core_1.CompositePropagator({
+                        propagators: [
+                            new propagator_b3_1.B3Propagator(),
+                            new propagator_b3_1.B3Propagator({
+                                injectEncoding: propagator_b3_1.B3InjectEncoding.MULTI_HEADER,
+                            }),
+                        ],
+                    }),
+                });
+            },
+        };
+    }
+    // Можно добавить включение и выключение при изменении конфига.
+    async onModuleInit() {
+        if (!this.config.enabled) {
+            this.logger.info('Tracing is disabled');
+            return;
+        }
+        this.logger.info('Tracing is enabled');
+        this.logger.debug('Starting Open Telemetry SDK...');
+        await this.sdk.start();
+        this.logger.debug('Instrumenting nest.js entities...');
+        this.instrumentations.inject();
+        this.logger.debug('Attaching log messages to spans...');
+        logging_1.LoggerFactory.onMessage((level, msg) => {
+            const span = api_1.trace.getSpan(api_1.context.active());
+            span?.addEvent('log', { ...msg, level });
+        });
+    }
+    async beforeApplicationShutdown() {
+        this.logger.info('Shutting down Open Telemetry SDK...');
+        await this.sdk.shutdown();
+    }
+};
+TracingModule = TracingModule_1 = __decorate([
+    (0, common_1.Module)({}),
+    __param(0, (0, logging_2.InjectLogger)(TracingModule_1)),
+    __metadata("design:paramtypes", [Object, instrumentation_service_1.InstrumentationService,
+        sdk_node_1.NodeSDK,
+        tracing_config_1.TracingModuleConfig])
+], TracingModule);
+exports.TracingModule = TracingModule;
+//# sourceMappingURL=tracing.module.js.map

package/dist/tracing/tracing.module.js.map

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

package/dist/transport/transport.module.d.ts

@@ -0,0 +1,8 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { PlatformExtendedOptions } from '../types';
+export declare class PlatformTransportModule {
+    static forOptions(options: PlatformExtendedOptions): DynamicModule;
+    private static initMetrics;
+    private static initHealthchecks;
+    private static initExceptionsHandling;
+}

package/dist/transport/transport.module.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformTransportModule = void 0;
+const lodash_1 = require("lodash");
+const exceptions_handling_1 = require("../exceptions.handling");
+const health_1 = require("../health");
+const metrics_1 = require("../metrics");
+const types_1 = require("../types");
+class PlatformTransportModule {
+    static forOptions(options) {
+        return {
+            imports: [
+                PlatformTransportModule.initHealthchecks(options),
+                PlatformTransportModule.initMetrics(options),
+                PlatformTransportModule.initExceptionsHandling(options),
+            ],
+            module: PlatformTransportModule,
+        };
+    }
+    static initMetrics(options) {
+        const transports = options.transports ?? [];
+        return metrics_1.MetricsModule.forRoot({
+            controllers: transports
+                .filter(types_1.isPrimaryTransport)
+                .map((x) => x.getMetricsController()),
+        });
+    }
+    static initHealthchecks(options) {
+        const transports = options.transports ?? [];
+        return health_1.HealthModule.forRoot({
+            controllers: transports
+                .filter(types_1.isPrimaryTransport)
+                .map((x) => x.getHealthController()),
+        });
+    }
+    static initExceptionsHandling(options) {
+        const transports = options.transports ?? [];
+        return exceptions_handling_1.GlobalExceptionsModule.forRoot({
+            formatters: [
+                ...transports.map((x) => x.getErrorsFormatter()),
+                ...(options.plugins?.map((x) => x.errorFormatter?.()) || []),
+            ].filter((x) => x),
+            senders: [
+                ...transports.map((x) => x.getErrorsSender?.()),
+                ...(options.plugins?.map((x) => x.errorSender?.()) || []),
+            ].filter((x) => x),
+            transformers: [
+                ...(0, lodash_1.flatten)(transports.map((x) => x.getErrorTransformers())),
+                ...(0, lodash_1.flatten)(options.plugins?.map((x) => x.errorTransformers?.() || [])),
+            ],
+        });
+    }
+}
+exports.PlatformTransportModule = PlatformTransportModule;
+//# sourceMappingURL=transport.module.js.map

package/dist/transport/transport.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.module.js","sourceRoot":"","sources":["../../src/transport/transport.module.ts"],"names":[],"mappings":";;;AACA,mCAAiC;AAEjC,gEAAgE;AAChE,sCAAyC;AACzC,wCAA2C;AAE3C,oCAA8C;AAE9C,MAAa,uBAAuB;IAClC,MAAM,CAAC,UAAU,CAAC,OAAgC;QAChD,OAAO;YACL,OAAO,EAAE;gBACP,uBAAuB,CAAC,gBAAgB,CAAC,OAAO,CAAC;gBACjD,uBAAuB,CAAC,WAAW,CAAC,OAAO,CAAC;gBAC5C,uBAAuB,CAAC,sBAAsB,CAAC,OAAO,CAAC;aACxD;YACD,MAAM,EAAE,uBAAuB;SAChC,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,WAAW,CAAC,OAAgC;QACzD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAK,EAAY,CAAC;QAEvD,OAAO,uBAAa,CAAC,OAAO,CAAC;YAC3B,WAAW,EAAE,UAAU;iBACpB,MAAM,CAAC,0BAAkB,CAAC;iBAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAC7B,OAAgC;QAEhC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAK,EAAY,CAAC;QAEvD,OAAO,qBAAY,CAAC,OAAO,CAAC;YAC1B,WAAW,EAAE,UAAU;iBACpB,MAAM,CAAC,0BAAkB,CAAC;iBAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,sBAAsB,CACnC,OAAgC;QAEhC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;QAE5C,OAAO,4CAAsB,CAAC,OAAO,CAAC;YACpC,UAAU,EAAE;gBACV,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;gBAChD,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;aAC7D,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAClB,OAAO,EAAE;gBACP,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC;gBAC/C,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;aAC1D,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAClB,YAAY,EAAE;gBACZ,GAAG,IAAA,gBAAO,EAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC;gBAC3D,GAAG,IAAA,gBAAO,EAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;aACvE;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAtDD,0DAsDC"}