@rsdk/nats.kv 5.4.0-next.2

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [5.4.0-next.2](https://github.com/R-Vision/rsdk/compare/v5.4.0-next.1...v5.4.0-next.2) (2024-11-25)
+
+### Features
+
+* **nats:** nats transport/kv/os + examples + docs ([#306](https://github.com/R-Vision/rsdk/issues/306)) ([de67eed](https://github.com/R-Vision/rsdk/commit/de67eed8b4cb17ec9d359067eae1e0c35d6cc736))

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const NATS_KV_STORAGES_RSDK_METADATA_SCOPE = "nats-kv-storages";

package/dist/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NATS_KV_STORAGES_RSDK_METADATA_SCOPE = void 0;
+exports.NATS_KV_STORAGES_RSDK_METADATA_SCOPE = 'nats-kv-storages';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,oCAAoC,GAAG,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+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';

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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;
+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");
+Object.defineProperty(exports, "WatchKv", { enumerable: true, get: function () { return watch_kv_decorator_1.WatchKv; } });
+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);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -0,0 +1,2 @@
+export declare const InjectKvService: (connectionName?: string) => ParameterDecorator;
+export declare const InjectNatsKv: (bucketName: string, connectionName?: string) => ParameterDecorator;

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

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectNatsKv = exports.InjectKvService = 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) => {
+    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);
+        metadata_1.RsdkMetadata.setWithScope(target, metadata_1.PLATFORM_RAW_GLOBAL_METADATA_SCOPE, key, moduleDefinition, true);
+    };
+};
+exports.InjectNatsKv = InjectNatsKv;
+//# sourceMappingURL=inject-kv-service.decorator.js.map

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

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

package/dist/interfaces/nats-kv-entry-meta.interface.d.ts

@@ -0,0 +1,6 @@
+export interface NatsKvEntryMeta {
+    created: Date;
+    revision: number;
+    operation: 'PUT' | 'DEL' | 'PURGE';
+    length: number;
+}

package/dist/interfaces/nats-kv-entry-meta.interface.js

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

package/dist/interfaces/nats-kv-entry-meta.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-kv-entry-meta.interface.js","sourceRoot":"","sources":["../../src/interfaces/nats-kv-entry-meta.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/nats-kv-entry.interface.d.ts

@@ -0,0 +1,6 @@
+import type { DecodeFunc } from '../types/decode-func.type';
+import type { NatsKvEntryMeta } from './nats-kv-entry-meta.interface';
+export interface NatsKvEntry<Decode extends DecodeFunc> {
+    data: ReturnType<Decode>;
+    meta: NatsKvEntryMeta;
+}

package/dist/interfaces/nats-kv-entry.interface.js

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

package/dist/interfaces/nats-kv-entry.interface.js.map

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

package/dist/kv-storage.d.ts

@@ -0,0 +1,23 @@
+import type { ILogger } from '@rsdk/logging';
+import type { KV, KvDeleteOptions, KvEntry, KvPutOptions, KvStatus, Payload } from 'nats';
+import type { NatsKvEntry } from './interfaces/nats-kv-entry.interface';
+import type { DecodeFunc } from './types/decode-func.type';
+export declare class KvStorage {
+    private readonly storage;
+    private readonly logger;
+    constructor(storage: KV, logger: ILogger);
+    getKeys(filter?: string | string[]): Promise<string[]>;
+    getAllWithMeta<Decode extends DecodeFunc>(decode: Decode, filter?: string | string[]): Promise<NatsKvEntry<Decode>[]>;
+    get<Decode extends DecodeFunc>(key: string, decode: Decode): Promise<ReturnType<Decode> | null>;
+    getWithMeta(key: string): Promise<KvEntry | null>;
+    getAll<Decode extends DecodeFunc>(decode: Decode, filter?: string | string[]): Promise<ReturnType<Decode>[]>;
+    status(): Promise<KvStatus>;
+    put(key: string, data: Payload, opts?: Partial<KvPutOptions>): Promise<number>;
+    delete(key: string, opts?: Partial<KvDeleteOptions>): Promise<void>;
+    /**
+     * Возвращает сырой KV Nats. Используйте этот метод
+     * только в крайнем случае! Рекомендуется работать с оберткой
+     * для безопасного взаимодействия.
+     */
+    getRawStorage(): KV;
+}

