@rsdk/nats.common 5.3.0-next.4

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [5.3.0-next.4](https://github.com/R-Vision/rsdk/compare/v5.3.0-next.3...v5.3.0-next.4) (2024-11-05)
+
+### Features
+
+* **nats.producer:** direct nats producer alpha implementation ([#301](https://github.com/R-Vision/rsdk/issues/301)) ([d173b51](https://github.com/R-Vision/rsdk/commit/d173b51c664c718a214cdc695708cfdd40fc4dcb))

package/dist/client/client.config.d.ts

@@ -0,0 +1,6 @@
+import { Config } from '@rsdk/core';
+export declare const NatsConfigInstance: unique symbol;
+export declare class DefaultNatsConfig extends Config {
+    servers: string[];
+    debug: boolean;
+}

package/dist/client/client.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.DefaultNatsConfig = exports.NatsConfigInstance = void 0;
+const core_1 = require("@rsdk/core");
+exports.NatsConfigInstance = Symbol('NatsConfigInstance');
+let DefaultNatsConfig = class DefaultNatsConfig extends core_1.Config {
+    servers;
+    debug;
+};
+exports.DefaultNatsConfig = DefaultNatsConfig;
+__decorate([
+    (0, core_1.Property)('NATS_SERVERS', new core_1.ArrayParser(new core_1.StringParser()), {
+        description: 'NATS server URLs',
+    }),
+    __metadata("design:type", Array)
+], DefaultNatsConfig.prototype, "servers", void 0);
+__decorate([
+    (0, core_1.Property)('NATS_DEBUG', new core_1.BoolParser(), {
+        defaultValue: false,
+        description: 'Enable NATS debug',
+    }),
+    __metadata("design:type", Boolean)
+], DefaultNatsConfig.prototype, "debug", void 0);
+exports.DefaultNatsConfig = DefaultNatsConfig = __decorate([
+    (0, core_1.ConfigSection)()
+], DefaultNatsConfig);
+//# sourceMappingURL=client.config.js.map

package/dist/client/client.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.config.js","sourceRoot":"","sources":["../../src/client/client.config.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAOoB;AAEP,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAGxD,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,aAAM;IAI3C,OAAO,CAAY;IAMnB,KAAK,CAAW;CACjB,CAAA;AAXY,8CAAiB;AAI5B;IAHC,IAAA,eAAQ,EAAC,cAAc,EAAE,IAAI,kBAAW,CAAC,IAAI,mBAAY,EAAE,CAAC,EAAE;QAC7D,WAAW,EAAE,kBAAkB;KAChC,CAAC;;kDACiB;AAMnB;IAJC,IAAA,eAAQ,EAAC,YAAY,EAAE,IAAI,iBAAU,EAAE,EAAE;QACxC,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,mBAAmB;KACjC,CAAC;;gDACc;4BAVL,iBAAiB;IAD7B,IAAA,oBAAa,GAAE;GACH,iBAAiB,CAW7B"}

package/dist/client/client.constants.d.ts

@@ -0,0 +1,2 @@
+export declare const NATS_CLIENT_INJECTION_TOKEN: unique symbol;
+export declare const NATS_PRODUCER_INJECTION_TOKEN: unique symbol;

package/dist/client/client.constants.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NATS_PRODUCER_INJECTION_TOKEN = exports.NATS_CLIENT_INJECTION_TOKEN = void 0;
+exports.NATS_CLIENT_INJECTION_TOKEN = Symbol('NatsClient');
+exports.NATS_PRODUCER_INJECTION_TOKEN = Symbol('NatsProducer');
+//# sourceMappingURL=client.constants.js.map

package/dist/client/client.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.constants.js","sourceRoot":"","sources":["../../src/client/client.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,2BAA2B,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AACnD,QAAA,6BAA6B,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC"}

package/dist/client/client.decorators.d.ts

@@ -0,0 +1,2 @@
+export declare const InjectNatsClient: () => ParameterDecorator;
+export declare const InjectNatsProducer: () => ParameterDecorator;

package/dist/client/client.decorators.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectNatsProducer = exports.InjectNatsClient = void 0;
+const common_1 = require("@nestjs/common");
+const client_constants_1 = require("./client.constants");
+const InjectNatsClient = () => (0, common_1.Inject)(client_constants_1.NATS_CLIENT_INJECTION_TOKEN);
+exports.InjectNatsClient = InjectNatsClient;
+const InjectNatsProducer = () => (0, common_1.Inject)(client_constants_1.NATS_PRODUCER_INJECTION_TOKEN);
+exports.InjectNatsProducer = InjectNatsProducer;
+//# sourceMappingURL=client.decorators.js.map

package/dist/client/client.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.decorators.js","sourceRoot":"","sources":["../../src/client/client.decorators.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAExC,yDAG4B;AAErB,MAAM,gBAAgB,GAAG,GAAuB,EAAE,CACvD,IAAA,eAAM,EAAC,8CAA2B,CAAC,CAAC;AADzB,QAAA,gBAAgB,oBACS;AAE/B,MAAM,kBAAkB,GAAG,GAAuB,EAAE,CACzD,IAAA,eAAM,EAAC,gDAA6B,CAAC,CAAC;AAD3B,QAAA,kBAAkB,sBACS"}

package/dist/client/client.metadata.d.ts

@@ -0,0 +1,21 @@
+import type { EventType } from '../event.type';
+export declare enum TopicType {
+    PRODUCE = 0
+}
+/**
+ * TODO: Здесь надо разбираться с неймингом. Потому что хрен
+ * поймёшь сейчас, что это за типы
+ */
+export type NatsTopicMetadataByTopic = {
+    type: TopicType;
+    topicName: string;
+};
+export type NatsTopicMetadataByEventType = {
+    type: TopicType;
+    topicName: string;
+    group: string;
+    partitionKeyField: string | null;
+    eventType?: Pick<EventType, '$type' | '$group' | '$partitionKeyField'>;
+};
+export type NatsTopicMetadata = NatsTopicMetadataByEventType | NatsTopicMetadataByTopic;
+export declare const NATS_TOPIC_RSDK_METADATA_SCOPE = "nats-stream";

package/dist/client/client.metadata.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NATS_TOPIC_RSDK_METADATA_SCOPE = exports.TopicType = void 0;
+var TopicType;
+(function (TopicType) {
+    // CONSUME,
+    TopicType[TopicType["PRODUCE"] = 0] = "PRODUCE";
+})(TopicType || (exports.TopicType = TopicType = {}));
+exports.NATS_TOPIC_RSDK_METADATA_SCOPE = 'nats-stream';
+//# sourceMappingURL=client.metadata.js.map

package/dist/client/client.metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.metadata.js","sourceRoot":"","sources":["../../src/client/client.metadata.ts"],"names":[],"mappings":";;;AAEA,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,WAAW;IACX,+CAAO,CAAA;AACT,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAwBY,QAAA,8BAA8B,GAAG,aAAa,CAAC"}

package/dist/client/client.module.d.ts

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

package/dist/client/client.module.js

@@ -0,0 +1,27 @@
+"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.NatsClientModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@rsdk/core");
+const client_config_1 = require("./client.config");
+const client_provider_1 = require("./client.provider");
+const producer_provider_1 = require("./producer.provider");
+const topics_service_1 = require("./topics.service");
+let NatsClientModule = class NatsClientModule {
+};
+exports.NatsClientModule = NatsClientModule;
+exports.NatsClientModule = NatsClientModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        imports: [core_1.PlatformConfigModule.forFeature(client_config_1.DefaultNatsConfig)],
+        providers: [producer_provider_1.natsProducerProvider, client_provider_1.natsProvider, topics_service_1.TopicsService],
+        exports: [producer_provider_1.natsProducerProvider, client_provider_1.natsProvider, topics_service_1.TopicsService],
+    })
+], NatsClientModule);
+//# sourceMappingURL=client.module.js.map

