@gaonjs/config 0.14.1 → 0.15.2

package/dist/wire.d.ts

@@ -16,7 +16,12 @@ export interface WiredGaon {
 /** 도메인 배터리 배선 결과 — serve·work 가 공유한다. closeDomain() 으로 뒤집는다. */
 export interface WiredDomain {
     readonly config: GaonConfig;
-    /** DB 커넥션 파기 · storage/i18n 리셋(배선 역순). */
+    /**
+     * 락·캐시 백엔드용 Redis 커넥션(결정 202 · config.redis 있을 때). serve·work 공유 — wireGaon
+     * 은 이걸 세션 스토어로도 재사용한다(프로세스당 커넥션 1개). 없으면 undefined.
+     */
+    readonly redis?: Redis;
+    /** DB 커넥션 파기 · storage/i18n 리셋 · 락/캐시 백엔드 해제 · redis 종료(배선 역순). */
     closeDomain(): Promise<void>;
 }
 /**

package/dist/wire.js

@@ -11,8 +11,8 @@ import { createDb, registerConnection, destroyAllConnections, getConnection, has
 import { connectNats, configureJobs, configureEvents, outboxServiceTxWrapper, ensureOutboxTable, setLockBackend, redisLockBackend, memoryLockBackend, } from '@gaonjs/async';
 import { configureMailer, smtpTransport } from '@gaonjs/mail';
 import { configureStorage, localDisk, s3Disk, resetStorage } from '@gaonjs/storage';
-import { configureI18n, loadLocales, resetI18n, detectLanguage, enterLanguage, languages, } from '@gaonjs/i18n';
-import { createApp, redisSessionStore } from '@gaonjs/web';
+import { configureI18n, loadLocales, resetI18n, detectLanguage, enterLanguage, languages, t, } from '@gaonjs/i18n';
+import { createApp, redisSessionStore, setValidationMessageResolver, } from '@gaonjs/web';
 import { resolveApps, toAppSpec } from './apps.js';
 import { existsSync } from 'node:fs';
 import { resolve as resolvePath, join } from 'node:path';
@@ -36,9 +36,30 @@ export async function wireDomain(config, cwd = process.cwd()) {
     //       하네스가 공유한다(결정 136 · gaon test 도 이 경로를 태워야 스토리지·메일
     //       잡이 테스트에서 실제로 돈다).
     await configureNonDbBatteries(config, root);
+    // 5) 락·캐시 백엔드(결정 202 · 결정 147·148) — **serve·work 공통**. 잡·서비스가 `lock()`·
+    //    캐시를 쓰려면 work 프로세스에도 백엔드가 있어야 한다(이전엔 wireGaon[serve]에만 있어
+    //    워커의 lock() 이 "백엔드 미설정" throw · kitchen-sink 중첩 방지 배터리 발견). redis 가
+    //    있으면 진짜 분산 락(SET NX PX)·Redis 캐시, 없으면 dev/테스트 in-memory 폴백(락은 결정
+    //    88① 로 prod 미설정 시 미배선 유지 → 사용 시 수리 안내 throw). 이 redis 는 wireGaon 이
+    //    세션 스토어로도 재사용한다(프로세스당 커넥션 1개).
+    let redis;
+    if (config.redis) {
+        redis = new Redis(config.redis.url, { lazyConnect: false, maxRetriesPerRequest: 3 });
+        setLockBackend(redisLockBackend(redis));
+        setCacheBackend(redisCacheBackend(redis));
+    }
+    else if (process.env.NODE_ENV !== 'production') {
+        setLockBackend(memoryLockBackend());
+    }
     return {
         config,
+        redis,
         async closeDomain() {
+            // 배선 역순 — 백엔드 해제(다음 인스턴스 누출 방지 · 결정 147·148) → redis 종료 → DB·기타.
+            setLockBackend(undefined);
+            setCacheBackend(undefined);
+            if (redis)
+                redis.disconnect();
             await destroyAllConnections();
             resetStorage();
             resetI18n();
@@ -102,6 +123,11 @@ export async function configureNonDbBatteries(config, cwd = process.cwd(), opts
             fallbackLng: config.i18n.fallbackLng,
             supportedLngs: config.i18n.supportedLngs,
         });
+        // 결정 183(옵션 C): 검증 사유를 요청 로케일로 로케일화한다. web 은 안정적 코드만
+        // 노출하고, 앱이 locales/ 의 예약 namespace `validation.<code>` 로 번역을 준다.
+        // 키가 없으면 defaultValue(web 내장 fallback)로 떨어져 거동이 보존된다. t() 는
+        // 요청 ALS 로케일을 따르므로 검증 시점(dispatch)에 요청 언어로 번역된다.
+        setValidationMessageResolver((code, params, fallback) => t(`validation.${code}`, { ...params, defaultValue: fallback }));
     }
 }
 /**
@@ -120,24 +146,10 @@ export async function wireGaon(config, cwd = process.cwd()) {
     // 1) 도메인 배터리(DB 커넥션·메일·스토리지·i18n) — serve·work 공통 경로(결정 129).
     //    잡 핸들러가 모델·메일을 쓰려면 work 도 같은 배선을 태워야 한다.
     const domain = await wireDomain(config, cwd);
-    // 2) Redis — 세션 스토어. 앱 스펙 조립 시 세션 옵션에 주입한다.
-    let redis;
-    if (config.redis) {
-        redis = new Redis(config.redis.url, { lazyConnect: false, maxRetriesPerRequest: 3 });
-    }
-    // 결정 147: 분산 락 백엔드 배선. redis 가 있으면 진짜 분산 락(Redis SET NX PX),
-    // 없으면 dev/테스트용 in-memory 폴백을 심는다. prod 에서 redis 미설정이면 여기서
-    // 아무 것도 안 심어 lock() 은 미설정 백엔드로 남아 사용 시 수리 안내로 throw 한다
-    // (로컬 뮤텍스로 조용히 떨어지지 않는다 · 결정 88 ①).
-    if (redis)
-        setLockBackend(redisLockBackend(redis));
-    else if (process.env.NODE_ENV !== 'production')
-        setLockBackend(memoryLockBackend());
-    // 결정 148: 캐시 백엔드 배선. redis 가 있으면 Redis 캐시(§7.4), 없으면 data 의
-    // 기본 in-memory 폴백을 그대로 둔다(캐시는 best-effort 라 미설정 폴백이 안전 ·
-    // 락과 다른 지점 · 결정 147).
-    if (redis)
-        setCacheBackend(redisCacheBackend(redis));
+    // 2) Redis — 세션 스토어. 결정 202: 락·캐시 백엔드 배선과 함께 wireDomain 이 소유하는
+    //    커넥션을 재사용한다(serve·work 공통 경로 · 프로세스당 커넥션 1개). 세션은 웹 전용이라
+    //    여기서 앱 스펙에 주입만 한다(백엔드 배선은 wireDomain 이 이미 완료).
+    const redis = domain.redis;
     // 3) NATS — 웹 프로세스도 채널·잡·이벤트 publish 를 위해 연결한다.
     //    연결만으로는 부족하다 — 전송 런타임까지 배선해야 컨트롤러·서비스의
     //    `.later()`·`emit()` 이 실제로 publish 된다(work 는 runWork 가 이미 설정하지만
@@ -232,21 +244,32 @@ export async function wireGaon(config, cwd = process.cwd()) {
         redis,
         async close() {
             try {
-                await app.close();
+                // 결정 201(graceful drain): app.close 가 인플라이트 요청 완료를 기다리는 동안
+                // (createApp forceCloseConnections:false), idle keep-alive 커넥션은 스윕으로 즉시 닫아
+                // 종료가 keepAliveTimeout(기본 72s)까지 매달리지 않게 한다. closeIdleConnections 는
+                // 진행 중 요청 커넥션은 건드리지 않는다(실측) — 요청이 끝나 idle 가 되면 다음 스윕이 닫는다.
+                const closing = app.close();
+                const server = app.server;
+                const sweep = server && typeof server.closeIdleConnections === 'function'
+                    ? setInterval(() => server.closeIdleConnections(), 200)
+                    : undefined;
+                try {
+                    await closing;
+                }
+                finally {
+                    if (sweep)
+                        clearInterval(sweep);
+                }
             }
             catch {
                 /* 이미 닫혔을 수 있음 — graceful */
             }
             if (nats)
                 await nats.close();
