@gaonjs/config 0.17.4 → 0.17.6

package/dist/wire.d.ts

@@ -3,13 +3,6 @@ import { Redis } from 'ioredis';
 import { type GaonNats } from '@gaonjs/async';
 import type { GaonConfig } from './types.js';
 import { type DiscoveredApp } from './apps.js';
-/**
- * 결정 230: gaon.config.ts 의 `timezone` 을 **실제로 배선**한다(이전엔 저장만·조용한 no-op).
- * process.env.TZ 를 세워 이후 Date·로깅 타임스탬프·스케줄러(크론)가 선언 타임존을 따르게 한다.
- * Node 는 런타임 TZ 변경을 반영한다(실측 · 첫 Date 사용 전에 부팅 경로에서 세운다). 유효하지
- * 않은 IANA 이름은 process.env.TZ 에 넣으면 조용히 UTC 로 떨어지므로, 넣기 전에 검증해
- * 부팅 에러(§7.5.3)로 알린다 — 또 다른 조용한 실패를 만들지 않는다.
- */
 export declare function applyTimezone(config: GaonConfig): void;
 /** 부팅 결과 — 이후 serve 가 listen 한다. close() 로 배선을 뒤집는다. */
 export interface WiredGaon {

package/dist/wire.js

@@ -7,6 +7,7 @@
 // 세션은 세션 옵션이 세팅된 앱에만 등록된다. AppSessionOptions.secret 은
 // 필수이므로 auth 앱은 명시적으로 secret 을 제공해야 한다(env 로 주입 권장).
 import { Redis } from 'ioredis';
+import { log } from '@gaonjs/core';
 import { createDb, registerConnection, destroyAllConnections, getConnection, hasConnection, setServiceTxWrapper, setCacheBackend, redisCacheBackend, } from '@gaonjs/data';
 import { connectNats, configureJobs, configureEvents, outboxServiceTxWrapper, ensureOutboxTable, setLockBackend, redisLockBackend, memoryLockBackend, } from '@gaonjs/async';
 import { configureMailer, smtpTransport } from '@gaonjs/mail';
@@ -23,6 +24,38 @@ import { resolve as resolvePath, join } from 'node:path';
  * 않은 IANA 이름은 process.env.TZ 에 넣으면 조용히 UTC 로 떨어지므로, 넣기 전에 검증해
  * 부팅 에러(§7.5.3)로 알린다 — 또 다른 조용한 실패를 만들지 않는다.
  */
+/**
+ * A6(결정 262): Redis 부팅 도달성을 상한 시간 안에 확인한다. ping 이 상한 안에 응답하지
+ * 않으면(다운·URL 오타·방화벽) 수리 안내를 담아 throw 한다 — 상위(mid-wire catch)가 부분
+ * 핸들을 정리하고 rethrow 해 serve 가 확정 종료(exit 1)한다. 정상 Redis 면 ping 이 즉시
+ * 응답해 부팅 지연이 없다. 상한은 GAON_REDIS_PROBE_MS(기본 10000)로 조정 가능하다.
+ */
+async function assertRedisReachable(redis, url) {
+    const raw = Number(process.env.GAON_REDIS_PROBE_MS);
+    const probeMs = Number.isFinite(raw) && raw > 0 ? raw : 10000;
+    const ping = redis.ping();
+    // 레이스 패자가 나중에 reject 해도 미처리(unhandledRejection) 되지 않게 미리 삼킨다.
+    ping.catch(() => { });
+    let timer;
+    try {
+        await Promise.race([
+            ping,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`ping 응답 없음(${probeMs}ms 초과)`)), probeMs);
+            }),
+        ]);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`[@gaonjs/config] Redis 연결 실패 (${url}): ${msg}\n` +
+            `→ 개발 인프라를 기동하세요: gaon dev (또는 docker compose up -d redis)\n` +
+            `→ 접속지를 확인하세요: gaon.config 의 redis.url 또는 환경변수 REDIS_URL (.env.example 참조).`);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
 export function applyTimezone(config) {
     const tz = config.timezone;
     if (tz === undefined)
@@ -84,6 +117,15 @@ export async function wireDomain(config, cwd = process.cwd()) {
         //    세션 스토어로도 재사용한다(프로세스당 커넥션 1개).
         if (config.redis) {
             redis = new Redis(config.redis.url, { lazyConnect: false, maxRetriesPerRequest: 3 });
+            // A6(FINAL-AUDIT-2026-08-04 · 결정 262): 부팅 시 Redis 도달성을 fail-loud 로 확인한다
+            // (DB 결정 250/252 와 대칭). 이전엔 error 리스너·접속 확인이 없어 Redis 다운·URL 오타에도
+            // wireGaon 이 정상 반환 → serve 가 green 부팅하고 세션·락·캐시가 요청 시점에야 타임아웃
+            // 파손했다(무신호). 배경 재접속 에러(부팅 후 순단)는 ioredis 가 명령 단위로 처리하므로
+            // 리스너로 받아 프로세스 크래시(unhandled 'error' 이벤트)만 막는다.
+            redis.on('error', (err) => {
+                log.debug('config: redis 배경 에러(재접속은 ioredis 가 처리)', { err: err.message });
+            });
+            await assertRedisReachable(redis, config.redis.url);
             setLockBackend(redisLockBackend(redis));
             setCacheBackend(redisCacheBackend(redis));
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/config",
-  "version": "0.17.4",
+  "version": "0.17.6",
   "description": "Gaon 루트 설정 로더·자동 배선 (gaon.config.ts)",
   "type": "module",
   "license": "MIT",
@@ -25,13 +25,13 @@
   ],
   "dependencies": {
     "ioredis": "^5.4.1",
-    "@gaonjs/async": "0.15.0",
-    "@gaonjs/data": "0.17.0",
-    "@gaonjs/i18n": "0.2.2",
-    "@gaonjs/mail": "0.3.0",
-    "@gaonjs/core": "0.2.3",
-    "@gaonjs/storage": "0.1.4",
-    "@gaonjs/web": "0.19.4"
+    "@gaonjs/async": "0.15.2",
+    "@gaonjs/core": "0.2.4",
+    "@gaonjs/mail": "0.3.1",
+    "@gaonjs/data": "0.17.1",
+    "@gaonjs/storage": "0.1.5",
+    "@gaonjs/web": "0.20.1",
+    "@gaonjs/i18n": "0.2.3"
   },
   "devDependencies": {
     "fastify": "^5.0.0"