package/dist/client/client.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.module.js","sourceRoot":"","sources":["../../src/client/client.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,qCAAkD;AAElD,mDAAoD;AACpD,uDAAiD;AACjD,2DAA2D;AAC3D,qDAAiD;AAQ1C,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAAG,CAAA;AAAnB,4CAAgB;2BAAhB,gBAAgB;IAN5B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,2BAAoB,CAAC,UAAU,CAAC,iCAAiB,CAAC,CAAC;QAC7D,SAAS,EAAE,CAAC,wCAAoB,EAAE,8BAAY,EAAE,8BAAa,CAAC;QAC9D,OAAO,EAAE,CAAC,wCAAoB,EAAE,8BAAY,EAAE,8BAAa,CAAC;KAC7D,CAAC;GACW,gBAAgB,CAAG"}

package/dist/client/client.provider.d.ts

@@ -0,0 +1,2 @@
+import type { FactoryProvider } from '@nestjs/common';
+export declare const natsProvider: FactoryProvider;

package/dist/client/client.provider.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.natsProvider = void 0;
+const core_1 = require("@rsdk/core");
+const nats_1 = require("nats");
+const client_config_1 = require("./client.config");
+const client_constants_1 = require("./client.constants");
+exports.natsProvider = {
+    inject: [client_config_1.DefaultNatsConfig, core_1.APP_NAME],
+    provide: client_constants_1.NATS_CLIENT_INJECTION_TOKEN,
+    async useFactory(config, name) {
+        return await (0, nats_1.connect)({
+            name: `${name}-${process.pid}`,
+            ...config,
+        });
+    },
+};
+//# sourceMappingURL=client.provider.js.map

package/dist/client/client.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.provider.js","sourceRoot":"","sources":["../../src/client/client.provider.ts"],"names":[],"mappings":";;;AACA,qCAAsC;AAEtC,+BAA+B;AAE/B,mDAAoD;AACpD,yDAAiE;AAEpD,QAAA,YAAY,GAAoB;IAC3C,MAAM,EAAE,CAAC,iCAAiB,EAAE,eAAQ,CAAC;IACrC,OAAO,EAAE,8CAA2B;IACpC,KAAK,CAAC,UAAU,CACd,MAAyB,EACzB,IAAY;QAEZ,OAAO,MAAM,IAAA,cAAO,EAAC;YACnB,IAAI,EAAE,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE;YAC9B,GAAG,MAAM;SACV,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/client/producer.provider.d.ts

@@ -0,0 +1,4 @@
+import type { FactoryProvider } from '@nestjs/common';
+import type { JetStreamClient } from 'nats';
+export type Producer = JetStreamClient;
+export declare const natsProducerProvider: FactoryProvider;

package/dist/client/producer.provider.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.natsProducerProvider = void 0;
+const client_constants_1 = require("./client.constants");
+exports.natsProducerProvider = {
+    inject: [client_constants_1.NATS_CLIENT_INJECTION_TOKEN],
+    provide: client_constants_1.NATS_PRODUCER_INJECTION_TOKEN,
+    async useFactory(client) {
+        return client.jetstream();
+    },
+};
+//# sourceMappingURL=producer.provider.js.map

package/dist/client/producer.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"producer.provider.js","sourceRoot":"","sources":["../../src/client/producer.provider.ts"],"names":[],"mappings":";;;AAGA,yDAG4B;AAIf,QAAA,oBAAoB,GAAoB;IACnD,MAAM,EAAE,CAAC,8CAA2B,CAAC;IACrC,OAAO,EAAE,gDAA6B;IACtC,KAAK,CAAC,UAAU,CAAC,MAAsB;QACrC,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC;IAC5B,CAAC;CACF,CAAC"}

package/dist/client/topics.service.d.ts

