@alacard-project/shared 1.0.1 → 1.0.3

package/src/utils/health.utils.ts

@@ -0,0 +1,72 @@
+/**
+ * Health Check Utilities
+ */
+
+export interface ComponentHealth {
+    status: 'up' | 'down';
+    message?: string;
+    responseTime?: number;
+}
+
+/**
+ * Create Prisma health check function
+ */
+export function createPrismaHealthCheck(prisma: any) {
+    return async (): Promise<ComponentHealth> => {
+        const start = Date.now();
+        try {
+            await prisma.$queryRaw`SELECT 1`;
+            return {
+                status: 'up',
+                responseTime: Date.now() - start,
+            };
+        } catch (error: any) {
+            return {
+                status: 'down',
+                message: error.message,
+            };
+        }
+    };
+}
+
+/**
+ * Create Redis health check function
+ */
+export function createRedisHealthCheck(redis: any) {
+    return async (): Promise<ComponentHealth> => {
+        const start = Date.now();
+        try {
+            await redis.ping();
+            return {
+                status: 'up',
+                responseTime: Date.now() - start,
+            };
+        } catch (error: any) {
+            return {
+                status: 'down',
+                message: error.message,
+            };
+        }
+    };
+}
+
+/**
+ * Create gRPC service health check function
+ */
+export function createGrpcHealthCheck(client: any, methodName: string = 'ping') {
+    return async (): Promise<ComponentHealth> => {
+        const start = Date.now();
+        try {
+            await client[methodName]({});
+            return {
+                status: 'up',
+                responseTime: Date.now() - start,
+            };
+        } catch (error: any) {
+            return {
+                status: 'down',
+                message: error.message,
+            };
+        }
+    };
+}

package/src/utils/logging-client.ts

@@ -0,0 +1,21 @@
+export class LoggingClient {
+    logInfo(message: string, context?: any) {
+        console.log(`[INFO] ${message}`, context || '');
+    }
+
+    logWarn(message: string, context?: any) {
+        console.warn(`[WARN] ${message}`, context || '');
+    }
+
+    logError(message: string, context?: any) {
+        console.error(`[ERROR] ${message}`, context || '');
+    }
+
+    logUserAction(userId: string, email: string, action: string, resource: string, details?: any) {
+        console.log(`[USER_ACTION] ${action} by ${email} (${userId}) on ${resource}`, details || '');
+    }
+
+    updateServiceStatus(serviceName: string, status: string, version: string, uptime: number, metadata?: string) {
+        console.log(`[SERVICE_STATUS] ${serviceName} is ${status} (v${version}, uptime: ${uptime}s)`, metadata || '');
+    }
+}

package/src/utils/prometheus.utils.ts

@@ -0,0 +1,114 @@
+/**
+ * Prometheus Metrics Utilities
+ */
+
+import { PrometheusMetric, MetricValue } from '../types/monitoring.types';
+
+/**
+ * Format metric for Prometheus exposition format
+ */
+export function formatPrometheusMetric(
+    metric: PrometheusMetric,
+    value: MetricValue
+): string {
+    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;
+}
+
+/**
+ * Create a counter metric
+ */
+export function createCounter(
+    name: string,
+    help: string,
+    labelNames?: string[]
+): PrometheusMetric {
+    return {
+        name,
+        help,
+        type: 'counter',
+        labelNames,
+    };
+}
+
+/**
+ * Create a gauge metric
+ */
+export function createGauge(
+    name: string,
+    help: string,
+    labelNames?: string[]
+): PrometheusMetric {
+    return {
+        name,
+        help,
+        type: 'gauge',
+        labelNames,
+    };
+}
+
+/**
+ * Create a histogram metric
+ */
+export function createHistogram(
+    name: string,
+    help: string,
+    labelNames?: string[]
+): PrometheusMetric {
+    return {
+        name,
+        help,
+        type: 'histogram',
+        labelNames,
+    };
+}
+
+/**
+ * Calculate percentile from histogram data
+ */
+export function calculatePercentile(
+    values: number[],
+    percentile: number
+): number {
+    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];
+}
+
+/**
+ * Format duration in seconds
+ */
+export function formatDuration(milliseconds: number): number {
+    return milliseconds / 1000;
+}
+
+/**
+ * Format bytes to megabytes
+ */
+export function bytesToMegabytes(bytes: number): number {
+    return bytes / (1024 * 1024);
+}
+
+/**
+ * Calculate error rate percentage
+ */
+export function calculateErrorRate(
+    errorCount: number,
+    totalCount: number
+): number {
+    if (totalCount === 0) return 0;
+    return (errorCount / totalCount) * 100;
+}

