@flusys/nestjs-shared 1.1.0 → 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/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/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);
     }
 }
@@ -253,6 +309,22 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", String)
 ], MessageResponseDto.prototype, "message", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        example: 'user.delete.success',
+        description: 'Translation key for localization'
+    }),
+    _ts_metadata("design:type", String)
+], MessageResponseDto.prototype, "messageKey", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        example: {
+            count: 3
+        },
+        description: 'Variables for message interpolation'
+    }),
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], MessageResponseDto.prototype, "messageVariables", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         type: RequestMetaDto

package/fesm/entities/identity.js

@@ -39,14 +39,16 @@ _ts_decorate([
 _ts_decorate([
     CreateDateColumn({
         name: 'created_at',
-        type: 'timestamp'
+        type: 'timestamp',
+        select: false
     }),
     _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
 ], Identity.prototype, "createdAt", void 0);
 _ts_decorate([
     UpdateDateColumn({
         name: 'updated_at',
-        type: 'timestamp'
+        type: 'timestamp',
+        select: false
     }),
     _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
 ], Identity.prototype, "updatedAt", void 0);
@@ -54,6 +56,7 @@ _ts_decorate([
     DeleteDateColumn({
         name: 'deleted_at',
         type: 'timestamp',
+        select: false,
         nullable: true
     }),
     _ts_metadata("design:type", Object)
@@ -62,6 +65,7 @@ _ts_decorate([
     Column({
         name: 'created_by_id',
         type: 'uuid',
+        select: false,
         nullable: true
     }),
     _ts_metadata("design:type", Object)
@@ -70,6 +74,7 @@ _ts_decorate([
     Column({
         name: 'updated_by_id',
         type: 'uuid',
+        select: false,
         nullable: true
     }),
     _ts_metadata("design:type", Object)
@@ -78,6 +83,7 @@ _ts_decorate([
     Column({
         name: 'deleted_by_id',
         type: 'uuid',
+        select: false,
         nullable: true
     }),
     _ts_metadata("design:type", Object)

package/fesm/entities/index.js

@@ -1,2 +1,3 @@
 export * from './identity';
+export * from './raw-type';
 export * from './user-root';

package/fesm/entities/raw-type.js

@@ -0,0 +1 @@
+export { };

package/fesm/entities/user-root.js

@@ -20,6 +20,7 @@ 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 { getJsonColumnType } from '@flusys/nestjs-shared';
 import { Column, CreateDateColumn, DeleteDateColumn, PrimaryGeneratedColumn, UpdateDateColumn } from 'typeorm';
 export class UserRoot {
     constructor(){
@@ -124,7 +125,7 @@ _ts_decorate([
 ], UserRoot.prototype, "lastLoginAt", void 0);
 _ts_decorate([
     Column({
-        type: 'json',
+        type: getJsonColumnType(),
         nullable: true,
         name: 'additional_fields'
     }),

package/fesm/enums/index.js

@@ -0,0 +1,3 @@
+export * from './notification-type.enum';
+export * from './participant-status.enum';
+export * from './recurrence-type.enum';

package/fesm/enums/notification-type.enum.js

@@ -0,0 +1,7 @@
+export var NotificationType = /*#__PURE__*/ function(NotificationType) {
+    NotificationType["INFO"] = "info";
+    NotificationType["WARNING"] = "warning";
+    NotificationType["SUCCESS"] = "success";
+    NotificationType["ERROR"] = "error";
+    return NotificationType;
+}({});

package/fesm/enums/participant-status.enum.js

@@ -0,0 +1,7 @@
+export var ParticipantStatus = /*#__PURE__*/ function(ParticipantStatus) {
+    ParticipantStatus["PENDING"] = "pending";
+    ParticipantStatus["ACCEPTED"] = "accepted";
+    ParticipantStatus["DECLINED"] = "declined";
+    ParticipantStatus["TENTATIVE"] = "tentative";
+    return ParticipantStatus;
+}({});

package/fesm/enums/recurrence-type.enum.js

@@ -0,0 +1,8 @@
+export var RecurrenceType = /*#__PURE__*/ function(RecurrenceType) {
+    RecurrenceType["NONE"] = "none";
+    RecurrenceType["DAILY"] = "daily";
+    RecurrenceType["WEEKLY"] = "weekly";
+    RecurrenceType["BIWEEKLY"] = "biweekly";
+    RecurrenceType["MONTHLY"] = "monthly";
+    return RecurrenceType;
+}({});

package/fesm/exceptions/base-app.exception.js

@@ -0,0 +1,115 @@
+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;
+}
+import { HttpException, HttpStatus } from '@nestjs/common';
+import { ERROR_MESSAGES } from '../constants/message-keys';
+export class BaseAppException extends HttpException {
+    constructor(options){
+        const status = options.status || HttpStatus.BAD_REQUEST;
+        super({
+            success: false,
+            message: options.message,
+            messageKey: options.messageKey || ERROR_MESSAGES.GENERIC,
+            messageVariables: options.messageVariables,
+            errors: options.errors
+        }, status), _define_property(this, "messageKey", void 0), _define_property(this, "messageVariables", void 0), _define_property(this, "errors", void 0), _define_property(this, "metadata", void 0);
+        this.messageKey = options.messageKey || ERROR_MESSAGES.GENERIC;
+        this.messageVariables = options.messageVariables;
+        this.errors = options.errors;
+        this.metadata = options.metadata;
+    }
+}
+export class NotFoundException extends BaseAppException {
+    constructor(entity, id){
+        super({
+            message: id ? `${entity} with id "${id}" not found` : `${entity} not found`,
+            messageKey: ERROR_MESSAGES.NOT_FOUND,
+            status: HttpStatus.NOT_FOUND,
+            metadata: {
+                entity,
+                id
+            }
+        });
+    }
+}
+export class ValidationException extends BaseAppException {
+    constructor(errors){
+        super({
+            message: 'Validation failed',
+            messageKey: ERROR_MESSAGES.VALIDATION,
+            status: HttpStatus.BAD_REQUEST,
+            errors
+        });
+    }
+}
+export class UnauthorizedException extends BaseAppException {
+    constructor(message = 'Unauthorized access'){
+        super({
+            message,
+            messageKey: ERROR_MESSAGES.UNAUTHORIZED,
+            status: HttpStatus.UNAUTHORIZED
+        });
+    }
+}
+export class ForbiddenException extends BaseAppException {
+    constructor(message = 'Access forbidden'){
+        super({
+            message,
+            messageKey: ERROR_MESSAGES.FORBIDDEN,
+            status: HttpStatus.FORBIDDEN
+        });
+    }
+}
+export class ConflictException extends BaseAppException {
+    constructor(entity, field){
+        super({
+            message: field ? `${entity} with this ${field} already exists` : `${entity} already exists`,
+            messageKey: ERROR_MESSAGES.CONFLICT,
+            messageVariables: {
+                entity,
+                ...field !== undefined && {
+                    field
+                }
+            },
+            status: HttpStatus.CONFLICT,
+            metadata: {
+                entity,
+                field
+            }
+        });
+    }
+}
+export class InternalServerException extends BaseAppException {
+    constructor(message = 'Internal server error'){
+        super({
+            message,
+            messageKey: ERROR_MESSAGES.INTERNAL,
+            status: HttpStatus.INTERNAL_SERVER_ERROR
+        });
+    }
+}
+export class ServiceUnavailableException extends BaseAppException {
+    constructor(service){
+        super({
+            message: `${service} is temporarily unavailable`,
+            messageKey: ERROR_MESSAGES.SERVICE_UNAVAILABLE,
+            messageVariables: {
+                service
+            },
+            status: HttpStatus.SERVICE_UNAVAILABLE,
+            metadata: {
+                service
+            }
+        });
+    }
+}

package/fesm/exceptions/index.js

@@ -1 +1,2 @@
+export * from './base-app.exception';
 export * from './permission.exception';

package/fesm/exceptions/permission.exception.js

@@ -1,37 +1,35 @@
 import { ForbiddenException, InternalServerErrorException } from '@nestjs/common';
-/**
- * Exception thrown when permission system is unavailable
- */ export class PermissionSystemUnavailableException extends InternalServerErrorException {
-    constructor(message = 'Permission system temporarily unavailable. Please try again later.'){
+import { ERROR_MESSAGES } from '../constants/message-keys';
+export class PermissionSystemUnavailableException extends InternalServerErrorException {
+    constructor(){
         super({
             success: false,
-            message,
-            code: 'PERMISSION_SYSTEM_UNAVAILABLE'
+            message: 'Permission system temporarily unavailable',
+            messageKey: ERROR_MESSAGES.PERMISSION_SYSTEM_UNAVAILABLE
         });
     }
 }
-/**
- * Exception thrown when user lacks required permissions
- */ export class InsufficientPermissionsException extends ForbiddenException {
-    constructor(missingPermissions, operator = 'and'){
-        const message = operator === 'or' ? `Requires at least one of: ${missingPermissions.join(', ')}` : `Missing required permissions: ${missingPermissions.join(', ')}`;
+export class InsufficientPermissionsException extends ForbiddenException {
+    constructor(missingPermissions, operator = 'AND'){
+        const messageKey = operator === 'OR' ? ERROR_MESSAGES.INSUFFICIENT_PERMISSIONS_OR : ERROR_MESSAGES.INSUFFICIENT_PERMISSIONS;
         super({
             success: false,
-            message,
-            code: 'INSUFFICIENT_PERMISSIONS',
+            message: 'Insufficient permissions',
+            messageKey,
+            messageVariables: {
+                permissions: missingPermissions.join(', ')
+            },
             missingPermissions,
             operator
         });
     }
 }
-/**
- * Exception thrown when no permissions found for user
- */ export class NoPermissionsFoundException extends ForbiddenException {
+export class NoPermissionsFoundException extends ForbiddenException {
     constructor(){
         super({
             success: false,
-            message: 'No permissions found. Please contact administrator.',
-            code: 'NO_PERMISSIONS_FOUND'
+            message: 'No permissions found',
+            messageKey: ERROR_MESSAGES.NO_PERMISSIONS_FOUND
         });
     }
 }