nitrostack 1.0.0

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,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAc;QACxB,YAAO,GAAP,OAAO,CAAM;QAGpB,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,OAAa;QACxC,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: any[]) => 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: any[]): Promise<void>;
+    /**
+     * Emit an event synchronously
+     */
+    emitSync(event: string, ...args: any[]): 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,GAAG,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7D;;;;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,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAO7C;;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: any, 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: any) {
+ *     await this.sendConfirmationEmail(order);
+ *   }
+ * }
+ * ```
+ */
+export declare function OnEvent(event: string): MethodDecorator;
+/**
+ * Get event handlers from a class
+ */
+export declare function getEventHandlers(target: any): EventHandlerMetadata[];
+/**
+ * Register all event handlers from a class instance
+ */
+export declare function registerEventHandlers(instance: any): void;
+/**
+ * Emit an event from execution context
+ */
+export declare function emitEvent(event: string, ...args: any[]): 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,CAStD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,oBAAoB,EAAE,CAEpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAQzD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAS7D"}

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

@@ -0,0 +1,68 @@
+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: any, 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: any) {
+ *     await this.sendConfirmationEmail(order);
+ *   }
+ * }
+ * ```
+ */
+export function OnEvent(event) {
+    return (target, propertyKey, descriptor) => {
+        const existingHandlers = Reflect.getMetadata(EVENT_HANDLER_KEY, target.constructor) || [];
+        existingHandlers.push({
+            event,
+            methodName: propertyKey,
+        });
+        Reflect.defineMetadata(EVENT_HANDLER_KEY, existingHandlers, target.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 handler = instance[methodName].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,MAAW,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACnF,MAAM,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC1F,gBAAgB,CAAC,IAAI,CAAC;YACpB,KAAK;YACL,UAAU,EAAE,WAAW;SACxB,CAAC,CAAC;QACH,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAClF,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAW;IAC1C,OAAO,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAa;IACjD,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAExD,KAAK,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,GAAG,IAAW;IACrD,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/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: any, context: ExecutionContext) {
+ *     context.logger.error('Exception caught:', exception);
+ *     return {
+ *       error: exception.message,
+ *       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: any) { }
+ * ```
+ */
+export declare function UseFilters(...filters: ExceptionFilterConstructor[]): MethodDecorator;
+/**
+ * Get exception filters for a method
+ */
+export declare function getExceptionFilterMetadata(target: any, propertyKey: string | symbol): ExceptionFilterConstructor[];
+/**
+ * Check if a class is marked as an exception filter
+ */
+export declare function isExceptionFilter(target: any): 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,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,0BAA0B,EAAE,CAElH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAEtD"}

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: any, context: ExecutionContext) {
+ *     context.logger.error('Exception caught:', exception);
+ *     return {
+ *       error: exception.message,
+ *       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: any) { }
+ * ```
+ */
+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,MAAW,EAAE,EAAE;QACrB,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,MAAW,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACnF,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,MAAW,EAAE,WAA4B;IAClF,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAW;IAC3C,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,30 @@
+import 'reflect-metadata';
+import { ExecutionContext } from '../types.js';
+/**
+ * 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: any, context: ExecutionContext) {
+ *     return {
+ *       statusCode: exception.status || 500,
+ *       message: exception.message,
+ *       timestamp: new Date().toISOString(),
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface ExceptionFilterInterface {
+    catch(exception: any, context: ExecutionContext): any | Promise<any>;
+}
+/**
+ * Exception filter constructor type
+ */
+export type ExceptionFilterConstructor = new (...args: any[]) => 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;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,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]: any;
+}
+//# sourceMappingURL=apikey.guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apikey.guard.d.ts","sourceRoot":"","sources":["../../../src/core/guards/apikey.guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IAEZ,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,oCAAoC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/core/guards/apikey.guard.js

@@ -0,0 +1,11 @@
+/**
+ * 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 {};
+//# sourceMappingURL=apikey.guard.js.map

package/dist/core/guards/apikey.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apikey.guard.js","sourceRoot":"","sources":["../../../src/core/guards/apikey.guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,18 @@
+import { ExecutionContext } from '../types.js';
+/**
+ * Guard interface for protecting tool execution
+ * Guards can perform authentication, authorization, validation, etc.
+ */
+export interface Guard {
+    /**
+     * Determines if the current execution context is allowed to proceed
+     * @param context Execution context with request metadata
+     * @returns true if allowed, false if denied, or throws an error
+     */
+    canActivate(context: ExecutionContext): boolean | Promise<boolean>;
+}
+/**
+ * Type for guard constructor
+ */
+export type GuardConstructor = new (...args: any[]) => Guard;
+//# sourceMappingURL=guard.interface.d.ts.map

package/dist/core/guards/guard.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.interface.d.ts","sourceRoot":"","sources":["../../../src/core/guards/guard.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC"}

package/dist/core/guards/guard.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=guard.interface.js.map

package/dist/core/guards/guard.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.interface.js","sourceRoot":"","sources":["../../../src/core/guards/guard.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,18 @@
+/**
+ * JWT payload interface
+ *
+ * This is exported from the SDK for type definitions.
+ * The actual JWTGuard implementation should be in your project's guards folder.
+ *
+ * @example
+ * See templates/typescript-auth/src/guards/jwt.guard.ts for implementation
+ */
+export interface JWTPayload {
+    sub: string;
+    email?: string;
+    name?: string;
+    iat?: number;
+    exp?: number;
+    [key: string]: any;
+}
+//# sourceMappingURL=jwt.guard.d.ts.map

package/dist/core/guards/jwt.guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.guard.d.ts","sourceRoot":"","sources":["../../../src/core/guards/jwt.guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/core/guards/jwt.guard.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jwt.guard.js.map

package/dist/core/guards/jwt.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.guard.js","sourceRoot":"","sources":["../../../src/core/guards/jwt.guard.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,35 @@
+/**
+ * OAuth Token Payload Interface
+ *
+ * Standard OAuth 2.1 / JWT claims (RFC 9068)
+ *
+ * This is exported from the SDK for type definitions.
+ * The actual OAuthGuard implementation should be in your project's guards folder.
+ *
+ * @example
+ * See templates/typescript-oauth/src/guards/oauth.guard.ts for implementation
+ */
+export interface OAuthTokenPayload {
+    /** Subject - typically the user ID */
+    sub: string;
+    /** Issuer - the authorization server that issued the token */
+    iss?: string;
+    /** Audience - who the token is intended for (RFC 8707) */
+    aud?: string | string[];
+    /** Expiration time (Unix timestamp) */
+    exp?: number;
+    /** Issued at time (Unix timestamp) */
+    iat?: number;
+    /** Not before time (Unix timestamp) */
+    nbf?: number;
+    /** JWT ID - unique identifier for the token */
+    jti?: string;
+    /** Scopes - permissions granted to the token */
+    scope?: string;
+    scopes?: string[];
+    /** Client ID that requested the token */
+    client_id?: string;
+    /** Custom claims */
+    [key: string]: any;
+}
+//# sourceMappingURL=oauth.guard.d.ts.map

package/dist/core/guards/oauth.guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.guard.d.ts","sourceRoot":"","sources":["../../../src/core/guards/oauth.guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IAEZ,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oBAAoB;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/core/guards/oauth.guard.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=oauth.guard.js.map

package/dist/core/guards/oauth.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.guard.js","sourceRoot":"","sources":["../../../src/core/guards/oauth.guard.ts"],"names":[],"mappings":""}

package/dist/core/guards/use-guards.decorator.d.ts

@@ -0,0 +1,25 @@
+import 'reflect-metadata';
+import { GuardConstructor } from './guard.interface.js';
+/**
+ * Metadata key for guards
+ */
+export declare const GUARDS_METADATA: unique symbol;
+/**
+ * UseGuards decorator - Applies guards to a tool method
+ * Guards are executed before the tool handler
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'whoami', ... })
+ * @UseGuards(JWTGuard)
+ * async whoami(input: any, context: ExecutionContext) {
+ *   // This only executes if JWTGuard.canActivate returns true
+ * }
+ * ```
+ */
+export declare function UseGuards(...guards: GuardConstructor[]): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Get guards metadata for a specific method
+ */
+export declare function getGuardsMetadata(target: any, methodName: string): GuardConstructor[];
+//# sourceMappingURL=use-guards.decorator.d.ts.map

package/dist/core/guards/use-guards.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-guards.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/guards/use-guards.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,gBAAgB,EAAE,IACpC,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAKlF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAErF"}

package/dist/core/guards/use-guards.decorator.js

@@ -0,0 +1,32 @@
+import 'reflect-metadata';
+/**
+ * Metadata key for guards
+ */
+export const GUARDS_METADATA = Symbol('guards:metadata');
+/**
+ * UseGuards decorator - Applies guards to a tool method
+ * Guards are executed before the tool handler
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'whoami', ... })
+ * @UseGuards(JWTGuard)
+ * async whoami(input: any, context: ExecutionContext) {
+ *   // This only executes if JWTGuard.canActivate returns true
+ * }
+ * ```
+ */
+export function UseGuards(...guards) {
+    return function (target, propertyKey, descriptor) {
+        // Store guards metadata for this method
+        Reflect.defineMetadata(GUARDS_METADATA, guards, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Get guards metadata for a specific method
+ */
+export function getGuardsMetadata(target, methodName) {
+    return Reflect.getMetadata(GUARDS_METADATA, target, methodName) || [];
+}
+//# sourceMappingURL=use-guards.decorator.js.map