@alacard-project/shared 1.0.4 → 1.0.6

package/src/constants/env.constants.ts

@@ -6,29 +6,35 @@ export const ENV_KEYS = {
     REDIS_PORT: 'REDIS_PORT',
     REDIS_PASSWORD: 'REDIS_PASSWORD',
     KAFKA_BROKERS: 'KAFKA_BROKERS',
-    RABBITMQ_URL: 'RABBITMQ_URL',
     JWT_SECRET: 'JWT_SECRET',
     JWT_EXPIRES_IN: 'JWT_EXPIRES_IN',
     JWT_REFRESH_EXPIRES_IN: 'JWT_REFRESH_EXPIRES_IN',
     GRPC_PORT: 'GRPC_PORT',
     GRPC_URL: 'GRPC_URL',
+
     LOGGING_PROTO_PATH: 'LOGGING_PROTO_PATH',
+    USER_PROTO_PATH: 'USER_PROTO_PATH',
+    AUTH_PROTO_PATH: 'AUTH_PROTO_PATH',
+    CLIENT_PROTO_PATH: 'CLIENT_PROTO_PATH',
+    CARD_PROTO_PATH: 'CARD_PROTO_PATH',
+    TRANSACTION_PROTO_PATH: 'TRANSACTION_PROTO_PATH',
+    TOKEN_PROTO_PATH: 'TOKEN_PROTO_PATH',
+
+    LOGGING_SERVICE_URL: 'LOGGING_SERVICE_URL',
+    CONFIG_SERVICE_URL: 'CONFIG_SERVICE_URL',
+    USER_SERVICE_URL: 'USER_SERVICE_URL',
+    AUTH_SERVICE_URL: 'AUTH_SERVICE_URL',
+    NOTIFICATION_SERVICE_URL: 'NOTIFICATION_SERVICE_URL',
+    TOKEN_SERVICE_URL: 'TOKEN_SERVICE_URL',
+
+    CONFIG_SERVICE_ENABLED: 'CONFIG_SERVICE_ENABLED',
     INTERNAL_CONFIG_KEY: 'INTERNAL_CONFIG_KEY',
     RATE_LIMIT_TTL: 'RATE_LIMIT_TTL',
     RATE_LIMIT_MAX: 'RATE_LIMIT_MAX',
-    NOTIFICATION_SERVICE_URL: 'NOTIFICATION_SERVICE_URL',
+
     LOG_FILE_PATH: 'LOG_FILE_PATH',
     LOG_RETENTION_DAYS: 'LOG_RETENTION_DAYS',
     CORS_ORIGINS: 'CORS_ORIGINS',
-    USER_SERVICE_URL: 'USER_SERVICE_URL',
-    USER_PROTO_PATH: 'USER_PROTO_PATH',
-    AUTH_SERVICE_URL: 'AUTH_SERVICE_URL',
-    AUTH_PROTO_PATH: 'AUTH_PROTO_PATH',
-    LOGGING_SERVICE_URL: 'LOGGING_SERVICE_URL',
-    TOKEN_SERVICE_URL: 'TOKEN_SERVICE_URL',
-    TOKEN_PROTO_PATH: 'TOKEN_PROTO_PATH',
-    CONFIG_SERVICE_URL: 'CONFIG_SERVICE_URL',
-    CONFIG_SERVICE_ENABLED: 'CONFIG_SERVICE_ENABLED',
 } as const;
 
 export const ENV_VALUES = {

package/src/constants/grpc.constants.ts

@@ -3,6 +3,7 @@ export const GRPC_PACKAGES = {
     CONFIG: 'config',
     AUTH: 'auth',
     USER: 'user',
+    TOKEN: 'token',
 } as const;
 
 export const GRPC_METHODS = {

package/src/constants/index.ts

@@ -1,6 +1,5 @@
 export * from './env.constants';
 export * from './http.constants';
-export * from './logging.constants';
 export * from './microservices.constants';
 export * from './grpc.constants';
 export * from './error-messages';
@@ -8,6 +7,4 @@ export * from './auth.constants';
 export * from './logging-messages.constants';
 export * from './routes.constants';
 export * from './common.constants';
-export * from './tokens.constants';
 export * from './auth-config.constants';
-export * from './monitoring.constants';

package/src/constants/logging-messages.constants.ts

@@ -12,4 +12,32 @@ export const LOGGING_MESSAGES = {
     CONFIG_RELOADED: 'Configuration successfully reloaded',
     VAULT_CONNECTED: 'Connected to HashiCorp Vault',
     VAULT_CONNECTION_FAILED: 'Failed to connect to HashiCorp Vault',
+
+    LOGIN_FAILED: 'Login failed',
+    LOGIN_ATTEMPT_INACTIVE_USER: 'Login attempt from inactive user',
+    USER_VALIDATED: 'User validated',
+    USER_VALIDATION_FAILED: 'User validation failed',
+    JWT_PAYLOAD_VALIDATED: 'JWT payload validated',
+    JWT_PAYLOAD_VALIDATION_FAILED: 'JWT payload validation failed',
+    JWT_VALIDATION_ERROR: 'JWT validation error',
+    REGISTRATION_ATTEMPT_EXISTING_EMAIL: 'Registration attempt with existing email',
+    REGISTRATION_FAILED: 'Registration failed',
+    REFRESH_TOKEN_INVALID: 'Refresh token invalid',
+    REFRESH_TOKEN_REVOKED: 'Refresh token revoked',
+    REFRESH_TOKEN_REVOKED_MANUALLY: 'Refresh token revoked manually',
+    REFRESH_TOKEN_REVOKE_ATTEMPT_FAILED: 'Refresh token revoke attempt failed',
+    TOKEN_REVOKE_ERROR: 'Token revoke error',
+    PERMISSION_CHECK_PERFORMED: 'Permission check performed',
+    PERMISSION_CHECK_ERROR: 'Permission check error',
+    USER_PERMISSIONS_RETRIEVED: 'User permissions retrieved',
+    USER_PERMISSIONS_RETRIEVAL_ERROR: 'User permissions retrieval error',
+
+    INVITATION_CREATED: 'Invitation created',
+    INVITATION_VALIDATED: 'Invitation validated',
+    INVITATION_VALIDATION_FAILED: 'Invitation validation failed',
+    INVITATION_USED: 'Invitation used',
+
+    PASSWORD_RESET_TOKEN_CREATED: 'Password reset token created',
+    PASSWORD_RESET_SUCCESSFUL: 'Password reset successful',
+    PASSWORD_RESET_FAILED: 'Password reset failed',
 };

package/src/constants/microservices.constants.ts

@@ -1,18 +1,62 @@
 export const MICROSERVICES = {
     CONFIG: {
-        SERVICE_NAME: 'CONFIG_SERVICE',
+        SERVICE_NAME: 'ConfigService',
         PACKAGE: 'config',
     },
     LOGGING: {
-        SERVICE_NAME: 'LOGGING_SERVICE',
+        SERVICE_NAME: 'LoggingService',
         PACKAGE: 'logging',
     },
+    KAFKA: {
+        SERVICE_NAME: 'KafkaService',
+        PACKAGE: 'kafka',
+    },
     AUTH: {
-        SERVICE_NAME: 'AUTH_SERVICE',
+        SERVICE_NAME: 'AuthService',
         PACKAGE: 'auth',
     },
     USER: {
-        SERVICE_NAME: 'USER_SERVICE',
+        SERVICE_NAME: 'UserService',
         PACKAGE: 'user',
     },
+    CLIENT: {
+        SERVICE_NAME: 'ClientService',
+        PACKAGE: 'client',
+    },
+    CARD: {
+        SERVICE_NAME: 'CardService',
+        PACKAGE: 'card',
+    },
+    TRANSACTION: {
+        SERVICE_NAME: 'TransactionService',
+        PACKAGE: 'transaction',
+    },
+    ACCOUNT: {
+        SERVICE_NAME: 'AccountService',
+        PACKAGE: 'account',
+    },
+    INVOICE: {
+        SERVICE_NAME: 'InvoiceService',
+        PACKAGE: 'invoice',
+    },
+    NOTIFICATION: {
+        SERVICE_NAME: 'NotificationService',
+        PACKAGE: 'notification',
+    },
+    ATTACHMENT: {
+        SERVICE_NAME: 'AttachmentService',
+        PACKAGE: 'attachment',
+    },
+    TERMINAL: {
+        SERVICE_NAME: 'TerminalService',
+        PACKAGE: 'terminal',
+    },
+    PARTNER: {
+        SERVICE_NAME: 'PartnerService',
+        PACKAGE: 'partner',
+    },
+    TOKEN: {
+        SERVICE_NAME: 'TokenService',
+        PACKAGE: 'token',
+    },
 } as const;

package/src/contracts/auth.contract.ts

@@ -1,3 +1,7 @@
+import { Observable } from 'rxjs';
+import { RegisterDto, LoginDto } from '../dto/auth.dto';
+import { JwtTokens } from '../types/auth.types';
+
 export interface GetUserByIdGrpcRequest {
     userId: string;
 }
@@ -96,3 +100,16 @@ export type GetUserByIdRequest = GetUserByIdGrpcRequest;
 export type GetUserByEmailRequest = GetUserByEmailGrpcRequest;
 export type GetUserPermissionsRequest = GetUserPermissionsGrpcRequest;
 export type DeleteUserResponse = { success: boolean };
+
+export interface IAuthService {
+    loginGrpc(data: LoginDto): Observable<JwtTokens>;
+    registerGrpc(data: RegisterDto): Observable<any>;
+    validateGrpc(data: { token: string }): Observable<{ valid: boolean; userId?: string; email?: string; role?: string }>;
+    validateTokenGrpc(data: ValidateTokenGrpcRequest): Observable<ValidateTokenGrpcResponse>;
+    refreshTokenGrpc(data: RefreshTokenGrpcRequest): Observable<JwtTokens>;
+    revokeTokenGrpc(data: RevokeTokenGrpcRequest): Observable<RevokeTokenGrpcResponse>;
+    checkPermissionGrpc(data: CheckPermissionGrpcRequest): Observable<CheckPermissionGrpcResponse>;
+    getUserPermissionsGrpc(data: GetUserPermissionsGrpcRequest): Observable<GetUserPermissionsGrpcResponse>;
+    getUserByIdGrpc(data: GetUserByIdGrpcRequest): Observable<GetUserByIdGrpcResponse>;
+    getUserByEmailGrpc(data: GetUserByEmailGrpcRequest): Observable<GetUserByEmailGrpcResponse>;
+}

package/src/contracts/index.ts

@@ -1,3 +1,4 @@
 export * from './config.contract';
 export * from './logging.contract';
 export * from './auth.contract';
+export * from './token.contract';

package/src/contracts/token.contract.ts

@@ -0,0 +1,47 @@
+import { Observable } from 'rxjs';
+
+export interface GenerateTokensRequest {
+    userId: string;
+    email: string;
+    role: string;
+    scopes?: string[];
+}
+
+export interface TokensResponse {
+    accessToken: string;
+    refreshToken: string;
+    expiresIn: number;
+}
+
+export interface ValidateTokenRequest {
+    token: string;
+}
+
+export interface ValidateTokenResponse {
+    isValid: boolean;
+    userId: string;
+    role: string;
+    scopes: string[];
+}
+
+export interface RefreshTokensRequest {
+    refreshToken: string;
+    userAgent?: string;
+    ipAddress?: string;
+}
+
+export interface RevokeTokenRequest {
+    userId: string;
+    refreshToken: string;
+}
+
+export interface RevokeTokenResponse {
+    success: boolean;
+}
+
+export interface ITokenService {
+    generateTokens(request: GenerateTokensRequest): Observable<TokensResponse>;
+    validateToken(request: ValidateTokenRequest): Observable<ValidateTokenResponse>;
+    refreshTokens(request: RefreshTokensRequest): Observable<TokensResponse>;
+    revokeToken(request: RevokeTokenRequest): Observable<RevokeTokenResponse>;
+}

package/src/decorators/index.ts

@@ -0,0 +1,3 @@
+export * from './scopes.decorator';
+export * from './roles.decorator';
+export * from './permissions.decorator';

package/src/decorators/permissions.decorator.ts

@@ -0,0 +1,5 @@
+import { SetMetadata } from '@nestjs/common';
+import { PermissionScope } from '../enums/permission.enum';
+
+export const PERMISSIONS_KEY = 'permissions';
+export const Permissions = (...permissions: PermissionScope[]) => SetMetadata(PERMISSIONS_KEY, permissions);

package/src/decorators/roles.decorator.ts

@@ -0,0 +1,5 @@
+import { SetMetadata } from '@nestjs/common';
+import { UserRole } from '../enums/user.enum';
+
+export const ROLES_KEY = 'roles';
+export const Roles = (...roles: UserRole[]) => SetMetadata(ROLES_KEY, roles);

package/src/dto/auth.dto.ts

@@ -20,6 +20,10 @@ export class RegisterDto {
     @IsString()
     @IsOptional()
     lastName?: string;
+
+    @IsString()
+    @IsOptional()
+    userId?: string;
 }
 
 export class LoginDto {
@@ -60,3 +64,30 @@ export interface UserProfileDto {
     department: string;
     emailVerified: boolean;
 }
+
+export class InviteRequestBody {
+    @IsEmail()
+    email!: string;
+
+    @IsEnum(UserRole)
+    role!: UserRole;
+}
+
+export class RegisterByInviteBody extends RegisterDto {
+    @IsString()
+    token!: string;
+}
+
+export class ResetPasswordRequestBody {
+    @IsEmail()
+    email!: string;
+}
+
+export class ResetPasswordConfirmBody {
+    @IsString()
+    token!: string;
+
+    @IsString()
+    @MinLength(8)
+    newPassword!: string;
+}

package/src/dto/card.dto.ts

@@ -0,0 +1,64 @@
+import { IsString, IsOptional, IsNumber, IsDate } from 'class-validator';
+import { Type } from 'class-transformer';
+
+export class CreateCardDto {
+    @IsString()
+    cardNumber: string;
+
+    @IsOptional()
+    @IsString()
+    clientId?: string;
+
+    @IsOptional()
+    @IsString()
+    accountId?: string;
+
+    @IsOptional()
+    @IsString()
+    cardType?: string;
+
+    @IsOptional()
+    @IsString()
+    cardStatus?: string;
+
+    @IsOptional()
+    @Type(() => Date)
+    @IsDate()
+    issuedAt?: Date;
+
+    @IsOptional()
+    @Type(() => Date)
+    @IsDate()
+    expiresAt?: Date;
+
+    @IsOptional()
+    @IsNumber()
+    balance?: number;
+}
+
+export class UpdateCardDto {
+    @IsOptional()
+    @IsString()
+    clientId?: string;
+
+    @IsOptional()
+    @IsString()
+    accountId?: string;
+
+    @IsOptional()
+    @IsString()
+    cardType?: string;
+
+    @IsOptional()
+    @IsString()
+    cardStatus?: string;
+
+    @IsOptional()
+    @Type(() => Date)
+    @IsDate()
+    expiresAt?: Date;
+
+    @IsOptional()
+    @IsNumber()
+    balance?: number;
+}

package/src/dto/client.dto.ts

@@ -0,0 +1,137 @@
+import { IsString, IsOptional, IsBoolean, IsArray, ValidateNested, IsNumber, IsEnum, IsObject } from 'class-validator';
+import { Type } from 'class-transformer';
+import { RegisterDto } from './auth.dto';
+
+export class CreateClientContactDto {
+    @IsString()
+    contactType: string;
+
+    @IsString()
+    value: string;
+
+    @IsOptional()
+    @IsBoolean()
+    isPrimary?: boolean;
+}
+
+export class CreateClientDetailDto {
+    @IsString()
+    detailType: string;
+
+    @IsString()
+    value: string;
+
+    @IsOptional()
+    @IsBoolean()
+    isActive?: boolean;
+}
+
+export class CreateClientDto {
+    @IsString()
+    clientNumber: string;
+
+    @IsOptional()
+    @IsString()
+    clientNumberFormatted?: string;
+
+    @IsString()
+    clientType: string;
+
+    @IsOptional()
+    @IsString()
+    shortName?: string;
+
+    @IsString()
+    fullName: string;
+
+    @IsOptional()
+    @IsBoolean()
+    isActive?: boolean;
+
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => CreateClientContactDto)
+    contacts?: CreateClientContactDto[];
+
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => CreateClientDetailDto)
+    details?: CreateClientDetailDto[];
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => RegisterDto)
+    adminUser?: RegisterDto;
+}
+
+export class UpdateClientDto {
+    @IsOptional()
+    @IsString()
+    clientNumber?: string;
+
+    @IsOptional()
+    @IsString()
+    clientNumberFormatted?: string;
+
+    @IsOptional()
+    @IsString()
+    clientType?: string;
+
+    @IsOptional()
+    @IsString()
+    shortName?: string;
+
+    @IsOptional()
+    @IsString()
+    fullName?: string;
+
+    @IsOptional()
+    @IsBoolean()
+    isActive?: boolean;
+
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => CreateClientContactDto)
+    contacts?: CreateClientContactDto[];
+
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => CreateClientDetailDto)
+    details?: CreateClientDetailDto[];
+}
+
+export class FindClientsQueryDto {
+    @IsOptional()
+    @IsString()
+    search?: string;
+
+    @IsOptional()
+    @IsString()
+    searchType?: string;
+
+    @IsOptional()
+    @IsString()
+    status?: string;
+
+    @IsOptional()
+    @Type(() => Number)
+    @IsNumber()
+    skip?: number;
+
+    @IsOptional()
+    @Type(() => Number)
+    @IsNumber()
+    take?: number;
+
+    @IsOptional()
+    @IsString()
+    sortBy?: string;
+
+    @IsOptional()
+    @IsString()
+    sortOrder?: 'asc' | 'desc';
+}