-            if (redis)
-                redis.disconnect();
-            // 결정 147: 락 백엔드 배선 해제(다음 wireGaon 인스턴스로 누출 방지).
-            setLockBackend(undefined);
-            // 결정 148: 캐시 백엔드 배선 해제(메모리 폴백으로 되돌림 · 인스턴스 누출 방지).
-            setCacheBackend(undefined);
             // 결정 144: 서비스 트랜잭션 래퍼 배선 해제(다음 wireGaon 인스턴스로 누출 방지).
             setServiceTxWrapper(undefined);
+            // 결정 202: 락·캐시 백엔드 해제 + redis 종료는 closeDomain 이 소유한다(serve·work 공통 ·
+            // wireDomain 이 배선했으므로 해제도 거기서). serve 는 여기서 중복 해제하지 않는다.
             await domain.closeDomain();
         },
     };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gaonjs/config",
-  "version": "0.14.1",
-  "description": "Gaon 루트 설정 로더·자동 배선 (gaon.config.ts · §3.3 · M9-A)",
+  "version": "0.15.2",
+  "description": "Gaon 루트 설정 로더·자동 배선 (gaon.config.ts)",
   "type": "module",
   "license": "MIT",
   "homepage": "https://gaonjs.dev",
@@ -25,13 +25,13 @@
   ],
   "dependencies": {
     "ioredis": "^5.4.1",
-    "@gaonjs/async": "0.11.0",
-    "@gaonjs/core": "0.2.1",
-    "@gaonjs/data": "0.16.0",
-    "@gaonjs/storage": "0.1.2",
-    "@gaonjs/mail": "0.2.0",
-    "@gaonjs/i18n": "0.2.0",
-    "@gaonjs/web": "0.17.0"
+    "@gaonjs/async": "0.12.0",
+    "@gaonjs/i18n": "0.2.1",
+    "@gaonjs/storage": "0.1.3",
+    "@gaonjs/core": "0.2.2",
+    "@gaonjs/data": "0.16.1",
+    "@gaonjs/mail": "0.2.1",
+    "@gaonjs/web": "0.18.1"
   },
   "devDependencies": {
     "fastify": "^5.0.0"