@lad-tech/nsc-toolkit 1.28.0 → 1.28.2

package/.vscode/launch.json

@@ -0,0 +1,77 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Launch NSC_Example_Gate_Micro",
+      "skipFiles": ["<node_internals>/**"],
+      "program": "${workspaceFolder}/examples/HttpGate/dist/examples/HttpGate/start.micro.js",
+      "outFiles": ["${workspaceFolder}/examples/HttpGate/dist/**/*.js"],
+      "preLaunchTask": "buildGateMicro",
+      "outputCapture": "std",
+      "env": {
+        "NODE_PATH": "${workspaceFolder}/examples/HttpGate/dist",
+        "LOG_LEVEL": "info",
+        "NATS_HOST": "nats://localhost:4222",
+        "DEFAULT_RESPONSE_TIMEOUT": "50000",
+        "ENVIRONMENT": "local",
+        "OTEL_AGENT": "http://localhost:4318/v1/traces"
+      }
+    },
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Launch NSC_Example_Gate_Mono",
+      "skipFiles": ["<node_internals>/**"],
+      "program": "${workspaceFolder}/examples/HttpGate/dist/examples/HttpGate/start.mono.js",
+      "outFiles": ["${workspaceFolder}/examples/HttpGate/dist/**/*.js"],
+      "preLaunchTask": "buildGateMono",
+      "outputCapture": "std",
+      "env": {
+        "NODE_PATH": "${workspaceFolder}/examples/HttpGate/dist",
+        "LOG_LEVEL": "info",
+        "NATS_HOST": "nats://localhost:4222",
+        "DEFAULT_RESPONSE_TIMEOUT": "50000",
+        "ENVIRONMENT": "local"
+      }
+    },
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Launch NSC_Example_Logic",
+      "skipFiles": ["<node_internals>/**"],
+      "program": "${workspaceFolder}/examples/LogicService",
+      "outFiles": ["${workspaceFolder}/examples/LogicService/dist/**/*.js"],
+      "preLaunchTask": "buildLogic",
+      "outputCapture": "std",
+      "env": {
+        "NODE_PATH": "${workspaceFolder}/examples/LogicService/dist",
+        "LOG_LEVEL": "info",
+        "NATS_HOST": "nats://localhost:4222",
+        "ENVIRONMENT": "local",
+        "OTEL_AGENT": "http://localhost:4318/v1/traces"
+      }
+    },
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Launch NSC_Example_Math",
+      "skipFiles": ["<node_internals>/**"],
+      "program": "${workspaceFolder}/examples/MathService",
+      "outFiles": ["${workspaceFolder}/examples/MathService/dist/**/*.js"],
+      "preLaunchTask": "buildMath",
+      "outputCapture": "std",
+      "env": {
+        "NODE_PATH": "${workspaceFolder}/examples/MathService/dist",
+        "LOG_LEVEL": "info",
+        "NATS_HOST": "nats://localhost:4222",
+        "ENVIRONMENT": "local",
+        "OTEL_AGENT": "http://localhost:4318/v1/traces"
+      }
+    }
+  ]
+}

package/.vscode/tasks.json

