@rsdk/nats.kv 5.4.0-rc.0 → 5.4.0

package/CHANGELOG.md

@@ -3,10 +3,26 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [5.4.0-rc.0](https://github.com/R-Vision/rsdk/compare/v5.3.1-rc.1...v5.4.0-rc.0) (2024-12-02)
+## [5.4.0](https://github.com/R-Vision/rsdk/compare/v5.3.0...v5.4.0) (2024-12-15)
 
 **Note:** Version bump only for package @rsdk/nats.kv
 
+## [5.4.0-rc.0](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.11...v5.4.0-rc.0) (2024-12-12)
+
+**Note:** Version bump only for package @rsdk/nats.kv
+
+## [5.4.0-next.11](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.10...v5.4.0-next.11) (2024-12-04)
+
+### Bug Fixes
+
+* **nats:** check bucket existence + watch on application bootstrap + export ([#313](https://github.com/R-Vision/rsdk/issues/313)) ([2ec5768](https://github.com/R-Vision/rsdk/commit/2ec57688038a55b6f86972b0a95e57f38a901a9f))
+
+## [5.4.0-next.10](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.9...v5.4.0-next.10) (2024-12-03)
+
+### Features
+
+* export nats kv/os generators + new bind methods + reconnect env ([#312](https://github.com/R-Vision/rsdk/issues/312)) ([d4302ad](https://github.com/R-Vision/rsdk/commit/d4302ad2122560470712fa4aae91e06e8945fd17))
+
 ## [5.4.0-next.9](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.8...v5.4.0-next.9) (2024-12-02)
 
 **Note:** Version bump only for package @rsdk/nats.kv

package/dist/index.d.ts

@@ -2,5 +2,10 @@ export { NatsKvService } from './nats-kv.service';
 export { WatchKv, type KvWatcher } from './watch-kv.decorator';
 export { NatsKvModule } from './nats-kv.module';
 export * from './inject-kv-service.decorator';
-export * from './kv-storage';
+export * from './nats-kv';
 export * from './tokens.fn';
+export { NatsKvModuleGenerator } from './nats-kv-module.generator';
+export { NatsKvEntry } from './interfaces/nats-kv-entry.interface';
+export { NatsKvEntryMeta } from './interfaces/nats-kv-entry-meta.interface';
+export { NatsKvPlugin } from './nats-kv.plugin';
+export { DecodeFunc } from './types/decode-func.type';

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NatsKvModule = exports.WatchKv = exports.NatsKvService = void 0;
+exports.NatsKvPlugin = exports.NatsKvModuleGenerator = exports.NatsKvModule = exports.WatchKv = exports.NatsKvService = void 0;
 var nats_kv_service_1 = require("./nats-kv.service");
 Object.defineProperty(exports, "NatsKvService", { enumerable: true, get: function () { return nats_kv_service_1.NatsKvService; } });
 var watch_kv_decorator_1 = require("./watch-kv.decorator");
@@ -22,6 +22,10 @@ Object.defineProperty(exports, "WatchKv", { enumerable: true, get: function () {
 var nats_kv_module_1 = require("./nats-kv.module");
 Object.defineProperty(exports, "NatsKvModule", { enumerable: true, get: function () { return nats_kv_module_1.NatsKvModule; } });
 __exportStar(require("./inject-kv-service.decorator"), exports);
-__exportStar(require("./kv-storage"), exports);
+__exportStar(require("./nats-kv"), exports);
 __exportStar(require("./tokens.fn"), exports);
+var nats_kv_module_generator_1 = require("./nats-kv-module.generator");
+Object.defineProperty(exports, "NatsKvModuleGenerator", { enumerable: true, get: function () { return nats_kv_module_generator_1.NatsKvModuleGenerator; } });
+var nats_kv_plugin_1 = require("./nats-kv.plugin");
+Object.defineProperty(exports, "NatsKvPlugin", { enumerable: true, get: function () { return nats_kv_plugin_1.NatsKvPlugin; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAkD;AAAzC,gHAAA,aAAa,OAAA;AACtB,2DAA+D;AAAtD,6GAAA,OAAO,OAAA;AAChB,mDAAgD;AAAvC,8GAAA,YAAY,OAAA;AACrB,gEAA8C;AAC9C,+CAA6B;AAC7B,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAkD;AAAzC,gHAAA,aAAa,OAAA;AACtB,2DAA+D;AAAtD,6GAAA,OAAO,OAAA;AAChB,mDAAgD;AAAvC,8GAAA,YAAY,OAAA;AACrB,gEAA8C;AAC9C,4CAA0B;AAC1B,8CAA4B;AAC5B,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAG9B,mDAAgD;AAAvC,8GAAA,YAAY,OAAA"}

package/dist/inject-kv-service.decorator.d.ts

@@ -1,2 +1,5 @@
-export declare const InjectKvService: (connectionName?: string) => ParameterDecorator;
-export declare const InjectNatsKv: (bucketName: string, connectionName?: string) => ParameterDecorator;
+export declare const InjectNatsKvService: (connectionName?: string) => ParameterDecorator;
+export declare const InjectNatsKv: (bucketName: string, opts?: {
+    connectionName?: string;
+    domain?: string;
+}) => ParameterDecorator;

package/dist/inject-kv-service.decorator.js

@@ -1,17 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InjectNatsKv = exports.InjectKvService = void 0;
+exports.InjectNatsKv = exports.InjectNatsKvService = void 0;
 const common_1 = require("@nestjs/common");
 const metadata_1 = require("@rsdk/metadata");
 const nats_kv_module_generator_1 = require("./nats-kv-module.generator");
 const tokens_fn_1 = require("./tokens.fn");
-const InjectKvService = (connectionName) => (0, common_1.Inject)((0, tokens_fn_1.createKvServiceToken)(connectionName));
-exports.InjectKvService = InjectKvService;
-const InjectNatsKv = (bucketName, connectionName) => {
+const InjectNatsKvService = (connectionName) => (0, common_1.Inject)((0, tokens_fn_1.createKvServiceToken)(connectionName));
+exports.InjectNatsKvService = InjectNatsKvService;
+const InjectNatsKv = (bucketName, opts) => {
     return (target, propertyKey, parameterIndex) => {
-        (0, common_1.Inject)((0, tokens_fn_1.createKvToken)(bucketName, connectionName))(target, propertyKey, parameterIndex);
-        const key = `nats-kv:${bucketName}${connectionName ? `:${connectionName}` : ''}`;
-        const moduleDefinition = nats_kv_module_generator_1.NatsKvModuleGenerator.createClientModuleDefinition(target, bucketName, connectionName);
+        (0, common_1.Inject)((0, tokens_fn_1.createKvToken)(bucketName, opts?.connectionName))(target, propertyKey, parameterIndex);
+        const key = `nats-kv:${bucketName}${opts?.connectionName ? `:${opts.connectionName}` : ''}`;
+        const moduleDefinition = nats_kv_module_generator_1.NatsKvModuleGenerator.createClientModuleDefinition(target, bucketName, opts);
         metadata_1.RsdkMetadata.setWithScope(target, metadata_1.PLATFORM_RAW_GLOBAL_METADATA_SCOPE, key, moduleDefinition, true);
     };
 };

package/dist/inject-kv-service.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject-kv-service.decorator.js","sourceRoot":"","sources":["../src/inject-kv-service.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,6CAGwB;AAExB,yEAAmE;AACnE,2CAAkE;AAE3D,MAAM,eAAe,GAAG,CAAC,cAAuB,EAAsB,EAAE,CAC7E,IAAA,eAAM,EAAC,IAAA,gCAAoB,EAAC,cAAc,CAAC,CAAC,CAAC;AADlC,QAAA,eAAe,mBACmB;AAExC,MAAM,YAAY,GAAG,CAC1B,UAAkB,EAClB,cAAuB,EACH,EAAE;IACtB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC7C,IAAA,eAAM,EAAC,IAAA,yBAAa,EAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAC/C,MAAM,EACN,WAAW,EACX,cAAc,CACf,CAAC;QAEF,MAAM,GAAG,GAAG,WAAW,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACjF,MAAM,gBAAgB,GAAG,gDAAqB,CAAC,4BAA4B,CACzE,MAAM,EACN,UAAU,EACV,cAAc,CACf,CAAC;QAEF,uBAAY,CAAC,YAAY,CACvB,MAAM,EACN,6CAAkC,EAClC,GAAG,EACH,gBAAgB,EAChB,IAAI,CACL,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC;AA1BW,QAAA,YAAY,gBA0BvB"}
+{"version":3,"file":"inject-kv-service.decorator.js","sourceRoot":"","sources":["../src/inject-kv-service.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,6CAGwB;AAExB,yEAAmE;AACnE,2CAAkE;AAE3D,MAAM,mBAAmB,GAAG,CACjC,cAAuB,EACH,EAAE,CAAC,IAAA,eAAM,EAAC,IAAA,gCAAoB,EAAC,cAAc,CAAC,CAAC,CAAC;AAFzD,QAAA,mBAAmB,uBAEsC;AAE/D,MAAM,YAAY,GAAG,CAC1B,UAAkB,EAClB,IAAmD,EAC/B,EAAE;IACtB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC7C,IAAA,eAAM,EAAC,IAAA,yBAAa,EAAC,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CACrD,MAAM,EACN,WAAW,EACX,cAAc,CACf,CAAC;QAEF,MAAM,GAAG,GAAG,WAAW,UAAU,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC5F,MAAM,gBAAgB,GAAG,gDAAqB,CAAC,4BAA4B,CACzE,MAAM,EACN,UAAU,EACV,IAAI,CACL,CAAC;QAEF,uBAAY,CAAC,YAAY,CACvB,MAAM,EACN,6CAAkC,EAClC,GAAG,EACH,gBAAgB,EAChB,IAAI,CACL,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC;AA1BW,QAAA,YAAY,gBA0BvB"}

package/dist/module-options.interface.d.ts

@@ -0,0 +1,3 @@
+export interface ModuleOptions {
+    connectionName?: string | undefined;
+}

package/dist/module-options.interface.js

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

package/dist/module-options.interface.js.map

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

package/dist/nats-kv-module.generator.d.ts

@@ -1,5 +1,11 @@
-import type { DynamicModule } from '@nestjs/common';
+import type { DynamicModule, FactoryProvider } from '@nestjs/common';
 export declare class NatsKvModuleGenerator {
-    static createClientModuleDefinition(target: object, bucketName: string, connectionName?: string): DynamicModule;
-    private static createClientProvider;
+    static createClientModuleDefinition(target: object, bucketName: string, opts?: {
+        connectionName?: string;
+        domain?: string;
+    }): DynamicModule;
+    static createClientProvider(bucketName: string, opts?: {
+        connectionName?: string;
+        domain?: string;
+    }): FactoryProvider;
 }

package/dist/nats-kv-module.generator.js

@@ -6,23 +6,23 @@ const constants_1 = require("./constants");
 const nats_kv_module_1 = require("./nats-kv.module");
 const tokens_fn_1 = require("./tokens.fn");
 class NatsKvModuleGenerator {
-    static createClientModuleDefinition(target, bucketName, connectionName) {
-        const provider = NatsKvModuleGenerator.createClientProvider(bucketName, connectionName);
+    static createClientModuleDefinition(target, bucketName, opts) {
+        const provider = NatsKvModuleGenerator.createClientProvider(bucketName, opts);
         const moduleDefinition = {
             global: true,
-            imports: [nats_kv_module_1.NatsKvModule.forFeature(connectionName)],
+            imports: [nats_kv_module_1.NatsKvModule.forFeature(opts ?? {})],
             module: NatsKvModuleGenerator,
             providers: [provider],
             exports: [provider],
         };
-        metadata_1.RsdkMetadata.add(target, { bucketName, connectionName }, constants_1.NATS_KV_STORAGES_RSDK_METADATA_SCOPE);
+        metadata_1.RsdkMetadata.add(target, { bucketName, ...opts }, constants_1.NATS_KV_STORAGES_RSDK_METADATA_SCOPE);
         return moduleDefinition;
     }
-    static createClientProvider(bucketName, connectionName) {
+    static createClientProvider(bucketName, opts) {
         return {
-            provide: (0, tokens_fn_1.createKvToken)(bucketName, connectionName),
-            inject: [(0, tokens_fn_1.createKvServiceToken)(connectionName)],
-            useFactory: (service) => service.create({ bucketName, bindOnly: true }),
+            provide: (0, tokens_fn_1.createKvToken)(bucketName, opts?.connectionName),
+            inject: [(0, tokens_fn_1.createKvServiceToken)(opts?.connectionName)],
+            useFactory: (service) => service.bind({ bucketName, ...opts }),
         };
     }
 }

package/dist/nats-kv-module.generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"nats-kv-module.generator.js","sourceRoot":"","sources":["../src/nats-kv-module.generator.ts"],"names":[],"mappings":";;;AACA,6CAA8C;AAE9C,2CAAmE;AAEnE,qDAAgD;AAEhD,2CAAkE;AAElE,MAAa,qBAAqB;IAChC,MAAM,CAAC,4BAA4B,CACjC,MAAc,EACd,UAAkB,EAClB,cAAuB;QAEvB,MAAM,QAAQ,GAAG,qBAAqB,CAAC,oBAAoB,CACzD,UAAU,EACV,cAAc,CACf,CAAC;QAEF,MAAM,gBAAgB,GAAkB;YACtC,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,CAAC,6BAAY,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YAClD,MAAM,EAAE,qBAAqB;YAC7B,SAAS,EAAE,CAAC,QAAQ,CAAC;YACrB,OAAO,EAAE,CAAC,QAAQ,CAAC;SACpB,CAAC;QAEF,uBAAY,CAAC,GAAG,CACd,MAAM,EACN,EAAE,UAAU,EAAE,cAAc,EAAE,EAC9B,gDAAoC,CACrC,CAAC;QAEF,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAEO,MAAM,CAAC,oBAAoB,CACjC,UAAkB,EAClB,cAAuB;QAEvB,OAAO;YACL,OAAO,EAAE,IAAA,yBAAa,EAAC,UAAU,EAAE,cAAc,CAAC;YAClD,MAAM,EAAE,CAAC,IAAA,gCAAoB,EAAC,cAAc,CAAC,CAAC;YAC9C,UAAU,EAAE,CAAC,OAAsB,EAAsB,EAAE,CACzD,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC;CACF;AAvCD,sDAuCC"}
+{"version":3,"file":"nats-kv-module.generator.js","sourceRoot":"","sources":["../src/nats-kv-module.generator.ts"],"names":[],"mappings":";;;AACA,6CAA8C;AAE9C,2CAAmE;AAEnE,qDAAgD;AAEhD,2CAAkE;AAElE,MAAa,qBAAqB;IAChC,MAAM,CAAC,4BAA4B,CACjC,MAAc,EACd,UAAkB,EAClB,IAAmD;QAEnD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,oBAAoB,CACzD,UAAU,EACV,IAAI,CACL,CAAC;QAEF,MAAM,gBAAgB,GAAkB;YACtC,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,CAAC,6BAAY,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,EAAE,qBAAqB;YAC7B,SAAS,EAAE,CAAC,QAAQ,CAAC;YACrB,OAAO,EAAE,CAAC,QAAQ,CAAC;SACpB,CAAC;QAEF,uBAAY,CAAC,GAAG,CACd,MAAM,EACN,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,EACvB,gDAAoC,CACrC,CAAC;QAEF,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,oBAAoB,CACzB,UAAkB,EAClB,IAAmD;QAEnD,OAAO;YACL,OAAO,EAAE,IAAA,yBAAa,EAAC,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC;YACxD,MAAM,EAAE,CAAC,IAAA,gCAAoB,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACpD,UAAU,EAAE,CAAC,OAAsB,EAAmB,EAAE,CACtD,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,CAAC;SACxC,CAAC;IACJ,CAAC;CACF;AAvCD,sDAuCC"}

package/dist/{kv-storage.d.ts → nats-kv.d.ts}

@@ -3,7 +3,7 @@ import type { KV, KvDeleteOptions, KvPutOptions, KvStatus, NatsConnection, Paylo
 import type { NatsKvEntry } from './interfaces/nats-kv-entry.interface';
 import type { NatsKvEntryMeta } from './interfaces/nats-kv-entry-meta.interface';
 import type { DecodeFunc } from './types/decode-func.type';
-export declare class KvStorage {
+export declare class NatsKv {
     private readonly storage;
     private readonly logger;
     private readonly bucketName;

package/dist/{kv-storage.js → nats-kv.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KvStorage = void 0;
+exports.NatsKv = void 0;
 const nats_1 = require("nats");
-class KvStorage {
+class NatsKv {
     storage;
     logger;
     bucketName;
@@ -118,5 +118,5 @@ class KvStorage {
         };
     }
 }
-exports.KvStorage = KvStorage;
-//# sourceMappingURL=kv-storage.js.map
+exports.NatsKv = NatsKv;
+//# sourceMappingURL=nats-kv.js.map

package/dist/nats-kv.js.map

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

package/dist/nats-kv.module.d.ts

@@ -1,9 +1,10 @@
-import type { DynamicModule, OnModuleDestroy, OnModuleInit } from '@nestjs/common';
+import type { DynamicModule, OnApplicationBootstrap, OnApplicationShutdown } from '@nestjs/common';
+import type { ModuleOptions } from './module-options.interface';
 import { WatchKvService } from './watch-kv.service';
-export declare class NatsKvModule implements OnModuleInit, OnModuleDestroy {
+export declare class NatsKvModule implements OnApplicationBootstrap, OnApplicationShutdown {
     private readonly watchKvService;
     constructor(watchKvService: WatchKvService);
-    static forFeature(connectionName?: string): DynamicModule;
-    onModuleInit(): Promise<void>;
-    onModuleDestroy(): Promise<void>;
+    static forFeature({ connectionName }: ModuleOptions): DynamicModule;
+    onApplicationBootstrap(): Promise<void>;
+    onApplicationShutdown(): Promise<void>;
 }

package/dist/nats-kv.module.js

@@ -22,13 +22,14 @@ let NatsKvModule = NatsKvModule_1 = class NatsKvModule {
     constructor(watchKvService) {
         this.watchKvService = watchKvService;
     }
-    static forFeature(connectionName) {
+    static forFeature({ connectionName }) {
         const clientProvider = {
             provide: (0, tokens_fn_1.createKvServiceToken)(connectionName),
             useClass: nats_kv_service_1.NatsKvService,
         };
         return {
             module: NatsKvModule_1,
+            global: true,
             providers: [
                 {
                     provide: nats_common_1.NATS_CLIENT_INJECTION_TOKEN_FOR_PACKAGE,
@@ -36,6 +37,12 @@ let NatsKvModule = NatsKvModule_1 = class NatsKvModule {
                         ? (0, nats_common_1.createNatsClientToken)(connectionName)
                         : nats_common_1.NATS_CLIENT_INJECTION_TOKEN,
                 },
+                {
+                    provide: nats_common_1.NATS_CONFIG_INJECTION_TOKEN_FOR_PACKAGE,
+                    useExisting: connectionName
+                        ? (0, nats_common_1.createNatsConfigToken)(connectionName)
+                        : nats_common_1.NATS_CONFIG_INJECTION_TOKEN,
+                },
                 {
                     provide: 'CONNECTION_NAME',
                     useFactory: () => connectionName,
@@ -45,10 +52,10 @@ let NatsKvModule = NatsKvModule_1 = class NatsKvModule {
             exports: [clientProvider],
         };
     }
-    async onModuleInit() {
+    async onApplicationBootstrap() {
         await this.watchKvService?.runWatches();
     }
-    async onModuleDestroy() {
+    async onApplicationShutdown() {
         await this.watchKvService?.stopWatches();
     }
 };

package/dist/nats-kv.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"nats-kv.module.js","sourceRoot":"","sources":["../src/nats-kv.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAMA,2CAAwC;AACxC,uCAA+C;AAC/C,mDAI2B;AAE3B,uDAAkD;AAClD,2CAAmD;AACnD,yDAAoD;AAM7C,IAAM,YAAY,oBAAlB,MAAM,YAAY;IACM;IAA7B,YAA6B,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAExD,MAAM,CAAC,UAAU,CAAC,cAAuB;QAC9C,MAAM,cAAc,GAAa;YAC/B,OAAO,EAAE,IAAA,gCAAoB,EAAC,cAAc,CAAC;YAC7C,QAAQ,EAAE,+BAAa;SACxB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,qDAAuC;oBAChD,WAAW,EAAE,cAAc;wBACzB,CAAC,CAAC,IAAA,mCAAqB,EAAC,cAAc,CAAC;wBACvC,CAAC,CAAC,yCAA2B;iBAChC;gBACD;oBACE,OAAO,EAAE,iBAAiB;oBAC1B,UAAU,EAAE,GAAG,EAAE,CAAC,cAAc;iBACjC;gBACD,cAAc;aACf;YACD,OAAO,EAAE,CAAC,cAAc,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,cAAc,EAAE,UAAU,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,MAAM,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC;IAC3C,CAAC;CACF,CAAA;AAnCY,oCAAY;uBAAZ,YAAY;IAJxB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,sBAAe,CAAC;QAC1B,SAAS,EAAE,CAAC,+BAAa,EAAE,iCAAc,CAAC;KAC3C,CAAC;qCAE6C,iCAAc;GADhD,YAAY,CAmCxB"}
+{"version":3,"file":"nats-kv.module.js","sourceRoot":"","sources":["../src/nats-kv.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAMA,2CAAwC;AACxC,uCAA+C;AAC/C,mDAO2B;AAG3B,uDAAkD;AAClD,2CAAmD;AACnD,yDAAoD;AAM7C,IAAM,YAAY,oBAAlB,MAAM,YAAY;IAGM;IAA7B,YAA6B,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAExD,MAAM,CAAC,UAAU,CAAC,EAAE,cAAc,EAAiB;QACxD,MAAM,cAAc,GAAa;YAC/B,OAAO,EAAE,IAAA,gCAAoB,EAAC,cAAc,CAAC;YAC7C,QAAQ,EAAE,+BAAa;SACxB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,qDAAuC;oBAChD,WAAW,EAAE,cAAc;wBACzB,CAAC,CAAC,IAAA,mCAAqB,EAAC,cAAc,CAAC;wBACvC,CAAC,CAAC,yCAA2B;iBAChC;gBACD;oBACE,OAAO,EAAE,qDAAuC;oBAChD,WAAW,EAAE,cAAc;wBACzB,CAAC,CAAC,IAAA,mCAAqB,EAAC,cAAc,CAAC;wBACvC,CAAC,CAAC,yCAA2B;iBAChC;gBACD;oBACE,OAAO,EAAE,iBAAiB;oBAC1B,UAAU,EAAE,GAAG,EAAE,CAAC,cAAc;iBACjC;gBACD,cAAc;aACf;YACD,OAAO,EAAE,CAAC,cAAc,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,sBAAsB;QAC1B,MAAM,IAAI,CAAC,cAAc,EAAE,UAAU,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,MAAM,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC;IAC3C,CAAC;CACF,CAAA;AA5CY,oCAAY;uBAAZ,YAAY;IAJxB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,sBAAe,CAAC;QAC1B,SAAS,EAAE,CAAC,+BAAa,EAAE,iCAAc,CAAC;KAC3C,CAAC;qCAI6C,iCAAc;GAHhD,YAAY,CA4CxB"}

package/dist/nats-kv.plugin.d.ts

@@ -0,0 +1,10 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { Constructor } from '@rsdk/common';
+import type { AppropriateTransports, PlatformAppPlugin } from '@rsdk/core';
+import type { ModuleOptions } from './module-options.interface';
+export declare class NatsKvPlugin implements PlatformAppPlugin {
+    private readonly options?;
+    constructor(options?: ModuleOptions | undefined);
+    forTransports(): AppropriateTransports;
+    modules(): (DynamicModule | Constructor)[];
+}

package/dist/nats-kv.plugin.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsKvPlugin = void 0;
+const nats_kv_module_1 = require("./nats-kv.module");
+class NatsKvPlugin {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    forTransports() {
+        return 'any';
+    }
+    modules() {
+        return [nats_kv_module_1.NatsKvModule.forFeature(this.options ?? {})];
+    }
+}
+exports.NatsKvPlugin = NatsKvPlugin;
+//# sourceMappingURL=nats-kv.plugin.js.map

package/dist/nats-kv.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-kv.plugin.js","sourceRoot":"","sources":["../src/nats-kv.plugin.ts"],"names":[],"mappings":";;;AAKA,qDAAgD;AAEhD,MAAa,YAAY;IACM;IAA7B,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,aAAa;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,OAAO,CAAC,6BAAY,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;CACF;AAVD,oCAUC"}

package/dist/nats-kv.service.d.ts

@@ -1,18 +1,27 @@
 import { ILogger } from '@rsdk/logging';
+import { DefaultNatsConfig } from '@rsdk/nats.common';
 import { NatsConnection } from 'nats';
 import type { KvOptions } from 'nats/lib/jetstream/types';
-import { KvStorage } from './kv-storage';
+import { NatsKv } from './nats-kv';
 export declare class NatsKvService {
     private readonly logger;
     private readonly nats;
-    constructor(logger: ILogger, nats: NatsConnection);
+    private readonly config;
+    constructor(logger: ILogger, nats: NatsConnection, config: DefaultNatsConfig);
     /**
      * Gets or creates a JetStream KV store
      */
-    create({ bucketName, domain, ...opts }: Partial<KvOptions> & {
+    create({ bucketName, domain, ...opts }: Partial<Omit<KvOptions, 'bindOnly'>> & {
         bucketName: string;
         domain?: string;
-    }): Promise<KvStorage>;
+    }): Promise<NatsKv>;
+    /**
+     * Gets a JetStream KV store
+     */
+    bind({ bucketName, domain, ...opts }: Partial<Omit<KvOptions, 'bindOnly'>> & {
+        bucketName: string;
+        domain?: string;
+    }): Promise<NatsKv>;
     /**
      * Waits for the specified bucket to exist.
      *

package/dist/nats-kv.service.js

@@ -17,34 +17,56 @@ const common_1 = require("@nestjs/common");
 const common_2 = require("@rsdk/common");
 const core_1 = require("@rsdk/core");
 const nats_common_1 = require("@rsdk/nats.common");
-const kv_storage_1 = require("./kv-storage");
+const nats_kv_1 = require("./nats-kv");
 let NatsKvService = class NatsKvService {
     logger;
     nats;
-    constructor(logger, nats) {
+    config;
+    constructor(logger, nats, config) {
         this.logger = logger;
         this.nats = nats;
+        this.config = config;
     }
     /**
      * Gets or creates a JetStream KV store
      */
     async create({ bucketName, domain, ...opts }) {
-        const jsOptions = domain ? { domain } : undefined;
+        const js = this.nats.jetstream({
+            domain: domain ?? this.config.defaultJetStreamDomain,
+        });
         try {
-            const kv = await this.nats
-                .jetstream(jsOptions)
-                .views.kv(bucketName, opts);
-            if (opts.bindOnly && !(await kv.status())) {
-                throw new common_1.NotFoundException(`Nats KV ${bucketName} not found`);
-            }
+            const kv = await js.views.kv(bucketName, opts);
             this.logger.trace('KV store initialized', {
                 connectionName: this.nats.info,
                 bucketName,
             });
-            return new kv_storage_1.KvStorage(kv, this.logger, bucketName, this.nats);
+            return new nats_kv_1.NatsKv(kv, this.logger, bucketName, this.nats);
         }
         catch (error) {
-            this.logger.error('Failed to get or create KV store', {
+            this.logger.error('Failed to create KV store', {
+                err: error,
+                bucketName,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Gets a JetStream KV store
+     */
+    async bind({ bucketName, domain, ...opts }) {
+        const js = this.nats.jetstream({
+            domain: domain ?? this.config.defaultJetStreamDomain,
+        });
+        try {
+            const kv = await js.views.kv(bucketName, { ...opts, bindOnly: true });
+            this.logger.trace('KV store bound', {
+                connectionName: this.nats.info,
+                bucketName,
+            });
+            return new nats_kv_1.NatsKv(kv, this.logger, bucketName, this.nats);
+        }
+        catch (error) {
+            this.logger.error('Failed to get KV store', {
                 err: error,
                 bucketName,
             });
@@ -82,7 +104,9 @@ let NatsKvService = class NatsKvService {
      */
     async isBucketExists(bucketName) {
         try {
-            const kv = await this.create({ bucketName, bindOnly: true });
+            const kv = await this.nats
+                .jetstream()
+                .views.kv(bucketName, { bindOnly: true });
             await kv.status();
         }
         catch {
@@ -96,6 +120,7 @@ exports.NatsKvService = NatsKvService = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, core_1.InjectLogger)(NatsKvService)),
     __param(1, (0, common_1.Inject)(nats_common_1.NATS_CLIENT_INJECTION_TOKEN_FOR_PACKAGE)),
-    __metadata("design:paramtypes", [Object, Object])
+    __param(2, (0, common_1.Inject)(nats_common_1.NATS_CONFIG_INJECTION_TOKEN_FOR_PACKAGE)),
+    __metadata("design:paramtypes", [Object, Object, nats_common_1.DefaultNatsConfig])
 ], NatsKvService);
 //# sourceMappingURL=nats-kv.service.js.map

package/dist/nats-kv.service.js.map

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

package/dist/watch-kv.service.js

@@ -65,9 +65,8 @@ let WatchKvService = class WatchKvService {
      * @returns A Promise that resolves when the watch operation is complete.
      */
     async runWatch(config, watcher) {
-        const kv = await this.nats.create({
+        const kv = await this.nats.bind({
             bucketName: config.bucket,
-            bindOnly: true,
         });
         this.watch(kv.getRawStorage(), { include: nats_1.KvWatchInclude.LastValue }, async (event) => {
             switch (event.operation) {

package/dist/watch-kv.service.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsdk/nats.kv",
-  "version": "5.4.0-rc.0",
+  "version": "5.4.0",
   "description": "Nats NestJS key-Value storage",
   "main": "dist/index.js",
   "license": "Apache License 2.0",
@@ -38,5 +38,5 @@
     "rxjs": "^7.8.1"
   },
   "nx": {},
-  "gitHead": "4083b1a0b34f2d26f2850c9b17db386a4ec17f99"
+  "gitHead": "042109a747dbe31c009f6c1f230596f79c064328"
 }

package/src/index.ts

@@ -2,5 +2,10 @@ export { NatsKvService } from './nats-kv.service';
 export { WatchKv, type KvWatcher } from './watch-kv.decorator';
 export { NatsKvModule } from './nats-kv.module';
 export * from './inject-kv-service.decorator';
-export * from './kv-storage';
+export * from './nats-kv';
 export * from './tokens.fn';
+export { NatsKvModuleGenerator } from './nats-kv-module.generator';
+export { NatsKvEntry } from './interfaces/nats-kv-entry.interface';
+export { NatsKvEntryMeta } from './interfaces/nats-kv-entry-meta.interface';
+export { NatsKvPlugin } from './nats-kv.plugin';
+export { DecodeFunc } from './types/decode-func.type';

package/src/inject-kv-service.decorator.ts

@@ -7,25 +7,26 @@ import {
 import { NatsKvModuleGenerator } from './nats-kv-module.generator';
 import { createKvServiceToken, createKvToken } from './tokens.fn';
 
-export const InjectKvService = (connectionName?: string): ParameterDecorator =>
-  Inject(createKvServiceToken(connectionName));
+export const InjectNatsKvService = (
+  connectionName?: string,
+): ParameterDecorator => Inject(createKvServiceToken(connectionName));
 
 export const InjectNatsKv = (
   bucketName: string,
-  connectionName?: string,
+  opts?: { connectionName?: string; domain?: string },
 ): ParameterDecorator => {
   return (target, propertyKey, parameterIndex) => {
-    Inject(createKvToken(bucketName, connectionName))(
+    Inject(createKvToken(bucketName, opts?.connectionName))(
       target,
       propertyKey,
       parameterIndex,
     );
 
-    const key = `nats-kv:${bucketName}${connectionName ? `:${connectionName}` : ''}`;
+    const key = `nats-kv:${bucketName}${opts?.connectionName ? `:${opts.connectionName}` : ''}`;
     const moduleDefinition = NatsKvModuleGenerator.createClientModuleDefinition(
       target,
       bucketName,
-      connectionName,
+      opts,
     );
 
     RsdkMetadata.setWithScope(

package/src/module-options.interface.ts

@@ -0,0 +1,3 @@
+export interface ModuleOptions {
+  connectionName?: string | undefined;
+}

package/src/nats-kv-module.generator.ts

@@ -2,7 +2,7 @@ import type { DynamicModule, FactoryProvider } from '@nestjs/common';
 import { RsdkMetadata } from '@rsdk/metadata';
 
 import { NATS_KV_STORAGES_RSDK_METADATA_SCOPE } from './constants';
-import type { KvStorage } from './kv-storage';
+import type { NatsKv } from './nats-kv';
 import { NatsKvModule } from './nats-kv.module';
 import type { NatsKvService } from './nats-kv.service';
 import { createKvServiceToken, createKvToken } from './tokens.fn';
@@ -11,16 +11,16 @@ export class NatsKvModuleGenerator {
   static createClientModuleDefinition(
     target: object,
     bucketName: string,
-    connectionName?: string,
+    opts?: { connectionName?: string; domain?: string },
   ): DynamicModule {
     const provider = NatsKvModuleGenerator.createClientProvider(
       bucketName,
-      connectionName,
+      opts,
     );
 
     const moduleDefinition: DynamicModule = {
       global: true,
-      imports: [NatsKvModule.forFeature(connectionName)],
+      imports: [NatsKvModule.forFeature(opts ?? {})],
       module: NatsKvModuleGenerator,
       providers: [provider],
       exports: [provider],
@@ -28,22 +28,22 @@ export class NatsKvModuleGenerator {
 
     RsdkMetadata.add(
       target,
-      { bucketName, connectionName },
+      { bucketName, ...opts },
       NATS_KV_STORAGES_RSDK_METADATA_SCOPE,
     );
 
     return moduleDefinition;
   }
 
-  private static createClientProvider(
+  static createClientProvider(
     bucketName: string,
-    connectionName?: string,
+    opts?: { connectionName?: string; domain?: string },
   ): FactoryProvider {
     return {
-      provide: createKvToken(bucketName, connectionName),
-      inject: [createKvServiceToken(connectionName)],
-      useFactory: (service: NatsKvService): Promise<KvStorage> =>
-        service.create({ bucketName, bindOnly: true }),
+      provide: createKvToken(bucketName, opts?.connectionName),
+      inject: [createKvServiceToken(opts?.connectionName)],
+      useFactory: (service: NatsKvService): Promise<NatsKv> =>
+        service.bind({ bucketName, ...opts }),
     };
   }
 }

package/src/nats-kv.module.ts

@@ -1,17 +1,21 @@
 import type {
   DynamicModule,
-  OnModuleDestroy,
-  OnModuleInit,
+  OnApplicationBootstrap,
+  OnApplicationShutdown,
   Provider,
 } from '@nestjs/common';
 import { Module } from '@nestjs/common';
 import { DiscoveryModule } from '@nestjs/core';
 import {
   createNatsClientToken,
+  createNatsConfigToken,
   NATS_CLIENT_INJECTION_TOKEN,
   NATS_CLIENT_INJECTION_TOKEN_FOR_PACKAGE,
+  NATS_CONFIG_INJECTION_TOKEN,
+  NATS_CONFIG_INJECTION_TOKEN_FOR_PACKAGE,
 } from '@rsdk/nats.common';
 
+import type { ModuleOptions } from './module-options.interface';
 import { NatsKvService } from './nats-kv.service';
 import { createKvServiceToken } from './tokens.fn';
 import { WatchKvService } from './watch-kv.service';
@@ -20,10 +24,12 @@ import { WatchKvService } from './watch-kv.service';
   imports: [DiscoveryModule],
   providers: [NatsKvService, WatchKvService],
 })
-export class NatsKvModule implements OnModuleInit, OnModuleDestroy {
+export class NatsKvModule
+  implements OnApplicationBootstrap, OnApplicationShutdown
+{
   constructor(private readonly watchKvService: WatchKvService) {}
 
-  public static forFeature(connectionName?: string): DynamicModule {
+  public static forFeature({ connectionName }: ModuleOptions): DynamicModule {
     const clientProvider: Provider = {
       provide: createKvServiceToken(connectionName),
       useClass: NatsKvService,
@@ -31,6 +37,7 @@ export class NatsKvModule implements OnModuleInit, OnModuleDestroy {
 
     return {
       module: NatsKvModule,
+      global: true,
       providers: [
         {
           provide: NATS_CLIENT_INJECTION_TOKEN_FOR_PACKAGE,
@@ -38,6 +45,12 @@ export class NatsKvModule implements OnModuleInit, OnModuleDestroy {
             ? createNatsClientToken(connectionName)
             : NATS_CLIENT_INJECTION_TOKEN,
         },
+        {
+          provide: NATS_CONFIG_INJECTION_TOKEN_FOR_PACKAGE,
+          useExisting: connectionName
+            ? createNatsConfigToken(connectionName)
+            : NATS_CONFIG_INJECTION_TOKEN,
+        },
         {
           provide: 'CONNECTION_NAME',
           useFactory: () => connectionName,
@@ -48,11 +61,11 @@ export class NatsKvModule implements OnModuleInit, OnModuleDestroy {
     };
   }
 
-  async onModuleInit(): Promise<void> {
+  async onApplicationBootstrap(): Promise<void> {
     await this.watchKvService?.runWatches();
   }
 
-  async onModuleDestroy(): Promise<void> {
+  async onApplicationShutdown(): Promise<void> {
     await this.watchKvService?.stopWatches();
   }
 }

package/src/nats-kv.plugin.ts

@@ -0,0 +1,18 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { Constructor } from '@rsdk/common';
+import type { AppropriateTransports, PlatformAppPlugin } from '@rsdk/core';
+
+import type { ModuleOptions } from './module-options.interface';
+import { NatsKvModule } from './nats-kv.module';
+
+export class NatsKvPlugin implements PlatformAppPlugin {
+  constructor(private readonly options?: ModuleOptions) {}
+
+  forTransports(): AppropriateTransports {
+    return 'any';
+  }
+
+  modules(): (DynamicModule | Constructor)[] {
+    return [NatsKvModule.forFeature(this.options ?? {})];
+  }
+}

package/src/nats-kv.service.ts

@@ -1,12 +1,16 @@
-import { Inject, Injectable, NotFoundException } from '@nestjs/common';
+import { Inject, Injectable } from '@nestjs/common';
 import { delay, Timespan } from '@rsdk/common';
 import { InjectLogger, InternalException } from '@rsdk/core';
 import { ILogger } from '@rsdk/logging';
-import { NATS_CLIENT_INJECTION_TOKEN_FOR_PACKAGE } from '@rsdk/nats.common';
+import {
+  DefaultNatsConfig,
+  NATS_CLIENT_INJECTION_TOKEN_FOR_PACKAGE,
+  NATS_CONFIG_INJECTION_TOKEN_FOR_PACKAGE,
+} from '@rsdk/nats.common';
 import { NatsConnection } from 'nats';
 import type { KvOptions } from 'nats/lib/jetstream/types';
 
-import { KvStorage } from './kv-storage';
+import { NatsKv } from './nats-kv';
 
 @Injectable()
 export class NatsKvService {
@@ -15,6 +19,8 @@ export class NatsKvService {
     private readonly logger: ILogger,
     @Inject(NATS_CLIENT_INJECTION_TOKEN_FOR_PACKAGE)
     private readonly nats: NatsConnection,
+    @Inject(NATS_CONFIG_INJECTION_TOKEN_FOR_PACKAGE)
+    private readonly config: DefaultNatsConfig,
   ) {}
 
   /**
@@ -24,29 +30,58 @@ export class NatsKvService {
     bucketName,
     domain,
     ...opts
-  }: Partial<KvOptions> & {
+  }: Partial<Omit<KvOptions, 'bindOnly'>> & {
     bucketName: string;
     domain?: string;
-  }): Promise<KvStorage> {
-    const jsOptions = domain ? { domain } : undefined;
+  }): Promise<NatsKv> {
+    const js = this.nats.jetstream({
+      domain: domain ?? this.config.defaultJetStreamDomain,
+    });
 
     try {
-      const kv = await this.nats
-        .jetstream(jsOptions)
-        .views.kv(bucketName, opts);
-
-      if (opts.bindOnly && !(await kv.status())) {
-        throw new NotFoundException(`Nats KV ${bucketName} not found`);
-      }
+      const kv = await js.views.kv(bucketName, opts);
 
       this.logger.trace('KV store initialized', {
         connectionName: this.nats.info,
         bucketName,
       });
 
-      return new KvStorage(kv, this.logger, bucketName, this.nats);
+      return new NatsKv(kv, this.logger, bucketName, this.nats);
+    } catch (error) {
+      this.logger.error('Failed to create KV store', {
+        err: error,
+        bucketName,
+      });
+      throw error;
+    }
+  }
+
+  /**
+   * Gets a JetStream KV store
+   */
+  public async bind({
+    bucketName,
+    domain,
+    ...opts
+  }: Partial<Omit<KvOptions, 'bindOnly'>> & {
+    bucketName: string;
+    domain?: string;
+  }): Promise<NatsKv> {
+    const js = this.nats.jetstream({
+      domain: domain ?? this.config.defaultJetStreamDomain,
+    });
+
+    try {
+      const kv = await js.views.kv(bucketName, { ...opts, bindOnly: true });
+
+      this.logger.trace('KV store bound', {
+        connectionName: this.nats.info,
+        bucketName,
+      });
+
+      return new NatsKv(kv, this.logger, bucketName, this.nats);
     } catch (error) {
-      this.logger.error('Failed to get or create KV store', {
+      this.logger.error('Failed to get KV store', {
         err: error,
         bucketName,
       });
@@ -92,7 +127,9 @@ export class NatsKvService {
    */
   public async isBucketExists(bucketName: string): Promise<boolean> {
     try {
-      const kv = await this.create({ bucketName, bindOnly: true });
+      const kv = await this.nats
+        .jetstream()
+        .views.kv(bucketName, { bindOnly: true });
 
       await kv.status();
     } catch {

package/src/{kv-storage.ts → nats-kv.ts}

@@ -14,7 +14,7 @@ import type { NatsKvEntry } from './interfaces/nats-kv-entry.interface';
 import type { NatsKvEntryMeta } from './interfaces/nats-kv-entry-meta.interface';
 import type { DecodeFunc } from './types/decode-func.type';
 
-export class KvStorage {
+export class NatsKv {
   constructor(
     private readonly storage: KV,
     private readonly logger: ILogger,

package/src/watch-kv.service.ts

@@ -67,9 +67,8 @@ export class WatchKvService {
     config: WatchConfig,
     watcher: KvWatcher,
   ): Promise<void> {
-    const kv = await this.nats.create({
+    const kv = await this.nats.bind({
       bucketName: config.bucket,
-      bindOnly: true,
     });
 
     this.watch(

package/dist/kv-storage.js.map

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