@digitaldefiance/node-express-suite 3.11.31 → 3.12.0

package/src/decorators/metadata-collector.js

@@ -0,0 +1,272 @@
+"use strict";
+/**
+ * @fileoverview Metadata collector utilities for decorator system.
+ * Provides helper functions for getting, setting, and merging decorator metadata.
+ * @module decorators/metadata-collector
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA_METADATA = void 0;
+exports.getMetadata = getMetadata;
+exports.setMetadata = setMetadata;
+exports.getMetadataOrDefault = getMetadataOrDefault;
+exports.appendToMetadataArray = appendToMetadataArray;
+exports.mergeMetadata = mergeMetadata;
+exports.deepMergeMetadata = deepMergeMetadata;
+exports.hasMetadata = hasMetadata;
+exports.deleteMetadata = deleteMetadata;
+exports.getMetadataKeys = getMetadataKeys;
+exports.collectAllMetadata = collectAllMetadata;
+exports.collectMethodMetadata = collectMethodMetadata;
+exports.createClassDecorator = createClassDecorator;
+exports.createMethodDecorator = createMethodDecorator;
+exports.createAppendingMethodDecorator = createAppendingMethodDecorator;
+exports.createMergingMethodDecorator = createMergingMethodDecorator;
+require("reflect-metadata");
+const metadata_keys_1 = require("./metadata-keys");
+Object.defineProperty(exports, "SCHEMA_METADATA", { enumerable: true, get: function () { return metadata_keys_1.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
+ */
+function getMetadata(key, target, propertyKey) {
+    if (propertyKey !== undefined) {
+        return Reflect.getMetadata(key, target, propertyKey);
+    }
+    return Reflect.getMetadata(key, target);
+}
+/**
+ * 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
+ */
+function setMetadata(key, value, target, propertyKey) {
+    if (propertyKey !== undefined) {
+        Reflect.defineMetadata(key, value, target, propertyKey);
+    }
+    else {
+        Reflect.defineMetadata(key, value, target);
+    }
+}
+/**
+ * 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
+ */
+function getMetadataOrDefault(key, target, propertyKey, defaultValue) {
+    const value = getMetadata(key, target, propertyKey);
+    return value !== undefined ? value : defaultValue;
+}
+/**
+ * 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
+ */
+function appendToMetadataArray(key, value, target, propertyKey) {
+    const existing = getMetadataOrDefault(key, target, propertyKey, []);
+    existing.push(value);
+    setMetadata(key, existing, target, propertyKey);
+}
+/**
+ * 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
+ */
+function mergeMetadata(key, value, target, propertyKey) {
+    const existing = getMetadataOrDefault(key, target, propertyKey, {});
+    const merged = { ...existing, ...value };
+    setMetadata(key, merged, target, propertyKey);
+}
+/**
+ * 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
+ */
+function deepMergeMetadata(key, value, target, propertyKey) {
+    const existing = getMetadataOrDefault(key, target, propertyKey, {});
+    const merged = deepMerge(existing, value);
+    setMetadata(key, merged, target, propertyKey);
+}
+/**
+ * Deep merges two objects.
+ * Arrays are concatenated, objects are recursively merged.
+ * @param target - The target object
+ * @param source - The source object to merge from
+ * @returns The merged object
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key in source) {
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+            const sourceValue = source[key];
+            const targetValue = result[key];
+            if (Array.isArray(sourceValue) && Array.isArray(targetValue)) {
+                // Concatenate arrays
+                result[key] = [
+                    ...targetValue,
+                    ...sourceValue,
+                ];
+            }
+            else if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {
+                // Recursively merge objects
+                result[key] = deepMerge(targetValue, sourceValue);
+            }
+            else if (sourceValue !== undefined) {
+                // Override with source value
+                result[key] = sourceValue;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Checks if a value is a plain object (not an array, null, or other type).
+ * @param value - The value to check
+ * @returns True if the value is a plain object
+ */
+function isPlainObject(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.getPrototypeOf(value) === Object.prototype);
+}
+/**
+ * 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
+ */
+function hasMetadata(key, target, propertyKey) {
+    if (propertyKey !== undefined) {
+        return Reflect.hasMetadata(key, target, propertyKey);
+    }
+    return Reflect.hasMetadata(key, target);
+}
+/**
+ * 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
+ */
+function deleteMetadata(key, target, propertyKey) {
+    if (propertyKey !== undefined) {
+        return Reflect.deleteMetadata(key, target, propertyKey);
+    }
+    return Reflect.deleteMetadata(key, target);
+}
+/**
+ * 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
+ */
+function getMetadataKeys(target, propertyKey) {
+    if (propertyKey !== undefined) {
+        return Reflect.getMetadataKeys(target, propertyKey);
+    }
+    return Reflect.getMetadataKeys(target);
+}
+/**
+ * Collects all decorator metadata from a class and its methods.
+ * @param target - The class constructor
+ * @returns Object containing all collected metadata
+ */
+function collectAllMetadata(target) {
+    const controllerMetadata = getMetadata(metadata_keys_1.CONTROLLER_METADATA, target);
+    const routesMetadata = getMetadata(metadata_keys_1.ROUTES_METADATA, target);
+    const openApiControllerMetadata = getMetadata(metadata_keys_1.OPENAPI_CONTROLLER_METADATA, target);
+    return {
+        controller: controllerMetadata,
+        routes: routesMetadata ?? [],
+        openApiController: openApiControllerMetadata,
+    };
+}
+/**
+ * Collects method-level metadata for a specific method.
+ * @param target - The class prototype
+ * @param propertyKey - The method name
+ * @returns Object containing all method metadata
+ */
+function collectMethodMetadata(target, propertyKey) {
+    return {
+        openApi: getMetadata(metadata_keys_1.OPENAPI_METADATA, target, propertyKey),
+        auth: getMetadata(metadata_keys_1.AUTH_METADATA, target, propertyKey),
+        validation: getMetadata(metadata_keys_1.VALIDATION_METADATA, target, propertyKey),
+        middleware: getMetadata(metadata_keys_1.MIDDLEWARE_METADATA, target, propertyKey),
+        params: getMetadata(metadata_keys_1.PARAMS_METADATA, target, propertyKey),
+        lifecycle: getMetadata(metadata_keys_1.LIFECYCLE_METADATA, target, propertyKey),
+        response: getMetadata(metadata_keys_1.RESPONSE_METADATA, target, propertyKey),
+        handlerArgs: getMetadata(metadata_keys_1.HANDLER_ARGS_METADATA, target, propertyKey),
+        transaction: getMetadata(metadata_keys_1.TRANSACTION_METADATA, target, propertyKey),
+        rateLimit: getMetadata(metadata_keys_1.RATE_LIMIT_METADATA, target, propertyKey),
+        cache: getMetadata(metadata_keys_1.CACHE_METADATA, target, propertyKey),
+        openApiParams: getMetadata(metadata_keys_1.OPENAPI_PARAMS_METADATA, target, propertyKey),
+        openApiRequestBody: getMetadata(metadata_keys_1.OPENAPI_REQUEST_BODY_METADATA, target, propertyKey),
+    };
+}
+/**
+ * Creates a class decorator that sets metadata.
+ * @param key - The metadata key symbol
+ * @param value - The metadata value
+ * @returns A class decorator function
+ */
+function createClassDecorator(key, value) {
+    return (target) => {
+        setMetadata(key, value, target);
+    };
+}
+/**
+ * Creates a method decorator that sets metadata.
+ * @param key - The metadata key symbol
+ * @param value - The metadata value
+ * @returns A method decorator function
+ */
+function createMethodDecorator(key, value) {
+    return (target, propertyKey, descriptor) => {
+        setMetadata(key, value, target.constructor, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * 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
+ */
+function createAppendingMethodDecorator(key, value) {
+    return (target, propertyKey, descriptor) => {
+        appendToMetadataArray(key, value, target.constructor, propertyKey);
+        return descriptor;
+    };
+}
+/**
+ * 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
+ */
+function createMergingMethodDecorator(key, value) {
+    return (target, propertyKey, descriptor) => {
+        mergeMetadata(key, value, target.constructor, propertyKey);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=metadata-collector.js.map

package/src/decorators/metadata-collector.js.map

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

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

@@ -0,0 +1,121 @@
+/**
+ * @fileoverview Metadata keys for decorator system.
+ * Provides unique Symbol constants for storing decorator metadata.
+ * @module decorators/metadata-keys
+ */
+/**
+ * Metadata key for controller-level configuration.
+ * Stores base path and controller options.
+ */
+export declare const CONTROLLER_METADATA: unique symbol;
+/**
+ * Metadata key for route definitions array.
+ * Stores array of RouteMetadata objects for each decorated method.
+ */
+export declare const ROUTES_METADATA: unique symbol;
+/**
+ * Metadata key for OpenAPI-specific metadata per method.
+ * Stores OpenAPIRouteMetadata for individual route operations.
+ */
+export declare const OPENAPI_METADATA: unique symbol;
+/**
+ * Metadata key for controller-level OpenAPI metadata.
+ * Stores tags, description, and other controller-wide OpenAPI settings.
+ */
+export declare const OPENAPI_CONTROLLER_METADATA: unique symbol;
+/**
+ * Metadata key for authentication settings per method.
+ * Stores auth requirements (JWT, crypto auth, public).
+ */
+export declare const AUTH_METADATA: unique symbol;
+/**
+ * Metadata key for validation schemas per method.
+ * Stores Zod schemas or express-validator chains.
+ */
+export declare const VALIDATION_METADATA: unique symbol;
+/**
+ * Metadata key for middleware array per method.
+ * Stores Express middleware functions to be applied to routes.
+ */
+export declare const MIDDLEWARE_METADATA: unique symbol;
+/**
+ * Metadata key for parameter injection metadata per method.
+ * Stores parameter decorators info (@Param, @Body, @Query, etc.).
+ */
+export declare const PARAMS_METADATA: unique symbol;
+/**
+ * Metadata key for lifecycle hooks per method.
+ * Stores @OnSuccess, @OnError, @Before, @After callbacks.
+ */
+export declare const LIFECYCLE_METADATA: unique symbol;
+/**
+ * Metadata key for response definitions per method.
+ * Stores @Returns and @ApiResponse decorator data.
+ */
+export declare const RESPONSE_METADATA: unique symbol;
+/**
+ * Metadata key for schema registration metadata.
+ * Stores @ApiSchema and @ApiProperty decorator data.
+ */
+export declare const SCHEMA_METADATA: unique symbol;
+/**
+ * Metadata key for handler arguments.
+ * Stores additional arguments to pass to handler methods.
+ */
+export declare const HANDLER_ARGS_METADATA: unique symbol;
+/**
+ * Metadata key for transaction settings per method.
+ * Stores @Transactional decorator options.
+ */
+export declare const TRANSACTION_METADATA: unique symbol;
+/**
+ * Metadata key for rate limiting settings per method.
+ * Stores @RateLimit decorator options.
+ */
+export declare const RATE_LIMIT_METADATA: unique symbol;
+/**
+ * Metadata key for cache settings per method.
+ * Stores @CacheResponse decorator options.
+ */
+export declare const CACHE_METADATA: unique symbol;
+/**
+ * Metadata key for OpenAPI parameter definitions.
+ * Stores @ApiParam, @ApiQuery, @ApiHeader decorator data.
+ */
+export declare const OPENAPI_PARAMS_METADATA: unique symbol;
+/**
+ * Metadata key for OpenAPI request body definition.
+ * Stores @ApiRequestBody decorator data.
+ */
+export declare const OPENAPI_REQUEST_BODY_METADATA: unique symbol;
+/**
+ * All metadata keys exported as a collection for iteration/validation.
+ */
+export declare const ALL_METADATA_KEYS: {
+    readonly CONTROLLER_METADATA: typeof CONTROLLER_METADATA;
+    readonly ROUTES_METADATA: typeof ROUTES_METADATA;
+    readonly OPENAPI_METADATA: typeof OPENAPI_METADATA;
+    readonly OPENAPI_CONTROLLER_METADATA: typeof OPENAPI_CONTROLLER_METADATA;
+    readonly AUTH_METADATA: typeof AUTH_METADATA;
+    readonly VALIDATION_METADATA: typeof VALIDATION_METADATA;
+    readonly MIDDLEWARE_METADATA: typeof MIDDLEWARE_METADATA;
+    readonly PARAMS_METADATA: typeof PARAMS_METADATA;
+    readonly LIFECYCLE_METADATA: typeof LIFECYCLE_METADATA;
+    readonly RESPONSE_METADATA: typeof RESPONSE_METADATA;
+    readonly SCHEMA_METADATA: typeof SCHEMA_METADATA;
+    readonly HANDLER_ARGS_METADATA: typeof HANDLER_ARGS_METADATA;
+    readonly TRANSACTION_METADATA: typeof TRANSACTION_METADATA;
+    readonly RATE_LIMIT_METADATA: typeof RATE_LIMIT_METADATA;
+    readonly CACHE_METADATA: typeof CACHE_METADATA;
+    readonly OPENAPI_PARAMS_METADATA: typeof OPENAPI_PARAMS_METADATA;
+    readonly OPENAPI_REQUEST_BODY_METADATA: typeof OPENAPI_REQUEST_BODY_METADATA;
+};
+/**
+ * Type representing all metadata key names.
+ */
+export type MetadataKeyName = keyof typeof ALL_METADATA_KEYS;
+/**
+ * Type representing all metadata key symbols.
+ */
+export type MetadataKey = (typeof ALL_METADATA_KEYS)[MetadataKeyName];
+//# sourceMappingURL=metadata-keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-keys.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/metadata-keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,eAAuB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,eAAe,eAAmB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,eAAoB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,eAA+B,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,aAAa,eAAiB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,eAAuB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,eAAuB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,eAAe,eAAmB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,eAAsB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,eAAqB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,eAAe,eAAmB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,eAAwB,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,eAAwB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,eAAsB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,cAAc,eAAkB,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,eAA2B,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,6BAA6B,eAAgC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;CAkBpB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,eAAe,CAAC,CAAC"}

package/src/decorators/metadata-keys.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * @fileoverview Metadata keys for decorator system.
+ * Provides unique Symbol constants for storing decorator metadata.
+ * @module decorators/metadata-keys
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_METADATA_KEYS = exports.OPENAPI_REQUEST_BODY_METADATA = exports.OPENAPI_PARAMS_METADATA = exports.CACHE_METADATA = exports.RATE_LIMIT_METADATA = exports.TRANSACTION_METADATA = exports.HANDLER_ARGS_METADATA = exports.SCHEMA_METADATA = exports.RESPONSE_METADATA = exports.LIFECYCLE_METADATA = exports.PARAMS_METADATA = exports.MIDDLEWARE_METADATA = exports.VALIDATION_METADATA = exports.AUTH_METADATA = exports.OPENAPI_CONTROLLER_METADATA = exports.OPENAPI_METADATA = exports.ROUTES_METADATA = exports.CONTROLLER_METADATA = void 0;
+/**
+ * Metadata key for controller-level configuration.
+ * Stores base path and controller options.
+ */
+exports.CONTROLLER_METADATA = Symbol('controller');
+/**
+ * Metadata key for route definitions array.
+ * Stores array of RouteMetadata objects for each decorated method.
+ */
+exports.ROUTES_METADATA = Symbol('routes');
+/**
+ * Metadata key for OpenAPI-specific metadata per method.
+ * Stores OpenAPIRouteMetadata for individual route operations.
+ */
+exports.OPENAPI_METADATA = Symbol('openapi');
+/**
+ * Metadata key for controller-level OpenAPI metadata.
+ * Stores tags, description, and other controller-wide OpenAPI settings.
+ */
+exports.OPENAPI_CONTROLLER_METADATA = Symbol('openapi:controller');
+/**
+ * Metadata key for authentication settings per method.
+ * Stores auth requirements (JWT, crypto auth, public).
+ */
+exports.AUTH_METADATA = Symbol('auth');
+/**
+ * Metadata key for validation schemas per method.
+ * Stores Zod schemas or express-validator chains.
+ */
+exports.VALIDATION_METADATA = Symbol('validation');
+/**
+ * Metadata key for middleware array per method.
+ * Stores Express middleware functions to be applied to routes.
+ */
+exports.MIDDLEWARE_METADATA = Symbol('middleware');
+/**
+ * Metadata key for parameter injection metadata per method.
+ * Stores parameter decorators info (@Param, @Body, @Query, etc.).
+ */
+exports.PARAMS_METADATA = Symbol('params');
+/**
+ * Metadata key for lifecycle hooks per method.
+ * Stores @OnSuccess, @OnError, @Before, @After callbacks.
+ */
+exports.LIFECYCLE_METADATA = Symbol('lifecycle');
+/**
+ * Metadata key for response definitions per method.
+ * Stores @Returns and @ApiResponse decorator data.
+ */
+exports.RESPONSE_METADATA = Symbol('response');
+/**
+ * Metadata key for schema registration metadata.
+ * Stores @ApiSchema and @ApiProperty decorator data.
+ */
+exports.SCHEMA_METADATA = Symbol('schema');
+/**
+ * Metadata key for handler arguments.
+ * Stores additional arguments to pass to handler methods.
+ */
+exports.HANDLER_ARGS_METADATA = Symbol('handlerArgs');
+/**
+ * Metadata key for transaction settings per method.
+ * Stores @Transactional decorator options.
+ */
+exports.TRANSACTION_METADATA = Symbol('transaction');
+/**
+ * Metadata key for rate limiting settings per method.
+ * Stores @RateLimit decorator options.
+ */
+exports.RATE_LIMIT_METADATA = Symbol('rateLimit');
+/**
+ * Metadata key for cache settings per method.
+ * Stores @CacheResponse decorator options.
+ */
+exports.CACHE_METADATA = Symbol('cache');
+/**
+ * Metadata key for OpenAPI parameter definitions.
+ * Stores @ApiParam, @ApiQuery, @ApiHeader decorator data.
+ */
+exports.OPENAPI_PARAMS_METADATA = Symbol('openapi:params');
+/**
+ * Metadata key for OpenAPI request body definition.
+ * Stores @ApiRequestBody decorator data.
+ */
+exports.OPENAPI_REQUEST_BODY_METADATA = Symbol('openapi:requestBody');
+/**
+ * All metadata keys exported as a collection for iteration/validation.
+ */
+exports.ALL_METADATA_KEYS = {
+    CONTROLLER_METADATA: exports.CONTROLLER_METADATA,
+    ROUTES_METADATA: exports.ROUTES_METADATA,
+    OPENAPI_METADATA: exports.OPENAPI_METADATA,
+    OPENAPI_CONTROLLER_METADATA: exports.OPENAPI_CONTROLLER_METADATA,
+    AUTH_METADATA: exports.AUTH_METADATA,
+    VALIDATION_METADATA: exports.VALIDATION_METADATA,
+    MIDDLEWARE_METADATA: exports.MIDDLEWARE_METADATA,
+    PARAMS_METADATA: exports.PARAMS_METADATA,
+    LIFECYCLE_METADATA: exports.LIFECYCLE_METADATA,
+    RESPONSE_METADATA: exports.RESPONSE_METADATA,
+    SCHEMA_METADATA: exports.SCHEMA_METADATA,
+    HANDLER_ARGS_METADATA: exports.HANDLER_ARGS_METADATA,
+    TRANSACTION_METADATA: exports.TRANSACTION_METADATA,
+    RATE_LIMIT_METADATA: exports.RATE_LIMIT_METADATA,
+    CACHE_METADATA: exports.CACHE_METADATA,
+    OPENAPI_PARAMS_METADATA: exports.OPENAPI_PARAMS_METADATA,
+    OPENAPI_REQUEST_BODY_METADATA: exports.OPENAPI_REQUEST_BODY_METADATA,
+};
+//# sourceMappingURL=metadata-keys.js.map

package/src/decorators/metadata-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-keys.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/decorators/metadata-keys.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH;;;GAGG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAExD;;;GAGG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACU,QAAA,gBAAgB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAElD;;;GAGG;AACU,QAAA,2BAA2B,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAExE;;;GAGG;AACU,QAAA,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AAE5C;;;GAGG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAExD;;;GAGG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAExD;;;GAGG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAEtD;;;GAGG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAEpD;;;GAGG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACU,QAAA,qBAAqB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAE3D;;;GAGG;AACU,QAAA,oBAAoB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAE1D;;;GAGG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvD;;;GAGG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAE9C;;;GAGG;AACU,QAAA,uBAAuB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEhE;;;GAGG;AACU,QAAA,6BAA6B,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAE3E;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,mBAAmB,EAAnB,2BAAmB;IACnB,eAAe,EAAf,uBAAe;IACf,gBAAgB,EAAhB,wBAAgB;IAChB,2BAA2B,EAA3B,mCAA2B;IAC3B,aAAa,EAAb,qBAAa;IACb,mBAAmB,EAAnB,2BAAmB;IACnB,mBAAmB,EAAnB,2BAAmB;IACnB,eAAe,EAAf,uBAAe;IACf,kBAAkB,EAAlB,0BAAkB;IAClB,iBAAiB,EAAjB,yBAAiB;IACjB,eAAe,EAAf,uBAAe;IACf,qBAAqB,EAArB,6BAAqB;IACrB,oBAAoB,EAApB,4BAAoB;IACpB,mBAAmB,EAAnB,2BAAmB;IACnB,cAAc,EAAd,sBAAc;IACd,uBAAuB,EAAvB,+BAAuB;IACvB,6BAA6B,EAA7B,qCAA6B;CACrB,CAAC"}