@hed-hog/core 0.0.398 → 0.0.400

package/dist/redis/redis-kv.service.js

@@ -0,0 +1,247 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var RedisKvService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisKvService = void 0;
+const common_1 = require("@nestjs/common");
+const redis_1 = require("redis");
+const redis_pubsub_1 = require("./redis-pubsub");
+const redis_master_1 = require("./redis-master");
+/**
+ * Chave/valor com TTL sobre o Redis, para estado efêmero compartilhado entre as
+ * réplicas da API.
+ *
+ * Existe ao lado do `redis-pubsub.ts` — que só publica e assina — porque
+ * algumas features precisam GUARDAR estado por um tempo curto, não só avisar
+ * que algo mudou. O caso que motivou: o painel de visitantes ao vivo da loja,
+ * onde gravar cada navegação no Postgres colocaria carga de escrita no banco
+ * que serve a própria loja, exatamente o que o recurso não pode fazer. Aqui o
+ * dado vive na memória do Redis e expira sozinho, sem job de limpeza.
+ *
+ * **Toda falha degrada para inerte.** Mesma postura do pub/sub: sem
+ * `REDIS_URL`, ou com o Redis fora, cada método vira no-op (ou devolve vazio) e
+ * quem chamou segue seu caminho. Um recurso de observação nunca pode derrubar o
+ * fluxo que ele observa — daí nenhum método propagar erro.
+ */
+let RedisKvService = RedisKvService_1 = class RedisKvService {
+    constructor() {
+        this.logger = new common_1.Logger(RedisKvService_1.name);
+        this.url = String(process.env.REDIS_URL || '').trim();
+        this.connectTimeoutMs = Math.max(1000, Number(process.env.REDIS_CONNECT_TIMEOUT_MS || 3000));
+        /** Uma queda do Redis dispara `error` a cada tentativa de reconexão. */
+        this.errorLogCooldownMs = 30000;
+        this.lastErrorLogAt = 0;
+        this.client = null;
+        /** Reconexão em andamento, para não abrir uma por escrita durante o failover. */
+        this.reconnecting = null;
+    }
+    /** `false` = sem Redis; todo método é no-op e quem chama não precisa saber. */
+    get enabled() {
+        return this.client !== null;
+    }
+    async onModuleInit() {
+        if (!this.url) {
+            this.logger.log('Redis key-value disabled because REDIS_URL is not configured.');
+            return;
+        }
+        this.client = await this.connectToMaster();
+        if (this.client)
+            this.logger.log('Redis key-value enabled.');
+    }
+    /**
+     * Conecta no master, e não em quem o Service devolver.
+     *
+     * `REDIS_URL` aponta para um Service que balanceia entre master e réplica
+     * (veja `resolveMasterUrl`), então conectar direto na URL deixa metade dos
+     * processos escrevendo numa réplica e falhando com `READONLY`.
+     */
+    async connectToMaster() {
+        try {
+            const url = await (0, redis_master_1.resolveMasterUrl)(this.url, this.logger, this.connectTimeoutMs);
+            const client = (0, redis_1.createClient)({
+                url,
+                socket: {
+                    reconnectStrategy: (retries) => Math.min(retries * 250, 5000),
+                },
+            });
+            // Registrado antes do connect: uma falha no handshake vira erro tratado
+            // em vez de um evento 'error' sem dono derrubando o processo.
+            client.on('error', (error) => this.logClientError(error));
+            await (0, redis_pubsub_1.withConnectTimeout)(client.connect(), this.connectTimeoutMs);
+            return client;
+        }
+        catch (error) {
+            this.logger.warn(`Redis key-value disabled: ${(0, redis_pubsub_1.extractRedisErrorMessage)(error)}`);
+            return null;
+        }
+    }
+    /**
+     * Refaz a conexão depois de um `READONLY`.
+     *
+     * Um failover troca quem é o master, e o client fica preso no nó que virou
+     * réplica — daí em diante toda escrita falha. Reconectar redescobre o master.
+     * O guard serializa as tentativas: sem ele, um pico de escritas em cima do
+     * failover abriria uma conexão nova por requisição.
+     */
+    async reconnectToMaster() {
+        if (this.reconnecting)
+            return this.reconnecting;
+        this.reconnecting = (async () => {
+            const stale = this.client;
+            this.client = null;
+            if (stale) {
+                try {
+                    await stale.quit();
+                }
+                catch (_a) {
+                    // O nó virou réplica ou caiu; encerrando de qualquer forma.
+                }
+            }
+            this.client = await this.connectToMaster();
+        })().finally(() => {
+            this.reconnecting = null;
+        });
+        return this.reconnecting;
+    }
+    async onModuleDestroy() {
+        const client = this.client;
+        this.client = null;
+        if (!client)
+            return;
+        try {
+            await client.quit();
+        }
+        catch (_a) {
+            // Encerrando de qualquer forma.
+        }
+    }
+    /** Grava um objeto como JSON com expiração em segundos. */
+    async setJson(key, value, ttlSeconds) {
+        await this.run(async (client) => {
+            await client.set(key, JSON.stringify(value), { EX: Math.max(1, ttlSeconds) });
+        });
+    }
+    /** Lê e desserializa. Devolve `null` se não existe, expirou ou está corrompido. */
+    async getJson(key) {
+        var _a;
+        return ((_a = (await this.run(async (client) => {
+            const raw = await client.get(key);
+            if (raw == null)
+                return null;
+            try {
+                return JSON.parse(raw);
+            }
+            catch (_a) {
+                // Valor gravado por uma versão anterior com outro formato: tratar como
+                // ausente é melhor do que estourar na leitura do painel.
+                return null;
+            }
+        }))) !== null && _a !== void 0 ? _a : null);
+    }
+    /**
+     * Lê várias chaves numa ida só.
+     *
+     * `MGET` em vez de um `get` por chave: com dezenas de visitantes ao vivo, uma
+     * chamada por chave multiplicaria o round-trip pelo número de sessões a cada
+     * atualização do painel. Devolve na MESMA ordem das chaves pedidas, com `null`
+     * onde não havia valor.
+     */
+    async getJsonMany(keys) {
+        if (!keys.length)
+            return [];
+        const values = await this.run(async (client) => client.mGet(keys));
+        if (!values)
+            return keys.map(() => null);
+        return values.map((raw) => {
+            if (raw == null)
+                return null;
+            try {
+                return JSON.parse(raw);
+            }
+            catch (_a) {
+                return null;
+            }
+        });
+    }
+    async delete(key) {
+        await this.run(async (client) => {
+            await client.del(key);
+        });
+    }
+    /** Põe (ou repontua) um membro no índice ordenado. */
+    async zadd(key, member, score) {
+        await this.run(async (client) => {
+            await client.zAdd(key, [{ value: member, score }]);
+        });
+    }
+    /** Membros com score dentro do intervalo, do mais antigo para o mais recente. */
+    async zrangeByScore(key, min, max) {
+        const rows = await this.run(async (client) => client.zRangeByScoreWithScores(key, min, max));
+        return (rows !== null && rows !== void 0 ? rows : []).map((row) => ({ member: row.value, score: row.score }));
+    }
+    /**
+     * Remove do índice o que caiu fora da janela.
+     *
+     * O TTL cuida das chaves individuais, mas não do índice: sem esta poda o
+     * sorted set acumularia para sempre todo visitante que já passou pela loja, e
+     * cada leitura do painel ficaria mais cara que a anterior.
+     */
+    async zremRangeByScore(key, min, max) {
+        await this.run(async (client) => {
+            await client.zRemRangeByScore(key, min, max);
+        });
+    }
+    /**
+     * Executa contra o client, engolindo qualquer falha.
+     *
+     * É aqui que mora a promessa de degradar para inerte: quem chama recebe
+     * `undefined` e trata como "sem dado", em vez de precisar de try/catch em
+     * cada ponto de uso.
+     */
+    async run(fn) {
+        const client = this.client;
+        if (!client)
+            return undefined;
+        try {
+            return await fn(client);
+        }
+        catch (error) {
+            // `READONLY` quer dizer que este client está falando com uma réplica —
+            // um failover trocou o master debaixo dele. Reconectar redescobre quem é
+            // o master e a operação é refeita uma vez; qualquer outro erro segue a
+            // regra da casa e degrada para inerte.
+            if ((0, redis_master_1.isReadOnlyReplicaError)(error)) {
+                await this.reconnectToMaster();
+                const reconnected = this.client;
+                if (reconnected) {
+                    try {
+                        return await fn(reconnected);
+                    }
+                    catch (retryError) {
+                        this.logClientError(retryError);
+                        return undefined;
+                    }
+                }
+            }
+            this.logClientError(error);
+            return undefined;
+        }
+    }
+    logClientError(error) {
+        const now = Date.now();
+        if (now - this.lastErrorLogAt < this.errorLogCooldownMs)
+            return;
+        this.lastErrorLogAt = now;
+        this.logger.warn(`Redis key-value error: ${(0, redis_pubsub_1.extractRedisErrorMessage)(error)}`);
+    }
+};
+exports.RedisKvService = RedisKvService;
+exports.RedisKvService = RedisKvService = RedisKvService_1 = __decorate([
+    (0, common_1.Injectable)()
+], RedisKvService);
+//# sourceMappingURL=redis-kv.service.js.map

