@nitrostack/core 1.0.0

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,EAAkB,MAAM,gBAAgB,CAAC;AAG7D,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAC/C,MAAM,UAAU,GAAG,mBAAmB,CAAC;AACvC,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AAwBnC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU,CAAC,OAA2B;IACpD,OAAO,CAAC,MAAc,EAAE,EAAE;QACxB,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAErD,0DAA0D;QAC1D,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;QAED,gCAAgC;QAChC,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAA0B,CAAC,EAAE,CAAC;YAC/C,SAAS,CAAC,QAAQ,CAAC,MAA0B,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,KAAqB;IAC1C,OAAO,CAAC,MAAc,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QAC1F,MAAM,cAAc,GAAqB,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACvF,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,MAAwB;IACnD,OAAO,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,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?: unknown | undefined;
+    constructor(message: string, code: string, statusCode?: number, details?: unknown | undefined);
+}
+/**
+ * Validation error
+ */
+export declare class ValidationError extends McpError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * 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?: unknown;
+};
+//# 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,OAAO;gBAHxB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY,EACxB,OAAO,CAAC,EAAE,OAAO,YAAA;CAM3B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;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,OAAO,CAAC;CACnB,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

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGxB;IACA;IACA;IAJT,YACE,OAAe,EACR,IAAY,EACZ,aAAqB,GAAG,EACxB,OAAiB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAc;QACxB,YAAO,GAAP,OAAO,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,QAAgB;QAC1B,KAAK,CAAC,SAAS,QAAQ,aAAa,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,GAAW;QACrB,KAAK,CAAC,aAAa,GAAG,aAAa,EAAE,oBAAoB,EAAE,GAAG,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,UAAkB;QAC5B,KAAK,CAAC,WAAW,UAAU,aAAa,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,YAAY,UAAkB,qBAAqB;QACjD,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,QAAgB,EAAE,aAAoB;QAChD,KAAK,CACH,yBAAyB,QAAQ,MAAM,aAAa,CAAC,OAAO,EAAE,EAC9D,sBAAsB,EACtB,GAAG,EACH,EAAE,aAAa,EAAE,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,CACrE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IAKtC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC"}

package/dist/core/events/event-emitter.d.ts

@@ -0,0 +1,50 @@
+import 'reflect-metadata';
+/**
+ * Event handler type
+ */
+type EventHandler = (...args: unknown[]) => void | Promise<void>;
+/**
+ * Event Emitter
+ *
+ * Simple event bus for decoupled communication between modules
+ */
+export declare class EventEmitter {
+    private static instance;
+    private listeners;
+    private constructor();
+    static getInstance(): EventEmitter;
+    /**
+     * Register an event listener
+     */
+    on(event: string, handler: EventHandler): void;
+    /**
+     * Register a one-time event listener
+     */
+    once(event: string, handler: EventHandler): void;
+    /**
+     * Remove an event listener
+     */
+    off(event: string, handler: EventHandler): void;
+    /**
+     * Emit an event
+     */
+    emit(event: string, ...args: unknown[]): Promise<void>;
+    /**
+     * Emit an event synchronously
+     */
+    emitSync(event: string, ...args: unknown[]): void;
+    /**
+     * Remove all listeners for an event
+     */
+    removeAllListeners(event?: string): void;
+    /**
+     * Get listener count for an event
+     */
+    listenerCount(event: string): number;
+    /**
+     * Get all event names
+     */
+    eventNames(): string[];
+}
+export {};
+//# sourceMappingURL=event-emitter.d.ts.map

package/dist/core/events/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../../src/core/events/event-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B;;GAEG;AACH,KAAK,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjE;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,SAAS,CAA0C;IAE3D,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAO9C;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAQhD;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAc/C;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAOjD;;OAEG;IACH,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIpC;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;CAGvB"}

package/dist/core/events/event-emitter.js

