@rsdk/nats.transport 5.4.0-next.2

package/dist/server.js

@@ -0,0 +1,365 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsJetStreamServer = void 0;
+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 events_common_1 = require("@rsdk/events.common");
+const logging_1 = require("@rsdk/logging");
+const nats_common_1 = require("@rsdk/nats.common");
+const lodash_1 = require("lodash");
+const nats_1 = require("nats");
+const rxjs_1 = require("rxjs");
+const events_deserializer_1 = require("./events.deserializer");
+/**
+ * Класс, реализующий сервер NATS JetStream.
+ */
+class NatsJetStreamServer extends microservices_1.Server {
+    options;
+    config;
+    transportId = nestjs_nats_jetstream_transport_1.NATS_JETSTREAM_TRANSPORT;
+    logger = logging_1.LoggerFactory.create('NatsJetStreamServer');
+    deserializer = new events_deserializer_1.EventsDeserializer();
+    nc;
+    jsm;
+    streams = new Set();
+    normalizedApplicationName;
+    autoUpdateConsumers;
+    /**
+     * Конструктор класса NatsJetStreamServer.
+     * @param options - Опции для подключения к NATS JetStream.
+     * @param config - Конфигурация приложения.
+     */
+    constructor(options, config) {
+        super();
+        this.options = options;
+        this.config = config;
+        this.normalizedApplicationName = config.appName.replaceAll('.', '-');
+        this.autoUpdateConsumers = Boolean(config.autoUpdateConsumers);
+    }
+    static isNatsContext(maybeNatsContext) {
+        return maybeNatsContext instanceof nestjs_nats_jetstream_transport_1.NatsJetStreamContext;
+    }
+    /**
+     * Запускает сервер и устанавливает соединение.
+     * @param callback - Функция обратного вызова для выполнения после подключения.
+     */
+    async listen(callback) {
+        if (!this.nc) {
+            this.nc = await (0, nats_1.connect)(this.options.connectionOptions);
+            this.options.connectionOptions.connectedHook?.(this.nc);
+        }
+        this.jsm = await this.nc.jetstreamManager(this.options.jetStreamOptions);
+        await this.bindEventHandlers();
+        this.bindMessageHandlers();
+        callback();
+    }
+    /**
+     * Закрывает соединение с сервером.
+     */
+    async close() {
+        await this.nc?.drain();
+        delete this.nc;
+    }
+    /**
+     * Добавляет обработчик сообщения.
+     * @param pattern Шаблон для сообщения.
+     * @param callback Функция-обработчик сообщения.
+     * @param isEventHandler Указывает, является ли обработчик обработчиком событий.
+     * @param extras Дополнительные параметры.
+     */
+    addHandler(pattern, callback, isEventHandler = false, extras = {}) {
+        const eventType = this.getEventType(pattern);
+        let formattedPattern;
+        if ((0, events_common_1.isEventType)(eventType)) {
+            this.streams.add(this.getStreamName(pattern));
+            formattedPattern = eventType.$type;
+            this.deserializer.events.set(formattedPattern, pattern);
+        }
+        else if (typeof eventType === 'string') {
+            formattedPattern = eventType;
+            this.streams.add(eventType);
+        }
+        super.addHandler(formattedPattern, callback, isEventHandler, extras);
+    }
+    /**
+     * Получает тип события из шаблона.
+     * @param pattern - Шаблон для получения типа события.
+     * @returns Тип события.
+     */
+    getEventType(pattern) {
+        return typeof pattern === 'object' && 'eventType' in pattern
+            ? pattern.eventType
+            : pattern;
+    }
+    /**
+     * Связывает обработчики событий.
+     */
+    async bindEventHandlers() {
+        const eventHandlers = [...this.messageHandlers.entries()].filter(([, handler]) => handler.isEventHandler);
+        if (!this.nc) {
+            throw new core_1.InternalException('Connection must be established');
+        }
+        const js = this.nc.jetstream(this.options.jetStreamOptions);
+        const { orderedConsumers, unorderedConsumers } = this.groupHandlersByOrderType(eventHandlers);
+        for (const [consumerName, consumer] of orderedConsumers) {
+            await this.createConsumer(js, consumerName, consumer, {
+                max_ack_pending: 1,
+            });
+        }
+        for (const [consumerName, consumer] of unorderedConsumers) {
+            await this.createConsumer(js, consumerName, consumer, {});
+        }
+    }
+    /**
+     * Группирует обработчики по типу порядка (зависимые и независимые от порядка).
+     *
+     * @param {Array<[string, MessageHandler<any, any, any>]>} eventHandlers - Список обработчиков событий,
+     * где каждый элемент представляет собой кортеж из метаданных и обработчика.
+     *
+     * @returns {{
+     *   orderedConsumers: ConsumersMap,
+     *   unorderedConsumers: ConsumersMap
+     * }}
+     * Объект, содержащий две карты:
+     * - orderedConsumers: карта с зависимыми от порядка consumer'ами.
+     * - unorderedConsumers: карта с независимыми от порядка consumer'ами.
+     */
+    groupHandlersByOrderType(eventHandlers) {
+        const orderedConsumers = new Map();
+        const unorderedConsumers = new Map();
+        for (const [meta, handler] of eventHandlers) {
+            const deserializer = this.deserializer.events.get(meta);
+            const consumerName = this.getConsumerName(deserializer);
+            const streamName = this.getStreamName(deserializer);
+            const targetMap = deserializer.options?.maxAckPending
+                ? orderedConsumers
+                : unorderedConsumers;
+            const aggregatedConsumer = targetMap.get(consumerName) ?? {
+                streamName,
+                mapping: new Map(),
+            };
+            aggregatedConsumer.mapping.set(this.getTypePart(deserializer.eventType), {
+                deserializer,
+                handler,
+            });
+            targetMap.set(consumerName, aggregatedConsumer);
+        }
+        return { orderedConsumers, unorderedConsumers };
+    }
+    /**
+     * Получает информацию о консьюмере.
+     * @param js - Клиент JetStream.
+     * @param streamName - Имя потока.
+     * @param consumerName - Имя консьюмера.
+     * @returns Информация о консьюмере.
+     */
+    async getConsumer(js, streamName, consumerName) {
+        return js.consumers.get(streamName, consumerName);
+    }
+    /**
+     * Создаёт консьюмера для заданного потока.
+     * @param js - Клиент JetStream.
+     * @param consumerName - Имя консьюмера.
+     * @param consumer - Информация о консьюмере.
+     * @param options - Дополнительные параметры конфигурации консьюмера.
+     */
+    async createConsumer(js, consumerName, { streamName, mapping }, options) {
+        try {
+            await js.streams.get(streamName);
+            this.logger.trace('Stream %s found', { streamName });
+        }
+        catch (error) {
+            this.logger.error('Stream %s not found', { streamName });
+            throw new core_1.InternalException(`Stream not found: ${streamName}`, {
+                cause: error,
+            });
+        }
+        const jsm = await js.jetstreamManager();
+        const expectedSubjects = [...mapping.values()].flatMap((e) => this.getEventSubjects(e.deserializer));
+        const consumer = (await this.getConsumer(js, streamName, consumerName).catch(() => null)) ??
+            (await jsm.consumers
+                .add(streamName, {
+                ...options,
+                durable_name: consumerName,
+                filter_subjects: expectedSubjects,
+            })
+                .then(() => this.getConsumer(js, streamName, consumerName)));
+        const info = await consumer.info();
+        const receivedSubjects = info.config.filter_subjects;
+        await this.handleCorrectness(jsm, streamName, consumerName, expectedSubjects, receivedSubjects);
+        this.handleMessages(consumer, mapping, consumerName);
+    }
+    /**
+     * Обрабатывает сообщения из консьюмера.
+     * @param consumer - Консьюмер для обработки сообщений.
+     * @param mapping - Соответствия между типами сообщений и обработчиками.
+     * @param consumerName - Имя консьюмера.
+     */
+    async handleMessages(consumer, mapping, consumerName) {
+        const msgs = await consumer.consume();
+        /**
+         * Слушаем все сообщения консьюмера
+         * @type {Promise<void>}
+         */
+        const done = (async () => {
+            for await (const msg of msgs) {
+                try {
+                    const data = this.deserializer.deserialize(msg);
+                    const context = new nestjs_nats_jetstream_transport_1.NatsJetStreamContext([msg]);
+                    const contract = mapping.get(this.getTypePart(data.pattern));
+                    if (!contract) {
+                        throw new core_1.NotFoundException(`Unknown ${events_common_1.X_TYPE_HEADER} header`);
+                    }
+                    const resultOrStream = await contract.handler(data, context);
+                    if ((0, rxjs_1.isObservable)(resultOrStream)) {
+                        const connectableSource = (0, rxjs_1.connectable)(resultOrStream, {
+                            connector: () => new rxjs_1.Subject(),
+                            resetOnDisconnect: false,
+                        });
+                        connectableSource.connect();
+                    }
+                }
+                catch (error) {
+                    this.logger.error(error.message, error.stack);
+                    // specifies that you failed to process the server and instructs
+                    // the server to not send it again (to any consumer)
+                    msg.term();
+                    continue;
+                }
+                /**
+                 * Потенциально мы можем сюда придти если в одном консюьмере несколько сервисов
+                 * Это не совсем корректное поведение потому что неясно есть ли такой обработчик, а мы можем встрять и ни разу не двинуть оффсет
+                 */
+                msg.nak();
+                this.logger.warn('Unhandled message: ', { msg });
+            }
+        })();
+        done.then(() => {
+            if (this.nc?.isDraining() || this.nc?.isClosed()) {
+                return;
+            }
+            this.logger.debug(`Unsubscribed ${consumerName}`);
+        });
+    }
+    /**
+     * Проверяет корректность подписки консьюмера.
+     * @param jsm - Менеджер JetStream.
+     * @param streamName - Имя потока.
+     * @param consumerName - Имя консьюмера.
+     * @param expectedSubjects - Ожидаемые темы.
+     * @param receivedSubjects - Полученные темы.
+     */
+    async handleCorrectness(jsm, streamName, consumerName, expectedSubjects, receivedSubjects) {
+        if ((0, lodash_1.isEqual)(receivedSubjects, expectedSubjects)) {
+            return;
+        }
+        if (!this.autoUpdateConsumers) {
+            throw new core_1.InternalException('Incorrect subjects', {
+                cause: {
+                    expectedSubjects,
+                    receivedSubjects,
+                },
+            });
+        }
+        await jsm.consumers.update(streamName, consumerName, {
+            filter_subjects: expectedSubjects,
+        });
+    }
+    /**
+     * Связывает обработчики сообщений.
+     */
+    bindMessageHandlers() {
+        const messageHandlers = [...this.messageHandlers.entries()].filter(([, handler]) => !handler.isEventHandler);
+        for (const [subject, messageHandler] of messageHandlers) {
+            const subscriptionOptions = {
+                callback: async (err, msg) => {
+                    if (err) {
+                        this.logger.error(err.message, err);
+                        return;
+                    }
+                    const payload = this.deserializer.deserialize(msg);
+                    const context = new nestjs_nats_jetstream_transport_1.NatsContext([msg]);
+                    const response$ = this.transformToObservable(messageHandler(payload.data, context));
+                    this.send(response$, (response) => msg.respond(response));
+                },
+            };
+            this.nc?.subscribe(subject, subscriptionOptions);
+            this.logger.debug(`Subscribed to ${subject} messages`);
+        }
+    }
+    /**
+     * Настраивает поток для сервера.
+     */
+    async setupStream() {
+        const { streamConfig } = this.options;
+        const streams = await this.jsm?.streams.list().next();
+        const reqStreamConfigs = Array.isArray(streamConfig)
+            ? streamConfig
+            : [streamConfig];
+        for (const requiredStreamConfig of reqStreamConfigs) {
+            if (!requiredStreamConfig) {
+                continue;
+            }
+            const stream = streams?.find((stream) => stream.config.name === requiredStreamConfig?.name);
+            if (stream) {
+                const streamSubjects = new Set([
+                    ...stream.config.subjects,
+                    ...(requiredStreamConfig?.subjects ?? []),
+                ]);
+                const streamInfo = await this.jsm?.streams.update(stream.config.name, {
+                    ...stream.config,
+                    ...requiredStreamConfig,
+                    subjects: [...streamSubjects.keys()],
+                });
+                this.logger.info(`Stream ${streamInfo?.config.name} updated`);
+            }
+            else {
+                const streamInfo = await this.jsm?.streams.add(requiredStreamConfig);
+                this.logger.info(`Stream ${streamInfo?.config.name} created`);
+            }
+        }
+    }
+    /**
+     * Получает имя потока для десериализатора.
+     * @param contract - Десериализатор событий.
+     * @returns Имя потока.
+     */
+    getStreamName(contract) {
+        return contract.options?.streamName ?? (0, nats_common_1.getStreamName)(contract.eventType);
+    }
+    /**
+     * Получает имя консьюмера по десериализатору.
+     * @param contract - Десериализатор событий.
+     * @returns Имя консьюмера.
+     */
+    getConsumerName(contract) {
+        const arr = [
+            this.normalizedApplicationName,
+            this.getStreamName(contract),
+            'consumer',
+        ];
+        if (contract.options?.consumerName) {
+            arr.unshift(contract.options.consumerName);
+        }
+        return arr.join('-');
+    }
+    /**
+     * Получает темы событий для десериализатора.
+     * @param contract - Десериализатор событий.
+     * @returns Темы событий.
+     */
+    getEventSubjects(contract) {
+        return contract.options?.subjects ?? [];
+    }
+    /**
+     * Получает часть типа события.
+     * @param eventType - Тип события.
+     * @returns Часть типа.
+     */
+    getTypePart(eventType) {
+        return (typeof eventType === 'string' ? eventType : eventType.$type).replaceAll('.', '-');
+    }
+}
+exports.NatsJetStreamServer = NatsJetStreamServer;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/types/consume.options.d.ts

