@flusys/nestjs-shared 1.1.0-beta → 1.2.0-rc.1

package/fesm/decorators/require-permission.decorator.js

@@ -1,75 +1,27 @@
 import { SetMetadata } from '@nestjs/common';
 import { PERMISSIONS_KEY } from '../constants';
-/**
- * Decorator to require specific permissions for a route
- *
- * By default uses AND logic (user must have ALL permissions).
- * This is the most common and secure pattern.
- *
- * @param permissions - One or more permission keys required (AND logic)
- *
- * @example
- * // Require single permission
- * @RequirePermission('users.read')
- *
- * @example
- * // Require ALL permissions (AND)
- * @RequirePermission('users.read', 'users.write')
- *
- * @example
- * // For OR logic, use RequireAnyPermission instead
- * @RequireAnyPermission('admin.access', 'manager.access')
- */ export const RequirePermission = (...permissions)=>SetMetadata(PERMISSIONS_KEY, {
+/** Require ALL permissions (AND logic) - most secure pattern */ export const RequirePermission = (...permissions)=>SetMetadata(PERMISSIONS_KEY, {
         permissions,
-        operator: 'and'
+        operator: 'AND'
     });
-/**
- * Decorator to require ANY of the specified permissions (OR logic)
- *
- * User must have at least ONE of the specified permissions.
- * Less secure than RequirePermission (AND), use carefully.
- *
- * @param permissions - User must have at least ONE of these permissions
- *
- * @example
- * @RequireAnyPermission('admin.access', 'manager.access')
- */ export const RequireAnyPermission = (...permissions)=>SetMetadata(PERMISSIONS_KEY, {
+/** Require ANY permission (OR logic) - use carefully */ export const RequireAnyPermission = (...permissions)=>SetMetadata(PERMISSIONS_KEY, {
         permissions,
-        operator: 'or'
+        operator: 'OR'
     });
 /**
- * Decorator for complex permission conditions with nested logic
- *
- * Supports building complex permission trees:
- * - AND/OR operators
- * - Nested children for complex logic
- *
- * @param condition - Complex permission condition
- *
- * @example
- * // Simple: User needs 'admin' OR 'manager'
- * @RequirePermissionCondition({
- *   operator: 'or',
- *   permissions: ['admin', 'manager'],
- * })
- *
+ * Require complex permission logic using ILogicNode tree
  * @example
- * // Complex: User needs 'users.read' AND ('admin' OR 'manager')
- * @RequirePermissionCondition({
- *   operator: 'and',
- *   permissions: ['users.read'],
- *   children: [
- *     { operator: 'or', permissions: ['admin', 'manager'] }
- *   ]
- * })
- *
+ * // Single permission
+ * @RequirePermissionLogic('users.read')
  * @example
- * // Very complex: (A AND B) OR (C AND D)
- * @RequirePermissionCondition({
- *   operator: 'or',
- *   children: [
- *     { operator: 'and', permissions: ['finance.read', 'finance.write'] },
- *     { operator: 'and', permissions: ['admin.full', 'reports.access'] }
- *   ]
+ * // Complex: users.read AND (admin OR manager)
+ * @RequirePermissionLogic({
+ *   type: 'group', operator: 'AND', children: [
+ *     { type: 'action', actionId: 'users.read' },
+ *     { type: 'group', operator: 'OR', children: [
+ *       { type: 'action', actionId: 'admin' },
+ *       { type: 'action', actionId: 'manager' },
+ *     ]},
+ *   ],
  * })
- */ export const RequirePermissionCondition = (condition)=>SetMetadata(PERMISSIONS_KEY, condition);
+ */ export const RequirePermissionLogic = (logic)=>SetMetadata(PERMISSIONS_KEY, logic);

package/fesm/dtos/delete.dto.js

@@ -20,12 +20,13 @@ function _ts_decorate(decorators, target, key, desc) {
 function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-import { ApiProperty } from '@nestjs/swagger';
-import { IsIn, IsNotEmpty } from 'class-validator';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsIn, IsNotEmpty, IsOptional, IsUUID } from 'class-validator';
 export class DeleteDto {
     constructor(){
         _define_property(this, "id", void 0);
         _define_property(this, "type", void 0);
+        _define_property(this, "deletedById", void 0);
     }
 }
 _ts_decorate([
@@ -70,3 +71,12 @@ _ts_decorate([
     ]),
     _ts_metadata("design:type", String)
 ], DeleteDto.prototype, "type", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        description: 'User ID who initiated the deletion (auto-set by interceptor)',
+        example: 'f2e9c8d0-7a2a-11eb-9439-0242ac130002'
+    }),
+    IsOptional(),
+    IsUUID(),
+    _ts_metadata("design:type", String)
+], DeleteDto.prototype, "deletedById", void 0);

package/fesm/dtos/filter-and-pagination.dto.js

@@ -22,27 +22,15 @@ function _ts_metadata(k, v) {
 }
 import { ApiPropertyOptional } from '@nestjs/swagger';
 import { Type } from 'class-transformer';
-import { IsArray, IsBoolean, IsObject, IsOptional, ValidateNested } from 'class-validator';
+import { IsArray, IsBoolean, IsObject, IsOptional, IsString, Matches, MaxLength, ValidateNested } from 'class-validator';
 import { PaginationDto } from './pagination.dto';
-/**
- * DTO for filtering and pagination in get-all requests
- *
- * @example
- * {
- *   "filter": { "isActive": true, "category": "electronics" },
- *   "pagination": { "currentPage": 0, "pageSize": 10 },
- *   "sort": { "createdAt": "DESC" },
- *   "select": ["id", "name", "price"],
- *   "withDeleted": false
- * }
- */ export class FilterAndPaginationDto {
+export class FilterAndPaginationDto {
     constructor(){
         _define_property(this, "filter", void 0);
         _define_property(this, "pagination", void 0);
         _define_property(this, "sort", void 0);
         _define_property(this, "select", void 0);
         _define_property(this, "withDeleted", void 0);
-        _define_property(this, "extraKey", void 0);
     }
 }
 _ts_decorate([
@@ -90,7 +78,7 @@ _ts_decorate([
         type: [
             String
         ],
-        description: 'Fields to return. If empty, returns all fields.',
+        description: 'Fields to return. Must be valid field names (alphanumeric, underscores only). If empty, returns all fields.',
         example: [
             'id',
             'name',
@@ -100,6 +88,17 @@ _ts_decorate([
     }),
     IsOptional(),
     IsArray(),
+    IsString({
+        each: true
+    }),
+    Matches(/^[a-zA-Z_][a-zA-Z0-9_]*$/, {
+        each: true,
+        message: 'Select fields must be valid identifiers (alphanumeric and underscores only)'
+    }),
+    MaxLength(64, {
+        each: true,
+        message: 'Field names must be 64 characters or less'
+    }),
     _ts_metadata("design:type", Array)
 ], FilterAndPaginationDto.prototype, "select", void 0);
 _ts_decorate([
@@ -112,27 +111,11 @@ _ts_decorate([
     IsBoolean(),
     _ts_metadata("design:type", Boolean)
 ], FilterAndPaginationDto.prototype, "withDeleted", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        type: [
-            String
-        ],
-        description: 'Additional relation keys to include',
-        example: [
-            'category',
-            'createdBy'
-        ]
-    }),
-    IsOptional(),
-    IsArray(),
-    _ts_metadata("design:type", Array)
-], FilterAndPaginationDto.prototype, "extraKey", void 0);
 /**
  * DTO for get-by-id request body
  */ export class GetByIdBodyDto {
     constructor(){
         _define_property(this, "select", void 0);
-        _define_property(this, "extraKey", void 0);
     }
 }
 _ts_decorate([
@@ -140,7 +123,7 @@ _ts_decorate([
         type: [
             String
         ],
-        description: 'Fields to return. If empty, returns all fields.',
+        description: 'Fields to return. Must be valid field names (alphanumeric, underscores only). If empty, returns all fields.',
         example: [
             'id',
             'name',
@@ -150,20 +133,16 @@ _ts_decorate([
     }),
     IsOptional(),
     IsArray(),
-    _ts_metadata("design:type", Array)
-], GetByIdBodyDto.prototype, "select", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        type: [
-            String
-        ],
-        description: 'Additional relation keys to include',
-        example: [
-            'category',
-            'createdBy'
-        ]
+    IsString({
+        each: true
+    }),
+    Matches(/^[a-zA-Z_][a-zA-Z0-9_]*$/, {
+        each: true,
+        message: 'Select fields must be valid identifiers (alphanumeric and underscores only)'
+    }),
+    MaxLength(64, {
+        each: true,
+        message: 'Field names must be 64 characters or less'
     }),
-    IsOptional(),
-    IsArray(),
     _ts_metadata("design:type", Array)
-], GetByIdBodyDto.prototype, "extraKey", void 0);
+], GetByIdBodyDto.prototype, "select", void 0);

package/fesm/dtos/get-by-ids.dto.js

@@ -0,0 +1,55 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsArray, IsNotEmpty, IsOptional, IsUUID } from 'class-validator';
+export class GetByIdsDto {
+    constructor(){
+        _define_property(this, "ids", void 0);
+        _define_property(this, "select", void 0);
+    }
+}
+_ts_decorate([
+    ApiProperty({
+        description: 'Array of IDs to retrieve',
+        type: [
+            String
+        ],
+        example: [
+            'uuid-1',
+            'uuid-2'
+        ]
+    }),
+    IsNotEmpty(),
+    IsArray(),
+    IsUUID('all', {
+        each: true
+    }),
+    _ts_metadata("design:type", Array)
+], GetByIdsDto.prototype, "ids", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        description: 'Select specific fields to return (comma-separated or array)'
+    }),
+    IsOptional(),
+    _ts_metadata("design:type", Object)
+], GetByIdsDto.prototype, "select", void 0);

