@pawells/nestjs-shared 1.0.0-dev.3052c75

package/build/common/decorators/common-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-decorators.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/common-decorators.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAItD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAIvD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAIrD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAIxD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAIxD"}

package/build/common/decorators/common-decorators.js

@@ -0,0 +1,101 @@
+import { CreateRequestPropertyDecorator } from './decorator-factory.js';
+/**
+ * Extract query parameters from HTTP request.
+ * @param key - Specific query parameter key (optional - extracts all if not specified)
+ * @returns Parameter decorator
+ *
+ * @example
+ * ```typescript
+ * // Extract all query parameters
+ * @Get()
+ * getData(@Query() query: any) {}
+ *
+ * // Extract specific query parameter
+ * @Get()
+ * getData(@Query('limit') limit: number) {}
+ * ```
+ */
+export function Query(key) {
+    return CreateRequestPropertyDecorator((request) => (key ? request.query[key] : request.query));
+}
+/**
+ * Extract route parameters from HTTP request.
+ * @param key - Specific route parameter key (optional - extracts all if not specified)
+ * @returns Parameter decorator
+ *
+ * @example
+ * ```typescript
+ * // Extract all route parameters
+ * @Get(':id')
+ * getUser(@Params() params: any) {}
+ *
+ * // Extract specific route parameter
+ * @Get(':id')
+ * getUser(@Params('id') id: string) {}
+ * ```
+ */
+export function Params(key) {
+    return CreateRequestPropertyDecorator((request) => (key ? request.params[key] : request.params));
+}
+/**
+ * Extract request body from HTTP request.
+ * @param key - Specific body property key (optional - extracts all if not specified)
+ * @returns Parameter decorator
+ *
+ * @example
+ * ```typescript
+ * // Extract entire body
+ * @Post()
+ * createUser(@Body() userData: CreateUserDto) {}
+ *
+ * // Extract specific body property
+ * @Patch(':id')
+ * updateUser(@Body('email') email: string) {}
+ * ```
+ */
+export function Body(key) {
+    return CreateRequestPropertyDecorator((request) => (key ? request.body[key] : request.body));
+}
+/**
+ * Extract request headers from HTTP request.
+ * @param key - Specific header key (optional - extracts all if not specified)
+ * @returns Parameter decorator
+ *
+ * @remarks Header names are case-insensitive in HTTP/1.1.
+ *
+ * @example
+ * ```typescript
+ * // Extract all headers
+ * @Get()
+ * getData(@Headers() headers: any) {}
+ *
+ * // Extract specific header
+ * @Get()
+ * getData(@Headers('authorization') auth: string) {}
+ * ```
+ */
+export function Headers(key) {
+    return CreateRequestPropertyDecorator((request) => (key ? request.headers[key] : request.headers));
+}
+/**
+ * Extract cookies from HTTP request.
+ * @param key - Specific cookie key (optional - extracts all if not specified)
+ * @returns Parameter decorator
+ *
+ * @remarks Requires cookie-parser middleware to be enabled.
+ *
+ * @example
+ * ```typescript
+ * // Extract all cookies
+ * @Get()
+ * getData(@Cookies() cookies: any) {}
+ *
+ * // Extract specific cookie
+ * @Get()
+ * getData(@Cookies('sessionId') sessionId: string) {}
+ * ```
+ */
+export function Cookies(key) {
+    return CreateRequestPropertyDecorator((request) => (key ? request.cookies[key] : request.cookies));
+}
+//# sourceMappingURL=common-decorators.js.map

package/build/common/decorators/common-decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-decorators.js","sourceRoot":"","sources":["../../../src/common/decorators/common-decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY;IACjC,OAAO,8BAA8B,CACpC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CACvD,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,MAAM,CAAC,GAAY;IAClC,OAAO,8BAA8B,CACpC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CACzD,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,IAAI,CAAC,GAAY;IAChC,OAAO,8BAA8B,CACpC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CACrD,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IACnC,OAAO,8BAA8B,CACpC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAC3D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IACnC,OAAO,8BAA8B,CACpC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAC3D,CAAC;AACH,CAAC"}

package/build/common/decorators/decorator-factory.d.ts

