@riktajs/core 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/provider.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAGrD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,CASrD"}

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

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Provider = Provider;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+const registry_1 = require("../registry");
+/**
+ * @Provider() decorator
+ *
+ * Marks a class as a custom provider that will be auto-discovered.
+ * The class must implement a `provide()` method that returns the value.
+ *
+ * Providers can inject dependencies via constructor or @Autowired properties,
+ * making them perfect for complex factory logic.
+ *
+ * @param token - The injection token this provider supplies
+ *
+ * @example Simple value provider:
+ * ```typescript
+ * const APP_CONFIG = new InjectionToken<AppConfig>('app.config');
+ *
+ * @Provider(APP_CONFIG)
+ * export class AppConfigProvider {
+ *   provide(): AppConfig {
+ *     return {
+ *       name: 'My App',
+ *       version: '1.0.0',
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * @example Provider with dependencies:
+ * ```typescript
+ * const LOGGER = new InjectionToken<Logger>('logger');
+ *
+ * @Provider(LOGGER)
+ * export class LoggerProvider {
+ *   constructor(@Autowired(APP_CONFIG) private config: AppConfig) {}
+ *
+ *   provide(): Logger {
+ *     return createLogger({
+ *       appName: this.config.name,
+ *       level: this.config.debug ? 'debug' : 'info',
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * @example Async provider:
+ * ```typescript
+ * @Provider(DATABASE)
+ * export class DatabaseProvider {
+ *   async provide(): Promise<Database> {
+ *     const db = await connectToDatabase();
+ *     return db;
+ *   }
+ * }
+ * ```
+ */
+function Provider(token) {
+    return (target) => {
+        const metadata = { token };
+        Reflect.defineMetadata(constants_1.PROVIDER_METADATA, metadata, target);
+        // Register in global registry for auto-discovery
+        registry_1.registry.registerCustomProvider(target);
+    };
+}
+//# sourceMappingURL=provider.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/provider.decorator.ts"],"names":[],"mappings":";;AAkEA,4BASC;AA3ED,4BAA0B;AAC1B,4CAAiD;AAEjD,0CAAuC;AASvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,SAAgB,QAAQ,CAAC,KAAY;IACnC,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAqB,EAAE,KAAK,EAAE,CAAC;QAE7C,OAAO,CAAC,cAAc,CAAC,6BAAiB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAE5D,iDAAiD;QACjD,mBAAQ,CAAC,sBAAsB,CAAC,MAA6C,CAAC,CAAC;IACjF,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/decorators/route.decorator.d.ts

