nitrostack 1.0.0

package/dist/core/decorators/cache.decorator.js

@@ -0,0 +1,115 @@
+import 'reflect-metadata';
+const CACHE_KEY = 'nitrostack:cache';
+/**
+ * Default in-memory cache storage
+ */
+export class InMemoryCacheStorage {
+    cache = new Map();
+    get(key) {
+        const item = this.cache.get(key);
+        if (!item)
+            return null;
+        if (item.expires < Date.now()) {
+            this.cache.delete(key);
+            return null;
+        }
+        return item.value;
+    }
+    set(key, value, ttl) {
+        this.cache.set(key, {
+            value,
+            expires: Date.now() + (ttl * 1000),
+        });
+    }
+    delete(key) {
+        this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    // Cleanup expired entries periodically
+    cleanup() {
+        const now = Date.now();
+        for (const [key, item] of this.cache.entries()) {
+            if (item.expires < now) {
+                this.cache.delete(key);
+            }
+        }
+    }
+}
+// Default cache storage instance
+const defaultStorage = new InMemoryCacheStorage();
+/**
+ * Cache decorator - caches tool results for a specified duration
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'get_products', ... })
+ * @Cache({ ttl: 300 }) // Cache for 5 minutes
+ * async getProducts(input: any) {
+ *   return await this.database.query('SELECT * FROM products');
+ * }
+ *
+ * // With custom cache key
+ * @Cache({
+ *   ttl: 300,
+ *   key: (input) => `products:${input.category}`
+ * })
+ * async getProducts(input: any) { }
+ * ```
+ */
+export function Cache(options) {
+    return (target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const storage = options.storage || defaultStorage;
+            const input = args[0];
+            const context = args[1];
+            // Generate cache key
+            let cacheKey;
+            if (options.key) {
+                cacheKey = options.key(input, context);
+            }
+            else {
+                cacheKey = `${target.constructor.name}:${String(propertyKey)}:${JSON.stringify(input)}`;
+            }
+            // Check cache
+            const cached = await storage.get(cacheKey);
+            if (cached !== null && cached !== undefined) {
+                if (context?.logger) {
+                    context.logger.info(`[Cache] Hit for key: ${cacheKey}`);
+                }
+                return cached;
+            }
+            // Execute original method
+            const result = await originalMethod.apply(this, args);
+            // Store in cache
+            await storage.set(cacheKey, result, options.ttl);
+            if (context?.logger) {
+                context.logger.info(`[Cache] Miss for key: ${cacheKey}, stored for ${options.ttl}s`);
+            }
+            return result;
+        };
+        // Store metadata
+        Reflect.defineMetadata(CACHE_KEY, options, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Get cache options from metadata
+ */
+export function getCacheMetadata(target, propertyKey) {
+    return Reflect.getMetadata(CACHE_KEY, target, propertyKey);
+}
+/**
+ * Clear cache for a specific key or all keys
+ */
+export async function clearCache(key) {
+    if (key) {
+        await defaultStorage.delete(key);
+    }
+    else {
+        await defaultStorage.clear();
+    }
+}
+//# sourceMappingURL=cache.decorator.js.map

package/dist/core/decorators/cache.decorator.js.map

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

package/dist/core/decorators/health-check.decorator.d.ts

@@ -0,0 +1,80 @@
+import 'reflect-metadata';
+/**
+ * Health check result
+ */
+export interface HealthCheckResult {
+    status: 'up' | 'down' | 'degraded';
+    message?: string;
+    details?: any;
+    timestamp?: number;
+}
+/**
+ * Health check interface
+ */
+export interface HealthCheckInterface {
+    check(): Promise<HealthCheckResult> | HealthCheckResult;
+}
+/**
+ * Health check options
+ */
+export interface HealthCheckOptions {
+    /** Health check name/identifier */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Interval to run health check (in seconds) */
+    interval?: number;
+}
+/**
+ * Health check decorator - marks a class as a health check
+ *
+ * @example
+ * ```typescript
+ * @HealthCheck({ name: 'database', description: 'Database connectivity' })
+ * export class DatabaseHealthCheck implements HealthCheckInterface {
+ *   constructor(private database: DatabaseService) {}
+ *
+ *   async check(): Promise<HealthCheckResult> {
+ *     try {
+ *       await this.database.ping();
+ *       return { status: 'up', message: 'Database is healthy' };
+ *     } catch (error) {
+ *       return {
+ *         status: 'down',
+ *         message: 'Database connection failed',
+ *         details: error.message
+ *       };
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare function HealthCheck(options: HealthCheckOptions): ClassDecorator;
+/**
+ * Register a health check
+ */
+export declare function registerHealthCheck(checker: HealthCheckInterface, options: HealthCheckOptions): void;
+/**
+ * Get all health check results
+ */
+export declare function getAllHealthChecks(): Promise<Record<string, HealthCheckResult>>;
+/**
+ * Get a specific health check result
+ */
+export declare function getHealthCheck(name: string): Promise<HealthCheckResult | null>;
+/**
+ * Get overall health status
+ */
+export declare function getOverallHealth(): Promise<{
+    status: 'healthy' | 'unhealthy' | 'degraded';
+    checks: Record<string, HealthCheckResult>;
+}>;
+/**
+ * Check if a class is a health check
+ */
+export declare function isHealthCheck(target: any): boolean;
+/**
+ * Get health check options from metadata
+ */
+export declare function getHealthCheckMetadata(target: any): HealthCheckOptions | undefined;
+//# sourceMappingURL=health-check.decorator.d.ts.map

package/dist/core/decorators/health-check.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/health-check.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc,CAIvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CA4BpG;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAwBrF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAsBpF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAChD,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC3C,CAAC,CAkBD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,kBAAkB,GAAG,SAAS,CAElF"}

package/dist/core/decorators/health-check.decorator.js

@@ -0,0 +1,153 @@
+import 'reflect-metadata';
+const HEALTH_CHECK_KEY = 'nitrostack:health_check';
+// Global health check registry
+const healthChecks = new Map();
+/**
+ * Health check decorator - marks a class as a health check
+ *
+ * @example
+ * ```typescript
+ * @HealthCheck({ name: 'database', description: 'Database connectivity' })
+ * export class DatabaseHealthCheck implements HealthCheckInterface {
+ *   constructor(private database: DatabaseService) {}
+ *
+ *   async check(): Promise<HealthCheckResult> {
+ *     try {
+ *       await this.database.ping();
+ *       return { status: 'up', message: 'Database is healthy' };
+ *     } catch (error) {
+ *       return {
+ *         status: 'down',
+ *         message: 'Database connection failed',
+ *         details: error.message
+ *       };
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export function HealthCheck(options) {
+    return (target) => {
+        Reflect.defineMetadata(HEALTH_CHECK_KEY, options, target);
+    };
+}
+/**
+ * Register a health check
+ */
+export function registerHealthCheck(checker, options) {
+    healthChecks.set(options.name, { checker, options });
+    // Run periodically if interval is set
+    if (options.interval) {
+        setInterval(async () => {
+            try {
+                const result = await checker.check();
+                const entry = healthChecks.get(options.name);
+                if (entry) {
+                    entry.lastResult = {
+                        ...result,
+                        timestamp: Date.now(),
+                    };
+                }
+            }
+            catch (error) {
+                const entry = healthChecks.get(options.name);
+                if (entry) {
+                    entry.lastResult = {
+                        status: 'down',
+                        message: 'Health check failed',
+                        details: error,
+                        timestamp: Date.now(),
+                    };
+                }
+            }
+        }, options.interval * 1000);
+    }
+}
+/**
+ * Get all health check results
+ */
+export async function getAllHealthChecks() {
+    const results = {};
+    for (const [name, { checker, lastResult }] of healthChecks.entries()) {
+        if (lastResult) {
+            results[name] = lastResult;
+        }
+        else {
+            try {
+                results[name] = {
+                    ...await checker.check(),
+                    timestamp: Date.now(),
+                };
+            }
+            catch (error) {
+                results[name] = {
+                    status: 'down',
+                    message: 'Health check failed',
+                    details: error.message,
+                    timestamp: Date.now(),
+                };
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Get a specific health check result
+ */
+export async function getHealthCheck(name) {
+    const entry = healthChecks.get(name);
+    if (!entry)
+        return null;
+    if (entry.lastResult) {
+        return entry.lastResult;
+    }
+    try {
+        const result = await entry.checker.check();
+        return {
+            ...result,
+            timestamp: Date.now(),
+        };
+    }
+    catch (error) {
+        return {
+            status: 'down',
+            message: 'Health check failed',
+            details: error.message,
+            timestamp: Date.now(),
+        };
+    }
+}
+/**
+ * Get overall health status
+ */
+export async function getOverallHealth() {
+    const checks = await getAllHealthChecks();
+    const statuses = Object.values(checks).map(c => c.status);
+    let overallStatus;
+    if (statuses.every(s => s === 'up')) {
+        overallStatus = 'healthy';
+    }
+    else if (statuses.some(s => s === 'down')) {
+        overallStatus = 'unhealthy';
+    }
+    else {
+        overallStatus = 'degraded';
+    }
+    return {
+        status: overallStatus,
+        checks,
+    };
+}
+/**
+ * Check if a class is a health check
+ */
+export function isHealthCheck(target) {
+    return Reflect.hasMetadata(HEALTH_CHECK_KEY, target);
+}
+/**
+ * Get health check options from metadata
+ */
+export function getHealthCheckMetadata(target) {
+    return Reflect.getMetadata(HEALTH_CHECK_KEY, target);
+}
+//# sourceMappingURL=health-check.decorator.js.map

package/dist/core/decorators/health-check.decorator.js.map

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

package/dist/core/decorators/rate-limit.decorator.d.ts

@@ -0,0 +1,62 @@
+import 'reflect-metadata';
+/**
+ * Rate limit options
+ */
+export interface RateLimitOptions {
+    /** Maximum number of requests */
+    requests: number;
+    /** Time window (e.g., '1m', '1h', '1d') */
+    window: string;
+    /** Custom key generator (default: uses auth subject or IP) */
+    key?: (context: any) => string;
+    /** Storage for rate limit data */
+    storage?: RateLimitStorage;
+    /** Custom error message */
+    message?: string;
+}
+/**
+ * Rate limit storage interface
+ */
+export interface RateLimitStorage {
+    increment(key: string, windowMs: number): Promise<number> | number;
+    reset(key: string): Promise<void> | void;
+}
+/**
+ * Default in-memory rate limit storage
+ */
+export declare class InMemoryRateLimitStorage implements RateLimitStorage {
+    private limits;
+    increment(key: string, windowMs: number): number;
+    reset(key: string): void;
+    cleanup(): void;
+}
+/**
+ * Rate limit decorator - limits the number of requests per time window
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'send_email', ... })
+ * @RateLimit({ requests: 10, window: '1m' }) // 10 requests per minute
+ * async sendEmail(input: any, context: ExecutionContext) {
+ *   // Send email
+ * }
+ *
+ * // With custom key (per user)
+ * @RateLimit({
+ *   requests: 100,
+ *   window: '1h',
+ *   key: (ctx) => ctx.auth?.subject || 'anonymous'
+ * })
+ * async createOrder(input: any, context: ExecutionContext) { }
+ * ```
+ */
+export declare function RateLimit(options: RateLimitOptions): MethodDecorator;
+/**
+ * Get rate limit options from metadata
+ */
+export declare function getRateLimitMetadata(target: any, propertyKey: string | symbol): RateLimitOptions | undefined;
+/**
+ * Reset rate limit for a specific key
+ */
+export declare function resetRateLimit(key: string): Promise<void>;
+//# sourceMappingURL=rate-limit.decorator.d.ts.map

package/dist/core/decorators/rate-limit.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/rate-limit.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IAEf,8DAA8D;IAC9D,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC;IAE/B,kCAAkC;IAClC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAE3B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACnE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,MAAM,CAAyD;IAEvE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAmBhD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKxB,OAAO,IAAI,IAAI;CAQhB;AA8BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CA+CpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE5G;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D"}

package/dist/core/decorators/rate-limit.decorator.js

@@ -0,0 +1,129 @@
+import 'reflect-metadata';
+const RATE_LIMIT_KEY = 'nitrostack:rate_limit';
+/**
+ * Default in-memory rate limit storage
+ */
+export class InMemoryRateLimitStorage {
+    limits = new Map();
+    increment(key, windowMs) {
+        const now = Date.now();
+        const limit = this.limits.get(key);
+        // Reset if window expired
+        if (!limit || limit.resetAt < now) {
+            this.limits.set(key, {
+                count: 1,
+                resetAt: now + windowMs,
+            });
+            return 1;
+        }
+        // Increment
+        limit.count++;
+        this.limits.set(key, limit);
+        return limit.count;
+    }
+    reset(key) {
+        this.limits.delete(key);
+    }
+    // Cleanup expired entries
+    cleanup() {
+        const now = Date.now();
+        for (const [key, limit] of this.limits.entries()) {
+            if (limit.resetAt < now) {
+                this.limits.delete(key);
+            }
+        }
+    }
+}
+// Default storage instance
+const defaultStorage = new InMemoryRateLimitStorage();
+// Cleanup every minute
+setInterval(() => defaultStorage.cleanup(), 60000);
+/**
+ * Parse time window string to milliseconds
+ */
+function parseWindow(window) {
+    const match = window.match(/^(\d+)([smhd])$/);
+    if (!match) {
+        throw new Error(`Invalid time window format: ${window}. Use format like '1m', '1h', '1d'`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    const multipliers = {
+        s: 1000,
+        m: 60 * 1000,
+        h: 60 * 60 * 1000,
+        d: 24 * 60 * 60 * 1000,
+    };
+    return value * multipliers[unit];
+}
+/**
+ * Rate limit decorator - limits the number of requests per time window
+ *
+ * @example
+ * ```typescript
+ * @Tool({ name: 'send_email', ... })
+ * @RateLimit({ requests: 10, window: '1m' }) // 10 requests per minute
+ * async sendEmail(input: any, context: ExecutionContext) {
+ *   // Send email
+ * }
+ *
+ * // With custom key (per user)
+ * @RateLimit({
+ *   requests: 100,
+ *   window: '1h',
+ *   key: (ctx) => ctx.auth?.subject || 'anonymous'
+ * })
+ * async createOrder(input: any, context: ExecutionContext) { }
+ * ```
+ */
+export function RateLimit(options) {
+    return (target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        const windowMs = parseWindow(options.window);
+        descriptor.value = async function (...args) {
+            const context = args[1];
+            const storage = options.storage || defaultStorage;
+            // Generate rate limit key
+            let rateLimitKey;
+            if (options.key) {
+                rateLimitKey = options.key(context);
+            }
+            else {
+                // Default: use auth subject or 'anonymous'
+                rateLimitKey = context?.auth?.subject || 'anonymous';
+            }
+            const fullKey = `${target.constructor.name}:${String(propertyKey)}:${rateLimitKey}`;
+            // Check rate limit
+            const count = await storage.increment(fullKey, windowMs);
+            if (count > options.requests) {
+                const message = options.message ||
+                    `Rate limit exceeded. Maximum ${options.requests} requests per ${options.window}`;
+                if (context?.logger) {
+                    context.logger.warn(`[RateLimit] Limit exceeded for key: ${fullKey}`);
+                }
+                throw new Error(message);
+            }
+            if (context?.logger) {
+                context.logger.info(`[RateLimit] Request ${count}/${options.requests} for key: ${fullKey}`);
+            }
+            // Execute original method
+            return await originalMethod.apply(this, args);
+        };
+        // Store metadata
+        Reflect.defineMetadata(RATE_LIMIT_KEY, options, target, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * Get rate limit options from metadata
+ */
+export function getRateLimitMetadata(target, propertyKey) {
+    return Reflect.getMetadata(RATE_LIMIT_KEY, target, propertyKey);
+}
+/**
+ * Reset rate limit for a specific key
+ */
+export async function resetRateLimit(key) {
+    await defaultStorage.reset(key);
+}
+//# sourceMappingURL=rate-limit.decorator.js.map

package/dist/core/decorators/rate-limit.decorator.js.map

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