nitrostack 1.0.0

package/dist/core/decorators.d.ts

@@ -0,0 +1,151 @@
+import 'reflect-metadata';
+import { z } from 'zod';
+/**
+ * Metadata keys for decorators
+ */
+export declare const TOOL_METADATA: unique symbol;
+export declare const WIDGET_METADATA: unique symbol;
+export declare const RESOURCE_METADATA: unique symbol;
+export declare const PROMPT_METADATA: unique symbol;
+export declare const GUARDS_METADATA: unique symbol;
+/**
+ * Tool decorator options
+ */
+export interface ToolOptions {
+    name: string;
+    description: string;
+    inputSchema: z.ZodSchema;
+    examples?: {
+        request?: any;
+        response?: any;
+    };
+    metadata?: {
+        category?: string;
+        tags?: string[];
+        rateLimit?: {
+            maxCalls: number;
+            windowMs: number;
+        };
+    };
+}
+/**
+ * Resource decorator options
+ */
+export interface ResourceOptions {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType?: string;
+    examples?: {
+        response?: any;
+    };
+    metadata?: {
+        cacheable?: boolean;
+        cacheMaxAge?: number;
+    };
+}
+/**
+ * Prompt decorator options
+ */
+export interface PromptOptions {
+    name: string;
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}
+/**
+ * Tool decorator - Marks a method as an MCP tool
+ *
+ * @example
+ * ```typescript
+ * @Tool({
+ *   name: 'login',
+ *   description: 'Login with email and password',
+ *   inputSchema: z.object({
+ *     email: z.string().email(),
+ *     password: z.string(),
+ *   }),
+ * })
+ * async login(input: any, context: ExecutionContext) {
+ *   // Implementation
+ * }
+ * ```
+ */
+export declare function Tool(options: ToolOptions): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Widget decorator - Links a tool to a Next.js widget route
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'login', ... })
+ * @Widget('login-result')
+ * async login(input: any, context: ExecutionContext) {
+ *   // Implementation
+ * }
+ * ```
+ */
+export declare function Widget(routePath: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Resource decorator - Marks a method as an MCP resource
+ *
+ * @example
+ * ```typescript
+ * @Resource({
+ *   uri: 'db://users/schema',
+ *   name: 'User Schema',
+ *   description: 'Database schema for users',
+ * })
+ * async getUserSchema(context: ExecutionContext) {
+ *   // Return schema
+ * }
+ * ```
+ */
+export declare function Resource(options: ResourceOptions): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Prompt decorator - Marks a method as an MCP prompt
+ *
+ * @example
+ * ```typescript
+ * @Prompt({
+ *   name: 'authentication-help',
+ *   description: 'Help with authentication',
+ * })
+ * async authHelp(args: any, context: ExecutionContext) {
+ *   // Return prompt messages
+ * }
+ * ```
+ */
+export declare function Prompt(options: PromptOptions): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Extract tool definitions from a decorated class
+ */
+export declare function extractTools(target: any): Array<{
+    methodName: string;
+    options: ToolOptions;
+}>;
+/**
+ * Extract resource definitions from a decorated class
+ */
+export declare function extractResources(target: any): Array<{
+    methodName: string;
+    options: ResourceOptions;
+}>;
+/**
+ * Extract prompt definitions from a decorated class
+ */
+export declare function extractPrompts(target: any): Array<{
+    methodName: string;
+    options: PromptOptions;
+}>;
+/**
+ * Get widget metadata for a specific method
+ */
+export declare function getWidgetMetadata(target: any, methodName: string): string | undefined;
+/**
+ * Get guards metadata for a specific method
+ */
+export declare function getGuardsMetadata(target: any, methodName: string): any[];
+//# sourceMappingURL=decorators.d.ts.map

package/dist/core/decorators.d.ts.map

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

package/dist/core/decorators.js

@@ -0,0 +1,142 @@
+import 'reflect-metadata';
+/**
+ * Metadata keys for decorators
+ */
+export const TOOL_METADATA = Symbol('tool:metadata');
+export const WIDGET_METADATA = Symbol('widget:metadata');
+export const RESOURCE_METADATA = Symbol('resource:metadata');
+export const PROMPT_METADATA = Symbol('prompt:metadata');
+export const GUARDS_METADATA = Symbol('guards:metadata');
+/**
+ * Tool decorator - Marks a method as an MCP tool
+ *
+ * @example
+ * ```typescript
+ * @Tool({
+ *   name: 'login',
+ *   description: 'Login with email and password',
+ *   inputSchema: z.object({
+ *     email: z.string().email(),
+ *     password: z.string(),
+ *   }),
+ * })
+ * async login(input: any, context: ExecutionContext) {
+ *   // Implementation
+ * }
+ * ```
+ */
+export function Tool(options) {
+    return function (target, propertyKey, descriptor) {
+        // Get existing tools or create new array
+        const existingTools = Reflect.getMetadata(TOOL_METADATA, target.constructor) || [];
+        // Add this tool
+        existingTools.push({
+            methodName: propertyKey,
+            options,
+        });
+        // Store metadata on the class constructor
+        Reflect.defineMetadata(TOOL_METADATA, existingTools, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * Widget decorator - Links a tool to a Next.js widget route
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'login', ... })
+ * @Widget('login-result')
+ * async login(input: any, context: ExecutionContext) {
+ *   // Implementation
+ * }
+ * ```
+ */
+export function Widget(routePath) {
+    return function (target, propertyKey, descriptor) {
+        // Store widget metadata
+        Reflect.defineMetadata(WIDGET_METADATA, routePath, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Resource decorator - Marks a method as an MCP resource
+ *
+ * @example
+ * ```typescript
+ * @Resource({
+ *   uri: 'db://users/schema',
+ *   name: 'User Schema',
+ *   description: 'Database schema for users',
+ * })
+ * async getUserSchema(context: ExecutionContext) {
+ *   // Return schema
+ * }
+ * ```
+ */
+export function Resource(options) {
+    return function (target, propertyKey, descriptor) {
+        const existingResources = Reflect.getMetadata(RESOURCE_METADATA, target.constructor) || [];
+        existingResources.push({
+            methodName: propertyKey,
+            options,
+        });
+        Reflect.defineMetadata(RESOURCE_METADATA, existingResources, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * Prompt decorator - Marks a method as an MCP prompt
+ *
+ * @example
+ * ```typescript
+ * @Prompt({
+ *   name: 'authentication-help',
+ *   description: 'Help with authentication',
+ * })
+ * async authHelp(args: any, context: ExecutionContext) {
+ *   // Return prompt messages
+ * }
+ * ```
+ */
+export function Prompt(options) {
+    return function (target, propertyKey, descriptor) {
+        const existingPrompts = Reflect.getMetadata(PROMPT_METADATA, target.constructor) || [];
+        existingPrompts.push({
+            methodName: propertyKey,
+            options,
+        });
+        Reflect.defineMetadata(PROMPT_METADATA, existingPrompts, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * Extract tool definitions from a decorated class
+ */
+export function extractTools(target) {
+    return Reflect.getMetadata(TOOL_METADATA, target) || [];
+}
+/**
+ * Extract resource definitions from a decorated class
+ */
+export function extractResources(target) {
+    return Reflect.getMetadata(RESOURCE_METADATA, target) || [];
+}
+/**
+ * Extract prompt definitions from a decorated class
+ */
+export function extractPrompts(target) {
+    return Reflect.getMetadata(PROMPT_METADATA, target) || [];
+}
+/**
+ * Get widget metadata for a specific method
+ */
+export function getWidgetMetadata(target, methodName) {
+    return Reflect.getMetadata(WIDGET_METADATA, target, methodName);
+}
+/**
+ * Get guards metadata for a specific method
+ */
+export function getGuardsMetadata(target, methodName) {
+    return Reflect.getMetadata(GUARDS_METADATA, target, methodName) || [];
+}
+//# sourceMappingURL=decorators.js.map

package/dist/core/decorators.js.map

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

package/dist/core/di/container.d.ts

@@ -0,0 +1,42 @@
+import 'reflect-metadata';
+/**
+ * Dependency Injection Container
+ *
+ * Simple DI container for managing service instances and dependencies.
+ * Supports constructor injection and singleton pattern.
+ */
+export declare class DIContainer {
+    private static instance;
+    private providers;
+    private instances;
+    private constructor();
+    /**
+     * Get the singleton container instance
+     */
+    static getInstance(): DIContainer;
+    /**
+     * Register a provider (class)
+     */
+    register(token: any, provider?: any): void;
+    /**
+     * Register a value directly
+     */
+    registerValue(token: any, value: any): void;
+    /**
+     * Resolve a dependency (get or create instance)
+     */
+    resolve<T>(token: any): T;
+    /**
+     * Get constructor dependencies from metadata
+     */
+    private getDependencies;
+    /**
+     * Clear all registrations (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Check if a token is registered
+     */
+    has(token: any): boolean;
+}
+//# sourceMappingURL=container.d.ts.map

package/dist/core/di/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../src/core/di/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,SAAS,CAA4B;IAE7C,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,WAAW;IAOjC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAI1C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAI3C;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;IAwBzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;CAGzB"}

package/dist/core/di/container.js

@@ -0,0 +1,76 @@
+import 'reflect-metadata';
+/**
+ * Dependency Injection Container
+ *
+ * Simple DI container for managing service instances and dependencies.
+ * Supports constructor injection and singleton pattern.
+ */
+export class DIContainer {
+    static instance;
+    providers = new Map();
+    instances = new Map();
+    constructor() { }
+    /**
+     * Get the singleton container instance
+     */
+    static getInstance() {
+        if (!DIContainer.instance) {
+            DIContainer.instance = new DIContainer();
+        }
+        return DIContainer.instance;
+    }
+    /**
+     * Register a provider (class)
+     */
+    register(token, provider) {
+        this.providers.set(token, provider || token);
+    }
+    /**
+     * Register a value directly
+     */
+    registerValue(token, value) {
+        this.instances.set(token, value);
+    }
+    /**
+     * Resolve a dependency (get or create instance)
+     */
+    resolve(token) {
+        // Check if already instantiated
+        if (this.instances.has(token)) {
+            return this.instances.get(token);
+        }
+        // Get the provider
+        const provider = this.providers.get(token) || token;
+        // Get constructor dependencies
+        const dependencies = this.getDependencies(provider);
+        // Resolve dependencies recursively
+        const resolvedDependencies = dependencies.map((dep) => this.resolve(dep));
+        // Create instance
+        const instance = new provider(...resolvedDependencies);
+        // Cache instance
+        this.instances.set(token, instance);
+        return instance;
+    }
+    /**
+     * Get constructor dependencies from metadata
+     */
+    getDependencies(target) {
+        // Get design:paramtypes metadata set by TypeScript
+        const params = Reflect.getMetadata('design:paramtypes', target) || [];
+        return params;
+    }
+    /**
+     * Clear all registrations (useful for testing)
+     */
+    clear() {
+        this.providers.clear();
+        this.instances.clear();
+    }
+    /**
+     * Check if a token is registered
+     */
+    has(token) {
+        return this.providers.has(token) || this.instances.has(token);
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/core/di/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../../src/core/di/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAC,QAAQ,CAAc;IAC7B,SAAS,GAAkB,IAAI,GAAG,EAAE,CAAC;IACrC,SAAS,GAAkB,IAAI,GAAG,EAAE,CAAC;IAE7C,gBAAuB,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC1B,WAAW,CAAC,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAU,EAAE,QAAc;QACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,IAAI,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAU,EAAE,KAAU;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,OAAO,CAAI,KAAU;QACnB,gCAAgC;QAChC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,mBAAmB;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;QAEpD,+BAA+B;QAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAEpD,mCAAmC;QACnC,MAAM,oBAAoB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAE/E,kBAAkB;QAClB,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,GAAG,oBAAoB,CAAC,CAAC;QAEvD,iBAAiB;QACjB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,MAAW;QACjC,mDAAmD;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACtE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/core/di/injectable.decorator.d.ts

@@ -0,0 +1,35 @@
+import 'reflect-metadata';
+/**
+ * Marks a class as injectable (can be used with DI)
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class UserService {
+ *   constructor(private db: DatabaseService) {}
+ *
+ *   async findUser(id: string) {
+ *     return this.db.query('SELECT * FROM users WHERE id = ?', [id]);
+ *   }
+ * }
+ * ```
+ */
+export declare function Injectable(): ClassDecorator;
+/**
+ * Inject a specific token (optional - for custom injection)
+ *
+ * @example
+ * ```typescript
+ * constructor(@Inject('DATABASE_CONFIG') private config: DatabaseConfig) {}
+ * ```
+ */
+export declare function Inject(token: any): ParameterDecorator;
+/**
+ * Check if a class is injectable
+ */
+export declare function isInjectable(target: any): boolean;
+/**
+ * Get inject tokens for constructor parameters
+ */
+export declare function getInjectTokens(target: any): any[];
+//# sourceMappingURL=injectable.decorator.d.ts.map

package/dist/core/di/injectable.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/di/injectable.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAM1B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAU3C;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,kBAAkB,CAMrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,EAAE,CAElD"}

package/dist/core/di/injectable.decorator.js

@@ -0,0 +1,57 @@
+import 'reflect-metadata';
+import { DIContainer } from './container.js';
+const INJECTABLE_KEY = 'nitrostack:injectable';
+const INJECT_KEY = 'nitrostack:inject';
+/**
+ * Marks a class as injectable (can be used with DI)
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class UserService {
+ *   constructor(private db: DatabaseService) {}
+ *
+ *   async findUser(id: string) {
+ *     return this.db.query('SELECT * FROM users WHERE id = ?', [id]);
+ *   }
+ * }
+ * ```
+ */
+export function Injectable() {
+    return (target) => {
+        Reflect.defineMetadata(INJECTABLE_KEY, true, target);
+        // Auto-register in DI container
+        const container = DIContainer.getInstance();
+        if (!container.has(target)) {
+            container.register(target);
+        }
+    };
+}
+/**
+ * Inject a specific token (optional - for custom injection)
+ *
+ * @example
+ * ```typescript
+ * constructor(@Inject('DATABASE_CONFIG') private config: DatabaseConfig) {}
+ * ```
+ */
+export function Inject(token) {
+    return (target, propertyKey, parameterIndex) => {
+        const existingTokens = Reflect.getMetadata(INJECT_KEY, target) || [];
+        existingTokens[parameterIndex] = token;
+        Reflect.defineMetadata(INJECT_KEY, existingTokens, target);
+    };
+}
+/**
+ * Check if a class is injectable
+ */
+export function isInjectable(target) {
+    return Reflect.getMetadata(INJECTABLE_KEY, target) === true;
+}
+/**
+ * Get inject tokens for constructor parameters
+ */
+export function getInjectTokens(target) {
+    return Reflect.getMetadata(INJECT_KEY, target) || [];
+}
+//# sourceMappingURL=injectable.decorator.js.map

package/dist/core/di/injectable.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable.decorator.js","sourceRoot":"","sources":["../../../src/core/di/injectable.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAC/C,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAErD,gCAAgC;QAChC,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,KAAU;IAC/B,OAAO,CAAC,MAAW,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QACvF,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACrE,cAAc,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC;QACvC,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAW;IACtC,OAAO,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAW;IACzC,OAAO,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACvD,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Base error class for MCP server errors
+ */
+export declare class McpError extends Error {
+    code: string;
+    statusCode: number;
+    details?: any | undefined;
+    constructor(message: string, code: string, statusCode?: number, details?: any | undefined);
+}
+/**
+ * Validation error
+ */
+export declare class ValidationError extends McpError {
+    constructor(message: string, details?: any);
+}
+/**
+ * Tool not found error
+ */
+export declare class ToolNotFoundError extends McpError {
+    constructor(toolName: string);
+}
+/**
+ * Resource not found error
+ */
+export declare class ResourceNotFoundError extends McpError {
+    constructor(uri: string);
+}
+/**
+ * Prompt not found error
+ */
+export declare class PromptNotFoundError extends McpError {
+    constructor(promptName: string);
+}
+/**
+ * Rate limit error
+ */
+export declare class RateLimitError extends McpError {
+    constructor(message?: string);
+}
+/**
+ * Tool execution error
+ */
+export declare class ToolExecutionError extends McpError {
+    constructor(toolName: string, originalError: Error);
+}
+/**
+ * Format error for response
+ */
+export declare function formatError(error: Error): {
+    code: string;
+    message: string;
+    details?: any;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAGxB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,MAAM;IAClB,OAAO,CAAC,EAAE,GAAG;gBAHpB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY,EACxB,OAAO,CAAC,EAAE,GAAG,YAAA;CAMvB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,QAAQ,EAAE,MAAM;CAI7B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,GAAG,EAAE,MAAM;CAIxB;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,UAAU,EAAE,MAAM;CAI/B;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,GAAE,MAA8B;CAIpD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK;CASnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,GAAG,CAAC;CACf,CAaA"}

package/dist/core/errors.js

@@ -0,0 +1,87 @@
+/**
+ * Base error class for MCP server errors
+ */
+export class McpError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(message, code, statusCode = 500, details) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'McpError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Validation error
+ */
+export class ValidationError extends McpError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', 400, details);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Tool not found error
+ */
+export class ToolNotFoundError extends McpError {
+    constructor(toolName) {
+        super(`Tool '${toolName}' not found`, 'TOOL_NOT_FOUND', 404);
+        this.name = 'ToolNotFoundError';
+    }
+}
+/**
+ * Resource not found error
+ */
+export class ResourceNotFoundError extends McpError {
+    constructor(uri) {
+        super(`Resource '${uri}' not found`, 'RESOURCE_NOT_FOUND', 404);
+        this.name = 'ResourceNotFoundError';
+    }
+}
+/**
+ * Prompt not found error
+ */
+export class PromptNotFoundError extends McpError {
+    constructor(promptName) {
+        super(`Prompt '${promptName}' not found`, 'PROMPT_NOT_FOUND', 404);
+        this.name = 'PromptNotFoundError';
+    }
+}
+/**
+ * Rate limit error
+ */
+export class RateLimitError extends McpError {
+    constructor(message = 'Rate limit exceeded') {
+        super(message, 'RATE_LIMIT_EXCEEDED', 429);
+        this.name = 'RateLimitError';
+    }
+}
+/**
+ * Tool execution error
+ */
+export class ToolExecutionError extends McpError {
+    constructor(toolName, originalError) {
+        super(`Error executing tool '${toolName}': ${originalError.message}`, 'TOOL_EXECUTION_ERROR', 500, { originalError: originalError.message, stack: originalError.stack });
+        this.name = 'ToolExecutionError';
+    }
+}
+/**
+ * Format error for response
+ */
+export function formatError(error) {
+    if (error instanceof McpError) {
+        return {
+            code: error.code,
+            message: error.message,
+            details: error.details,
+        };
+    }
+    return {
+        code: 'INTERNAL_ERROR',
+        message: error.message,
+    };
+}
+//# sourceMappingURL=errors.js.map