@@ -0,0 +1,8 @@
+import { RsdkMetadataProvider } from '@rsdk/metadata';
+import type { TopicType } from './client.metadata';
+export declare class TopicsService {
+    private readonly provider;
+    constructor(provider: RsdkMetadataProvider);
+    getTopics(type: TopicType): string[];
+    private getResources;
+}

package/dist/client/topics.service.js

@@ -0,0 +1,35 @@
+"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.TopicsService = void 0;
+const common_1 = require("@nestjs/common");
+const metadata_1 = require("@rsdk/metadata");
+const client_metadata_1 = require("./client.metadata");
+let TopicsService = class TopicsService {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    getTopics(type) {
+        return this.getResources()
+            .filter(({ value }) => value.type === type)
+            .map(({ value }) => value.topicName);
+    }
+    getResources() {
+        return this.provider.get(client_metadata_1.NATS_TOPIC_RSDK_METADATA_SCOPE);
+    }
+};
+exports.TopicsService = TopicsService;
+exports.TopicsService = TopicsService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [metadata_1.RsdkMetadataProvider])
+], TopicsService);
+//# sourceMappingURL=topics.service.js.map

package/dist/client/topics.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topics.service.js","sourceRoot":"","sources":["../../src/client/topics.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAE5C,6CAAsD;AAGtD,uDAAmE;AAG5D,IAAM,aAAa,GAAnB,MAAM,aAAa;IACK;IAA7B,YAA6B,QAA8B;QAA9B,aAAQ,GAAR,QAAQ,CAAsB;IAAG,CAAC;IAE/D,SAAS,CAAC,IAAe;QACvB,OAAO,IAAI,CAAC,YAAY,EAAE;aACvB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;aAC1C,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAEO,YAAY;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAoB,gDAA8B,CAAC,CAAC;IAC9E,CAAC;CACF,CAAA;AAZY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;qCAE4B,+BAAoB;GADhD,aAAa,CAYzB"}

package/dist/event.codec.d.ts

@@ -0,0 +1,22 @@
+import type { Payload } from 'nats';
+import type { EventPayload, EventType } from './event.type';
+export interface EventCodec<E extends EventType> {
+    decode<P extends EventPayload<E> = EventPayload<E>>(payload: Payload): P;
+    encode<P extends EventPayload<E> = EventPayload<E>>(payload: P): Payload;
+}
+/**
+ * Protobuf-encoding strategy
+ */
+export declare class ProtoEventCodec<E extends EventType> implements EventCodec<E> {
+    readonly eventType: E;
+    constructor(eventType: E);
+    decode<P extends EventPayload<E>>(buffer: Buffer): P;
+    encode<P extends EventPayload<E>>(payload: P): Buffer;
+}
+/**
+ * JSON-encoding strategy
+ */
+export declare class JSONEventCodec<E extends EventType> implements EventCodec<E> {
+    decode<P extends EventPayload<E>>(payload: string): P;
+    encode<P extends EventPayload<E>>(payload: P): Payload;
+}

package/dist/event.codec.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSONEventCodec = exports.ProtoEventCodec = void 0;
+/**
+ * Protobuf-encoding strategy
+ */
+class ProtoEventCodec {
+    eventType;
+    constructor(eventType) {
+        this.eventType = eventType;
+    }
+    decode(buffer) {
+        return this.eventType.decode(buffer);
+    }
+    encode(payload) {
+        return Buffer.from(this.eventType.encode(payload).finish());
+    }
+}
+exports.ProtoEventCodec = ProtoEventCodec;
+/**
+ * JSON-encoding strategy
+ */
+class JSONEventCodec {
+    decode(payload) {
+        return JSON.parse(payload);
+    }
+    encode(payload) {
+        return JSON.stringify(payload);
+    }
+}
+exports.JSONEventCodec = JSONEventCodec;
+//# sourceMappingURL=event.codec.js.map

package/dist/event.codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.codec.js","sourceRoot":"","sources":["../src/event.codec.ts"],"names":[],"mappings":";;;AAUA;;GAEG;AACH,MAAa,eAAe;IACL;IAArB,YAAqB,SAAY;QAAZ,cAAS,GAAT,SAAS,CAAG;IAAG,CAAC;IAErC,MAAM,CAA4B,MAAc;QAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAA4B,OAAU;QAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AAVD,0CAUC;AAED;;GAEG;AACH,MAAa,cAAc;IACzB,MAAM,CAA4B,OAAe;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAA4B,OAAU;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;CACF;AARD,wCAQC"}

package/dist/event.type.d.ts

@@ -0,0 +1,23 @@
+import type { Reader, Writer } from 'protobufjs/minimal';
+/**
+ * Генерируется при компиляции proto-файлов
+ */
+export interface EventType<T = any> {
+    $group: string;
+    $partitionKeyField: string | null;
+    $type: string;
+    encode(message: T): Writer;
+    decode(data: Uint8Array | Reader): T;
+}
+/**
+ * Выводит тип payload из EventType
+ */
+export type EventPayload<E extends EventType> = E extends EventType<infer P> ? P : never;
+/**
+ * Проверяет, является ли переданный тип EventType
+ */
+export declare const isEventType: <T = any>(x: any) => x is EventType<T>;
+/**
+ * Генерирует имя subject из EventType
+ */
+export declare const getSubjectName: (eventType: EventType, partitionKey?: string) => string;

package/dist/event.type.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSubjectName = exports.isEventType = void 0;
+/**
+ * Проверяет, является ли переданный тип EventType
+ */
+const isEventType = (x) => typeof x === 'object' &&
+    typeof x.$type === 'string' &&
+    typeof x.$group === 'string';
+exports.isEventType = isEventType;
+/**
+ * Генерирует имя subject из EventType
+ */
+const getSubjectName = (eventType, partitionKey) => {
+    return `events.${eventType.$type}${partitionKey ? `.${partitionKey}` : ''}`;
+};
+exports.getSubjectName = getSubjectName;
+//# sourceMappingURL=event.type.js.map

