@nestjs-mcp/server 0.1.0-alpha.4

package/README.md

@@ -0,0 +1,490 @@
+# MCP Server NestJS Module Library <!-- omit in toc -->
+
+[![NPM Version](https://img.shields.io/npm/v/@your-org/nestjs-mcp-server)](https://www.npmjs.com/package/@nestjs-mcp/server)
+[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
+
+---
+
+## Overview <!-- omit in toc -->
+
+**NestJS MCP Server** is a modular library for building [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol/typescript-sdk/tree/server) servers using [NestJS](https://nestjs.com/). It provides decorators, modules, and integration patterns to expose MCP resources, tools, and prompts in a scalable, maintainable way. This project is a wrapper for the official [`@modelcontextprotocol/sdk`](https://github.com/modelcontextprotocol/typescript-sdk/tree/server) and is always kept compatible with its types and specification.
+
+---
+
+## Table of Contents <!-- omit in toc -->
+
+- [Overview](#overview)
+- [Installation](#installation)
+- [Quickstart](#quickstart)
+- [What is MCP?](#what-is-mcp)
+- [Core Concepts](#core-concepts)
+  - [Server](#server)
+  - [Resource](#resource)
+  - [Tool](#tool)
+  - [Prompt](#prompt)
+- [Module API](#module-api)
+  - [forRoot](#mcpmoduleforroot)
+  - [forFeature](#mcpmoduleforfeature)
+  - [Resolver](#resolver)
+- [Capabilities](#capabilities)
+  - [@Resolver](#resolver-decorator)
+  - [@Prompt](#prompt-decorator)
+  - [@Resource](#resource-decorator)
+  - [@Tool](#tool-decorator)
+- [Guards](#guards)
+  - [Global-level guards:](#global-guard-guards)
+  - [Resolver-level guards:](#resolver-level-guards)
+  - [Method-level guards:](#method-level-guards)
+  - [Guard Example](#guard-example)
+- [Inspector Playground](#inspector-playground)
+- [Examples](#examples)
+- [Changelog](#changelog)
+- [License](#license)
+- [Contributions](#contributions)
+
+---
+
+## Installation
+
+```sh
+pnpm add @your-org/nestjs-mcp-server @modelcontextprotocol/sdk
+# or
+npm install @your-org/nestjs-mcp-server @modelcontextprotocol/sdk
+```
+
+---
+
+## Quickstart
+
+Register the MCP module in your NestJS app and expose a simple tool:
+
+```ts
+import { Module } from '@nestjs/common';
+import { Injectable } from '@nestjs/common';
+
+import { CallToolResult } from '@modelcontextprotocol/sdk/types';
+
+import { Tool } from '@nestjs-mcp/server';
+
+@Injectable()
+export class AppService {
+  /**
+   * Simple health check tool
+   */
+  @Tool({ name: 'server_health_check' })
+  healthCheck(): CallToolResult {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: 'Server is operational. All systems running normally.',
+        },
+      ],
+    };
+  }
+}
+
+@Module({
+  imports: [
+    McpModule.forRoot({
+      name: 'My MCP Server',
+      version: '1.0.0',
+    }),
+  ],
+  providers: [AppService],
+})
+export class AppModule {}
+```
+
+---
+
+## What is MCP?
+
+The **Model Context Protocol (MCP)** is an open protocol for connecting LLMs to external data, tools, and prompts. MCP servers expose resources (data), tools (actions), and prompts (conversational flows) in a standardized way, enabling seamless integration with LLM-powered clients.
+
+- See the [Anthropic announcement](https://www.anthropic.com/news/model-context-protocol) for more background.
+
+---
+
+## Core Concepts
+
+### Server
+
+The MCP Server is the main entry point for exposing capabilities to LLMs. It manages the registration and discovery of resources, tools, and prompts.
+
+### Resource
+
+A Resource represents structured data or documents that can be queried or retrieved by LLMs. Resources are typically read-only and are identified by a unique URI.
+
+- Learn more: [MCP Resources documentation](https://modelcontextprotocol.io/docs/concepts/resources)
+
+### Tool
+
+A Tool is an action or function that can be invoked by LLMs. Tools may have side effects and can accept parameters to perform computations or trigger operations.
+
+- Learn more: [MCP Tools documentation](https://modelcontextprotocol.io/docs/concepts/tools)
+
+### Prompt
+
+A Prompt defines a conversational flow, template, or interaction pattern for LLMs. Prompts help guide the model’s behavior in specific scenarios.
+
+- Learn more: [MCP Prompts documentation](https://modelcontextprotocol.io/docs/concepts/prompts)
+
+> **See the [Capabilities](#capabilities) section for implementation details and code examples.**
+
+---
+
+## Module API
+
+### `McpModule.forRoot`
+
+Registers the MCP Server globally in your NestJS application. Accepts an options object compatible with the MCP Server specification from `@modelcontextprotocol/sdk`.
+
+**Parameters:**
+
+- `options: McpServerOptions` — Main server configuration (name, version, description, etc.)
+
+**Returns:**
+
+- A dynamic NestJS module with all MCP providers registered
+
+**Example:**
+
+```ts
+import { McpModule } from '@nestjs-mcp/server';
+
+@Module({
+  imports: [
+    McpModule.forRoot({
+      name: 'My Server',
+      version: '1.0.0',
+      // ...other MCP options
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### `McpModule.forFeature`
+
+Registers additional MCP resources, tools, or prompts in a feature module. Use this to organize large servers into multiple modules.
+
+**Parameters:**
+
+- `providers: Provider[]` — Array of NestJS providers (resources, tools, prompts)
+
+**Returns:**
+
+- A dynamic module with the specified providers
+
+**Example:**
+
+```ts
+import { McpModule } from '@nestjs-mcp/server';
+
+@Module({
+  imports: [McpModule.forFeature()],
+  providers: [
+    /*Your Providers with Mcp Capabilities*/
+  ],
+})
+export class StatusModule {}
+```
+
+---
+
+## Module Usage
+
+This library provides two main ways to register MCP capabilities in your NestJS application:
+
+### 1. Global Registration with `McpModule.forRoot`
+
+Use `McpModule.forRoot` in your root application module to configure and register the MCP server globally. This is required for every MCP server application.
+
+```ts
+import { Module } from '@nestjs/common';
+import { McpModule } from '@nestjs-mcp/server';
+import { PromptsResolver } from './prompts.resolver';
+
+@Module({
+  imports: [
+    McpModule.forRoot({
+      name: 'My MCP Server',
+      version: '1.0.0',
+      // ...other MCP options
+    }),
+  ],
+  providers: [PromptsResolver],
+})
+export class AppModule {}
+```
+
+### 2. Feature Module Registration with `McpModule.forFeature`
+
+Use `McpModule.forFeature` in feature modules to register additional resolvers, tools, or resources. This is useful for organizing large servers into multiple modules.
+
+```ts
+import { Module } from '@nestjs/common';
+import { McpModule } from '@nestjs-mcp/server';
+
+import { ToolsResolver } from './tools.resolver';
+
+@Module({
+  imports: [McpModule.forFeature()],
+  providers: [ToolsResolver],
+})
+export class ToolsModule {}
+```
+
+- Use `forRoot` only once in your root module.
+- Use `forFeature` as many times as needed in feature modules.
+- All resolvers, tools, and resources must be registered as providers.
+
+---
+
+## Capabilities
+
+This library provides a set of decorators to define MCP capabilities and apply cross-cutting concerns such as guards. Decorators can be used at both the Resolver (class) level and the method level.
+
+### Resolver Decorator
+
+A Resolver is a class that groups related MCP capabilities (such as prompts, resources, and tools) and provides a workspace context for them. Use the `@Resolver` decorator to mark a class as a resolver. Dependency injection is supported, and you can apply guards or other cross-cutting concerns at the class level.
+
+**Example:**
+
+```ts
+import { Resolver, Prompt, Resource, Tool } from '@nestjs-mcp/server';
+
+@Resolver('workspace')
+export class MyResolver {
+  @Prompt({ name: 'greet' })
+  greetPrompt() {
+    /* ... */
+  }
+
+  @Resource({ name: 'user', uri: 'user://{id}' })
+  getUserResource() {
+    /* ... */
+  }
+
+  @Tool({ name: 'sum' })
+  sumTool() {
+    /* ... */
+  }
+}
+```
+
+You can also apply guards at the resolver level:
+
+```ts
+import { UseGuards, Resolver } from '@nestjs-mcp/server';
+import { MyGuard } from './guards/my.guard';
+
+@UseGuards(MyGuard)
+@Resolver('secure')
+export class SecureResolver {
+  // ...
+}
+```
+
+### Prompt Decorator
+
+Decorate methods within a Resolver to expose them as MCP Prompts.
+
+```ts
+import { Prompt } from '@nestjs-mcp/server';
+
+@Resolver('workspace')
+export class MyResolver {
+  @Prompt({ name: 'greet' })
+  greetPrompt() {
+    /* ... */
+  }
+}
+```
+
+### Resource Decorator
+
+Decorate methods within a Resolver to expose them as MCP Resources.
+
+```ts
+import { Resource } from '@nestjs-mcp/server';
+
+@Resolver('workspace')
+export class MyResolver {
+  @Resource({ name: 'user', uri: 'user://{id}' })
+  getUserResource() {
+    /* ... */
+  }
+}
+```
+
+### Tool Decorator
+
+Decorate methods within a Resolver to expose them as MCP Tools.
+
+```ts
+import { Tool } from '@nestjs-mcp/server';
+
+@Resolver('workspace')
+export class MyResolver {
+  @Tool({ name: 'sum' })
+  sumTool() {
+    /* ... */
+  }
+}
+```
+
+---
+
+## Guards
+
+Apply one or more guards to a Resolver, to individual methods, or globally. Guards must implement the NestJS `CanActivate` interface.
+
+### Global-level guards:
+
+This approach uses the standard NestJS global guard system. A global guard will protect all entry points of your MCP server by running before any connection is handled. Use this for authentication, API key checks, or any logic that should apply to every connection.
+
+```ts
+// src/guards/global-auth.guard.ts
+import { CanActivate, ExecutionContext, Injectable } from '@nestjs/common';
+
+@Injectable()
+export class GlobalAuthGuard implements CanActivate {
+  canActivate(context: ExecutionContext): boolean {
+    // Example: Allow all requests (replace with real logic)
+    // You can access request info via context.switchToHttp().getRequest() if needed
+    return true;
+  }
+}
+```
+
+Register the guard globally in your main module:
+
+```ts
+import { Module } from '@nestjs/common';
+import { APP_GUARD } from '@nestjs/core';
+import { McpModule } from '@nestjs-mcp/server';
+import { GlobalAuthGuard } from './guards/global-auth.guard';
+import { PromptsResolver } from './prompts.resolver';
+
+@Module({
+  imports: [
+    McpModule.forRoot({
+      name: 'My MCP Server',
+      version: '1.0.0',
+    }),
+  ],
+  providers: [
+    PromptsResolver,
+    {
+      provide: APP_GUARD,
+      useClass: GlobalAuthGuard,
+    },
+  ],
+})
+export class AppModule {}
+```
+
+**Key points:**
+
+- The guard will run for every request handled by your NestJS application, including all MCP endpoints.
+- You can implement any logic in canActivate, such as checking headers, tokens, or user roles.
+- This approach is fully compatible with NestJS and your MCP Server module.
+
+### Resolver-level guards:
+
+This is a custom feature of this library. Resolver-level guards are applied using the `@UseGuards` decorator on a Resolver class. All MCP methods (`@Prompt`, `@Resource`, `@Tool`) in the resolver will be protected by these guards. Use this to enforce logic (e.g., role checks) for a specific group of capabilities.
+
+```ts
+import { UseGuards, Resolver, Prompt } from '@nestjs-mcp/server';
+import { MyGuard } from './guards/my.guard';
+
+@UseGuards(MyGuard)
+@Resolver('secure')
+export class SecureResolver {
+  @Prompt({ name: 'securePrompt' })
+  securePrompt() {
+    /* ... */
+  }
+}
+```
+
+### Method-level guards:
+
+This is a custom feature of this library. Method-level guards are applied using the `@UseGuards` decorator directly on a method. Only the decorated MCP method will be protected by these guards. Use this for fine-grained access control on specific capabilities.
+
+```ts
+import { UseGuards, Resolver, Prompt } from '@nestjs-mcp/server';
+import { MyGuard } from './guards/my.guard';
+
+@Resolver('mixed')
+export class MixedResolver {
+  @Prompt({ name: 'publicPrompt' })
+  publicPrompt() {
+    /* ... */
+  }
+
+  @UseGuards(MyGuard)
+  @Prompt({ name: 'protectedPrompt' })
+  protectedPrompt() {
+    /* ... */
+  }
+}
+```
+
+### Guard Example
+
+```ts
+import { CanActivate } from '@nestjs/common';
+import { McpExecutionContext } from '@nestjs-mcp/server';
+
+export class MyGuard implements CanActivate {
+  canActivate(context: McpExecutionContext): boolean {
+    // Custom logic: allow or deny
+    return true;
+  }
+}
+```
+
+---
+
+## Inspector Playground
+
+Use the Inspector Playground to interactively test and debug your MCP server endpoints in a browser UI. This tool, powered by [`@modelcontextprotocol/inspector`](https://www.npmjs.com/package/@modelcontextprotocol/inspector), allows you to:
+
+- Explore available resources, tools, and prompts
+- Invoke endpoints and view responses in real time
+- Validate your server implementation against the MCP specification
+
+To launch the Inspector Playground:
+
+```sh
+npx @modelcontextprotocol/inspector
+```
+
+---
+
+## Examples
+
+The [`examples/`](./examples/) directory contains ready-to-use scenarios demonstrating how to register and expose MCP capabilities
+
+Each example is self-contained and follows best practices. For advanced usage, see the code and documentation in each example.
+
+---
+
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md) for release notes.
+
+---
+
+## License
+
+MIT — see [LICENSE](./LICENSE) for details.
+
+---
+
+## Contributions
+
+Contributions are welcome! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines, reporting issues, and pull request rules.

package/dist/examples/async-import/app.module.d.ts

@@ -0,0 +1,2 @@
+export declare class AppModule {
+}

package/dist/examples/async-import/app.module.js

@@ -0,0 +1,33 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModule = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const mcp_module_1 = require("../../src/mcp.module");
+let AppModule = class AppModule {
+};
+exports.AppModule = AppModule;
+exports.AppModule = AppModule = __decorate([
+    (0, common_1.Module)({
+        imports: [
+            mcp_module_1.McpModule.forRootAsync({
+                imports: [config_1.ConfigModule.forRoot()],
+                useFactory: (configService) => ({
+                    name: 'tools',
+                    version: '1.0.0',
+                    logging: {
+                        enabled: configService.get('MCP_LOGGING_ENABLED'),
+                        level: configService.get('MCP_LOGGING_LEVEL'),
+                    },
+                }),
+            }),
+        ],
+    })
+], AppModule);
+//# sourceMappingURL=app.module.js.map

package/dist/examples/async-import/app.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../../../examples/async-import/app.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AAExC,2CAA6D;AAE7D,qDAAiD;AAiB1C,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IAfrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,sBAAS,CAAC,YAAY,CAAC;gBACrB,OAAO,EAAE,CAAC,qBAAY,CAAC,OAAO,EAAE,CAAC;gBACjC,UAAU,EAAE,CAAC,aAA4B,EAAE,EAAE,CAAC,CAAC;oBAC7C,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,OAAO;oBAChB,OAAO,EAAE;wBACP,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,qBAAqB,CAAC;wBACjD,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,mBAAmB,CAAC;qBAC9C;iBACF,CAAC;aACH,CAAC;SACH;KACF,CAAC;GACW,SAAS,CAAG"}

package/dist/examples/async-import/main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/examples/async-import/main.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@nestjs/core");
+const app_module_1 = require("./app.module");
+async function bootstrap() {
+    try {
+        const app = await core_1.NestFactory.create(app_module_1.AppModule);
+        await app.listen(3000);
+        console.log('Async-import example server running on http://localhost:3000');
+    }
+    catch (error) {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    }
+}
+void bootstrap();
+//# sourceMappingURL=main.js.map

package/dist/examples/async-import/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../examples/async-import/main.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,6CAAyC;AAEzC,KAAK,UAAU,SAAS;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,sBAAS,CAAC,CAAC;QAChD,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,SAAS,EAAE,CAAC"}

package/dist/examples/guards/app.module.d.ts

@@ -0,0 +1,6 @@
+import { CanActivate, ExecutionContext } from '@nestjs/common';
+export declare class GlobalLogGuard implements CanActivate {
+    canActivate(_context: ExecutionContext): boolean;
+}
+export declare class AppModule {
+}

package/dist/examples/guards/app.module.js

@@ -0,0 +1,48 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModule = exports.GlobalLogGuard = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_module_1 = require("../../src/mcp.module");
+const core_1 = require("@nestjs/core");
+const guards_resolver_1 = require("./guards.resolver");
+let GlobalLogGuard = class GlobalLogGuard {
+    canActivate(_context) {
+        console.log('[GlobalLogGuard] Global guard executed');
+        return true;
+    }
+};
+exports.GlobalLogGuard = GlobalLogGuard;
+exports.GlobalLogGuard = GlobalLogGuard = __decorate([
+    (0, common_1.Injectable)()
+], GlobalLogGuard);
+let AppModule = class AppModule {
+};
+exports.AppModule = AppModule;
+exports.AppModule = AppModule = __decorate([
+    (0, common_1.Module)({
+        imports: [
+            mcp_module_1.McpModule.forRoot({
+                name: 'tools',
+                version: '1.0.0',
+                logging: {
+                    enabled: true,
+                    level: 'verbose',
+                },
+            }),
+        ],
+        providers: [
+            {
+                provide: core_1.APP_GUARD,
+                useClass: GlobalLogGuard,
+            },
+            guards_resolver_1.GuardsResolver,
+        ],
+    })
+], AppModule);
+//# sourceMappingURL=app.module.js.map

package/dist/examples/guards/app.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../../../examples/guards/app.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAKwB;AAExB,qDAAiD;AAEjD,uCAAyC;AACzC,uDAAmD;AAI5C,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,WAAW,CAAC,QAA0B;QAIpC,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AARY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;GACA,cAAc,CAQ1B;AAqBM,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IAnBrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,sBAAS,CAAC,OAAO,CAAC;gBAChB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,OAAO;gBAChB,OAAO,EAAE;oBACP,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,SAAS;iBACjB;aACF,CAAC;SACH;QACD,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,gBAAS;gBAClB,QAAQ,EAAE,cAAc;aACzB;YACD,gCAAc;SACf;KACF,CAAC;GACW,SAAS,CAAG"}

package/dist/examples/guards/guards.resolver.d.ts

@@ -0,0 +1,13 @@
+import { CanActivate } from '@nestjs/common';
+import { McpExecutionContext } from '../../src';
+import { CallToolResult, GetPromptResult } from '@modelcontextprotocol/sdk/types';
+export declare class ResolverLogGuard implements CanActivate {
+    canActivate(_context: McpExecutionContext): boolean;
+}
+export declare class MethodLogGuard implements CanActivate {
+    canActivate(_context: McpExecutionContext): boolean;
+}
+export declare class GuardsResolver {
+    logPrompt(): GetPromptResult;
+    logTool(): CallToolResult;
+}

package/dist/examples/guards/guards.resolver.js

@@ -0,0 +1,61 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuardsResolver = exports.MethodLogGuard = exports.ResolverLogGuard = void 0;
+const src_1 = require("../../src");
+class ResolverLogGuard {
+    canActivate(_context) {
+        console.log('[ResolverLogGuard] Resolver-level guard executed');
+        return true;
+    }
+}
+exports.ResolverLogGuard = ResolverLogGuard;
+class MethodLogGuard {
+    canActivate(_context) {
+        console.log('[MethodLogGuard] Method-level guard executed');
+        return true;
+    }
+}
+exports.MethodLogGuard = MethodLogGuard;
+let GuardsResolver = class GuardsResolver {
+    logPrompt() {
+        return {
+            messages: [
+                {
+                    role: 'assistant',
+                    content: { type: 'text', text: 'Prompt executed' },
+                },
+            ],
+        };
+    }
+    logTool() {
+        return { content: [{ type: 'text', text: 'Tool executed' }] };
+    }
+};
+exports.GuardsResolver = GuardsResolver;
+__decorate([
+    (0, src_1.Prompt)({ name: 'logPrompt' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], GuardsResolver.prototype, "logPrompt", null);
+__decorate([
+    (0, src_1.UseGuards)(MethodLogGuard),
+    (0, src_1.Tool)({ name: 'logTool' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], GuardsResolver.prototype, "logTool", null);
+exports.GuardsResolver = GuardsResolver = __decorate([
+    (0, src_1.UseGuards)(ResolverLogGuard),
+    (0, src_1.Resolver)('guards')
+], GuardsResolver);
+//# sourceMappingURL=guards.resolver.js.map

package/dist/examples/guards/guards.resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.resolver.js","sourceRoot":"","sources":["../../../examples/guards/guards.resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,mCAMmB;AAQnB,MAAa,gBAAgB;IAC3B,WAAW,CAAC,QAA6B;QACvC,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AALD,4CAKC;AAGD,MAAa,cAAc;IACzB,WAAW,CAAC,QAA6B;QACvC,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AALD,wCAKC;AAIM,IAAM,cAAc,GAApB,MAAM,cAAc;IAEzB,SAAS;QACP,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE;iBACnD;aACF;SACF,CAAC;IACJ,CAAC;IAID,OAAO;QACL,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAChE,CAAC;CACF,CAAA;AAlBY,wCAAc;AAEzB;IADC,IAAA,YAAM,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;;;;+CAU7B;AAID;IAFC,IAAA,eAAS,EAAC,cAAc,CAAC;IACzB,IAAA,UAAI,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;;;6CAGzB;yBAjBU,cAAc;IAF1B,IAAA,eAAS,EAAC,gBAAgB,CAAC;IAC3B,IAAA,cAAQ,EAAC,QAAQ,CAAC;GACN,cAAc,CAkB1B"}