@@ -0,0 +1,25 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "buildGateMicro",
+      "type": "shell",
+      "command": "cd ${workspaceFolder}/examples/HttpGate/ && npm run buildMicro",
+    },
+    {
+      "label": "buildGateMono",
+      "type": "shell",
+      "command": "cd ${workspaceFolder}/examples/HttpGate/ && npm run buildMono",
+    },
+    {
+      "label": "buildLogic",
+      "type": "shell",
+      "command": "cd ${workspaceFolder}/examples/LogicService/ && npm run build",
+    },
+    {
+      "label": "buildMath",
+      "type": "shell",
+      "command": "cd ${workspaceFolder}/examples/MathService/ && npm run build",
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lad-tech/nsc-toolkit",
-  "version": "1.28.0",
+  "version": "1.28.2",
   "description": "Toolkit for create microservices around NATS",
   "main": "dist/index.js",
   "types": "./dist/types/index.d.ts",

package/CHANGELOG.md

@@ -1,6 +0,0 @@
-# [1.28.0](https://github.com/lad-tech/nsc-toolkit/compare/v1.27.0...v1.28.0) (2025-05-12)
-
-
-### Features
-
-* Async event traces and tags ([#145](https://github.com/lad-tech/nsc-toolkit/issues/145)) ([02c3560](https://github.com/lad-tech/nsc-toolkit/commit/02c356051d295d528c4cc7758b2a310d37074424))

package/dist/Client.js

@@ -1,292 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = void 0;
-const opentelemetry = require("@opentelemetry/api");
-const ajv_1 = require("ajv");
-const nats_1 = require("nats");
-const node_crypto_1 = require("node:crypto");
-const http = require("node:http");
-const node_stream_1 = require("node:stream");
-const promises_1 = require("node:timers/promises");
-const Root_1 = require("./Root");
-const StreamManager_1 = require("./StreamManager");
-const Meter_1 = require("./Meter");
-class Client extends Root_1.Root {
-    constructor({ broker, events, loggerOutputFormatter, serviceName, baggage, cache, Ref }) {
-        super(broker, loggerOutputFormatter);
-        this.subscriptions = new Map();
-        this.REQUEST_HTTP_SETTINGS_TIMEOUT = 1000; // ms
-        this.logger.setLocation(serviceName);
-        this.serviceName = serviceName;
-        this.baggage = baggage;
-        this.cache = cache;
-        this.events = events;
-        this.Ref = Ref;
-    }
-    async startWatch(subscription, listener, eventName) {
-        for await (const event of subscription) {
-            if (!event) {
-                continue;
-            }
-            let data;
-            try {
-                data = (0, nats_1.JSONCodec)().decode(event.data);
-            }
-            catch (error) {
-                data = (0, nats_1.StringCodec)().decode(event.data);
-            }
-            const message = { data };
-            let baggage;
-            if (event.headers) {
-                baggage = this.getBaggageFromNATSHeader(event.headers);
-            }
-            message.meter = new Meter_1.Meter(eventName, baggage);
-            if (this.isJsMessage(event)) {
-                message.ack = event.ack.bind(event);
-                message.nak = event.nak.bind(event);
-            }
-            listener.emit(eventName, message);
-        }
-    }
-    async startBatchWatch(fetcher, listener, eventName) {
-        while (true) {
-            const batch = [];
-            const events = await fetcher.fetch();
-            for await (const event of events) {
-                let data;
-                try {
-                    data = (0, nats_1.JSONCodec)().decode(event.data);
-                }
-                catch (error) {
-                    data = (0, nats_1.StringCodec)().decode(event.data);
-                }
-                const message = { data };
-                message.ack = event.ack.bind(event);
-                message.nak = event.nak.bind(event);
-                batch.push(message);
-            }
-            if (batch.length > 0)
-                listener.emit(eventName, batch);
-        }
-    }
-    getListener(serviceNameFrom, options) {
-        if (!this.events) {
-            throw new Error('The service does not generate events');
-        }
-        const listener = new node_stream_1.EventEmitter();
-        return new Proxy(listener, {
-            get: (target, prop, receiver) => {
-                const method = Reflect.get(target, prop, receiver);
-                if (prop === 'on') {
-                    return async (eventName, handler) => {
-                        var _a, _b;
-                        try {
-                            this.logger.info('Subscribe', eventName);
-                            const action = (_a = this.events) === null || _a === void 0 ? void 0 : _a.list[eventName];
-                            if (!action) {
-                                throw new Error(`The service does not generate ${String(eventName)} event`);
-                            }
-                            const isStream = (_b = action.options) === null || _b === void 0 ? void 0 : _b.stream;
-                            let subscription;
-                            if (isStream) {
-                                subscription = await new StreamManager_1.StreamManager({
-                                    broker: this.broker,
-                                    options: this.events.streamOptions,
-                                    serviceName: this.serviceName,
-                                }).createConsumer(serviceNameFrom, String(eventName), options);
-                            }
-                            else {
-                                const queue = (options === null || options === void 0 ? void 0 : options.queue) ? { queue: options.queue } : {};
-                                subscription = this.broker.subscribe(`${this.serviceName}.${eventName}`, queue);
-                            }
-                            this.subscriptions.set(eventName, subscription);
-                            if (StreamManager_1.StreamManager.isStreamFetcher(subscription) && StreamManager_1.StreamManager.isPullConsumerOptions(options)) {
-                                this.startBatchWatch(subscription, listener, String(eventName));
-                            }
-                            else {
-                                this.startWatch(subscription, listener, String(eventName));
-                            }
-                            return method.call(target, eventName, handler);
-                        }
-                        catch (error) {
-                            const errorMessage = 'Failed subscribe to subject';
-                            this.logger.error(errorMessage, error);
-                            throw new Error(`${errorMessage} ${this.serviceName}.${String(eventName)}`);
-                        }
-                    };
-                }
-                if (prop === 'off') {
-                    return (eventName, listener) => {
-                        this.logger.info('Unsubscribe', eventName);
-                        const subscription = this.subscriptions.get(eventName);
-                        subscription === null || subscription === void 0 ? void 0 : subscription.unsubscribe();
-                        this.subscriptions.delete(eventName);
-                        return method.call(target, eventName, listener);
-                    };
-                }
-                return method;
-            },
-        });
-    }
-    createCacheKey(subject, data) {
-        const dataHash = (0, node_crypto_1.createHash)('sha1').update(JSON.stringify(data)).digest('hex');
-        return `${this.CACHE_SERVICE_KEY}:${subject}:${dataHash}`;
-    }
-    validate(data, schema) {
-        const ajv = new ajv_1.default();
-        if (this.Ref) {
-            ajv.addSchema(this.Ref);
-        }
-        const requestValidator = ajv.compile(schema);
-        const valid = requestValidator(data);
-        if (!valid) {
-            throw new Error(JSON.stringify(requestValidator.errors));
-        }
-    }
-    async request(subject, data, { options, request, response }) {
-        var _a, _b, _c, _d, _e;
-        const tracer = opentelemetry.trace.getTracer('');
-        const span = tracer.startSpan(subject, undefined, this.getContext(this.baggage));
-        try {
-            if (((_a = options === null || options === void 0 ? void 0 : options.runTimeValidation) === null || _a === void 0 ? void 0 : _a.request) && request) {
-                this.validate(data, request);
-            }
-            const { spanId, traceId, traceFlags } = span.spanContext();
-            const expired = this.getExpired((_b = this.baggage) === null || _b === void 0 ? void 0 : _b.expired, options === null || options === void 0 ? void 0 : options.timeout);
-            const requestId = (_c = this.baggage) === null || _c === void 0 ? void 0 : _c.requestId;
-            const message = { payload: data, baggage: { expired, traceId, spanId, traceFlags, requestId } };
-            const timeout = expired - Date.now();
-            if (timeout <= 0) {
-                throw new Error('Timeout request service ' + subject);
-            }
-            let key = '';
-            if ((options === null || options === void 0 ? void 0 : options.cache) && !this.isStream(data) && this.cache) {
-                try {
-                    key = this.createCacheKey(subject, data);
-                    const result = await Promise.race([this.cache.service.get(key), (0, promises_1.setTimeout)(this.cache.timeout, null)]);
-                    if (result) {
-                        return JSON.parse(result);
-                    }
-                }
-                catch (error) {
-                    this.logger.warn('get cache: ', error);
-                }
-            }
-            const result = (options === null || options === void 0 ? void 0 : options.useStream)
-                ? await this.makeHttpRequest(subject, message, options, timeout)
-                : await this.makeBrokerRequest(subject, message, timeout);
-            if (result.error) {
-                throw new Error((_d = result.error.message) !== null && _d !== void 0 ? _d : result.error);
-            }
-            if (((_e = options === null || options === void 0 ? void 0 : options.runTimeValidation) === null || _e === void 0 ? void 0 : _e.response) && response) {
-                this.validate(result.payload, response);
-            }
-            if ((options === null || options === void 0 ? void 0 : options.cache) && !this.isStream(result.payload) && this.cache) {
-                this.cache.service.set(key, JSON.stringify(result.payload), options.cache);
-            }
-            return result.payload;
-        }
-        catch (error) {
-            span.setAttribute('error', true);
-            span.setAttribute('error.kind', error);
-            this.logger.error(error);
-            throw error;
-        }
-        finally {
-            span.end();
-        }
-    }
-    async getHTTPSettingsFromRemoteService() {
-        const subject = `${this.serviceName}.${this.SERVICE_SUBJECT_FOR_GET_HTTP_SETTINGS}`;
-        const result = await this.broker.request(subject, Buffer.from(JSON.stringify('')), {
-            timeout: this.REQUEST_HTTP_SETTINGS_TIMEOUT,
-        });
-        const { ip, port } = (0, nats_1.JSONCodec)().decode(result.data);
-        if (!ip || !port) {
-            throw new Error(`Remote service ${this.serviceName} did not return http settings`);
-        }
-        return { ip, port };
-    }
-    isStream(data) {
-        return data instanceof node_stream_1.Readable;
-    }
-    async makeBrokerRequest(subject, message, timeout) {
-        try {
-            const result = await this.broker.request(subject, Buffer.from(JSON.stringify(message)), { timeout });
-            return (0, nats_1.JSONCodec)().decode(result.data);
-        }
-        catch (error) {
-            const errorMessage = new Error(`${error === null || error === void 0 ? void 0 : error.message}. Subject: ${subject} `);
-            return this.buildErrorMessage(errorMessage);
-        }
-    }
-    async makeHttpRequest(subject, message, options, timeout) {
-        return new Promise(async (resolve) => {
-            const { ip, port } = await this.getHTTPSettingsFromRemoteService();
-            const serviceActionPath = subject.split('.');
-            const headersFromBaggage = this.convertBaggaggeToExternalHeader(message.baggage);
-            const headers = {
-                'Content-Type': this.isStream(message.payload) ? 'application/octet-stream' : 'application/json',
-                ...headersFromBaggage,
-            };
-            if (!this.isStream(message.payload)) {
-                headers['Content-Length'] = Buffer.byteLength(JSON.stringify(message.payload));
-            }
-            const request = http.request({
-                host: ip,
-                port,
-                path: `/${serviceActionPath.join('/')}`,
-                method: 'POST',
-                headers,
-                timeout,
-            }, async (response) => {
-                var _a;
-                if (((_a = options === null || options === void 0 ? void 0 : options.useStream) === null || _a === void 0 ? void 0 : _a.response) && response.statusCode !== 500) {
-                    resolve({ payload: response });
-                    return;
-                }
-                const data = [];
-                for await (const chunk of response) {
-                    data.push(chunk);
-                }
-                const responseDataString = Buffer.concat(data).toString();
-                try {
-                    resolve(JSON.parse(responseDataString));
-                }
-                catch (error) {
-                    const errorMessage = new Error(`${error === null || error === void 0 ? void 0 : error.message}. Subject: ${subject} `);
-                    resolve(this.buildErrorMessage(errorMessage));
-                }
-            });
-            request.on('error', error => {
-                const errorMessage = new Error(`${error === null || error === void 0 ? void 0 : error.message}. Subject: ${subject} `);
-                resolve(this.buildErrorMessage(errorMessage));
-            });
-            if (this.isStream(message.payload)) {
-                message.payload.pipe(request);
-                return;
-            }
-            request.write(JSON.stringify(message.payload));
-            request.end();
-        });
-    }
-    isJsMessage(message) {
-        return !!message.ack && !!message.nak;
-    }
-    getBaggageFromNATSHeader(headers) {
-        const traceId = headers.get('nsc-trace-id');
-        const spanId = headers.get('nsc-span-id');
-        const traceFlags = headers.has('nsc-trace-flags') ? +headers.get('nsc-trace-flags') : undefined;
-        const requestId = headers.has('x-request-id') ? String(headers.get('x-request-id')) : undefined;
-        if (traceId && spanId && traceFlags) {
-            return {
-                traceId,
-                spanId,
-                traceFlags,
-                requestId,
-            };
-        }
-    }
-}
-exports.Client = Client;
-//# sourceMappingURL=Client.js.map

package/dist/Container.js

@@ -1,124 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.container = void 0;
-const _1 = require(".");
-class Container {
-    constructor() {
-        this.container = new Map();
-        this.singltons = new Map();
-    }
-    buildDependency(key) {
-        const deepDependency = this.get(key);
-        if (this.isAdapterDependency(deepDependency.dependency)) {
-            return new deepDependency.dependency.value(...deepDependency.constructor);
-        }
-        if (this.isConstantDependency(deepDependency.dependency)) {
-            return deepDependency.dependency.value;
-        }
-    }
-    inject(dependency) {
-        if (this.isServiceDependency(dependency)) {
-            return { dependency, constructor: [] };
-        }
-        const deepDependencies = Reflect.getMetadata(_1.dependencyStorageMetaKey, dependency.value);
-        if (deepDependencies && deepDependencies.size) {
-            const constructor = [];
-            deepDependencies.forEach((key, propertyName) => {
-                if (Array.isArray(key)) {
-                    key.forEach((item, index) => {
-                        constructor[index] = this.buildDependency(item);
-                    });
-                }
-                else {
-                    dependency.value.prototype[propertyName] = this.buildDependency(key);
-                }
-            });
-            return { dependency, constructor };
-        }
-        return { dependency, constructor: [] };
-    }
-    isServiceDependency(dependency) {
-        return dependency.type === _1.DependencyType.SERVICE;
-    }
-    isAdapterDependency(dependency) {
-        return dependency.type === _1.DependencyType.ADAPTER;
-    }
-    isConstantDependency(dependency) {
-        return dependency.type === _1.DependencyType.CONSTANT;
-    }
-    bind(key, type, value, options) {
-        this.container.set(key, { type, value, options });
-    }
-    symbol(key) {
-        return {
-            to: {
-                Adapter: (value, options) => {
-                    this.container.set(key, { type: _1.DependencyType.ADAPTER, value, options });
-                },
-                Singlton: (value) => {
-                    this.container.set(key, { type: _1.DependencyType.ADAPTER, value, options: { singlton: true } });
-                },
-                Constant: (value) => {
-                    this.container.set(key, { type: _1.DependencyType.CONSTANT, value, options: { singlton: true } });
-                },
-                Initializable: (value) => {
-                    this.container.set(key, { type: _1.DependencyType.ADAPTER, value, options: { init: true } });
-                },
-                Service: (value) => {
-                    this.container.set(key, { type: _1.DependencyType.SERVICE, value });
-                },
-            },
-        };
-    }
-    async unbind(key) {
-        this.container.delete(key);
-        const instance = this.singltons.get(key);
-        if (instance === null || instance === void 0 ? void 0 : instance.init) {
-            await instance.value.close();
-        }
-        this.singltons.delete(key);
-    }
-    get(key) {
-        const dependency = this.container.get(key);
-        if (!dependency) {
-            throw new Error(`Dependency ${key.toString()} is not bound to the container`);
-        }
-        return this.inject(dependency);
-    }
-    getInstance(key) {
-        var _a, _b, _c;
-        const { dependency, constructor } = this.get(key);
-        if (this.isServiceDependency(dependency)) {
-            throw new Error(`Unable to get service instance`);
-        }
-        if (this.isConstantDependency(dependency)) {
-            return dependency.value;
-        }
-        if (this.isAdapterDependency(dependency)) {
-            if (this.singltons.has(key)) {
-                return this.singltons.get(key).value;
-            }
-            const adapter = new dependency.value(...constructor);
-            if (((_a = dependency.options) === null || _a === void 0 ? void 0 : _a.singlton) || ((_b = dependency.options) === null || _b === void 0 ? void 0 : _b.init)) {
-                this.singltons.set(key, { value: adapter, init: (_c = dependency.options) === null || _c === void 0 ? void 0 : _c.init });
-            }
-            return adapter;
-        }
-        throw new Error(`Unknown dependency type for key ${key.toString()}`);
-    }
-    async initDependencies() {
-        var _a, _b;
-        const initialized = [];
-        for await (const [key, dependency] of this.container) {
-            if (this.isAdapterDependency(dependency) && ((_a = dependency.options) === null || _a === void 0 ? void 0 : _a.init) && !this.singltons.has(key)) {
-                const instance = this.getInstance(key);
-                await (instance === null || instance === void 0 ? void 0 : instance.init());
-                initialized.push(instance);
-                this.singltons.set(key, { value: instance, init: (_b = dependency.options) === null || _b === void 0 ? void 0 : _b.init });
-            }
-        }
-        return initialized;
-    }
-}
-exports.container = new Container();
-//# sourceMappingURL=Container.js.map

package/dist/Meter.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Meter = void 0;
-const interfaces_1 = require("./interfaces");
-const opentelemetry = require("@opentelemetry/api");
-const Root_1 = require("./Root");
-class Meter extends Root_1.Root {
-    constructor(name, baggage) {
-        super();
-        this.name = name;
-        this.baggage = baggage;
-    }
-    start() {
-        const tracer = opentelemetry.trace.getTracer('');
-        this.span = tracer.startSpan(this.name, { kind: opentelemetry.SpanKind.CONSUMER }, this.getContext(this.baggage));
-    }
-    end(error) {
-        if (!this.span) {
-            return;
-        }
-        if (error) {
-            this.span.setAttribute('error', true);
-            this.span.setAttribute('error.kind', error.message);
-        }
-        this.span.end();
-    }
-    measure(func, arg, context, tag) {
-        const tracer = opentelemetry.trace.getTracer('');
-        let spanContext;
-        if (this.span) {
-            spanContext = opentelemetry.trace.setSpan(opentelemetry.context.active(), this.span);
-        }
-        const options = { kind: opentelemetry.SpanKind.INTERNAL };
-        if ((tag === null || tag === void 0 ? void 0 : tag[interfaces_1.TagKey.LOCATION]) === 'external') {
-            options.kind = opentelemetry.SpanKind.CLIENT;
-        }
-        const span = tracer.startSpan(func.name, options, spanContext);
-        this.applyTag(span, tag);
-        const result = func.apply(context, arg);
-        if (result.then) {
-            return result.then((result) => {
-                span.end();
-                return result;
-            }, (error) => {
-                span.setAttribute('error', true);
-                span.setAttribute('error.kind', error.message);
-                span.end();
-                throw error;
-            });
-        }
-        else {
-            span.end();
-        }
-        return result;
-    }
-}
-exports.Meter = Meter;
-//# sourceMappingURL=Meter.js.map

package/dist/Method.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseMethod = void 0;
-class BaseMethod {
-}
-exports.BaseMethod = BaseMethod;
-//# sourceMappingURL=Method.js.map