@@ -0,0 +1,94 @@
+import 'reflect-metadata';
+/**
+ * Event Emitter
+ *
+ * Simple event bus for decoupled communication between modules
+ */
+export class EventEmitter {
+    static instance;
+    listeners = new Map();
+    constructor() { }
+    static getInstance() {
+        if (!EventEmitter.instance) {
+            EventEmitter.instance = new EventEmitter();
+        }
+        return EventEmitter.instance;
+    }
+    /**
+     * Register an event listener
+     */
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, []);
+        }
+        this.listeners.get(event).push(handler);
+    }
+    /**
+     * Register a one-time event listener
+     */
+    once(event, handler) {
+        const wrappedHandler = async (...args) => {
+            await handler(...args);
+            this.off(event, wrappedHandler);
+        };
+        this.on(event, wrappedHandler);
+    }
+    /**
+     * Remove an event listener
+     */
+    off(event, handler) {
+        const handlers = this.listeners.get(event);
+        if (!handlers)
+            return;
+        const index = handlers.indexOf(handler);
+        if (index > -1) {
+            handlers.splice(index, 1);
+        }
+        if (handlers.length === 0) {
+            this.listeners.delete(event);
+        }
+    }
+    /**
+     * Emit an event
+     */
+    async emit(event, ...args) {
+        const handlers = this.listeners.get(event);
+        if (!handlers || handlers.length === 0)
+            return;
+        // Execute all handlers in parallel
+        await Promise.all(handlers.map(handler => handler(...args)));
+    }
+    /**
+     * Emit an event synchronously
+     */
+    emitSync(event, ...args) {
+        const handlers = this.listeners.get(event);
+        if (!handlers || handlers.length === 0)
+            return;
+        handlers.forEach(handler => handler(...args));
+    }
+    /**
+     * Remove all listeners for an event
+     */
+    removeAllListeners(event) {
+        if (event) {
+            this.listeners.delete(event);
+        }
+        else {
+            this.listeners.clear();
+        }
+    }
+    /**
+     * Get listener count for an event
+     */
+    listenerCount(event) {
+        return this.listeners.get(event)?.length || 0;
+    }
+    /**
+     * Get all event names
+     */
+    eventNames() {
+        return Array.from(this.listeners.keys());
+    }
+}
+//# sourceMappingURL=event-emitter.js.map

package/dist/core/events/event-emitter.js.map

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

package/dist/core/events/event.decorator.d.ts

@@ -0,0 +1,48 @@
+import 'reflect-metadata';
+/**
+ * Event handler metadata
+ */
+interface EventHandlerMetadata {
+    event: string;
+    methodName: string;
+}
+/**
+ * Marks a method as an event handler
+ *
+ * @example
+ * ```typescript
+ * export class OrderTools {
+ *   @Tool({ name: 'create_order', ... })
+ *   async createOrder(input: Record<string, unknown>, ctx: ExecutionContext) {
+ *     const order = await this.saveOrder(input);
+ *
+ *     // Emit event
+ *     ctx.emit('order.created', order);
+ *
+ *     return order;
+ *   }
+ * }
+ *
+ * export class NotificationService {
+ *   @OnEvent('order.created')
+ *   async handleOrderCreated(order: unknown) {
+ *     await this.sendConfirmationEmail(order);
+ *   }
+ * }
+ * ```
+ */
+export declare function OnEvent(event: string): MethodDecorator;
+/**
+ * Get event handlers from a class
+ */
+export declare function getEventHandlers(target: object): EventHandlerMetadata[];
+/**
+ * Register all event handlers from a class instance
+ */
+export declare function registerEventHandlers(instance: object & Record<string, unknown>): void;
+/**
+ * Emit an event from execution context
+ */
+export declare function emitEvent(event: string, ...args: unknown[]): void;
+export {};
+//# sourceMappingURL=event.decorator.d.ts.map

package/dist/core/events/event.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/events/event.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAK1B;;GAEG;AACH,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAUtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWtF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CASjE"}

package/dist/core/events/event.decorator.js

