@gaonjs/config 0.23.0 → 0.25.0

package/dist/testkit.d.ts

@@ -1,7 +1,18 @@
+import { type MongoConnectionConfig } from '@gaonjs/data';
 export interface TestDbHandle {
     /** 등록한 모든 커넥션을 종료하고 배터리를 리셋한다(afterAll 에서 호출). */
     close(): Promise<void>;
 }
+/**
+ * 문서형(mongodb) 커넥션을 테스트용으로 파생한다 — SQL 의 `<db>_test`(결정 111)와 대칭.
+ * 몽고는 CREATE DATABASE 가 없어(첫 쓰기에 생성) 미리 만들 것이 없고, 이름만 갈라도
+ * 개발 DB 를 테스트가 건드리지 않는다. `database` 를 채워 돌려주면 adapter-mongo 가
+ * dbName 으로 우선 적용한다(결정 364 — url 경로보다 database 가 이긴다).
+ *
+ * url·database 가 둘 다 없으면 그대로 돌려준다 — openMongoConnection 이 무신호
+ * 오배선(기본 DB `test`)을 fail-loud 로 막는 자기 안내를 그대로 내게 둔다(결정 335).
+ */
+export declare function deriveMongoTestConfig(cfg: MongoConnectionConfig): MongoConnectionConfig;
 /**
  * 테스트용 DB 커넥션 + DB 외 배터리(mail·storage·i18n)를 배선한다(결정 111·136).
  * 각 커넥션을 `<db>_test` 로 파생해 poolMax:1 로 붙이고, 스토리지·메일을 테스트

package/dist/testkit.js

@@ -4,6 +4,10 @@
 // 만들어 마이그레이션한 그 DB 다. 스캐폴드 `test/setup.ts` 가 부트스트랩으로 쓰고,
 // 매 테스트 뒤 `truncateAll()` 로 격리한다(§9 실 인프라 · 근거는 결정 111).
 //
+// 문서형(mongodb) 커넥션도 **등록한다**(`<db>_test` · deriveMongoTestConfig) — 다만
+// SQL 전용 프로비저닝(CREATE DATABASE + 마이그레이션)과 트랜잭션 롤백/truncate 격리는
+// 타지 않는다(§7.3 · 결정 279 — 문서형은 각 테스트가 deleteMany 로 자기 정리).
+//
 // Redis·NATS 는 배선하지 않는다(웹 전용). mail·storage·i18n 은 serve·work 와 같은
 // 경로(configureNonDbBatteries)로 배선한다 — 스토리지·메일을 쓰는 잡·서비스가
 // 테스트에서도 운영과 같은 코드로 돌아야 한다(결정 136 · "wireDomain 안 태워 테스트만
@@ -15,6 +19,30 @@ import { resetStorage } from '@gaonjs/storage';
 import { resetI18n } from '@gaonjs/i18n';
 import { connectNats, configureJobs, configureEvents, configureBroadcast, resetJobs, resetEvents, resetBroadcast, outboxServiceTxWrapper, ensureOutboxTable, relayOutboxBatch, setOutboxDrainer, setLockBackend, memoryLockBackend, } from '@gaonjs/async';
 import { createDb, registerConnection, deriveTestDatabaseConfig, destroyAllConnections, setServiceTxWrapper, setCacheBackend, memoryCacheBackend, getConnection, hasConnection, } from '@gaonjs/data';
+/**
+ * 문서형 커넥션의 url 에서 DB 경로를 뽑는다. `new URL` 은 멀티 호스트
+ * (`mongodb://h1:1,h2:2/db`)에서 포트 파싱이 깨지므로 스킴·호스트를 문자열로 벗긴다
+ * (adapter-mongo 의 urlHasDbPath 와 같은 이유 · 결정 364).
+ */
+function mongoDbNameFromUrl(url) {
+    const noScheme = url.replace(/^mongodb(\+srv)?:\/\//, '');
+    return (noScheme.split('/').slice(1).join('/').split('?')[0] ?? '').trim();
+}
+/**
+ * 문서형(mongodb) 커넥션을 테스트용으로 파생한다 — SQL 의 `<db>_test`(결정 111)와 대칭.
+ * 몽고는 CREATE DATABASE 가 없어(첫 쓰기에 생성) 미리 만들 것이 없고, 이름만 갈라도
+ * 개발 DB 를 테스트가 건드리지 않는다. `database` 를 채워 돌려주면 adapter-mongo 가
+ * dbName 으로 우선 적용한다(결정 364 — url 경로보다 database 가 이긴다).
+ *
+ * url·database 가 둘 다 없으면 그대로 돌려준다 — openMongoConnection 이 무신호
+ * 오배선(기본 DB `test`)을 fail-loud 로 막는 자기 안내를 그대로 내게 둔다(결정 335).
+ */
+export function deriveMongoTestConfig(cfg) {
+    const base = cfg.database ?? (cfg.url ? mongoDbNameFromUrl(cfg.url) : '');
+    if (!base)
+        return cfg;
+    return { ...cfg, database: base.endsWith('_test') ? base : `${base}_test` };
+}
 /**
  * 테스트용 DB 커넥션 + DB 외 배터리(mail·storage·i18n)를 배선한다(결정 111·136).
  * 각 커넥션을 `<db>_test` 로 파생해 poolMax:1 로 붙이고, 스토리지·메일을 테스트
@@ -22,13 +50,24 @@ import { createDb, registerConnection, deriveTestDatabaseConfig, destroyAllConne
  */
 export async function connectTestDatabase(cwd = process.cwd()) {
     const config = await loadGaonConfig(cwd);
+    // 문서형(mongodb) 커넥션을 하나라도 열었는지 — close() 에서 몽고 레지스트리를 닫을지 결정한다
+    // (wireDomain 의 mongoOpened 와 대칭 · 결정 280).
+    let mongoOpened = false;
     if (config.db) {
         for (const [key, cfg] of Object.entries(config.db)) {
             const base = cfg;
-            // 결정 279(§7.3): 문서형(mongodb)은 SQL 테스트 프로비저닝(<db>_test + CREATE DATABASE)을
-            // 타지 않는다 — 몽고 테스트 격리는 전용 DB + deleteMany 로 각 통합 테스트가 직접 수행한다.
-            if (base.adapter === 'mongodb')
+            // 결정 279(§7.3): 문서형(mongodb)은 SQL 테스트 프로비저닝(CREATE DATABASE + 마이그레이션)을
+            // 타지 않는다 — 몽고는 첫 쓰기에 DB 가 생기고 격리는 각 테스트의 deleteMany 가 한다.
+            // 다만 **등록은 한다** — 이전엔 통째로 continue 라 테스트 안 collection() 호출이
+            // "Mongo 커넥션 '<키>' 이(가) 등록되지 않았습니다" 로 깨졌다(serve·work 는 wireDomain 이
+            // 여는데 테스트 레인만 빠진 비대칭 · 결정 136 의 "테스트에서만 깨지던" 사각과 동형).
+            // 이름은 `<db>_test` 로 갈라 개발 DB 를 테스트가 건드리지 않게 한다(SQL 대칭).
+            if (base.adapter === 'mongodb') {
+                const { openMongoConnection } = await import('@gaonjs/adapter-mongo');
+                await openMongoConnection(key, deriveMongoTestConfig(base));
+                mongoOpened = true;
                 continue;
+            }
             const testCfg = deriveTestDatabaseConfig({ ...base, poolMax: 1 });
             registerConnection(key, createDb(testCfg), base.adapter);
         }
@@ -74,6 +113,12 @@ export async function connectTestDatabase(cwd = process.cwd()) {
     return {
         close: async () => {
             await destroyAllConnections();
+            if (mongoOpened) {
+                // 결정 280: 문서형 커넥션이 열렸으면 몽고 레지스트리도 닫는다(SQL 과 대칭 · 배선 역순).
+                // 안 닫으면 열린 소켓이 이벤트 루프를 붙잡아 vitest 프로세스가 종료하지 못한다.
+                const { closeMongoConnections } = await import('@gaonjs/adapter-mongo');
+                await closeMongoConnections();
+            }
             resetStorage();
             resetI18n();
             // 결정 249: 락·캐시 백엔드 해제(다음 테스트 파일로 상태 누출 방지 · wireDomain.closeDomain 대칭).

package/dist/wire.js

@@ -401,6 +401,11 @@ async function assembleApp(config, root, domain, redis, nats) {
         apps: specs,
         version: config.web?.assetsVersion,
         cookieSecret: config.web?.cookieSecret,
+        // 결정 431: 프로세스 공용 redis(gaon.config 의 redis)를 web 에 넘긴다 — seal 의 replay
+        // nonce store 가 **세션 없는 앱**에서도 공유 store 를 타게 하는 폴백이다. 이전엔 seal 이
+        // spec.session?.redis 만 봐서, REDIS_URL 을 구성해도 세션을 안 쓰는 seal 앱(JWT API)은
+        // in-memory nonce(프로세스별 격리)로 조용히 떨어졌다. 세션 저장소 배선은 그대로다.
+        redis,
         // 결정 159(W1): i18n 설정이 있으면 매 요청 로케일을 협상해 ALS 에 심는다(자동 배선).
         // createApp 의 onRequest 슬롯이 이 통로다(web↔i18n 결합 회피). 이게 없으면
         // detectLanguage·enterLanguage 가 죽은 코드라 t() 가 항상 fallback 이었다(반쪽 배선).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/config",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Gaon 루트 설정 로더·자동 배선 (gaon.config.ts)",
   "type": "module",
   "license": "MIT",
@@ -30,14 +30,14 @@
   ],
   "dependencies": {
     "ioredis": "^5.4.1",
-    "@gaonjs/adapter-mongo": "0.4.0",
-    "@gaonjs/async": "0.18.0",
-    "@gaonjs/core": "0.2.4",
+    "@gaonjs/adapter-mongo": "0.4.2",
     "@gaonjs/i18n": "0.3.0",
+    "@gaonjs/data": "0.25.2",
+    "@gaonjs/async": "0.18.1",
+    "@gaonjs/core": "0.2.4",
     "@gaonjs/mail": "0.5.0",
-    "@gaonjs/data": "0.25.0",
     "@gaonjs/storage": "0.1.5",
-    "@gaonjs/web": "0.29.0"
+    "@gaonjs/web": "0.30.0"
   },
   "devDependencies": {
     "fastify": "^5.0.0"