@digitaldefiance/node-express-suite 3.11.32 → 3.12.1

package/src/decorators/http-methods.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * @fileoverview Enhanced HTTP method decorators with OpenAPI support.
+ * Provides @Get, @Post, @Put, @Delete, @Patch decorators with inline OpenAPI metadata.
+ * @module decorators/http-methods
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Get = Get;
+exports.Post = Post;
+exports.Put = Put;
+exports.Delete = Delete;
+exports.Patch = Patch;
+require("reflect-metadata");
+const metadata_keys_1 = require("./metadata-keys");
+const metadata_collector_1 = require("./metadata-collector");
+/**
+ * Extracts path parameters from an Express-style route path.
+ * @param path - Route path (e.g., '/users/:id/posts/:postId')
+ * @returns Array of parameter names
+ */
+function extractPathParameters(path) {
+    const paramRegex = /:([a-zA-Z_][a-zA-Z0-9_]*)/g;
+    const params = [];
+    let match;
+    while ((match = paramRegex.exec(path)) !== null) {
+        params.push(match[1]);
+    }
+    return params;
+}
+/**
+ * Builds OpenAPI metadata from route decorator options.
+ * Merges inline options (summary, description, tags, etc.) with explicit openapi object.
+ * @param path - Route path for extracting parameters
+ * @param options - Route decorator options
+ * @returns Partial OpenAPI route metadata
+ */
+function buildOpenAPIMetadata(path, options) {
+    const metadata = {};
+    // Extract inline OpenAPI options
+    if (options.summary !== undefined) {
+        metadata.summary = options.summary;
+    }
+    if (options.description !== undefined) {
+        metadata.description = options.description;
+    }
+    if (options.tags !== undefined) {
+        metadata.tags = options.tags;
+    }
+    if (options.operationId !== undefined) {
+        metadata.operationId = options.operationId;
+    }
+    if (options.deprecated !== undefined) {
+        metadata.deprecated = options.deprecated;
+    }
+    // Auto-extract path parameters for OpenAPI
+    const pathParams = extractPathParameters(path);
+    if (pathParams.length > 0) {
+        metadata.parameters = pathParams.map((name) => ({
+            name,
+            in: 'path',
+            required: true,
+            schema: { type: 'string' },
+        }));
+    }
+    // Merge with explicit openapi object (explicit takes precedence)
+    if (options.openapi) {
+        // Merge tags (concatenate arrays)
+        if (options.openapi.tags) {
+            metadata.tags = [...(metadata.tags ?? []), ...options.openapi.tags];
+        }
+        // Merge parameters (concatenate, explicit params can override auto-extracted)
+        if (options.openapi.parameters) {
+            const existingParams = metadata.parameters ?? [];
+            const explicitParams = options.openapi.parameters;
+            // Remove auto-extracted params that are overridden by explicit params
+            const explicitParamNames = new Set(explicitParams.map((p) => p.name));
+            const filteredExisting = existingParams.filter((p) => !explicitParamNames.has(p.name));
+            metadata.parameters = [...filteredExisting, ...explicitParams];
+        }
+        // Override scalar values
+        if (options.openapi.summary !== undefined) {
+            metadata.summary = options.openapi.summary;
+        }
+        if (options.openapi.description !== undefined) {
+            metadata.description = options.openapi.description;
+        }
+        if (options.openapi.operationId !== undefined) {
+            metadata.operationId = options.openapi.operationId;
+        }
+        if (options.openapi.deprecated !== undefined) {
+            metadata.deprecated = options.openapi.deprecated;
+        }
+        if (options.openapi.requestBody !== undefined) {
+            metadata.requestBody = options.openapi.requestBody;
+        }
+        if (options.openapi.responses !== undefined) {
+            metadata.responses = options.openapi.responses;
+        }
+    }
+    return metadata;
+}
+/**
+ * Creates an HTTP method decorator with OpenAPI support.
+ * @param method - HTTP method (get, post, put, delete, patch)
+ * @param path - Route path
+ * @param options - Route decorator options
+ * @returns Method decorator function
+ */
+function createHttpMethodDecorator(method, path, options = {}) {
+    return function (target, propertyKey, descriptor) {
+        const constructor = target.constructor;
+        const handlerName = String(propertyKey);
+        // Get existing routes or initialize empty array
+        const existingRoutes = (0, metadata_collector_1.getMetadataOrDefault)(metadata_keys_1.ROUTES_METADATA, constructor, undefined, []);
+        // Create route metadata
+        const route = {
+            method,
+            path,
+            handlerName,
+            options,
+        };
+        // Add to routes array
+        existingRoutes.push(route);
+        Reflect.defineMetadata(metadata_keys_1.ROUTES_METADATA, existingRoutes, constructor);
+        // Build and store OpenAPI metadata for this method
+        const openApiMetadata = buildOpenAPIMetadata(path, options);
+        if (Object.keys(openApiMetadata).length > 0) {
+            // Deep merge with any existing OpenAPI metadata on this method
+            // (from other decorators like @ApiSummary, @ApiTags, etc.)
+            (0, metadata_collector_1.deepMergeMetadata)(metadata_keys_1.OPENAPI_METADATA, openApiMetadata, constructor, propertyKey);
+        }
+        return descriptor;
+    };
+}
+/**
+ * GET method decorator with OpenAPI support.
+ * Registers a GET route handler with optional OpenAPI metadata.
+ *
+ * @param path - Route path (e.g., '/users/:id')
+ * @param options - Route options including validation, auth, and OpenAPI metadata
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Get('/:id', {
+ *     summary: 'Get user by ID',
+ *     tags: ['Users'],
+ *     auth: true,
+ *   })
+ *   async getUser(@Param('id') id: string) {
+ *     return this.userService.findById(id);
+ *   }
+ * }
+ * ```
+ */
+function Get(path, options = {}) {
+    return createHttpMethodDecorator('get', path, options);
+}
+/**
+ * POST method decorator with OpenAPI support.
+ * Registers a POST route handler with optional OpenAPI metadata.
+ *
+ * @param path - Route path (e.g., '/users')
+ * @param options - Route options including validation, auth, and OpenAPI metadata
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Post('/', {
+ *     summary: 'Create a new user',
+ *     tags: ['Users'],
+ *     schema: createUserSchema,
+ *   })
+ *   async createUser(@Body() data: CreateUserDto) {
+ *     return this.userService.create(data);
+ *   }
+ * }
+ * ```
+ */
+function Post(path, options = {}) {
+    return createHttpMethodDecorator('post', path, options);
+}
+/**
+ * PUT method decorator with OpenAPI support.
+ * Registers a PUT route handler with optional OpenAPI metadata.
+ *
+ * @param path - Route path (e.g., '/users/:id')
+ * @param options - Route options including validation, auth, and OpenAPI metadata
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Put('/:id', {
+ *     summary: 'Update user',
+ *     tags: ['Users'],
+ *     auth: true,
+ *   })
+ *   async updateUser(@Param('id') id: string, @Body() data: UpdateUserDto) {
+ *     return this.userService.update(id, data);
+ *   }
+ * }
+ * ```
+ */
+function Put(path, options = {}) {
+    return createHttpMethodDecorator('put', path, options);
+}
+/**
+ * DELETE method decorator with OpenAPI support.
+ * Registers a DELETE route handler with optional OpenAPI metadata.
+ *
+ * @param path - Route path (e.g., '/users/:id')
+ * @param options - Route options including validation, auth, and OpenAPI metadata
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Delete('/:id', {
+ *     summary: 'Delete user',
+ *     tags: ['Users'],
+ *     auth: true,
+ *   })
+ *   async deleteUser(@Param('id') id: string) {
+ *     return this.userService.delete(id);
+ *   }
+ * }
+ * ```
+ */
+function Delete(path, options = {}) {
+    return createHttpMethodDecorator('delete', path, options);
+}
+/**
+ * PATCH method decorator with OpenAPI support.
+ * Registers a PATCH route handler with optional OpenAPI metadata.
+ *
+ * @param path - Route path (e.g., '/users/:id')
+ * @param options - Route options including validation, auth, and OpenAPI metadata
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Patch('/:id', {
+ *     summary: 'Partially update user',
+ *     tags: ['Users'],
+ *     auth: true,
+ *   })
+ *   async patchUser(@Param('id') id: string, @Body() data: PatchUserDto) {
+ *     return this.userService.patch(id, data);
+ *   }
+ * }
+ * ```
+ */
+function Patch(path, options = {}) {
+    return createHttpMethodDecorator('patch', path, options);
+}
+//# sourceMappingURL=http-methods.js.map