@@ -0,0 +1,6 @@
+export type ConsumeOptions = {
+    streamName?: string;
+    subjects?: string[];
+    maxAckPending?: number;
+    consumerName?: string;
+};

package/dist/types/consume.options.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=consume.options.js.map

package/dist/types/consume.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consume.options.js","sourceRoot":"","sources":["../../src/types/consume.options.ts"],"names":[],"mappings":""}

package/dist/types/consumer-info.type.d.ts

@@ -0,0 +1,5 @@
+import type { Mapping } from './mapping.type';
+export type ConsumerInfo = {
+    streamName: string;
+    mapping: Mapping;
+};

package/dist/types/consumer-info.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=consumer-info.type.js.map

package/dist/types/consumer-info.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-info.type.js","sourceRoot":"","sources":["../../src/types/consumer-info.type.ts"],"names":[],"mappings":""}

package/dist/types/consumers-map.type.d.ts

@@ -0,0 +1,2 @@
+import type { ConsumerInfo } from './consumer-info.type';
+export type ConsumersMap = Map<string, ConsumerInfo>;

package/dist/types/consumers-map.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=consumers-map.type.js.map

package/dist/types/consumers-map.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumers-map.type.js","sourceRoot":"","sources":["../../src/types/consumers-map.type.ts"],"names":[],"mappings":""}