package/dist/redis/redis-kv.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-kv.service.js","sourceRoot":"","sources":["../../src/redis/redis-kv.service.ts"],"names":[],"mappings":"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"}

package/dist/redis/redis-master.d.ts

@@ -0,0 +1,29 @@
+import { Logger } from '@nestjs/common';
+/**
+ * Descobre qual nó do Redis é o master e devolve a URL dele.
+ *
+ * O `REDIS_URL` aponta para o Service `redis-hub`, e esse Service — o chart
+ * Bitnami em modo Sentinel — tem os DOIS pods como endpoint. Cada conexão nova
+ * faz round-robin entre master e réplica, então metade delas cai na réplica e
+ * toda escrita falha com `READONLY You can't write against a read only
+ * replica`. Não é falha intermitente do Redis: é o cliente conectando no nó
+ * errado.
+ *
+ * A descoberta não usa o protocolo do Sentinel de propósito. Um `INFO
+ * replication` já responde `role:` e, quando é réplica, `master_host` e
+ * `master_port` — que aqui é o DNS do headless service, resolvível de dentro do
+ * cluster. Isso dispensa configurar nome de master e porta de Sentinel, e
+ * continua valendo depois de um failover, porque a resposta é sempre a do nó
+ * que está no ar naquele momento.
+ *
+ * **Nunca lança.** Se o probe falhar, devolve a URL original: o comportamento
+ * passa a ser o de hoje, não pior.
+ */
+export declare function resolveMasterUrl(url: string, logger: Logger, connectTimeoutMs: number): Promise<string>;
+/**
+ * `READONLY` é a resposta do Redis a uma escrita numa réplica. Distinguir esse
+ * erro dos demais é o que permite reagir a um failover reconectando, em vez de
+ * só registrar o erro e perder a escrita.
+ */
+export declare function isReadOnlyReplicaError(error: unknown): boolean;
+//# sourceMappingURL=redis-master.d.ts.map

