@alacard-project/shared 1.0.0 → 1.0.3

package/dist/utils/logging-client.d.ts

@@ -0,0 +1,7 @@
+export declare class LoggingClient {
+    logInfo(message: string, context?: any): void;
+    logWarn(message: string, context?: any): void;
+    logError(message: string, context?: any): void;
+    logUserAction(userId: string, email: string, action: string, resource: string, details?: any): void;
+    updateServiceStatus(serviceName: string, status: string, version: string, uptime: number, metadata?: string): void;
+}

package/dist/utils/logging-client.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggingClient = void 0;
+class LoggingClient {
+    logInfo(message, context) {
+        console.log(`[INFO] ${message}`, context || '');
+    }
+    logWarn(message, context) {
+        console.warn(`[WARN] ${message}`, context || '');
+    }
+    logError(message, context) {
+        console.error(`[ERROR] ${message}`, context || '');
+    }
+    logUserAction(userId, email, action, resource, details) {
+        console.log(`[USER_ACTION] ${action} by ${email} (${userId}) on ${resource}`, details || '');
+    }
+    updateServiceStatus(serviceName, status, version, uptime, metadata) {
+        console.log(`[SERVICE_STATUS] ${serviceName} is ${status} (v${version}, uptime: ${uptime}s)`, metadata || '');
+    }
+}
+exports.LoggingClient = LoggingClient;
+//# sourceMappingURL=logging-client.js.map

package/dist/utils/logging-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-client.js","sourceRoot":"","sources":["../../src/utils/logging-client.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAa;IACtB,OAAO,CAAC,OAAe,EAAE,OAAa;QAClC,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,CAAC,OAAe,EAAE,OAAa;QAClC,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,QAAQ,CAAC,OAAe,EAAE,OAAa;QACnC,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,aAAa,CAAC,MAAc,EAAE,KAAa,EAAE,MAAc,EAAE,QAAgB,EAAE,OAAa;QACxF,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,OAAO,KAAK,KAAK,MAAM,QAAQ,QAAQ,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,mBAAmB,CAAC,WAAmB,EAAE,MAAc,EAAE,OAAe,EAAE,MAAc,EAAE,QAAiB;QACvG,OAAO,CAAC,GAAG,CAAC,oBAAoB,WAAW,OAAO,MAAM,MAAM,OAAO,aAAa,MAAM,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;IAClH,CAAC;CACJ;AApBD,sCAoBC"}

package/dist/utils/prometheus.utils.d.ts

@@ -0,0 +1,9 @@
+import { PrometheusMetric, MetricValue } from '../types/monitoring.types';
+export declare function formatPrometheusMetric(metric: PrometheusMetric, value: MetricValue): string;
+export declare function createCounter(name: string, help: string, labelNames?: string[]): PrometheusMetric;
+export declare function createGauge(name: string, help: string, labelNames?: string[]): PrometheusMetric;
+export declare function createHistogram(name: string, help: string, labelNames?: string[]): PrometheusMetric;
+export declare function calculatePercentile(values: number[], percentile: number): number;
+export declare function formatDuration(milliseconds: number): number;
+export declare function bytesToMegabytes(bytes: number): number;
+export declare function calculateErrorRate(errorCount: number, totalCount: number): number;

