@alacard-project/shared 1.1.1 → 1.1.4

package/src/dto/logging.dto.ts

@@ -1,101 +0,0 @@
-import { IsOptional, IsString, IsEnum, IsDateString, IsInt, Min, Max } from 'class-validator';
-import { Type } from 'class-transformer';
-import { LogLevel } from '../enums';
-
-export class LogFilterDto {
-    @IsOptional()
-    @IsDateString()
-    startDate?: string;
-
-    @IsOptional()
-    @IsDateString()
-    endDate?: string;
-
-    @IsOptional()
-    @IsString()
-    serviceName?: string;
-
-    @IsOptional()
-    @IsEnum(LogLevel)
-    level?: LogLevel;
-
-    @IsOptional()
-    @IsString()
-    userId?: string;
-
-    @IsOptional()
-    @IsString()
-    requestId?: string;
-
-    @IsOptional()
-    @Type(() => Number)
-    @IsInt()
-    @Min(1)
-    page?: number = 1;
-
-    @IsOptional()
-    @Type(() => Number)
-    @IsInt()
-    @Min(1)
-    @Max(100)
-    pageSize?: number = 20;
-}
-
-export class LogCleanupDto {
-    @IsDateString()
-    startDate!: string;
-
-    @IsDateString()
-    endDate!: string;
-
-    @IsOptional()
-    @IsString()
-    serviceName?: string;
-
-    @IsOptional()
-    @IsEnum(LogLevel)
-    level?: LogLevel;
-}
-
-export class RetentionPeriodDto {
-    @Type(() => Number)
-    @IsInt()
-    @Min(1)
-    @Max(365)
-    retentionDays!: number;
-}
-
-export class UserActionFilterDto {
-    @IsOptional()
-    @IsDateString()
-    startDate?: string;
-
-    @IsOptional()
-    @IsDateString()
-    endDate?: string;
-
-    @IsOptional()
-    @IsString()
-    userId?: string;
-
-    @IsOptional()
-    @IsString()
-    action?: string;
-
-    @IsOptional()
-    @IsString()
-    resource?: string;
-
-    @IsOptional()
-    @Type(() => Number)
-    @IsInt()
-    @Min(1)
-    page?: number = 1;
-
-    @IsOptional()
-    @Type(() => Number)
-    @IsInt()
-    @Min(1)
-    @Max(100)
-    pageSize?: number = 20;
-}

package/src/dto/partner.dto.ts

@@ -1,18 +0,0 @@
-import { IsString, IsOptional, IsBoolean, ValidateNested, IsObject } from 'class-validator';
-import { Type } from 'class-transformer';
-import { RegisterDto } from './auth.dto';
-
-export class PartnerDto {
-    @IsString()
-    name!: string;
-
-    @IsString()
-    type!: string;
-
-    @IsOptional()
-    @IsBoolean()
-    isActive?: boolean;
-    @IsObject()
-    @Type(() => RegisterDto)
-    adminUser?: RegisterDto;
-}

package/src/dto/transaction.dto.ts

@@ -1,52 +0,0 @@
-import { IsString, IsOptional, IsNumber, Min, IsUUID } from 'class-validator';
-import { Type } from 'class-transformer';
-import type { JsonValue } from '../types/common.types';
-
-export class CreateTransactionDto {
-    @IsOptional()
-    @IsString()
-    externalId?: string;
-
-    @IsString()
-    cardId!: string;
-
-    @IsNumber()
-    @Min(0)
-    amount!: number;
-
-    @IsOptional()
-    @IsString()
-    currency?: string;
-
-    @IsOptional()
-    @IsString()
-    description?: string;
-
-    @IsOptional()
-    @IsString()
-    type?: string;
-
-    @IsOptional()
-    @IsString()
-    status?: string;
-
-    @IsOptional()
-    @IsUUID()
-    id?: string;
-
-    @IsOptional()
-    @Type(() => Date)
-    transactionDate?: Date;
-
-    @IsOptional()
-    metadata?: any;
-}
-
-export class UpdateTransactionDto {
-    @IsOptional()
-    @IsString()
-    status?: string;
-
-    @IsOptional()
-    metadata?: JsonValue;
-}

package/src/dto/user.dto.ts