@@ -0,0 +1,72 @@
+import 'reflect-metadata';
+import { EventEmitter } from './event-emitter.js';
+const EVENT_HANDLER_KEY = 'nitrostack:event_handler';
+/**
+ * Marks a method as an event handler
+ *
+ * @example
+ * ```typescript
+ * export class OrderTools {
+ *   @Tool({ name: 'create_order', ... })
+ *   async createOrder(input: Record<string, unknown>, ctx: ExecutionContext) {
+ *     const order = await this.saveOrder(input);
+ *
+ *     // Emit event
+ *     ctx.emit('order.created', order);
+ *
+ *     return order;
+ *   }
+ * }
+ *
+ * export class NotificationService {
+ *   @OnEvent('order.created')
+ *   async handleOrderCreated(order: unknown) {
+ *     await this.sendConfirmationEmail(order);
+ *   }
+ * }
+ * ```
+ */
+export function OnEvent(event) {
+    return (target, propertyKey, descriptor) => {
+        const targetWithConstructor = target;
+        const existingHandlers = Reflect.getMetadata(EVENT_HANDLER_KEY, targetWithConstructor.constructor) || [];
+        existingHandlers.push({
+            event,
+            methodName: propertyKey,
+        });
+        Reflect.defineMetadata(EVENT_HANDLER_KEY, existingHandlers, targetWithConstructor.constructor);
+    };
+}
+/**
+ * Get event handlers from a class
+ */
+export function getEventHandlers(target) {
+    return Reflect.getMetadata(EVENT_HANDLER_KEY, target) || [];
+}
+/**
+ * Register all event handlers from a class instance
+ */
+export function registerEventHandlers(instance) {
+    const emitter = EventEmitter.getInstance();
+    const handlers = getEventHandlers(instance.constructor);
+    for (const { event, methodName } of handlers) {
+        const method = instance[String(methodName)];
+        if (typeof method === 'function') {
+            const handler = method.bind(instance);
+            emitter.on(event, handler);
+        }
+    }
+}
+/**
+ * Emit an event from execution context
+ */
+export function emitEvent(event, ...args) {
+    const emitter = EventEmitter.getInstance();
+    // Use sync emit to avoid blocking
+    emitter.emitSync(event, ...args);
+    // Also emit async in background
+    emitter.emit(event, ...args).catch(error => {
+        console.error(`Error in event handler for ${event}:`, error);
+    });
+}
+//# sourceMappingURL=event.decorator.js.map

package/dist/core/events/event.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.decorator.js","sourceRoot":"","sources":["../../../src/core/events/event.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAUrD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,MAAM,qBAAqB,GAAG,MAAiC,CAAC;QAChE,MAAM,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACzG,gBAAgB,CAAC,IAAI,CAAC;YACpB,KAAK;YACL,UAAU,EAAE,WAAW;SACxB,CAAC,CAAC;QACH,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACjG,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA0C;IAC9E,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,gBAAgB,CAAE,QAAoC,CAAC,WAAW,CAAC,CAAC;IAErF,KAAK,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QAC5C,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,GAAG,IAAe;IACzD,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAC3C,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IAEjC,gCAAgC;IAChC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACzC,OAAO,CAAC,KAAK,CAAC,8BAA8B,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/events/log-emitter.d.ts

@@ -0,0 +1,14 @@
+import { EventEmitter } from 'events';
+import Transport from 'winston-transport';
+export declare const logEmitter: EventEmitter<[never]>;
+interface LogInfo {
+    level: string;
+    message: string;
+    [key: string]: unknown;
+}
+export declare class EventEmitterTransport extends Transport {
+    constructor(opts?: Transport.TransportStreamOptions);
+    log(info: LogInfo, callback: () => void): void;
+}
+export {};
+//# sourceMappingURL=log-emitter.d.ts.map

package/dist/core/events/log-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-emitter.d.ts","sourceRoot":"","sources":["../../../src/core/events/log-emitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,eAAO,MAAM,UAAU,uBAAqB,CAAC;AAE7C,UAAU,OAAO;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAGD,qBAAa,qBAAsB,SAAQ,SAAS;gBACtC,IAAI,CAAC,EAAE,SAAS,CAAC,sBAAsB;IAInD,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI;CAUxC"}

