@opra/nestjs-kafka 1.11.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Panates
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# OPRA
+
+Open Protocol for Restful Api

package/cjs/constants.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPRA_KAFKA_MODULE_CONFIG = void 0;
+exports.OPRA_KAFKA_MODULE_CONFIG = 'OPRA_KAFKA_MODULE_CONFIG';

package/cjs/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Public = exports.OpraNestUtils = exports.IS_PUBLIC_KEY = void 0;
+const tslib_1 = require("tslib");
+const nestjs_1 = require("@opra/nestjs");
+Object.defineProperty(exports, "IS_PUBLIC_KEY", { enumerable: true, get: function () { return nestjs_1.IS_PUBLIC_KEY; } });
+Object.defineProperty(exports, "OpraNestUtils", { enumerable: true, get: function () { return nestjs_1.OpraNestUtils; } });
+Object.defineProperty(exports, "Public", { enumerable: true, get: function () { return nestjs_1.Public; } });
+tslib_1.__exportStar(require("./constants.js"), exports);
+tslib_1.__exportStar(require("./opra-kafka.module.js"), exports);

package/cjs/opra-kafka-core.module.js

@@ -0,0 +1,137 @@
+"use strict";
+var OpraKafkaCoreModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpraKafkaCoreModule = void 0;
+const tslib_1 = require("tslib");
+const objects_1 = require("@jsopen/objects");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const common_2 = require("@opra/common");
+const kafka_1 = require("@opra/kafka");
+const nestjs_1 = require("@opra/nestjs");
+const constants_js_1 = require("./constants.js");
+const opraKafkaNestjsAdapterToken = Symbol('OpraKafkaNestjsAdapter');
+let OpraKafkaCoreModule = OpraKafkaCoreModule_1 = class OpraKafkaCoreModule {
+    constructor(controllerFactory, adapter, config) {
+        this.controllerFactory = controllerFactory;
+        this.adapter = adapter;
+        this.config = config;
+    }
+    static forRoot(moduleOptions) {
+        return this._getDynamicModule({
+            ...moduleOptions,
+            providers: [
+                ...(moduleOptions?.providers || []),
+                {
+                    provide: constants_js_1.OPRA_KAFKA_MODULE_CONFIG,
+                    useValue: {
+                        ...moduleOptions,
+                        logger: moduleOptions.logger || new common_1.Logger(moduleOptions.name),
+                    },
+                },
+            ],
+        });
+    }
+    static forRootAsync(moduleOptions) {
+        if (!moduleOptions.useFactory)
+            throw new Error('Invalid configuration. Must provide "useFactory"');
+        return this._getDynamicModule({
+            ...moduleOptions,
+            providers: [
+                ...(moduleOptions?.providers || []),
+                {
+                    provide: constants_js_1.OPRA_KAFKA_MODULE_CONFIG,
+                    inject: moduleOptions.inject,
+                    useFactory: async (...args) => {
+                        const result = await moduleOptions.useFactory(...args);
+                        result.logger = result.logger || new common_1.Logger(result.name);
+                        return result;
+                    },
+                },
+            ],
+        });
+    }
+    static _getDynamicModule(moduleOptions) {
+        const token = moduleOptions.id || kafka_1.KafkaAdapter;
+        const adapterProvider = {
+            provide: token,
+            inject: [nestjs_1.RpcControllerFactory, core_1.ModuleRef, constants_js_1.OPRA_KAFKA_MODULE_CONFIG],
+            useFactory: async (controllerFactory, moduleRef, config) => {
+                const controllers = controllerFactory
+                    .exploreControllers()
+                    .map(x => x.wrapper.instance.constructor);
+                const document = await common_2.ApiDocumentFactory.createDocument({
+                    info: config.info,
+                    types: config.types,
+                    references: config.references,
+                    api: {
+                        name: config.name,
+                        description: config.description,
+                        transport: 'rpc',
+                        platform: kafka_1.KafkaAdapter.PlatformName,
+                        controllers,
+                    },
+                });
+                const interceptors = moduleOptions.interceptors
+                    ? moduleOptions.interceptors.map(x => {
+                        if ((0, objects_1.isConstructor)(x)) {
+                            return async (ctx, next) => {
+                                const interceptor = moduleRef.get(x);
+                                if (typeof interceptor.intercept === 'function')
+                                    return interceptor.intercept(ctx, next);
+                            };
+                        }
+                        return x;
+                    })
+                    : undefined;
+                return new kafka_1.KafkaAdapter(document, { ...config, interceptors });
+            },
+        };
+        return {
+            global: moduleOptions.global,
+            module: OpraKafkaCoreModule_1,
+            controllers: moduleOptions.controllers,
+            providers: [
+                ...(moduleOptions?.providers || []),
+                nestjs_1.RpcControllerFactory,
+                adapterProvider,
+                {
+                    provide: opraKafkaNestjsAdapterToken,
+                    useExisting: token,
+                },
+            ],
+            imports: [...(moduleOptions?.imports || [])],
+            exports: [...(moduleOptions?.exports || []), adapterProvider],
+        };
+    }
+    onModuleInit() {
+        /** NestJS initialize controller instances on init stage.
+         * So we should update instance properties */
+        const rpcApi = this.adapter.document.rpcApi;
+        const controllers = Array.from(rpcApi.controllers.values());
+        for (const { wrapper } of this.controllerFactory
+            .exploreControllers()
+            .values()) {
+            const ctor = wrapper.instance.constructor;
+            const controller = controllers.find(x => x.ctor === ctor);
+            if (controller) {
+                controller.instance = wrapper.instance;
+            }
+        }
+    }
+    async onApplicationBootstrap() {
+        await this.adapter.start();
+    }
+    async onApplicationShutdown() {
+        await this.adapter.close();
+    }
+};
+exports.OpraKafkaCoreModule = OpraKafkaCoreModule;
+exports.OpraKafkaCoreModule = OpraKafkaCoreModule = OpraKafkaCoreModule_1 = tslib_1.__decorate([
+    (0, common_1.Module)({}),
+    (0, common_1.Global)(),
+    tslib_1.__param(1, (0, common_1.Inject)(opraKafkaNestjsAdapterToken)),
+    tslib_1.__param(2, (0, common_1.Inject)(constants_js_1.OPRA_KAFKA_MODULE_CONFIG)),
+    tslib_1.__metadata("design:paramtypes", [nestjs_1.RpcControllerFactory,
+        kafka_1.KafkaAdapter, Object])
+], OpraKafkaCoreModule);