package/dist/kv-storage.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KvStorage = void 0;
+class KvStorage {
+    storage;
+    logger;
+    constructor(storage, logger) {
+        this.storage = storage;
+        this.logger = logger;
+    }
+    async getKeys(filter) {
+        const keysIterator = await this.storage.keys(filter);
+        const keys = [];
+        for await (const key of keysIterator) {
+            keys.push(key);
+        }
+        return keys;
+    }
+    async getAllWithMeta(decode, filter) {
+        this.logger.trace('Getting all entries from KV', { filter });
+        /*
+          An additional array is used here, because kv.keys() returns an asynchronous iterator,
+          which bugs and stops sending new keys if you use kv.get() inside "for await of"
+        */
+        const keys = await this.getKeys(filter);
+        const result = [];
+        for (const key of keys) {
+            const entry = await this.storage.get(key);
+            if (!entry) {
+                this.logger.warn('KV entry not found', { key });
+                continue;
+            }
+            result.push({
+                data: decode(entry.value),
+                meta: {
+                    created: entry.created,
+                    length: entry.length,
+                    operation: entry.operation,
+                    revision: entry.revision,
+                },
+            });
+        }
+        this.logger.trace('Getting all entries from KV: KV entries received', {
+            count: result.length,
+        });
+        return result;
+    }
+    async get(key, decode) {
+        const entry = await this.getWithMeta(key);
+        if (!entry)
+            return null;
+        return decode(entry.value);
+    }
+    async getWithMeta(key) {
+        return this.storage.get(key);
+    }
+    async getAll(decode, filter) {
+        const entries = await this.getAllWithMeta(decode, filter);
+        return entries.map((entry) => entry.data);
+    }
+    async status() {
+        return this.storage.status();
+    }
+    async put(key, data, opts) {
+        return this.storage.put(key, data, opts);
+    }
+    async delete(key, opts) {
+        await this.storage.delete(key, opts);
+    }
+    /**
+     * Возвращает сырой KV Nats. Используйте этот метод
+     * только в крайнем случае! Рекомендуется работать с оберткой
+     * для безопасного взаимодействия.
+     */
+    getRawStorage() {
+        return this.storage;
+    }
+}
+exports.KvStorage = KvStorage;
+//# sourceMappingURL=kv-storage.js.map

package/dist/kv-storage.js.map

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

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

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

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsKvModuleGenerator = void 0;
+const metadata_1 = require("@rsdk/metadata");
+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);
+        const moduleDefinition = {
+            global: true,
+            imports: [nats_kv_module_1.NatsKvModule.forFeature(connectionName)],
+            module: NatsKvModuleGenerator,
+            providers: [provider],
+            exports: [provider],
+        };
+        metadata_1.RsdkMetadata.add(target, { bucketName, connectionName }, constants_1.NATS_KV_STORAGES_RSDK_METADATA_SCOPE);
+        return moduleDefinition;
+    }
+    static createClientProvider(bucketName, connectionName) {
+        return {
+            provide: (0, tokens_fn_1.createKvToken)(bucketName, connectionName),
+            inject: [(0, tokens_fn_1.createKvServiceToken)(connectionName)],
+            useFactory: (service) => service.create({ bucketName, bindOnly: true }),
+        };
+    }
+}
+exports.NatsKvModuleGenerator = NatsKvModuleGenerator;
+//# sourceMappingURL=nats-kv-module.generator.js.map

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

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

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

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

package/dist/nats-kv.module.js

@@ -0,0 +1,63 @@
+"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);
+};
+var NatsKvModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsKvModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const nats_common_1 = require("@rsdk/nats.common");
+const nats_kv_service_1 = require("./nats-kv.service");
+const tokens_fn_1 = require("./tokens.fn");
+const watch_kv_service_1 = require("./watch-kv.service");
+let NatsKvModule = NatsKvModule_1 = class NatsKvModule {
+    watchKvService;
+    constructor(watchKvService) {
+        this.watchKvService = watchKvService;
+    }
+    static forFeature(connectionName) {
+        const clientProvider = {
+            provide: (0, tokens_fn_1.createKvServiceToken)(connectionName),
+            useClass: nats_kv_service_1.NatsKvService,
+        };
+        return {
+            module: NatsKvModule_1,
+            providers: [
+                {
+                    provide: nats_common_1.NATS_CLIENT_INJECTION_TOKEN_FOR_PACKAGE,
+                    useExisting: connectionName
+                        ? (0, nats_common_1.createNatsClientToken)(connectionName)
+                        : nats_common_1.NATS_CLIENT_INJECTION_TOKEN,
+                },
+                {
+                    provide: 'CONNECTION_NAME',
+                    useFactory: () => connectionName,
+                },
+                clientProvider,
+            ],
+            exports: [clientProvider],
+        };
+    }
+    async onModuleInit() {
+        await this.watchKvService?.runWatches();
+    }
+    async onModuleDestroy() {
+        await this.watchKvService?.stopWatches();
+    }
+};
+exports.NatsKvModule = NatsKvModule;
+exports.NatsKvModule = NatsKvModule = NatsKvModule_1 = __decorate([
+    (0, common_1.Module)({
+        imports: [core_1.DiscoveryModule],
+        providers: [nats_kv_service_1.NatsKvService, watch_kv_service_1.WatchKvService],
+    }),
+    __metadata("design:paramtypes", [watch_kv_service_1.WatchKvService])
+], NatsKvModule);
+//# sourceMappingURL=nats-kv.module.js.map

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

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

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