package/src/utils/user.utils.ts

@@ -0,0 +1,3 @@
+export function generateFullName(firstName?: string, lastName?: string, middleName?: string): string {
+    return [lastName, firstName, middleName].filter(Boolean).join(' ').trim();
+}

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/shared.iml" filepath="$PROJECT_DIR$/.idea/shared.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/shared.iml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="WEB_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$">
-      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
-      <excludeFolder url="file://$MODULE_DIR$/temp" />
-      <excludeFolder url="file://$MODULE_DIR$/tmp" />
-    </content>
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>

package/.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>

package/.idea/workspace.xml

@@ -1,55 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AutoImportSettings">
-    <option name="autoReloadType" value="SELECTIVE" />
-  </component>
-  <component name="ChangeListManager">
-    <list default="true" id="4e6227af-3de2-4819-896b-00ff294bc9a2" name="Changes" comment="">
-      <change beforePath="$PROJECT_DIR$/package.json" beforeDir="false" afterPath="$PROJECT_DIR$/package.json" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/constants/index.ts" beforeDir="false" afterPath="$PROJECT_DIR$/src/constants/index.ts" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/enums/index.ts" beforeDir="false" afterPath="$PROJECT_DIR$/src/enums/index.ts" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/types/index.ts" beforeDir="false" afterPath="$PROJECT_DIR$/src/types/index.ts" afterDir="false" />
-    </list>
-    <option name="SHOW_DIALOG" value="false" />
-    <option name="HIGHLIGHT_CONFLICTS" value="true" />
-    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
-    <option name="LAST_RESOLUTION" value="IGNORE" />
-  </component>
-  <component name="Git.Settings">
-    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
-  </component>
-  <component name="ProjectId" id="38cuwD20Ia0ozpGeeafIWS9yU4F" />
-  <component name="ProjectViewState">
-    <option name="hideEmptyMiddlePackages" value="true" />
-    <option name="showLibraryContents" value="true" />
-  </component>
-  <component name="PropertiesComponent"><![CDATA[{
-  "keyToString": {
-    "RunOnceActivity.ShowReadmeOnStart": "true",
-    "WebServerToolWindowFactoryState": "false",
-    "git-widget-placeholder": "main",
-    "last_opened_file_path": "/Users/adilalipbaev/Desktop/programing/Alacard_v5/shared",
-    "node.js.detected.package.eslint": "true",
-    "node.js.detected.package.tslint": "true",
-    "node.js.selected.package.eslint": "(autodetect)",
-    "node.js.selected.package.tslint": "(autodetect)",
-    "nodejs_package_manager_path": "npm",
-    "vue.rearranger.settings.migration": "true"
-  }
-}]]></component>
-  <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
-  <component name="TaskManager">
-    <task active="true" id="Default" summary="Default task">
-      <changelist id="4e6227af-3de2-4819-896b-00ff294bc9a2" name="Changes" comment="" />
-      <created>1769111416610</created>
-      <option name="number" value="Default" />
-      <option name="presentableId" value="Default" />
-      <updated>1769111416610</updated>
-      <workItem from="1769111417631" duration="1568000" />
-    </task>
-    <servers />
-  </component>
-  <component name="TypeScriptGeneratedFilesManager">
-    <option name="version" value="3" />
-  </component>
-</project>

package/dist/constants/services.constants.d.ts

