@lakutata/nats 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# 1.1.0 (2025-09-27)
+
+
+### Features
+
+* **nats:** implement JSON codec for message serialization ([422e56e](https://github.com/lakutata/lakutata-packages/commit/422e56e672172ad2aafde80457e5495f40d4a792))

package/README.md

@@ -0,0 +1,38 @@
+<div align="center">
+
+![lakutata](https://socialify.git.ci/lakutata/lakutata/image?description=1&descriptionEditable=An%20IoC-based%20universal%20application%20framework&font=Source%20Code%20Pro&forks=1&language=1&logo=https%3A%2F%2Fraw.githubusercontent.com%2Flakutata%2Flakutata%2Fmain%2Fassets%2Flogo.svg&name=1&pattern=Circuit%20Board&stargazers=1&theme=Auto)
+
+</div>
+
+<div align="center">
+
+![node-lts](https://img.shields.io/node/v-lts/lakutata?style=for-the-badge&logo=nodedotjs&color=rgb(128%2C189%2C65))
+![npm](https://img.shields.io/npm/v/lakutata?style=for-the-badge&logo=npm&color=rgb(128%2C189%2C65))
+![npm](https://img.shields.io/npm/dm/lakutata?style=for-the-badge&logo=npm&color=rgb(128%2C189%2C65))
+![NPM](https://img.shields.io/npm/l/lakutata?style=for-the-badge&logo=github&color=rgb(128%2C189%2C65))
+![Codacy grade](https://img.shields.io/codacy/grade/0f16d1c355494415ad7733f8f22f7d36?style=for-the-badge&logo=codacy)
+
+</div>
+
+## 💫 Description
+
+Lakutata is a generic development framework written in TypeScript and designed with IoC principles. Its main objective
+is to provide a universal, efficient, and stable development framework. The design goals of Lakutata are not limited to
+web application development; it aims to serve as a foundational framework for desktop applications, embedded systems
+applications, and web applications. The framework primarily adopts an OOP (Object-Oriented Programming) approach and
+encapsulates functionalities such as subprocesses, threads, permission management, and database ORM, enabling the
+framework to be used out of the box.
+
+In addition, Lakutata also supports the integration of third-party libraries into the application, allowing developers
+to freely encapsulate and call third-party modules using Lakutata's dependency injection.
+
+## ✨ Getting started
+
+- Install lakutata NATS client
+```shell
+npm install @lakutata/nats
+```
+
+## 🌎 License
+
+Lakutata is [MIT licensed](LICENSE).

package/dist/CommonExports.d.ts

@@ -0,0 +1,14 @@
+export { SetupNatsServiceEntrypoint } from './entrypoints/SetupNatsServiceEntrypoint';
+export { NATS, buildNatsClientOptions } from './components/NATS';
+export { JSONCodec } from './codecs/JSONCodec';
+export { StringCodec } from 'nats';
+export type { SubscribeOptions } from './types/SubscribeOptions';
+export type { Subscription, Codec } from 'nats';
+export type { NatsClientOptions } from './interfaces/NatsClientOptions';
+export { NatsBadRequestException } from './exceptions/NatsBadRequestException';
+export { NatsForbiddenException } from './exceptions/NatsForbiddenException';
+export { NatsInternalServerException } from './exceptions/NatsInternalServerException';
+export { NatsNoRespondersAvailableException } from './exceptions/NatsNoRespondersAvailableException';
+export { NatsNotFoundException } from './exceptions/NatsNotFoundException';
+export { NatsRequestTimeoutException } from './exceptions/NatsRequestTimeoutException';
+//# sourceMappingURL=CommonExports.d.ts.map

package/dist/CommonExports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommonExports.d.ts","sourceRoot":"","sources":["../src/CommonExports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,0CAA0C,CAAA;AACnF,OAAO,EAAC,IAAI,EAAE,sBAAsB,EAAC,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAC,WAAW,EAAC,MAAM,MAAM,CAAA;AAChC,YAAY,EAAC,gBAAgB,EAAC,MAAM,0BAA0B,CAAA;AAC9D,YAAY,EAAC,YAAY,EAAE,KAAK,EAAC,MAAM,MAAM,CAAA;AAC7C,YAAY,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAA;AACrE,OAAO,EAAC,uBAAuB,EAAC,MAAM,sCAAsC,CAAA;AAC5E,OAAO,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAA;AAC1E,OAAO,EAAC,2BAA2B,EAAC,MAAM,0CAA0C,CAAA;AACpF,OAAO,EAAC,kCAAkC,EAAC,MAAM,iDAAiD,CAAA;AAClG,OAAO,EAAC,qBAAqB,EAAC,MAAM,oCAAoC,CAAA;AACxE,OAAO,EAAC,2BAA2B,EAAC,MAAM,0CAA0C,CAAA"}

package/dist/CommonExports.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsRequestTimeoutException = exports.NatsNotFoundException = exports.NatsNoRespondersAvailableException = exports.NatsInternalServerException = exports.NatsForbiddenException = exports.NatsBadRequestException = exports.StringCodec = exports.JSONCodec = exports.buildNatsClientOptions = exports.NATS = exports.SetupNatsServiceEntrypoint = void 0;
+var SetupNatsServiceEntrypoint_1 = require("./entrypoints/SetupNatsServiceEntrypoint");
+Object.defineProperty(exports, "SetupNatsServiceEntrypoint", { enumerable: true, get: function () { return SetupNatsServiceEntrypoint_1.SetupNatsServiceEntrypoint; } });
+var NATS_1 = require("./components/NATS");
+Object.defineProperty(exports, "NATS", { enumerable: true, get: function () { return NATS_1.NATS; } });
+Object.defineProperty(exports, "buildNatsClientOptions", { enumerable: true, get: function () { return NATS_1.buildNatsClientOptions; } });
+var JSONCodec_1 = require("./codecs/JSONCodec");
+Object.defineProperty(exports, "JSONCodec", { enumerable: true, get: function () { return JSONCodec_1.JSONCodec; } });
+var nats_1 = require("nats");
+Object.defineProperty(exports, "StringCodec", { enumerable: true, get: function () { return nats_1.StringCodec; } });
+var NatsBadRequestException_1 = require("./exceptions/NatsBadRequestException");
+Object.defineProperty(exports, "NatsBadRequestException", { enumerable: true, get: function () { return NatsBadRequestException_1.NatsBadRequestException; } });
+var NatsForbiddenException_1 = require("./exceptions/NatsForbiddenException");
+Object.defineProperty(exports, "NatsForbiddenException", { enumerable: true, get: function () { return NatsForbiddenException_1.NatsForbiddenException; } });
+var NatsInternalServerException_1 = require("./exceptions/NatsInternalServerException");
+Object.defineProperty(exports, "NatsInternalServerException", { enumerable: true, get: function () { return NatsInternalServerException_1.NatsInternalServerException; } });
+var NatsNoRespondersAvailableException_1 = require("./exceptions/NatsNoRespondersAvailableException");
+Object.defineProperty(exports, "NatsNoRespondersAvailableException", { enumerable: true, get: function () { return NatsNoRespondersAvailableException_1.NatsNoRespondersAvailableException; } });
+var NatsNotFoundException_1 = require("./exceptions/NatsNotFoundException");
+Object.defineProperty(exports, "NatsNotFoundException", { enumerable: true, get: function () { return NatsNotFoundException_1.NatsNotFoundException; } });
+var NatsRequestTimeoutException_1 = require("./exceptions/NatsRequestTimeoutException");
+Object.defineProperty(exports, "NatsRequestTimeoutException", { enumerable: true, get: function () { return NatsRequestTimeoutException_1.NatsRequestTimeoutException; } });

package/dist/codecs/JSONCodec.d.ts

@@ -0,0 +1,3 @@
+import { Codec } from 'nats';
+export declare function JSONCodec(): Codec<any>;
+//# sourceMappingURL=JSONCodec.d.ts.map

package/dist/codecs/JSONCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSONCodec.d.ts","sourceRoot":"","sources":["../../src/codecs/JSONCodec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,MAAM,CAAA;AAE1B,wBAAgB,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,CAUtC"}

package/dist/codecs/JSONCodec.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSONCodec = void 0;
+function JSONCodec() {
+    return {
+        encode(d) {
+            return Buffer.from(JSON.stringify([d]));
+        },
+        decode(a) {
+            const [res] = JSON.parse(Buffer.from(a).toString());
+            return res;
+        }
+    };
+}
+exports.JSONCodec = JSONCodec;

package/dist/components/NATS.d.ts

@@ -0,0 +1,129 @@
+import { Component, ComponentOptionsBuilder } from 'lakutata';
+import { type Codec, Subscription } from 'nats';
+import { SubscribeOptions } from '../types/SubscribeOptions';
+import { NatsClientOptions } from '../interfaces/NatsClientOptions';
+export declare const buildNatsClientOptions: ComponentOptionsBuilder<NatsClientOptions>;
+export declare class NATS extends Component {
+    #private;
+    /**
+     * NATS servers
+     * @protected
+     */
+    protected readonly servers: string | string[];
+    /**
+     * NATS message codec
+     * @protected
+     */
+    protected readonly codec: Codec<unknown>;
+    /**
+     * Sets the number of milliseconds the client should wait for a server
+     * handshake to be established
+     * @protected
+     */
+    protected readonly timeout?: number;
+    /**
+     * Set to a client authentication token. Note that these tokens are
+     * a specific authentication strategy on the nats-server
+     * @protected
+     */
+    protected readonly token?: string;
+    /**
+     * Sets the username for a client connection
+     * @protected
+     */
+    protected readonly user?: string;
+    /**
+     * Sets the password for a client connection
+     * @protected
+     */
+    protected readonly pass?: string;
+    /**
+     * When set to `true` the client will print protocol messages that it receives
+     * or sends to the server
+     * @protected
+     */
+    protected readonly debug?: boolean;
+    /**
+     * Sets the maximum count of ping commands that can be awaiting a response
+     * before rasing a stale connection status notification and initiating a reconnect
+     * @protected
+     */
+    protected readonly maxPingOut?: number;
+    /**
+     * Sets the maximum count of per-server reconnect attempts before giving up.
+     * Set to `-1` to never give up
+     *
+     * @default 10
+     * @protected
+     */
+    protected readonly maxReconnectAttempts?: number;
+    /**
+     * Sets the client name. When set, the server monitoring pages will display
+     * this name when referring to this client
+     * @protected
+     */
+    protected readonly name?: string;
+    /**
+     * When set to true, messages published by this client will not match
+     * this client's subscriptions, so the client is guaranteed to never
+     * receive self-published messages on a subject that it is listening on
+     * @protected
+     */
+    protected readonly noEcho?: boolean;
+    /**
+     * If set to true, the client will not randomize its server connection list
+     * @protected
+     */
+    protected readonly noRandomize?: boolean;
+    /**
+     * Sets the number of milliseconds between client initiated ping commands
+     *
+     * @default 2 minutes.
+     * @protected
+     */
+    protected readonly pingInterval?: number;
+    /**
+     * When set to true, the server will attempt to reconnect so long as doesn't prevent it
+     *
+     * @default true
+     * @protected
+     */
+    protected readonly reconnect?: boolean;
+    /**
+     * Initializer
+     * @protected
+     */
+    protected init(): Promise<void>;
+    /**
+     * Destroyer
+     * @protected
+     */
+    protected destroy(): Promise<void>;
+    /**
+     * Publishes the specified data to the specified subject.
+     * @param subject
+     * @param payload
+     */
+    publish(subject: string, payload: any): void;
+    /**
+     * Publishes a request with specified data in the specified subject expecting a
+     * response before timeout milliseconds. The api returns a
+     * Promise that resolves when the first response to the request is received. If
+     * there are no responders (a subscription) listening on the request subject,
+     * the request will fail as soon as the server processes it
+     * @param subject
+     * @param payload
+     * @param timeout
+     */
+    request(subject: string, payload?: any, timeout?: number): Promise<any>;
+    /**
+     * Subscribe expresses interest in the specified subject. The subject may
+     * have wildcards. Messages are delivered to the callback.
+     * If the subscription receives request, the callback return's value will respond to requester
+     * @param subject
+     * @param callback
+     * @param subscribeOptions
+     */
+    subscribe(subject: string, callback: (data: any) => any | Promise<any>, subscribeOptions?: SubscribeOptions): Subscription;
+}
+//# sourceMappingURL=NATS.d.ts.map

package/dist/components/NATS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NATS.d.ts","sourceRoot":"","sources":["../../src/components/NATS.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EAET,uBAAuB,EAE1B,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAC,KAAK,KAAK,EAA6C,YAAY,EAAC,MAAM,MAAM,CAAA;AACxF,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAA;AAO1D,OAAO,EAAC,iBAAiB,EAAC,MAAM,iCAAiC,CAAA;AAGjE,eAAO,MAAM,sBAAsB,EAAE,uBAAuB,CAAC,iBAAiB,CAkB7E,CAAA;AAED,qBAAa,IAAK,SAAQ,SAAS;;IAC/B;;;OAGG;IAEH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAE7C;;;OAGG;IAKH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAExC;;;;OAIG;IAEH,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IAEnC;;;;OAIG;IAEH,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IAEjC;;;OAGG;IAEH,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IAEhC;;;OAGG;IAEH,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IAEhC;;;;OAIG;IAEH,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IAElC;;;;OAIG;IAEH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAEtC;;;;;;OAMG;IAEH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAEhD;;;;OAIG;IAEH,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IAEhC;;;;;OAKG;IAEH,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IAEnC;;;OAGG;IAEH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAExC;;;;;OAKG;IAEH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAExC;;;;;OAKG;IAEH,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAQtC;;;OAGG;cACa,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBrC;;;OAGG;cACa,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;OAIG;IACI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAInD;;;;;;;;;OASG;IACU,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IA4BpF;;;;;;;OAOG;IACI,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,YAAY;CAYpI"}

package/dist/components/NATS.js

@@ -0,0 +1,205 @@
+"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.NATS = exports.buildNatsClientOptions = void 0;
+const lakutata_1 = require("lakutata");
+const di_1 = require("lakutata/decorator/di");
+const nats_1 = require("nats");
+const NatsBadRequestException_1 = require("../exceptions/NatsBadRequestException");
+const NatsForbiddenException_1 = require("../exceptions/NatsForbiddenException");
+const NatsNotFoundException_1 = require("../exceptions/NatsNotFoundException");
+const NatsRequestTimeoutException_1 = require("../exceptions/NatsRequestTimeoutException");
+const NatsNoRespondersAvailableException_1 = require("../exceptions/NatsNoRespondersAvailableException");
+const NatsInternalServerException_1 = require("../exceptions/NatsInternalServerException");
+const JSONCodec_1 = require("../codecs/JSONCodec");
+const buildNatsClientOptions = (options) => {
+    return {
+        class: NATS,
+        servers: options.servers,
+        codec: options.codec,
+        timeout: options.timeout,
+        token: options.token,
+        user: options.user,
+        pass: options.pass,
+        debug: options.debug,
+        maxPingOut: options.maxPingOut,
+        maxReconnectAttempts: options.maxReconnectAttempts,
+        name: options.name,
+        noEcho: options.noEcho,
+        noRandomize: options.noRandomize,
+        pingInterval: options.pingInterval,
+        reconnect: options.reconnect
+    };
+};
+exports.buildNatsClientOptions = buildNatsClientOptions;
+class NATS extends lakutata_1.Component {
+    /**
+     * NATS client instance
+     * @private
+     */
+    #conn;
+    /**
+     * Initializer
+     * @protected
+     */
+    async init() {
+        this.#conn = await (0, nats_1.connect)({
+            servers: this.servers,
+            user: this.user,
+            pass: this.pass,
+            timeout: this.timeout,
+            token: this.token,
+            debug: this.debug,
+            maxPingOut: this.maxPingOut,
+            maxReconnectAttempts: this.maxReconnectAttempts,
+            name: this.name,
+            noEcho: this.noEcho,
+            noRandomize: this.noRandomize,
+            pingInterval: this.pingInterval,
+            reconnect: this.reconnect
+        });
+    }
+    /**
+     * Destroyer
+     * @protected
+     */
+    async destroy() {
+        await this.#conn.close();
+    }
+    /**
+     * Publishes the specified data to the specified subject.
+     * @param subject
+     * @param payload
+     */
+    publish(subject, payload) {
+        return this.#conn.publish(subject, this.codec.encode(payload));
+    }
+    /**
+     * Publishes a request with specified data in the specified subject expecting a
+     * response before timeout milliseconds. The api returns a
+     * Promise that resolves when the first response to the request is received. If
+     * there are no responders (a subscription) listening on the request subject,
+     * the request will fail as soon as the server processes it
+     * @param subject
+     * @param payload
+     * @param timeout
+     */
+    async request(subject, payload, timeout) {
+        try {
+            const response = await this.#conn.request(subject, this.codec.encode(payload), { timeout: timeout ? timeout : 0 });
+            return this.codec.decode(response.data);
+        }
+        catch (e) {
+            if (e.code) {
+                switch (e.code.toString()) {
+                    case '400':
+                        throw new NatsBadRequestException_1.NatsBadRequestException();
+                    case '403':
+                        throw new NatsForbiddenException_1.NatsForbiddenException();
+                    case '404':
+                        throw new NatsNotFoundException_1.NatsNotFoundException();
+                    case '408':
+                        throw new NatsRequestTimeoutException_1.NatsRequestTimeoutException();
+                    case '503':
+                        throw new NatsNoRespondersAvailableException_1.NatsNoRespondersAvailableException();
+                    case '500':
+                        throw new NatsInternalServerException_1.NatsInternalServerException();
+                    default:
+                        throw e;
+                }
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+    /**
+     * Subscribe expresses interest in the specified subject. The subject may
+     * have wildcards. Messages are delivered to the callback.
+     * If the subscription receives request, the callback return's value will respond to requester
+     * @param subject
+     * @param callback
+     * @param subscribeOptions
+     */
+    subscribe(subject, callback, subscribeOptions) {
+        return this.#conn.subscribe(subject, {
+            queue: subscribeOptions?.queue,
+            max: subscribeOptions?.max,
+            callback: async (err, msg) => {
+                if (err)
+                    this.emit('error', err);
+                const data = this.codec.decode(msg.data);
+                const result = await callback(data);
+                msg.respond(this.codec.encode(result));
+            }
+        });
+    }
+}
+exports.NATS = NATS;
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.Alternatives(lakutata_1.DTO.String(), lakutata_1.DTO.Array(lakutata_1.DTO.String())).required()),
+    __metadata("design:type", Object)
+], NATS.prototype, "servers", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.Object({
+        encode: lakutata_1.DTO.Function().arity(1).required(),
+        decode: lakutata_1.DTO.Function().arity(1).required()
+    }).optional().default((0, JSONCodec_1.JSONCodec)())),
+    __metadata("design:type", Object)
+], NATS.prototype, "codec", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.Number().integer().optional()),
+    __metadata("design:type", Number)
+], NATS.prototype, "timeout", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.String().optional()),
+    __metadata("design:type", String)
+], NATS.prototype, "token", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.String().optional()),
+    __metadata("design:type", String)
+], NATS.prototype, "user", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.String().optional()),
+    __metadata("design:type", String)
+], NATS.prototype, "pass", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.Boolean().optional()),
+    __metadata("design:type", Boolean)
+], NATS.prototype, "debug", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.Number().optional()),
+    __metadata("design:type", Number)
+], NATS.prototype, "maxPingOut", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.Number().optional().default(10)),
+    __metadata("design:type", Number)
+], NATS.prototype, "maxReconnectAttempts", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.String().optional()),
+    __metadata("design:type", String)
+], NATS.prototype, "name", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.Boolean().optional()),
+    __metadata("design:type", Boolean)
+], NATS.prototype, "noEcho", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.Boolean().optional()),
+    __metadata("design:type", Boolean)
+], NATS.prototype, "noRandomize", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.Number().optional().default(1000 * 60 * 2)),
+    __metadata("design:type", Number)
+], NATS.prototype, "pingInterval", void 0);
+__decorate([
+    (0, di_1.Configurable)(lakutata_1.DTO.Boolean().optional().default(true)),
+    __metadata("design:type", Boolean)
+], NATS.prototype, "reconnect", void 0);