@@ -0,0 +1,108 @@
+import { ExecutionContext } from '@nestjs/common';
+import type { Request } from 'express';
+/**
+ * Base options for decorator factories
+ */
+export interface BaseDecoratorOptions {
+    /**
+     * Transform function to apply to the extracted value
+     */
+    transform?: (value: unknown) => unknown;
+    /**
+     * Validation function to check the extracted value
+     */
+    validate?: (value: unknown) => boolean;
+}
+/**
+ * Options for conditional decorators (metadata-based)
+ */
+export interface ConditionalDecoratorOptions extends BaseDecoratorOptions {
+    /**
+     * Metadata key to set
+     */
+    key: string;
+    /**
+     * Metadata value to set
+     */
+    value: any;
+}
+/**
+ * Options for validating decorators
+ */
+export interface ValidatingDecoratorOptions extends BaseDecoratorOptions {
+    /**
+     * Whether to throw an error if validation fails
+     */
+    throwOnInvalid?: boolean;
+    /**
+     * Error message for validation failures
+     */
+    errorMessage?: string;
+}
+/**
+ * Options for transforming decorators
+ */
+export interface TransformingDecoratorOptions extends BaseDecoratorOptions {
+    /**
+     * Whether to apply transformation even if value is undefined/null
+     */
+    transformUndefined?: boolean;
+}
+/**
+ * Gets the request object from HTTP execution context
+ * @param ctx - The execution context
+ * @returns The request object
+ */
+export declare function GetRequestFromContext(ctx: ExecutionContext): Request;
+/**
+ * Base factory for creating parameter decorators that extend RequestProperty functionality
+ * @param extractor - Function that extracts the value from request
+ * @param options - Configuration options
+ * @returns Parameter decorator function
+ * @example
+ * ```typescript
+ * // With explicit type parameter
+ * const MyDecorator = CreateRequestPropertyDecorator<string>(
+ *   (req) => req.headers['x-custom-id'],
+ *   { transform: (v) => (v as string).toUpperCase() }
+ * );
+ * ```
+ */
+export declare function CreateRequestPropertyDecorator<T = any>(extractor: (request: Request, ctx: ExecutionContext) => T, options?: BaseDecoratorOptions): ParameterDecorator;
+/**
+ * Factory for creating conditional decorators that set metadata
+ * @param options - Configuration options
+ * @returns Method decorator function
+ */
+export declare function CreateConditionalDecorator(options: ConditionalDecoratorOptions): MethodDecorator;
+/**
+ * Factory for creating validating decorators
+ * @param extractor - Function that extracts the value from request
+ * @param options - Configuration options
+ * @returns Parameter decorator function
+ * @example
+ * ```typescript
+ * // With explicit type parameter
+ * const ValidatedId = CreateValidatingDecorator<string>(
+ *   (req) => req.params.id,
+ *   { validate: (v) => typeof v === 'string' && v.length > 0 }
+ * );
+ * ```
+ */
+export declare function CreateValidatingDecorator<T = any>(extractor: (request: Request, ctx: ExecutionContext) => T, options?: ValidatingDecoratorOptions): ParameterDecorator;
+/**
+ * Factory for creating transforming decorators
+ * @param extractor - Function that extracts the value from request
+ * @param options - Configuration options
+ * @returns Parameter decorator function
+ * @example
+ * ```typescript
+ * // With explicit type parameter
+ * const LowercaseQuery = CreateTransformingDecorator<string>(
+ *   (req) => req.query.search as string,
+ *   { transform: (v) => (v as string).toLowerCase() }
+ * );
+ * ```
+ */
+export declare function CreateTransformingDecorator<T = any>(extractor: (request: Request, ctx: ExecutionContext) => T, options?: TransformingDecoratorOptions): ParameterDecorator;
+//# sourceMappingURL=decorator-factory.d.ts.map

package/build/common/decorators/decorator-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-factory.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/decorator-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,gBAAgB,EAAe,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;GAEG;AAEH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACxE;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,KAAK,EAAE,GAAG,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACvE;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;IACzE;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAEpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,GAAG,GAAG,EACrD,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,KAAK,CAAC,EACzD,OAAO,GAAE,oBAAyB,GAChC,kBAAkB,CAmBpB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,eAAe,CAEhG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,GAAG,GAAG,EAChD,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,KAAK,CAAC,EACzD,OAAO,GAAE,0BAA+B,GACtC,kBAAkB,CAsBpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,GAAG,GAAG,EAClD,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,KAAK,CAAC,EACzD,OAAO,GAAE,4BAAiC,GACxC,kBAAkB,CAcpB"}

