@digitaldefiance/node-express-suite 3.11.32 → 3.12.0

package/src/decorators/lifecycle.js

@@ -0,0 +1,301 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnSuccess = OnSuccess;
+exports.OnError = OnError;
+exports.Before = Before;
+exports.After = After;
+exports.getLifecycleMetadata = getLifecycleMetadata;
+exports.getClassLifecycleMetadata = getClassLifecycleMetadata;
+exports.getEffectiveLifecycleMetadata = getEffectiveLifecycleMetadata;
+exports.hasLifecycleHooks = hasLifecycleHooks;
+exports.executeBeforeHooks = executeBeforeHooks;
+exports.executeAfterHooks = executeAfterHooks;
+exports.executeOnSuccessHooks = executeOnSuccessHooks;
+exports.executeOnErrorHooks = executeOnErrorHooks;
+require("reflect-metadata");
+const metadata_keys_1 = require("./metadata-keys");
+const metadata_collector_1 = require("./metadata-collector");
+/**
+ * Creates an empty lifecycle metadata object.
+ */
+function createEmptyLifecycleMetadata() {
+    return {
+        onSuccess: [],
+        onError: [],
+        before: [],
+        after: [],
+    };
+}
+/**
+ * Creates a lifecycle decorator that can be applied to both classes and methods.
+ * @param hookType - The type of lifecycle hook
+ * @param callback - The callback function to execute
+ * @returns A decorator function
+ */
+function createLifecycleDecorator(hookType, callback) {
+    function decorator(target, propertyKey, descriptor) {
+        if (propertyKey !== undefined && descriptor !== undefined) {
+            // Method decorator
+            const existing = (0, metadata_collector_1.getMetadataOrDefault)(metadata_keys_1.LIFECYCLE_METADATA, target.constructor, propertyKey, createEmptyLifecycleMetadata());
+            existing[hookType].push(callback);
+            (0, metadata_collector_1.setMetadata)(metadata_keys_1.LIFECYCLE_METADATA, existing, target.constructor, propertyKey);
+            return descriptor;
+        }
+        else {
+            // Class decorator
+            const existing = (0, metadata_collector_1.getMetadataOrDefault)(metadata_keys_1.LIFECYCLE_METADATA, target, undefined, createEmptyLifecycleMetadata());
+            existing[hookType].push(callback);
+            (0, metadata_collector_1.setMetadata)(metadata_keys_1.LIFECYCLE_METADATA, existing, target);
+            return target;
+        }
+    }
+    return decorator;
+}
+/**
+ * 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() {}
+ * }
+ * ```
+ */
+function OnSuccess(callback) {
+    return createLifecycleDecorator('onSuccess', callback);
+}
+/**
+ * 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() {}
+ * }
+ * ```
+ */
+function OnError(callback) {
+    return createLifecycleDecorator('onError', callback);
+}
+/**
+ * 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() {}
+ * }
+ * ```
+ */
+function Before(callback) {
+    return createLifecycleDecorator('before', callback);
+}
+/**
+ * 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() {}
+ * }
+ * ```
+ */
+function After(callback) {
+    return createLifecycleDecorator('after', callback);
+}
+/**
+ * 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
+ */
+function getLifecycleMetadata(target, propertyKey) {
+    return (0, metadata_collector_1.getMetadata)(metadata_keys_1.LIFECYCLE_METADATA, target, propertyKey);
+}
+/**
+ * Gets class-level lifecycle metadata.
+ *
+ * @param target - The class constructor
+ * @returns Lifecycle metadata or undefined if not set
+ */
+function getClassLifecycleMetadata(target) {
+    return (0, metadata_collector_1.getMetadata)(metadata_keys_1.LIFECYCLE_METADATA, target);
+}
+/**
+ * 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
+ */
+function getEffectiveLifecycleMetadata(target, propertyKey) {
+    const classMetadata = (0, metadata_collector_1.getMetadataOrDefault)(metadata_keys_1.LIFECYCLE_METADATA, target, undefined, createEmptyLifecycleMetadata());
+    const methodMetadata = (0, metadata_collector_1.getMetadataOrDefault)(metadata_keys_1.LIFECYCLE_METADATA, target, propertyKey, createEmptyLifecycleMetadata());
+    // Merge: class-level hooks run first, then method-level
+    return {
+        onSuccess: [...classMetadata.onSuccess, ...methodMetadata.onSuccess],
+        onError: [...classMetadata.onError, ...methodMetadata.onError],
+        before: [...classMetadata.before, ...methodMetadata.before],
+        after: [...classMetadata.after, ...methodMetadata.after],
+    };
+}
+/**
+ * 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
+ */
+function hasLifecycleHooks(target, propertyKey) {
+    const metadata = getEffectiveLifecycleMetadata(target, propertyKey);
+    return (metadata.onSuccess.length > 0 ||
+        metadata.onError.length > 0 ||
+        metadata.before.length > 0 ||
+        metadata.after.length > 0);
+}
+/**
+ * Executes all before hooks for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @param context - The lifecycle context
+ */
+async function executeBeforeHooks(target, propertyKey, context) {
+    const metadata = getEffectiveLifecycleMetadata(target, propertyKey);
+    for (const callback of metadata.before) {
+        await callback(context);
+    }
+}
+/**
+ * Executes all after hooks for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @param context - The lifecycle context
+ */
+async function executeAfterHooks(target, propertyKey, context) {
+    const metadata = getEffectiveLifecycleMetadata(target, propertyKey);
+    for (const callback of metadata.after) {
+        await callback(context);
+    }
+}
+/**
+ * Executes all onSuccess hooks for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @param context - The lifecycle context with result
+ */
+async function executeOnSuccessHooks(target, propertyKey, context) {
+    const metadata = getEffectiveLifecycleMetadata(target, propertyKey);
+    for (const callback of metadata.onSuccess) {
+        await callback(context);
+    }
+}
+/**
+ * Executes all onError hooks for a method.
+ *
+ * @param target - The class constructor
+ * @param propertyKey - The method name
+ * @param context - The lifecycle context with error
+ */
+async function executeOnErrorHooks(target, propertyKey, context) {
+    const metadata = getEffectiveLifecycleMetadata(target, propertyKey);
+    for (const callback of metadata.onError) {
+        await callback(context);
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/src/decorators/lifecycle.js.map

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

package/src/decorators/metadata-collector.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @fileoverview Metadata collector utilities for decorator system.
+ * Provides helper functions for getting, setting, and merging decorator metadata.
+ * @module decorators/metadata-collector
+ */
+import 'reflect-metadata';
+import { MetadataKey, SCHEMA_METADATA } from './metadata-keys';
+export { SCHEMA_METADATA };
+/**
+ * Gets metadata from a target (class or method).
+ * @param key - The metadata key symbol
+ * @param target - The target object (class constructor or prototype)
+ * @param propertyKey - Optional property key for method-level metadata
+ * @returns The metadata value or undefined
+ */
+export declare function getMetadata<T>(key: MetadataKey, target: object, propertyKey?: string | symbol): T | undefined;
+/**
+ * Sets metadata on a target (class or method).
+ * @param key - The metadata key symbol
+ * @param value - The metadata value to set
+ * @param target - The target object (class constructor or prototype)
+ * @param propertyKey - Optional property key for method-level metadata
+ */
+export declare function setMetadata<T>(key: MetadataKey, value: T, target: object, propertyKey?: string | symbol): void;
+/**
+ * Gets metadata or returns a default value if not found.
+ * @param key - The metadata key symbol
+ * @param target - The target object
+ * @param propertyKey - Optional property key for method-level metadata
+ * @param defaultValue - Default value to return if metadata not found
+ * @returns The metadata value or the default value
+ */
+export declare function getMetadataOrDefault<T>(key: MetadataKey, target: object, propertyKey: string | symbol | undefined, defaultValue: T): T;
+/**
+ * Appends a value to an array stored in metadata.
+ * Creates the array if it doesn't exist.
+ * @param key - The metadata key symbol
+ * @param value - The value to append
+ * @param target - The target object
+ * @param propertyKey - Optional property key for method-level metadata
+ */
+export declare function appendToMetadataArray<T>(key: MetadataKey, value: T, target: object, propertyKey?: string | symbol): void;
+/**
+ * Merges an object into existing metadata.
+ * Creates the object if it doesn't exist.
+ * @param key - The metadata key symbol
+ * @param value - The object to merge
+ * @param target - The target object
+ * @param propertyKey - Optional property key for method-level metadata
+ */
+export declare function mergeMetadata<T extends object>(key: MetadataKey, value: Partial<T>, target: object, propertyKey?: string | symbol): void;
+/**
+ * Deep merges an object into existing metadata.
+ * Handles nested objects and arrays.
+ * @param key - The metadata key symbol
+ * @param value - The object to deep merge
+ * @param target - The target object
+ * @param propertyKey - Optional property key for method-level metadata
+ */
+export declare function deepMergeMetadata<T extends object>(key: MetadataKey, value: Partial<T>, target: object, propertyKey?: string | symbol): void;
+/**
+ * Checks if metadata exists on a target.
+ * @param key - The metadata key symbol
+ * @param target - The target object
+ * @param propertyKey - Optional property key for method-level metadata
+ * @returns True if metadata exists
+ */
+export declare function hasMetadata(key: MetadataKey, target: object, propertyKey?: string | symbol): boolean;
+/**
+ * Deletes metadata from a target.
+ * @param key - The metadata key symbol
+ * @param target - The target object
+ * @param propertyKey - Optional property key for method-level metadata
+ * @returns True if metadata was deleted
+ */
+export declare function deleteMetadata(key: MetadataKey, target: object, propertyKey?: string | symbol): boolean;
+/**
+ * Gets all metadata keys defined on a target.
+ * @param target - The target object
+ * @param propertyKey - Optional property key for method-level metadata
+ * @returns Array of metadata keys
+ */
+export declare function getMetadataKeys(target: object, propertyKey?: string | symbol): MetadataKey[];
+/**
+ * Collects all decorator metadata from a class and its methods.
+ * @param target - The class constructor
+ * @returns Object containing all collected metadata
+ */
+export declare function collectAllMetadata(target: new (...args: unknown[]) => unknown): CollectedMetadata;
+/**
+ * Collects method-level metadata for a specific method.
+ * @param target - The class prototype
+ * @param propertyKey - The method name
+ * @returns Object containing all method metadata
+ */
+export declare function collectMethodMetadata(target: object, propertyKey: string | symbol): MethodMetadata;
+/**
+ * Controller metadata value type.
+ */
+export interface ControllerMetadataValue {
+    basePath: string;
+    name?: string;
+}
+/**
+ * Route metadata value type.
+ */
+export interface RouteMetadataValue {
+    method: 'get' | 'post' | 'put' | 'delete' | 'patch';
+    path: string;
+    handlerName: string;
+    options: Record<string, unknown>;
+}
+/**
+ * OpenAPI controller metadata value type.
+ */
+export interface OpenApiControllerMetadataValue {
+    tags?: string[];
+    description?: string;
+    deprecated?: boolean;
+}
+/**
+ * Collected metadata from a class.
+ */
+export interface CollectedMetadata {
+    controller?: ControllerMetadataValue;
+    routes: RouteMetadataValue[];
+    openApiController?: OpenApiControllerMetadataValue;
+}
+/**
+ * Method-level metadata collection.
+ */
+export interface MethodMetadata {
+    openApi?: unknown;
+    auth?: unknown;
+    validation?: unknown;
+    middleware?: unknown;
+    params?: unknown;
+    lifecycle?: unknown;
+    response?: unknown;
+    handlerArgs?: unknown;
+    transaction?: unknown;
+    rateLimit?: unknown;
+    cache?: unknown;
+    openApiParams?: unknown;
+    openApiRequestBody?: unknown;
+}
+/**
+ * Creates a class decorator that sets metadata.
+ * @param key - The metadata key symbol
+ * @param value - The metadata value
+ * @returns A class decorator function
+ */
+export declare function createClassDecorator<T>(key: MetadataKey, value: T): ClassDecorator;
+/**
+ * Creates a method decorator that sets metadata.
+ * @param key - The metadata key symbol
+ * @param value - The metadata value
+ * @returns A method decorator function
+ */
+export declare function createMethodDecorator<T>(key: MetadataKey, value: T): MethodDecorator;
+/**
+ * Creates a method decorator that appends to an array in metadata.
+ * @param key - The metadata key symbol
+ * @param value - The value to append
+ * @returns A method decorator function
+ */
+export declare function createAppendingMethodDecorator<T>(key: MetadataKey, value: T): MethodDecorator;
+/**
+ * Creates a method decorator that merges into metadata.
+ * @param key - The metadata key symbol
+ * @param value - The value to merge
+ * @returns A method decorator function
+ */
+export declare function createMergingMethodDecorator<T extends object>(key: MetadataKey, value: Partial<T>): MethodDecorator;
+//# sourceMappingURL=metadata-collector.d.ts.map

package/src/decorators/metadata-collector.d.ts.map

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