package/dist/event.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.type.js","sourceRoot":"","sources":["../src/event.type.ts"],"names":[],"mappings":";;;AAqBA;;GAEG;AACI,MAAM,WAAW,GAAG,CAAU,CAAM,EAAqB,EAAE,CAChE,OAAO,CAAC,KAAK,QAAQ;IACrB,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;IAC3B,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;AAHlB,QAAA,WAAW,eAGO;AAE/B;;GAEG;AACI,MAAM,cAAc,GAAG,CAC5B,SAAoB,EACpB,YAAqB,EACb,EAAE;IACV,OAAO,UAAU,SAAS,CAAC,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC9E,CAAC,CAAC;AALW,QAAA,cAAc,kBAKzB"}

package/dist/exceptions/exception.handler.d.ts

@@ -0,0 +1 @@
+export declare const handleNatsException: (error: unknown, pattern: string, details?: unknown) => never;

package/dist/exceptions/exception.handler.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleNatsException = void 0;
+const unknown_nats_exception_1 = require("./unknown-nats.exception");
+const handleNatsException = (error, pattern, details) => {
+    throw new unknown_nats_exception_1.UnknownNatsException(error, pattern, details);
+};
+exports.handleNatsException = handleNatsException;
+//# sourceMappingURL=exception.handler.js.map

package/dist/exceptions/exception.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.handler.js","sourceRoot":"","sources":["../../src/exceptions/exception.handler.ts"],"names":[],"mappings":";;;AAAA,qEAAgE;AAEzD,MAAM,mBAAmB,GAAG,CACjC,KAAc,EACd,OAAe,EACf,OAAiB,EACV,EAAE;IACT,MAAM,IAAI,6CAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC,CAAC;AANW,QAAA,mBAAmB,uBAM9B"}

package/dist/exceptions/missing-topics.exception.d.ts

@@ -0,0 +1,6 @@
+import type { ExceptionsProps } from '@rsdk/core';
+import { InternalException } from '@rsdk/core';
+export declare class MissingStreamOrSubjectException extends InternalException {
+    readonly topics: string[];
+    constructor(topics: string[], props?: ExceptionsProps);
+}

package/dist/exceptions/missing-topics.exception.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingStreamOrSubjectException = void 0;
+const core_1 = require("@rsdk/core");
+class MissingStreamOrSubjectException extends core_1.InternalException {
+    topics;
+    constructor(topics, props = {}) {
+        super('Expected stream or subject not found', {
+            ...props,
+            details: {
+                ...props.details,
+                topics,
+            },
+        });
+        this.topics = topics;
+    }
+}
+exports.MissingStreamOrSubjectException = MissingStreamOrSubjectException;
+//# sourceMappingURL=missing-topics.exception.js.map

package/dist/exceptions/missing-topics.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-topics.exception.js","sourceRoot":"","sources":["../../src/exceptions/missing-topics.exception.ts"],"names":[],"mappings":";;;AACA,qCAA+C;AAE/C,MAAa,+BAAgC,SAAQ,wBAAiB;IAEzD;IADX,YACW,MAAgB,EACzB,QAAyB,EAAE;QAE3B,KAAK,CAAC,sCAAsC,EAAE;YAC5C,GAAG,KAAK;YACR,OAAO,EAAE;gBACP,GAAG,KAAK,CAAC,OAAO;gBAChB,MAAM;aACP;SACF,CAAC,CAAC;QATM,WAAM,GAAN,MAAM,CAAU;IAU3B,CAAC;CACF;AAbD,0EAaC"}

package/dist/exceptions/payload-format.exception.d.ts

@@ -0,0 +1,5 @@
+import type { EnumValue } from '@rsdk/common';
+import { BootstrapException } from '@rsdk/core';
+export declare class PayloadFormatException extends BootstrapException {
+    constructor(value: string, allowed: EnumValue[]);
+}

package/dist/exceptions/payload-format.exception.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PayloadFormatException = void 0;
+const core_1 = require("@rsdk/core");
+class PayloadFormatException extends core_1.BootstrapException {
+    constructor(value, allowed) {
+        super(`PayloadFormat has wrong value: ${value}, allowed: ${allowed.join(',')}`);
+    }
+}
+exports.PayloadFormatException = PayloadFormatException;
+//# sourceMappingURL=payload-format.exception.js.map

package/dist/exceptions/payload-format.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-format.exception.js","sourceRoot":"","sources":["../../src/exceptions/payload-format.exception.ts"],"names":[],"mappings":";;;AACA,qCAAgD;AAEhD,MAAa,sBAAuB,SAAQ,yBAAkB;IAC5D,YAAY,KAAa,EAAE,OAAoB;QAC7C,KAAK,CACH,kCAAkC,KAAK,cAAc,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;CACF;AAND,wDAMC"}

package/dist/exceptions/unknown-nats.exception.d.ts

@@ -0,0 +1,4 @@
+import { InternalException } from '@rsdk/core';
+export declare class UnknownNatsException extends InternalException {
+    constructor(cause: unknown, pattern: string, details?: unknown);
+}

package/dist/exceptions/unknown-nats.exception.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnknownNatsException = void 0;
+const core_1 = require("@rsdk/core");
+class UnknownNatsException extends core_1.InternalException {
+    constructor(cause, pattern, details) {
+        super('Unknown exception from Nats Server', {
+            details: {
+                pattern,
+                details: details,
+            },
+            cause,
+        });
+    }
+}
+exports.UnknownNatsException = UnknownNatsException;
+//# sourceMappingURL=unknown-nats.exception.js.map