package/dist/entrypoints/SetupNatsServiceEntrypoint.d.ts

@@ -0,0 +1,8 @@
+import { ServiceEntrypoint } from 'lakutata/com/entrypoint';
+/**
+ * Setup service based on NATS
+ * @param natsComponentName
+ * @constructor
+ */
+export declare function SetupNatsServiceEntrypoint(natsComponentName: string): ServiceEntrypoint;
+//# sourceMappingURL=SetupNatsServiceEntrypoint.d.ts.map

package/dist/entrypoints/SetupNatsServiceEntrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SetupNatsServiceEntrypoint.d.ts","sourceRoot":"","sources":["../../src/entrypoints/SetupNatsServiceEntrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,iBAAiB,EAEpB,MAAM,yBAAyB,CAAA;AAIhC;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,iBAAiB,EAAE,MAAM,GAAG,iBAAiB,CASvF"}

package/dist/entrypoints/SetupNatsServiceEntrypoint.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SetupNatsServiceEntrypoint = void 0;
+const entrypoint_1 = require("lakutata/com/entrypoint");
+/**
+ * Setup service based on NATS
+ * @param natsComponentName
+ * @constructor
+ */
+function SetupNatsServiceEntrypoint(natsComponentName) {
+    return (0, entrypoint_1.BuildServiceEntrypoint)(async (module, handler) => {
+        const nats = await module.getObject(natsComponentName);
+        nats.subscribe(module.appId, async (incomeRequestPayload) => {
+            return await handler(new entrypoint_1.ServiceContext({
+                data: incomeRequestPayload
+            }));
+        });
+    });
+}
+exports.SetupNatsServiceEntrypoint = SetupNatsServiceEntrypoint;