package/fesm/dtos/identity-response.dto.js

@@ -20,8 +20,8 @@ function _ts_decorate(decorators, target, key, desc) {
 function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-import { Expose, Type } from 'class-transformer';
 import { ApiProperty } from '@nestjs/swagger';
+import { Expose, Type } from 'class-transformer';
 export class IdentityResponseDto {
     constructor(){
         _define_property(this, "id", void 0);
@@ -34,28 +34,28 @@ export class IdentityResponseDto {
     }
 }
 _ts_decorate([
+    Expose(),
     ApiProperty({
         type: String,
         format: 'uuid'
     }),
-    Expose(),
     _ts_metadata("design:type", String)
 ], IdentityResponseDto.prototype, "id", void 0);
 _ts_decorate([
+    Expose(),
     ApiProperty({
         type: String,
         format: 'date-time'
     }),
-    Expose(),
     Type(()=>Date),
     _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
 ], IdentityResponseDto.prototype, "createdAt", void 0);
 _ts_decorate([
+    Expose(),
     ApiProperty({
         type: String,
         format: 'date-time'
     }),
-    Expose(),
     Type(()=>Date),
     _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
 ], IdentityResponseDto.prototype, "updatedAt", void 0);
@@ -66,7 +66,6 @@ _ts_decorate([
         nullable: true,
         required: false
     }),
-    Expose(),
     Type(()=>Date),
     _ts_metadata("design:type", Object)
 ], IdentityResponseDto.prototype, "deletedAt", void 0);