package/dist/redis/redis-master.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-master.d.ts","sourceRoot":"","sources":["../../src/redis/redis-master.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAIxC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAgDjB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D"}

package/dist/redis/redis-master.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveMasterUrl = resolveMasterUrl;
+exports.isReadOnlyReplicaError = isReadOnlyReplicaError;
+const redis_1 = require("redis");
+const redis_pubsub_1 = require("./redis-pubsub");
+/**
+ * Descobre qual nó do Redis é o master e devolve a URL dele.
+ *
+ * O `REDIS_URL` aponta para o Service `redis-hub`, e esse Service — o chart
+ * Bitnami em modo Sentinel — tem os DOIS pods como endpoint. Cada conexão nova
+ * faz round-robin entre master e réplica, então metade delas cai na réplica e
+ * toda escrita falha com `READONLY You can't write against a read only
+ * replica`. Não é falha intermitente do Redis: é o cliente conectando no nó
+ * errado.
+ *
+ * A descoberta não usa o protocolo do Sentinel de propósito. Um `INFO
+ * replication` já responde `role:` e, quando é réplica, `master_host` e
+ * `master_port` — que aqui é o DNS do headless service, resolvível de dentro do
+ * cluster. Isso dispensa configurar nome de master e porta de Sentinel, e
+ * continua valendo depois de um failover, porque a resposta é sempre a do nó
+ * que está no ar naquele momento.
+ *
+ * **Nunca lança.** Se o probe falhar, devolve a URL original: o comportamento
+ * passa a ser o de hoje, não pior.
+ */
+async function resolveMasterUrl(url, logger, connectTimeoutMs) {
+    var _a, _b, _c, _d;
+    if (!url)
+        return url;
+    let probe = null;
+    try {
+        probe = (0, redis_1.createClient)({
+            url,
+            // Uma tentativa só: este client existe para perguntar quem é o master, e
+            // insistir aqui atrasaria o boot sem melhorar a resposta.
+            socket: { reconnectStrategy: false },
+        });
+        probe.on('error', () => {
+            // Tratado pelo catch; sem listener o node-redis derruba o processo.
+        });
+        await (0, redis_pubsub_1.withConnectTimeout)(probe.connect(), connectTimeoutMs);
+        const info = String(await probe.info('replication'));
+        if (/^role:master/m.test(info))
+            return url;
+        const host = (_b = (_a = info.match(/^master_host:(.+)$/m)) === null || _a === void 0 ? void 0 : _a[1]) === null || _b === void 0 ? void 0 : _b.trim();
+        const port = (_d = (_c = info.match(/^master_port:(\d+)$/m)) === null || _c === void 0 ? void 0 : _c[1]) === null || _d === void 0 ? void 0 : _d.trim();
+        if (!host || !port) {
+            logger.warn('Redis conectou numa réplica mas o INFO não trouxe master_host/master_port; seguindo com a URL original.');
+            return url;
+        }
+        const masterUrl = new URL(url);
+        masterUrl.hostname = host;
+        masterUrl.port = port;
+        logger.log(`Redis: conectado numa réplica, redirecionando para o master ${host}:${port}.`);
+        return masterUrl.toString();
+    }
+    catch (error) {
+        logger.warn(`Redis: não foi possível descobrir o master (${(0, redis_pubsub_1.extractRedisErrorMessage)(error)}); seguindo com a URL original.`);
+        return url;
+    }
+    finally {
+        if (probe) {
+            try {
+                await probe.quit();
+            }
+            catch (_e) {
+                // O probe já cumpriu seu papel.
+            }
+        }
+    }
+}
+/**
+ * `READONLY` é a resposta do Redis a uma escrita numa réplica. Distinguir esse
+ * erro dos demais é o que permite reagir a um failover reconectando, em vez de
+ * só registrar o erro e perder a escrita.
+ */
+function isReadOnlyReplicaError(error) {
+    return /READONLY/i.test((0, redis_pubsub_1.extractRedisErrorMessage)(error));
+}
+//# sourceMappingURL=redis-master.js.map