package/dist/utils/prometheus.utils.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPrometheusMetric = formatPrometheusMetric;
+exports.createCounter = createCounter;
+exports.createGauge = createGauge;
+exports.createHistogram = createHistogram;
+exports.calculatePercentile = calculatePercentile;
+exports.formatDuration = formatDuration;
+exports.bytesToMegabytes = bytesToMegabytes;
+exports.calculateErrorRate = calculateErrorRate;
+function formatPrometheusMetric(metric, value) {
+    const labels = value.labels
+        ? Object.entries(value.labels)
+            .map(([key, val]) => `${key}="${val}"`)
+            .join(',')
+        : '';
+    const metricLine = labels
+        ? `${metric.name}{${labels}} ${value.value}`
+        : `${metric.name} ${value.value}`;
+    return value.timestamp
+        ? `${metricLine} ${value.timestamp}`
+        : metricLine;
+}
+function createCounter(name, help, labelNames) {
+    return {
+        name,
+        help,
+        type: 'counter',
+        labelNames,
+    };
+}
+function createGauge(name, help, labelNames) {
+    return {
+        name,
+        help,
+        type: 'gauge',
+        labelNames,
+    };
+}
+function createHistogram(name, help, labelNames) {
+    return {
+        name,
+        help,
+        type: 'histogram',
+        labelNames,
+    };
+}
+function calculatePercentile(values, percentile) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const index = Math.ceil((percentile / 100) * sorted.length) - 1;
+    return sorted[index];
+}
+function formatDuration(milliseconds) {
+    return milliseconds / 1000;
+}
+function bytesToMegabytes(bytes) {
+    return bytes / (1024 * 1024);
+}
+function calculateErrorRate(errorCount, totalCount) {
+    if (totalCount === 0)
+        return 0;
+    return (errorCount / totalCount) * 100;
+}
+//# sourceMappingURL=prometheus.utils.js.map

package/dist/utils/prometheus.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.utils.js","sourceRoot":"","sources":["../../src/utils/prometheus.utils.ts"],"names":[],"mappings":";;AASA,wDAiBC;AAKD,sCAWC;AAKD,kCAWC;AAKD,0CAWC;AAKD,kDASC;AAKD,wCAEC;AAKD,4CAEC;AAKD,gDAMC;AAxGD,SAAgB,sBAAsB,CAClC,MAAwB,EACxB,KAAkB;IAElB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM;QACvB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;aACzB,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;aACtC,IAAI,CAAC,GAAG,CAAC;QACd,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,UAAU,GAAG,MAAM;QACrB,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,KAAK,KAAK,CAAC,KAAK,EAAE;QAC5C,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;IAEtC,OAAO,KAAK,CAAC,SAAS;QAClB,CAAC,CAAC,GAAG,UAAU,IAAI,KAAK,CAAC,SAAS,EAAE;QACpC,CAAC,CAAC,UAAU,CAAC;AACrB,CAAC;AAKD,SAAgB,aAAa,CACzB,IAAY,EACZ,IAAY,EACZ,UAAqB;IAErB,OAAO;QACH,IAAI;QACJ,IAAI;QACJ,IAAI,EAAE,SAAS;QACf,UAAU;KACb,CAAC;AACN,CAAC;AAKD,SAAgB,WAAW,CACvB,IAAY,EACZ,IAAY,EACZ,UAAqB;IAErB,OAAO;QACH,IAAI;QACJ,IAAI;QACJ,IAAI,EAAE,OAAO;QACb,UAAU;KACb,CAAC;AACN,CAAC;AAKD,SAAgB,eAAe,CAC3B,IAAY,EACZ,IAAY,EACZ,UAAqB;IAErB,OAAO;QACH,IAAI;QACJ,IAAI;QACJ,IAAI,EAAE,WAAW;QACjB,UAAU;KACb,CAAC;AACN,CAAC;AAKD,SAAgB,mBAAmB,CAC/B,MAAgB,EAChB,UAAkB;IAElB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAElC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAKD,SAAgB,cAAc,CAAC,YAAoB;IAC/C,OAAO,YAAY,GAAG,IAAI,CAAC;AAC/B,CAAC;AAKD,SAAgB,gBAAgB,CAAC,KAAa;IAC1C,OAAO,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACjC,CAAC;AAKD,SAAgB,kBAAkB,CAC9B,UAAkB,EAClB,UAAkB;IAElB,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC;AAC3C,CAAC"}

package/dist/utils/user.utils.d.ts

@@ -0,0 +1 @@
+export declare function generateFullName(firstName?: string, lastName?: string, middleName?: string): string;

package/dist/utils/user.utils.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFullName = generateFullName;
+function generateFullName(firstName, lastName, middleName) {
+    return [lastName, firstName, middleName].filter(Boolean).join(' ').trim();
+}
+//# sourceMappingURL=user.utils.js.map