package/dist/exceptions/NatsBadRequestException.d.ts

@@ -0,0 +1,7 @@
+import { Exception } from 'lakutata';
+export declare class NatsBadRequestException extends Exception {
+    errno: string | number;
+    message: string;
+    statusCode: number;
+}
+//# sourceMappingURL=NatsBadRequestException.d.ts.map

package/dist/exceptions/NatsBadRequestException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NatsBadRequestException.d.ts","sourceRoot":"","sources":["../../src/exceptions/NatsBadRequestException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAA;AAElC,qBAAa,uBAAwB,SAAQ,SAAS;IAC3C,KAAK,EAAE,MAAM,GAAG,MAAM,CAAuB;IAC7C,OAAO,EAAE,MAAM,CAAgB;IAC/B,UAAU,EAAE,MAAM,CAAM;CAClC"}

package/dist/exceptions/NatsBadRequestException.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsBadRequestException = void 0;
+const lakutata_1 = require("lakutata");
+class NatsBadRequestException extends lakutata_1.Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_NATS_BAD_REQUEST';
+        this.message = 'Bad Request';
+        this.statusCode = 400;
+    }
+}
+exports.NatsBadRequestException = NatsBadRequestException;

package/dist/exceptions/NatsForbiddenException.d.ts

@@ -0,0 +1,7 @@
+import { Exception } from 'lakutata';
+export declare class NatsForbiddenException extends Exception {
+    errno: string | number;
+    message: string;
+    statusCode: number;
+}
+//# sourceMappingURL=NatsForbiddenException.d.ts.map