@@ -0,0 +1,31 @@
+import { ILogger } from '@rsdk/logging';
+import { NatsConnection } from 'nats';
+import type { KvOptions } from 'nats/lib/jetstream/types';
+import { KvStorage } from './kv-storage';
+export declare class NatsKvService {
+    private readonly logger;
+    private readonly nats;
+    constructor(logger: ILogger, nats: NatsConnection);
+    /**
+     * Gets or creates a JetStream KV store
+     */
+    create({ bucketName, domain, ...opts }: Partial<KvOptions> & {
+        bucketName: string;
+        domain?: string;
+    }): Promise<KvStorage>;
+    /**
+     * Waits for the specified bucket to exist.
+     *
+     * @param bucketName - The name of the bucket to wait for.
+     * @param timeout - The maximum time to wait for the bucket to exist, in milliseconds. Defaults to infinity.
+     * @throws {InternalException} If the bucket does not exist within the specified timeout.
+     */
+    waitForBucketExists(bucketName: string, timeout?: number): Promise<void>;
+    /**
+     * Checks if a bucket exists.
+     *
+     * @param bucket - The name of the bucket to check.
+     * @returns A promise that resolves to a boolean indicating whether the bucket exists or not.
+     */
+    isBucketExists(bucketName: string): Promise<boolean>;
+}

package/dist/nats-kv.service.js