package/dist/utils/user.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.utils.js","sourceRoot":"","sources":["../../src/utils/user.utils.ts"],"names":[],"mappings":";;AAAA,4CAEC;AAFD,SAAgB,gBAAgB,CAAC,SAAkB,EAAE,QAAiB,EAAE,UAAmB;IACvF,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9E,CAAC"}

package/package.json

@@ -1,9 +1,8 @@
 {
     "name": "@alacard-project/shared",
-    "version": "1.0.0",
-    "private": false,
-    "publishConfig": {
-        "access": "public"
+    "version": "1.0.3",
+    "engines": {
+        "node": ">=24.0.0"
     },
     "description": "Pure types and constants for Alacard microservices",
     "main": "dist/index.js",
@@ -13,11 +12,13 @@
         "watch": "tsc -w"
     },
     "dependencies": {
+        "@nestjs/config": "^4.0.2",
         "class-transformer": "^0.5.1",
-        "class-validator": "^0.14.3"
+        "class-validator": "^0.14.3",
+        "rxjs": "^7.8.2"
     },
     "devDependencies": {
-        "@types/node": "^20.11.0",
-        "typescript": "^5.3.3"
+        "@types/node": "^24.10.0",
+        "typescript": "^5.9.3"
     }
-}
+}

package/src/config/base-config.service.ts

@@ -0,0 +1,101 @@
+import { ConfigService } from '@nestjs/config';
+import { ENV_KEYS } from '../constants/env.constants';
+import { Environment } from '../enums/env.enum';
+
+export abstract class BaseConfigService {
+    constructor(protected readonly configService: ConfigService) { }
+
+    get environment(): Environment {
+        return this.configService.get<Environment>(ENV_KEYS.NODE_ENV) || Environment.DEVELOPMENT;
+    }
+
+    get isProduction(): boolean {
+        return this.environment === Environment.PRODUCTION;
+    }
+
+    get port(): number {
+        return this.getOptionalNumber(ENV_KEYS.PORT, 3000)!;
+    }
+
+    get databaseUrl(): string {
+        return this.getRequiredString(ENV_KEYS.DATABASE_URL);
+    }
+
+    get redisHost(): string {
+        return this.getRequiredString(ENV_KEYS.REDIS_HOST);
+    }
+
+    get redisPort(): number {
+        return this.getRequiredNumber(ENV_KEYS.REDIS_PORT);
+    }
+
+    get kafkaBrokers(): string[] {
+        const brokers = this.getRequiredString(ENV_KEYS.KAFKA_BROKERS);
+        return brokers.split(',');
+    }
+
+    get corsOrigins(): string[] {
+        const origins = this.getOptionalString(ENV_KEYS.CORS_ORIGINS);
+        return origins ? origins.split(',') : ['*'];
+    }
+
+    get rabbitmqUrl(): string {
+        return this.getRequiredString(ENV_KEYS.RABBITMQ_URL);
+    }
+
+    get rateLimitTtl(): number {
+        return this.getOptionalNumber(ENV_KEYS.RATE_LIMIT_TTL, 60)!;
+    }
+
+    get rateLimitMax(): number {
+        return this.getOptionalNumber(ENV_KEYS.RATE_LIMIT_MAX, 10)!;
+    }
+
+    get userServiceUrl(): string {
+        return this.getRequiredString(ENV_KEYS.USER_SERVICE_URL);
+    }
+
+    get userProtoPath(): string {
+        return this.getRequiredString(ENV_KEYS.USER_PROTO_PATH);
+    }
+
+    protected getRequiredString(key: string): string {
+        const value = this.configService.get<string>(key);
+        if (!value) {
+            throw new Error(`Config error: ${key} is required`);
+        }
+        return value;
+    }
+
+    protected getRequiredNumber(key: string): number {
+        const value = this.configService.get<number>(key);
+        if (value === undefined) {
+            throw new Error(`Config error: ${key} is required`);
+        }
+        return value;
+    }
+
+    protected getOptionalString(key: string, defaultValue?: string): string | undefined {
+        return this.configService.get<string>(key) || defaultValue;
+    }
+
+    protected getOptionalNumber(key: string, defaultValue?: number): number | undefined {
+        return this.configService.get<number>(key) ?? defaultValue;
+    }
+
+    protected getOptionalBoolean(key: string, defaultValue = false): boolean {
+        return this.configService.get<boolean>(key) ?? defaultValue;
+    }
+
+    protected timeToSeconds(timeStr: string): number {
+        const unit = timeStr.slice(-1);
+        const value = parseInt(timeStr.slice(0, -1));
+        switch (unit) {
+            case 's': return value;
+            case 'm': return value * 60;
+            case 'h': return value * 3600;
+            case 'd': return value * 86400;
+            default: return parseInt(timeStr);
+        }
+    }
+}