@@ -1,6 +0,0 @@
-export declare const MICROSERVICES: {
-    readonly CONFIG: "CONFIG_SERVICE";
-    readonly LOGGING: "LOGGING_SERVICE";
-    readonly AUTH: "AUTH_SERVICE";
-    readonly USER: "USER_SERVICE";
-};

package/dist/constants/services.constants.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MICROSERVICES = void 0;
-exports.MICROSERVICES = {
-    CONFIG: 'CONFIG_SERVICE',
-    LOGGING: 'LOGGING_SERVICE',
-    AUTH: 'AUTH_SERVICE',
-    USER: 'USER_SERVICE',
-};
-//# sourceMappingURL=services.constants.js.map

package/dist/constants/services.constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"services.constants.js","sourceRoot":"","sources":["../../src/constants/services.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG;IACzB,MAAM,EAAE,gBAAgB;IACxB,OAAO,EAAE,iBAAiB;IAC1B,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,cAAc;CACd,CAAC"}

package/dist/enums/environment.enum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"environment.enum.js","sourceRoot":"","sources":["../../src/enums/environment.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,WAMX;AAND,WAAY,WAAW;IACnB,0CAA2B,CAAA;IAC3B,kCAAmB,CAAA;IACnB,wCAAyB,CAAA;IACzB,4BAAa,CAAA;IACb,8BAAe,CAAA;AACnB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB"}

package/dist/enums/error-code.enum.d.ts

@@ -1,8 +0,0 @@
-export declare 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/dist/enums/error-code.enum.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorCode = void 0;
-var ErrorCode;
-(function (ErrorCode) {
-    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
-    ErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
-    ErrorCode["AUTHENTICATION_ERROR"] = "AUTHENTICATION_ERROR";
-    ErrorCode["AUTHORIZATION_ERROR"] = "AUTHORIZATION_ERROR";
-    ErrorCode["NOT_FOUND"] = "NOT_FOUND";
-    ErrorCode["INVALID_TOKEN"] = "INVALID_TOKEN";
-})(ErrorCode || (exports.ErrorCode = ErrorCode = {}));
-//# sourceMappingURL=error-code.enum.js.map

package/dist/enums/error-code.enum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-code.enum.js","sourceRoot":"","sources":["../../src/enums/error-code.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,SAOX;AAPD,WAAY,SAAS;IACjB,8CAAiC,CAAA;IACjC,kDAAqC,CAAA;IACrC,0DAA6C,CAAA;IAC7C,wDAA2C,CAAA;IAC3C,oCAAuB,CAAA;IACvB,4CAA+B,CAAA;AACnC,CAAC,EAPW,SAAS,yBAAT,SAAS,QAOpB"}

package/dist/enums/log-level.enum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"log-level.enum.js","sourceRoot":"","sources":["../../src/enums/log-level.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAMX;AAND,WAAY,QAAQ;IAChB,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;IACf,2BAAe,CAAA;AACnB,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB"}

package/dist/enums/notification-type.enum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"notification-type.enum.js","sourceRoot":"","sources":["../../src/enums/notification-type.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IACxB,mCAAe,CAAA;IACf,+BAAW,CAAA;IACX,iCAAa,CAAA;AACjB,CAAC,EAJW,gBAAgB,gCAAhB,gBAAgB,QAI3B"}

package/dist/enums/user-role.enum.d.ts

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

package/dist/enums/user-role.enum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"user-role.enum.js","sourceRoot":"","sources":["../../src/enums/user-role.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAKX;AALD,WAAY,QAAQ;IAChB,2BAAe,CAAA;IACf,+BAAmB,CAAA;IACnB,6BAAiB,CAAA;IACjB,yBAAa,CAAA;AACjB,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB"}

package/dist/enums/user-scope.enum.d.ts

@@ -1,9 +0,0 @@
-export declare enum UserScope {
-    CARDS_READ = "cards:read",
-    CARDS_WRITE = "cards:write",
-    TRANSACTIONS_READ = "transactions:read",
-    PROFILE_READ = "profile:read",
-    PROFILE_WRITE = "profile:write",
-    LOGS_READ = "logs:read",
-    SETTINGS_WRITE = "settings:write"
-}