package/dist/exceptions/NatsForbiddenException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NatsForbiddenException.d.ts","sourceRoot":"","sources":["../../src/exceptions/NatsForbiddenException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAA;AAElC,qBAAa,sBAAuB,SAAQ,SAAS;IAC1C,KAAK,EAAE,MAAM,GAAG,MAAM,CAAqB;IAC3C,OAAO,EAAE,MAAM,CAAc;IAC7B,UAAU,EAAE,MAAM,CAAM;CAClC"}

package/dist/exceptions/NatsForbiddenException.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsForbiddenException = void 0;
+const lakutata_1 = require("lakutata");
+class NatsForbiddenException extends lakutata_1.Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_NATS_FORBIDDEN';
+        this.message = 'Forbidden';
+        this.statusCode = 403;
+    }
+}
+exports.NatsForbiddenException = NatsForbiddenException;

package/dist/exceptions/NatsInternalServerException.d.ts

@@ -0,0 +1,7 @@
+import { Exception } from 'lakutata';
+export declare class NatsInternalServerException extends Exception {
+    errno: string | number;
+    message: string;
+    statusCode: number;
+}
+//# sourceMappingURL=NatsInternalServerException.d.ts.map

package/dist/exceptions/NatsInternalServerException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NatsInternalServerException.d.ts","sourceRoot":"","sources":["../../src/exceptions/NatsInternalServerException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAA;AAElC,qBAAa,2BAA4B,SAAQ,SAAS;IAC/C,KAAK,EAAE,MAAM,GAAG,MAAM,CAA2B;IACjD,OAAO,EAAE,MAAM,CAA0B;IACzC,UAAU,EAAE,MAAM,CAAM;CAClC"}