package/src/constants/auth-config.constants.ts

@@ -0,0 +1,9 @@
+export const INVITATION_CONFIG = {
+    DEFAULT_EXPIRATION_DAYS: 7,
+    TOKEN_LENGTH: 32,
+};
+
+export const PASSWORD_RESET_CONFIG = {
+    TOKEN_EXPIRY_HOURS: 1,
+    TOKEN_LENGTH: 32,
+};

package/src/constants/auth.constants.ts

@@ -0,0 +1,34 @@
+export const AUTHENTICATION_MESSAGES = {
+    USER_NOT_FOUND: 'User with this email was not found.',
+    USER_ALREADY_EXISTS: 'User with this email already exists.',
+    INVALID_PASSWORD: 'The password you entered is incorrect.',
+    USER_INACTIVE: 'Your account is currently inactive. Please contact support.',
+    INVALID_REFRESH_TOKEN: 'Your session has expired or the refresh token is invalid.',
+    LOGOUT_SUCCESS: 'You have been successfully logged out.',
+    REGISTRATION_SUCCESS: 'Your account has been created successfully.',
+    REGISTER_SUCCESS: 'Account created successfully.',
+    LOGIN_SUCCESS: 'Logged in successfully.',
+    PASSWORD_RESET_SENT: 'A password reset link has been sent to your email.',
+    PASSWORD_RESET_SUCCESS: 'Your password has been reset successfully.',
+    INVALID_CREDENTIALS: 'The email or password you entered is incorrect.',
+};
+
+export const COOKIE_EXPIRATION = {
+    REFRESH_TOKEN_MS: 7 * 24 * 60 * 60 * 1000, // 7 days
+    ACCESS_TOKEN_MS: 15 * 60 * 1000, // 15 minutes
+};
+
+export const INVITATION_MESSAGES = {
+    INVITATION_SENT: 'Invitation sent successfully.',
+    INVITATION_VALID: 'Invitation is valid.',
+    INVITATION_NOT_FOUND: 'Invitation not found.',
+    INVITATION_EXPIRED: 'Invitation has expired.',
+    INVITATION_ALREADY_USED: 'Invitation has already been used.',
+};
+
+export const PASSWORD_RESET_MESSAGES = {
+    RESET_EMAIL_SENT: 'Password reset email sent.',
+    PASSWORD_RESET_SUCCESS: 'Password reset successfully.',
+    INVALID_TOKEN: 'Invalid password reset token.',
+    TOKEN_EXPIRED: 'Password reset token has expired.',
+};

package/src/constants/common.constants.ts

@@ -0,0 +1,9 @@
+export const COOKIE_NAMES = {
+    ACCESS_TOKEN: 'access_token',
+    REFRESH_TOKEN: 'refresh_token',
+} as const;
+
+export const PASSPORT_STRATEGIES = {
+    LOCAL: 'local',
+    JWT: 'jwt',
+} as const;

package/src/constants/env.constants.ts