package/dist/redis/redis-master.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-master.js","sourceRoot":"","sources":["../../src/redis/redis-master.ts"],"names":[],"mappings":";;AAwBA,4CAoDC;AAOD,wDAEC;AApFD,iCAA2D;AAC3D,iDAA8E;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACI,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,MAAc,EACd,gBAAwB;;IAExB,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IAErB,IAAI,KAAK,GAA2B,IAAI,CAAC;IACzC,IAAI,CAAC;QACH,KAAK,GAAG,IAAA,oBAAY,EAAC;YACnB,GAAG;YACH,yEAAyE;YACzE,0DAA0D;YAC1D,MAAM,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE;SACrC,CAAoB,CAAC;QACtB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,oEAAoE;QACtE,CAAC,CAAC,CAAC;QAEH,MAAM,IAAA,iCAAkB,EAAC,KAAK,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAErD,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,GAAG,CAAC;QAE3C,MAAM,IAAI,GAAG,MAAA,MAAA,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,0CAAG,CAAC,CAAC,0CAAE,IAAI,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAA,MAAA,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,0CAAG,CAAC,CAAC,0CAAE,IAAI,EAAE,CAAC;QAC7D,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CACT,yGAAyG,CAC1G,CAAC;YACF,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC1B,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,+DAA+D,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC;QAC3F,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CACT,+CAA+C,IAAA,uCAAwB,EAAC,KAAK,CAAC,iCAAiC,CAChH,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACrB,CAAC;YAAC,WAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,KAAc;IACnD,OAAO,WAAW,CAAC,IAAI,CAAC,IAAA,uCAAwB,EAAC,KAAK,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/redis/redis-pubsub.d.ts