package/dist/exceptions/unknown-nats.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-nats.exception.js","sourceRoot":"","sources":["../../src/exceptions/unknown-nats.exception.ts"],"names":[],"mappings":";;;AAAA,qCAA+C;AAE/C,MAAa,oBAAqB,SAAQ,wBAAiB;IACzD,YAAY,KAAc,EAAE,OAAe,EAAE,OAAiB;QAC5D,KAAK,CAAC,oCAAoC,EAAE;YAC1C,OAAO,EAAE;gBACP,OAAO;gBACP,OAAO,EAAE,OAAO;aACjB;YACD,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF;AAVD,oDAUC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { EventType, EventPayload, isEventType, getSubjectName, } from './event.type';
+export { EventCodec, ProtoEventCodec, JSONEventCodec } from './event.codec';
+export { PayloadFormat, DEFAULT_PAYLOAD_FORMAT, X_FORMAT_HEADER, X_TYPE_HEADER, } from './payload.format';
+export { NatsTopicMetadata, NatsTopicMetadataByEventType, NatsTopicMetadataByTopic, TopicType, NATS_TOPIC_RSDK_METADATA_SCOPE, } from './client/client.metadata';
+export { NATS_CLIENT_INJECTION_TOKEN, NATS_PRODUCER_INJECTION_TOKEN, } from './client/client.constants';
+export type { Producer } from './client/producer.provider';
+export { NatsClientModule } from './client/client.module';
+export { handleNatsException } from './exceptions/exception.handler';

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleNatsException = exports.NatsClientModule = exports.NATS_PRODUCER_INJECTION_TOKEN = exports.NATS_CLIENT_INJECTION_TOKEN = exports.NATS_TOPIC_RSDK_METADATA_SCOPE = exports.TopicType = exports.X_TYPE_HEADER = exports.X_FORMAT_HEADER = exports.DEFAULT_PAYLOAD_FORMAT = exports.PayloadFormat = exports.JSONEventCodec = exports.ProtoEventCodec = exports.getSubjectName = exports.isEventType = void 0;
+var event_type_1 = require("./event.type");
+Object.defineProperty(exports, "isEventType", { enumerable: true, get: function () { return event_type_1.isEventType; } });
+Object.defineProperty(exports, "getSubjectName", { enumerable: true, get: function () { return event_type_1.getSubjectName; } });
+var event_codec_1 = require("./event.codec");
+Object.defineProperty(exports, "ProtoEventCodec", { enumerable: true, get: function () { return event_codec_1.ProtoEventCodec; } });
+Object.defineProperty(exports, "JSONEventCodec", { enumerable: true, get: function () { return event_codec_1.JSONEventCodec; } });
+var payload_format_1 = require("./payload.format");
+Object.defineProperty(exports, "PayloadFormat", { enumerable: true, get: function () { return payload_format_1.PayloadFormat; } });
+Object.defineProperty(exports, "DEFAULT_PAYLOAD_FORMAT", { enumerable: true, get: function () { return payload_format_1.DEFAULT_PAYLOAD_FORMAT; } });
+Object.defineProperty(exports, "X_FORMAT_HEADER", { enumerable: true, get: function () { return payload_format_1.X_FORMAT_HEADER; } });
+Object.defineProperty(exports, "X_TYPE_HEADER", { enumerable: true, get: function () { return payload_format_1.X_TYPE_HEADER; } });
+var client_metadata_1 = require("./client/client.metadata");
+Object.defineProperty(exports, "TopicType", { enumerable: true, get: function () { return client_metadata_1.TopicType; } });
+Object.defineProperty(exports, "NATS_TOPIC_RSDK_METADATA_SCOPE", { enumerable: true, get: function () { return client_metadata_1.NATS_TOPIC_RSDK_METADATA_SCOPE; } });
+var client_constants_1 = require("./client/client.constants");
+Object.defineProperty(exports, "NATS_CLIENT_INJECTION_TOKEN", { enumerable: true, get: function () { return client_constants_1.NATS_CLIENT_INJECTION_TOKEN; } });
+Object.defineProperty(exports, "NATS_PRODUCER_INJECTION_TOKEN", { enumerable: true, get: function () { return client_constants_1.NATS_PRODUCER_INJECTION_TOKEN; } });
+var client_module_1 = require("./client/client.module");
+Object.defineProperty(exports, "NatsClientModule", { enumerable: true, get: function () { return client_module_1.NatsClientModule; } });
+var exception_handler_1 = require("./exceptions/exception.handler");
+Object.defineProperty(exports, "handleNatsException", { enumerable: true, get: function () { return exception_handler_1.handleNatsException; } });
+//# 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,2CAKsB;AAFpB,yGAAA,WAAW,OAAA;AACX,4GAAA,cAAc,OAAA;AAEhB,6CAA4E;AAAvD,8GAAA,eAAe,OAAA;AAAE,6GAAA,cAAc,OAAA;AACpD,mDAK0B;AAJxB,+GAAA,aAAa,OAAA;AACb,wHAAA,sBAAsB,OAAA;AACtB,iHAAA,eAAe,OAAA;AACf,+GAAA,aAAa,OAAA;AAEf,4DAMkC;AAFhC,4GAAA,SAAS,OAAA;AACT,iIAAA,8BAA8B,OAAA;AAEhC,8DAGmC;AAFjC,+HAAA,2BAA2B,OAAA;AAC3B,iIAAA,6BAA6B,OAAA;AAG/B,wDAA0D;AAAjD,iHAAA,gBAAgB,OAAA;AACzB,oEAAqE;AAA5D,wHAAA,mBAAmB,OAAA"}