@@ -1,28 +0,0 @@
-import { IsEmail, IsEnum, IsOptional, IsString, IsUUID } from 'class-validator';
-import { UserRole } from '../enums';
-
-export class UserDto {
-    @IsUUID()
-    id!: string;
-
-    @IsEmail()
-    email!: string;
-
-    @IsString()
-    @IsOptional()
-    firstName?: string;
-
-    @IsString()
-    @IsOptional()
-    lastName?: string;
-
-    @IsEnum(UserRole)
-    role!: UserRole;
-
-    @IsString()
-    @IsOptional()
-    phoneNumber?: string;
-
-    createdAt!: Date;
-    updatedAt!: Date;
-}

package/src/enums/auth.enum.ts

@@ -1,13 +0,0 @@
-export enum CredentialStatus {
-    ACTIVE = 'ACTIVE',
-    INACTIVE = 'INACTIVE',
-    LOCKED = 'LOCKED',
-    SUSPENDED = 'SUSPENDED',
-    DELETED = 'DELETED',
-}
-
-export enum ServiceTokenType {
-    API = 'API',
-    INTERNAL = 'INTERNAL',
-    WEBHOOK = 'WEBHOOK',
-}

package/src/enums/env.enum.ts

@@ -1,7 +0,0 @@
-export enum Environment {
-    DEVELOPMENT = 'development',
-    STAGING = 'staging',
-    PRODUCTION = 'production',
-    TEST = 'test',
-    LOCAL = 'local',
-}

package/src/enums/error.enum.ts

@@ -1,28 +0,0 @@
-export enum ErrorCode {
-    // Auth Errors
-    AUTH_USER_NOT_FOUND = 'AUTH_USER_NOT_FOUND',
-    AUTH_USER_ALREADY_EXISTS = 'AUTH_USER_ALREADY_EXISTS',
-    AUTH_USER_INACTIVE = 'AUTH_USER_INACTIVE',
-    AUTH_INVALID_PASSWORD = 'AUTH_INVALID_PASSWORD',
-    AUTH_INVALID_TOKEN = 'AUTH_INVALID_TOKEN',
-    AUTH_TOKEN_EXPIRED = 'AUTH_TOKEN_EXPIRED',
-    AUTH_ACCESS_DENIED = 'AUTH_ACCESS_DENIED',
-    AUTH_INSUFFICIENT_SCOPES = 'AUTH_INSUFFICIENT_SCOPES',
-    AUTH_INVALID_CREDENTIALS = 'AUTH_INVALID_CREDENTIALS',
-
-    // Config Errors
-    CONFIG_NOT_FOUND = 'CONFIG_NOT_FOUND',
-    CONFIG_LOAD_FAILED = 'CONFIG_LOAD_FAILED',
-
-    // Logging Errors
-    LOG_WRITE_FAILED = 'LOG_WRITE_FAILED',
-    LOG_READ_FAILED = 'LOG_READ_FAILED',
-
-    // General Errors
-    INTERNAL_SERVER_ERROR = 'INTERNAL_SERVER_ERROR',
-    BAD_REQUEST = 'BAD_REQUEST',
-    NOT_FOUND = 'NOT_FOUND',
-    VALIDATION_ERROR = 'VALIDATION_ERROR',
-    AUTH_USER_BLOCKED = 'AUTH_USER_BLOCKED',
-    INVALID_TOKEN = 'INVALID_TOKEN',
-}

package/src/enums/events.enum.ts

@@ -1,22 +0,0 @@
-export enum ServiceEventType {
-    AUTH_USER_REGISTERED = 'auth.user.registered',
-    AUTH_USER_LOGGED_IN = 'auth.user.logged_in',
-    AUTH_PASSWORD_RESET_REQUESTED = 'auth.password_reset_requested',
-    AUTH_PASSWORD_RESET_SUCCESS = 'auth.password_reset_success',
-    USER_PROFILE_UPDATED = 'user.profile_updated',
-    USER_DELETED = 'user.deleted',
-    AUTH_USER_BLOCKED = 'auth.user.blocked',
-}
-
-export interface AuthUserRegisteredEvent {
-    userId: string;
-    email: string;
-    role: string;
-    occurredAt: Date;
-}
-
-export interface AuthUserBlockedEvent {
-    userId: string;
-    reason?: string;
-    blockedAt: Date;
-}

package/src/enums/health.enum.ts

@@ -1,7 +0,0 @@
-export enum ServiceHealth {
-    UP = 'UP',
-    HEALTHY = 'UP',
-    DOWN = 'DOWN',
-    DEGRADED = 'DEGRADED',
-    MAINTENANCE = 'MAINTENANCE',
-}

package/src/enums/iam.enum.ts