package/build/common/decorators/decorator-factory.js

@@ -0,0 +1,104 @@
+import { createParamDecorator, SetMetadata } from '@nestjs/common';
+/**
+ * Gets the request object from HTTP execution context
+ * @param ctx - The execution context
+ * @returns The request object
+ */
+export function GetRequestFromContext(ctx) {
+    return ctx.switchToHttp().getRequest();
+}
+/**
+ * Base factory for creating parameter decorators that extend RequestProperty functionality
+ * @param extractor - Function that extracts the value from request
+ * @param options - Configuration options
+ * @returns Parameter decorator function
+ * @example
+ * ```typescript
+ * // With explicit type parameter
+ * const MyDecorator = CreateRequestPropertyDecorator<string>(
+ *   (req) => req.headers['x-custom-id'],
+ *   { transform: (v) => (v as string).toUpperCase() }
+ * );
+ * ```
+ */
+export function CreateRequestPropertyDecorator(extractor, options = {}) {
+    return createParamDecorator((_data, ctx) => {
+        const request = GetRequestFromContext(ctx);
+        let value = extractor(request, ctx);
+        // Apply validation if provided
+        if (options.validate && !options.validate(value)) {
+            throw new Error('Validation failed for extracted value');
+        }
+        // Apply transformation if provided
+        if (options.transform) {
+            value = options.transform(value);
+        }
+        return value;
+    })();
+}
+/**
+ * Factory for creating conditional decorators that set metadata
+ * @param options - Configuration options
+ * @returns Method decorator function
+ */
+export function CreateConditionalDecorator(options) {
+    return SetMetadata(options.key, options.value);
+}
+/**
+ * Factory for creating validating decorators
+ * @param extractor - Function that extracts the value from request
+ * @param options - Configuration options
+ * @returns Parameter decorator function
+ * @example
+ * ```typescript
+ * // With explicit type parameter
+ * const ValidatedId = CreateValidatingDecorator<string>(
+ *   (req) => req.params.id,
+ *   { validate: (v) => typeof v === 'string' && v.length > 0 }
+ * );
+ * ```
+ */
+export function CreateValidatingDecorator(extractor, options = {}) {
+    return createParamDecorator((_data, ctx) => {
+        const request = GetRequestFromContext(ctx);
+        let value = extractor(request, ctx);
+        // Apply validation if provided
+        if (options.validate) {
+            const isValid = options.validate(value);
+            if (!isValid && options.throwOnInvalid) {
+                throw new Error(options.errorMessage ?? 'Validation failed for extracted value');
+            }
+        }
+        // Apply transformation if provided
+        if (options.transform) {
+            value = options.transform(value);
+        }
+        return value;
+    })();
+}
+/**
+ * Factory for creating transforming decorators
+ * @param extractor - Function that extracts the value from request
+ * @param options - Configuration options
+ * @returns Parameter decorator function
+ * @example
+ * ```typescript
+ * // With explicit type parameter
+ * const LowercaseQuery = CreateTransformingDecorator<string>(
+ *   (req) => req.query.search as string,
+ *   { transform: (v) => (v as string).toLowerCase() }
+ * );
+ * ```
+ */
+export function CreateTransformingDecorator(extractor, options = {}) {
+    return createParamDecorator((_data, ctx) => {
+        const request = GetRequestFromContext(ctx);
+        let value = extractor(request, ctx);
+        // Apply transformation if provided
+        if (options.transform && (value !== undefined || options.transformUndefined)) {
+            value = options.transform(value);
+        }
+        return value;
+    })();
+}
+//# sourceMappingURL=decorator-factory.js.map

