axios-cache-nats-adapter 1.0.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,257 @@
+# axios-cache-nats-adapter
+
+A NATS storage adapter for [axios-cache-interceptor](https://axios-cache-interceptor.js.org/), enabling distributed caching using NATS JetStream Key-Value store.
+
+## Features
+
+- 🚀 **NATS JetStream KV Store** - Persistent, distributed caching
+- 📦 **Dual Module Support** - Works with both ESM and CommonJS
+- 🔧 **Flexible Configuration** - Customizable bucket, TTL, and serialization
+- 🔑 **Key Prefixing** - Namespace support for multiple applications
+- ⚡ **TypeScript** - Full type safety and IntelliSense support
+- 🧪 **Well Tested** - Comprehensive test coverage
+
+## Installation
+
+```bash
+npm install axios-cache-nats-adapter axios-cache-interceptor nats
+```
+
+or
+
+```bash
+yarn add axios-cache-nats-adapter axios-cache-interceptor nats
+```
+
+or
+
+```bash
+pnpm add axios-cache-nats-adapter axios-cache-interceptor nats
+```
+
+## Quick Start
+
+### ESM
+
+```typescript
+import axios from 'axios';
+import { setupCache } from 'axios-cache-interceptor';
+import { NatsAdapter } from 'axios-cache-nats-adapter';
+
+// Create the NATS adapter
+const adapter = new NatsAdapter({
+  natsOptions: {
+    servers: 'nats://localhost:4222',
+  },
+  bucket: 'axios-cache',
+  ttl: 60000, // 1 minute default TTL
+});
+
+// Setup axios with cache
+const cachedAxios = setupCache(axios, {
+  storage: adapter,
+});
+
+// Use it like normal axios
+const response = await cachedAxios.get('https://api.example.com/data');
+console.log(response.cached); // false on first request, true on subsequent
+
+// Clean up when done
+await adapter.close();
+```
+
+### CommonJS
+
+```javascript
+const axios = require('axios');
+const { setupCache } = require('axios-cache-interceptor');
+const { NatsAdapter } = require('axios-cache-nats-adapter');
+
+const adapter = new NatsAdapter({
+  natsOptions: {
+    servers: 'nats://localhost:4222',
+  },
+  bucket: 'axios-cache',
+});
+
+const cachedAxios = setupCache(axios, {
+  storage: adapter,
+});
+
+// Use it...
+```
+
+## Configuration Options
+
+### NatsAdapterOptions
+
+```typescript
+interface NatsAdapterOptions {
+  /**
+   * NATS connection options
+   * @default { servers: 'nats://localhost:4222' }
+   */
+  natsOptions?: ConnectionOptions;
+
+  /**
+   * Name of the JetStream KV bucket to use for caching
+   * @default 'axios-cache'
+   */
+  bucket?: string;
+
+  /**
+   * Prefix to prepend to all cache keys for namespacing
+   * @default ''
+   */
+  keyPrefix?: string;
+
+  /**
+   * Default TTL (time-to-live) in milliseconds for cached values
+   * Individual cache entries can override this
+   * @default 0 (no expiration)
+   */
+  ttl?: number;
+
+  /**
+   * Custom serializer for encoding/decoding cached values
+   * @default JsonSerializer
+   */
+  serializer?: Serializer;
+
+  /**
+   * Maximum number of history entries to keep in the KV bucket
+   * @default 1
+   */
+  maxHistory?: number;
+
+  /**
+   * Whether to automatically create the KV bucket if it doesn't exist
+   * @default true
+   */
+  autoCreateBucket?: boolean;
+}
+```
+
+## Advanced Usage
+
+### Custom Serializer
+
+You can provide a custom serializer for advanced use cases:
+
+```typescript
+import { NatsAdapter, Serializer } from 'axios-cache-nats-adapter';
+import type { StorageValue } from 'axios-cache-interceptor';
+
+class CustomSerializer implements Serializer {
+  serialize(value: StorageValue): Uint8Array {
+    // Your custom serialization logic
+    return new TextEncoder().encode(JSON.stringify(value));
+  }
+
+  deserialize(data: Uint8Array): StorageValue {
+    // Your custom deserialization logic
+    return JSON.parse(new TextDecoder().decode(data));
+  }
+}
+
+const adapter = new NatsAdapter({
+  serializer: new CustomSerializer(),
+});
+```
+
+### Multiple Applications
+
+Use key prefixes to isolate caches for different applications:
+
+```typescript
+// Application 1
+const adapter1 = new NatsAdapter({
+  bucket: 'shared-cache',
+  keyPrefix: 'app1:',
+});
+
+// Application 2
+const adapter2 = new NatsAdapter({
+  bucket: 'shared-cache',
+  keyPrefix: 'app2:',
+});
+```
+
+### Per-Request TTL
+
+You can override the default TTL per request:
+
+```typescript
+const cachedAxios = setupCache(axios, {
+  storage: adapter,
+});
+
+// Cache for 5 minutes
+await cachedAxios.get('https://api.example.com/data', {
+  cache: {
+    ttl: 5 * 60 * 1000,
+  },
+});
+```
+
+### Connection Management
+
+Always clean up resources when done:
+
+```typescript
+const adapter = new NatsAdapter({ /* options */ });
+
+try {
+  // Use the adapter...
+} finally {
+  await adapter.close();
+}
+```
+
+## Requirements
+
+- Node.js >= 16.0.0
+- A running NATS server with JetStream enabled
+
+## Running NATS Server
+
+### Using Docker
+
+```bash
+docker run -p 4222:4222 nats:latest -js
+```
+
+### Using NATS CLI
+
+```bash
+nats-server -js
+```
+
+## API Reference
+
+### NatsAdapter
+
+#### Methods
+
+- `get(key: string): Promise<StorageValue | undefined>` - Get a cached value
+- `set(key: string, value: StorageValue, requestConfig?: CacheProperties): Promise<void>` - Set a cached value
+- `remove(key: string): Promise<void>` - Remove a cached value
+- `find(predicate: (key: string, value: StorageValue) => boolean): Promise<StorageValue[]>` - Find cached values matching a predicate
+- `close(): Promise<void>` - Close the NATS connection
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT © [Yasser Ouaftouh](https://github.com/youaftouh)
+
+## Related Projects
+
+- [axios-cache-interceptor](https://github.com/arthurfiorette/axios-cache-interceptor) - The cache interceptor this adapter is built for
+- [nats.js](https://github.com/nats-io/nats.js) - NATS client for Node.js
+
+## Support
+
+If you encounter any issues or have questions, please [open an issue](https://github.com/youaftouh/axios-cache-nats-adapter/issues) on GitHub.

package/dist/index.d.mts

@@ -0,0 +1,45 @@
+import { StorageValue, AxiosStorage, CacheRequestConfig, NotEmptyStorageValue } from 'axios-cache-interceptor';
+import { ConnectionOptions, KV } from 'nats';
+
+interface Serializer {
+    serialize(value: StorageValue): Uint8Array;
+    deserialize(data: Uint8Array): StorageValue;
+}
+interface NatsAdapterOptions {
+    natsOptions?: ConnectionOptions;
+    bucket?: string;
+    keyPrefix?: string;
+    ttl?: number;
+    serializer?: Serializer;
+    maxHistory?: number;
+    autoCreateBucket?: boolean;
+}
+interface NatsAdapterState {
+    kv: KV | null;
+    connected: boolean;
+}
+
+declare class NatsAdapter implements AxiosStorage {
+    private connection;
+    private state;
+    private readonly options;
+    private readonly serializer;
+    private initPromise;
+    constructor(options?: NatsAdapterOptions);
+    private initialize;
+    private _doInitialize;
+    private buildKey;
+    get(key: string, _currentRequest?: CacheRequestConfig): Promise<StorageValue>;
+    set(key: string, value: NotEmptyStorageValue, currentRequest?: CacheRequestConfig): Promise<void>;
+    remove(key: string): Promise<void>;
+    find(predicate: (key: string, value: StorageValue) => boolean): Promise<StorageValue[]>;
+    close(): Promise<void>;
+}
+
+declare class JsonSerializer implements Serializer {
+    serialize(value: StorageValue): Uint8Array;
+    deserialize(data: Uint8Array): StorageValue;
+}
+declare function getDefaultSerializer(): Serializer;
+
+export { JsonSerializer, NatsAdapter, type NatsAdapterOptions, type NatsAdapterState, type Serializer, getDefaultSerializer };

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+import { StorageValue, AxiosStorage, CacheRequestConfig, NotEmptyStorageValue } from 'axios-cache-interceptor';
+import { ConnectionOptions, KV } from 'nats';
+
+interface Serializer {
+    serialize(value: StorageValue): Uint8Array;
+    deserialize(data: Uint8Array): StorageValue;
+}
+interface NatsAdapterOptions {
+    natsOptions?: ConnectionOptions;
+    bucket?: string;
+    keyPrefix?: string;
+    ttl?: number;
+    serializer?: Serializer;
+    maxHistory?: number;
+    autoCreateBucket?: boolean;
+}
+interface NatsAdapterState {
+    kv: KV | null;
+    connected: boolean;
+}
+
+declare class NatsAdapter implements AxiosStorage {
+    private connection;
+    private state;
+    private readonly options;
+    private readonly serializer;
+    private initPromise;
+    constructor(options?: NatsAdapterOptions);
+    private initialize;
+    private _doInitialize;
+    private buildKey;
+    get(key: string, _currentRequest?: CacheRequestConfig): Promise<StorageValue>;
+    set(key: string, value: NotEmptyStorageValue, currentRequest?: CacheRequestConfig): Promise<void>;
+    remove(key: string): Promise<void>;
+    find(predicate: (key: string, value: StorageValue) => boolean): Promise<StorageValue[]>;
+    close(): Promise<void>;
+}
+
+declare class JsonSerializer implements Serializer {
+    serialize(value: StorageValue): Uint8Array;
+    deserialize(data: Uint8Array): StorageValue;
+}
+declare function getDefaultSerializer(): Serializer;
+
+export { JsonSerializer, NatsAdapter, type NatsAdapterOptions, type NatsAdapterState, type Serializer, getDefaultSerializer };

package/dist/index.js

@@ -0,0 +1,235 @@
+'use strict';
+
+var nats = require('nats');
+
+// src/adapter.ts
+
+// src/serializer.ts
+var JsonSerializer = class {
+  /**
+   * Serialize a StorageValue to a Uint8Array using JSON
+   */
+  serialize(value) {
+    try {
+      const json = JSON.stringify(value);
+      return new TextEncoder().encode(json);
+    } catch (error) {
+      throw new Error(
+        `Failed to serialize value: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Deserialize a Uint8Array to a StorageValue using JSON
+   */
+  deserialize(data) {
+    try {
+      const json = new TextDecoder().decode(data);
+      return JSON.parse(json);
+    } catch (error) {
+      throw new Error(
+        `Failed to deserialize value: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+};
+function getDefaultSerializer() {
+  return new JsonSerializer();
+}
+
+// src/adapter.ts
+var NatsAdapter = class {
+  constructor(options = {}) {
+    this.connection = null;
+    this.state = {
+      kv: null,
+      connected: false
+    };
+    this.initPromise = null;
+    this.options = {
+      natsOptions: options.natsOptions || {},
+      bucket: options.bucket || "axios-cache",
+      keyPrefix: options.keyPrefix || "",
+      ttl: options.ttl || 0,
+      serializer: options.serializer || getDefaultSerializer(),
+      maxHistory: options.maxHistory || 1,
+      autoCreateBucket: options.autoCreateBucket !== false
+    };
+    this.serializer = this.options.serializer;
+  }
+  /**
+   * Initialize the NATS connection and KV bucket
+   */
+  async initialize() {
+    if (this.state.connected && this.state.kv) {
+      return;
+    }
+    if (this.initPromise) {
+      return this.initPromise;
+    }
+    this.initPromise = this._doInitialize();
+    return this.initPromise;
+  }
+  async _doInitialize() {
+    try {
+      this.connection = await nats.connect(this.options.natsOptions);
+      const jsm = await this.connection.jetstreamManager();
+      let kvExists = false;
+      try {
+        await jsm.streams.info(`KV_${this.options.bucket}`);
+        kvExists = true;
+      } catch (error) {
+        kvExists = false;
+      }
+      if (!kvExists) {
+        if (this.options.autoCreateBucket) {
+          await jsm.streams.add({
+            name: `KV_${this.options.bucket}`,
+            subjects: [`$KV.${this.options.bucket}.>`],
+            max_msgs_per_subject: this.options.maxHistory
+          });
+        } else {
+          throw new Error(
+            `KV bucket '${this.options.bucket}' does not exist and autoCreateBucket is disabled`
+          );
+        }
+      }
+      const js = this.connection.jetstream();
+      this.state.kv = await js.views.kv(this.options.bucket);
+      this.state.connected = true;
+    } catch (error) {
+      this.initPromise = null;
+      throw new Error(
+        `Failed to initialize NATS adapter: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Build the full key with prefix
+   */
+  buildKey(key) {
+    return this.options.keyPrefix ? `${this.options.keyPrefix}${key}` : key;
+  }
+  /**
+   * Get a value from the cache
+   */
+  async get(key, _currentRequest) {
+    try {
+      await this.initialize();
+      if (!this.state.kv) {
+        throw new Error("KV store not initialized");
+      }
+      const fullKey = this.buildKey(key);
+      const entry = await this.state.kv.get(fullKey);
+      if (!entry || entry.operation === "DEL" || entry.operation === "PURGE") {
+        return void 0;
+      }
+      const value = this.serializer.deserialize(entry.value);
+      return value;
+    } catch (error) {
+      console.error(`Error getting key '${key}' from NATS:`, error);
+      return void 0;
+    }
+  }
+  /**
+   * Set a value in the cache
+   */
+  async set(key, value, currentRequest) {
+    try {
+      await this.initialize();
+      if (!this.state.kv) {
+        throw new Error("KV store not initialized");
+      }
+      const fullKey = this.buildKey(key);
+      const serialized = this.serializer.serialize(value);
+      let ttl = this.options.ttl;
+      if (currentRequest?.cache && typeof currentRequest.cache === "object") {
+        const cacheConfig = currentRequest.cache;
+        if (typeof cacheConfig.ttl === "number") {
+          ttl = cacheConfig.ttl;
+        }
+      }
+      if (ttl > 0) {
+        const ttlNanos = ttl * 1e6;
+        await this.state.kv.put(fullKey, serialized, { ttl: ttlNanos });
+      } else {
+        await this.state.kv.put(fullKey, serialized);
+      }
+    } catch (error) {
+      console.error(`Error setting key '${key}' in NATS:`, error);
+      throw error;
+    }
+  }
+  /**
+   * Remove a value from the cache
+   */
+  async remove(key) {
+    try {
+      await this.initialize();
+      if (!this.state.kv) {
+        throw new Error("KV store not initialized");
+      }
+      const fullKey = this.buildKey(key);
+      await this.state.kv.delete(fullKey);
+    } catch (error) {
+      console.error(`Error removing key '${key}' from NATS:`, error);
+    }
+  }
+  /**
+   * Find entries matching a given criteria
+   */
+  async find(predicate) {
+    try {
+      await this.initialize();
+      if (!this.state.kv) {
+        throw new Error("KV store not initialized");
+      }
+      const results = [];
+      const keys = await this.state.kv.keys();
+      for await (const key of keys) {
+        if (this.options.keyPrefix && !key.startsWith(this.options.keyPrefix)) {
+          continue;
+        }
+        try {
+          const entry = await this.state.kv.get(key);
+          if (entry && entry.operation !== "DEL" && entry.operation !== "PURGE") {
+            const value = this.serializer.deserialize(entry.value);
+            const originalKey = this.options.keyPrefix ? key.substring(this.options.keyPrefix.length) : key;
+            if (predicate(originalKey, value)) {
+              results.push(value);
+            }
+          }
+        } catch (error) {
+          console.error(`Error reading key '${key}' during find:`, error);
+        }
+      }
+      return results;
+    } catch (error) {
+      console.error("Error finding keys in NATS:", error);
+      return [];
+    }
+  }
+  /**
+   * Close the NATS connection
+   */
+  async close() {
+    try {
+      if (this.connection) {
+        await this.connection.drain();
+        await this.connection.close();
+        this.connection = null;
+        this.state.kv = null;
+        this.state.connected = false;
+        this.initPromise = null;
+      }
+    } catch (error) {
+      console.error("Error closing NATS connection:", error);
+    }
+  }
+};
+
+exports.JsonSerializer = JsonSerializer;
+exports.NatsAdapter = NatsAdapter;
+exports.getDefaultSerializer = getDefaultSerializer;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/serializer.ts","../src/adapter.ts"],"names":["connect"],"mappings":"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","file":"index.js","sourcesContent":["import type { StorageValue } from 'axios-cache-interceptor';\nimport type { Serializer } from './types';\n\n/**\n * Default JSON-based serializer for cache values\n */\nexport class JsonSerializer implements Serializer {\n  /**\n   * Serialize a StorageValue to a Uint8Array using JSON\n   */\n  serialize(value: StorageValue): Uint8Array {\n    try {\n      const json = JSON.stringify(value);\n      return new TextEncoder().encode(json);\n    } catch (error) {\n      throw new Error(\n        `Failed to serialize value: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Deserialize a Uint8Array to a StorageValue using JSON\n   */\n  deserialize(data: Uint8Array): StorageValue {\n    try {\n      const json = new TextDecoder().decode(data);\n      return JSON.parse(json) as StorageValue;\n    } catch (error) {\n      throw new Error(\n        `Failed to deserialize value: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n}\n\n/**\n * Get the default serializer instance\n */\nexport function getDefaultSerializer(): Serializer {\n  return new JsonSerializer();\n}\n","import { connect, NatsConnection } from 'nats';\nimport type { AxiosStorage, StorageValue, NotEmptyStorageValue, CacheRequestConfig } from 'axios-cache-interceptor';\nimport type { NatsAdapterOptions, NatsAdapterState, Serializer } from './types';\nimport { getDefaultSerializer } from './serializer';\n\n/**\n * NATS storage adapter for axios-cache-interceptor\n * Uses NATS JetStream Key-Value store for persistent caching\n */\nexport class NatsAdapter implements AxiosStorage {\n  private connection: NatsConnection | null = null;\n  private state: NatsAdapterState = {\n    kv: null,\n    connected: false,\n  };\n  private readonly options: Required<NatsAdapterOptions>;\n  private readonly serializer: Serializer;\n  private initPromise: Promise<void> | null = null;\n\n  constructor(options: NatsAdapterOptions = {}) {\n    this.options = {\n      natsOptions: options.natsOptions || {},\n      bucket: options.bucket || 'axios-cache',\n      keyPrefix: options.keyPrefix || '',\n      ttl: options.ttl || 0,\n      serializer: options.serializer || getDefaultSerializer(),\n      maxHistory: options.maxHistory || 1,\n      autoCreateBucket: options.autoCreateBucket !== false,\n    };\n    this.serializer = this.options.serializer;\n  }\n\n  /**\n   * Initialize the NATS connection and KV bucket\n   */\n  private async initialize(): Promise<void> {\n    if (this.state.connected && this.state.kv) {\n      return;\n    }\n\n    if (this.initPromise) {\n      return this.initPromise;\n    }\n\n    this.initPromise = this._doInitialize();\n    return this.initPromise;\n  }\n\n  private async _doInitialize(): Promise<void> {\n    try {\n      // Connect to NATS\n      this.connection = await connect(this.options.natsOptions);\n\n      // Get JetStream manager\n      const jsm = await this.connection.jetstreamManager();\n\n      // Check if bucket exists\n      let kvExists = false;\n      try {\n        await jsm.streams.info(`KV_${this.options.bucket}`);\n        kvExists = true;\n      } catch (error) {\n        // Bucket doesn't exist\n        kvExists = false;\n      }\n\n      // Create bucket if it doesn't exist and autoCreateBucket is true\n      if (!kvExists) {\n        if (this.options.autoCreateBucket) {\n          await jsm.streams.add({\n            name: `KV_${this.options.bucket}`,\n            subjects: [`$KV.${this.options.bucket}.>`],\n            max_msgs_per_subject: this.options.maxHistory,\n          });\n        } else {\n          throw new Error(\n            `KV bucket '${this.options.bucket}' does not exist and autoCreateBucket is disabled`\n          );\n        }\n      }\n\n      // Get KV handle\n      const js = this.connection.jetstream();\n      this.state.kv = await js.views.kv(this.options.bucket);\n      this.state.connected = true;\n    } catch (error) {\n      this.initPromise = null;\n      throw new Error(\n        `Failed to initialize NATS adapter: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Build the full key with prefix\n   */\n  private buildKey(key: string): string {\n    return this.options.keyPrefix ? `${this.options.keyPrefix}${key}` : key;\n  }\n\n  /**\n   * Get a value from the cache\n   */\n  async get(key: string, _currentRequest?: CacheRequestConfig): Promise<StorageValue> {\n    try {\n      await this.initialize();\n\n      if (!this.state.kv) {\n        throw new Error('KV store not initialized');\n      }\n\n      const fullKey = this.buildKey(key);\n\n      const entry = await this.state.kv.get(fullKey);\n\n      if (!entry || entry.operation === 'DEL' || entry.operation === 'PURGE') {\n        return undefined as unknown as StorageValue;\n      }\n\n      const value = this.serializer.deserialize(entry.value);\n      return value;\n    } catch (error) {\n      // Key doesn't exist or other error\n      console.error(`Error getting key '${key}' from NATS:`, error);\n      return undefined as unknown as StorageValue;\n    }\n  }\n\n  /**\n   * Set a value in the cache\n   */\n  async set(key: string, value: NotEmptyStorageValue, currentRequest?: CacheRequestConfig): Promise<void> {\n    try {\n      await this.initialize();\n\n      if (!this.state.kv) {\n        throw new Error('KV store not initialized');\n      }\n\n      const fullKey = this.buildKey(key);\n      const serialized = this.serializer.serialize(value);\n\n      // Determine TTL - use from currentRequest if available, otherwise use default\n      let ttl = this.options.ttl;\n      if (currentRequest?.cache && typeof currentRequest.cache === 'object') {\n        const cacheConfig = currentRequest.cache;\n        if (typeof cacheConfig.ttl === 'number') {\n          ttl = cacheConfig.ttl;\n        }\n      }\n\n      // Convert milliseconds to nanoseconds for NATS\n      // NATS KV ttl is in nanoseconds\n      if (ttl > 0) {\n        const ttlNanos = ttl * 1_000_000;\n        await this.state.kv.put(fullKey, serialized, { ttl: ttlNanos } as any);\n      } else {\n        await this.state.kv.put(fullKey, serialized);\n      }\n    } catch (error) {\n      console.error(`Error setting key '${key}' in NATS:`, error);\n      throw error;\n    }\n  }\n\n  /**\n   * Remove a value from the cache\n   */\n  async remove(key: string): Promise<void> {\n    try {\n      await this.initialize();\n\n      if (!this.state.kv) {\n        throw new Error('KV store not initialized');\n      }\n\n      const fullKey = this.buildKey(key);\n      await this.state.kv.delete(fullKey);\n    } catch (error) {\n      console.error(`Error removing key '${key}' from NATS:`, error);\n    }\n  }\n\n  /**\n   * Find entries matching a given criteria\n   */\n  async find(predicate: (key: string, value: StorageValue) => boolean): Promise<StorageValue[]> {\n    try {\n      await this.initialize();\n\n      if (!this.state.kv) {\n        throw new Error('KV store not initialized');\n      }\n\n      const results: StorageValue[] = [];\n      const keys = await this.state.kv.keys();\n\n      for await (const key of keys) {\n        // Filter by prefix if set\n        if (this.options.keyPrefix && !key.startsWith(this.options.keyPrefix)) {\n          continue;\n        }\n\n        try {\n          const entry = await this.state.kv.get(key);\n          if (entry && entry.operation !== 'DEL' && entry.operation !== 'PURGE') {\n            const value = this.serializer.deserialize(entry.value);\n            // Remove prefix from key for predicate\n            const originalKey = this.options.keyPrefix\n              ? key.substring(this.options.keyPrefix.length)\n              : key;\n            if (predicate(originalKey, value)) {\n              results.push(value);\n            }\n          }\n        } catch (error) {\n          console.error(`Error reading key '${key}' during find:`, error);\n        }\n      }\n\n      return results;\n    } catch (error) {\n      console.error('Error finding keys in NATS:', error);\n      return [];\n    }\n  }\n\n  /**\n   * Close the NATS connection\n   */\n  async close(): Promise<void> {\n    try {\n      if (this.connection) {\n        await this.connection.drain();\n        await this.connection.close();\n        this.connection = null;\n        this.state.kv = null;\n        this.state.connected = false;\n        this.initPromise = null;\n      }\n    } catch (error) {\n      console.error('Error closing NATS connection:', error);\n    }\n  }\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,231 @@
+import { connect } from 'nats';
+
+// src/adapter.ts
+
+// src/serializer.ts
+var JsonSerializer = class {
+  /**
+   * Serialize a StorageValue to a Uint8Array using JSON
+   */
+  serialize(value) {
+    try {
+      const json = JSON.stringify(value);
+      return new TextEncoder().encode(json);
+    } catch (error) {
+      throw new Error(
+        `Failed to serialize value: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Deserialize a Uint8Array to a StorageValue using JSON
+   */
+  deserialize(data) {
+    try {
+      const json = new TextDecoder().decode(data);
+      return JSON.parse(json);
+    } catch (error) {
+      throw new Error(
+        `Failed to deserialize value: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+};
+function getDefaultSerializer() {
+  return new JsonSerializer();
+}
+
+// src/adapter.ts
+var NatsAdapter = class {
+  constructor(options = {}) {
+    this.connection = null;
+    this.state = {
+      kv: null,
+      connected: false
+    };
+    this.initPromise = null;
+    this.options = {
+      natsOptions: options.natsOptions || {},
+      bucket: options.bucket || "axios-cache",
+      keyPrefix: options.keyPrefix || "",
+      ttl: options.ttl || 0,
+      serializer: options.serializer || getDefaultSerializer(),
+      maxHistory: options.maxHistory || 1,
+      autoCreateBucket: options.autoCreateBucket !== false
+    };
+    this.serializer = this.options.serializer;
+  }
+  /**
+   * Initialize the NATS connection and KV bucket
+   */
+  async initialize() {
+    if (this.state.connected && this.state.kv) {
+      return;
+    }
+    if (this.initPromise) {
+      return this.initPromise;
+    }
+    this.initPromise = this._doInitialize();
+    return this.initPromise;
+  }
+  async _doInitialize() {
+    try {
+      this.connection = await connect(this.options.natsOptions);
+      const jsm = await this.connection.jetstreamManager();
+      let kvExists = false;
+      try {
+        await jsm.streams.info(`KV_${this.options.bucket}`);
+        kvExists = true;
+      } catch (error) {
+        kvExists = false;
+      }
+      if (!kvExists) {
+        if (this.options.autoCreateBucket) {
+          await jsm.streams.add({
+            name: `KV_${this.options.bucket}`,
+            subjects: [`$KV.${this.options.bucket}.>`],
+            max_msgs_per_subject: this.options.maxHistory
+          });
+        } else {
+          throw new Error(
+            `KV bucket '${this.options.bucket}' does not exist and autoCreateBucket is disabled`
+          );
+        }
+      }
+      const js = this.connection.jetstream();
+      this.state.kv = await js.views.kv(this.options.bucket);
+      this.state.connected = true;
+    } catch (error) {
+      this.initPromise = null;
+      throw new Error(
+        `Failed to initialize NATS adapter: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Build the full key with prefix
+   */
+  buildKey(key) {
+    return this.options.keyPrefix ? `${this.options.keyPrefix}${key}` : key;
+  }
+  /**
+   * Get a value from the cache
+   */
+  async get(key, _currentRequest) {
+    try {
+      await this.initialize();
+      if (!this.state.kv) {
+        throw new Error("KV store not initialized");
+      }
+      const fullKey = this.buildKey(key);
+      const entry = await this.state.kv.get(fullKey);
+      if (!entry || entry.operation === "DEL" || entry.operation === "PURGE") {
+        return void 0;
+      }
+      const value = this.serializer.deserialize(entry.value);
+      return value;
+    } catch (error) {
+      console.error(`Error getting key '${key}' from NATS:`, error);
+      return void 0;
+    }
+  }
+  /**
+   * Set a value in the cache
+   */
+  async set(key, value, currentRequest) {
+    try {
+      await this.initialize();
+      if (!this.state.kv) {
+        throw new Error("KV store not initialized");
+      }
+      const fullKey = this.buildKey(key);
+      const serialized = this.serializer.serialize(value);
+      let ttl = this.options.ttl;
+      if (currentRequest?.cache && typeof currentRequest.cache === "object") {
+        const cacheConfig = currentRequest.cache;
+        if (typeof cacheConfig.ttl === "number") {
+          ttl = cacheConfig.ttl;
+        }
+      }
+      if (ttl > 0) {
+        const ttlNanos = ttl * 1e6;
+        await this.state.kv.put(fullKey, serialized, { ttl: ttlNanos });
+      } else {
+        await this.state.kv.put(fullKey, serialized);
+      }
+    } catch (error) {
+      console.error(`Error setting key '${key}' in NATS:`, error);
+      throw error;
+    }
+  }
+  /**
+   * Remove a value from the cache
+   */
+  async remove(key) {
+    try {
+      await this.initialize();
+      if (!this.state.kv) {
+        throw new Error("KV store not initialized");
+      }
+      const fullKey = this.buildKey(key);
+      await this.state.kv.delete(fullKey);
+    } catch (error) {
+      console.error(`Error removing key '${key}' from NATS:`, error);
+    }
+  }
+  /**
+   * Find entries matching a given criteria
+   */
+  async find(predicate) {
+    try {
+      await this.initialize();
+      if (!this.state.kv) {
+        throw new Error("KV store not initialized");
+      }
+      const results = [];
+      const keys = await this.state.kv.keys();
+      for await (const key of keys) {
+        if (this.options.keyPrefix && !key.startsWith(this.options.keyPrefix)) {
+          continue;
+        }
+        try {
+          const entry = await this.state.kv.get(key);
+          if (entry && entry.operation !== "DEL" && entry.operation !== "PURGE") {
+            const value = this.serializer.deserialize(entry.value);
+            const originalKey = this.options.keyPrefix ? key.substring(this.options.keyPrefix.length) : key;
+            if (predicate(originalKey, value)) {
+              results.push(value);
+            }
+          }
+        } catch (error) {
+          console.error(`Error reading key '${key}' during find:`, error);
+        }
+      }
+      return results;
+    } catch (error) {
+      console.error("Error finding keys in NATS:", error);
+      return [];
+    }
+  }
+  /**
+   * Close the NATS connection
+   */
+  async close() {
+    try {
+      if (this.connection) {
+        await this.connection.drain();
+        await this.connection.close();
+        this.connection = null;
+        this.state.kv = null;
+        this.state.connected = false;
+        this.initPromise = null;
+      }
+    } catch (error) {
+      console.error("Error closing NATS connection:", error);
+    }
+  }
+};
+
+export { JsonSerializer, NatsAdapter, getDefaultSerializer };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/serializer.ts","../src/adapter.ts"],"names":[],"mappings":";;;;;AAMO,IAAM,iBAAN,MAA2C;AAAA;AAAA;AAAA;AAAA,EAIhD,UAAU,KAAA,EAAiC;AACzC,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA;AACjC,MAAA,OAAO,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,IAAI,CAAA;AAAA,IACtC,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,8BAA8B,KAAA,YAAiB,KAAA,GAAQ,MAAM,OAAA,GAAU,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,OACtF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,IAAA,EAAgC;AAC1C,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,IAAI,WAAA,EAAY,CAAE,OAAO,IAAI,CAAA;AAC1C,MAAA,OAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,IACxB,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,gCAAgC,KAAA,YAAiB,KAAA,GAAQ,MAAM,OAAA,GAAU,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,OACxF;AAAA,IACF;AAAA,EACF;AACF;AAKO,SAAS,oBAAA,GAAmC;AACjD,EAAA,OAAO,IAAI,cAAA,EAAe;AAC5B;;;AChCO,IAAM,cAAN,MAA0C;AAAA,EAU/C,WAAA,CAAY,OAAA,GAA8B,EAAC,EAAG;AAT9C,IAAA,IAAA,CAAQ,UAAA,GAAoC,IAAA;AAC5C,IAAA,IAAA,CAAQ,KAAA,GAA0B;AAAA,MAChC,EAAA,EAAI,IAAA;AAAA,MACJ,SAAA,EAAW;AAAA,KACb;AAGA,IAAA,IAAA,CAAQ,WAAA,GAAoC,IAAA;AAG1C,IAAA,IAAA,CAAK,OAAA,GAAU;AAAA,MACb,WAAA,EAAa,OAAA,CAAQ,WAAA,IAAe,EAAC;AAAA,MACrC,MAAA,EAAQ,QAAQ,MAAA,IAAU,aAAA;AAAA,MAC1B,SAAA,EAAW,QAAQ,SAAA,IAAa,EAAA;AAAA,MAChC,GAAA,EAAK,QAAQ,GAAA,IAAO,CAAA;AAAA,MACpB,UAAA,EAAY,OAAA,CAAQ,UAAA,IAAc,oBAAA,EAAqB;AAAA,MACvD,UAAA,EAAY,QAAQ,UAAA,IAAc,CAAA;AAAA,MAClC,gBAAA,EAAkB,QAAQ,gBAAA,KAAqB;AAAA,KACjD;AACA,IAAA,IAAA,CAAK,UAAA,GAAa,KAAK,OAAA,CAAQ,UAAA;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,UAAA,GAA4B;AACxC,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,SAAA,IAAa,IAAA,CAAK,MAAM,EAAA,EAAI;AACzC,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,KAAK,WAAA,EAAa;AACpB,MAAA,OAAO,IAAA,CAAK,WAAA;AAAA,IACd;AAEA,IAAA,IAAA,CAAK,WAAA,GAAc,KAAK,aAAA,EAAc;AACtC,IAAA,OAAO,IAAA,CAAK,WAAA;AAAA,EACd;AAAA,EAEA,MAAc,aAAA,GAA+B;AAC3C,IAAA,IAAI;AAEF,MAAA,IAAA,CAAK,UAAA,GAAa,MAAM,OAAA,CAAQ,IAAA,CAAK,QAAQ,WAAW,CAAA;AAGxD,MAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,UAAA,CAAW,gBAAA,EAAiB;AAGnD,MAAA,IAAI,QAAA,GAAW,KAAA;AACf,MAAA,IAAI;AACF,QAAA,MAAM,IAAI,OAAA,CAAQ,IAAA,CAAK,MAAM,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA,CAAE,CAAA;AAClD,QAAA,QAAA,GAAW,IAAA;AAAA,MACb,SAAS,KAAA,EAAO;AAEd,QAAA,QAAA,GAAW,KAAA;AAAA,MACb;AAGA,MAAA,IAAI,CAAC,QAAA,EAAU;AACb,QAAA,IAAI,IAAA,CAAK,QAAQ,gBAAA,EAAkB;AACjC,UAAA,MAAM,GAAA,CAAI,QAAQ,GAAA,CAAI;AAAA,YACpB,IAAA,EAAM,CAAA,GAAA,EAAM,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA,CAAA;AAAA,YAC/B,UAAU,CAAC,CAAA,IAAA,EAAO,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA,EAAA,CAAI,CAAA;AAAA,YACzC,oBAAA,EAAsB,KAAK,OAAA,CAAQ;AAAA,WACpC,CAAA;AAAA,QACH,CAAA,MAAO;AACL,UAAA,MAAM,IAAI,KAAA;AAAA,YACR,CAAA,WAAA,EAAc,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA,iDAAA;AAAA,WACnC;AAAA,QACF;AAAA,MACF;AAGA,MAAA,MAAM,EAAA,GAAK,IAAA,CAAK,UAAA,CAAW,SAAA,EAAU;AACrC,MAAA,IAAA,CAAK,KAAA,CAAM,KAAK,MAAM,EAAA,CAAG,MAAM,EAAA,CAAG,IAAA,CAAK,QAAQ,MAAM,CAAA;AACrD,MAAA,IAAA,CAAK,MAAM,SAAA,GAAY,IAAA;AAAA,IACzB,SAAS,KAAA,EAAO;AACd,MAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AACnB,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,sCAAsC,KAAA,YAAiB,KAAA,GAAQ,MAAM,OAAA,GAAU,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,OAC9F;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,SAAS,GAAA,EAAqB;AACpC,IAAA,OAAO,IAAA,CAAK,QAAQ,SAAA,GAAY,CAAA,EAAG,KAAK,OAAA,CAAQ,SAAS,CAAA,EAAG,GAAG,CAAA,CAAA,GAAK,GAAA;AAAA,EACtE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,GAAA,CAAI,GAAA,EAAa,eAAA,EAA6D;AAClF,IAAA,IAAI;AACF,MAAA,MAAM,KAAK,UAAA,EAAW;AAEtB,MAAA,IAAI,CAAC,IAAA,CAAK,KAAA,CAAM,EAAA,EAAI;AAClB,QAAA,MAAM,IAAI,MAAM,0BAA0B,CAAA;AAAA,MAC5C;AAEA,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA;AAEjC,MAAA,MAAM,QAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,EAAA,CAAG,IAAI,OAAO,CAAA;AAE7C,MAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,cAAc,KAAA,IAAS,KAAA,CAAM,cAAc,OAAA,EAAS;AACtE,QAAA,OAAO,KAAA,CAAA;AAAA,MACT;AAEA,MAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,UAAA,CAAW,WAAA,CAAY,MAAM,KAAK,CAAA;AACrD,MAAA,OAAO,KAAA;AAAA,IACT,SAAS,KAAA,EAAO;AAEd,MAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,mBAAA,EAAsB,GAAG,CAAA,YAAA,CAAA,EAAgB,KAAK,CAAA;AAC5D,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,GAAA,CAAI,GAAA,EAAa,KAAA,EAA6B,cAAA,EAAoD;AACtG,IAAA,IAAI;AACF,MAAA,MAAM,KAAK,UAAA,EAAW;AAEtB,MAAA,IAAI,CAAC,IAAA,CAAK,KAAA,CAAM,EAAA,EAAI;AAClB,QAAA,MAAM,IAAI,MAAM,0BAA0B,CAAA;AAAA,MAC5C;AAEA,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA;AACjC,MAAA,MAAM,UAAA,GAAa,IAAA,CAAK,UAAA,CAAW,SAAA,CAAU,KAAK,CAAA;AAGlD,MAAA,IAAI,GAAA,GAAM,KAAK,OAAA,CAAQ,GAAA;AACvB,MAAA,IAAI,cAAA,EAAgB,KAAA,IAAS,OAAO,cAAA,CAAe,UAAU,QAAA,EAAU;AACrE,QAAA,MAAM,cAAc,cAAA,CAAe,KAAA;AACnC,QAAA,IAAI,OAAO,WAAA,CAAY,GAAA,KAAQ,QAAA,EAAU;AACvC,UAAA,GAAA,GAAM,WAAA,CAAY,GAAA;AAAA,QACpB;AAAA,MACF;AAIA,MAAA,IAAI,MAAM,CAAA,EAAG;AACX,QAAA,MAAM,WAAW,GAAA,GAAM,GAAA;AACvB,QAAA,MAAM,IAAA,CAAK,MAAM,EAAA,CAAG,GAAA,CAAI,SAAS,UAAA,EAAY,EAAE,GAAA,EAAK,QAAA,EAAiB,CAAA;AAAA,MACvE,CAAA,MAAO;AACL,QAAA,MAAM,IAAA,CAAK,KAAA,CAAM,EAAA,CAAG,GAAA,CAAI,SAAS,UAAU,CAAA;AAAA,MAC7C;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,mBAAA,EAAsB,GAAG,CAAA,UAAA,CAAA,EAAc,KAAK,CAAA;AAC1D,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,GAAA,EAA4B;AACvC,IAAA,IAAI;AACF,MAAA,MAAM,KAAK,UAAA,EAAW;AAEtB,MAAA,IAAI,CAAC,IAAA,CAAK,KAAA,CAAM,EAAA,EAAI;AAClB,QAAA,MAAM,IAAI,MAAM,0BAA0B,CAAA;AAAA,MAC5C;AAEA,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA;AACjC,MAAA,MAAM,IAAA,CAAK,KAAA,CAAM,EAAA,CAAG,MAAA,CAAO,OAAO,CAAA;AAAA,IACpC,SAAS,KAAA,EAAO;AACd,MAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,oBAAA,EAAuB,GAAG,CAAA,YAAA,CAAA,EAAgB,KAAK,CAAA;AAAA,IAC/D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,KAAK,SAAA,EAAmF;AAC5F,IAAA,IAAI;AACF,MAAA,MAAM,KAAK,UAAA,EAAW;AAEtB,MAAA,IAAI,CAAC,IAAA,CAAK,KAAA,CAAM,EAAA,EAAI;AAClB,QAAA,MAAM,IAAI,MAAM,0BAA0B,CAAA;AAAA,MAC5C;AAEA,MAAA,MAAM,UAA0B,EAAC;AACjC,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,KAAA,CAAM,GAAG,IAAA,EAAK;AAEtC,MAAA,WAAA,MAAiB,OAAO,IAAA,EAAM;AAE5B,QAAA,IAAI,IAAA,CAAK,QAAQ,SAAA,IAAa,CAAC,IAAI,UAAA,CAAW,IAAA,CAAK,OAAA,CAAQ,SAAS,CAAA,EAAG;AACrE,UAAA;AAAA,QACF;AAEA,QAAA,IAAI;AACF,UAAA,MAAM,QAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,EAAA,CAAG,IAAI,GAAG,CAAA;AACzC,UAAA,IAAI,SAAS,KAAA,CAAM,SAAA,KAAc,KAAA,IAAS,KAAA,CAAM,cAAc,OAAA,EAAS;AACrE,YAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,UAAA,CAAW,WAAA,CAAY,MAAM,KAAK,CAAA;AAErD,YAAA,MAAM,WAAA,GAAc,IAAA,CAAK,OAAA,CAAQ,SAAA,GAC7B,GAAA,CAAI,UAAU,IAAA,CAAK,OAAA,CAAQ,SAAA,CAAU,MAAM,CAAA,GAC3C,GAAA;AACJ,YAAA,IAAI,SAAA,CAAU,WAAA,EAAa,KAAK,CAAA,EAAG;AACjC,cAAA,OAAA,CAAQ,KAAK,KAAK,CAAA;AAAA,YACpB;AAAA,UACF;AAAA,QACF,SAAS,KAAA,EAAO;AACd,UAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,mBAAA,EAAsB,GAAG,CAAA,cAAA,CAAA,EAAkB,KAAK,CAAA;AAAA,QAChE;AAAA,MACF;AAEA,MAAA,OAAO,OAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,OAAA,CAAQ,KAAA,CAAM,+BAA+B,KAAK,CAAA;AAClD,MAAA,OAAO,EAAC;AAAA,IACV;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,KAAA,GAAuB;AAC3B,IAAA,IAAI;AACF,MAAA,IAAI,KAAK,UAAA,EAAY;AACnB,QAAA,MAAM,IAAA,CAAK,WAAW,KAAA,EAAM;AAC5B,QAAA,MAAM,IAAA,CAAK,WAAW,KAAA,EAAM;AAC5B,QAAA,IAAA,CAAK,UAAA,GAAa,IAAA;AAClB,QAAA,IAAA,CAAK,MAAM,EAAA,GAAK,IAAA;AAChB,QAAA,IAAA,CAAK,MAAM,SAAA,GAAY,KAAA;AACvB,QAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AAAA,MACrB;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAA,CAAQ,KAAA,CAAM,kCAAkC,KAAK,CAAA;AAAA,IACvD;AAAA,EACF;AACF","file":"index.mjs","sourcesContent":["import type { StorageValue } from 'axios-cache-interceptor';\nimport type { Serializer } from './types';\n\n/**\n * Default JSON-based serializer for cache values\n */\nexport class JsonSerializer implements Serializer {\n  /**\n   * Serialize a StorageValue to a Uint8Array using JSON\n   */\n  serialize(value: StorageValue): Uint8Array {\n    try {\n      const json = JSON.stringify(value);\n      return new TextEncoder().encode(json);\n    } catch (error) {\n      throw new Error(\n        `Failed to serialize value: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Deserialize a Uint8Array to a StorageValue using JSON\n   */\n  deserialize(data: Uint8Array): StorageValue {\n    try {\n      const json = new TextDecoder().decode(data);\n      return JSON.parse(json) as StorageValue;\n    } catch (error) {\n      throw new Error(\n        `Failed to deserialize value: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n}\n\n/**\n * Get the default serializer instance\n */\nexport function getDefaultSerializer(): Serializer {\n  return new JsonSerializer();\n}\n","import { connect, NatsConnection } from 'nats';\nimport type { AxiosStorage, StorageValue, NotEmptyStorageValue, CacheRequestConfig } from 'axios-cache-interceptor';\nimport type { NatsAdapterOptions, NatsAdapterState, Serializer } from './types';\nimport { getDefaultSerializer } from './serializer';\n\n/**\n * NATS storage adapter for axios-cache-interceptor\n * Uses NATS JetStream Key-Value store for persistent caching\n */\nexport class NatsAdapter implements AxiosStorage {\n  private connection: NatsConnection | null = null;\n  private state: NatsAdapterState = {\n    kv: null,\n    connected: false,\n  };\n  private readonly options: Required<NatsAdapterOptions>;\n  private readonly serializer: Serializer;\n  private initPromise: Promise<void> | null = null;\n\n  constructor(options: NatsAdapterOptions = {}) {\n    this.options = {\n      natsOptions: options.natsOptions || {},\n      bucket: options.bucket || 'axios-cache',\n      keyPrefix: options.keyPrefix || '',\n      ttl: options.ttl || 0,\n      serializer: options.serializer || getDefaultSerializer(),\n      maxHistory: options.maxHistory || 1,\n      autoCreateBucket: options.autoCreateBucket !== false,\n    };\n    this.serializer = this.options.serializer;\n  }\n\n  /**\n   * Initialize the NATS connection and KV bucket\n   */\n  private async initialize(): Promise<void> {\n    if (this.state.connected && this.state.kv) {\n      return;\n    }\n\n    if (this.initPromise) {\n      return this.initPromise;\n    }\n\n    this.initPromise = this._doInitialize();\n    return this.initPromise;\n  }\n\n  private async _doInitialize(): Promise<void> {\n    try {\n      // Connect to NATS\n      this.connection = await connect(this.options.natsOptions);\n\n      // Get JetStream manager\n      const jsm = await this.connection.jetstreamManager();\n\n      // Check if bucket exists\n      let kvExists = false;\n      try {\n        await jsm.streams.info(`KV_${this.options.bucket}`);\n        kvExists = true;\n      } catch (error) {\n        // Bucket doesn't exist\n        kvExists = false;\n      }\n\n      // Create bucket if it doesn't exist and autoCreateBucket is true\n      if (!kvExists) {\n        if (this.options.autoCreateBucket) {\n          await jsm.streams.add({\n            name: `KV_${this.options.bucket}`,\n            subjects: [`$KV.${this.options.bucket}.>`],\n            max_msgs_per_subject: this.options.maxHistory,\n          });\n        } else {\n          throw new Error(\n            `KV bucket '${this.options.bucket}' does not exist and autoCreateBucket is disabled`\n          );\n        }\n      }\n\n      // Get KV handle\n      const js = this.connection.jetstream();\n      this.state.kv = await js.views.kv(this.options.bucket);\n      this.state.connected = true;\n    } catch (error) {\n      this.initPromise = null;\n      throw new Error(\n        `Failed to initialize NATS adapter: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Build the full key with prefix\n   */\n  private buildKey(key: string): string {\n    return this.options.keyPrefix ? `${this.options.keyPrefix}${key}` : key;\n  }\n\n  /**\n   * Get a value from the cache\n   */\n  async get(key: string, _currentRequest?: CacheRequestConfig): Promise<StorageValue> {\n    try {\n      await this.initialize();\n\n      if (!this.state.kv) {\n        throw new Error('KV store not initialized');\n      }\n\n      const fullKey = this.buildKey(key);\n\n      const entry = await this.state.kv.get(fullKey);\n\n      if (!entry || entry.operation === 'DEL' || entry.operation === 'PURGE') {\n        return undefined as unknown as StorageValue;\n      }\n\n      const value = this.serializer.deserialize(entry.value);\n      return value;\n    } catch (error) {\n      // Key doesn't exist or other error\n      console.error(`Error getting key '${key}' from NATS:`, error);\n      return undefined as unknown as StorageValue;\n    }\n  }\n\n  /**\n   * Set a value in the cache\n   */\n  async set(key: string, value: NotEmptyStorageValue, currentRequest?: CacheRequestConfig): Promise<void> {\n    try {\n      await this.initialize();\n\n      if (!this.state.kv) {\n        throw new Error('KV store not initialized');\n      }\n\n      const fullKey = this.buildKey(key);\n      const serialized = this.serializer.serialize(value);\n\n      // Determine TTL - use from currentRequest if available, otherwise use default\n      let ttl = this.options.ttl;\n      if (currentRequest?.cache && typeof currentRequest.cache === 'object') {\n        const cacheConfig = currentRequest.cache;\n        if (typeof cacheConfig.ttl === 'number') {\n          ttl = cacheConfig.ttl;\n        }\n      }\n\n      // Convert milliseconds to nanoseconds for NATS\n      // NATS KV ttl is in nanoseconds\n      if (ttl > 0) {\n        const ttlNanos = ttl * 1_000_000;\n        await this.state.kv.put(fullKey, serialized, { ttl: ttlNanos } as any);\n      } else {\n        await this.state.kv.put(fullKey, serialized);\n      }\n    } catch (error) {\n      console.error(`Error setting key '${key}' in NATS:`, error);\n      throw error;\n    }\n  }\n\n  /**\n   * Remove a value from the cache\n   */\n  async remove(key: string): Promise<void> {\n    try {\n      await this.initialize();\n\n      if (!this.state.kv) {\n        throw new Error('KV store not initialized');\n      }\n\n      const fullKey = this.buildKey(key);\n      await this.state.kv.delete(fullKey);\n    } catch (error) {\n      console.error(`Error removing key '${key}' from NATS:`, error);\n    }\n  }\n\n  /**\n   * Find entries matching a given criteria\n   */\n  async find(predicate: (key: string, value: StorageValue) => boolean): Promise<StorageValue[]> {\n    try {\n      await this.initialize();\n\n      if (!this.state.kv) {\n        throw new Error('KV store not initialized');\n      }\n\n      const results: StorageValue[] = [];\n      const keys = await this.state.kv.keys();\n\n      for await (const key of keys) {\n        // Filter by prefix if set\n        if (this.options.keyPrefix && !key.startsWith(this.options.keyPrefix)) {\n          continue;\n        }\n\n        try {\n          const entry = await this.state.kv.get(key);\n          if (entry && entry.operation !== 'DEL' && entry.operation !== 'PURGE') {\n            const value = this.serializer.deserialize(entry.value);\n            // Remove prefix from key for predicate\n            const originalKey = this.options.keyPrefix\n              ? key.substring(this.options.keyPrefix.length)\n              : key;\n            if (predicate(originalKey, value)) {\n              results.push(value);\n            }\n          }\n        } catch (error) {\n          console.error(`Error reading key '${key}' during find:`, error);\n        }\n      }\n\n      return results;\n    } catch (error) {\n      console.error('Error finding keys in NATS:', error);\n      return [];\n    }\n  }\n\n  /**\n   * Close the NATS connection\n   */\n  async close(): Promise<void> {\n    try {\n      if (this.connection) {\n        await this.connection.drain();\n        await this.connection.close();\n        this.connection = null;\n        this.state.kv = null;\n        this.state.connected = false;\n        this.initPromise = null;\n      }\n    } catch (error) {\n      console.error('Error closing NATS connection:', error);\n    }\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "axios-cache-nats-adapter",
+  "version": "1.0.0",
+  "description": "NATS storage adapter for axios-cache-interceptor",
+  "keywords": [
+    "axios",
+    "cache",
+    "nats",
+    "jetstream",
+    "storage",
+    "adapter",
+    "interceptor"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/youaftouh/axios-cache-nats-adapter.git"
+  },
+  "author": "Youssef Aftouh",
+  "license": "MIT",
+  "dependencies": {
+    "nats": "^2.28.2"
+  },
+  "peerDependencies": {
+    "axios-cache-interceptor": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.5",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "axios-cache-interceptor": "^1.5.3",
+    "eslint": "^8.56.0",
+    "prettier": "^3.2.4",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.1"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}