nitrostack 1.0.0

package/dist/core/pipes/pipe.decorator.js

@@ -0,0 +1,85 @@
+import 'reflect-metadata';
+const PIPE_KEY = 'nitrostack:pipe';
+const IS_PIPE_KEY = 'nitrostack:is_pipe';
+const PARAM_PIPES_KEY = 'nitrostack:param_pipes';
+/**
+ * Marks a class as a pipe
+ *
+ * @example
+ * ```typescript
+ * @Pipe()
+ * export class ValidationPipe implements PipeInterface {
+ *   transform(value: any, metadata: ArgumentMetadata) {
+ *     // Validate and transform
+ *     return value;
+ *   }
+ * }
+ * ```
+ */
+export function Pipe() {
+    return (target) => {
+        Reflect.defineMetadata(IS_PIPE_KEY, true, target);
+    };
+}
+/**
+ * Apply pipes to tool input (entire input object)
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'create_user', ... })
+ * @UsePipes(ValidationPipe, TransformPipe)
+ * async createUser(input: any) { }
+ * ```
+ */
+export function UsePipes(...pipes) {
+    return (target, propertyKey, descriptor) => {
+        const existingPipes = Reflect.getMetadata(PIPE_KEY, target, propertyKey) || [];
+        Reflect.defineMetadata(PIPE_KEY, [...existingPipes, ...pipes], target, propertyKey);
+    };
+}
+/**
+ * Parameter decorator to apply pipes to specific parameters
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'create_user', ... })
+ * async createUser(@Body(ValidationPipe) input: CreateUserDto) { }
+ * ```
+ */
+export function Body(...pipes) {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey)
+            return;
+        const existingParams = Reflect.getMetadata(PARAM_PIPES_KEY, target, propertyKey) || {};
+        existingParams[parameterIndex] = {
+            type: 'body',
+            pipes,
+        };
+        Reflect.defineMetadata(PARAM_PIPES_KEY, existingParams, target, propertyKey);
+    };
+}
+/**
+ * Shorthand for validation pipe
+ */
+export function Validated() {
+    return Body(); // Can be enhanced with default validation pipe
+}
+/**
+ * Get pipes for a method
+ */
+export function getPipeMetadata(target, propertyKey) {
+    return Reflect.getMetadata(PIPE_KEY, target, propertyKey) || [];
+}
+/**
+ * Get parameter pipes for a method
+ */
+export function getParamPipesMetadata(target, propertyKey) {
+    return Reflect.getMetadata(PARAM_PIPES_KEY, target, propertyKey) || {};
+}
+/**
+ * Check if a class is marked as a pipe
+ */
+export function isPipe(target) {
+    return Reflect.getMetadata(IS_PIPE_KEY, target) === true;
+}
+//# sourceMappingURL=pipe.decorator.js.map

package/dist/core/pipes/pipe.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.decorator.js","sourceRoot":"","sources":["../../../src/core/pipes/pipe.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AACnC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AACzC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,IAAI;IAClB,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAG,KAAwB;IAClD,OAAO,CAAC,MAAW,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACnF,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAC/E,OAAO,CAAC,cAAc,CACpB,QAAQ,EACR,CAAC,GAAG,aAAa,EAAE,GAAG,KAAK,CAAC,EAC5B,MAAM,EACN,WAAW,CACZ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CAAC,GAAG,KAAwB;IAC9C,OAAO,CAAC,MAAW,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QACvF,IAAI,CAAC,WAAW;YAAE,OAAO;QAEzB,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QACvF,cAAc,CAAC,cAAc,CAAC,GAAG;YAC/B,IAAI,EAAE,MAAM;YACZ,KAAK;SACN,CAAC;QACF,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/E,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,EAAE,CAAC,CAAC,+CAA+C;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAW,EAAE,WAA4B;IACvE,OAAO,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAW,EAAE,WAA4B;IAC7E,OAAO,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,MAAW;IAChC,OAAO,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAC3D,CAAC"}

package/dist/core/pipes/pipe.interface.d.ts