@@ -0,0 +1,101 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsKvService = void 0;
+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");
+let NatsKvService = class NatsKvService {
+    logger;
+    nats;
+    constructor(logger, nats) {
+        this.logger = logger;
+        this.nats = nats;
+    }
+    /**
+     * Gets or creates a JetStream KV store
+     */
+    async create({ bucketName, domain, ...opts }) {
+        const jsOptions = domain ? { domain } : undefined;
+        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`);
+            }
+            this.logger.trace('KV store initialized', {
+                connectionName: this.nats.info,
+                bucketName,
+            });
+            return new kv_storage_1.KvStorage(kv, this.logger);
+        }
+        catch (error) {
+            this.logger.error('Failed to get or create KV store', {
+                err: error,
+                bucketName,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Waits for the specified bucket to exist.
+     *
+     * @param bucketName - The name of the bucket to wait for.
+     * @param timeout - The maximum time to wait for the bucket to exist, in milliseconds. Defaults to infinity.
+     * @throws {InternalException} If the bucket does not exist within the specified timeout.
+     */
+    async waitForBucketExists(bucketName, timeout = Number.POSITIVE_INFINITY) {
+        const start = Date.now();
+        while (true) {
+            if (await this.isBucketExists(bucketName)) {
+                this.logger.trace('KV bucket exists');
+                return;
+            }
+            if (timeout && Date.now() - start > timeout) {
+                throw new core_1.InternalException(`Bucket ${bucketName} does not exist`);
+            }
+            this.logger.trace('KV bucket does not exist, retry after 3 seconds...', {
+                bucketName,
+            });
+            await (0, common_2.delay)(common_2.Timespan.second(3));
+        }
+    }
+    /**
+     * Checks if a bucket exists.
+     *
+     * @param bucket - The name of the bucket to check.
+     * @returns A promise that resolves to a boolean indicating whether the bucket exists or not.
+     */
+    async isBucketExists(bucketName) {
+        try {
+            const kv = await this.create({ bucketName, bindOnly: true });
+            await kv.status();
+        }
+        catch {
+            return false;
+        }
+        return true;
+    }
+};
+exports.NatsKvService = NatsKvService;
+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])
+], NatsKvService);
+//# sourceMappingURL=nats-kv.service.js.map

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

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

package/dist/tokens.fn.d.ts

@@ -0,0 +1,2 @@
+export declare const createKvServiceToken: (connectionName?: string) => string;
+export declare const createKvToken: (bucketName: string, connectionName?: string) => string;

package/dist/tokens.fn.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createKvToken = exports.createKvServiceToken = void 0;
+const createKvServiceToken = (connectionName) => `NATS_KV_SERVICE${connectionName ? `_${connectionName}` : ''}`;
+exports.createKvServiceToken = createKvServiceToken;
+const createKvToken = (bucketName, connectionName) => `NATS_KV_${bucketName}${connectionName ? `_${connectionName}` : ''}`;
+exports.createKvToken = createKvToken;
+//# sourceMappingURL=tokens.fn.js.map

package/dist/tokens.fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.fn.js","sourceRoot":"","sources":["../src/tokens.fn.ts"],"names":[],"mappings":";;;AAAO,MAAM,oBAAoB,GAAG,CAAC,cAAuB,EAAU,EAAE,CACtE,kBAAkB,cAAc,CAAC,CAAC,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AADpD,QAAA,oBAAoB,wBACgC;AAE1D,MAAM,aAAa,GAAG,CAC3B,UAAkB,EAClB,cAAuB,EACf,EAAE,CACV,WAAW,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAJ1D,QAAA,aAAa,iBAI6C"}

package/dist/types/decode-func.type.d.ts

@@ -0,0 +1 @@
+export type DecodeFunc = (value: Uint8Array) => any;

package/dist/types/decode-func.type.js

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

package/dist/types/decode-func.type.js.map

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

package/dist/watch-kv.decorator.d.ts

@@ -0,0 +1,23 @@
+import type { KvEntry } from 'nats';
+export type WatchConfig = {
+    bucket: string;
+    filter?: string;
+    connectionName?: string;
+};
+export interface KvWatcher {
+    onDelete(entry: KvEntry): Promise<void>;
+    onPurge(entry: KvEntry): Promise<void>;
+    onPut(entry: KvEntry): Promise<void>;
+}
+/**
+ * Key used to mark class as a watcher for key-value pairs.
+ */
+export declare const WATCH_NATS_KV_KEY = "WATCH_NATS_KV";
+/**
+ * Decorator used to mark class as a watcher for key-value pairs.
+ * Needs to be used in conjunction with the `KvWatcher` interface.
+ *
+ * @param {WatchConfig} config - The configuration for watching key-value pairs.
+ * @returns {void}
+ */
+export declare const WatchKv: import("@nestjs/core").ReflectableDecorator<WatchConfig, WatchConfig>;

package/dist/watch-kv.decorator.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WatchKv = exports.WATCH_NATS_KV_KEY = void 0;
+const core_1 = require("@nestjs/core");
+/**
+ * Key used to mark class as a watcher for key-value pairs.
+ */
+exports.WATCH_NATS_KV_KEY = 'WATCH_NATS_KV';
+/**
+ * Decorator used to mark class as a watcher for key-value pairs.
+ * Needs to be used in conjunction with the `KvWatcher` interface.
+ *
+ * @param {WatchConfig} config - The configuration for watching key-value pairs.
+ * @returns {void}
+ */
+exports.WatchKv = core_1.Reflector.createDecorator({
+    key: exports.WATCH_NATS_KV_KEY,
+});
+//# sourceMappingURL=watch-kv.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch-kv.decorator.js","sourceRoot":"","sources":["../src/watch-kv.decorator.ts"],"names":[],"mappings":";;;AAAA,uCAAyC;AAezC;;GAEG;AACU,QAAA,iBAAiB,GAAG,eAAe,CAAC;AAEjD;;;;;;GAMG;AACU,QAAA,OAAO,GAAG,gBAAS,CAAC,eAAe,CAAc;IAC5D,GAAG,EAAE,yBAAiB;CACvB,CAAC,CAAC"}

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

@@ -0,0 +1,37 @@
+import { DiscoveryService } from '@nestjs/core';
+import { ILogger } from '@rsdk/logging';
+import type { KV, KvEntry, KvWatchOptions } from 'nats';
+import { NatsKvService } from './nats-kv.service';
+export declare class WatchKvService {
+    private readonly logger;
+    private readonly discovery;
+    private readonly nats;
+    private readonly connectionName?;
+    constructor(logger: ILogger, discovery: DiscoveryService, nats: NatsKvService, connectionName?: string | undefined);
+    /**
+     * Runs the watches for the key-value service.
+     * Waits for buckets to exist and starts the watch operation for each bucket.
+     */
+    runWatches(): Promise<void>;
+    /**
+     * Stops all watches.
+     *
+     * @note This method is not implemented yet.
+     */
+    stopWatches(): Promise<void>;
+    watch(kv: KV, opts: KvWatchOptions, callback: (event: KvEntry) => Promise<void>): Promise<void>;
+    /**
+     * Runs the watch operation for the given metadata and watcher.
+     *
+     * @param config - The watch configuration.
+     * @param watcher - The KvWatcher instance.
+     * @returns A Promise that resolves when the watch operation is complete.
+     */
+    private runWatch;
+    /**
+     * Discovers and returns an array of KvWatcher instances along with their corresponding metadata.
+     *
+     * @returns An array of objects containing the KvWatcher instance and its metadata.
+     */
+    private discoverWatchers;
+}