@lakutata/nats 2.3.0 → 3.0.0-beta.1

package/CHANGELOG.md

@@ -1,288 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-# [2.3.0](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@2.2.2...@lakutata/nats@2.3.0) (2026-07-05)
-
-
-### Features
-
-* **nats:** pass concrete subject to subscribe callback ([de30954](https://github.com/lakutata/lakutata-packages/commit/de30954fde54f0c73b6b4db786c63d4bb199b5da))
-
-
-
-
-
-## [2.2.2](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@2.2.1...@lakutata/nats@2.2.2) (2026-06-22)
-
-
-### Bug Fixes
-
-* **nats:** never send replicas to object store by default ([af35db3](https://github.com/lakutata/lakutata-packages/commit/af35db304029e8473b62d3430c78ce0b0a1c8d4d))
-
-
-
-
-
-## [2.2.1](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@2.2.0...@lakutata/nats@2.2.1) (2026-06-22)
-
-
-### Bug Fixes
-
-* **nats:** do not send replicas field to object store by default ([4a05d8b](https://github.com/lakutata/lakutata-packages/commit/4a05d8bd50e689b4b594ccef3f9fada62f788049))
-
-
-
-
-
-# [2.2.0](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@2.1.0...@lakutata/nats@2.2.0) (2026-06-21)
-
-
-### Features
-
-* **nats:** update gitHead hash in package.json ([d1826a8](https://github.com/lakutata/lakutata-packages/commit/d1826a825492971f47c1d860360cab980733dea5))
-* **nats:** update gitHead hash in package.json ([d936b72](https://github.com/lakutata/lakutata-packages/commit/d936b7289cccf1bf6d567fb99b7557d87da66f5f))
-* **nats:** update gitHead hash in package.json ([4f25418](https://github.com/lakutata/lakutata-packages/commit/4f2541873b9dc5630a7788138b6541ae97da51a8)), closes [#2](https://github.com/lakutata/lakutata-packages/issues/2) [#3](https://github.com/lakutata/lakutata-packages/issues/3) [#7](https://github.com/lakutata/lakutata-packages/issues/7)
-
-
-
-
-
-# [2.1.0](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@2.0.1...@lakutata/nats@2.1.0) (2026-06-21)
-
-
-### Features
-
-* **nats:** add bulk data transfer and service proxy retry ([107ad48](https://github.com/lakutata/lakutata-packages/commit/107ad48219857f7f7e13dcfd728d1f92438f10a9)), closes [#2](https://github.com/lakutata/lakutata-packages/issues/2) [#3](https://github.com/lakutata/lakutata-packages/issues/3) [#7](https://github.com/lakutata/lakutata-packages/issues/7)
-
-
-
-
-
-## [2.0.1](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@2.0.0...@lakutata/nats@2.0.1) (2026-03-02)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-# [2.0.0](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.6.2...@lakutata/nats@2.0.0) (2026-03-02)
-
-
-### Code Refactoring
-
-* **nats:** remove Task provider and simplify NATS component ([7eb57ac](https://github.com/lakutata/lakutata-packages/commit/7eb57ac4f7b89c1619a3042cbaca8869c0a8f8d2))
-
-
-### BREAKING CHANGES
-
-* **nats:** Task provider and related exports have been removed. Applications using the Task functionality will need to implement their own task management solution.
-
-
-
-
-
-## [1.6.2](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.6.1...@lakutata/nats@1.6.2) (2026-01-17)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.6.1](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.6.0...@lakutata/nats@1.6.1) (2026-01-17)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-# [1.6.0](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.5.2...@lakutata/nats@1.6.0) (2026-01-16)
-
-
-### Features
-
-* **nats:** add task provider and update NATS component ([3ec7114](https://github.com/lakutata/lakutata-packages/commit/3ec7114af0aed0e548728339b44d21bc42e0e210))
-* **nats:** add Task provider to CommonExports ([ad07ee9](https://github.com/lakutata/lakutata-packages/commit/ad07ee9cff6306bbc77ccc9ce1fa3c025df04ee5))
-
-
-
-
-
-## [1.5.2](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.5.1...@lakutata/nats@1.5.2) (2026-01-11)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.5.1](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.5.0...@lakutata/nats@1.5.1) (2025-12-28)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-# [1.5.0](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.4.0...@lakutata/nats@1.5.0) (2025-12-27)
-
-
-### Features
-
-* **nats:** export MessagePackCodec in CommonExports ([b22f0d0](https://github.com/lakutata/lakutata-packages/commit/b22f0d0480bbbe5b6e83b7f481e4f5ce4fc06e15))
-
-
-
-
-
-# [1.4.0](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.12...@lakutata/nats@1.4.0) (2025-12-27)
-
-
-### Features
-
-* **nats:** add MessagePack codec and update dependencies ([9e229a9](https://github.com/lakutata/lakutata-packages/commit/9e229a98c74b77393c3dca26cc812564f49a326c))
-
-
-
-
-
-## [1.3.12](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.11...@lakutata/nats@1.3.12) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.11](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.10...@lakutata/nats@1.3.11) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.10](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.9...@lakutata/nats@1.3.10) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.9](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.8...@lakutata/nats@1.3.9) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.8](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.7...@lakutata/nats@1.3.8) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.7](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.6...@lakutata/nats@1.3.7) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.6](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.5...@lakutata/nats@1.3.6) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.5](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.4...@lakutata/nats@1.3.5) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.4](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.3...@lakutata/nats@1.3.4) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.3](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.3...@lakutata/nats@1.3.3) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.3](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.2...@lakutata/nats@1.3.3) (2025-12-13)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.2](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.1...@lakutata/nats@1.3.2) (2025-11-23)
-
-**Note:** Version bump only for package @lakutata/nats
-
-
-
-
-
-## [1.3.1](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.3.0...@lakutata/nats@1.3.1) (2025-11-10)
-
-
-### Bug Fixes
-
-* **nats:** add default timeout for service proxy invocation ([d3f13ec](https://github.com/lakutata/lakutata-packages/commit/d3f13ec0884083e6ae162d1e89241cfad3a3680a))
-
-
-
-
-
-# [1.3.0](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.2.0...@lakutata/nats@1.3.0) (2025-10-16)
-
-
-### Features
-
-* **nats:** add service event system with pub/sub capabilities ([0dbc85a](https://github.com/lakutata/lakutata-packages/commit/0dbc85af81a37ddf21912fc520023928224ab0ee))
-* **nats:** implement service proxy and error handling ([4b9c806](https://github.com/lakutata/lakutata-packages/commit/4b9c8068c3071c9ccc0076d581f82d418cd9711f))
-
-
-
-
-
-# [1.2.0](https://github.com/lakutata/lakutata-packages/compare/@lakutata/nats@1.1.0...@lakutata/nats@1.2.0) (2025-10-14)
-
-
-### Features
-
-* **nats:** add iterator support for NATS subscriptions ([8877dc2](https://github.com/lakutata/lakutata-packages/commit/8877dc2b238a2f7e49bcef516ec452f5423df8f7))
-
-
-
-
-
-# 1.1.0 (2025-09-27)
-
-
-### Features
-
-* **nats:** implement JSON codec for message serialization ([422e56e](https://github.com/lakutata/lakutata-packages/commit/422e56e672172ad2aafde80457e5495f40d4a792))

package/dist/CommonExports.d.ts

@@ -1,19 +0,0 @@
-export { SetupNatsServiceEntrypoint } from './entrypoints/SetupNatsServiceEntrypoint';
-export { ServiceProxy, BuildServiceProxy, type BuildServiceProxyOptions } from './providers/ServiceProxy';
-export { RetentionPolicy } from 'nats';
-export { NATS, buildNatsClientOptions } from './components/NATS';
-export { JSONCodec } from './codecs/JSONCodec';
-export { MessagePackCodec } from './codecs/MessagePackCodec';
-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';
-export { ServiceInvokeException } from './exceptions/ServiceInvokeException';
-export { NatsBulkException } from './exceptions/NatsBulkException';
-//# sourceMappingURL=CommonExports.d.ts.map

package/dist/CommonExports.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CommonExports.d.ts","sourceRoot":"","sources":["../src/CommonExports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,0CAA0C,CAAA;AACnF,OAAO,EAAC,YAAY,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAC,MAAM,0BAA0B,CAAA;AACvG,OAAO,EAAC,eAAe,EAAC,MAAM,MAAM,CAAA;AACpC,OAAO,EAAC,IAAI,EAAE,sBAAsB,EAAC,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAA;AAC1D,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;AACpF,OAAO,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAA;AAC1E,OAAO,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAA"}

package/dist/CommonExports.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NatsBulkException = exports.ServiceInvokeException = exports.NatsRequestTimeoutException = exports.NatsNotFoundException = exports.NatsNoRespondersAvailableException = exports.NatsInternalServerException = exports.NatsForbiddenException = exports.NatsBadRequestException = exports.StringCodec = exports.MessagePackCodec = exports.JSONCodec = exports.buildNatsClientOptions = exports.NATS = exports.RetentionPolicy = exports.BuildServiceProxy = exports.ServiceProxy = exports.SetupNatsServiceEntrypoint = void 0;
-var SetupNatsServiceEntrypoint_1 = require("./entrypoints/SetupNatsServiceEntrypoint");
-Object.defineProperty(exports, "SetupNatsServiceEntrypoint", { enumerable: true, get: function () { return SetupNatsServiceEntrypoint_1.SetupNatsServiceEntrypoint; } });
-var ServiceProxy_1 = require("./providers/ServiceProxy");
-Object.defineProperty(exports, "ServiceProxy", { enumerable: true, get: function () { return ServiceProxy_1.ServiceProxy; } });
-Object.defineProperty(exports, "BuildServiceProxy", { enumerable: true, get: function () { return ServiceProxy_1.BuildServiceProxy; } });
-var nats_1 = require("nats");
-Object.defineProperty(exports, "RetentionPolicy", { enumerable: true, get: function () { return nats_1.RetentionPolicy; } });
-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 MessagePackCodec_1 = require("./codecs/MessagePackCodec");
-Object.defineProperty(exports, "MessagePackCodec", { enumerable: true, get: function () { return MessagePackCodec_1.MessagePackCodec; } });
-var nats_2 = require("nats");
-Object.defineProperty(exports, "StringCodec", { enumerable: true, get: function () { return nats_2.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; } });
-var ServiceInvokeException_1 = require("./exceptions/ServiceInvokeException");
-Object.defineProperty(exports, "ServiceInvokeException", { enumerable: true, get: function () { return ServiceInvokeException_1.ServiceInvokeException; } });
-var NatsBulkException_1 = require("./exceptions/NatsBulkException");
-Object.defineProperty(exports, "NatsBulkException", { enumerable: true, get: function () { return NatsBulkException_1.NatsBulkException; } });

package/dist/codecs/JSONCodec.d.ts

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,15 +0,0 @@
-"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/codecs/MessagePackCodec.d.ts

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

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

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

package/dist/codecs/MessagePackCodec.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MessagePackCodec = void 0;
-const helper_1 = require("lakutata/helper");
-function MessagePackCodec() {
-    return {
-        encode(d) {
-            return helper_1.MessagePack.encode(JSON.parse(JSON.stringify([d])));
-        },
-        decode(a) {
-            const [res] = helper_1.MessagePack.decode(a);
-            return res;
-        }
-    };
-}
-exports.MessagePackCodec = MessagePackCodec;

package/dist/components/NATS.d.ts

@@ -1,252 +0,0 @@
-import { Application, Component, ComponentOptionsBuilder } from 'lakutata';
-import { type Codec, Subscription, type ObjectStoreStatus } 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;
-    /**
-     * Application instance
-     * @protected
-     */
-    protected readonly app: Application;
-    /**
-     * 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;
-    /**
-     * 是否启用 bulk 大数据旁路:启用后启动时建第二条独立连接 + 准备 Object Store。
-     * @default true
-     * @protected
-     */
-    protected readonly bulk?: boolean;
-    /**
-     * bulk Object Store bucket 名,默认 lkt-bulk-${name}。
-     * @protected
-     */
-    protected readonly bulkBucket?: string;
-    /**
-     * bulk 对象 TTL(毫秒),默认 5 分钟。
-     * @protected
-     */
-    protected readonly bulkTTL?: number;
-    /**
-     * bulk bucket 副本数。默认【不下发】此字段,由 server 用其默认单副本;仅在显式配置时才下发。
-     * 重要:绝不能加 .default(),否则字段恒有值、会被无条件下发,在严格校验的 NATS server 上
-     * 触发 "invalid json: unknown field replicas" 导致启动失败(2.2.1 曾因加了 default 而修复无效)。
-     * @protected
-     */
-    protected readonly bulkReplicas?: number;
-    /**
-     * Service event subscription map
-     * @protected
-     */
-    protected readonly serviceEventSubscriptionMap: Map<string, Map<(...args: any[]) => void, Subscription>>;
-    /**
-     * Initializer
-     * @protected
-     */
-    protected init(): Promise<void>;
-    /**
-     * Destroyer
-     * @protected
-     */
-    protected destroy(): Promise<void>;
-    /**
-     * 优雅停机:drain 停止接收新消息、把 in-flight 处理完、flush 出站后再关闭,
-     * 这样 K8s 滚动升级/缩容时正在处理的请求不被硬切断;drain 失败兜底强制关闭。
-     * @param conn
-     * @private
-     */
-    private drainConnection;
-    /**
-     * 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 receives (data, subject) — `subject` is the concrete subject the message
-     *   arrived on, letting wildcard subscribers read routing tokens (e.g. an id embedded in the
-     *   subject) without the publisher having to duplicate them into the payload.
-     * @param subscribeOptions
-     */
-    subscribe(subject: string, callback: (data: any, subject: string) => any | Promise<any>, subscribeOptions?: SubscribeOptions): Subscription;
-    /**
-     * 安全地发出 error 事件:仅在存在监听器时发出。
-     * Node EventEmitter 在没有 'error' 监听器时 emit('error') 会抛出,
-     * 在异步回调里那会变成 unhandled rejection,所以这里加监听器守卫。
-     * @param error
-     * @protected
-     */
-    protected emitError(error: any): void;
-    /**
-     * 是否启用了 bulk 旁路(连接 + Object Store 均就绪)
-     */
-    get bulkEnabled(): boolean;
-    /**
-     * 走 bulk 的字节阈值 = server max_payload × 0.9(从连接 info 自动读,跟随集群配置)
-     */
-    get bulkThreshold(): number;
-    /**
-     * server 是否支持消息 header(从连接 info)
-     */
-    get headersSupported(): boolean;
-    /**
-     * 把一块字节存入 Object Store,返回 objId(供引用中转)。
-     * @param bytes
-     */
-    putBulk(bytes: Uint8Array): Promise<string>;
-    /**
-     * 从 Object Store 取回一块字节。
-     * @param objId
-     */
-    getBulk(objId: string): Promise<Uint8Array>;
-    /**
-     * 删除 Object Store 中的对象(用完即清,失败由 TTL 兜底)。
-     * @param objId
-     */
-    deleteBulk(objId: string): Promise<void>;
-    /**
-     * 返回 bulk Object Store 的运行时状态(bucket/ttl/replicas/storage/size 等);未启用 bulk 返回 undefined。
-     */
-    bulkStatus(): Promise<ObjectStoreStatus | undefined>;
-    /**
-     * 打包待发送 payload:编码后若对端支持中转且超阈值,存入 Object Store 改发小引用。
-     * @param payload
-     * @param peerSupportsBulk 对端是否支持引用中转(不支持只能直传)
-     * @private
-     */
-    private packPayload;
-    /**
-     * 解包收到的字节:若是引用,从 Object Store 取回真实字节再解码(取回后即删,失败靠 TTL 兜底)。
-     * @param bytes
-     * @param isRef
-     * @private
-     */
-    private unpackPayload;
-    /**
-     * Emit service event
-     * @param eventName
-     * @param args
-     */
-    emitServiceEvent(eventName: string, ...args: any[]): this;
-    /**
-     * On service event
-     * @param serviceId
-     * @param eventName
-     * @param listener
-     * @param onlySingleClientReceived
-     */
-    onServiceEvent(serviceId: string, eventName: string, listener: (...args: any[]) => void, onlySingleClientReceived?: boolean): this;
-    /**
-     * Once service event
-     * @param serviceId
-     * @param eventName
-     * @param listener
-     */
-    onceServiceEvent(serviceId: string, eventName: string, listener: (...args: any[]) => void): this;
-    /**
-     * Off server events
-     * @param serviceId
-     * @param eventName
-     * @param listener
-     */
-    offServiceEvent(serviceId: string, eventName: string, listener?: (...args: any[]) => void): this;
-}
-//# sourceMappingURL=NATS.d.ts.map

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

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