@alacard-project/shared 1.0.0

package/src/contracts/logging.contract.ts

@@ -0,0 +1,115 @@
+export interface LogEventGrpcRequest {
+    serviceId: string;
+    serviceName: string;
+    level: string;
+    message: string;
+    metadata: string;
+    userId?: string;
+    requestId?: string;
+}
+
+export interface LogEventGrpcResponse {
+    success: boolean;
+    logId: string;
+}
+
+export interface LogUserActionGrpcRequest {
+    userId: string;
+    userName: string;
+    action: string;
+    resource: string;
+    details?: string;
+    ipAddress?: string;
+    userAgent?: string;
+}
+
+export interface LogUserActionGrpcResponse {
+    success: boolean;
+    actionId: string;
+}
+
+export interface UpdateServiceStatusGrpcRequest {
+    serviceName: string;
+    status: string;
+    version?: string;
+    uptime?: number;
+    metadata?: string;
+}
+
+export interface UpdateServiceStatusGrpcResponse {
+    success: boolean;
+    statusId: string;
+}
+
+export interface GetServiceLogsGrpcRequest {
+    serviceName?: string;
+    level?: string;
+    userId?: string;
+    requestId?: string;
+    startDate?: string;
+    endDate?: string;
+    limit?: number;
+    offset?: number;
+}
+
+export interface ServiceLogEntry {
+    id: string;
+    serviceId: string;
+    serviceName: string;
+    level: string;
+    message: string;
+    metadata: string;
+    timestamp: string;
+    userId?: string;
+    requestId?: string;
+}
+
+export interface GetServiceLogsGrpcResponse {
+    logs: ServiceLogEntry[];
+    total: number;
+}
+
+export interface GetServiceStatusGrpcRequest {
+    serviceName?: string;
+}
+
+export interface ServiceStatusEntry {
+    id: string;
+    serviceName: string;
+    status: string;
+    lastHeartbeat: string;
+    version?: string;
+    uptime?: number;
+    metadata?: string;
+}
+
+export interface GetServiceStatusGrpcResponse {
+    statuses: ServiceStatusEntry[];
+}
+
+export interface GetUserActionsGrpcRequest {
+    userId?: string;
+    action?: string;
+    resource?: string;
+    startDate?: string;
+    endDate?: string;
+    limit?: number;
+    offset?: number;
+}
+
+export interface UserActionEntry {
+    id: string;
+    userId: string;
+    userName: string;
+    action: string;
+    resource: string;
+    details: string;
+    timestamp: string;
+    ipAddress?: string;
+    userAgent?: string;
+}
+
+export interface GetUserActionsGrpcResponse {
+    actions: UserActionEntry[];
+    total: number;
+}

package/src/enums/environment.enum.ts

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

package/src/enums/error-code.enum.ts

@@ -0,0 +1,8 @@
+export enum ErrorCode {
+    INTERNAL_ERROR = 'INTERNAL_ERROR',
+    VALIDATION_ERROR = 'VALIDATION_ERROR',
+    AUTHENTICATION_ERROR = 'AUTHENTICATION_ERROR',
+    AUTHORIZATION_ERROR = 'AUTHORIZATION_ERROR',
+    NOT_FOUND = 'NOT_FOUND',
+    INVALID_TOKEN = 'INVALID_TOKEN',
+}

package/src/enums/index.ts

@@ -0,0 +1,5 @@
+export * from './environment.enum';
+export * from './user-role.enum';
+export * from './log-level.enum';
+export * from './notification-type.enum';
+export * from './error-code.enum';

package/src/enums/log-level.enum.ts

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

package/src/enums/notification-type.enum.ts

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

package/src/enums/user-role.enum.ts

@@ -0,0 +1,6 @@
+export enum UserRole {
+    ADMIN = 'ADMIN',
+    PARTNER = 'PARTNER',
+    CLIENT = 'CLIENT',
+    USER = 'USER',
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+export * from './enums';
+export * from './constants';
+export * from './types';
+export * from './contracts';
+export * from './utils/proto-path';
+export * from './logging';

package/src/logging/dto/log-filter.dto.ts

@@ -0,0 +1,101 @@
+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/logging/index.ts

@@ -0,0 +1 @@
+export * from './dto/log-filter.dto';

package/src/types/auth.types.ts

@@ -0,0 +1,9 @@
+export interface JwtPayload {
+    sub: string;
+    email: string;
+    role: string;
+    scopes: string[];
+    iat?: number;
+    exp?: number;
+    iss?: string;
+}

package/src/types/config.types.ts

@@ -0,0 +1,30 @@
+export interface IBaseConfig {
+    environment: string;
+}
+
+export interface DbConfig {
+    url: string;
+    poolSize?: number;
+}
+
+export interface RedisConfig {
+    host: string;
+    port: number;
+    password?: string;
+}
+
+export interface BrokerConfig {
+    brokers: string[];
+}
+
+export interface AppConfig {
+    port: number;
+    host?: string;
+    serviceName: string;
+    environment?: string;
+    version?: string;
+    description?: string;
+    databaseUrl?: string;
+    rabbitMqUrl?: string;
+    [key: string]: any;
+}

package/src/types/index.ts

@@ -0,0 +1,3 @@
+export * from './config.types';
+export * from './auth.types';
+// ErrorCode moved to enums

package/src/utils/proto-path.ts

@@ -0,0 +1,15 @@
+import { join } from 'path';
+
+/**
+ * Returns the absolute path to a proto file.
+ * Assumes protos are in the 'proto' directory at the shared library root.
+ */
+export function getProtoPath(serviceName: string): string {
+    // In Docker/Production, this might be absolute
+    if (process.env.PROTO_PATH_OVERRIDE) {
+        return join(process.env.PROTO_PATH_OVERRIDE, `${serviceName}.proto`);
+    }
+
+    // Default path relative to the shared/proto directory
+    return join(__dirname, '../../proto', `${serviceName}.proto`);
+}

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "declaration": true,
+        "removeComments": true,
+        "emitDecoratorMetadata": true,
+        "experimentalDecorators": true,
+        "allowSyntheticDefaultImports": true,
+        "target": "es2021",
+        "sourceMap": true,
+        "outDir": "./dist",
+        "baseUrl": "./src",
+        "incremental": true,
+        "skipLibCheck": true,
+        "strict": false
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}