@@ -77,7 +76,6 @@ _ts_decorate([
         nullable: true,
         required: false
     }),
-    Expose(),
     _ts_metadata("design:type", Object)
 ], IdentityResponseDto.prototype, "createdById", void 0);
 _ts_decorate([
@@ -87,7 +85,6 @@ _ts_decorate([
         nullable: true,
         required: false
     }),
-    Expose(),
     _ts_metadata("design:type", Object)
 ], IdentityResponseDto.prototype, "updatedById", void 0);
 _ts_decorate([
@@ -97,6 +94,5 @@ _ts_decorate([
         nullable: true,
         required: false
     }),
-    Expose(),
     _ts_metadata("design:type", Object)
 ], IdentityResponseDto.prototype, "deletedById", void 0);

package/fesm/dtos/index.js

@@ -1,5 +1,6 @@
 export * from './delete.dto';
 export * from './filter-and-pagination.dto';
+export * from './get-by-ids.dto';
 export * from './identity-response.dto';
 export * from './pagination.dto';
 export * from './response-payload.dto';

package/fesm/dtos/pagination.dto.js

@@ -25,17 +25,13 @@ import { Transform } from 'class-transformer';
 import { IsNumber, IsOptional } from 'class-validator';
 export class PaginationDto {
     constructor(){
-        /**
-   * Number of items per page. Defaults to 10 when not provided or invalid.
-   */ _define_property(this, "pageSize", 10);
-        /**
-   * Zero-based page index. Defaults to 0 when not provided or invalid.
-   */ _define_property(this, "currentPage", 0);
+        _define_property(this, "pageSize", 10);
+        _define_property(this, "currentPage", 0);
     }
 }
 _ts_decorate([
     ApiPropertyOptional({
-        description: 'Number of items per page. Defaults to 10 when not provided or invalid.',
+        description: 'Number of items per page (default: 10)',
         example: 10
     }),
     IsOptional(),
@@ -48,7 +44,7 @@ _ts_decorate([
 ], PaginationDto.prototype, "pageSize", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        description: 'Zero-based page index. Defaults to 0 when not provided or invalid.',
+        description: 'Zero-based page index (default: 0)',
         example: 0
     }),
     IsOptional(),

package/fesm/dtos/response-payload.dto.js

@@ -50,6 +50,8 @@ export class SingleResponseDto {
     constructor(){
         _define_property(this, "success", void 0);
         _define_property(this, "message", void 0);
+        _define_property(this, "messageKey", void 0);
+        _define_property(this, "messageVariables", void 0);
         _define_property(this, "data", void 0);
         _define_property(this, "_meta", void 0);
     }
@@ -66,6 +68,22 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", String)
 ], SingleResponseDto.prototype, "message", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        example: 'user.create.success',
+        description: 'Translation key for localization'
+    }),
+    _ts_metadata("design:type", String)
+], SingleResponseDto.prototype, "messageKey", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        example: {
+            name: 'John'
+        },
+        description: 'Variables for message interpolation'
+    }),
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], SingleResponseDto.prototype, "messageVariables", void 0);
 _ts_decorate([
     ApiPropertyOptional(),
     _ts_metadata("design:type", typeof T === "undefined" ? Object : T)
@@ -129,6 +147,8 @@ export class ListResponseDto {
     constructor(){
         _define_property(this, "success", void 0);
         _define_property(this, "message", void 0);
+        _define_property(this, "messageKey", void 0);
+        _define_property(this, "messageVariables", void 0);
         _define_property(this, "data", void 0);
         _define_property(this, "meta", void 0);
         _define_property(this, "_meta", void 0);
@@ -146,6 +166,22 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", String)
 ], ListResponseDto.prototype, "message", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        example: 'user.list.success',
+        description: 'Translation key for localization'
+    }),
+    _ts_metadata("design:type", String)
+], ListResponseDto.prototype, "messageKey", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        example: {
+            count: 10
+        },
+        description: 'Variables for message interpolation'
+    }),
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], ListResponseDto.prototype, "messageVariables", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         isArray: true
@@ -196,6 +232,8 @@ export class BulkResponseDto {
     constructor(){
         _define_property(this, "success", void 0);
         _define_property(this, "message", void 0);
+        _define_property(this, "messageKey", void 0);
+        _define_property(this, "messageVariables", void 0);
         _define_property(this, "data", void 0);
         _define_property(this, "meta", void 0);
         _define_property(this, "_meta", void 0);
@@ -213,6 +251,22 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", String)
 ], BulkResponseDto.prototype, "message", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        example: 'user.bulk.success',
+        description: 'Translation key for localization'
+    }),
+    _ts_metadata("design:type", String)
+], BulkResponseDto.prototype, "messageKey", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        example: {
+            count: 5
+        },
+        description: 'Variables for message interpolation'
+    }),
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], BulkResponseDto.prototype, "messageVariables", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         isArray: true
@@ -238,6 +292,8 @@ export class MessageResponseDto {
     constructor(){
         _define_property(this, "success", void 0);
         _define_property(this, "message", void 0);
+        _define_property(this, "messageKey", void 0);
+        _define_property(this, "messageVariables", void 0);
         _define_property(this, "_meta", void 0);
     }
 }