package/build/common/decorators/decorator-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-factory.js","sourceRoot":"","sources":["../../../src/common/decorators/decorator-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAoB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA2DrF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAqB;IAC1D,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAW,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,8BAA8B,CAC7C,SAAyD,EACzD,UAAgC,EAAE;IAElC,OAAO,oBAAoB,CAC1B,CAAC,KAAc,EAAE,GAAqB,EAAK,EAAE;QAC5C,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,KAAK,GAAY,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAE7C,+BAA+B;QAC/B,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC1D,CAAC;QAED,mCAAmC;QACnC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,KAAU,CAAC;IACnB,CAAC,CACD,EAAE,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAoC;IAC9E,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CACxC,SAAyD,EACzD,UAAsC,EAAE;IAExC,OAAO,oBAAoB,CAC1B,CAAC,KAAc,EAAE,GAAqB,EAAK,EAAE;QAC5C,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,KAAK,GAAY,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAE7C,+BAA+B;QAC/B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,IAAI,uCAAuC,CAAC,CAAC;YAClF,CAAC;QACF,CAAC;QAED,mCAAmC;QACnC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,KAAU,CAAC;IACnB,CAAC,CACD,EAAE,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CAC1C,SAAyD,EACzD,UAAwC,EAAE;IAE1C,OAAO,oBAAoB,CAC1B,CAAC,KAAc,EAAE,GAAqB,EAAK,EAAE;QAC5C,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,KAAK,GAAY,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAE7C,mCAAmC;QACnC,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC9E,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,KAAU,CAAC;IACnB,CAAC,CACD,EAAE,CAAC;AACL,CAAC"}

package/build/common/decorators/guard.decorators.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Decorator to specify required roles for a route or method
+ *
+ * @param roles - Array of role names required to access the resource
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @Roles('admin', 'moderator')
+ * @Get('admin-only')
+ * async getAdminData() {
+ *   // Only users with 'admin' or 'moderator' roles can access
+ * }
+ * ```
+ */
+export declare const Roles: (...roles: string[]) => MethodDecorator;
+/**
+ * Decorator to specify required permissions for a route or method
+ *
+ * @param permissions - Array of permission names required to access the resource
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @Permissions('user.create', 'user.update')
+ * @Post('users')
+ * async createUser(@Body() userData: CreateUserDto) {
+ *   // Only users with 'user.create' AND 'user.update' permissions can access
+ * }
+ * ```
+ */
+export declare const Permissions: (...permissions: string[]) => MethodDecorator;
+/**
+ * Decorator to mark a route as public (bypasses authentication guards)
+ *
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @Public()
+ * @Get('health')
+ * async getHealth() {
+ *   // This endpoint is accessible without authentication
+ * }
+ * ```
+ */
+export declare const Public: () => MethodDecorator;
+//# sourceMappingURL=guard.decorators.d.ts.map

package/build/common/decorators/guard.decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.decorators.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/guard.decorators.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,OAAO,MAAM,EAAE,KAAG,eAA8C,CAAC;AAE1F;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,GAAI,GAAG,aAAa,MAAM,EAAE,KAAG,eAA0D,CAAC;AAElH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,QAAO,eAAgD,CAAC"}

package/build/common/decorators/guard.decorators.js

@@ -0,0 +1,49 @@
+import { SetMetadata } from '@nestjs/common';
+/**
+ * Decorator to specify required roles for a route or method
+ *
+ * @param roles - Array of role names required to access the resource
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @Roles('admin', 'moderator')
+ * @Get('admin-only')
+ * async getAdminData() {
+ *   // Only users with 'admin' or 'moderator' roles can access
+ * }
+ * ```
+ */
+export const Roles = (...roles) => SetMetadata('roles', roles);
+/**
+ * Decorator to specify required permissions for a route or method
+ *
+ * @param permissions - Array of permission names required to access the resource
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @Permissions('user.create', 'user.update')
+ * @Post('users')
+ * async createUser(@Body() userData: CreateUserDto) {
+ *   // Only users with 'user.create' AND 'user.update' permissions can access
+ * }
+ * ```
+ */
+export const Permissions = (...permissions) => SetMetadata('permissions', permissions);
+/**
+ * Decorator to mark a route as public (bypasses authentication guards)
+ *
+ * @returns Method decorator
+ *
+ * @example
+ * ```typescript
+ * @Public()
+ * @Get('health')
+ * async getHealth() {
+ *   // This endpoint is accessible without authentication
+ * }
+ * ```
+ */
+export const Public = () => SetMetadata('isPublic', true);
+//# sourceMappingURL=guard.decorators.js.map