package/dist/exceptions/NatsInternalServerException.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsInternalServerException = void 0;
+const lakutata_1 = require("lakutata");
+class NatsInternalServerException extends lakutata_1.Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_NATS_INTERNAL_SERVER';
+        this.message = 'Internal Server Error';
+        this.statusCode = 500;
+    }
+}
+exports.NatsInternalServerException = NatsInternalServerException;

package/dist/exceptions/NatsNoRespondersAvailableException.d.ts

@@ -0,0 +1,7 @@
+import { Exception } from 'lakutata';
+export declare class NatsNoRespondersAvailableException extends Exception {
+    errno: string | number;
+    message: string;
+    statusCode: number;
+}
+//# sourceMappingURL=NatsNoRespondersAvailableException.d.ts.map

package/dist/exceptions/NatsNoRespondersAvailableException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NatsNoRespondersAvailableException.d.ts","sourceRoot":"","sources":["../../src/exceptions/NatsNoRespondersAvailableException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAA;AAElC,qBAAa,kCAAmC,SAAQ,SAAS;IACtD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAmC;IACzD,OAAO,EAAE,MAAM,CAA4B;IAC3C,UAAU,EAAE,MAAM,CAAM;CAClC"}

package/dist/exceptions/NatsNoRespondersAvailableException.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsNoRespondersAvailableException = void 0;
+const lakutata_1 = require("lakutata");
+class NatsNoRespondersAvailableException extends lakutata_1.Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_NATS_NO_RESPONDERS_AVAILABLE';
+        this.message = 'No Responders Available';
+        this.statusCode = 503;
+    }
+}
+exports.NatsNoRespondersAvailableException = NatsNoRespondersAvailableException;