package/src/dto/index.ts

@@ -1,2 +1,6 @@
 export * from './logging.dto';
 export * from './auth.dto';
+export * from './client.dto';
+export * from './transaction.dto';
+export * from './card.dto';
+export * from './partner.dto';

package/src/dto/partner.dto.ts

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

package/src/dto/transaction.dto.ts

@@ -0,0 +1,51 @@
+import { IsString, IsOptional, IsNumber, Min, IsUUID } from 'class-validator';
+import { Type } from 'class-transformer';
+
+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?: any;
+}

package/src/enums/error.enum.ts

@@ -23,4 +23,6 @@ export enum ErrorCode {
     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/user.enum.ts

@@ -5,4 +5,24 @@ export enum UserRole {
     ACCOUNTANT = 'ACCOUNTANT',
     PARTNER = 'PARTNER',
     CLIENT = 'CLIENT',
+    USER = 'USER',
+}
+
+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/error-map.ts

@@ -92,4 +92,14 @@ export const ERROR_MAP: Record<ErrorCode, ErrorDetail> = {
         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/index.ts

@@ -5,11 +5,8 @@ export * from './contracts';
 export * from './dto';
 export * from './errors/app.error';
 export * from './errors/error-map';
-export * from './decorators/scopes.decorator';
+export * from './decorators';
 export * from './utils/proto-path';
-export * from './utils/logging-client';
-export * from './config/base-config.service';
 export * from './utils/user.utils';
-export * from './utils/prometheus.utils';
 export * from './utils/app.utils';
 export * from './utils/health.utils';

package/src/types/auth.types.ts

@@ -12,3 +12,8 @@ export interface JwtTokens {
     refreshToken: string;
     expiresIn: number;
 }
+
+export interface AuthenticatedRequest {
+    user: any;
+    [key: string]: any;
+}