package/dist/payload.format.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Способ сериализации данных события
+ */
+export declare enum PayloadFormat {
+    PROTOBUF = "protobuf",
+    JSON = "json"
+}
+/**
+ * Проверяет, является ли переданная строка - одним
+ * из значений перечисления PayloadFormat
+ */
+export declare const isPayloadFormat: (value: string) => value is PayloadFormat;
+/**
+ * Проверяет, является ли переданная строка - одним
+ * из значений перечисления PayloadFormat. В случае,
+ * если передано неверное значение - бросает ошибку
+ */
+export declare const assertIsPayloadFormat: (value: string) => asserts value is PayloadFormat;
+/**
+ * Заголовок в kafka, через который передаётся способ
+ * сериализации
+ */
+export declare const X_FORMAT_HEADER = "X-Format";
+/**
+ * Сериализация по умолчанию (protobuf)
+ */
+export declare const DEFAULT_PAYLOAD_FORMAT = PayloadFormat.PROTOBUF;
+/**
+ * Заголовок в nats, через который передаётся тип сообщения
+ */
+export declare const X_TYPE_HEADER = "X-Type";

package/dist/payload.format.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X_TYPE_HEADER = exports.DEFAULT_PAYLOAD_FORMAT = exports.X_FORMAT_HEADER = exports.assertIsPayloadFormat = exports.isPayloadFormat = exports.PayloadFormat = void 0;
+const common_1 = require("@rsdk/common");
+const payload_format_exception_1 = require("./exceptions/payload-format.exception");
+/**
+ * Способ сериализации данных события
+ */
+var PayloadFormat;
+(function (PayloadFormat) {
+    PayloadFormat["PROTOBUF"] = "protobuf";
+    PayloadFormat["JSON"] = "json";
+})(PayloadFormat || (exports.PayloadFormat = PayloadFormat = {}));
+const allowed = common_1.Enum.values(PayloadFormat);
+/**
+ * Проверяет, является ли переданная строка - одним
+ * из значений перечисления PayloadFormat
+ */
+const isPayloadFormat = (value) => allowed.includes(value);
+exports.isPayloadFormat = isPayloadFormat;
+/**
+ * Проверяет, является ли переданная строка - одним
+ * из значений перечисления PayloadFormat. В случае,
+ * если передано неверное значение - бросает ошибку
+ */
+const assertIsPayloadFormat = (value) => {
+    if ((0, exports.isPayloadFormat)(value)) {
+        return;
+    }
+    throw new payload_format_exception_1.PayloadFormatException(value, allowed);
+};
+exports.assertIsPayloadFormat = assertIsPayloadFormat;
+/**
+ * Заголовок в kafka, через который передаётся способ
+ * сериализации
+ */
+exports.X_FORMAT_HEADER = 'X-Format';
+/**
+ * Сериализация по умолчанию (protobuf)
+ */
+exports.DEFAULT_PAYLOAD_FORMAT = PayloadFormat.PROTOBUF;
+/**
+ * Заголовок в nats, через который передаётся тип сообщения
+ */
+exports.X_TYPE_HEADER = 'X-Type';
+//# sourceMappingURL=payload.format.js.map

package/dist/payload.format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.format.js","sourceRoot":"","sources":["../src/payload.format.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AAEpC,oFAA+E;AAE/E;;GAEG;AACH,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,8BAAa,CAAA;AACf,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB;AAED,MAAM,OAAO,GAAG,aAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AAE3C;;;GAGG;AACI,MAAM,eAAe,GAAG,CAAC,KAAa,EAA0B,EAAE,CACvE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AADb,QAAA,eAAe,mBACF;AAE1B;;;;GAIG;AACI,MAAM,qBAAqB,GAAG,CACnC,KAAa,EACmB,EAAE;IAClC,IAAI,IAAA,uBAAe,EAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,iDAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC,CAAC;AARW,QAAA,qBAAqB,yBAQhC;AAEF;;;GAGG;AACU,QAAA,eAAe,GAAG,UAAU,CAAC;AAE1C;;GAEG;AACU,QAAA,sBAAsB,GAAG,aAAa,CAAC,QAAQ,CAAC;AAE7D;;GAEG;AACU,QAAA,aAAa,GAAG,QAAQ,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@rsdk/nats.common",
+  "version": "5.3.0-next.4",
+  "description": "Common functionality for nats consumers and producers",
+  "license": "Apache License 2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "url": "https://github.com/R-Vision/rsdk"
+  },
+  "main": "dist/index.js",
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "@nestjs/microservices": "^10.0.0",
+    "@rsdk/common": "*",
+    "@rsdk/core": "*",
+    "@rsdk/logging": "*",
+    "@rsdk/metadata": "*",
+    "nats": "^2.28.2",
+    "reflect-metadata": "^0.1.12 || ^0.2.0",
+    "rxjs": "^7.8.1"
+  },
+  "dependencies": {
+    "lodash": "^4.17.21",
+    "protobufjs": "^7.2.3"
+  },
+  "gitHead": "6d80aacd87b9cc36cfcff8c0c050e4fe31810276"
+}

package/src/client/client.config.ts

@@ -0,0 +1,24 @@
+import {
+  ArrayParser,
+  BoolParser,
+  Config,
+  ConfigSection,
+  Property,
+  StringParser,
+} from '@rsdk/core';
+
+export const NatsConfigInstance = Symbol('NatsConfigInstance');
+
+@ConfigSection()
+export class DefaultNatsConfig extends Config {
+  @Property('NATS_SERVERS', new ArrayParser(new StringParser()), {
+    description: 'NATS server URLs',
+  })
+  servers!: string[];
+
+  @Property('NATS_DEBUG', new BoolParser(), {
+    defaultValue: false,
+    description: 'Enable NATS debug',
+  })
+  debug!: boolean;
+}

package/src/client/client.constants.ts

@@ -0,0 +1,2 @@
+export const NATS_CLIENT_INJECTION_TOKEN = Symbol('NatsClient');
+export const NATS_PRODUCER_INJECTION_TOKEN = Symbol('NatsProducer');

package/src/client/client.decorators.ts