package/dist/types/event-type-with-options.type.d.ts

@@ -0,0 +1,6 @@
+import type { EventType } from '@rsdk/events.common';
+import type { ConsumeOptions } from './consume.options';
+export type EventTypeWithOptions = {
+    eventType: EventType;
+    options?: ConsumeOptions;
+};

package/dist/types/event-type-with-options.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=event-type-with-options.type.js.map

package/dist/types/event-type-with-options.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-type-with-options.type.js","sourceRoot":"","sources":["../../src/types/event-type-with-options.type.ts"],"names":[],"mappings":""}

package/dist/types/mapping.type.d.ts

@@ -0,0 +1,6 @@
+import type { MessageHandler } from '@nestjs/microservices';
+import type { EventTypeWithOptions } from './event-type-with-options.type';
+export type Mapping = Map<string, {
+    deserializer: EventTypeWithOptions;
+    handler: MessageHandler;
+}>;

package/dist/types/mapping.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mapping.type.js.map

package/dist/types/mapping.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.type.js","sourceRoot":"","sources":["../../src/types/mapping.type.ts"],"names":[],"mappings":""}

package/dist/types/nats-jetstream-transport-options.type.d.ts

@@ -0,0 +1,2 @@
+import type { NatsJetStreamServerOptions } from '@nestjs-plugins/nestjs-nats-jetstream-transport';
+export type NatsJetstreamTransportOptions = Partial<NatsJetStreamServerOptions>;