@@ -255,117 +311,26 @@ _ts_decorate([
 ], MessageResponseDto.prototype, "message", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        type: RequestMetaDto
-    }),
-    _ts_metadata("design:type", typeof RequestMetaDto === "undefined" ? Object : RequestMetaDto)
-], MessageResponseDto.prototype, "_meta", void 0);
-MessageResponseDto = _ts_decorate([
-    ApiExtraModels()
-], MessageResponseDto);
-export class ValidationErrorDto {
-    constructor(){
-        _define_property(this, "field", void 0);
-        _define_property(this, "message", void 0);
-        _define_property(this, "constraint", void 0);
-    }
-}
-_ts_decorate([
-    ApiProperty({
-        example: 'email'
+        example: 'user.delete.success',
+        description: 'Translation key for localization'
     }),
     _ts_metadata("design:type", String)
-], ValidationErrorDto.prototype, "field", void 0);
-_ts_decorate([
-    ApiProperty({
-        example: 'Invalid email format'
-    }),
-    _ts_metadata("design:type", String)
-], ValidationErrorDto.prototype, "message", void 0);
+], MessageResponseDto.prototype, "messageKey", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        example: 'isEmail'
+        example: {
+            count: 3
+        },
+        description: 'Variables for message interpolation'
     }),
-    _ts_metadata("design:type", String)
-], ValidationErrorDto.prototype, "constraint", void 0);
-export class ErrorResponseDto {
-    constructor(){
-        _define_property(this, "success", void 0);
-        _define_property(this, "message", void 0);
-        _define_property(this, "code", void 0);
-        _define_property(this, "errors", void 0);
-        _define_property(this, "_meta", void 0);
-    }
-}
-_ts_decorate([
-    ApiProperty({
-        example: false
-    }),
-    _ts_metadata("design:type", Boolean)
-], ErrorResponseDto.prototype, "success", void 0);
-_ts_decorate([
-    ApiProperty({
-        example: 'Validation failed'
-    }),
-    _ts_metadata("design:type", String)
-], ErrorResponseDto.prototype, "message", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        example: 'VALIDATION_ERROR'
-    }),
-    _ts_metadata("design:type", String)
-], ErrorResponseDto.prototype, "code", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        type: [
-            ValidationErrorDto
-        ]
-    }),
-    _ts_metadata("design:type", Array)
-], ErrorResponseDto.prototype, "errors", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        type: RequestMetaDto
-    }),
-    _ts_metadata("design:type", typeof RequestMetaDto === "undefined" ? Object : RequestMetaDto)
-], ErrorResponseDto.prototype, "_meta", void 0);
-ErrorResponseDto = _ts_decorate([
-    ApiExtraModels()
-], ErrorResponseDto);
-export class ResponsePayloadDto {
-    constructor(){
-        _define_property(this, "success", void 0);
-        _define_property(this, "message", void 0);
-        _define_property(this, "data", void 0);
-        _define_property(this, "meta", void 0);
-        _define_property(this, "_meta", void 0);
-    }
-}
-_ts_decorate([
-    ApiProperty({
-        example: true
-    }),
-    _ts_metadata("design:type", Boolean)
-], ResponsePayloadDto.prototype, "success", void 0);
-_ts_decorate([
-    ApiProperty({
-        example: 'Operation successful'
-    }),
-    _ts_metadata("design:type", String)
-], ResponsePayloadDto.prototype, "message", void 0);
-_ts_decorate([
-    ApiPropertyOptional(),
-    _ts_metadata("design:type", typeof T === "undefined" ? Object : T)
-], ResponsePayloadDto.prototype, "data", void 0);
-_ts_decorate([
-    ApiPropertyOptional(),
-    _ts_metadata("design:type", Object)
-], ResponsePayloadDto.prototype, "meta", void 0);
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], MessageResponseDto.prototype, "messageVariables", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         type: RequestMetaDto
     }),
     _ts_metadata("design:type", typeof RequestMetaDto === "undefined" ? Object : RequestMetaDto)
-], ResponsePayloadDto.prototype, "_meta", void 0);
-ResponsePayloadDto = _ts_decorate([
+], MessageResponseDto.prototype, "_meta", void 0);
+MessageResponseDto = _ts_decorate([
     ApiExtraModels()
-], ResponsePayloadDto);
+], MessageResponseDto);