package/src/decorators/http-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-methods.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/http-methods.ts"],"names":[],"mappings":"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"}

package/src/decorators/index.d.ts

@@ -1,4 +1,26 @@
+/**
+ * @fileoverview Decorator module exports.
+ * Provides all decorator exports for Express Suite.
+ * @module decorators
+ */
+export * from './auth';
 export * from './base-controller';
 export * from './controller';
+export * from './handler-args';
+export { Get, Post, Put, Delete, Patch } from './http-methods';
+export type { EnhancedRouteMetadata, RouteDecoratorOptions, } from './http-methods';
+export { OnSuccess, OnError, Before, After, getLifecycleMetadata, getClassLifecycleMetadata, getEffectiveLifecycleMetadata, hasLifecycleHooks, executeBeforeHooks, executeAfterHooks, executeOnSuccessHooks, executeOnErrorHooks, } from './lifecycle';
+export type { LifecycleContext, LifecycleCallback, LifecycleMetadata, } from './lifecycle';
+export * from './metadata-collector';
+export * from './metadata-keys';
+export * from './middleware';
+export * from './openapi';
+export * from './openapi-params';
+export * from './params';
+export * from './response';
+export * from './schema';
+export { Transactional, getTransactionMetadata, isTransactional, getTransactionTimeout, } from './transaction';
+export type { TransactionMetadata } from './transaction';
+export * from './validation';
 export * from './zod-validation';
 //# sourceMappingURL=index.d.ts.map