@@ -0,0 +1,53 @@
+import 'reflect-metadata';
+/**
+ * @Get() decorator - Handles HTTP GET requests
+ *
+ * @example
+ * ```typescript
+ * @Get('/users')
+ * getUsers() { return []; }
+ * ```
+ */
+export declare const Get: (path?: string) => MethodDecorator;
+/**
+ * @Post() decorator - Handles HTTP POST requests
+ *
+ * @example
+ * ```typescript
+ * @Post('/users')
+ * createUser(@Body() data: CreateUserDto) { return data; }
+ * ```
+ */
+export declare const Post: (path?: string) => MethodDecorator;
+/**
+ * @Put() decorator - Handles HTTP PUT requests
+ */
+export declare const Put: (path?: string) => MethodDecorator;
+/**
+ * @Patch() decorator - Handles HTTP PATCH requests
+ */
+export declare const Patch: (path?: string) => MethodDecorator;
+/**
+ * @Delete() decorator - Handles HTTP DELETE requests
+ */
+export declare const Delete: (path?: string) => MethodDecorator;
+/**
+ * @Options() decorator - Handles HTTP OPTIONS requests
+ */
+export declare const Options: (path?: string) => MethodDecorator;
+/**
+ * @Head() decorator - Handles HTTP HEAD requests
+ */
+export declare const Head: (path?: string) => MethodDecorator;
+/**
+ * @HttpCode() decorator - Sets the HTTP status code for a route
+ *
+ * @example
+ * ```typescript
+ * @Post('/users')
+ * @HttpCode(201)
+ * createUser() { return { created: true }; }
+ * ```
+ */
+export declare function HttpCode(statusCode: number): MethodDecorator;
+//# sourceMappingURL=route.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/route.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAgC1B;;;;;;;;GAQG;AACH,eAAO,MAAM,GAAG,UAjCA,MAAM,KAAQ,eAiCgB,CAAC;AAE/C;;;;;;;;GAQG;AACH,eAAO,MAAM,IAAI,UA5CD,MAAM,KAAQ,eA4CkB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,GAAG,UAjDA,MAAM,KAAQ,eAiDgB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,KAAK,UAtDF,MAAM,KAAQ,eAsDoB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,MAAM,UA3DH,MAAM,KAAQ,eA2DsB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,OAAO,UAhEJ,MAAM,KAAQ,eAgEwB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,IAAI,UArED,MAAM,KAAQ,eAqEkB,CAAC;AAEjD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAK5D"}

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

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Head = exports.Options = exports.Delete = exports.Patch = exports.Put = exports.Post = exports.Get = void 0;
+exports.HttpCode = HttpCode;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+/**
+ * Creates a route decorator for a specific HTTP method
+ */
+function createRouteDecorator(method) {
+    return (path = '') => {
+        return (target, propertyKey, descriptor) => {
+            // Normalize path
+            const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+            // Get existing routes or initialize empty array
+            const routes = Reflect.getMetadata(constants_1.ROUTES_METADATA, target.constructor) ?? [];
+            // Add this route
+            routes.push({
+                method,
+                path: normalizedPath === '/' ? '' : normalizedPath,
+                handlerName: propertyKey,
+            });
+            // Store updated routes
+            Reflect.defineMetadata(constants_1.ROUTES_METADATA, routes, target.constructor);
+            return descriptor;
+        };
+    };
+}
+/**
+ * @Get() decorator - Handles HTTP GET requests
+ *
+ * @example
+ * ```typescript
+ * @Get('/users')
+ * getUsers() { return []; }
+ * ```
+ */
+exports.Get = createRouteDecorator('GET');
+/**
+ * @Post() decorator - Handles HTTP POST requests
+ *
+ * @example
+ * ```typescript
+ * @Post('/users')
+ * createUser(@Body() data: CreateUserDto) { return data; }
+ * ```
+ */
+exports.Post = createRouteDecorator('POST');
+/**
+ * @Put() decorator - Handles HTTP PUT requests
+ */
+exports.Put = createRouteDecorator('PUT');
+/**
+ * @Patch() decorator - Handles HTTP PATCH requests
+ */
+exports.Patch = createRouteDecorator('PATCH');
+/**
+ * @Delete() decorator - Handles HTTP DELETE requests
+ */
+exports.Delete = createRouteDecorator('DELETE');
+/**
+ * @Options() decorator - Handles HTTP OPTIONS requests
+ */
+exports.Options = createRouteDecorator('OPTIONS');
+/**
+ * @Head() decorator - Handles HTTP HEAD requests
+ */
+exports.Head = createRouteDecorator('HEAD');
+/**
+ * @HttpCode() decorator - Sets the HTTP status code for a route
+ *
+ * @example
+ * ```typescript
+ * @Post('/users')
+ * @HttpCode(201)
+ * createUser() { return { created: true }; }
+ * ```
+ */
+function HttpCode(statusCode) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(constants_1.HTTP_CODE_METADATA, statusCode, target.constructor, propertyKey);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=route.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/route.decorator.ts"],"names":[],"mappings":";;;AAyFA,4BAKC;AA9FD,4BAA0B;AAC1B,4CAAmE;AAGnE;;GAEG;AACH,SAAS,oBAAoB,CAAC,MAAkB;IAC9C,OAAO,CAAC,OAAe,EAAE,EAAmB,EAAE;QAC5C,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;YACtF,iBAAiB;YACjB,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YAEhE,gDAAgD;YAChD,MAAM,MAAM,GACV,OAAO,CAAC,WAAW,CAAC,2BAAe,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YAEjE,iBAAiB;YACjB,MAAM,CAAC,IAAI,CAAC;gBACV,MAAM;gBACN,IAAI,EAAE,cAAc,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc;gBAClD,WAAW,EAAE,WAAW;aACzB,CAAC,CAAC;YAEH,uBAAuB;YACvB,OAAO,CAAC,cAAc,CAAC,2BAAe,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YAEpE,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;AAE/C;;;;;;;;GAQG;AACU,QAAA,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAEjD;;GAEG;AACU,QAAA,GAAG,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;AAE/C;;GAEG;AACU,QAAA,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAEnD;;GAEG;AACU,QAAA,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AAErD;;GAEG;AACU,QAAA,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAEvD;;GAEG;AACU,QAAA,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAEjD;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CAAC,UAAkB;IACzC,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACtF,OAAO,CAAC,cAAc,CAAC,8BAAkB,EAAE,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACxF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/discovery.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Discover and import modules matching the given patterns
+ *
+ * Only imports files that contain @Controller, @Injectable, or @Provider decorators.
+ *
+ * @param patterns - Glob patterns to search for files (default: ['./**'])
+ * @param cwd - Base directory for pattern matching (default: process.cwd())
+ * @returns Promise resolving to list of imported files
+ *
+ * @example
+ * ```typescript
+ * // Scan specific directories
+ * await discoverModules(['./src/controllers', './src/services']);
+ *
+ * // Scan everything (default)
+ * await discoverModules();
+ * ```
+ */
+export declare function discoverModules(patterns?: string[], cwd?: string): Promise<string[]>;
+/**
+ * Get the caller's directory (useful for relative pattern resolution)
+ */
+export declare function getCallerDirectory(): string;
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/core/discovery.ts"],"names":[],"mappings":"AAqCA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,QAAQ,GAAE,MAAM,EAAuB,EACvC,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAgDnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA+B3C"}