@@ -8,18 +8,35 @@ export const ENV_KEYS = {
     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',
     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 = {
-    DEVELOPMENT: 'development',
-    PRODUCTION: 'production',
-    TEST: 'test',
-    STAGING: 'staging',
+    NODE_ENV: {
+        DEVELOPMENT: 'development',
+        PRODUCTION: 'production',
+        TEST: 'test',
+        STAGING: 'staging',
+        LOCAL: 'local',
+    },
 } as const;

package/src/constants/error-messages.ts

@@ -0,0 +1,10 @@
+import { ErrorCode } from '../enums/error.enum';
+
+export const ErrorMessages: Record<string, string> = {
+    [ErrorCode.INTERNAL_SERVER_ERROR]: 'An internal server error occurred. Please try again later.',
+    [ErrorCode.VALIDATION_ERROR]: 'Input validation failed. Please check your data.',
+    [ErrorCode.AUTH_INVALID_TOKEN]: 'Your session token is invalid or has been revoked.',
+    [ErrorCode.AUTH_TOKEN_EXPIRED]: 'Your session has expired. Please log in again.',
+    [ErrorCode.AUTH_ACCESS_DENIED]: 'Access denied. You do not have the required role or scope.',
+    [ErrorCode.NOT_FOUND]: 'The requested resource was not found.',
+};

package/src/constants/grpc.constants.ts

@@ -1,10 +1,13 @@
 export const GRPC_PACKAGES = {
     LOGGING: 'logging',
     CONFIG: 'config',
+    AUTH: 'auth',
+    USER: 'user',
 } as const;
 
 export const GRPC_METHODS = {
     LOGGING: {
+        SERVICE: 'LoggingService',
         LOG_EVENT: 'LogEvent',
         LOG_USER_ACTION: 'LogUserAction',
         UPDATE_SERVICE_STATUS: 'UpdateServiceStatus',
@@ -12,4 +15,27 @@ export const GRPC_METHODS = {
         GET_SERVICE_STATUS: 'GetServiceStatus',
         GET_USER_ACTIONS: 'GetUserActions',
     },
+    AUTH: {
+        SERVICE: 'AuthService',
+        LOGIN: 'Login',
+        REGISTER: 'Register',
+        VALIDATE: 'Validate',
+        GET_USER_BY_ID: 'GetUserById',
+        GET_USER_BY_EMAIL: 'GetUserByEmail',
+        VALIDATE_TOKEN: 'ValidateToken',
+        REFRESH_TOKEN: 'RefreshToken',
+        REVOKE_TOKEN: 'RevokeToken',
+        CHECK_PERMISSION: 'CheckPermission',
+        GET_USER_PERMISSIONS: 'GetUserPermissions',
+    },
+    USER: {
+        SERVICE: 'UserService',
+        GET_USER_BY_ID: 'GetUserById',
+        GET_USER_By_EMAIL: 'GetUserByEmail',
+        GET_USER_PERMISSIONS: 'GetUserPermissions',
+        CREATE_USER: 'CreateUser',
+        UPDATE_USER: 'UpdateUser',
+        UPDATE_PROFILE: 'UpdateProfile',
+        DELETE_USER: 'DeleteUser',
+    },
 } as const;

package/src/constants/index.ts

@@ -1,5 +1,13 @@
 export * from './env.constants';
 export * from './http.constants';
-export * from './services.constants';
-export * from './grpc.constants';
 export * from './logging.constants';
+export * from './microservices.constants';
+export * from './grpc.constants';
+export * from './error-messages';
+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

@@ -0,0 +1,15 @@
+export const LOGGING_MESSAGES = {
+    USER_LOGGED_IN: 'User successfully logged in',
+    USER_REGISTERED: 'New user registered',
+    USER_LOGGED_OUT: 'User logged out',
+
+    LOGIN_ATTEMPT_NONEXISTENT_EMAIL: 'Login attempt with non-existent email',
+    LOGIN_ATTEMPT_INVALID_PASSWORD: 'Login attempt with invalid password',
+
+    ACCESS_TOKEN_VALIDATED: 'Access token successfully validated',
+    ACCESS_TOKEN_VALIDATION_FAILED: 'Access token validation failed',
+
+    CONFIG_RELOADED: 'Configuration successfully reloaded',
+    VAULT_CONNECTED: 'Connected to HashiCorp Vault',
+    VAULT_CONNECTION_FAILED: 'Failed to connect to HashiCorp Vault',
+};

package/src/constants/microservices.constants.ts

@@ -0,0 +1,18 @@
+export const MICROSERVICES = {
+    CONFIG: {
+        SERVICE_NAME: 'CONFIG_SERVICE',
+        PACKAGE: 'config',
+    },
+    LOGGING: {
+        SERVICE_NAME: 'LOGGING_SERVICE',
+        PACKAGE: 'logging',
+    },
+    AUTH: {
+        SERVICE_NAME: 'AUTH_SERVICE',
+        PACKAGE: 'auth',
+    },
+    USER: {
+        SERVICE_NAME: 'USER_SERVICE',
+        PACKAGE: 'user',
+    },
+} as const;

package/src/constants/monitoring.constants.ts

@@ -0,0 +1,71 @@
+/**
+ * Prometheus Metrics Constants
+ */
+
+export const PROMETHEUS_METRICS = {
+    // HTTP Metrics
+    HTTP_REQUESTS_TOTAL: 'http_requests_total',
+    HTTP_REQUEST_DURATION: 'http_request_duration_seconds',
+    HTTP_ERRORS_TOTAL: 'http_errors_total',
+    HTTP_RESPONSE_SIZE: 'http_response_size_bytes',
+
+    // Database Metrics
+    DB_CONNECTIONS_ACTIVE: 'db_connections_active',
+    DB_CONNECTIONS_IDLE: 'db_connections_idle',
+    DB_QUERY_DURATION: 'db_query_duration_seconds',
+    DB_QUERIES_TOTAL: 'db_queries_total',
+    DB_ERRORS_TOTAL: 'db_errors_total',
+
+    // gRPC Metrics
+    GRPC_REQUESTS_TOTAL: 'grpc_requests_total',
+    GRPC_REQUEST_DURATION: 'grpc_request_duration_seconds',
+    GRPC_ERRORS_TOTAL: 'grpc_errors_total',
+
+    // Kafka Metrics
+    KAFKA_MESSAGES_SENT: 'kafka_messages_sent_total',
+    KAFKA_MESSAGES_RECEIVED: 'kafka_messages_received_total',
+    KAFKA_ERRORS_TOTAL: 'kafka_errors_total',
+
+    // System Metrics
+    PROCESS_CPU_USAGE: 'process_cpu_usage_percent',
+    PROCESS_MEMORY_USAGE: 'process_memory_usage_bytes',
+    PROCESS_HEAP_USED: 'process_heap_used_bytes',
+    PROCESS_HEAP_TOTAL: 'process_heap_total_bytes',
+    PROCESS_UPTIME: 'process_uptime_seconds',
+
+    // Application Metrics
+    ACTIVE_USERS: 'active_users_total',
+    REGISTERED_USERS: 'registered_users_total',
+    REQUESTS_PER_SECOND: 'requests_per_second',
+    ERROR_RATE: 'error_rate_percent',
+
+    // Cache Metrics
+    CACHE_HITS: 'cache_hits_total',
+    CACHE_MISSES: 'cache_misses_total',
+    CACHE_SIZE: 'cache_size_bytes',
+} as const;
+
+export const METRIC_LABELS = {
+    SERVICE: 'service',
+    METHOD: 'method',
+    STATUS: 'status',
+    ENDPOINT: 'endpoint',
+    ERROR_TYPE: 'error_type',
+    DATABASE: 'database',
+    QUERY_TYPE: 'query_type',
+    USER_ROLE: 'user_role',
+    GRPC_METHOD: 'grpc_method',
+    KAFKA_TOPIC: 'kafka_topic',
+} as const;
+
+export const HEALTH_CHECK_ENDPOINTS = {
+    LIVENESS: '/health/liveness',
+    READINESS: '/health/readiness',
+    STARTUP: '/health/startup',
+} as const;
+
+export const MONITORING_CONFIG = {
+    SCRAPE_INTERVAL: 15, // seconds
+    SCRAPE_TIMEOUT: 10, // seconds
+    RETENTION_DAYS: 15,
+} as const;

package/src/constants/routes.constants.ts

@@ -0,0 +1,21 @@
+export const ROUTES = {
+    AUTH: {
+        BASE: 'auth',
+        LOGIN: 'login',
+        LOGOUT: 'logout',
+        REGISTER: 'register',
+        PROFILE: 'profile',
+        REFRESH: 'refresh',
+        INVITE: 'invite',
+        INVITATIONS: 'invitations',
+        REGISTER_BY_INVITE: 'register-by-invite',
+    },
+    USER: {
+        BASE: 'users',
+    },
+} as const;
+
+export const AUTH_ROUTES = {
+    PASSWORD_RESET_REQUEST: 'password-reset/request',
+    PASSWORD_RESET_CONFIRM: 'password-reset/confirm',
+};

package/src/constants/tokens.constants.ts

@@ -0,0 +1,6 @@
+export const SERVICE_TOKENS = {
+    USER_SERVICE: 'USER_PACKAGE',
+    AUTH_SERVICE: 'AUTH_PACKAGE',
+    LOGGING_SERVICE: 'LOGGING_PACKAGE',
+    CONFIG_SERVICE: 'CONFIG_PACKAGE',
+} as const;

package/src/contracts/auth.contract.ts

@@ -0,0 +1,98 @@
+export interface GetUserByIdGrpcRequest {
+    userId: string;
+}
+
+export interface GetUserByIdGrpcResponse {
+    user: any;
+}
+
+export interface GetUserByEmailGrpcRequest {
+    email: string;
+}
+
+export interface GetUserByEmailGrpcResponse {
+    user: any;
+}
+
+export interface ValidateTokenGrpcRequest {
+    token: string;
+}
+
+export interface ValidateTokenGrpcResponse {
+    valid: boolean;
+    user?: any;
+}
+
+export interface RefreshTokenGrpcRequest {
+    refreshToken: string;
+}
+
+export interface RevokeTokenGrpcRequest {
+    refreshToken: string;
+    userId: string;
+}
+
+export interface RevokeTokenGrpcResponse {
+    success: boolean;
+}
+
+export interface CheckPermissionGrpcRequest {
+    userId: string;
+    resource: string;
+    action: string;
+}
+
+export interface CheckPermissionGrpcResponse {
+    hasPermission: boolean;
+}
+
+export interface GetUserPermissionsGrpcRequest {
+    userId: string;
+}
+
+export interface GetUserPermissionsGrpcResponse {
+    userId: string;
+    permissions: Array<{ resource: string; action: string }>;
+    scopes: string[];
+}
+
+export interface CreateUserRequest {
+    userId?: string;
+    email: string;
+    role: string;
+    firstName?: string;
+    lastName?: string;
+    password?: string;
+}
+
+export interface UpdateUserRequest {
+    userId: string;
+    email?: string;
+    role?: string;
+    firstName?: string;
+    lastName?: string;
+    password?: string;
+    isActive?: boolean;
+}
+
+export interface UpdateProfileRequest {
+    userId: string;
+    firstName?: string;
+    lastName?: string;
+}
+
+export interface DeleteUserRequest {
+    userId: string;
+}
+
+export interface PermissionsResponse {
+    userId: string;
+    permissions: Array<{ id?: string; resource: string; action: string }>;
+    scopes: string[];
+}
+
+// Aliases for backward compatibility or cleaner naming
+export type GetUserByIdRequest = GetUserByIdGrpcRequest;
+export type GetUserByEmailRequest = GetUserByEmailGrpcRequest;
+export type GetUserPermissionsRequest = GetUserPermissionsGrpcRequest;
+export type DeleteUserResponse = { success: boolean };