package/build/common/decorators/guard.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.decorators.js","sourceRoot":"","sources":["../../../src/common/decorators/guard.decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAG,KAAe,EAAmB,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAE1F;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAG,WAAqB,EAAmB,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;AAElH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,GAAoB,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC"}

package/build/common/decorators/index.d.ts

@@ -0,0 +1,10 @@
+export { RequestProperty } from './request-property.decorator.js';
+export type { RequestPropertyOptions } from './request-property.decorator.js';
+export { CreateRequestPropertyDecorator as createRequestPropertyDecorator, CreateConditionalDecorator as createConditionalDecorator, CreateValidatingDecorator as createValidatingDecorator, CreateTransformingDecorator as createTransformingDecorator, GetRequestFromContext as getRequestFromContext, } from './decorator-factory.js';
+export { ObjectGetPropertyByPath as GetNestedProperty, ObjectGetPropertyByPath as getNestedProperty } from '@pawells/typescript-common';
+export type { BaseDecoratorOptions, ConditionalDecoratorOptions, ValidatingDecoratorOptions, TransformingDecoratorOptions, } from './decorator-factory.js';
+export { Query, Params, Body, Headers, Cookies, } from './common-decorators.js';
+export * from './guard.decorators.js';
+export { InstrumentationRegistryHolder, Instrument } from './instrument.decorator.js';
+export type { InstrumentOptions } from './instrument.decorator.js';
+//# sourceMappingURL=index.d.ts.map

package/build/common/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAG9E,OAAO,EACN,8BAA8B,IAAI,8BAA8B,EAChE,0BAA0B,IAAI,0BAA0B,EACxD,yBAAyB,IAAI,yBAAyB,EACtD,2BAA2B,IAAI,2BAA2B,EAC1D,qBAAqB,IAAI,qBAAqB,GAC9C,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,IAAI,iBAAiB,EAAE,uBAAuB,IAAI,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACxI,YAAY,EACX,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,GAC5B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACN,KAAK,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,OAAO,GACP,MAAM,wBAAwB,CAAC;AAGhC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,6BAA6B,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACtF,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/build/common/decorators/index.js

@@ -0,0 +1,11 @@
+export { RequestProperty } from './request-property.decorator.js';
+// Decorator factories
+export { CreateRequestPropertyDecorator as createRequestPropertyDecorator, CreateConditionalDecorator as createConditionalDecorator, CreateValidatingDecorator as createValidatingDecorator, CreateTransformingDecorator as createTransformingDecorator, GetRequestFromContext as getRequestFromContext, } from './decorator-factory.js';
+export { ObjectGetPropertyByPath as GetNestedProperty, ObjectGetPropertyByPath as getNestedProperty } from '@pawells/typescript-common';
+// Common decorators
+export { Query, Params, Body, Headers, Cookies, } from './common-decorators.js';
+// Guard decorators
+export * from './guard.decorators.js';
+// Instrumentation
+export { InstrumentationRegistryHolder, Instrument } from './instrument.decorator.js';
+//# sourceMappingURL=index.js.map

package/build/common/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,sBAAsB;AACtB,OAAO,EACN,8BAA8B,IAAI,8BAA8B,EAChE,0BAA0B,IAAI,0BAA0B,EACxD,yBAAyB,IAAI,yBAAyB,EACtD,2BAA2B,IAAI,2BAA2B,EAC1D,qBAAqB,IAAI,qBAAqB,GAC9C,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,IAAI,iBAAiB,EAAE,uBAAuB,IAAI,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAQxI,oBAAoB;AACpB,OAAO,EACN,KAAK,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,OAAO,GACP,MAAM,wBAAwB,CAAC;AAEhC,mBAAmB;AACnB,cAAc,uBAAuB,CAAC;AAEtC,kBAAkB;AAClB,OAAO,EAAE,6BAA6B,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}

package/build/common/decorators/instrument.decorator.d.ts