package/cjs/opra-kafka.module.js

@@ -0,0 +1,33 @@
+"use strict";
+var OpraKafkaModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpraKafkaModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const opra_kafka_core_module_js_1 = require("./opra-kafka-core.module.js");
+let OpraKafkaModule = OpraKafkaModule_1 = class OpraKafkaModule {
+    /**
+     *
+     * @param options
+     */
+    static forRoot(options) {
+        return {
+            module: OpraKafkaModule_1,
+            imports: [opra_kafka_core_module_js_1.OpraKafkaCoreModule.forRoot(options)],
+        };
+    }
+    /**
+     *
+     * @param options
+     */
+    static forRootAsync(options) {
+        return {
+            module: OpraKafkaModule_1,
+            imports: [opra_kafka_core_module_js_1.OpraKafkaCoreModule.forRootAsync(options)],
+        };
+    }
+};
+exports.OpraKafkaModule = OpraKafkaModule;
+exports.OpraKafkaModule = OpraKafkaModule = OpraKafkaModule_1 = tslib_1.__decorate([
+    (0, common_1.Module)({})
+], OpraKafkaModule);

package/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/esm/constants.js

@@ -0,0 +1 @@
+export const OPRA_KAFKA_MODULE_CONFIG = 'OPRA_KAFKA_MODULE_CONFIG';