package/dist/types/nats-jetstream-transport-options.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=nats-jetstream-transport-options.type.js.map

package/dist/types/nats-jetstream-transport-options.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-jetstream-transport-options.type.js","sourceRoot":"","sources":["../../src/types/nats-jetstream-transport-options.type.ts"],"names":[],"mappings":""}

package/jest.config.js

@@ -0,0 +1 @@
+module.exports = require('@rsdk/jest/jest.config');

package/jest.config.unit.js

@@ -0,0 +1 @@
+module.exports = require('@rsdk/jest/jest.config.unit');

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@rsdk/nats.transport",
+  "version": "5.4.0-next.2",
+  "description": "Nats NestJS Transport",
+  "main": "dist/index.js",
+  "license": "Apache License 2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "url": "https://github.com/R-Vision/rsdk"
+  },
+  "dependencies": {
+    "@nestjs-plugins/nestjs-nats-jetstream-transport": "^2.2.6",
+    "lodash": "^4.17.21",
+    "nats": "^2.28.0",
+    "typescript": "^5.3.2"
+  },
+  "peerDependencies": {
+    "@grpc/grpc-js": "^1.10.9",
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/config": "^3.2.3",
+    "@nestjs/core": "^10.0.0",
+    "@nestjs/microservices": "^10.0.0",
+    "@opentelemetry/api": "1.9.0",
+    "@rsdk/actx": "*",
+    "@rsdk/autodoc.protocol": "*",
+    "@rsdk/common": "*",
+    "@rsdk/common.nestjs": "*",
+    "@rsdk/common.node": "*",
+    "@rsdk/core": "*",
+    "@rsdk/decorators": "*",
+    "@rsdk/events.common": "*",
+    "@rsdk/logging": "*",
+    "@rsdk/metadata": "*",
+    "@rsdk/nats.common": "*",
+    "@rsdk/nest-tools": "*",
+    "reflect-metadata": "^0.1.12 || ^0.2.0",
+    "rxjs": "^7.8.1"
+  },
+  "nx": {},
+  "gitHead": "be4deac03b38b3f923a08116e1dc2b55838905b0"
+}