package/dist/core/events/log-emitter.js

@@ -0,0 +1,20 @@
+import { EventEmitter } from 'events';
+import Transport from 'winston-transport';
+// Create a new event emitter
+export const logEmitter = new EventEmitter();
+// Define a custom winston transport
+export class EventEmitterTransport extends Transport {
+    constructor(opts) {
+        super(opts);
+    }
+    log(info, callback) {
+        setImmediate(() => {
+            logEmitter.emit('log', info);
+            // Also write to stderr for the dev wrapper to capture
+            process.stderr.write(`NITRO_LOG::${JSON.stringify(info)}\n`);
+        });
+        // Perform the callback
+        callback();
+    }
+}
+//# sourceMappingURL=log-emitter.js.map

package/dist/core/events/log-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-emitter.js","sourceRoot":"","sources":["../../../src/core/events/log-emitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,6BAA6B;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,YAAY,EAAE,CAAC;AAQ7C,oCAAoC;AACpC,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IAClD,YAAY,IAAuC;QACjD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,GAAG,CAAC,IAAa,EAAE,QAAoB;QACrC,YAAY,CAAC,GAAG,EAAE;YAChB,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC7B,sDAAsD;YACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,QAAQ,EAAE,CAAC;IACb,CAAC;CACF"}

package/dist/core/filters/exception-filter.decorator.d.ts

@@ -0,0 +1,40 @@
+import 'reflect-metadata';
+import { ExceptionFilterConstructor } from './exception-filter.interface.js';
+/**
+ * Marks a class as an exception filter
+ *
+ * @example
+ * ```typescript
+ * @ExceptionFilter()
+ * export class GlobalExceptionFilter implements ExceptionFilterInterface {
+ *   catch(exception: unknown, context: ExecutionContext) {
+ *     context.logger.error('Exception caught:', exception);
+ *     return {
+ *       error: exception instanceof Error ? exception.message : String(exception),
+ *       timestamp: new Date().toISOString(),
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export declare function ExceptionFilter(): ClassDecorator;
+/**
+ * Apply exception filters to a tool method
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'create_user', ... })
+ * @UseFilters(ValidationExceptionFilter, HttpExceptionFilter)
+ * async createUser(input: Record<string, unknown>) { }
+ * ```
+ */
+export declare function UseFilters(...filters: ExceptionFilterConstructor[]): MethodDecorator;
+/**
+ * Get exception filters for a method
+ */
+export declare function getExceptionFilterMetadata(target: object, propertyKey: string | symbol): ExceptionFilterConstructor[];
+/**
+ * Check if a class is marked as an exception filter
+ */
+export declare function isExceptionFilter(target: object): boolean;
+//# sourceMappingURL=exception-filter.decorator.d.ts.map

package/dist/core/filters/exception-filter.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception-filter.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/filters/exception-filter.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAK7E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,IAAI,cAAc,CAIhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,GAAG,OAAO,EAAE,0BAA0B,EAAE,GAAG,eAAe,CAUpF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,0BAA0B,EAAE,CAErH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/core/filters/exception-filter.decorator.js