package/dist/exceptions/NatsNotFoundException.d.ts

@@ -0,0 +1,7 @@
+import { Exception } from 'lakutata';
+export declare class NatsNotFoundException extends Exception {
+    errno: string | number;
+    message: string;
+    statusCode: number;
+}
+//# sourceMappingURL=NatsNotFoundException.d.ts.map

package/dist/exceptions/NatsNotFoundException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NatsNotFoundException.d.ts","sourceRoot":"","sources":["../../src/exceptions/NatsNotFoundException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAA;AAElC,qBAAa,qBAAsB,SAAQ,SAAS;IACzC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAqB;IAC3C,OAAO,EAAE,MAAM,CAAsB;IACrC,UAAU,EAAE,MAAM,CAAM;CAClC"}

package/dist/exceptions/NatsNotFoundException.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsNotFoundException = void 0;
+const lakutata_1 = require("lakutata");
+class NatsNotFoundException extends lakutata_1.Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_NATS_NOT_FOUND';
+        this.message = 'Subject Not Found';
+        this.statusCode = 404;
+    }
+}
+exports.NatsNotFoundException = NatsNotFoundException;

package/dist/exceptions/NatsRequestTimeoutException.d.ts

@@ -0,0 +1,7 @@
+import { Exception } from 'lakutata';
+export declare class NatsRequestTimeoutException extends Exception {
+    errno: string | number;
+    message: string;
+    statusCode: number;
+}
+//# sourceMappingURL=NatsRequestTimeoutException.d.ts.map