@@ -15,6 +15,18 @@ export type CreateRedisPubSubOptions = {
     url?: string;
     errorLogCooldownMs?: number;
 };
+/**
+ * `createClient` rejects with an `AggregateError` whose own `message` is empty,
+ * so logging it directly yields "Redis error: " with nothing after it.
+ */
+export declare function extractRedisErrorMessage(error: unknown): string;
+/**
+ * `reconnectStrategy` never returning `false` makes `client.connect()` retry
+ * forever while Redis is down: the promise never settles, so an `await` on it
+ * inside `onModuleInit` hangs the whole app's boot. This bounds only the
+ * initial attempt; reconnection of an already-connected client stays infinite.
+ */
+export declare function withConnectTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;
 /**
  * Publisher/subscriber pair on a single channel, mirroring the settings-sync
  * pattern. Never throws: without a URL — or if the connection fails — it returns

package/dist/redis/redis-pubsub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-pubsub.d.ts","sourceRoot":"","sources":["../../src/redis/redis-pubsub.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,MAAM,MAAM,WAAW,GAAG;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAmDF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,WAAW,CAAC,CA4GtB"}
+{"version":3,"file":"redis-pubsub.d.ts","sourceRoot":"","sources":["../../src/redis/redis-pubsub.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,MAAM,MAAM,WAAW,GAAG;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAmBF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU/D;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAe9F;AAkBD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,WAAW,CAAC,CA6GtB"}

package/dist/redis/redis-pubsub.js

@@ -33,6 +33,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractRedisErrorMessage = extractRedisErrorMessage;
+exports.withConnectTimeout = withConnectTimeout;
 exports.createRedisPubSub = createRedisPubSub;
 const Sentry = __importStar(require("@sentry/nestjs"));
 const redis_1 = require("redis");
@@ -67,6 +69,26 @@ function extractRedisErrorMessage(error) {
     }
     return String(error);
 }
+/**
+ * `reconnectStrategy` never returning `false` makes `client.connect()` retry
+ * forever while Redis is down: the promise never settles, so an `await` on it
+ * inside `onModuleInit` hangs the whole app's boot. This bounds only the
+ * initial attempt; reconnection of an already-connected client stays infinite.
+ */
+async function withConnectTimeout(promise, timeoutMs) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`Redis connection timed out after ${timeoutMs}ms`)), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
 async function safeClose(client) {
     if (!client || !client.isOpen) {
         return;
@@ -100,6 +122,7 @@ async function createRedisPubSub(options) {
         return INERT;
     }
     const cooldownMs = Math.max(1000, Number(options.errorLogCooldownMs || DEFAULT_ERROR_LOG_COOLDOWN_MS));
+    const connectTimeoutMs = Math.max(1000, Number(process.env.REDIS_CONNECT_TIMEOUT_MS || 3000));
     // A Redis outage fires `error` on every reconnect attempt; unthrottled that
     // buries every other log line in the pod.
     const lastErrorLogAt = {
@@ -129,8 +152,8 @@ async function createRedisPubSub(options) {
         // rather than thrown as an unhandled 'error' event.
         subscriber.on('error', (error) => logClientError('subscriber', error));
         publisher.on('error', (error) => logClientError('publisher', error));
-        await subscriber.connect();
-        await publisher.connect();
+        await withConnectTimeout(subscriber.connect(), connectTimeoutMs);
+        await withConnectTimeout(publisher.connect(), connectTimeoutMs);
         await subscriber.subscribe(channel, async (message) => {
             try {
                 await onMessage(message);

package/dist/redis/redis-pubsub.js.map

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

package/dist/redis/redis.module.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado efêmero compartilhado entre as réplicas da API.
+ *
+ * `@Global` porque a conexão é um recurso de processo: cada módulo que
+ * importasse este abriria seu próprio client para o mesmo Redis, e com 4
+ * réplicas isso multiplica conexões sem ganho nenhum. Mesmo motivo de o
+ * `RealtimeService` ser um só.
+ */
+export declare class RedisModule {
+}
+//# sourceMappingURL=redis.module.d.ts.map

package/dist/redis/redis.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.module.d.ts","sourceRoot":"","sources":["../../src/redis/redis.module.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,qBAKa,WAAW;CAAG"}

package/dist/redis/redis.module.js

@@ -0,0 +1,30 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisModule = void 0;
+const common_1 = require("@nestjs/common");
+const redis_kv_service_1 = require("./redis-kv.service");
+/**
+ * Estado efêmero compartilhado entre as réplicas da API.
+ *
+ * `@Global` porque a conexão é um recurso de processo: cada módulo que
+ * importasse este abriria seu próprio client para o mesmo Redis, e com 4
+ * réplicas isso multiplica conexões sem ganho nenhum. Mesmo motivo de o
+ * `RealtimeService` ser um só.
+ */
+let RedisModule = class RedisModule {
+};
+exports.RedisModule = RedisModule;
+exports.RedisModule = RedisModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [redis_kv_service_1.RedisKvService],
+        exports: [redis_kv_service_1.RedisKvService],
+    })
+], RedisModule);
+//# sourceMappingURL=redis.module.js.map

package/dist/redis/redis.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.module.js","sourceRoot":"","sources":["../../src/redis/redis.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,yDAAoD;AAEpD;;;;;;;GAOG;AAMI,IAAM,WAAW,GAAjB,MAAM,WAAW;CAAG,CAAA;AAAd,kCAAW;sBAAX,WAAW;IALvB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,iCAAc,CAAC;QAC3B,OAAO,EAAE,CAAC,iCAAc,CAAC;KAC1B,CAAC;GACW,WAAW,CAAG"}

package/dist/session/session.controller.d.ts

@@ -33,15 +33,19 @@ export declare class SessionController {
         id: number;
         user_id: number;
         user_agent: string;
-        impersonator_user_id: number | null;
         created_at: Date;
+        impersonator_user_id: number | null;
         updated_at: Date;
         hash: string;
-        browser_id: string | null;
         ip_address: string;
         revoked_at: Date | null;
         expires_at: Date;
+        browser_id: string | null;
         impersonation_reason: string | null;
+        previous_hash: string | null;
+        previous_hash_expires_at: Date | null;
+        audience: string | null;
+        oauth_client_id: string | null;
     }>;
 }
 //# sourceMappingURL=session.controller.d.ts.map

package/dist/session/session.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.controller.d.ts","sourceRoot":"","sources":["../../src/session/session.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,qBAEa,iBAAiB;IAEtB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAI7C,qBAAqB,CACT,gBAAgB,EAAE,aAAa,EACrC,EAAE,EAAE,EAAE;;KAAA,EACJ,MAAM,EAAE,MAAM;;;;;;;IAMtB,eAAe,CACH,gBAAgB,EAAE,aAAa,EACrC,EAAE,EAAE,EAAE;;KAAA,EACJ,MAAM,EAAE,MAAM;;;;;;;IAMtB,sBAAsB,CAAS,EAAE,EAAE,EAAE;;KAAA,EAAa,SAAS,EAAE,MAAM;IAKnE,iBAAiB,CAAS,EAAE,EAAE,EAAE;;KAAA;IAKhC,aAAa,CACP,EAAE,EAAE,EAAE,MAAM,EAAE;;KAAA,EACY,SAAS,EAAE,MAAM,EACzC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;CAI/B"}
+{"version":3,"file":"session.controller.d.ts","sourceRoot":"","sources":["../../src/session/session.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,qBAEa,iBAAiB;IAEtB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAI7C,qBAAqB,CACT,gBAAgB,EAAE,aAAa,EACrC,EAAE,EAAE,EAAE;;KAAA,EACJ,MAAM,EAAE,MAAM;;;;;;;IAMtB,eAAe,CACH,gBAAgB,EAAE,aAAa,EACrC,EAAE,EAAE,EAAE;;KAAA,EACJ,MAAM,EAAE,MAAM;;;;;;;IAMtB,sBAAsB,CAAS,EAAE,EAAE,EAAE;;KAAA,EAAa,SAAS,EAAE,MAAM;IAKnE,iBAAiB,CAAS,EAAE,EAAE,EAAE;;KAAA;IAKhC,aAAa,CACP,EAAE,EAAE,EAAE,MAAM,EAAE;;KAAA,EACY,SAAS,EAAE,MAAM,EACzC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;CAI/B"}