@@ -1,28 +0,0 @@
-/**
- * Subject Type Enum
- * Defines the type of subject in the system (immutable after creation)
- */
-export enum SubjectType {
-    EMPLOYEE = 'EMPLOYEE',
-    CLIENT = 'CLIENT',
-    PARTNER = 'PARTNER',
-}
-
-/**
- * Identifier Type Enum
- * Defines the type of login identifier used for authentication
- */
-export enum IdentifierType {
-    EMAIL = 'EMAIL',
-    USERNAME = 'USERNAME',
-}
-
-/**
- * Identity Status Enum
- * Defines the status of an identity in the IAM system
- */
-export enum IdentityStatus {
-    ACTIVE = 'ACTIVE',
-    BLOCKED = 'BLOCKED',
-    DELETED = 'DELETED',
-}

package/src/enums/index.ts

@@ -1,10 +0,0 @@
-export * from './env.enum';
-export * from './user.enum';
-export * from './iam.enum';
-export * from './health.enum';
-export * from './logging.enum';
-export * from './notification.enum';
-export * from './error.enum';
-export * from './auth.enum';
-export * from './permission.enum';
-export * from './events.enum';

package/src/enums/logging.enum.ts

@@ -1,7 +0,0 @@
-export enum LogLevel {
-    DEBUG = 'DEBUG',
-    INFO = 'INFO',
-    WARN = 'WARN',
-    ERROR = 'ERROR',
-    FATAL = 'FATAL',
-}

package/src/enums/notification.enum.ts

@@ -1,5 +0,0 @@
-export enum NotificationType {
-    EMAIL = 'EMAIL',
-    SMS = 'SMS',
-    PUSH = 'PUSH',
-}

package/src/enums/permission.enum.ts

@@ -1,31 +0,0 @@
-export enum PermissionScope {
-    // User Management
-    USERS_VIEW = 'users:view',
-    USERS_MANAGE = 'users:manage',
-
-    // Auth Management
-    ROLES_MANAGE = 'roles:manage',
-    PERMISSIONS_MANAGE = 'permissions:manage',
-
-    // Client Management
-    CLIENTS_VIEW = 'clients:view',
-    CLIENTS_MANAGE = 'clients:manage',
-
-    // Partner Management
-    PARTNERS_VIEW = 'partners:view',
-    PARTNERS_MANAGE = 'partners:manage',
-
-    // Financial/Accounting
-    INVOICES_VIEW = 'invoices:view',
-    INVOICES_MANAGE = 'invoices:manage',
-    TRANSACTIONS_VIEW = 'transactions:view',
-    TRANSACTIONS_MANAGE = 'transactions:manage',
-
-    // System Config
-    CONFIG_VIEW = 'config:view',
-    CONFIG_MANAGE = 'config:manage',
-
-    // Logging/Monitoring
-    LOGS_VIEW = 'logs:view',
-    METRICS_VIEW = 'metrics:view',
-}

package/src/enums/user.enum.ts

@@ -1,27 +0,0 @@
-export enum UserRole {
-    SUPER_ADMIN = 'SUPER_ADMIN',
-    ADMIN = 'ADMIN',
-    MANAGER = 'MANAGER',
-    ACCOUNTANT = 'ACCOUNTANT',
-    PARTNER = 'PARTNER',
-    CLIENT = 'CLIENT',
-}
-
-export enum UserStatus {
-    ACTIVE = 'ACTIVE',
-    INACTIVE = 'INACTIVE',
-    PENDING = 'PENDING',
-    SUSPENDED = 'SUSPENDED',
-    BLOCKED = 'BLOCKED',
-}
-
-export enum UserScope {
-    READ = 'READ',
-    WRITE = 'WRITE',
-    DELETE = 'DELETE',
-    ADMIN = 'ADMIN',
-    PROFILE_READ = 'PROFILE_READ',
-    CARDS_READ = 'CARDS_READ',
-    TRANSACTIONS_READ = 'TRANSACTIONS_READ',
-    LOGS_READ = 'LOGS_READ',
-}

package/src/errors/app.error.ts

@@ -1,33 +0,0 @@
-import { ErrorCode } from '../enums/error.enum';
-import { ERROR_MAP } from './error-map';
-
-export class AppError extends Error {
-    public readonly code: ErrorCode;
-    public readonly statusCode: number;
-    public readonly description?: string;
-    public readonly metadata?: any;
-
-    constructor(code: ErrorCode, customMessage?: string, metadata?: any) {
-        const errorDetail = ERROR_MAP[code] || ERROR_MAP[ErrorCode.INTERNAL_SERVER_ERROR];
-        super(customMessage || errorDetail.message);
-
-        this.code = code;
-        this.statusCode = errorDetail.statusCode;
-        this.description = errorDetail.description;
-        this.metadata = metadata;
-
-        Object.setPrototypeOf(this, AppError.prototype);
-    }
-
-    toJSON() {
-        return {
-            success: false,
-            error: {
-                code: this.code,
-                message: this.message,
-                description: this.description,
-                metadata: this.metadata,
-            },
-        };
-    }
-}