package/dist/exceptions/NatsRequestTimeoutException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NatsRequestTimeoutException.d.ts","sourceRoot":"","sources":["../../src/exceptions/NatsRequestTimeoutException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAA;AAElC,qBAAa,2BAA4B,SAAQ,SAAS;IAC/C,KAAK,EAAE,MAAM,GAAG,MAAM,CAA2B;IACjD,OAAO,EAAE,MAAM,CAAoB;IACnC,UAAU,EAAE,MAAM,CAAM;CAClC"}

package/dist/exceptions/NatsRequestTimeoutException.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsRequestTimeoutException = void 0;
+const lakutata_1 = require("lakutata");
+class NatsRequestTimeoutException extends lakutata_1.Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_NATS_REQUEST_TIMEOUT';
+        this.message = 'Request Timeout';
+        this.statusCode = 408;
+    }
+}
+exports.NatsRequestTimeoutException = NatsRequestTimeoutException;

package/dist/interfaces/NatsClientOptions.d.ts

@@ -0,0 +1,18 @@
+import { Codec } from 'nats';
+export interface NatsClientOptions {
+    servers: string | string[];
+    codec?: Codec<unknown>;
+    timeout?: number;
+    token?: string;
+    user?: string;
+    pass?: string;
+    debug?: boolean;
+    maxPingOut?: number;
+    maxReconnectAttempts?: number;
+    name?: string;
+    noEcho?: boolean;
+    noRandomize?: boolean;
+    pingInterval?: number;
+    reconnect?: boolean;
+}
+//# sourceMappingURL=NatsClientOptions.d.ts.map