@@ -0,0 +1,12 @@
+import { Inject } from '@nestjs/common';
+
+import {
+  NATS_CLIENT_INJECTION_TOKEN,
+  NATS_PRODUCER_INJECTION_TOKEN,
+} from './client.constants';
+
+export const InjectNatsClient = (): ParameterDecorator =>
+  Inject(NATS_CLIENT_INJECTION_TOKEN);
+
+export const InjectNatsProducer = (): ParameterDecorator =>
+  Inject(NATS_PRODUCER_INJECTION_TOKEN);

package/src/client/client.metadata.ts

@@ -0,0 +1,30 @@
+import type { EventType } from '../event.type';
+
+export enum TopicType {
+  // CONSUME,
+  PRODUCE,
+}
+
+/**
+ * TODO: Здесь надо разбираться с неймингом. Потому что хрен
+ * поймёшь сейчас, что это за типы
+ */
+
+export type NatsTopicMetadataByTopic = {
+  type: TopicType;
+  topicName: string;
+};
+
+export type NatsTopicMetadataByEventType = {
+  type: TopicType;
+  topicName: string;
+  group: string;
+  partitionKeyField: string | null;
+  eventType?: Pick<EventType, '$type' | '$group' | '$partitionKeyField'>;
+};
+
+export type NatsTopicMetadata =
+  | NatsTopicMetadataByEventType
+  | NatsTopicMetadataByTopic;
+
+export const NATS_TOPIC_RSDK_METADATA_SCOPE = 'nats-stream';

package/src/client/client.module.ts

@@ -0,0 +1,15 @@
+import { Global, Module } from '@nestjs/common';
+import { PlatformConfigModule } from '@rsdk/core';
+
+import { DefaultNatsConfig } from './client.config';
+import { natsProvider } from './client.provider';
+import { natsProducerProvider } from './producer.provider';
+import { TopicsService } from './topics.service';
+
+@Global()
+@Module({
+  imports: [PlatformConfigModule.forFeature(DefaultNatsConfig)],
+  providers: [natsProducerProvider, natsProvider, TopicsService],
+  exports: [natsProducerProvider, natsProvider, TopicsService],
+})
+export class NatsClientModule {}

package/src/client/client.provider.ts

@@ -0,0 +1,21 @@
+import type { FactoryProvider } from '@nestjs/common';
+import { APP_NAME } from '@rsdk/core';
+import type { NatsConnection } from 'nats';
+import { connect } from 'nats';
+
+import { DefaultNatsConfig } from './client.config';
+import { NATS_CLIENT_INJECTION_TOKEN } from './client.constants';
+
+export const natsProvider: FactoryProvider = {
+  inject: [DefaultNatsConfig, APP_NAME],
+  provide: NATS_CLIENT_INJECTION_TOKEN,
+  async useFactory(
+    config: DefaultNatsConfig,
+    name: string,
+  ): Promise<NatsConnection> {
+    return await connect({
+      name: `${name}-${process.pid}`,
+      ...config,
+    });
+  },
+};

package/src/client/producer.provider.ts

@@ -0,0 +1,17 @@
+import type { FactoryProvider } from '@nestjs/common';
+import type { JetStreamClient, NatsConnection } from 'nats';
+
+import {
+  NATS_CLIENT_INJECTION_TOKEN,
+  NATS_PRODUCER_INJECTION_TOKEN,
+} from './client.constants';
+
+export type Producer = JetStreamClient;
+
+export const natsProducerProvider: FactoryProvider = {
+  inject: [NATS_CLIENT_INJECTION_TOKEN],
+  provide: NATS_PRODUCER_INJECTION_TOKEN,
+  async useFactory(client: NatsConnection): Promise<Producer> {
+    return client.jetstream();
+  },
+};

package/src/client/topics.service.ts

@@ -0,0 +1,21 @@
+import { Injectable } from '@nestjs/common';
+import type { Resource } from '@rsdk/metadata';
+import { RsdkMetadataProvider } from '@rsdk/metadata';
+
+import type { NatsTopicMetadata, TopicType } from './client.metadata';
+import { NATS_TOPIC_RSDK_METADATA_SCOPE } from './client.metadata';
+
+@Injectable()
+export class TopicsService {
+  constructor(private readonly provider: RsdkMetadataProvider) {}
+
+  getTopics(type: TopicType): string[] {
+    return this.getResources()
+      .filter(({ value }) => value.type === type)
+      .map(({ value }) => value.topicName);
+  }
+
+  private getResources(): Resource<NatsTopicMetadata>[] {
+    return this.provider.get<NatsTopicMetadata>(NATS_TOPIC_RSDK_METADATA_SCOPE);
+  }
+}

package/src/event.codec.ts

@@ -0,0 +1,37 @@
+import type { Payload } from 'nats';
+
+import type { EventPayload, EventType } from './event.type';
+
+export interface EventCodec<E extends EventType> {
+  decode<P extends EventPayload<E> = EventPayload<E>>(payload: Payload): P;
+
+  encode<P extends EventPayload<E> = EventPayload<E>>(payload: P): Payload;
+}
+
+/**
+ * Protobuf-encoding strategy
+ */
+export class ProtoEventCodec<E extends EventType> implements EventCodec<E> {
+  constructor(readonly eventType: E) {}
+
+  decode<P extends EventPayload<E>>(buffer: Buffer): P {
+    return this.eventType.decode(buffer);
+  }
+
+  encode<P extends EventPayload<E>>(payload: P): Buffer {
+    return Buffer.from(this.eventType.encode(payload).finish());
+  }
+}
+
+/**
+ * JSON-encoding strategy
+ */
+export class JSONEventCodec<E extends EventType> implements EventCodec<E> {
+  decode<P extends EventPayload<E>>(payload: string): P {
+    return JSON.parse(payload);
+  }
+
+  encode<P extends EventPayload<E>>(payload: P): Payload {
+    return JSON.stringify(payload);
+  }
+}

