@zorionapp/gg-core 5.0.37 → 5.0.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zorionapp/gg-core",
-  "version": "5.0.37",
+  "version": "5.0.38",
   "type": "commonjs",
   "dependencies": {
     "cache-manager": "5.2.4",

package/src/gg-auth/services/gg-bearer-auth.service.d.ts

@@ -38,5 +38,6 @@ export declare class GgBearerAuthService implements AuthService {
      * @protected
      */
     protected fetchAndCacheUserDto(accessToken: string, cacheKey: string): Promise<UserDto>;
+    private handleJwtCheckError;
     private getPositiveNumberOrFallback;
 }

package/src/gg-auth/services/gg-bearer-auth.service.js

@@ -12,6 +12,7 @@ const luxon_1 = require("luxon");
 const nestjs_cls_1 = require("nestjs-cls");
 const rxjs_1 = require("rxjs");
 const gg_cache_1 = require("../../gg-cache");
+const gg_resilience_1 = require("../../gg-resilience");
 const gg_auth_module_options_1 = require("../gg-auth.module-options");
 let GgBearerAuthService = GgBearerAuthService_1 = class GgBearerAuthService {
     constructor(options, request, http, ggCache) {
@@ -54,30 +55,40 @@ let GgBearerAuthService = GgBearerAuthService_1 = class GgBearerAuthService {
      * @param cacheKey
      * @protected
      */
-    fetchAndCacheUserDto(accessToken, cacheKey) {
-        const onSuccess = async (value) => {
-            this.logger.log({ msg: `User queried successfully`, userId: value?.data?.user?.ggId });
-            await this.ggCache.set(cacheKey, value.data.user, {
+    async fetchAndCacheUserDto(accessToken, cacheKey) {
+        try {
+            const response = await (0, gg_resilience_1.withRetry)(() => (0, rxjs_1.firstValueFrom)(this.http.post(`${this.baseUrl}/jwt/check`, { accessToken }, { timeout: this.jwtCheckTimeoutMs })), {
+                attempts: 2,
+                shouldRetry: gg_resilience_1.isTransientHttpError,
+                onRetry: (err, attempt, delayMs) => this.logger.warn({ msg: 'Retrying JWT check after a transient error', attempt, delayMs, err: err }),
+            });
+            this.logger.log({ msg: 'User queried successfully', userId: response?.data?.user?.ggId });
+            await this.ggCache.set(cacheKey, response.data.user, {
+                namespaced: false,
+                ttl: luxon_1.Duration.fromObject({ seconds: this.authCacheTtlSeconds }),
+            });
+            return (0, class_transformer_1.plainToInstance)(dto_1.UserDto, response.data.user);
+        }
+        catch (error) {
+            await this.handleJwtCheckError(error, cacheKey);
+            throw error;
+        }
+    }
+    async handleJwtCheckError(error, cacheKey) {
+        // Invalid/expired JWT — cache a negative result and decline at warn, matching the prior policy.
+        if (error.code === 'ERR_BAD_REQUEST') {
+            this.logger.warn({ msg: `User authentication declined with given JWT`, err: error });
+            await this.ggCache.set(cacheKey, new dto_1.UserDto(), {
                 namespaced: false,
                 ttl: luxon_1.Duration.fromObject({ seconds: this.authCacheTtlSeconds }),
             });
-        };
-        const onError = async (error) => {
-            if (error.code === 'ECONNREFUSED') {
-                this.logger.error({ msg: 'User service unreachable; check network connection or port mapping', err: error });
-                return error;
-            }
-            if (error.code === 'ERR_BAD_REQUEST') {
-                this.logger.warn({ msg: `User authentication declined with given JWT`, err: error });
-                await this.ggCache.set(cacheKey, new dto_1.UserDto(), {
-                    namespaced: false,
-                    ttl: luxon_1.Duration.fromObject({ seconds: this.authCacheTtlSeconds }),
-                });
-                return error;
-            }
-            this.logger.error({ msg: `Internal server error`, err: error });
-        };
-        return (0, rxjs_1.firstValueFrom)(this.http.post(`${this.baseUrl}/jwt/check`, { accessToken }, { timeout: this.jwtCheckTimeoutMs }).pipe((0, rxjs_1.tap)({ next: onSuccess, error: onError }), (0, rxjs_1.map)((res) => (0, class_transformer_1.plainToInstance)(dto_1.UserDto, res.data.user))));
+            return;
+        }
+        if (error.code === 'ECONNREFUSED') {
+            this.logger.error({ msg: 'User service unreachable; check network connection or port mapping', err: error });
+            return;
+        }
+        this.logger.error({ msg: `Internal server error`, err: error });
     }
     getPositiveNumberOrFallback(value, fallback) {
         if (Number.isFinite(value) && value > 0)

package/src/gg-auth/services/gg-bearer-auth.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"gg-bearer-auth.service.js","sourceRoot":"","sources":["../../../../../../libs/gg-core/src/gg-auth/services/gg-bearer-auth.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gg-bearer-auth.service.js","sourceRoot":"","sources":["../../../../../../libs/gg-core/src/gg-auth/services/gg-bearer-auth.service.ts"],"names":[],"mappings":"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"}

package/src/gg-logger/gg-logger.module.js

@@ -6,6 +6,7 @@ const tslib_1 = require("tslib");
 const common_1 = require("@nestjs/common");
 const nestjs_pino_1 = require("nestjs-pino");
 const gg_config_1 = require("../gg-config");
+const gg_resilience_1 = require("../gg-resilience");
 const PINO_LEVEL_TO_GCP_SEVERITY = {
     trace: 'DEBUG',
     debug: 'DEBUG',
@@ -50,6 +51,11 @@ function buildErrorReportingMixin(service, version) {
         if (!(err instanceof Error) || !err.stack) {
             return {};
         }
+        // ClientRMQ logs broker force-closes / heartbeat timeouts at error, but the client auto-reconnects:
+        // keep the log line, keep the self-healing noise out of Error Reporting.
+        if ((0, gg_resilience_1.isTransientRmqConnectionError)(err)) {
+            return {};
+        }
         return {
             stack_trace: err.stack,
             serviceContext: { service, version },

package/src/gg-logger/gg-logger.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"gg-logger.module.js","sourceRoot":"","sources":["../../../../../libs/gg-core/src/gg-logger/gg-logger.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gg-logger.module.js","sourceRoot":"","sources":["../../../../../libs/gg-core/src/gg-logger/gg-logger.module.ts"],"names":[],"mappings":"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"}

package/src/gg-resilience/index.d.ts

@@ -0,0 +1,2 @@
+export * from './is-transient-error';
+export * from './with-retry';

package/src/gg-resilience/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./is-transient-error"), exports);
+tslib_1.__exportStar(require("./with-retry"), exports);
+//# sourceMappingURL=index.js.map

package/src/gg-resilience/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/gg-core/src/gg-resilience/index.ts"],"names":[],"mappings":";;;AAAA,+DAAqC;AACrC,uDAA6B"}

package/src/gg-resilience/is-transient-error.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A failed outbound HTTP call worth retrying: a network/timeout error (no response) or an upstream
+ * 5xx. A 4xx (including 429) is the peer's deliberate rejection and is never treated as transient —
+ * retrying it just adds load.
+ */
+export declare function isTransientHttpError(error: unknown): boolean;
+/**
+ * A database driver error caused by the connection dropping rather than the query itself — safe to
+ * retry a read. Never matches constraint/validation/not-found errors.
+ */
+export declare function isTransientDbError(error: unknown): boolean;
+/**
+ * A Redis command that timed out or was interrupted by a reconnect — safe to retry for idempotent ops.
+ */
+export declare function isTransientRedisError(error: unknown): boolean;
+/**
+ * A RabbitMQ connection lifecycle error the client recovers from on its own (broker force-close,
+ * heartbeat timeout). Used to keep this self-healing noise out of Error Reporting — it is NOT a
+ * retry signal, since reconnection is handled by the connection manager, not by the caller.
+ */
+export declare function isTransientRmqConnectionError(error: unknown): boolean;
+/**
+ * Explicit-only union of the transient HTTP, database, and Redis classifiers
+ */
+export declare function isTransientError(error: unknown): boolean;

package/src/gg-resilience/is-transient-error.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTransientError = exports.isTransientRmqConnectionError = exports.isTransientRedisError = exports.isTransientDbError = exports.isTransientHttpError = void 0;
+// Network-layer error codes that mean "the connection failed", not "the peer rejected the request".
+// Shared by the HTTP and DB/Redis classifiers since node surfaces the same codes across drivers.
+const TRANSIENT_NETWORK_CODES = new Set([
+    'ECONNRESET',
+    'ECONNREFUSED',
+    'ECONNABORTED',
+    'ETIMEDOUT',
+    'EAI_AGAIN',
+    'ENOTFOUND',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+    'EPIPE',
+]);
+// Postgres/MikroORM: an idle connection dropped by the server or a proxy, a failover, or the pool
+// giving up. These wrap a plain SELECT/UPDATE that would otherwise succeed on a retry.
+const TRANSIENT_DB_ERROR_PATTERNS = [
+    'Connection terminated unexpectedly',
+    'Connection terminated due to connection timeout',
+    'connection is closed',
+    'Client has encountered a connection error',
+    'server closed the connection unexpectedly',
+    'terminating connection due to administrator command',
+    'the database system is shutting down',
+    'the database system is starting up',
+    'timeout exceeded when trying to connect',
+    'read ECONNRESET',
+];
+// Postgres SQLSTATE codes in the connection-exception (08xxx) and operator-intervention (57xxx) classes.
+const TRANSIENT_DB_SQL_STATES = new Set(['08000', '08003', '08006', '08001', '08004', '57P01', '57P02', '57P03', '53300']);
+// ioredis: a command that timed out or was cut off mid-flight while the client reconnected.
+const TRANSIENT_REDIS_ERROR_PATTERNS = [
+    'Command timed out',
+    "Stream isn't writeable",
+    'Connection is closed',
+    'Connection is fully closed',
+    'max retries per request',
+];
+// amqplib: the broker forcibly closed the connection (redeploy, management action) or a heartbeat
+// lapsed. The connection manager reconnects transparently, so these are noise, never a lost message.
+const TRANSIENT_RMQ_ERROR_PATTERNS = ['CONNECTION-FORCED', 'Connection closed: 320', 'Heartbeat timeout'];
+// amqplib reply code for CONNECTION-FORCED (see amqplib/lib/connection.js).
+const AMQP_CONNECTION_FORCED_CODE = 320;
+function messageIncludes(error, patterns) {
+    const message = error instanceof Error ? error.message : typeof error === 'string' ? error : '';
+    return patterns.some((pattern) => message.includes(pattern));
+}
+function errorCode(error) {
+    return error?.code;
+}
+function isAxiosError(error) {
+    return Boolean(error?.isAxiosError);
+}
+/**
+ * A failed outbound HTTP call worth retrying: a network/timeout error (no response) or an upstream
+ * 5xx. A 4xx (including 429) is the peer's deliberate rejection and is never treated as transient —
+ * retrying it just adds load.
+ */
+function isTransientHttpError(error) {
+    if (isAxiosError(error)) {
+        if (error.response) {
+            return error.response.status >= 500;
+        }
+        return true;
+    }
+    const code = errorCode(error);
+    return typeof code === 'string' && TRANSIENT_NETWORK_CODES.has(code);
+}
+exports.isTransientHttpError = isTransientHttpError;
+/**
+ * A database driver error caused by the connection dropping rather than the query itself — safe to
+ * retry a read. Never matches constraint/validation/not-found errors.
+ */
+function isTransientDbError(error) {
+    const code = errorCode(error);
+    if (typeof code === 'string' && (TRANSIENT_NETWORK_CODES.has(code) || TRANSIENT_DB_SQL_STATES.has(code))) {
+        return true;
+    }
+    return messageIncludes(error, TRANSIENT_DB_ERROR_PATTERNS);
+}
+exports.isTransientDbError = isTransientDbError;
+/**
+ * A Redis command that timed out or was interrupted by a reconnect — safe to retry for idempotent ops.
+ */
+function isTransientRedisError(error) {
+    if (error?.name === 'MaxRetriesPerRequestError') {
+        return true;
+    }
+    const code = errorCode(error);
+    if (typeof code === 'string' && TRANSIENT_NETWORK_CODES.has(code)) {
+        return true;
+    }
+    return messageIncludes(error, TRANSIENT_REDIS_ERROR_PATTERNS);
+}
+exports.isTransientRedisError = isTransientRedisError;
+/**
+ * A RabbitMQ connection lifecycle error the client recovers from on its own (broker force-close,
+ * heartbeat timeout). Used to keep this self-healing noise out of Error Reporting — it is NOT a
+ * retry signal, since reconnection is handled by the connection manager, not by the caller.
+ */
+function isTransientRmqConnectionError(error) {
+    if (errorCode(error) === AMQP_CONNECTION_FORCED_CODE) {
+        return true;
+    }
+    return messageIncludes(error, TRANSIENT_RMQ_ERROR_PATTERNS);
+}
+exports.isTransientRmqConnectionError = isTransientRmqConnectionError;
+/**
+ * Explicit-only union of the transient HTTP, database, and Redis classifiers
+ */
+function isTransientError(error) {
+    return isTransientHttpError(error) || isTransientDbError(error) || isTransientRedisError(error);
+}
+exports.isTransientError = isTransientError;
+//# sourceMappingURL=is-transient-error.js.map

package/src/gg-resilience/is-transient-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-transient-error.js","sourceRoot":"","sources":["../../../../../libs/gg-core/src/gg-resilience/is-transient-error.ts"],"names":[],"mappings":"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"}

package/src/gg-resilience/with-retry.d.ts

@@ -0,0 +1,17 @@
+export interface RetryOptions {
+    attempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    jitter?: boolean;
+    shouldRetry?: (error: unknown) => boolean;
+    onRetry?: (error: unknown, attempt: number, delayMs: number) => void;
+    signal?: AbortSignal;
+}
+/**
+ * Runs `operation`, retrying it on transient failures with exponential backoff. Retries are logged
+ * via `onRetry` (typically at `warn`); the original error is rethrown unchanged once attempts are
+ * exhausted or the error is not retryable, so the caller — or the global exception filter — logs the
+ * genuine failure at `error`. This keeps self-healing blips out of Error Reporting while preserving
+ * real faults.
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, options?: RetryOptions): Promise<T>;

package/src/gg-resilience/with-retry.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRetry = void 0;
+const is_transient_error_1 = require("./is-transient-error");
+const DEFAULT_ATTEMPTS = 3;
+const DEFAULT_BASE_DELAY_MS = 100;
+const DEFAULT_MAX_DELAY_MS = 2000;
+function backoffDelay(attempt, baseDelayMs, maxDelayMs, jitter) {
+    const capped = Math.min(maxDelayMs, baseDelayMs * 2 ** (attempt - 1));
+    // Equal jitter: half fixed, half random — spreads retries without collapsing the delay to ~0.
+    return jitter ? capped / 2 + Math.random() * (capped / 2) : capped;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            return reject(signal.reason ?? new Error('Aborted'));
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason ?? new Error('Aborted'));
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * Runs `operation`, retrying it on transient failures with exponential backoff. Retries are logged
+ * via `onRetry` (typically at `warn`); the original error is rethrown unchanged once attempts are
+ * exhausted or the error is not retryable, so the caller — or the global exception filter — logs the
+ * genuine failure at `error`. This keeps self-healing blips out of Error Reporting while preserving
+ * real faults.
+ */
+async function withRetry(operation, options = {}) {
+    const { attempts = DEFAULT_ATTEMPTS, baseDelayMs = DEFAULT_BASE_DELAY_MS, maxDelayMs = DEFAULT_MAX_DELAY_MS, jitter = true, shouldRetry = is_transient_error_1.isTransientHttpError, onRetry, signal, } = options;
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (attempt >= attempts || !shouldRetry(error)) {
+                throw error;
+            }
+            const delayMs = backoffDelay(attempt, baseDelayMs, maxDelayMs, jitter);
+            onRetry?.(error, attempt, delayMs);
+            await sleep(delayMs, signal);
+        }
+    }
+}
+exports.withRetry = withRetry;
+//# sourceMappingURL=with-retry.js.map

package/src/gg-resilience/with-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-retry.js","sourceRoot":"","sources":["../../../../../libs/gg-core/src/gg-resilience/with-retry.ts"],"names":[],"mappings":";;;AAAA,6DAA4D;AAgB5D,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC,SAAS,YAAY,CAAC,OAAe,EAAE,WAAmB,EAAE,UAAkB,EAAE,MAAe;IAC7F,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;IAEtE,8FAA8F;IAC9F,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACrE,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,SAAS,CAAI,SAA2B,EAAE,UAAwB,EAAE;IACxF,MAAM,EACJ,QAAQ,GAAG,gBAAgB,EAC3B,WAAW,GAAG,qBAAqB,EACnC,UAAU,GAAG,oBAAoB,EACjC,MAAM,GAAG,IAAI,EACb,WAAW,GAAG,yCAAoB,EAClC,OAAO,EACP,MAAM,GACP,GAAG,OAAO,CAAC;IAEZ,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,IAAI,QAAQ,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/C,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;YACvE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACnC,MAAM,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC;AAxBD,8BAwBC"}

package/src/index.d.ts

@@ -10,3 +10,4 @@ export * from './gg-metrics';
 export * from './gg-micro';
 export * from './gg-redis';
 export * from './gg-redlock';
+export * from './gg-resilience';

package/src/index.js

@@ -13,4 +13,5 @@ tslib_1.__exportStar(require("./gg-metrics"), exports);
 tslib_1.__exportStar(require("./gg-micro"), exports);
 tslib_1.__exportStar(require("./gg-redis"), exports);
 tslib_1.__exportStar(require("./gg-redlock"), exports);
+tslib_1.__exportStar(require("./gg-resilience"), exports);
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/gg-core/src/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,qDAA2B;AAC3B,sDAA4B;AAC5B,oDAA0B;AAC1B,wDAA8B;AAC9B,qDAA2B;AAC3B,sDAA4B;AAC5B,sDAA4B;AAC5B,uDAA6B;AAC7B,qDAA2B;AAC3B,qDAA2B;AAC3B,uDAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/gg-core/src/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,qDAA2B;AAC3B,sDAA4B;AAC5B,oDAA0B;AAC1B,wDAA8B;AAC9B,qDAA2B;AAC3B,sDAA4B;AAC5B,sDAA4B;AAC5B,uDAA6B;AAC7B,qDAA2B;AAC3B,qDAA2B;AAC3B,uDAA6B;AAC7B,0DAAgC"}