@@ -0,0 +1,36 @@
+import 'reflect-metadata';
+/**
+ * Argument metadata for pipe transformation
+ */
+export interface ArgumentMetadata {
+    type: 'body' | 'param' | 'query' | 'custom';
+    metatype?: any;
+    data?: string | undefined;
+}
+/**
+ * Pipe Interface
+ *
+ * Pipes are used to transform and validate input data before it reaches the tool handler.
+ * Similar to NestJS pipes.
+ *
+ * @example
+ * ```typescript
+ * @Pipe()
+ * export class ValidationPipe implements PipeInterface {
+ *   transform(value: any, metadata: ArgumentMetadata) {
+ *     if (!this.isValid(value)) {
+ *       throw new Error('Validation failed');
+ *     }
+ *     return value;
+ *   }
+ * }
+ * ```
+ */
+export interface PipeInterface<T = any, R = any> {
+    transform(value: T, metadata: ArgumentMetadata): R | Promise<R>;
+}
+/**
+ * Pipe constructor type
+ */
+export type PipeConstructor = new (...args: any[]) => PipeInterface;
+//# sourceMappingURL=pipe.interface.d.ts.map

package/dist/core/pipes/pipe.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.interface.d.ts","sourceRoot":"","sources":["../../../src/core/pipes/pipe.interface.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG;IAC7C,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,gBAAgB,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,aAAa,CAAC"}

package/dist/core/pipes/pipe.interface.js

@@ -0,0 +1,2 @@
+import 'reflect-metadata';
+//# sourceMappingURL=pipe.interface.js.map

package/dist/core/pipes/pipe.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.interface.js","sourceRoot":"","sources":["../../../src/core/pipes/pipe.interface.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC"}

package/dist/core/prompt.d.ts

@@ -0,0 +1,37 @@
+import { PromptDefinition, ExecutionContext, PromptMessage } from './types.js';
+/**
+ * Prompt class provides a clean abstraction for defining and executing prompts
+ */
+export declare class Prompt {
+    private definition;
+    constructor(definition: PromptDefinition);
+    /**
+     * Get prompt name
+     */
+    get name(): string;
+    /**
+     * Get prompt description
+     */
+    get description(): string;
+    /**
+     * Get prompt arguments
+     */
+    get arguments(): any[];
+    /**
+     * Execute the prompt with provided arguments
+     */
+    execute(args: Record<string, any>, context: ExecutionContext): Promise<PromptMessage[]>;
+    /**
+     * Validate prompt arguments
+     */
+    private validateArguments;
+    /**
+     * Create prompt metadata for MCP protocol
+     */
+    toMcpPrompt(): any;
+}
+/**
+ * Helper function to create a prompt
+ */
+export declare function createPrompt(definition: PromptDefinition): Prompt;
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/core/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG/E;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,UAAU,CAAmB;gBAEzB,UAAU,EAAE,gBAAgB;IAIxC;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,GAAG,EAAE,CAErB;IAED;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAoB7F;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,WAAW,IAAI,GAAG;CAOnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAEjE"}

package/dist/core/prompt.js