@@ -0,0 +1,128 @@
+import type { InstrumentationRegistry } from '../registry/instrumentation-registry.js';
+/**
+ * Options for the @Instrument() method decorator
+ *
+ * Configures automatic timing, counter, and error tracking for decorated methods.
+ * Metrics are automatically registered on first invocation.
+ *
+ * @example
+ * ```typescript
+ * @Instrument({
+ *   timing: 'user_service_find_by_id_seconds',
+ *   counters: ['user_service_find_by_id_success'],
+ *   errorCounters: ['user_service_find_by_id_error'],
+ *   labels: (userId: string) => ({ userId }),
+ * })
+ * async findById(userId: string): Promise<User> {
+ *   // Implementation
+ * }
+ * ```
+ */
+export interface InstrumentOptions {
+    /**
+     * Name of the histogram metric to record method timing (in seconds).
+     * If provided, timing will be recorded for all invocations.
+     *
+     * @optional
+     */
+    timing?: string;
+    /**
+     * Counter metric names to increment on successful completion.
+     * Incremented after the method returns (or resolves for async).
+     *
+     * @optional
+     */
+    counters?: string[];
+    /**
+     * Counter metric names to increment on exception.
+     * Incremented if the method throws or rejects.
+     *
+     * @optional
+     */
+    errorCounters?: string[];
+    /**
+     * Static labels to attach to all recorded metrics, or a function that extracts labels
+     * from method arguments.
+     *
+     * If a function, it receives the argument array and returns a Record of label values.
+     * Static labels (object) are always used. Function labels are computed per invocation.
+     *
+     * @optional
+     */
+    labels?: Record<string, string | number> | ((...args: unknown[]) => Record<string, string | number>);
+}
+/**
+ * Module-level singleton holder for InstrumentationRegistry.
+ *
+ * The @Instrument() decorator uses this holder to access the registry
+ * without requiring direct DI into every decorated method.
+ *
+ * Set during application bootstrap by CommonModule.onModuleInit().
+ *
+ * @example
+ * ```typescript
+ * // In CommonModule.onModuleInit()
+ * InstrumentationRegistryHolder.setInstance(this.registry);
+ * ```
+ */
+export declare class InstrumentationRegistryHolder {
+    /**
+     * Singleton instance of InstrumentationRegistry
+     * @private
+     */
+    private static instance;
+    /**
+     * Set the singleton instance.
+     * Called during application bootstrap.
+     *
+     * @param registry - The InstrumentationRegistry instance
+     */
+    static setInstance(registry: InstrumentationRegistry): void;
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The InstrumentationRegistry instance, or null if not yet set
+     */
+    static getInstance(): InstrumentationRegistry | null;
+}
+/**
+ * Method decorator for automatic metrics instrumentation.
+ *
+ * Automatically records method timing (histogram), success counters, and error counters
+ * using the InstrumentationRegistry. Metric descriptors are auto-registered on first use.
+ *
+ * Supports both synchronous and asynchronous (Promise-returning) methods.
+ *
+ * @param options - Instrumentation configuration (timing, counters, errorCounters, labels)
+ * @returns MethodDecorator
+ *
+ * @throws Error if a metric name is not registered (only if registry is available)
+ * @throws The original error if the decorated method throws/rejects
+ *
+ * @example
+ * ```typescript
+ * class UserService {
+ *   @Instrument({
+ *     timing: 'user_service_create_duration_seconds',
+ *     counters: ['user_service_create_total'],
+ *     errorCounters: ['user_service_create_errors'],
+ *     labels: { service: 'user' },
+ *   })
+ *   async create(userData: CreateUserDto): Promise<User> {
+ *     return this.repository.save(userData);
+ *   }
+ *
+ *   @Instrument({
+ *     timing: 'user_service_find_by_id_duration_seconds',
+ *     counters: ['user_service_find_by_id_total'],
+ *     errorCounters: ['user_service_find_by_id_errors'],
+ *     labels: (id: string) => ({ userId: id }),
+ *   })
+ *   async findById(id: string): Promise<User | null> {
+ *     return this.repository.findOne(id);
+ *   }
+ * }
+ * ```
+ */
+export declare function Instrument(options: InstrumentOptions): MethodDecorator;
+//# sourceMappingURL=instrument.decorator.d.ts.map

package/build/common/decorators/instrument.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/instrument.decorator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAEvF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;CACrG;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,6BAA6B;IACzC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAwC;IAE/D;;;;;OAKG;WACW,WAAW,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAIlE;;;;OAIG;WACW,WAAW,IAAI,uBAAuB,GAAG,IAAI;CAG3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,eAAe,CAwGtE"}