package/dist/enums/user-scope.enum.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UserScope = void 0;
-var UserScope;
-(function (UserScope) {
-    UserScope["CARDS_READ"] = "cards:read";
-    UserScope["CARDS_WRITE"] = "cards:write";
-    UserScope["TRANSACTIONS_READ"] = "transactions:read";
-    UserScope["PROFILE_READ"] = "profile:read";
-    UserScope["PROFILE_WRITE"] = "profile:write";
-    UserScope["LOGS_READ"] = "logs:read";
-    UserScope["SETTINGS_WRITE"] = "settings:write";
-})(UserScope || (exports.UserScope = UserScope = {}));
-//# sourceMappingURL=user-scope.enum.js.map

package/dist/enums/user-scope.enum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"user-scope.enum.js","sourceRoot":"","sources":["../../src/enums/user-scope.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,SAQX;AARD,WAAY,SAAS;IACjB,sCAAyB,CAAA;IACzB,wCAA2B,CAAA;IAC3B,oDAAuC,CAAA;IACvC,0CAA6B,CAAA;IAC7B,4CAA+B,CAAA;IAC/B,oCAAuB,CAAA;IACvB,8CAAiC,CAAA;AACrC,CAAC,EARW,SAAS,yBAAT,SAAS,QAQpB"}

package/dist/enums/user-status.enum.d.ts

@@ -1,5 +0,0 @@
-export declare enum UserStatus {
-    ACTIVE = "ACTIVE",
-    INACTIVE = "INACTIVE",
-    BLOCKED = "BLOCKED"
-}

package/dist/enums/user-status.enum.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UserStatus = void 0;
-var UserStatus;
-(function (UserStatus) {
-    UserStatus["ACTIVE"] = "ACTIVE";
-    UserStatus["INACTIVE"] = "INACTIVE";
-    UserStatus["BLOCKED"] = "BLOCKED";
-})(UserStatus || (exports.UserStatus = UserStatus = {}));
-//# sourceMappingURL=user-status.enum.js.map

package/dist/enums/user-status.enum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"user-status.enum.js","sourceRoot":"","sources":["../../src/enums/user-status.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,UAIX;AAJD,WAAY,UAAU;IAClB,+BAAiB,CAAA;IACjB,mCAAqB,CAAA;IACrB,iCAAmB,CAAA;AACvB,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB"}

package/dist/enums/user.enums.d.ts

@@ -1,3 +0,0 @@
-export * from './user-role.enum';
-export * from './user-status.enum';
-export * from './user-scope.enum';

package/dist/enums/user.enums.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"user.enums.js","sourceRoot":"","sources":["../../src/enums/user.enums.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,qDAAmC;AACnC,oDAAkC"}

package/dist/logging/enums/log-level.enum.d.ts

@@ -1,7 +0,0 @@
-export declare enum LogLevel {
-    INFO = "INFO",
-    WARN = "WARN",
-    ERROR = "ERROR",
-    DEBUG = "DEBUG",
-    VERBOSE = "VERBOSE"
-}

package/dist/logging/enums/log-level.enum.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogLevel = void 0;
-var LogLevel;
-(function (LogLevel) {
-    LogLevel["INFO"] = "INFO";
-    LogLevel["WARN"] = "WARN";
-    LogLevel["ERROR"] = "ERROR";
-    LogLevel["DEBUG"] = "DEBUG";
-    LogLevel["VERBOSE"] = "VERBOSE";
-})(LogLevel || (exports.LogLevel = LogLevel = {}));
-//# sourceMappingURL=log-level.enum.js.map

package/dist/logging/enums/log-level.enum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"log-level.enum.js","sourceRoot":"","sources":["../../../src/logging/enums/log-level.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAMX;AAND,WAAY,QAAQ;IAChB,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;IACf,2BAAe,CAAA;IACf,+BAAmB,CAAA;AACvB,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB"}