package/src/errors/error-map.ts

@@ -1,105 +0,0 @@
-import { ErrorCode } from '../enums/error.enum';
-
-export interface ErrorDetail {
-    message: string;
-    statusCode: number;
-    description?: string;
-}
-
-export const ERROR_MAP: Record<ErrorCode, ErrorDetail> = {
-    [ErrorCode.AUTH_USER_NOT_FOUND]: {
-        message: 'User not found',
-        statusCode: 404,
-        description: 'The requested user could not be found in the system.',
-    },
-    [ErrorCode.AUTH_USER_ALREADY_EXISTS]: {
-        message: 'User already exists',
-        statusCode: 409,
-        description: 'A user with this email already exists.',
-    },
-    [ErrorCode.AUTH_USER_INACTIVE]: {
-        message: 'User is inactive',
-        statusCode: 403,
-        description: 'The user account is currently deactivated.',
-    },
-    [ErrorCode.AUTH_INVALID_PASSWORD]: {
-        message: 'Invalid password',
-        statusCode: 401,
-        description: 'The provided password does not match.',
-    },
-    [ErrorCode.AUTH_INVALID_TOKEN]: {
-        message: 'Invalid token',
-        statusCode: 401,
-        description: 'The provided authentication token is invalid or malformed.',
-    },
-    [ErrorCode.AUTH_TOKEN_EXPIRED]: {
-        message: 'Token expired',
-        statusCode: 401,
-        description: 'The authentication token has expired. Please log in again.',
-    },
-    [ErrorCode.AUTH_ACCESS_DENIED]: {
-        message: 'Access denied',
-        statusCode: 403,
-        description: 'You do not have permission to perform this action.',
-    },
-    [ErrorCode.AUTH_INSUFFICIENT_SCOPES]: {
-        message: 'Insufficient scopes',
-        statusCode: 403,
-        description: 'Your token does not have the required scopes for this resource.',
-    },
-    [ErrorCode.AUTH_INVALID_CREDENTIALS]: {
-        message: 'Invalid credentials',
-        statusCode: 401,
-        description: 'The email or password you entered is incorrect.',
-    },
-    [ErrorCode.CONFIG_NOT_FOUND]: {
-        message: 'Configuration not found',
-        statusCode: 404,
-        description: 'The requested configuration key was not found.',
-    },
-    [ErrorCode.CONFIG_LOAD_FAILED]: {
-        message: 'Configuration load failed',
-        statusCode: 500,
-        description: 'Failed to load configuration from the source.',
-    },
-    [ErrorCode.LOG_WRITE_FAILED]: {
-        message: 'Log write failed',
-        statusCode: 500,
-        description: 'Failed to write log to the destination.',
-    },
-    [ErrorCode.LOG_READ_FAILED]: {
-        message: 'Log read failed',
-        statusCode: 500,
-        description: 'Failed to read logs from the source.',
-    },
-    [ErrorCode.INTERNAL_SERVER_ERROR]: {
-        message: 'Internal server error',
-        statusCode: 500,
-        description: 'An unexpected error occurred on the server.',
-    },
-    [ErrorCode.BAD_REQUEST]: {
-        message: 'Bad request',
-        statusCode: 400,
-        description: 'The request is invalid or cannot be served.',
-    },
-    [ErrorCode.NOT_FOUND]: {
-        message: 'Resource not found',
-        statusCode: 404,
-        description: 'The requested resource could not be found.',
-    },
-    [ErrorCode.VALIDATION_ERROR]: {
-        message: 'Validation error',
-        statusCode: 422,
-        description: 'The provided data failed validation.',
-    },
-    [ErrorCode.AUTH_USER_BLOCKED]: {
-        message: 'User blocked',
-        statusCode: 403,
-        description: 'The user account has been blocked.',
-    },
-    [ErrorCode.INVALID_TOKEN]: {
-        message: 'Invalid token',
-        statusCode: 401,
-        description: 'The provided token is invalid.',
-    },
-};

package/src/filters/http-exception.filter.ts