package/dist/core/discovery.js

@@ -0,0 +1,168 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverModules = discoverModules;
+exports.getCallerDirectory = getCallerDirectory;
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Default patterns to exclude from discovery
+ */
+const DEFAULT_IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/*.test.ts',
+    '**/*.spec.ts',
+    '**/*.d.ts',
+];
+/**
+ * Regex patterns to detect Rikta decorators
+ */
+const DECORATOR_PATTERNS = [
+    /@Controller\s*\(/, // @Controller() or @Controller('/path')
+    /@Injectable\s*\(/, // @Injectable() or @Injectable({ scope: 'singleton' })
+    /@Provider\s*\(/, // @Provider(TOKEN)
+];
+/**
+ * Check if a file contains Rikta decorators (@Controller, @Injectable, or @Provider)
+ */
+async function containsRiktaDecorators(filePath) {
+    try {
+        const content = await promises_1.default.readFile(filePath, 'utf-8');
+        return DECORATOR_PATTERNS.some(pattern => pattern.test(content));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Discover and import modules matching the given patterns
+ *
+ * Only imports files that contain @Controller, @Injectable, or @Provider decorators.
+ *
+ * @param patterns - Glob patterns to search for files (default: ['./**'])
+ * @param cwd - Base directory for pattern matching (default: process.cwd())
+ * @returns Promise resolving to list of imported files
+ *
+ * @example
+ * ```typescript
+ * // Scan specific directories
+ * await discoverModules(['./src/controllers', './src/services']);
+ *
+ * // Scan everything (default)
+ * await discoverModules();
+ * ```
+ */
+async function discoverModules(patterns = ['./**/*.{ts,js}'], cwd = process.cwd()) {
+    // Normalize patterns to include file extensions if not present
+    const normalizedPatterns = patterns.map(pattern => {
+        // If pattern already has extension, use as-is
+        if (/\.\w+$/.test(pattern) || pattern.endsWith('*')) {
+            return pattern;
+        }
+        // Add file extension pattern
+        return pattern.endsWith('/')
+            ? `${pattern}**/*.{ts,js}`
+            : `${pattern}/**/*.{ts,js}`;
+    });
+    // Find all matching files
+    const files = await (0, fast_glob_1.default)(normalizedPatterns, {
+        cwd,
+        absolute: true,
+        ignore: DEFAULT_IGNORE_PATTERNS,
+        onlyFiles: true,
+    });
+    // Filter files that contain Rikta decorators
+    const riktaFiles = [];
+    for (const file of files) {
+        if (await containsRiktaDecorators(file)) {
+            riktaFiles.push(file);
+        }
+    }
+    // Import only files with decorators
+    const importedFiles = [];
+    for (const file of riktaFiles) {
+        try {
+            // Convert to proper import path
+            const importPath = file.replace(/\.ts$/, '');
+            await Promise.resolve(`${importPath}`).then(s => __importStar(require(s)));
+            importedFiles.push(file);
+        }
+        catch (error) {
+            // Log but don't fail - some files might have import errors
+            if (process.env.DEBUG) {
+                console.warn(`[Rikta] Failed to import ${file}:`, error);
+            }
+        }
+    }
+    return importedFiles;
+}
+/**
+ * Get the caller's directory (useful for relative pattern resolution)
+ */
+function getCallerDirectory() {
+    const originalPrepareStackTrace = Error.prepareStackTrace;
+    try {
+        const err = new Error();
+        let callerFile;
+        Error.prepareStackTrace = (_, stack) => stack;
+        const stack = err.stack;
+        // Find the first file that's not this module
+        for (const site of stack) {
+            const filename = site.getFileName();
+            if (filename && !filename.includes('discovery.ts') && !filename.includes('application.ts')) {
+                callerFile = filename;
+                break;
+            }
+        }
+        if (callerFile) {
+            // Handle file:// URLs (ESM) and regular paths
+            const filePath = callerFile.startsWith('file://')
+                ? new URL(callerFile).pathname
+                : callerFile;
+            return path_1.default.dirname(filePath);
+        }
+        return process.cwd();
+    }
+    finally {
+        Error.prepareStackTrace = originalPrepareStackTrace;
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/core/discovery.js.map

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

package/dist/core/exceptions/catch.decorator.d.ts

@@ -0,0 +1,71 @@
+import 'reflect-metadata';
+import { Constructor } from '../types';
+/**
+ * Metadata key for @Catch() decorator
+ */
+export declare const CATCH_METADATA: unique symbol;
+/**
+ * Metadata stored by @Catch() decorator
+ */
+export interface CatchMetadata {
+    /** Exception types this filter handles */
+    exceptions: Constructor<Error>[];
+}
+/**
+ * @Catch() Decorator
+ *
+ * Marks a class as an exception filter and specifies which
+ * exception types it should handle.
+ *
+ * If no exception types are provided, the filter catches all exceptions.
+ *
+ * @param exceptions - Exception types to catch (optional)
+ *
+ * @example Catch specific exception
+ * ```typescript
+ * @Catch(NotFoundException)
+ * class NotFoundExceptionFilter implements ExceptionFilter {
+ *   catch(exception: NotFoundException, context: ExceptionContext) {
+ *     const { reply, path } = context;
+ *     reply.status(404).send({
+ *       statusCode: 404,
+ *       message: exception.message,
+ *       path,
+ *       timestamp: new Date().toISOString()
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * @example Catch multiple exceptions
+ * ```typescript
+ * @Catch(BadRequestException, UnprocessableEntityException)
+ * class ValidationExceptionFilter implements ExceptionFilter {
+ *   catch(exception: HttpException, context: ExceptionContext) {
+ *     const { reply } = context;
+ *     const response = exception.getResponse();
+ *
+ *     reply.status(exception.getStatus()).send({
+ *       ...response,
+ *       type: 'VALIDATION_ERROR'
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * @example Catch all exceptions
+ * ```typescript
+ * @Catch()
+ * class AllExceptionsFilter implements ExceptionFilter {
+ *   catch(exception: Error, context: ExceptionContext) {
+ *     // Handle any exception
+ *   }
+ * }
+ * ```
+ */
+export declare function Catch(...exceptions: Constructor<Error>[]): ClassDecorator;
+/**
+ * Get catch metadata from a filter class
+ */
+export declare function getCatchMetadata(target: Constructor): CatchMetadata | undefined;
+//# sourceMappingURL=catch.decorator.d.ts.map

package/dist/core/exceptions/catch.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catch.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/catch.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,KAAK,CAAC,GAAG,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,GAAG,cAAc,CAQzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAE/E"}

package/dist/core/exceptions/catch.decorator.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CATCH_METADATA = void 0;
+exports.Catch = Catch;
+exports.getCatchMetadata = getCatchMetadata;
+require("reflect-metadata");
+/**
+ * Metadata key for @Catch() decorator
+ */
+exports.CATCH_METADATA = Symbol('catch:metadata');
+/**
+ * @Catch() Decorator
+ *
+ * Marks a class as an exception filter and specifies which
+ * exception types it should handle.
+ *
+ * If no exception types are provided, the filter catches all exceptions.
+ *
+ * @param exceptions - Exception types to catch (optional)
+ *
+ * @example Catch specific exception
+ * ```typescript
+ * @Catch(NotFoundException)
+ * class NotFoundExceptionFilter implements ExceptionFilter {
+ *   catch(exception: NotFoundException, context: ExceptionContext) {
+ *     const { reply, path } = context;
+ *     reply.status(404).send({
+ *       statusCode: 404,
+ *       message: exception.message,
+ *       path,
+ *       timestamp: new Date().toISOString()
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * @example Catch multiple exceptions
+ * ```typescript
+ * @Catch(BadRequestException, UnprocessableEntityException)
+ * class ValidationExceptionFilter implements ExceptionFilter {
+ *   catch(exception: HttpException, context: ExceptionContext) {
+ *     const { reply } = context;
+ *     const response = exception.getResponse();
+ *
+ *     reply.status(exception.getStatus()).send({
+ *       ...response,
+ *       type: 'VALIDATION_ERROR'
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * @example Catch all exceptions
+ * ```typescript
+ * @Catch()
+ * class AllExceptionsFilter implements ExceptionFilter {
+ *   catch(exception: Error, context: ExceptionContext) {
+ *     // Handle any exception
+ *   }
+ * }
+ * ```
+ */
+function Catch(...exceptions) {
+    return (target) => {
+        const metadata = {
+            exceptions: exceptions.length > 0 ? exceptions : [],
+        };
+        Reflect.defineMetadata(exports.CATCH_METADATA, metadata, target);
+    };
+}
+/**
+ * Get catch metadata from a filter class
+ */
+function getCatchMetadata(target) {
+    return Reflect.getMetadata(exports.CATCH_METADATA, target);
+}
+//# sourceMappingURL=catch.decorator.js.map

package/dist/core/exceptions/catch.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catch.decorator.js","sourceRoot":"","sources":["../../../src/core/exceptions/catch.decorator.ts"],"names":[],"mappings":";;;AAoEA,sBAQC;AAKD,4CAEC;AAnFD,4BAA0B;AAG1B;;GAEG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAUvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,SAAgB,KAAK,CAAC,GAAG,UAAgC;IACvD,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,MAAM,QAAQ,GAAkB;YAC9B,UAAU,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;SACpD,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,sBAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAAmB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,sBAAc,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC"}