package/src/decorators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,QAAQ,CAAC;AAGvB,cAAc,mBAAmB,CAAC;AAGlC,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EACV,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,SAAS,EACT,OAAO,EACP,MAAM,EACN,KAAK,EACL,oBAAoB,EACpB,yBAAyB,EACzB,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,cAAc,CAAC;AAG7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,UAAU,CAAC;AAGzB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGzD,cAAc,cAAc,CAAC;AAG7B,cAAc,kBAAkB,CAAC"}

package/src/decorators/index.js

@@ -1,7 +1,63 @@
 "use strict";
+/**
+ * @fileoverview Decorator module exports.
+ * Provides all decorator exports for Express Suite.
+ * @module decorators
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTransactionTimeout = exports.isTransactional = exports.getTransactionMetadata = exports.Transactional = exports.executeOnErrorHooks = exports.executeOnSuccessHooks = exports.executeAfterHooks = exports.executeBeforeHooks = exports.hasLifecycleHooks = exports.getEffectiveLifecycleMetadata = exports.getClassLifecycleMetadata = exports.getLifecycleMetadata = exports.After = exports.Before = exports.OnError = exports.OnSuccess = exports.Patch = exports.Delete = exports.Put = exports.Post = exports.Get = void 0;
 const tslib_1 = require("tslib");
+// Auth decorators
+tslib_1.__exportStar(require("./auth"), exports);
+// Base controller with decorator support
 tslib_1.__exportStar(require("./base-controller"), exports);
+// Controller decorators
 tslib_1.__exportStar(require("./controller"), exports);
+// Handler args decorator
+tslib_1.__exportStar(require("./handler-args"), exports);
+// HTTP method decorators - export specific items to avoid conflicts
+var http_methods_1 = require("./http-methods");
+Object.defineProperty(exports, "Get", { enumerable: true, get: function () { return http_methods_1.Get; } });
+Object.defineProperty(exports, "Post", { enumerable: true, get: function () { return http_methods_1.Post; } });
+Object.defineProperty(exports, "Put", { enumerable: true, get: function () { return http_methods_1.Put; } });
+Object.defineProperty(exports, "Delete", { enumerable: true, get: function () { return http_methods_1.Delete; } });
+Object.defineProperty(exports, "Patch", { enumerable: true, get: function () { return http_methods_1.Patch; } });
+// Lifecycle decorators - export specific items to avoid conflicts with interfaces
+var lifecycle_1 = require("./lifecycle");
+Object.defineProperty(exports, "OnSuccess", { enumerable: true, get: function () { return lifecycle_1.OnSuccess; } });
+Object.defineProperty(exports, "OnError", { enumerable: true, get: function () { return lifecycle_1.OnError; } });
+Object.defineProperty(exports, "Before", { enumerable: true, get: function () { return lifecycle_1.Before; } });
+Object.defineProperty(exports, "After", { enumerable: true, get: function () { return lifecycle_1.After; } });
+Object.defineProperty(exports, "getLifecycleMetadata", { enumerable: true, get: function () { return lifecycle_1.getLifecycleMetadata; } });
+Object.defineProperty(exports, "getClassLifecycleMetadata", { enumerable: true, get: function () { return lifecycle_1.getClassLifecycleMetadata; } });
+Object.defineProperty(exports, "getEffectiveLifecycleMetadata", { enumerable: true, get: function () { return lifecycle_1.getEffectiveLifecycleMetadata; } });
+Object.defineProperty(exports, "hasLifecycleHooks", { enumerable: true, get: function () { return lifecycle_1.hasLifecycleHooks; } });
+Object.defineProperty(exports, "executeBeforeHooks", { enumerable: true, get: function () { return lifecycle_1.executeBeforeHooks; } });
+Object.defineProperty(exports, "executeAfterHooks", { enumerable: true, get: function () { return lifecycle_1.executeAfterHooks; } });
+Object.defineProperty(exports, "executeOnSuccessHooks", { enumerable: true, get: function () { return lifecycle_1.executeOnSuccessHooks; } });
+Object.defineProperty(exports, "executeOnErrorHooks", { enumerable: true, get: function () { return lifecycle_1.executeOnErrorHooks; } });
+// Metadata utilities
+tslib_1.__exportStar(require("./metadata-collector"), exports);
+tslib_1.__exportStar(require("./metadata-keys"), exports);
+// Middleware decorators
+tslib_1.__exportStar(require("./middleware"), exports);
+// OpenAPI decorators
+tslib_1.__exportStar(require("./openapi"), exports);
+tslib_1.__exportStar(require("./openapi-params"), exports);
+// Parameter injection decorators
+tslib_1.__exportStar(require("./params"), exports);
+// Response decorators
+tslib_1.__exportStar(require("./response"), exports);
+// Schema decorators
+tslib_1.__exportStar(require("./schema"), exports);
+// Transaction decorator - export specific items to avoid conflicts with interfaces
+var transaction_1 = require("./transaction");
+Object.defineProperty(exports, "Transactional", { enumerable: true, get: function () { return transaction_1.Transactional; } });
+Object.defineProperty(exports, "getTransactionMetadata", { enumerable: true, get: function () { return transaction_1.getTransactionMetadata; } });
+Object.defineProperty(exports, "isTransactional", { enumerable: true, get: function () { return transaction_1.isTransactional; } });
+Object.defineProperty(exports, "getTransactionTimeout", { enumerable: true, get: function () { return transaction_1.getTransactionTimeout; } });
+// Validation decorators
+tslib_1.__exportStar(require("./validation"), exports);
+// Zod validation utilities
 tslib_1.__exportStar(require("./zod-validation"), exports);
 //# sourceMappingURL=index.js.map

package/src/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/index.ts"],"names":[],"mappings":";;;AAAA,4DAAkC;AAClC,uDAA6B;AAC7B,2DAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;AAEH,kBAAkB;AAClB,iDAAuB;AAEvB,yCAAyC;AACzC,4DAAkC;AAElC,wBAAwB;AACxB,uDAA6B;AAE7B,yBAAyB;AACzB,yDAA+B;AAE/B,oEAAoE;AACpE,+CAA+D;AAAtD,mGAAA,GAAG,OAAA;AAAE,oGAAA,IAAI,OAAA;AAAE,mGAAA,GAAG,OAAA;AAAE,sGAAA,MAAM,OAAA;AAAE,qGAAA,KAAK,OAAA;AAMtC,kFAAkF;AAClF,yCAaqB;AAZnB,sGAAA,SAAS,OAAA;AACT,oGAAA,OAAO,OAAA;AACP,mGAAA,MAAM,OAAA;AACN,kGAAA,KAAK,OAAA;AACL,iHAAA,oBAAoB,OAAA;AACpB,sHAAA,yBAAyB,OAAA;AACzB,0HAAA,6BAA6B,OAAA;AAC7B,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,8GAAA,iBAAiB,OAAA;AACjB,kHAAA,qBAAqB,OAAA;AACrB,gHAAA,mBAAmB,OAAA;AAQrB,qBAAqB;AACrB,+DAAqC;AACrC,0DAAgC;AAEhC,wBAAwB;AACxB,uDAA6B;AAE7B,qBAAqB;AACrB,oDAA0B;AAC1B,2DAAiC;AAEjC,iCAAiC;AACjC,mDAAyB;AAEzB,sBAAsB;AACtB,qDAA2B;AAE3B,oBAAoB;AACpB,mDAAyB;AAEzB,mFAAmF;AACnF,6CAKuB;AAJrB,4GAAA,aAAa,OAAA;AACb,qHAAA,sBAAsB,OAAA;AACtB,8GAAA,eAAe,OAAA;AACf,oHAAA,qBAAqB,OAAA;AAIvB,wBAAwB;AACxB,uDAA6B;AAE7B,2BAA2B;AAC3B,2DAAiC"}

package/src/decorators/lifecycle.d.ts

@@ -0,0 +1,248 @@
+/**
+ * @fileoverview Lifecycle decorators for Express Suite.
+ * Provides @OnSuccess, @OnError, @Before, and @After decorators
+ * for hooking into request lifecycle events.
+ * Supports both class-level and method-level application.
+ * @module decorators/lifecycle
+ */
+import 'reflect-metadata';
+import { Request, Response } from 'express';
+/**
+ * Context passed to lifecycle callbacks.
+ */
+export interface LifecycleContext<TResult = unknown, TError = Error> {
+    /**
+     * The Express request object.
+     */
+    req: Request;
+    /**
+     * The Express response object.
+     */
+    res: Response;
+    /**
+     * The result from the handler (available in onSuccess and after hooks).
+     */
+    result?: TResult;
+    /**
+     * The error that occurred (available in onError and after hooks).
+     */
+    error?: TError;
+}
+/**
+ * Lifecycle callback function type.
+ */
+export type LifecycleCallback<TResult = unknown, TError = Error> = (context: LifecycleContext<TResult, TError>) => void | Promise<void>;
+/**
+ * Metadata stored for lifecycle hooks.
+ */
+export interface LifecycleMetadata {
+    /**
+     * Callbacks to execute on successful response.
+     */
+    onSuccess: LifecycleCallback[];
+    /**
+     * Callbacks to execute on error.
+     */
+    onError: LifecycleCallback[];
+    /**
+     * Callbacks to execute before the handler.
+     */
+    before: LifecycleCallback[];
+    /**
+     * Callbacks to execute after the handler (success or error).
+     */
+    after: LifecycleCallback[];
+}
+/**
+ * Decorator that registers a callback to execute after a successful response.
+ * Can be applied at class level (affects all methods) or method level.
+ *
+ * @param callback - Function to execute on success, receives context with req, res, and result
+ * @returns Class or method decorator
+ *
+ * @example
+ * ```typescript
+ * // Method-level usage
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @OnSuccess(({ req, result }) => {
+ *     console.log(`User ${req.params.id} fetched successfully:`, result);
+ *   })
+ *   @Get('/:id')
+ *   getUser() {}
+ * }
+ *
+ * // Class-level usage (applies to all methods)
+ * @OnSuccess(({ req }) => {
+ *   console.log(`Request to ${req.path} completed successfully`);
+ * })
+ * @ApiController('/api/items')
+ * class ItemController {
+ *   @Get('/')
+ *   listItems() {}
+ * }
+ * ```
+ */
+export declare function OnSuccess<TResult = unknown>(callback: LifecycleCallback<TResult>): ClassDecorator & MethodDecorator;
+/**
+ * Decorator that registers a callback to execute when an error occurs.
+ * Can be applied at class level (affects all methods) or method level.
+ *
+ * @param callback - Function to execute on error, receives context with req, res, and error
+ * @returns Class or method decorator
+ *
+ * @example
+ * ```typescript
+ * // Method-level usage
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @OnError(({ req, error }) => {
+ *     console.error(`Error fetching user ${req.params.id}:`, error);
+ *   })
+ *   @Get('/:id')
+ *   getUser() {}
+ * }
+ *
+ * // Class-level usage for logging all errors
+ * @OnError(({ req, error }) => {
+ *   logger.error(`Request to ${req.path} failed:`, error);
+ * })
+ * @ApiController('/api/items')
+ * class ItemController {
+ *   @Get('/')
+ *   listItems() {}
+ * }
+ * ```
+ */
+export declare function OnError<TError = Error>(callback: LifecycleCallback<unknown, TError>): ClassDecorator & MethodDecorator;
+/**
+ * Decorator that registers a callback to execute before the handler.
+ * Can be applied at class level (affects all methods) or method level.
+ * Useful for logging, auditing, or pre-processing.
+ *
+ * @param callback - Function to execute before handler, receives context with req and res
+ * @returns Class or method decorator
+ *
+ * @example
+ * ```typescript
+ * // Method-level usage
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @Before(({ req }) => {
+ *     console.log(`Fetching user ${req.params.id}`);
+ *   })
+ *   @Get('/:id')
+ *   getUser() {}
+ * }
+ *
+ * // Class-level usage for request logging
+ * @Before(({ req }) => {
+ *   console.log(`Incoming ${req.method} request to ${req.path}`);
+ * })
+ * @ApiController('/api/items')
+ * class ItemController {
+ *   @Get('/')
+ *   listItems() {}
+ * }
+ * ```
+ */
+export declare function Before(callback: LifecycleCallback): ClassDecorator & MethodDecorator;
+/**
+ * Decorator that registers a callback to execute after the handler completes.
+ * Executes regardless of success or error.
+ * Can be applied at class level (affects all methods) or method level.
+ * Useful for cleanup, metrics, or finalization.
+ *
+ * @param callback - Function to execute after handler, receives context with req, res, result, and error
+ * @returns Class or method decorator
+ *
+ * @example
+ * ```typescript
+ * // Method-level usage
+ * @ApiController('/api/users')
+ * class UserController {
+ *   @After(({ req, result, error }) => {
+ *     const status = error ? 'failed' : 'succeeded';
+ *     console.log(`Request to ${req.path} ${status}`);
+ *   })
+ *   @Get('/:id')
+ *   getUser() {}
+ * }
+ *
+ * // Class-level usage for metrics
+ * @After(({ req }) => {
+ *   metrics.recordRequest(req.path);
+ * })
+ * @ApiController('/api/items')
+ * class ItemController {
+ *   @Get('/')
+ *   listItems() {}
+ * }
+ * ```
+ */
+export declare function After(callback: LifecycleCallback): ClassDecorator & MethodDecorator;
+/**
+ * Gets lifecycle metadata for a specific method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns Lifecycle metadata or undefined if not set
+ */
+export declare function getLifecycleMetadata(target: object, propertyKey: string | symbol): LifecycleMetadata | undefined;
+/**
+ * Gets class-level lifecycle metadata.
+ *
+ * @param target - The class constructor
+ * @returns Lifecycle metadata or undefined if not set
+ */
+export declare function getClassLifecycleMetadata(target: object): LifecycleMetadata | undefined;
+/**
+ * Gets the effective lifecycle metadata for a method, merging class-level and method-level hooks.
+ * Class-level hooks run first, then method-level hooks.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns Merged lifecycle metadata
+ */
+export declare function getEffectiveLifecycleMetadata(target: object, propertyKey: string | symbol): LifecycleMetadata;
+/**
+ * Checks if a method has any lifecycle hooks defined.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @returns True if any lifecycle hooks are defined
+ */
+export declare function hasLifecycleHooks(target: object, propertyKey: string | symbol): boolean;
+/**
+ * Executes all before hooks for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @param context - The lifecycle context
+ */
+export declare function executeBeforeHooks(target: object, propertyKey: string | symbol, context: LifecycleContext): Promise<void>;
+/**
+ * Executes all after hooks for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @param context - The lifecycle context
+ */
+export declare function executeAfterHooks(target: object, propertyKey: string | symbol, context: LifecycleContext): Promise<void>;
+/**
+ * Executes all onSuccess hooks for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @param context - The lifecycle context with result
+ */
+export declare function executeOnSuccessHooks(target: object, propertyKey: string | symbol, context: LifecycleContext): Promise<void>;
+/**
+ * Executes all onError hooks for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @param context - The lifecycle context with error
+ */
+export declare function executeOnErrorHooks(target: object, propertyKey: string | symbol, context: LifecycleContext): Promise<void>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/src/decorators/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/lifecycle.ts"],"names":[],"mappings":"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"}