@@ -1,49 +0,0 @@
-
-import { ExceptionFilter, Catch, ArgumentsHost, HttpException, HttpStatus, Logger } from '@nestjs/common';
-import { Request, Response } from 'express';
-
-@Catch()
-export class HttpExceptionFilter implements ExceptionFilter {
-    private readonly logger = new Logger(HttpExceptionFilter.name);
-
-    catch(exception: unknown, host: ArgumentsHost) {
-        const ctx = host.switchToHttp();
-        const response = ctx.getResponse<Response>();
-        const request = ctx.getRequest<Request>();
-
-        const status =
-            exception instanceof HttpException
-                ? exception.getStatus()
-                : HttpStatus.INTERNAL_SERVER_ERROR;
-
-        const message =
-            exception instanceof HttpException
-                ? exception.getResponse()
-                : 'Internal server error';
-
-        // Determine the actual error message string
-        const errorMessage = typeof message === 'string'
-            ? message
-            : (message as any).message || message;
-
-        // Log the error
-        if (status >= 500) {
-            this.logger.error(
-                `[${request.method}] ${request.url} - ${status} - ${JSON.stringify(errorMessage)}`,
-                exception instanceof Error ? exception.stack : '',
-            );
-        } else {
-            this.logger.warn(
-                `[${request.method}] ${request.url} - ${status} - ${JSON.stringify(errorMessage)}`,
-            );
-        }
-
-        response.status(status).json({
-            statusCode: status,
-            timestamp: new Date().toISOString(),
-            path: request.url,
-            method: request.method,
-            error: errorMessage,
-        });
-    }
-}

package/src/filters/index.ts

@@ -1,2 +0,0 @@
-
-export * from './http-exception.filter';

package/src/index.ts

@@ -1,17 +0,0 @@
-export * from './enums';
-export * from './constants';
-export * from './types';
-export * from './contracts';
-export * from './dto';
-export * from './errors/app.error';
-export * from './errors/error-map';
-export * from './decorators';
-export * from './utils/proto-path';
-export * from './utils/user.utils';
-export * from './utils/app.utils';
-export * from './utils/health.utils';
-export * from './filters';
-export * from './interceptors';
-export * from './observability';
-export * from './resilience/resilience.module';
-export * from './resilience/circuit-breaker.service';

package/src/interceptors/index.ts

@@ -1,3 +0,0 @@
-
-export * from './logging.interceptor';
-export * from './transform.interceptor';

package/src/interceptors/logging.interceptor.ts

@@ -1,37 +0,0 @@
-
-import { Injectable, NestInterceptor, ExecutionContext, CallHandler, Logger } from '@nestjs/common';
-import { Observable } from 'rxjs';
-import { tap } from 'rxjs/operators';
-import { randomUUID } from 'crypto';
-import { Request, Response } from 'express';
-
-@Injectable()
-export class LoggingInterceptor implements NestInterceptor {
-    private readonly logger = new Logger(LoggingInterceptor.name);
-
-    intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
-        const httpContext = context.switchToHttp();
-        const request = httpContext.getRequest<Request>();
-        const response = httpContext.getResponse<Response>();
-
-        const userAgent = request.get('user-agent') || '';
-        const { ip, method, path: url } = request;
-
-        // Generate or retrieve Trace ID
-        const traceId = request.headers['x-request-id'] || randomUUID();
-        request.headers['x-request-id'] = traceId as string;
-        response.setHeader('x-request-id', traceId);
-
-        this.logger.log(`[${traceId}] Incoming Request: ${method} ${url} - ${userAgent} ${ip}`);
-
-        const now = Date.now();
-        return next
-            .handle()
-            .pipe(
-                tap(() => {
-                    const duration = Date.now() - now;
-                    this.logger.log(`[${traceId}] Response Sent: ${method} ${url} ${response.statusCode} - ${duration}ms`);
-                }),
-            );
-    }
-}

package/src/interceptors/transform.interceptor.ts

@@ -1,21 +0,0 @@
-
-import { Injectable, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
-import { Observable } from 'rxjs';
-import { map } from 'rxjs/operators';
-
-export interface Response<T> {
-    statusCode: number;
-    data: T;
-}
-
-@Injectable()
-export class TransformInterceptor<T> implements NestInterceptor<T, Response<T>> {
-    intercept(context: ExecutionContext, next: CallHandler): Observable<Response<T>> {
-        return next.handle().pipe(
-            map(data => ({
-                statusCode: context.switchToHttp().getResponse().statusCode,
-                data,
-            })),
-        );
-    }
-}

package/src/observability/index.ts

@@ -1,3 +0,0 @@
-
-export * from './metrics/metrics.module';
-export * from './tracing';