@@ -0,0 +1,54 @@
+import 'reflect-metadata';
+const EXCEPTION_FILTER_KEY = 'nitrostack:exception_filter';
+const IS_EXCEPTION_FILTER_KEY = 'nitrostack:is_exception_filter';
+/**
+ * Marks a class as an exception filter
+ *
+ * @example
+ * ```typescript
+ * @ExceptionFilter()
+ * export class GlobalExceptionFilter implements ExceptionFilterInterface {
+ *   catch(exception: unknown, context: ExecutionContext) {
+ *     context.logger.error('Exception caught:', exception);
+ *     return {
+ *       error: exception instanceof Error ? exception.message : String(exception),
+ *       timestamp: new Date().toISOString(),
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export function ExceptionFilter() {
+    return (target) => {
+        Reflect.defineMetadata(IS_EXCEPTION_FILTER_KEY, true, target);
+    };
+}
+/**
+ * Apply exception filters to a tool method
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'create_user', ... })
+ * @UseFilters(ValidationExceptionFilter, HttpExceptionFilter)
+ * async createUser(input: Record<string, unknown>) { }
+ * ```
+ */
+export function UseFilters(...filters) {
+    return (target, propertyKey, descriptor) => {
+        const existingFilters = Reflect.getMetadata(EXCEPTION_FILTER_KEY, target, propertyKey) || [];
+        Reflect.defineMetadata(EXCEPTION_FILTER_KEY, [...existingFilters, ...filters], target, propertyKey);
+    };
+}
+/**
+ * Get exception filters for a method
+ */
+export function getExceptionFilterMetadata(target, propertyKey) {
+    return Reflect.getMetadata(EXCEPTION_FILTER_KEY, target, propertyKey) || [];
+}
+/**
+ * Check if a class is marked as an exception filter
+ */
+export function isExceptionFilter(target) {
+    return Reflect.getMetadata(IS_EXCEPTION_FILTER_KEY, target) === true;
+}
+//# sourceMappingURL=exception-filter.decorator.js.map

package/dist/core/filters/exception-filter.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception-filter.decorator.js","sourceRoot":"","sources":["../../../src/core/filters/exception-filter.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAC3D,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,MAAc,EAAE,EAAE;QACxB,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,GAAG,OAAqC;IACjE,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAC7F,OAAO,CAAC,cAAc,CACpB,oBAAoB,EACpB,CAAC,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC,EAChC,MAAM,EACN,WAAW,CACZ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc,EAAE,WAA4B;IACrF,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AACvE,CAAC"}

package/dist/core/filters/exception-filter.interface.d.ts

@@ -0,0 +1,39 @@
+import 'reflect-metadata';
+import { ExecutionContext } from '../types.js';
+/**
+ * Exception with optional status code
+ */
+export interface ExceptionWithStatus extends Error {
+    status?: number;
+    statusCode?: number;
+    code?: string;
+}
+/**
+ * Exception Filter Interface
+ *
+ * Exception filters handle errors thrown during tool execution.
+ * They can transform errors into user-friendly responses.
+ *
+ * @example
+ * ```typescript
+ * @ExceptionFilter()
+ * export class HttpExceptionFilter implements ExceptionFilterInterface {
+ *   catch(exception: unknown, context: ExecutionContext) {
+ *     const err = exception as ExceptionWithStatus;
+ *     return {
+ *       statusCode: err.status || 500,
+ *       message: err.message,
+ *       timestamp: new Date().toISOString(),
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface ExceptionFilterInterface {
+    catch(exception: unknown, context: ExecutionContext): unknown | Promise<unknown>;
+}
+/**
+ * Exception filter constructor type
+ */
+export type ExceptionFilterConstructor = new (...args: unknown[]) => ExceptionFilterInterface;
+//# sourceMappingURL=exception-filter.interface.d.ts.map

package/dist/core/filters/exception-filter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception-filter.interface.d.ts","sourceRoot":"","sources":["../../../src/core/filters/exception-filter.interface.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,KAAK;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClF;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,wBAAwB,CAAC"}

package/dist/core/filters/exception-filter.interface.js

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

package/dist/core/filters/exception-filter.interface.js.map

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

package/dist/core/guards/apikey.guard.d.ts

@@ -0,0 +1,22 @@
+/**
+ * API Key Guard Interface
+ *
+ * This is exported from the SDK for type definitions.
+ * The actual ApiKeyGuard implementation should be in your project's guards folder.
+ *
+ * @example
+ * See templates/typescript-auth-api-key/src/guards/apikey.guard.ts for implementation
+ */
+export interface ApiKeyMetadata {
+    /** The API key value (raw) */
+    key: string;
+    /** Optional: API key name/identifier */
+    name?: string;
+    /** Optional: Key prefix (e.g., 'sk' for secret key, 'pk' for public key) */
+    prefix?: string;
+    /** Optional: Scopes/permissions */
+    scopes?: string[];
+    /** Optional: Additional metadata */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=apikey.guard.d.ts.map