package/esm/index.js

@@ -0,0 +1,4 @@
+import { IS_PUBLIC_KEY, OpraNestUtils, Public } from '@opra/nestjs';
+export * from './constants.js';
+export * from './opra-kafka.module.js';
+export { IS_PUBLIC_KEY, OpraNestUtils, Public };

package/esm/opra-kafka-core.module.js

@@ -0,0 +1,134 @@
+var OpraKafkaCoreModule_1;
+import { __decorate, __metadata, __param } from "tslib";
+import { isConstructor } from '@jsopen/objects';
+import { Global, Inject, Logger, Module, } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { ApiDocumentFactory } from '@opra/common';
+import { KafkaAdapter } from '@opra/kafka';
+import { RpcControllerFactory } from '@opra/nestjs';
+import { OPRA_KAFKA_MODULE_CONFIG } from './constants.js';
+const opraKafkaNestjsAdapterToken = Symbol('OpraKafkaNestjsAdapter');
+let OpraKafkaCoreModule = OpraKafkaCoreModule_1 = class OpraKafkaCoreModule {
+    constructor(controllerFactory, adapter, config) {
+        this.controllerFactory = controllerFactory;
+        this.adapter = adapter;
+        this.config = config;
+    }
+    static forRoot(moduleOptions) {
+        return this._getDynamicModule({
+            ...moduleOptions,
+            providers: [
+                ...(moduleOptions?.providers || []),
+                {
+                    provide: OPRA_KAFKA_MODULE_CONFIG,
+                    useValue: {
+                        ...moduleOptions,
+                        logger: moduleOptions.logger || new Logger(moduleOptions.name),
+                    },
+                },
+            ],
+        });
+    }
+    static forRootAsync(moduleOptions) {
+        if (!moduleOptions.useFactory)
+            throw new Error('Invalid configuration. Must provide "useFactory"');
+        return this._getDynamicModule({
+            ...moduleOptions,
+            providers: [
+                ...(moduleOptions?.providers || []),
+                {
+                    provide: OPRA_KAFKA_MODULE_CONFIG,
+                    inject: moduleOptions.inject,
+                    useFactory: async (...args) => {
+                        const result = await moduleOptions.useFactory(...args);
+                        result.logger = result.logger || new Logger(result.name);
+                        return result;
+                    },
+                },
+            ],
+        });
+    }
+    static _getDynamicModule(moduleOptions) {
+        const token = moduleOptions.id || KafkaAdapter;
+        const adapterProvider = {
+            provide: token,
+            inject: [RpcControllerFactory, ModuleRef, OPRA_KAFKA_MODULE_CONFIG],
+            useFactory: async (controllerFactory, moduleRef, config) => {
+                const controllers = controllerFactory
+                    .exploreControllers()
+                    .map(x => x.wrapper.instance.constructor);
+                const document = await ApiDocumentFactory.createDocument({
+                    info: config.info,
+                    types: config.types,
+                    references: config.references,
+                    api: {
+                        name: config.name,
+                        description: config.description,
+                        transport: 'rpc',
+                        platform: KafkaAdapter.PlatformName,
+                        controllers,
+                    },
+                });
+                const interceptors = moduleOptions.interceptors
+                    ? moduleOptions.interceptors.map(x => {
+                        if (isConstructor(x)) {
+                            return async (ctx, next) => {
+                                const interceptor = moduleRef.get(x);
+                                if (typeof interceptor.intercept === 'function')
+                                    return interceptor.intercept(ctx, next);
+                            };
+                        }
+                        return x;
+                    })
+                    : undefined;
+                return new KafkaAdapter(document, { ...config, interceptors });
+            },
+        };
+        return {
+            global: moduleOptions.global,
+            module: OpraKafkaCoreModule_1,
+            controllers: moduleOptions.controllers,
+            providers: [
+                ...(moduleOptions?.providers || []),
+                RpcControllerFactory,
+                adapterProvider,
+                {
+                    provide: opraKafkaNestjsAdapterToken,
+                    useExisting: token,
+                },
+            ],
+            imports: [...(moduleOptions?.imports || [])],
+            exports: [...(moduleOptions?.exports || []), adapterProvider],
+        };
+    }
+    onModuleInit() {
+        /** NestJS initialize controller instances on init stage.
+         * So we should update instance properties */
+        const rpcApi = this.adapter.document.rpcApi;
+        const controllers = Array.from(rpcApi.controllers.values());
+        for (const { wrapper } of this.controllerFactory
+            .exploreControllers()
+            .values()) {
+            const ctor = wrapper.instance.constructor;
+            const controller = controllers.find(x => x.ctor === ctor);
+            if (controller) {
+                controller.instance = wrapper.instance;
+            }
+        }
+    }
+    async onApplicationBootstrap() {
+        await this.adapter.start();
+    }
+    async onApplicationShutdown() {
+        await this.adapter.close();
+    }
+};
+OpraKafkaCoreModule = OpraKafkaCoreModule_1 = __decorate([
+    Module({}),
+    Global(),
+    __param(1, Inject(opraKafkaNestjsAdapterToken)),
+    __param(2, Inject(OPRA_KAFKA_MODULE_CONFIG)),
+    __metadata("design:paramtypes", [RpcControllerFactory,
+        KafkaAdapter, Object])
+], OpraKafkaCoreModule);
+export { OpraKafkaCoreModule };

