@rsdk/nats.transport 5.4.0-next.10

package/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [5.4.0-next.10](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.9...v5.4.0-next.10) (2024-12-03)
+
+**Note:** Version bump only for package @rsdk/nats.transport
+
+## [5.4.0-next.9](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.8...v5.4.0-next.9) (2024-12-02)
+
+**Note:** Version bump only for package @rsdk/nats.transport
+
+## [5.4.0-next.8](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.7...v5.4.0-next.8) (2024-11-28)
+
+**Note:** Version bump only for package @rsdk/nats.transport
+
+## [5.4.0-next.7](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.6...v5.4.0-next.7) (2024-11-28)
+
+**Note:** Version bump only for package @rsdk/nats.transport
+
+## [5.4.0-next.6](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.5...v5.4.0-next.6) (2024-11-28)
+
+**Note:** Version bump only for package @rsdk/nats.transport
+
+## [5.4.0-next.5](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.4...v5.4.0-next.5) (2024-11-28)
+
+**Note:** Version bump only for package @rsdk/nats.transport
+
+## [5.4.0-next.4](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.3...v5.4.0-next.4) (2024-11-27)
+
+**Note:** Version bump only for package @rsdk/nats.transport
+
+## [5.4.0-next.3](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.2...v5.4.0-next.3) (2024-11-25)
+
+**Note:** Version bump only for package @rsdk/nats.transport
+
+## [5.4.0-next.2](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.1...v5.4.0-next.2) (2024-11-25)
+
+### Features
+
+* **nats:** nats transport/kv/os + examples + docs ([#306](https://github.com/R-Vision/rsdk/issues/306)) ([de67eed](https://github.com/R-Vision/rsdk/commit/de67eed8b4cb17ec9d359067eae1e0c35d6cc736))

package/dist/events.deserializer.d.ts

@@ -0,0 +1,23 @@
+import type { IncomingEvent, IncomingRequest } from '@nestjs/microservices';
+import { IncomingRequestDeserializer } from '@nestjs/microservices/deserializers';
+import type { JsMsg } from 'nats';
+import type { EventTypeWithOptions } from './types/event-type-with-options.type';
+/**
+ * This is a custom deserializer for a Nats request.
+ * From Nats comes a buffer, which can be either a proto-buffer or just a string.
+ * The string can be a JSON value.
+ * It is necessary to take into account all the options and parse the incoming data,
+ * or return everything to the user as it is without throwing an error
+ */
+export declare class EventsDeserializer extends IncomingRequestDeserializer {
+    static logger: import("@rsdk/logging").ILogger;
+    events: Map<string, EventTypeWithOptions>;
+    deserialize(value: any, options?: Record<string, any>): IncomingRequest | IncomingEvent;
+    mapToSchema(message: JsMsg, options?: Record<string, any>): IncomingRequest | IncomingEvent;
+    /**
+     * Try to parse the incoming value. If an error, return the value as is.
+     * @param message nats message
+     * @returns parsed or original value
+     */
+    private tryParseValue;
+}

package/dist/events.deserializer.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsDeserializer = void 0;
+const deserializers_1 = require("@nestjs/microservices/deserializers");
+const core_1 = require("@rsdk/core");
+const events_common_1 = require("@rsdk/events.common");
+const logging_1 = require("@rsdk/logging");
+/**
+ * This is a custom deserializer for a Nats request.
+ * From Nats comes a buffer, which can be either a proto-buffer or just a string.
+ * The string can be a JSON value.
+ * It is necessary to take into account all the options and parse the incoming data,
+ * or return everything to the user as it is without throwing an error
+ */
+class EventsDeserializer extends deserializers_1.IncomingRequestDeserializer {
+    static logger = logging_1.LoggerFactory.create(EventsDeserializer);
+    events = new Map();
+    deserialize(value, options) {
+        return this.mapToSchema(value, options);
+    }
+    mapToSchema(message, options) {
+        try {
+            return this.tryParseValue(message);
+        }
+        catch (error) {
+            const value = message?.data ?? message;
+            // todo: если произойдет ошибка некая, то мы эту ошибку не получим на отправляющей стороне и в приложении кроме лога ничего не будет видно, эту ошибку никто не обрабатывает
+            // нужно потом найти способ чтобы ошибку эту можно было перехватить, на текущий момент просто возвращаем значение, иначе если выпасть с ошибкой эти евенты продолжат висеть в Nats
+            EventsDeserializer.logger.warn(`Error in "mapToSchema": ${error}, the original value was used: ${JSON.stringify(value)}, options: ${JSON.stringify(options)}`, {
+                error,
+            });
+            return {
+                data: value,
+                pattern: undefined,
+            };
+        }
+    }
+    /**
+     * Try to parse the incoming value. If an error, return the value as is.
+     * @param message nats message
+     * @returns parsed or original value
+     */
+    tryParseValue(message) {
+        const value = message.data ?? message;
+        if (!value) {
+            EventsDeserializer.logger.warn('Received empty value', {
+                data: message,
+                value,
+            });
+            return value;
+        }
+        const xFormatType = message.headers?.get(events_common_1.X_FORMAT_HEADER) || events_common_1.DEFAULT_PAYLOAD_FORMAT;
+        (0, events_common_1.assertIsPayloadFormat)(xFormatType);
+        const type = message.headers?.get(events_common_1.X_TYPE_HEADER);
+        const eventType = type && this.events.get(type);
+        if (type && !eventType) {
+            EventsDeserializer.logger.warn('headers.type was found, but eventType by value not found, used JSONCodec', {
+                headers: message.headers,
+                eventTypes: [...this.events.keys()],
+            });
+        }
+        const payloadIsJson = xFormatType === events_common_1.PayloadFormat.JSON;
+        if (!payloadIsJson && !eventType) {
+            throw new core_1.InputException('Event type by headers type value not found', {
+                details: {
+                    data: message,
+                    eventType,
+                },
+            });
+        }
+        const codec = payloadIsJson
+            ? new events_common_1.JSONEventCodec()
+            : new events_common_1.ProtoEventCodec(eventType?.eventType);
+        try {
+            return {
+                data: codec.decode(value),
+                pattern: eventType?.eventType,
+            };
+        }
+        catch (error) {
+            EventsDeserializer.logger.warn(`Received data in the wrong format, return raw value`, {
+                data: message,
+                error,
+                eventType,
+            });
+            return {
+                data: value,
+                pattern: eventType,
+            };
+        }
+    }
+}
+exports.EventsDeserializer = EventsDeserializer;
+//# sourceMappingURL=events.deserializer.js.map

package/dist/events.deserializer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Consume } from './metadata.decorator';
+export { NatsJetstreamTransport } from './nats-jetstream.transport';
+export { NatsJetstreamTransportOptions } from './types/nats-jetstream-transport-options.type';
+export { Payload } from './payload.decorator';

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Payload = exports.NatsJetstreamTransport = exports.Consume = void 0;
+var metadata_decorator_1 = require("./metadata.decorator");
+Object.defineProperty(exports, "Consume", { enumerable: true, get: function () { return metadata_decorator_1.Consume; } });
+var nats_jetstream_transport_1 = require("./nats-jetstream.transport");
+Object.defineProperty(exports, "NatsJetstreamTransport", { enumerable: true, get: function () { return nats_jetstream_transport_1.NatsJetstreamTransport; } });
+var payload_decorator_1 = require("./payload.decorator");
+Object.defineProperty(exports, "Payload", { enumerable: true, get: function () { return payload_decorator_1.Payload; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2DAA+C;AAAtC,6GAAA,OAAO,OAAA;AAEhB,uEAAoE;AAA3D,kIAAA,sBAAsB,OAAA;AAE/B,yDAA8C;AAArC,4GAAA,OAAO,OAAA"}

package/dist/metadata.decorator.d.ts

@@ -0,0 +1,3 @@
+import type { EventType } from '@rsdk/events.common';
+import type { ConsumeOptions } from './types/consume.options';
+export declare const Consume: <T>(eventType: EventType<T> | string, options?: ConsumeOptions) => MethodDecorator;

package/dist/metadata.decorator.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Consume = void 0;
+const common_1 = require("@nestjs/common");
+const microservices_1 = require("@nestjs/microservices");
+const nestjs_nats_jetstream_transport_1 = require("@nestjs-plugins/nestjs-nats-jetstream-transport");
+const core_1 = require("@rsdk/core");
+const metadata_1 = require("@rsdk/metadata");
+const nats_common_1 = require("@rsdk/nats.common");
+const omit_1 = __importDefault(require("lodash/omit"));
+const ConsumeMetadata = (eventType) => (target) => {
+    const rsdkMetadata = new metadata_1.RsdkMetadata(target.constructor, nats_common_1.NATS_TOPIC_RSDK_METADATA_SCOPE);
+    const alias = 'NATS_STREAM_' +
+        (eventType.$group ?? eventType)
+            .replaceAll('.', '-')
+            .toUpperCase() +
+        '_IS_MIRROR';
+    core_1.ConfigMetadataRegistry.registerProperty(target, alias, {
+        description: '',
+        expectedInEnv: true,
+        key: alias,
+        parser: new core_1.BoolParser(),
+    });
+    if (typeof eventType === 'string') {
+        rsdkMetadata.add({
+            topicName: eventType,
+        });
+        return;
+    }
+    rsdkMetadata.add({
+        eventType: (0, omit_1.default)(eventType, 'toJSON', 'encode', 'decode'),
+        group: eventType.$group,
+        partitionKeyField: eventType.$partitionKeyField,
+    });
+};
+const Consume = (eventType, options) => (0, common_1.applyDecorators)((0, microservices_1.EventPattern)({ eventType, options }, nestjs_nats_jetstream_transport_1.NATS_JETSTREAM_TRANSPORT), ConsumeMetadata(eventType));
+exports.Consume = Consume;
+//# sourceMappingURL=metadata.decorator.js.map

package/dist/metadata.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.decorator.js","sourceRoot":"","sources":["../src/metadata.decorator.ts"],"names":[],"mappings":";;;;;;AAAA,2CAAiD;AACjD,yDAAqD;AACrD,qGAA2F;AAC3F,qCAAgE;AAEhE,6CAA8C;AAC9C,mDAAmE;AACnE,uDAA+B;AAI/B,MAAM,eAAe,GACnB,CAAI,SAAgC,EAAmB,EAAE,CACzD,CAAC,MAAM,EAAE,EAAE;IACT,MAAM,YAAY,GAAG,IAAI,uBAAY,CACnC,MAAM,CAAC,WAAW,EAClB,4CAA8B,CAC/B,CAAC;IAEF,MAAM,KAAK,GACT,cAAc;QACd,CAAE,SAAuB,CAAC,MAAM,IAAI,SAAS,CAAC;aAC3C,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;aACpB,WAAW,EAAE;QAChB,YAAY,CAAC;IAEf,6BAAsB,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE;QACrD,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,IAAI;QACnB,GAAG,EAAE,KAAK;QACV,MAAM,EAAE,IAAI,iBAAU,EAAE;KACzB,CAAC,CAAC;IAEH,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,YAAY,CAAC,GAAG,CAAC;YACf,SAAS,EAAE,SAAS;SACrB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,YAAY,CAAC,GAAG,CAAC;QACf,SAAS,EAAE,IAAA,cAAI,EAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;QACxD,KAAK,EAAE,SAAS,CAAC,MAAM;QACvB,iBAAiB,EAAE,SAAS,CAAC,kBAAkB;KAChD,CAAC,CAAC;AACL,CAAC,CAAC;AAEG,MAAM,OAAO,GAAG,CACrB,SAAgC,EAChC,OAAwB,EACP,EAAE,CACnB,IAAA,wBAAe,EACb,IAAA,4BAAY,EAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,0DAAwB,CAAC,EAC9D,eAAe,CAAC,SAAS,CAAC,CAC3B,CAAC;AAPS,QAAA,OAAO,WAOhB"}

package/dist/nats-jetstream-errors.formatter.d.ts

@@ -0,0 +1,6 @@
+import type { IErrorsFormatter } from '@rsdk/core';
+export declare class NatsJetstreamErrorsFormatter implements IErrorsFormatter {
+    protocol: string;
+    match(): boolean;
+    format(ex: unknown): unknown;
+}

package/dist/nats-jetstream-errors.formatter.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsJetstreamErrorsFormatter = void 0;
+class NatsJetstreamErrorsFormatter {
+    protocol = 'nats-jetstream';
+    match() {
+        return false;
+    }
+    format(ex) {
+        return ex;
+    }
+}
+exports.NatsJetstreamErrorsFormatter = NatsJetstreamErrorsFormatter;
+//# sourceMappingURL=nats-jetstream-errors.formatter.js.map

package/dist/nats-jetstream-errors.formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-jetstream-errors.formatter.js","sourceRoot":"","sources":["../src/nats-jetstream-errors.formatter.ts"],"names":[],"mappings":";;;AAEA,MAAa,4BAA4B;IACvC,QAAQ,GAAG,gBAAgB,CAAC;IAE5B,KAAK;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,EAAW;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAVD,oEAUC"}

package/dist/nats-jetstream-transport.module.d.ts

@@ -0,0 +1,2 @@
+export declare class NatsJetstreamTransportModule {
+}

package/dist/nats-jetstream-transport.module.js

@@ -0,0 +1,17 @@
+"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.NatsJetstreamTransportModule = void 0;
+const common_1 = require("@nestjs/common");
+let NatsJetstreamTransportModule = class NatsJetstreamTransportModule {
+};
+exports.NatsJetstreamTransportModule = NatsJetstreamTransportModule;
+exports.NatsJetstreamTransportModule = NatsJetstreamTransportModule = __decorate([
+    (0, common_1.Module)({})
+], NatsJetstreamTransportModule);
+//# sourceMappingURL=nats-jetstream-transport.module.js.map

package/dist/nats-jetstream-transport.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-jetstream-transport.module.js","sourceRoot":"","sources":["../src/nats-jetstream-transport.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AAGjC,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;CAAG,CAAA;AAA/B,oEAA4B;uCAA5B,4BAA4B;IADxC,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,4BAA4B,CAAG"}

package/dist/nats-jetstream.config.d.ts

@@ -0,0 +1,5 @@
+import { Config } from '@rsdk/core';
+export declare const NatsJetstreamConfigInstance: unique symbol;
+export declare class NatsJetstreamConfig extends Config {
+    name: string;
+}

package/dist/nats-jetstream.config.js

@@ -0,0 +1,29 @@
+"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.NatsJetstreamConfig = exports.NatsJetstreamConfigInstance = void 0;
+const core_1 = require("@rsdk/core");
+exports.NatsJetstreamConfigInstance = Symbol('NatsJetstreamConfigInstance');
+let NatsJetstreamConfig = class NatsJetstreamConfig extends core_1.Config {
+    name;
+};
+exports.NatsJetstreamConfig = NatsJetstreamConfig;
+__decorate([
+    (0, core_1.Property)('NATS_JETSTREAM_NAME', new core_1.StringParser(), {
+        defaultValue: 'default',
+        description: 'NATS connection name',
+    }),
+    __metadata("design:type", String)
+], NatsJetstreamConfig.prototype, "name", void 0);
+exports.NatsJetstreamConfig = NatsJetstreamConfig = __decorate([
+    (0, core_1.ConfigSection)()
+], NatsJetstreamConfig);
+//# sourceMappingURL=nats-jetstream.config.js.map

package/dist/nats-jetstream.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-jetstream.config.js","sourceRoot":"","sources":["../src/nats-jetstream.config.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAA2E;AAE9D,QAAA,2BAA2B,GAAG,MAAM,CAC/C,6BAA6B,CAC9B,CAAC;AAGK,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,aAAM;IAK7C,IAAI,CAAU;CACf,CAAA;AANY,kDAAmB;AAK9B;IAJC,IAAA,eAAQ,EAAC,qBAAqB,EAAE,IAAI,mBAAY,EAAE,EAAE;QACnD,YAAY,EAAE,SAAS;QACvB,WAAW,EAAE,sBAAsB;KACpC,CAAC;;iDACY;8BALH,mBAAmB;IAD/B,IAAA,oBAAa,GAAE;GACH,mBAAmB,CAM/B"}

package/dist/nats-jetstream.transport.d.ts

@@ -0,0 +1,20 @@
+import type { ArgumentsHost, ExecutionContext } from '@nestjs/common';
+import type { CustomStrategy } from '@nestjs/microservices';
+import { type ConfigContext, type GenericHeaders, type IErrorsFormatter, type IErrorsTransformer, type IMicroserviceTransport, type NestModuleDefinitions } from '@rsdk/core';
+import type { NatsJetstreamTransportOptions } from './types/nats-jetstream-transport-options.type';
+export declare class NatsJetstreamTransport implements IMicroserviceTransport {
+    private readonly options?;
+    private readonly logger;
+    private servers;
+    private name;
+    constructor(options?: NatsJetstreamTransportOptions | undefined);
+    extractHeaders(ctx: ExecutionContext): GenericHeaders;
+    getProtocol(): string;
+    matchByContext(ctx: ArgumentsHost): boolean;
+    getErrorsFormatter(): IErrorsFormatter;
+    getErrorTransformers(): IErrorsTransformer[];
+    modules(): NestModuleDefinitions;
+    createMicroserviceOptions(): CustomStrategy;
+    init(configContext: ConfigContext): void;
+    onStart(): void;
+}

package/dist/nats-jetstream.transport.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsJetstreamTransport = void 0;
+const core_1 = require("@rsdk/core");
+const logging_1 = require("@rsdk/logging");
+const nats_common_1 = require("@rsdk/nats.common");
+const nats_headers_1 = require("./nats.headers");
+const nats_jetstream_config_1 = require("./nats-jetstream.config");
+const nats_jetstream_errors_formatter_1 = require("./nats-jetstream-errors.formatter");
+const nats_jetstream_transport_module_1 = require("./nats-jetstream-transport.module");
+const server_1 = require("./server");
+class NatsJetstreamTransport {
+    options;
+    logger = logging_1.LoggerFactory.create(NatsJetstreamTransport);
+    servers = [];
+    name = 'nats-jetstream-unknown';
+    constructor(options) {
+        this.options = options;
+    }
+    extractHeaders(ctx) {
+        return new nats_headers_1.NatsHeaders(ctx);
+    }
+    getProtocol() {
+        return 'nats-jetstream';
+    }
+    matchByContext(ctx) {
+        const natsCtx = ctx.getArgByIndex(1);
+        return server_1.NatsJetStreamServer.isNatsContext(natsCtx);
+    }
+    getErrorsFormatter() {
+        return new nats_jetstream_errors_formatter_1.NatsJetstreamErrorsFormatter();
+    }
+    getErrorTransformers() {
+        return [];
+    }
+    modules() {
+        return [nats_jetstream_transport_module_1.NatsJetstreamTransportModule];
+    }
+    createMicroserviceOptions() {
+        const options = {
+            ...this.options,
+            connectionOptions: {
+                ...this.options?.connectionOptions,
+                name: this.name,
+                servers: this.servers,
+            },
+            consumerOptions: {
+                ...this.options?.consumerOptions,
+            },
+            streamConfig: [],
+        };
+        this.logger.trace('createMicroserviceOptions', { options });
+        const { name } = core_1.Manifest.getData();
+        const server = new server_1.NatsJetStreamServer(options, {
+            appName: name,
+            autoUpdateConsumers: true,
+        });
+        return {
+            strategy: server,
+        };
+    }
+    init(configContext) {
+        const natsConfig = configContext.resolve(nats_common_1.DefaultNatsConfig);
+        const natsJetstreamConfig = configContext.resolve(nats_jetstream_config_1.NatsJetstreamConfig);
+        this.name = natsJetstreamConfig.name;
+        this.servers = natsConfig.servers;
+    }
+    onStart() {
+        this.logger.info(`Nats servers: ${this.servers.join(',')}`);
+    }
+}
+exports.NatsJetstreamTransport = NatsJetstreamTransport;
+//# sourceMappingURL=nats-jetstream.transport.js.map

package/dist/nats-jetstream.transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-jetstream.transport.js","sourceRoot":"","sources":["../src/nats-jetstream.transport.ts"],"names":[],"mappings":";;;AAGA,qCAQoB;AACpB,2CAA8C;AAC9C,mDAAsD;AAGtD,iDAA6C;AAC7C,mEAA8D;AAC9D,uFAAiF;AACjF,uFAAiF;AACjF,qCAA+C;AAE/C,MAAa,sBAAsB;IAKJ;IAJZ,MAAM,GAAG,uBAAa,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAC/D,OAAO,GAAa,EAAE,CAAC;IACvB,IAAI,GAAG,wBAAwB,CAAC;IAExC,YAA6B,OAAuC;QAAvC,YAAO,GAAP,OAAO,CAAgC;IAAG,CAAC;IAExE,cAAc,CAAC,GAAqB;QAClC,OAAO,IAAI,0BAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,WAAW;QACT,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,cAAc,CAAC,GAAkB;QAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAErC,OAAO,4BAAmB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,8DAA4B,EAAE,CAAC;IAC5C,CAAC;IAED,oBAAoB;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,OAAO,CAAC,8DAA4B,CAAC,CAAC;IACxC,CAAC;IAED,yBAAyB;QACvB,MAAM,OAAO,GAA+B;YAC1C,GAAG,IAAI,CAAC,OAAO;YACf,iBAAiB,EAAE;gBACjB,GAAG,IAAI,CAAC,OAAO,EAAE,iBAAiB;gBAClC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB;YACD,eAAe,EAAE;gBACf,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe;aACjC;YACD,YAAY,EAAE,EAAE;SACjB,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAE5D,MAAM,EAAE,IAAI,EAAE,GAAG,eAAQ,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,4BAAmB,CAAC,OAAO,EAAE;YAC9C,OAAO,EAAE,IAAI;YACb,mBAAmB,EAAE,IAAI;SAC1B,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,MAAM;SACjB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,aAA4B;QAC/B,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,+BAAiB,CAAC,CAAC;QAC5D,MAAM,mBAAmB,GAAG,aAAa,CAAC,OAAO,CAAC,2CAAmB,CAAC,CAAC;QAEvE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AAvED,wDAuEC"}

package/dist/nats.headers.d.ts

@@ -0,0 +1,10 @@
+import type { ExecutionContext } from '@nestjs/common';
+import type { GenericHeaders } from '@rsdk/core';
+/**
+ * @description хелпер для нормализованного извлечения заголовков из nats
+ */
+export declare class NatsHeaders implements GenericHeaders {
+    private readonly normalizedHeaders;
+    constructor(ctx: ExecutionContext);
+    get(key: string): string | undefined;
+}

package/dist/nats.headers.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsHeaders = void 0;
+const core_1 = require("@rsdk/core");
+const server_1 = require("./server");
+/**
+ * @description хелпер для нормализованного извлечения заголовков из nats
+ */
+class NatsHeaders {
+    normalizedHeaders;
+    constructor(ctx) {
+        const natsCtx = ctx.getArgByIndex(1);
+        if (!server_1.NatsJetStreamServer.isNatsContext(natsCtx)) {
+            throw new core_1.InputException('Unexpected call with non Nats ArgumentHost');
+        }
+        this.normalizedHeaders = Object.fromEntries(Object.entries(natsCtx.message.headers || {}).map(([k, v]) => [
+            Array.isArray(k)
+                ? k[0].toString().toLowerCase()
+                : k.toString().toLowerCase(),
+            v,
+        ]));
+    }
+    get(key) {
+        return this.normalizedHeaders[key.toLowerCase()];
+    }
+}
+exports.NatsHeaders = NatsHeaders;
+//# sourceMappingURL=nats.headers.js.map

package/dist/nats.headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats.headers.js","sourceRoot":"","sources":["../src/nats.headers.ts"],"names":[],"mappings":";;;AAEA,qCAA4C;AAE5C,qCAA+C;AAE/C;;GAEG;AACH,MAAa,WAAW;IACL,iBAAiB,CAAyB;IAE3D,YAAY,GAAqB;QAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAErC,IAAI,CAAC,4BAAmB,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,qBAAc,CAAC,4CAA4C,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,WAAW,CACzC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YAC5D,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBACd,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE;gBAC/B,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE;YAC9B,CAAC;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,CAAC;CACF;AAvBD,kCAuBC"}

package/dist/payload.decorator.d.ts

@@ -0,0 +1,8 @@
+type Contract<T> = {
+    decode: (bytes: Uint8Array) => T;
+    encode: (data: T) => {
+        finish: () => Uint8Array;
+    };
+};
+export declare const Payload: <T>(...dataOrPipes: (Contract<T> | import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>>)[]) => ParameterDecorator;
+export {};

package/dist/payload.decorator.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Payload = void 0;
+const common_1 = require("@nestjs/common");
+exports.Payload = (0, common_1.createParamDecorator)((contract, ctx) => {
+    const natsContext = ctx.getArgByIndex(1);
+    return contract.decode(natsContext.message.data);
+});
+//# sourceMappingURL=payload.decorator.js.map

package/dist/payload.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.decorator.js","sourceRoot":"","sources":["../src/payload.decorator.ts"],"names":[],"mappings":";;;AACA,2CAAsD;AASzC,QAAA,OAAO,GAAG,IAAA,6BAAoB,EACzC,CAAI,QAAqB,EAAE,GAAqB,EAAK,EAAE;IACrD,MAAM,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAEzC,OAAO,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC,CACF,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,136 @@
+import type { CustomTransportStrategy, MessageHandler } from '@nestjs/microservices';
+import { Server } from '@nestjs/microservices';
+import type { NatsJetStreamServerOptions } from '@nestjs-plugins/nestjs-nats-jetstream-transport';
+import { NatsJetStreamContext } from '@nestjs-plugins/nestjs-nats-jetstream-transport';
+import { EventsDeserializer } from './events.deserializer';
+/**
+ * Класс, реализующий сервер NATS JetStream.
+ */
+export declare class NatsJetStreamServer extends Server implements CustomTransportStrategy {
+    private readonly options;
+    private readonly config;
+    readonly transportId: symbol;
+    logger: import("@rsdk/logging").ILogger;
+    readonly deserializer: EventsDeserializer;
+    private nc?;
+    private jsm?;
+    private readonly streams;
+    private readonly normalizedApplicationName;
+    private readonly autoUpdateConsumers;
+    /**
+     * Конструктор класса NatsJetStreamServer.
+     * @param options - Опции для подключения к NATS JetStream.
+     * @param config - Конфигурация приложения.
+     */
+    constructor(options: NatsJetStreamServerOptions, config: {
+        appName: string;
+        autoUpdateConsumers?: boolean;
+    });
+    static isNatsContext(maybeNatsContext: unknown): maybeNatsContext is NatsJetStreamContext;
+    /**
+     * Запускает сервер и устанавливает соединение.
+     * @param callback - Функция обратного вызова для выполнения после подключения.
+     */
+    listen(callback: () => void): Promise<void>;
+    /**
+     * Закрывает соединение с сервером.
+     */
+    close(): Promise<void>;
+    /**
+     * Добавляет обработчик сообщения.
+     * @param pattern Шаблон для сообщения.
+     * @param callback Функция-обработчик сообщения.
+     * @param isEventHandler Указывает, является ли обработчик обработчиком событий.
+     * @param extras Дополнительные параметры.
+     */
+    addHandler(pattern: any, callback: MessageHandler, isEventHandler?: boolean, extras?: Record<string, any>): void;
+    /**
+     * Получает тип события из шаблона.
+     * @param pattern - Шаблон для получения типа события.
+     * @returns Тип события.
+     */
+    private getEventType;
+    /**
+     * Связывает обработчики событий.
+     */
+    private bindEventHandlers;
+    /**
+     * Группирует обработчики по типу порядка (зависимые и независимые от порядка).
+     *
+     * @param {Array<[string, MessageHandler<any, any, any>]>} eventHandlers - Список обработчиков событий,
+     * где каждый элемент представляет собой кортеж из метаданных и обработчика.
+     *
+     * @returns {{
+     *   orderedConsumers: ConsumersMap,
+     *   unorderedConsumers: ConsumersMap
+     * }}
+     * Объект, содержащий две карты:
+     * - orderedConsumers: карта с зависимыми от порядка consumer'ами.
+     * - unorderedConsumers: карта с независимыми от порядка consumer'ами.
+     */
+    private groupHandlersByOrderType;
+    /**
+     * Получает информацию о консьюмере.
+     * @param js - Клиент JetStream.
+     * @param streamName - Имя потока.
+     * @param consumerName - Имя консьюмера.
+     * @returns Информация о консьюмере.
+     */
+    private getConsumer;
+    /**
+     * Создаёт консьюмера для заданного потока.
+     * @param js - Клиент JetStream.
+     * @param consumerName - Имя консьюмера.
+     * @param consumer - Информация о консьюмере.
+     * @param options - Дополнительные параметры конфигурации консьюмера.
+     */
+    private createConsumer;
+    /**
+     * Обрабатывает сообщения из консьюмера.
+     * @param consumer - Консьюмер для обработки сообщений.
+     * @param mapping - Соответствия между типами сообщений и обработчиками.
+     * @param consumerName - Имя консьюмера.
+     */
+    private handleMessages;
+    /**
+     * Проверяет корректность подписки консьюмера.
+     * @param jsm - Менеджер JetStream.
+     * @param streamName - Имя потока.
+     * @param consumerName - Имя консьюмера.
+     * @param expectedSubjects - Ожидаемые темы.
+     * @param receivedSubjects - Полученные темы.
+     */
+    private handleCorrectness;
+    /**
+     * Связывает обработчики сообщений.
+     */
+    private bindMessageHandlers;
+    /**
+     * Настраивает поток для сервера.
+     */
+    private setupStream;
+    /**
+     * Получает имя потока для десериализатора.
+     * @param contract - Десериализатор событий.
+     * @returns Имя потока.
+     */
+    private getStreamName;
+    /**
+     * Получает имя консьюмера по десериализатору.
+     * @param contract - Десериализатор событий.
+     * @returns Имя консьюмера.
+     */
+    private getConsumerName;
+    /**
+     * Получает темы событий для десериализатора.
+     * @param contract - Десериализатор событий.
+     * @returns Темы событий.
+     */
+    private getEventSubjects;
+    /**
+     * Получает часть типа события.
+     * @param eventType - Тип события.
+     * @returns Часть типа.
+     */
+    private getTypePart;
+}