@frontmcp/plugins 0.1.2

package/README.md

@@ -0,0 +1,255 @@
+# MCP Gateway — Plugins
+
+Pluggable extensions for MCP Gateway live here. Each plugin can contribute **providers**, **hooks**, and optional **adapters** that extend the platform.
+
+If you want to use a specific plugin, open that plugin’s README for full details. This page serves as an index and a contributor guide.
+
+---
+
+## Table of contents
+
+- [Available plugins](#available-plugins)
+- [Quick start: enabling a plugin](#quick-start-enabling-a-plugin)
+- [Contributor guide: authoring a plugin](#contributor-guide-authoring-a-plugin)
+  - [1) Recommended folder layout](#1-recommended-folder-layout)
+  - [2) Export surface (`index.ts`)](#2-export-surface-indexts)
+  - [3) Type augmentation for `@McpTool`](#3-type-augmentation-for-mcptool)
+  - [4) Implementing the plugin class](#4-implementing-the-plugin-class)
+  - [5) Initialization styles (`DynamicPlugin.init`)](#5-initialization-styles-dynamicplugininit)
+  - [6) Hooks contributed by plugins](#6-hooks-contributed-by-plugins)
+  - [7) Registering your plugin in an app](#7-registering-your-plugin-in-an-app)
+  - [8) Documentation checklist](#8-documentation-checklist)
+  - [9) Forward-looking hook families](#9-forward-looking-hook-families)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Available plugins
+
+| Plugin | Description | Docs | Path |
+|-------|-------------|------|------|
+| Cache | Transparent caching for tool outputs keyed by input. Supports in-memory and Redis stores; per-tool TTL and sliding windows. | [Cache Plugin README](./src/cache/README.md) | [`src/cache`](./src/cache) |
+
+> For configuration and usage examples, follow the plugin’s own README.
+
+---
+
+## Quick start: enabling a plugin
+
+```ts
+// app.ts
+import { McpApp } from '@frontmcp/sdk';
+import CachePlugin from '@frontmcp/plugins/cache';
+
+@McpApp({
+  name: 'my-app',
+  plugins: [
+    CachePlugin, // or CachePlugin.init({...}) — see below for init styles
+  ],
+})
+export default class MyApp {}
+````
+
+---
+
+## Contributor guide: authoring a plugin
+
+The sections below summarize structure, type augmentation, dynamic providers, and hooks.
+
+### 1) Recommended folder layout
+
+```
+plugins/
+  src/<your-plugin>/
+    ├─ <your-plugin>.plugin.ts
+    ├─ <your-plugin>.types.ts
+    ├─ <your-plugin>.symbol.ts        # optional, for DI tokens
+    ├─ providers/                     # optional, runtime providers
+    │   └─ ...
+    ├─ index.ts
+    └─ README.md                      # user-facing docs
+```
+
+> If your repo uses a monorepo layout like `libs/plugins/src/...`, keep the same structure under that root. Paths in this README are relative to the current `plugins` folder.
+
+### 2) Export surface (`index.ts`)
+
+At `src/<your-plugin>/index.ts`, re-export the plugin and its types:
+
+```ts
+export { default } from './<your-plugin>.plugin';
+export * from './<your-plugin>.types';
+```
+
+### 3) Type augmentation for `@McpTool`
+
+If your plugin adds tool-level options (e.g., `@McpTool({ myFeature: {...} })`), augment the ambient `ToolMetadata` interface so tool authors get type-safe options.
+
+```ts
+// src/my-feature/my-feature.types.ts
+
+declare global {
+  interface ToolMetadata {
+    /** Enables MyFeature for a tool; `true` uses plugin defaults. */
+    myFeature?: MyFeatureToolOptions | true;
+  }
+}
+
+export interface MyFeatureToolOptions {
+  level?: 'low' | 'medium' | 'high';
+}
+
+export interface MyFeaturePluginOptions {
+  /** Options provided at plugin registration time. */
+  defaultLevel?: 'low' | 'medium' | 'high';
+}
+```
+
+> Why: `declare global` merges into the ambient `ToolMetadata` used by `@McpTool`, so TypeScript validates options wherever tools are defined.
+
+### 4) Implementing the plugin class
+
+Plugins are classes decorated with `@McpPlugin(...)`. For plugins that need configuration and/or generated providers, extend `DynamicPlugin<TOptions>` so you can support both value and factory initialization while contributing dynamic providers.
+
+```ts
+// src/my-feature/my-feature.plugin.ts
+import {
+  McpPlugin,
+  DynamicPlugin,
+  ToolHook,
+  ToolHookStage,
+  McpProviderType,
+} from '@frontmcp/sdk';
+import { MyFeaturePluginOptions } from './my-feature.types';
+
+@McpPlugin({
+  name: 'plugin:my-feature',
+  description: 'Does something useful',
+  providers: [
+    // Static providers that always load with the plugin (optional)
+    // { provide: MyToken, useClass: MyProvider },
+  ],
+})
+export default class MyFeaturePlugin extends DynamicPlugin<MyFeaturePluginOptions> {
+  static defaultOptions: MyFeaturePluginOptions = {
+    defaultLevel: 'medium',
+  };
+
+  // Contribute providers based on resolved options (runs before instance creation)
+  static override dynamicProviders(options: MyFeaturePluginOptions): readonly McpProviderType[] {
+    const providers: McpProviderType[] = [];
+    // Decide implementations based on options
+    // providers.push({ provide: MyToken, useValue: new MyProvider(options) });
+    return providers;
+  }
+
+  constructor(public readonly options: MyFeaturePluginOptions = MyFeaturePlugin.defaultOptions) {
+    super();
+  }
+
+  // Optional: register global tool hooks contributed by the plugin
+  @ToolHook(ToolHookStage.willExecute)
+  async willExecute(ctx: any) {
+    // Observe/mutate ctx.input before tool execution
+  }
+}
+```
+
+### 5) Initialization styles (`DynamicPlugin.init`)
+
+`DynamicPlugin` exposes a static `init()` so apps can register your plugin in different ways:
+
+* **Raw class** — zero-arg constructor only; no dynamic providers from options:
+
+  ```ts
+  plugins: [MyFeaturePlugin]
+  ```
+* **Value style** — options known upfront; `dynamicProviders(options)` is evaluated and merged:
+
+  ```ts
+  plugins: [MyFeaturePlugin.init({ defaultLevel: 'high' })]
+  ```
+* **Factory style** — compute options from app DI; then merge `dynamicProviders(realOptions)`:
+
+  ```ts
+  plugins: [
+    MyFeaturePlugin.init({
+      inject: () => [SomeConfig],
+      useFactory: (cfg) => ({ defaultLevel: cfg.level }),
+    }),
+  ]
+  ```
+
+Under the hood (high level):
+
+* Static providers from `@McpPlugin({ providers: [...] })` are merged first.
+* In **value**/**factory** styles, the registry evaluates `dynamicProviders(...)` and merges results.
+* Provider tokens are de-duplicated to avoid conflicts.
+
+> Implementation references (repository paths may vary):
+> `../common/src/plugins/dynamic.plugin.ts` and `../core/src/plugin/plugin.registry.ts`.
+
+### 6) Hooks contributed by plugins
+
+Plugins can register global tool hooks via `@ToolHook(stage)`. Hooks run for every tool unless filtered by metadata. Common stages include (examples; depends on platform version):
+
+* `willReadCache`, `willWriteCache` (see Cache plugin)
+* `willParseInput`, `willValidateInput`, `willExecute`, `didExecute`, `willFinalizeInvoke`
+
+See the cache example hooks in: [`src/cache/cache.plugin.ts`](./src/cache/cache.plugin.ts).
+
+### 7) Registering your plugin in an app
+
+```ts
+import { McpApp } from '@frontmcp/sdk';
+import MyFeaturePlugin from '@frontmcp/plugins/my-feature';
+
+@McpApp({
+  name: 'my-app',
+  plugins: [
+    MyFeaturePlugin, // or MyFeaturePlugin.init({...})
+  ],
+})
+export default class MyApp {}
+```
+
+### 8) Documentation checklist
+
+Each plugin must ship a `README.md` that explains:
+
+* **What it does** and **when to use it**
+* **Installation & registration** examples (raw/value/factory)
+* **Configuration options** (plugin-level and tool-level)
+* **Providers** it contributes and any required external services
+* **Hooks** it adds and how they affect tool/app behavior
+* **Examples** (minimal and advanced)
+
+For a concrete example, see the [Cache Plugin README](./src/cache/README.md).
+
+### 9) Forward-looking hook families
+
+These hook families are planned. Design plugins with extension points in mind:
+
+* **AppHook** — app bootstrap/shutdown lifecycle.
+* **HttpHook** — inbound/outbound request/response (tracing, auditing, rate limiting, etc.).
+* **AuthHook** — authentication/authorization lifecycle (challenge, success, failure).
+* **AdapterHooks** — participate in adapter initialization/configuration.
+* **IO Hooks** — monitor and optionally block filesystem/native calls (policy/sandbox).
+
+As these land, plugin authors will be able to add `@AppHook`, `@HttpHook`, `@AuthHook`, etc., similarly to `@ToolHook`.
+
+---
+
+## Contributing
+
+1. Create your plugin under `src/<your-plugin>/` following the layout above.
+2. Include a thorough `README.md` in your plugin folder.
+3. Add your plugin to the **Available plugins** table (name, short description, links).
+4. Submit a PR with tests and lint passing.
+
+---
+
+## License
+
+This folder inherits the repository’s license unless otherwise noted in individual plugin folders.

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@frontmcp/plugins",
+  "version": "0.1.2",
+  "type": "commonjs",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    "./cache": {
+      "development": "./src/cache/index.ts",
+      "types": "./dist/src/cache/index.d.ts",
+      "import": "./dist/src/cache/index.js",
+      "default": "./dist/src/cache/index.js"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/src/cache/cache.plugin.d.ts

@@ -0,0 +1,12 @@
+import { DynamicPlugin, ProviderType } from '@frontmcp/sdk';
+import { ToolInvokeContext } from '@frontmcp/core';
+import { CachePluginOptions } from './cache.types';
+export default class CachePlugin extends DynamicPlugin<CachePluginOptions> {
+    private readonly defaultTTL;
+    static dynamicProviders: (options: CachePluginOptions) => ProviderType[];
+    static defaultOptions: CachePluginOptions;
+    options: CachePluginOptions;
+    constructor(options?: CachePluginOptions);
+    willReadCache(ctx: ToolInvokeContext): Promise<void>;
+    willWriteCache(ctx: ToolInvokeContext): Promise<void>;
+}

package/src/cache/cache.plugin.js

@@ -0,0 +1,103 @@
+"use strict";
+var CachePlugin_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const sdk_1 = require("@frontmcp/sdk");
+const core_1 = require("@frontmcp/core");
+const file_hasher_1 = require("nx/src/hasher/file-hasher");
+const cache_redis_provider_1 = tslib_1.__importDefault(require("./providers/cache-redis.provider"));
+const cache_memory_provider_1 = tslib_1.__importDefault(require("./providers/cache-memory.provider"));
+const cache_symbol_1 = require("./cache.symbol");
+let CachePlugin = CachePlugin_1 = class CachePlugin extends sdk_1.DynamicPlugin {
+    constructor(options = CachePlugin_1.defaultOptions) {
+        super();
+        this.options = {
+            defaultTTL: 60 * 60 * 24,
+            ...options,
+        };
+    }
+    async willReadCache(ctx) {
+        const { cache } = ctx.metadata;
+        if (!cache) {
+            return;
+        }
+        const redis = ctx.get(cache_symbol_1.CacheStoreToken);
+        const hash = (0, file_hasher_1.hashObject)(ctx.input);
+        const cached = await redis.getValue(hash);
+        if (cache == true || (cache.ttl && cache.slideWindow)) {
+            const ttl = cache === true ? this.defaultTTL : cache.ttl ?? this.defaultTTL;
+            await redis.setValue(hash, cached, ttl);
+        }
+        if (cached) {
+            ctx.respond({
+                ...cached,
+                ___cached__: true,
+            });
+        }
+    }
+    async willWriteCache(ctx) {
+        const { cache } = ctx.metadata;
+        if (!cache) {
+            return;
+        }
+        console.log('willWriteCache', { cache });
+        const ttl = cache === true ? this.defaultTTL : cache.ttl ?? this.defaultTTL;
+        const redis = ctx.get(cache_symbol_1.CacheStoreToken);
+        const hash = (0, file_hasher_1.hashObject)(ctx.input);
+        await redis.setValue(hash, ctx.output, ttl);
+    }
+};
+CachePlugin.dynamicProviders = (options) => {
+    const providers = [];
+    switch (options.type) {
+        case 'redis':
+        case 'redis-client':
+            providers.push({
+                name: 'cache:redis',
+                provide: cache_symbol_1.CacheStoreToken,
+                useValue: new cache_redis_provider_1.default(options),
+            });
+            break;
+        case 'memory':
+            providers.push({
+                name: 'cache:memory',
+                provide: cache_symbol_1.CacheStoreToken,
+                useValue: new cache_memory_provider_1.default(options.defaultTTL),
+            });
+            break;
+    }
+    return providers;
+};
+CachePlugin.defaultOptions = {
+    type: 'memory',
+};
+tslib_1.__decorate([
+    (0, sdk_1.ToolHook)(sdk_1.ToolHookStage.willReadCache),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [core_1.ToolInvokeContext]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CachePlugin.prototype, "willReadCache", null);
+tslib_1.__decorate([
+    (0, sdk_1.ToolHook)(sdk_1.ToolHookStage.willWriteCache),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [core_1.ToolInvokeContext]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CachePlugin.prototype, "willWriteCache", null);
+CachePlugin = CachePlugin_1 = tslib_1.__decorate([
+    (0, sdk_1.Plugin)({
+        name: 'cache',
+        description: 'Cache plugin for caching tool results',
+        providers: [
+            /* add providers that always loaded with the plugin or default providers */
+            {
+                // this is default provider for cache, will be overridden if dynamicProviders based on config
+                name: 'cache:memory',
+                provide: cache_symbol_1.CacheStoreToken,
+                useValue: new cache_memory_provider_1.default(60 * 60 * 24),
+            },
+        ],
+    }),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], CachePlugin);
+exports.default = CachePlugin;
+//# sourceMappingURL=cache.plugin.js.map

package/src/cache/cache.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.plugin.js","sourceRoot":"","sources":["../../../src/cache/cache.plugin.ts"],"names":[],"mappings":";;;;AAAA,uCAA6F;AAC7F,yCAAmD;AACnD,2DAAuD;AACvD,oGAAkE;AAClE,sGAAoE;AAEpE,iDAAiD;AAelC,IAAM,WAAW,mBAAjB,MAAM,WAAY,SAAQ,mBAAiC;IA8BxE,YAAY,UAA8B,aAAW,CAAC,cAAc;QAClE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG;YACb,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;YACxB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAGK,AAAN,KAAK,CAAC,aAAa,CAAC,GAAsB;QACxC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAsB,8BAAe,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC;YAC5E,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,CAAC,OAAO,CAAC;gBACV,GAAG,MAAM;gBACT,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAGK,AAAN,KAAK,CAAC,cAAc,CAAC,GAAsB;QACzC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC;QAE5E,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAsB,8BAAe,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;;AAvEe,4BAAgB,GAAG,CAAC,OAA2B,EAAE,EAAE;IACjE,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,OAAO,CAAC;QACb,KAAK,cAAc;YACjB,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,8BAAe;gBACxB,QAAQ,EAAE,IAAI,8BAAkB,CAAC,OAAO,CAAC;aAC1C,CAAC,CAAC;YACH,MAAM;QACR,KAAK,QAAQ;YACX,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,8BAAe;gBACxB,QAAQ,EAAE,IAAI,+BAAmB,CAAC,OAAO,CAAC,UAAU,CAAC;aACtD,CAAC,CAAC;YACH,MAAM;IACV,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,AApB+B,CAoB9B;AAEK,0BAAc,GAAuB;IAC1C,IAAI,EAAE,QAAQ;CACf,AAFoB,CAEnB;AAYI;IADL,IAAA,cAAQ,EAAC,mBAAa,CAAC,aAAa,CAAC;;6CACb,wBAAiB;;gDAqBzC;AAGK;IADL,IAAA,cAAQ,EAAC,mBAAa,CAAC,cAAc,CAAC;;6CACb,wBAAiB;;iDAW1C;AA1EkB,WAAW;IAb/B,IAAA,YAAM,EAAC;QACN,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,uCAAuC;QACpD,SAAS,EAAE;YACT,2EAA2E;YAC3E;gBACE,6FAA6F;gBAC7F,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,8BAAe;gBACxB,QAAQ,EAAE,IAAI,+BAAmB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;aAChD;SACF;KACF,CAAC;;GACmB,WAAW,CA2E/B;kBA3EoB,WAAW","sourcesContent":["import { DynamicPlugin, Plugin, ToolHook, ProviderType, ToolHookStage } from '@frontmcp/sdk';\nimport { ToolInvokeContext } from '@frontmcp/core';\nimport { hashObject } from 'nx/src/hasher/file-hasher';\nimport CacheRedisProvider from './providers/cache-redis.provider';\nimport CacheMemoryProvider from './providers/cache-memory.provider';\nimport { CachePluginOptions, CacheStoreInterface } from './cache.types';\nimport { CacheStoreToken } from './cache.symbol';\n\n@Plugin({\n  name: 'cache',\n  description: 'Cache plugin for caching tool results',\n  providers: [\n    /* add providers that always loaded with the plugin or default providers */\n    {\n      // this is default provider for cache, will be overridden if dynamicProviders based on config\n      name: 'cache:memory',\n      provide: CacheStoreToken,\n      useValue: new CacheMemoryProvider(60 * 60 * 24),\n    },\n  ],\n})\nexport default class CachePlugin extends DynamicPlugin<CachePluginOptions> {\n  private readonly defaultTTL: number;\n\n  static override dynamicProviders = (options: CachePluginOptions) => {\n    const providers: ProviderType[] = [];\n    switch (options.type) {\n      case 'redis':\n      case 'redis-client':\n        providers.push({\n          name: 'cache:redis',\n          provide: CacheStoreToken,\n          useValue: new CacheRedisProvider(options),\n        });\n        break;\n      case 'memory':\n        providers.push({\n          name: 'cache:memory',\n          provide: CacheStoreToken,\n          useValue: new CacheMemoryProvider(options.defaultTTL),\n        });\n        break;\n    }\n    return providers;\n  };\n\n  static defaultOptions: CachePluginOptions = {\n    type: 'memory',\n  };\n  options: CachePluginOptions;\n\n  constructor(options: CachePluginOptions = CachePlugin.defaultOptions) {\n    super();\n    this.options = {\n      defaultTTL: 60 * 60 * 24,\n      ...options,\n    };\n  }\n\n  @ToolHook(ToolHookStage.willReadCache)\n  async willReadCache(ctx: ToolInvokeContext) {\n    const { cache } = ctx.metadata;\n    if (!cache) {\n      return;\n    }\n\n    const redis = ctx.get<CacheStoreInterface>(CacheStoreToken);\n    const hash = hashObject(ctx.input);\n    const cached = await redis.getValue(hash);\n\n    if (cache == true || (cache.ttl && cache.slideWindow)) {\n      const ttl = cache === true ? this.defaultTTL : cache.ttl ?? this.defaultTTL;\n      await redis.setValue(hash, cached, ttl);\n    }\n\n    if (cached) {\n      ctx.respond({\n        ...cached,\n        ___cached__: true,\n      });\n    }\n  }\n\n  @ToolHook(ToolHookStage.willWriteCache)\n  async willWriteCache(ctx: ToolInvokeContext) {\n    const { cache } = ctx.metadata;\n    if (!cache) {\n      return;\n    }\n    console.log('willWriteCache', { cache });\n    const ttl = cache === true ? this.defaultTTL : cache.ttl ?? this.defaultTTL;\n\n    const redis = ctx.get<CacheStoreInterface>(CacheStoreToken);\n    const hash = hashObject(ctx.input);\n    await redis.setValue(hash, ctx.output, ttl);\n  }\n}\n"]}

package/src/cache/cache.symbol.d.ts

@@ -0,0 +1 @@
+export declare const CacheStoreToken: unique symbol;

package/src/cache/cache.symbol.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheStoreToken = void 0;
+exports.CacheStoreToken = Symbol('plugin:cache:store');
+//# sourceMappingURL=cache.symbol.js.map

package/src/cache/cache.symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.symbol.js","sourceRoot":"","sources":["../../../src/cache/cache.symbol.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC","sourcesContent":["export const CacheStoreToken = Symbol('plugin:cache:store');\n"]}

package/src/cache/cache.types.d.ts

@@ -0,0 +1,45 @@
+import { Redis as RedisClient } from 'ioredis';
+declare global {
+    interface ExtendFrontMcpToolMetadata {
+        cache?: CachePluginToolOptions | true;
+    }
+}
+export interface CachePluginToolOptions {
+    /**
+     * Time to live in seconds. Default is 1 day.
+     */
+    ttl?: number;
+    /**
+     * If true, the cache value will be updated with the new value after the TTL.
+     * Default is false.
+     */
+    slideWindow?: boolean;
+}
+export interface BaseCachePluginOptions {
+    defaultTTL?: number;
+}
+export interface RedisClientCachePluginOptions extends BaseCachePluginOptions {
+    type: 'redis-client';
+    client: RedisClient;
+}
+export interface RedisCachePluginOptions extends BaseCachePluginOptions {
+    type: 'redis';
+    config: {
+        host: string;
+        port: number;
+        password?: string;
+        db?: number;
+    };
+}
+export type MemoryCachePluginOptions = BaseCachePluginOptions & {
+    type: 'memory';
+};
+export type RedisCacheOptions = RedisClientCachePluginOptions | RedisCachePluginOptions;
+export type CachePluginOptions = MemoryCachePluginOptions | RedisCacheOptions;
+export interface CacheStoreInterface {
+    setValue(key: string, value: any, ttlSeconds?: number): Promise<void>;
+    getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    close(): Promise<void>;
+}

package/src/cache/cache.types.js

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

package/src/cache/cache.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.types.js","sourceRoot":"","sources":["../../../src/cache/cache.types.ts"],"names":[],"mappings":"","sourcesContent":["import { Redis as RedisClient } from 'ioredis';\ndeclare global {\n  interface ExtendFrontMcpToolMetadata {\n    cache?: CachePluginToolOptions | true;\n  }\n}\n\nexport interface CachePluginToolOptions {\n  /**\n   * Time to live in seconds. Default is 1 day.\n   */\n  ttl?: number; // default 1 day\n\n  /**\n   * If true, the cache value will be updated with the new value after the TTL.\n   * Default is false.\n   */\n  slideWindow?: boolean;\n}\n\nexport interface BaseCachePluginOptions {\n  defaultTTL?: number; // default 1 day\n}\n\nexport interface RedisClientCachePluginOptions extends BaseCachePluginOptions {\n  type: 'redis-client';\n  client: RedisClient;\n}\nexport interface RedisCachePluginOptions extends BaseCachePluginOptions {\n  type: 'redis';\n  config: {\n    host: string;\n    port: number;\n    password?: string;\n    db?: number;\n  };\n}\nexport type MemoryCachePluginOptions = BaseCachePluginOptions & {\n  type: 'memory';\n};\n\nexport type RedisCacheOptions = RedisClientCachePluginOptions | RedisCachePluginOptions;\n\nexport type CachePluginOptions = MemoryCachePluginOptions | RedisCacheOptions;\n\nexport interface CacheStoreInterface {\n  setValue(key: string, value: any, ttlSeconds?: number): Promise<void>;\n  getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined>;\n  delete(key: string): Promise<void>;\n  exists(key: string): Promise<boolean>;\n  close(): Promise<void>;\n}\n"]}

package/src/cache/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './cache.plugin';
+export * from './cache.types';

package/src/cache/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+const tslib_1 = require("tslib");
+var cache_plugin_1 = require("./cache.plugin");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return tslib_1.__importDefault(cache_plugin_1).default; } });
+tslib_1.__exportStar(require("./cache.types"), exports);
+//# sourceMappingURL=index.js.map

package/src/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":";;;;AAAA,+CAAyC;AAAhC,gIAAA,OAAO,OAAA;AAChB,wDAA8B","sourcesContent":["export { default } from './cache.plugin';\nexport * from './cache.types';\n"]}

package/src/cache/providers/cache-memory.provider.d.ts

@@ -0,0 +1,19 @@
+import { CacheStoreInterface } from '../cache.types';
+export default class CacheMemoryProvider implements CacheStoreInterface {
+    private readonly memory;
+    private sweeper?;
+    constructor(sweepIntervalTTL?: number);
+    /** Set any value (auto-stringifies objects) */
+    setValue(key: string, value: any, ttlSeconds?: number): Promise<void>;
+    /** Get a value and automatically parse JSON if possible */
+    getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined>;
+    /** Delete a key */
+    delete(key: string): Promise<void>;
+    /** Check if a key exists (and not expired) */
+    exists(key: string): Promise<boolean>;
+    /** Gracefully close the provider */
+    close(): Promise<void>;
+    private isExpired;
+    /** Periodically remove expired keys to keep memory tidy */
+    private sweep;
+}

package/src/cache/providers/cache-memory.provider.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const sdk_1 = require("@frontmcp/sdk");
+const MAX_TIMEOUT_MS = 2 ** 31 - 1; // ~24.8 days (Node setTimeout limit)
+let CacheMemoryProvider = class CacheMemoryProvider {
+    constructor(sweepIntervalTTL = 60) {
+        this.memory = new Map();
+        this.sweeper = setInterval(() => this.sweep(), sweepIntervalTTL * 1000);
+        // don’t keep the process alive just for the sweeper (Node >=14)
+        this.sweeper.unref?.();
+    }
+    /** Set any value (auto-stringifies objects) */
+    async setValue(key, value, ttlSeconds) {
+        const strValue = typeof value === 'string' ? value : JSON.stringify(value);
+        // clear any previous timeout on this key
+        const existing = this.memory.get(key);
+        if (existing?.timeout)
+            clearTimeout(existing.timeout);
+        const entry = { value: strValue };
+        if (ttlSeconds && ttlSeconds > 0) {
+            const ttlMs = ttlSeconds * 1000;
+            entry.expiresAt = Date.now() + ttlMs;
+            // Only schedule a timer if within Node's setTimeout limit; otherwise rely on sweeper/lazy purge
+            if (ttlMs <= MAX_TIMEOUT_MS) {
+                entry.timeout = setTimeout(() => {
+                    // final check guards against clock drift or updates
+                    const e = this.memory.get(key);
+                    if (e && e.expiresAt && e.expiresAt <= Date.now()) {
+                        this.memory.delete(key);
+                    }
+                }, ttlMs);
+                entry.timeout.unref?.();
+            }
+        }
+        this.memory.set(key, entry);
+    }
+    /** Get a value and automatically parse JSON if possible */
+    async getValue(key, defaultValue) {
+        const entry = this.memory.get(key);
+        if (!entry)
+            return defaultValue;
+        if (this.isExpired(entry)) {
+            await this.delete(key);
+            return defaultValue;
+        }
+        const raw = entry.value;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            // fallback for plain string values
+            return raw;
+        }
+    }
+    /** Delete a key */
+    async delete(key) {
+        const entry = this.memory.get(key);
+        if (entry?.timeout)
+            clearTimeout(entry.timeout);
+        this.memory.delete(key);
+    }
+    /** Check if a key exists (and not expired) */
+    async exists(key) {
+        const entry = this.memory.get(key);
+        if (!entry)
+            return false;
+        if (this.isExpired(entry)) {
+            await this.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /** Gracefully close the provider */
+    async close() {
+        if (this.sweeper)
+            clearInterval(this.sweeper);
+        for (const [, entry] of this.memory) {
+            if (entry.timeout)
+                clearTimeout(entry.timeout);
+        }
+        this.memory.clear();
+    }
+    // ---- internals ----
+    isExpired(entry) {
+        return entry.expiresAt !== undefined && entry.expiresAt <= Date.now();
+    }
+    /** Periodically remove expired keys to keep memory tidy */
+    sweep() {
+        const now = Date.now();
+        for (const [key, entry] of this.memory) {
+            if (entry.expiresAt !== undefined && entry.expiresAt <= now) {
+                if (entry.timeout)
+                    clearTimeout(entry.timeout);
+                this.memory.delete(key);
+            }
+        }
+    }
+};
+CacheMemoryProvider = tslib_1.__decorate([
+    (0, sdk_1.Provider)({
+        name: 'provider:cache:memory',
+        description: 'Memory-based cache provider',
+        scope: sdk_1.ProviderScope.GLOBAL,
+    }),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], CacheMemoryProvider);
+exports.default = CacheMemoryProvider;
+//# sourceMappingURL=cache-memory.provider.js.map

package/src/cache/providers/cache-memory.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-memory.provider.js","sourceRoot":"","sources":["../../../../src/cache/providers/cache-memory.provider.ts"],"names":[],"mappings":"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","sourcesContent":["import { Provider, ProviderScope } from '@frontmcp/sdk';\nimport { CacheStoreInterface } from '../cache.types';\n\ntype Entry = {\n  value: string;\n  /** epoch millis when this entry expires (undefined = no TTL) */\n  expiresAt?: number;\n  /** per-key timeout when TTL is short enough to schedule */\n  timeout?: NodeJS.Timeout;\n};\n\nconst MAX_TIMEOUT_MS = 2 ** 31 - 1; // ~24.8 days (Node setTimeout limit)\n\n@Provider({\n  name: 'provider:cache:memory',\n  description: 'Memory-based cache provider',\n  scope: ProviderScope.GLOBAL,\n})\nexport default class CacheMemoryProvider  implements CacheStoreInterface{\n  private readonly memory = new Map<string, Entry>();\n  private sweeper?: NodeJS.Timeout;\n\n  constructor(sweepIntervalTTL = 60) {\n    this.sweeper = setInterval(() => this.sweep(), sweepIntervalTTL * 1000);\n    // don’t keep the process alive just for the sweeper (Node >=14)\n    (this.sweeper as any).unref?.();\n  }\n\n  /** Set any value (auto-stringifies objects) */\n  async setValue(key: string, value: any, ttlSeconds?: number): Promise<void> {\n    const strValue = typeof value === 'string' ? value : JSON.stringify(value);\n\n    // clear any previous timeout on this key\n    const existing = this.memory.get(key);\n    if (existing?.timeout) clearTimeout(existing.timeout);\n\n    const entry: Entry = { value: strValue };\n\n    if (ttlSeconds && ttlSeconds > 0) {\n      const ttlMs = ttlSeconds * 1000;\n      entry.expiresAt = Date.now() + ttlMs;\n\n      // Only schedule a timer if within Node's setTimeout limit; otherwise rely on sweeper/lazy purge\n      if (ttlMs <= MAX_TIMEOUT_MS) {\n        entry.timeout = setTimeout(() => {\n          // final check guards against clock drift or updates\n          const e = this.memory.get(key);\n          if (e && e.expiresAt && e.expiresAt <= Date.now()) {\n            this.memory.delete(key);\n          }\n        }, ttlMs);\n        (entry.timeout as any).unref?.();\n      }\n    }\n\n    this.memory.set(key, entry);\n  }\n\n  /** Get a value and automatically parse JSON if possible */\n  async getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined> {\n    const entry = this.memory.get(key);\n    if (!entry) return defaultValue;\n\n    if (this.isExpired(entry)) {\n      await this.delete(key);\n      return defaultValue;\n    }\n\n    const raw = entry.value;\n    try {\n      return JSON.parse(raw) as T;\n    } catch {\n      // fallback for plain string values\n      return raw as unknown as T;\n    }\n  }\n\n  /** Delete a key */\n  async delete(key: string): Promise<void> {\n    const entry = this.memory.get(key);\n    if (entry?.timeout) clearTimeout(entry.timeout);\n    this.memory.delete(key);\n  }\n\n  /** Check if a key exists (and not expired) */\n  async exists(key: string): Promise<boolean> {\n    const entry = this.memory.get(key);\n    if (!entry) return false;\n    if (this.isExpired(entry)) {\n      await this.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  /** Gracefully close the provider */\n  async close(): Promise<void> {\n    if (this.sweeper) clearInterval(this.sweeper);\n    for (const [, entry] of this.memory) {\n      if (entry.timeout) clearTimeout(entry.timeout);\n    }\n    this.memory.clear();\n  }\n\n  // ---- internals ----\n\n  private isExpired(entry: Entry): boolean {\n    return entry.expiresAt !== undefined && entry.expiresAt <= Date.now();\n  }\n\n  /** Periodically remove expired keys to keep memory tidy */\n  private sweep(): void {\n    const now = Date.now();\n    for (const [key, entry] of this.memory) {\n      if (entry.expiresAt !== undefined && entry.expiresAt <= now) {\n        if (entry.timeout) clearTimeout(entry.timeout);\n        this.memory.delete(key);\n      }\n    }\n  }\n}\n"]}

package/src/cache/providers/cache-redis.provider.d.ts

@@ -0,0 +1,15 @@
+import { CacheStoreInterface, RedisCacheOptions } from '../cache.types';
+export default class CacheRedisProvider implements CacheStoreInterface {
+    private readonly client;
+    constructor(options: RedisCacheOptions);
+    /** Set any value (auto-stringifies objects) */
+    setValue(key: string, value: any, ttlSeconds?: number): Promise<void>;
+    /** Get a value and automatically parse JSON if possible */
+    getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined>;
+    /** Delete a key */
+    delete(key: string): Promise<void>;
+    /** Check if a key exists */
+    exists(key: string): Promise<boolean>;
+    /** Gracefully close the Redis connection */
+    close(): Promise<void>;
+}

package/src/cache/providers/cache-redis.provider.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const ioredis_1 = tslib_1.__importDefault(require("ioredis"));
+const sdk_1 = require("@frontmcp/sdk");
+let CacheRedisProvider = class CacheRedisProvider {
+    constructor(options) {
+        if (options.type !== 'redis' && options.type !== 'redis-client') {
+            throw new Error('Invalid cache provider type');
+        }
+        if (options.type === 'redis-client') {
+            this.client = options.client;
+            return;
+        }
+        this.client = new ioredis_1.default({
+            lazyConnect: false,
+            maxRetriesPerRequest: 3,
+            ...options.config,
+        });
+        this.client.on('connect', () => console.log('[Redis] Connected'));
+        this.client.on('error', (err) => console.error('[Redis] Error:', err));
+    }
+    /** Set any value (auto-stringifies objects) */
+    async setValue(key, value, ttlSeconds) {
+        const strValue = typeof value === 'string' ? value : JSON.stringify(value);
+        if (ttlSeconds && ttlSeconds > 0) {
+            await this.client.set(key, strValue, 'EX', ttlSeconds);
+        }
+        else {
+            await this.client.set(key, strValue);
+        }
+    }
+    /** Get a value and automatically parse JSON if possible */
+    async getValue(key, defaultValue) {
+        const raw = await this.client.get(key);
+        if (raw === null)
+            return defaultValue;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            // fallback for plain string values
+            return raw;
+        }
+    }
+    /** Delete a key */
+    async delete(key) {
+        await this.client.del(key);
+    }
+    /** Check if a key exists */
+    async exists(key) {
+        return (await this.client.exists(key)) === 1;
+    }
+    /** Gracefully close the Redis connection */
+    async close() {
+        await this.client.quit();
+    }
+};
+CacheRedisProvider = tslib_1.__decorate([
+    (0, sdk_1.Provider)({
+        name: 'provider:cache:redis',
+        description: 'Redis-based cache provider',
+        scope: sdk_1.ProviderScope.GLOBAL,
+    }),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], CacheRedisProvider);
+exports.default = CacheRedisProvider;
+//# sourceMappingURL=cache-redis.provider.js.map

package/src/cache/providers/cache-redis.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-redis.provider.js","sourceRoot":"","sources":["../../../../src/cache/providers/cache-redis.provider.ts"],"names":[],"mappings":";;;AAAA,8DAAsD;AACtD,uCAAwD;AAQzC,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAGrC,YAAY,OAA0B;QACpC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAK,CAAC;YACtB,WAAW,EAAE,KAAK;YAClB,oBAAoB,EAAE,CAAC;YACvB,GAAG,OAAO,CAAC,MAAM;SAClB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,KAAU,EAAE,UAAmB;QACzD,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAI,UAAU,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,QAAQ,CAAU,GAAW,EAAE,YAAgB;QACnD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,YAAY,CAAC;QAEtC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;YACnC,OAAO,GAAmB,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF,CAAA;AA3DoB,kBAAkB;IALtC,IAAA,cAAQ,EAAC;QACR,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,mBAAa,CAAC,MAAM;KAC5B,CAAC;;GACmB,kBAAkB,CA2DtC;kBA3DoB,kBAAkB","sourcesContent":["import Redis, { Redis as RedisClient } from 'ioredis';\nimport { Provider, ProviderScope } from '@frontmcp/sdk';\nimport { CacheStoreInterface, RedisCacheOptions } from '../cache.types';\n\n@Provider({\n  name: 'provider:cache:redis',\n  description: 'Redis-based cache provider',\n  scope: ProviderScope.GLOBAL,\n})\nexport default class CacheRedisProvider implements CacheStoreInterface {\n  private readonly client: RedisClient;\n\n  constructor(options: RedisCacheOptions) {\n    if (options.type !== 'redis' && options.type !== 'redis-client') {\n      throw new Error('Invalid cache provider type');\n    }\n\n    if (options.type === 'redis-client') {\n      this.client = options.client;\n      return;\n    }\n    this.client = new Redis({\n      lazyConnect: false,\n      maxRetriesPerRequest: 3,\n      ...options.config,\n    });\n\n    this.client.on('connect', () => console.log('[Redis] Connected'));\n    this.client.on('error', (err) => console.error('[Redis] Error:', err));\n  }\n\n  /** Set any value (auto-stringifies objects) */\n  async setValue(key: string, value: any, ttlSeconds?: number): Promise<void> {\n    const strValue = typeof value === 'string' ? value : JSON.stringify(value);\n    if (ttlSeconds && ttlSeconds > 0) {\n      await this.client.set(key, strValue, 'EX', ttlSeconds);\n    } else {\n      await this.client.set(key, strValue);\n    }\n  }\n\n  /** Get a value and automatically parse JSON if possible */\n  async getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined> {\n    const raw = await this.client.get(key);\n    if (raw === null) return defaultValue;\n\n    try {\n      return JSON.parse(raw) as T;\n    } catch {\n      // fallback for plain string values\n      return raw as unknown as T;\n    }\n  }\n\n  /** Delete a key */\n  async delete(key: string): Promise<void> {\n    await this.client.del(key);\n  }\n\n  /** Check if a key exists */\n  async exists(key: string): Promise<boolean> {\n    return (await this.client.exists(key)) === 1;\n  }\n\n  /** Gracefully close the Redis connection */\n  async close(): Promise<void> {\n    await this.client.quit();\n  }\n}\n"]}