package/dist/interfaces/NatsClientOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NatsClientOptions.d.ts","sourceRoot":"","sources":["../../src/interfaces/NatsClientOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,MAAM,CAAA;AAE1B,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB"}

package/dist/interfaces/NatsClientOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/tests/NatsTest.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NatsTest.spec.d.ts.map

package/dist/tests/NatsTest.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NatsTest.spec.d.ts","sourceRoot":"","sources":["../../src/tests/NatsTest.spec.ts"],"names":[],"mappings":""}

package/dist/tests/NatsTest.spec.js

@@ -0,0 +1,85 @@
+"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 });
+const lakutata_1 = require("lakutata");
+const entrypoint_1 = require("lakutata/com/entrypoint");
+const di_1 = require("lakutata/decorator/di");
+const CommonExports_1 = require("../CommonExports");
+const ctrl_1 = require("lakutata/decorator/ctrl");
+class TestComponent extends lakutata_1.Component {
+    async init() {
+        // this.nats.subscribe('test-invoke', (msg) => {
+        //     console.log('msg:', msg)
+        //     return Date.now()
+        // })
+        // this.nats.subscribe('test', (data: any) => {
+        //     console.log(data)
+        // })
+        //
+        // setInterval(async () => {
+        //     this.nats.publish('test', 1234)
+        //     console.log('res:', await this.nats.request('test-invoke', JSON.stringify({haha: true})), 1000000)
+        // }, 1)
+        console.log(await this.nats.request(this.app.appId, { test: true }));
+    }
+}
+__decorate([
+    (0, di_1.Inject)(lakutata_1.Application),
+    __metadata("design:type", lakutata_1.Application)
+], TestComponent.prototype, "app", void 0);
+__decorate([
+    (0, di_1.Inject)('nats'),
+    __metadata("design:type", CommonExports_1.NATS)
+], TestComponent.prototype, "nats", void 0);
+class TestController extends entrypoint_1.Controller {
+    async test(inp) {
+        // return 'hahahah'
+        return {
+            test: true,
+            num: 1234,
+            sub: {
+                a: 1234,
+                b: '1234234',
+                c: [{ test: true }]
+            }
+        };
+        // return ['hahahah']
+        // return {
+        //     test: 123456
+        // }
+    }
+}
+__decorate([
+    (0, ctrl_1.ServiceAction)({ test: true }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], TestController.prototype, "test", null);
+lakutata_1.Application.run({
+    id: 'test.app',
+    name: 'TestApp',
+    components: {
+        entrypoint: (0, entrypoint_1.BuildEntrypoints)({
+            controllers: [TestController],
+            service: (0, CommonExports_1.SetupNatsServiceEntrypoint)('nats')
+        }),
+        nats: (0, CommonExports_1.buildNatsClientOptions)({
+            servers: '127.0.0.1:4222'
+        }),
+        test: {
+            class: TestComponent
+        }
+    },
+    bootstrap: [
+        'entrypoint',
+        'test'
+    ]
+});

package/dist/types/SubscribeOptions.d.ts

@@ -0,0 +1,5 @@
+export type SubscribeOptions = {
+    queue?: string;
+    max?: number;
+};
+//# sourceMappingURL=SubscribeOptions.d.ts.map

package/dist/types/SubscribeOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscribeOptions.d.ts","sourceRoot":"","sources":["../../src/types/SubscribeOptions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACf,CAAA"}

package/dist/types/SubscribeOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@lakutata/nats",
+  "version": "1.1.0",
+  "description": "Lakutata NATS Client",
+  "keywords": [
+    "lakutata",
+    "NATS",
+    "client"
+  ],
+  "author": "myq1991 <myq1991@gmail.com>",
+  "homepage": "https://github.com/lakutata/lakutata-packages",
+  "license": "Apache-2.0",
+  "main": "./dist/CommonExports.js",
+  "types": "./dist/CommonExports.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lakutata/lakutata-packages.git"
+  },
+  "scripts": {
+    "clean": "shx rm -rf ./dist",
+    "build": "tsc",
+    "rebuild": "npm run clean && npm run build",
+    "test": "bun src/tests/NatsTest.spec.ts"
+  },
+  "bugs": {
+    "url": "https://github.com/lakutata/lakutata-packages/issues"
+  },
+  "dependencies": {
+    "nats": "^2.29.3"
+  },
+  "gitHead": "30da3fc101c09b9f3495c90bc88ceae78401e64a"
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  }
+}