package/esm/opra-kafka.module.js

@@ -0,0 +1,30 @@
+var OpraKafkaModule_1;
+import { __decorate } from "tslib";
+import { Module } from '@nestjs/common';
+import { OpraKafkaCoreModule } from './opra-kafka-core.module.js';
+let OpraKafkaModule = OpraKafkaModule_1 = class OpraKafkaModule {
+    /**
+     *
+     * @param options
+     */
+    static forRoot(options) {
+        return {
+            module: OpraKafkaModule_1,
+            imports: [OpraKafkaCoreModule.forRoot(options)],
+        };
+    }
+    /**
+     *
+     * @param options
+     */
+    static forRootAsync(options) {
+        return {
+            module: OpraKafkaModule_1,
+            imports: [OpraKafkaCoreModule.forRootAsync(options)],
+        };
+    }
+};
+OpraKafkaModule = OpraKafkaModule_1 = __decorate([
+    Module({})
+], OpraKafkaModule);
+export { OpraKafkaModule };

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@opra/nestjs-kafka",
+  "version": "1.11.0",
+  "description": "Opra NestJS Kafka Module",
+  "author": "Panates",
+  "license": "MIT",
+  "dependencies": {
+    "@jsopen/objects": "^1.5.0",
+    "fast-tokenizer": "^1.7.0",
+    "putil-promisify": "^1.10.1",
+    "reflect-metadata": "^0.2.2",
+    "tslib": "^2.8.1"
+  },
+  "peerDependencies": {
+    "@opra/common": "^1.11.0",
+    "@opra/core": "^1.11.0",
+    "@opra/nestjs": "^1.11.0",
+    "@opra/kafka": "^1.11.0",
+    "@nestjs/common": "^10.0.0 || ^11.0.0",
+    "@nestjs/core": "^10.0.0 || ^11.0.0",
+    "@nestjs/microservices": "^10.0.0 || ^11.0.0",
+    "kafkajs": "^2.2.4"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./types/index.d.ts",
+        "default": "./esm/index.js"
+      },
+      "require": {
+        "types": "./types/index.d.cts",
+        "default": "./cjs/index.js"
+      },
+      "default": "./esm/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./cjs/index.js",
+  "module": "./esm/index.js",
+  "types": "./types/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/panates/opra.git",
+    "directory": "packages/nestjs-kafka"
+  },
+  "engines": {
+    "node": ">=16.0",
+    "npm": ">=7.0.0"
+  },
+  "files": [
+    "bin/",
+    "cjs/",
+    "esm/",
+    "types/",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "opra",
+    "nestjs",
+    "http"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/types/constants.d.ts

@@ -0,0 +1 @@
+export declare const OPRA_KAFKA_MODULE_CONFIG = "OPRA_KAFKA_MODULE_CONFIG";

package/types/index.d.cts

@@ -0,0 +1,4 @@
+import { IS_PUBLIC_KEY, OpraNestUtils, Public } from '@opra/nestjs';
+export * from './constants.js';
+export * from './opra-kafka.module.js';
+export { IS_PUBLIC_KEY, OpraNestUtils, Public };

package/types/index.d.ts

@@ -0,0 +1,4 @@
+import { IS_PUBLIC_KEY, OpraNestUtils, Public } from '@opra/nestjs';
+export * from './constants.js';
+export * from './opra-kafka.module.js';
+export { IS_PUBLIC_KEY, OpraNestUtils, Public };

package/types/opra-kafka-core.module.d.ts

@@ -0,0 +1,16 @@
+import { type DynamicModule, OnApplicationBootstrap, OnApplicationShutdown, OnModuleInit } from '@nestjs/common';
+import { KafkaAdapter } from '@opra/kafka';
+import { RpcControllerFactory } from '@opra/nestjs';
+import type { OpraKafkaModule } from './opra-kafka.module.js';
+export declare class OpraKafkaCoreModule implements OnModuleInit, OnApplicationBootstrap, OnApplicationShutdown {
+    private controllerFactory;
+    protected adapter: KafkaAdapter;
+    protected config: OpraKafkaModule.ApiConfig;
+    constructor(controllerFactory: RpcControllerFactory, adapter: KafkaAdapter, config: OpraKafkaModule.ApiConfig);
+    static forRoot(moduleOptions: OpraKafkaModule.ModuleOptions): DynamicModule;
+    static forRootAsync(moduleOptions: OpraKafkaModule.AsyncModuleOptions): DynamicModule;
+    protected static _getDynamicModule(moduleOptions: OpraKafkaModule.ModuleOptions | OpraKafkaModule.AsyncModuleOptions): DynamicModule;
+    onModuleInit(): any;
+    onApplicationBootstrap(): Promise<void>;
+    onApplicationShutdown(): Promise<void>;
+}

package/types/opra-kafka.module.d.ts

@@ -0,0 +1,34 @@
+import { type DynamicModule, Logger, type Type } from '@nestjs/common';
+import { ApiDocumentFactory } from '@opra/common';
+import type { KafkaAdapter } from '@opra/kafka';
+export declare namespace OpraKafkaModule {
+    export interface ModuleOptions extends BaseModuleOptions, ApiConfig {
+    }
+    export interface AsyncModuleOptions extends BaseModuleOptions {
+        inject?: any[];
+        useFactory?: (...args: any[]) => Promise<ApiConfig> | ApiConfig;
+    }
+    interface BaseModuleOptions extends Pick<DynamicModule, 'imports' | 'providers' | 'exports' | 'controllers' | 'global'> {
+        id?: any;
+        interceptors?: (KafkaAdapter.InterceptorFunction | KafkaAdapter.IKafkaInterceptor | Type<KafkaAdapter.IKafkaInterceptor>)[];
+    }
+    export interface ApiConfig extends Pick<ApiDocumentFactory.InitArguments, 'types' | 'references' | 'info'>, Pick<KafkaAdapter.Config, 'client' | 'consumers' | 'logExtra' | 'defaults'> {
+        name: string;
+        description?: string;
+        scope?: string;
+        logger?: Logger;
+    }
+    export {};
+}
+export declare class OpraKafkaModule {
+    /**
+     *
+     * @param options
+     */
+    static forRoot(options: OpraKafkaModule.ModuleOptions): DynamicModule;
+    /**
+     *
+     * @param options
+     */
+    static forRootAsync(options: OpraKafkaModule.AsyncModuleOptions): DynamicModule;
+}