package/src/events.deserializer.ts

@@ -0,0 +1,133 @@
+import type { IncomingEvent, IncomingRequest } from '@nestjs/microservices';
+import { IncomingRequestDeserializer } from '@nestjs/microservices/deserializers';
+import { InputException } from '@rsdk/core';
+import {
+  assertIsPayloadFormat,
+  DEFAULT_PAYLOAD_FORMAT,
+  JSONEventCodec,
+  PayloadFormat,
+  ProtoEventCodec,
+  X_FORMAT_HEADER,
+  X_TYPE_HEADER,
+} from '@rsdk/events.common';
+import { LoggerFactory } from '@rsdk/logging';
+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 class EventsDeserializer extends IncomingRequestDeserializer {
+  static logger = LoggerFactory.create(EventsDeserializer);
+
+  events: Map<string, EventTypeWithOptions> = new Map();
+
+  override deserialize(
+    value: any,
+    options?: Record<string, any>,
+  ): IncomingRequest | IncomingEvent {
+    return this.mapToSchema(value, options);
+  }
+
+  override mapToSchema(
+    message: JsMsg,
+    options?: Record<string, any>,
+  ): IncomingRequest | IncomingEvent {
+    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
+   */
+  private tryParseValue(message: JsMsg): IncomingRequest | IncomingEvent {
+    const value = message.data ?? message;
+
+    if (!value) {
+      EventsDeserializer.logger.warn('Received empty value', {
+        data: message,
+        value,
+      });
+      return value;
+    }
+
+    const xFormatType =
+      message.headers?.get(X_FORMAT_HEADER) || DEFAULT_PAYLOAD_FORMAT;
+
+    assertIsPayloadFormat(xFormatType);
+
+    const type = message.headers?.get(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 === PayloadFormat.JSON;
+    if (!payloadIsJson && !eventType) {
+      throw new InputException('Event type by headers type value not found', {
+        details: {
+          data: message,
+          eventType,
+        },
+      });
+    }
+
+    const codec = payloadIsJson
+      ? new JSONEventCodec<any>()
+      : new ProtoEventCodec(
+          (eventType as EventTypeWithOptions | undefined)?.eventType as any,
+        );
+
+    try {
+      return {
+        data: codec.decode(value as Buffer),
+        pattern: (eventType as EventTypeWithOptions | undefined)?.eventType,
+      };
+    } catch (error) {
+      EventsDeserializer.logger.warn(
+        `Received data in the wrong format, return raw value`,
+        {
+          data: message,
+          error,
+          eventType,
+        },
+      );
+      return {
+        data: value,
+        pattern: eventType,
+      };
+    }
+  }
+}