@@ -0,0 +1,76 @@
+import { ValidationError } from './errors.js';
+/**
+ * Prompt class provides a clean abstraction for defining and executing prompts
+ */
+export class Prompt {
+    definition;
+    constructor(definition) {
+        this.definition = definition;
+    }
+    /**
+     * Get prompt name
+     */
+    get name() {
+        return this.definition.name;
+    }
+    /**
+     * Get prompt description
+     */
+    get description() {
+        return this.definition.description;
+    }
+    /**
+     * Get prompt arguments
+     */
+    get arguments() {
+        return this.definition.arguments || [];
+    }
+    /**
+     * Execute the prompt with provided arguments
+     */
+    async execute(args, context) {
+        // Validate required arguments
+        this.validateArguments(args);
+        context.logger.info(`Executing prompt: ${this.name}`, { args });
+        try {
+            const messages = await this.definition.handler(args, context);
+            context.logger.info(`Prompt executed successfully: ${this.name}`, {
+                messageCount: messages.length,
+            });
+            return messages;
+        }
+        catch (error) {
+            context.logger.error(`Error executing prompt: ${this.name}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Validate prompt arguments
+     */
+    validateArguments(args) {
+        if (!this.definition.arguments)
+            return;
+        for (const arg of this.definition.arguments) {
+            if (arg.required && !(arg.name in args)) {
+                throw new ValidationError(`Missing required argument '${arg.name}' for prompt '${this.name}'`);
+            }
+        }
+    }
+    /**
+     * Create prompt metadata for MCP protocol
+     */
+    toMcpPrompt() {
+        return {
+            name: this.name,
+            description: this.description,
+            arguments: this.arguments,
+        };
+    }
+}
+/**
+ * Helper function to create a prompt
+ */
+export function createPrompt(definition) {
+    return new Prompt(definition);
+}
+//# sourceMappingURL=prompt.js.map

package/dist/core/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/core/prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,OAAO,MAAM;IACT,UAAU,CAAmB;IAErC,YAAY,UAA4B;QACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,EAAE,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAAyB,EAAE,OAAyB;QAChE,8BAA8B;QAC9B,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE7B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAE9D,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,IAAI,CAAC,IAAI,EAAE,EAAE;gBAChE,YAAY,EAAE,QAAQ,CAAC,MAAM;aAC9B,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YACpE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,IAAyB;QACjD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS;YAAE,OAAO;QAEvC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YAC5C,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,eAAe,CACvB,8BAA8B,GAAG,CAAC,IAAI,iBAAiB,IAAI,CAAC,IAAI,GAAG,CACpE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAA4B;IACvD,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC"}

package/dist/core/resource.d.ts

@@ -0,0 +1,42 @@
+import { ResourceDefinition, ExecutionContext, ResourceContent } from './types.js';
+/**
+ * Resource class provides a clean abstraction for defining and serving resources
+ */
+export declare class Resource {
+    private definition;
+    private cache?;
+    constructor(definition: ResourceDefinition);
+    /**
+     * Get resource URI
+     */
+    get uri(): string;
+    /**
+     * Get resource name
+     */
+    get name(): string;
+    /**
+     * Get resource description
+     */
+    get description(): string;
+    /**
+     * Get resource MIME type
+     */
+    get mimeType(): string | undefined;
+    /**
+     * Fetch the resource content
+     */
+    fetch(context: ExecutionContext): Promise<ResourceContent>;
+    /**
+     * Clear cached content
+     */
+    clearCache(): void;
+    /**
+     * Create resource metadata for MCP protocol
+     */
+    toMcpResource(): any;
+}
+/**
+ * Helper function to create a resource
+ */
+export declare function createResource(definition: ResourceDefinition): Resource;
+//# sourceMappingURL=resource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/core/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnF;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,KAAK,CAAC,CAGZ;gBAEU,UAAU,EAAE,kBAAkB;IAI1C;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkChE;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,IAAI,GAAG;CAQrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,kBAAkB,GAAG,QAAQ,CAEvE"}

package/dist/core/resource.js

@@ -0,0 +1,90 @@
+/**
+ * Resource class provides a clean abstraction for defining and serving resources
+ */
+export class Resource {
+    definition;
+    cache;
+    constructor(definition) {
+        this.definition = definition;
+    }
+    /**
+     * Get resource URI
+     */
+    get uri() {
+        return this.definition.uri;
+    }
+    /**
+     * Get resource name
+     */
+    get name() {
+        return this.definition.name;
+    }
+    /**
+     * Get resource description
+     */
+    get description() {
+        return this.definition.description;
+    }
+    /**
+     * Get resource MIME type
+     */
+    get mimeType() {
+        return this.definition.mimeType;
+    }
+    /**
+     * Fetch the resource content
+     */
+    async fetch(context) {
+        const cacheable = this.definition.metadata?.cacheable;
+        const cacheMaxAge = this.definition.metadata?.cacheMaxAge || 60000; // 1 minute default
+        // Check cache
+        if (cacheable && this.cache) {
+            const age = Date.now() - this.cache.timestamp;
+            if (age < cacheMaxAge) {
+                context.logger.debug(`Serving cached resource: ${this.uri}`);
+                return this.cache.content;
+            }
+        }
+        context.logger.info(`Fetching resource: ${this.uri}`);
+        try {
+            const content = await this.definition.handler(context);
+            // Update cache
+            if (cacheable) {
+                this.cache = {
+                    content,
+                    timestamp: Date.now(),
+                };
+            }
+            context.logger.info(`Resource fetched successfully: ${this.uri}`);
+            return content;
+        }
+        catch (error) {
+            context.logger.error(`Error fetching resource: ${this.uri}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Clear cached content
+     */
+    clearCache() {
+        this.cache = undefined;
+    }
+    /**
+     * Create resource metadata for MCP protocol
+     */
+    toMcpResource() {
+        return {
+            uri: this.uri,
+            name: this.name,
+            description: this.description,
+            mimeType: this.mimeType,
+        };
+    }
+}
+/**
+ * Helper function to create a resource
+ */
+export function createResource(definition) {
+    return new Resource(definition);
+}
+//# sourceMappingURL=resource.js.map

package/dist/core/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/core/resource.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,QAAQ;IACX,UAAU,CAAqB;IAC/B,KAAK,CAGX;IAEF,YAAY,UAA8B;QACxC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,OAAyB;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,WAAW,IAAI,KAAK,CAAC,CAAC,mBAAmB;QAEvF,cAAc;QACd,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;YAC9C,IAAI,GAAG,GAAG,WAAW,EAAE,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAEtD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAEvD,eAAe;YACf,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,GAAG;oBACX,OAAO;oBACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAClE,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;YACpE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAA8B;IAC3D,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;AAClC,CAAC"}

package/dist/core/server.d.ts

@@ -0,0 +1,72 @@
+import { Tool } from './tool.js';
+import { Resource } from './resource.js';
+import { Prompt } from './prompt.js';
+import { McpServerConfig, ServerStats } from './types.js';
+/**
+ * NitroStackServer - Main server class
+ */
+export declare class NitroStackServer {
+    private mcpServer;
+    private tools;
+    private resources;
+    private prompts;
+    private config;
+    private logger;
+    private stats;
+    private pendingComponentRegistrations;
+    constructor(config: McpServerConfig);
+    /**
+     * Add a tool to the server
+     */
+    tool(tool: Tool): this;
+    /**
+     * Register a component as an MCP resource
+     */
+    private registerComponentResource;
+    /**
+     * Add a resource to the server
+     */
+    resource(resource: Resource): this;
+    /**
+     * Add a prompt to the server
+     */
+    prompt(prompt: Prompt): this;
+    /**
+     * Register a module with all its controllers
+     * Automatically extracts and registers all tools, resources, and prompts
+     *
+     * @example
+     * ```typescript
+     * server.module(AuthModule);
+     * server.module(ProductsModule);
+     * ```
+     */
+    module(moduleClass: any): this;
+    /**
+     * Get server statistics
+     */
+    getStats(): ServerStats;
+    /**
+     * Create execution context
+     */
+    private createContext;
+    /**
+     * Setup MCP protocol handlers
+     */
+    private setupHandlers;
+    /**
+     * Start the server with specified transport
+     * @param transportType - 'stdio', 'http', or 'dual' (default: 'stdio')
+     * @param transportOptions - Transport-specific options
+     */
+    start(transportType?: 'stdio' | 'http' | 'dual', transportOptions?: any): Promise<void>;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+}
+/**
+ * Helper function to create a server
+ */
+export declare function createServer(config: McpServerConfig): NitroStackServer;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAkB,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACL,eAAe,EAGf,WAAW,EACZ,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,6BAA6B,CAAuB;gBAEhD,MAAM,EAAE,eAAe;IA0BnC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAkBtB;;OAEG;YACW,yBAAyB;IA6BvC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAMlC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM5B;;;;;;;;;OASG;IACH,MAAM,CAAC,WAAW,EAAE,GAAG,GAAG,IAAI;IA+C9B;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAyLrB;;;;OAIG;IACG,KAAK,CAAC,aAAa,GAAE,OAAO,GAAG,MAAM,GAAG,MAAgB,EAAE,gBAAgB,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDtG;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiB5B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAEtE"}