package/src/event.type.ts

@@ -0,0 +1,38 @@
+import type { Reader, Writer } from 'protobufjs/minimal';
+
+/**
+ * Генерируется при компиляции proto-файлов
+ */
+export interface EventType<T = any> {
+  $group: string;
+  $partitionKeyField: string | null;
+  $type: string;
+
+  encode(message: T): Writer;
+
+  decode(data: Uint8Array | Reader): T;
+}
+
+/**
+ * Выводит тип payload из EventType
+ */
+export type EventPayload<E extends EventType> =
+  E extends EventType<infer P> ? P : never;
+
+/**
+ * Проверяет, является ли переданный тип EventType
+ */
+export const isEventType = <T = any>(x: any): x is EventType<T> =>
+  typeof x === 'object' &&
+  typeof x.$type === 'string' &&
+  typeof x.$group === 'string';
+
+/**
+ * Генерирует имя subject из EventType
+ */
+export const getSubjectName = (
+  eventType: EventType,
+  partitionKey?: string,
+): string => {
+  return `events.${eventType.$type}${partitionKey ? `.${partitionKey}` : ''}`;
+};

package/src/exceptions/exception.handler.ts

@@ -0,0 +1,9 @@
+import { UnknownNatsException } from './unknown-nats.exception';
+
+export const handleNatsException = (
+  error: unknown,
+  pattern: string,
+  details?: unknown,
+): never => {
+  throw new UnknownNatsException(error, pattern, details);
+};

package/src/exceptions/missing-topics.exception.ts

@@ -0,0 +1,17 @@
+import type { ExceptionsProps } from '@rsdk/core';
+import { InternalException } from '@rsdk/core';
+
+export class MissingStreamOrSubjectException extends InternalException {
+  constructor(
+    readonly topics: string[],
+    props: ExceptionsProps = {},
+  ) {
+    super('Expected stream or subject not found', {
+      ...props,
+      details: {
+        ...props.details,
+        topics,
+      },
+    });
+  }
+}

package/src/exceptions/payload-format.exception.ts

@@ -0,0 +1,10 @@
+import type { EnumValue } from '@rsdk/common';
+import { BootstrapException } from '@rsdk/core';
+
+export class PayloadFormatException extends BootstrapException {
+  constructor(value: string, allowed: EnumValue[]) {
+    super(
+      `PayloadFormat has wrong value: ${value}, allowed: ${allowed.join(',')}`,
+    );
+  }
+}

package/src/exceptions/unknown-nats.exception.ts

@@ -0,0 +1,13 @@
+import { InternalException } from '@rsdk/core';
+
+export class UnknownNatsException extends InternalException {
+  constructor(cause: unknown, pattern: string, details?: unknown) {
+    super('Unknown exception from Nats Server', {
+      details: {
+        pattern,
+        details: details,
+      },
+      cause,
+    });
+  }
+}

package/src/index.ts

@@ -0,0 +1,27 @@
+export {
+  EventType,
+  EventPayload,
+  isEventType,
+  getSubjectName,
+} from './event.type';
+export { EventCodec, ProtoEventCodec, JSONEventCodec } from './event.codec';
+export {
+  PayloadFormat,
+  DEFAULT_PAYLOAD_FORMAT,
+  X_FORMAT_HEADER,
+  X_TYPE_HEADER,
+} from './payload.format';
+export {
+  NatsTopicMetadata,
+  NatsTopicMetadataByEventType,
+  NatsTopicMetadataByTopic,
+  TopicType,
+  NATS_TOPIC_RSDK_METADATA_SCOPE,
+} from './client/client.metadata';
+export {
+  NATS_CLIENT_INJECTION_TOKEN,
+  NATS_PRODUCER_INJECTION_TOKEN,
+} from './client/client.constants';
+export type { Producer } from './client/producer.provider';
+export { NatsClientModule } from './client/client.module';
+export { handleNatsException } from './exceptions/exception.handler';

package/src/payload.format.ts

@@ -0,0 +1,51 @@
+import { Enum } from '@rsdk/common';
+
+import { PayloadFormatException } from './exceptions/payload-format.exception';
+
+/**
+ * Способ сериализации данных события
+ */
+export enum PayloadFormat {
+  PROTOBUF = 'protobuf',
+  JSON = 'json',
+}
+
+const allowed = Enum.values(PayloadFormat);
+
+/**
+ * Проверяет, является ли переданная строка - одним
+ * из значений перечисления PayloadFormat
+ */
+export const isPayloadFormat = (value: string): value is PayloadFormat =>
+  allowed.includes(value);
+
+/**
+ * Проверяет, является ли переданная строка - одним
+ * из значений перечисления PayloadFormat. В случае,
+ * если передано неверное значение - бросает ошибку
+ */
+export const assertIsPayloadFormat = (
+  value: string,
+): asserts value is PayloadFormat => {
+  if (isPayloadFormat(value)) {
+    return;
+  }
+
+  throw new PayloadFormatException(value, allowed);
+};
+
+/**
+ * Заголовок в kafka, через который передаётся способ
+ * сериализации
+ */
+export const X_FORMAT_HEADER = 'X-Format';
+
+/**
+ * Сериализация по умолчанию (protobuf)
+ */
+export const DEFAULT_PAYLOAD_FORMAT = PayloadFormat.PROTOBUF;
+
+/**
+ * Заголовок в nats, через который передаётся тип сообщения
+ */
+export const X_TYPE_HEADER = 'X-Type';

package/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": [
+    "node_modules",
+    "dist",
+    "test",
+    "**/*.spec.ts",
+    "**/*.test.ts",
+    "**/*.test.e2e.ts",
+    "**/*.test.manual-e2e.ts",
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "@rsdk/tsconfig/base.json",
+  "compilerOptions": {
+    "declaration": true,
+    "outDir": "dist"
+  }
+}