@gaonjs/config 0.9.1 → 0.10.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { defineConfig, defineAppConfig, type GaonConfig, type AppConfig, type AppSessionConfig, type DbConfig, type RedisConfig, type NatsConfig, type HubConfig, type MailConfig, type StorageConfig, type StorageDiskConfig, type I18nConfig, type WebConfig, } from './types.js';
 export { loadGaonConfig, findConfigPath } from './load.js';
 export { resolveApps, toAppSpec, type DiscoveredApp, } from './apps.js';
-export { wireGaon, type WiredGaon } from './wire.js';
+export { wireGaon, wireDomain, type WiredGaon, type WiredDomain } from './wire.js';
 export { connectTestDatabase, type TestDbHandle } from './testkit.js';

package/dist/index.js

@@ -9,6 +9,6 @@
 export { defineConfig, defineAppConfig, } from './types.js';
 export { loadGaonConfig, findConfigPath } from './load.js';
 export { resolveApps, toAppSpec, } from './apps.js';
-export { wireGaon } from './wire.js';
+export { wireGaon, wireDomain } from './wire.js';
 // 테스트 DB 배선 (결정 111 · gaon test 격리)
 export { connectTestDatabase } from './testkit.js';

package/dist/wire.d.ts

@@ -13,6 +13,20 @@ export interface WiredGaon {
     /** graceful 종료 — Fastify · NATS · Redis · DB 를 순서대로 닫는다. */
     close(): Promise<void>;
 }
+/** 도메인 배터리 배선 결과 — serve·work 가 공유한다. closeDomain() 으로 뒤집는다. */
+export interface WiredDomain {
+    readonly config: GaonConfig;
+    /** DB 커넥션 파기 · storage/i18n 리셋(배선 역순). */
+    closeDomain(): Promise<void>;
+}
+/**
+ * gaon.config.ts 의 **프로세스 전역 도메인 배터리**(DB 커넥션·메일·스토리지·
+ * i18n)를 배선한다. serve(웹)와 work(워커)가 함께 태우는 공통 경로다 — 잡
+ * 핸들러가 모델을 읽고(registerConnection) 메일을 보내려면(configureMailer)
+ * work 프로세스에도 같은 배선이 있어야 한다(결정 129). 웹 전용 배선(Redis
+ * 세션·NATS 잡 발행·Fastify)은 여기 두지 않는다 — wireGaon 이 이 위에 얹는다.
+ */
+export declare function wireDomain(config: GaonConfig, cwd?: string): Promise<WiredDomain>;
 /**
  * gaon.config.ts + apps/ 를 바탕으로 배터리를 배선하고 Fastify 앱을 만든다.
  *

package/dist/wire.js

@@ -17,41 +17,22 @@ import { resolveApps, toAppSpec } from './apps.js';
 import { existsSync } from 'node:fs';
 import { resolve as resolvePath, join } from 'node:path';
 /**
- * gaon.config.ts + apps/ 를 바탕으로 배터리를 배선하고 Fastify 앱을 만든다.
- *
- * 배선 순서(의존):
- *  1) DB — 다른 배터리가 이미 configureX 시점에 커넥션을 만지지는 않지만,
- *     사용 시점(모델 조회)에 필요. 실패는 즉시 던진다.
- *  2) Redis — 세션 배터리가 쓴다. redis 인스턴스는 앱 스펙 조립 시 주입.
- *  3) NATS — 실시간(웹) · 비동기 잡(work)이 공유. 여기서는 웹만 배선.
- *  4) mail · storage · i18n — 프로세스 전역 configureX() 호출.
- *  5) createApp — 위에서 만든 세션·realtime 설정을 담아 Fastify 인스턴스 생성.
+ * gaon.config.ts 의 **프로세스 전역 도메인 배터리**(DB 커넥션·메일·스토리지·
+ * i18n)를 배선한다. serve(웹)와 work(워커)가 함께 태우는 공통 경로다 — 잡
+ * 핸들러가 모델을 읽고(registerConnection) 메일을 보내려면(configureMailer)
+ * work 프로세스에도 같은 배선이 있어야 한다(결정 129). 웹 전용 배선(Redis
+ * 세션·NATS 잡 발행·Fastify)은 여기 두지 않는다 — wireGaon 이 이 위에 얹는다.
  */
-export async function wireGaon(config, cwd = process.cwd()) {
+export async function wireDomain(config, cwd = process.cwd()) {
     const root = resolvePath(cwd);
-    // 1) DB 커넥션 — 키별로 등록. 실 연결 검증은 첫 쿼리에서(pool 은 lazy).
+    // 1) DB 커넥션 — 키별로 등록(main + 명명 커넥션 · §4.5). 실 연결은 첫 쿼리에서(pool lazy).
     if (config.db) {
         for (const [key, cfg] of Object.entries(config.db)) {
             const db = createDb(cfg);
             registerConnection(key, db, cfg.adapter);
         }
     }
-    // 2) Redis — 세션 스토어. 앱 스펙 조립 시 세션 옵션에 주입한다.
-    let redis;
-    if (config.redis) {
-        redis = new Redis(config.redis.url, { lazyConnect: false, maxRetriesPerRequest: 3 });
-    }
-    // 3) NATS — 웹 프로세스도 채널·잡 publish 를 위해 연결한다.
-    //    연결만으로는 부족하다 — 잡 전송 런타임(configureJobs)까지 배선해야
-    //    컨트롤러의 `.later()` 가 실제로 publish 된다. 이걸 빠뜨리면 웹에서
-    //    잡 발행 시 "잡 전송이 설정되지 않았습니다" 로 깨진다(work 는 runWork
-    //    가 이미 설정하지만 serve 는 여기서 해야 한다).
-    let nats;
-    if (config.nats) {
-        nats = await connectNats({ servers: config.nats.url, name: config.nats.name ?? 'gaon-serve' });
-        configureJobs(nats);
-    }
-    // 4) mail — SMTP 전송(개발은 MailPit, 운영은 실 SMTP).
+    // 2) mail — SMTP 전송(개발은 MailPit, 운영은 실 SMTP).
     if (config.mail) {
         const m = config.mail;
         configureMailer({
@@ -64,7 +45,7 @@ export async function wireGaon(config, cwd = process.cwd()) {
             defaultFrom: m.defaultFrom,
         });
     }
-    // 4') storage — 로컬(기본) 또는 S3.
+    // 3) storage — 로컬(기본) 또는 S3.
     if (config.storage) {
         const disks = {};
         for (const [name, d] of Object.entries(config.storage.disks)) {
@@ -88,7 +69,7 @@ export async function wireGaon(config, cwd = process.cwd()) {
         }
         configureStorage({ default: config.storage.default, disks });
     }
-    // 4'') i18n — locales/ 로드 후 초기화.
+    // 4) i18n — locales/ 로드 후 초기화.
     if (config.i18n) {
         const dir = config.i18n.dir ?? 'locales';
         const abs = dir.startsWith('/') ? dir : join(root, dir);
@@ -99,6 +80,46 @@ export async function wireGaon(config, cwd = process.cwd()) {
             supportedLngs: config.i18n.supportedLngs,
         });
     }
+    return {
+        config,
+        async closeDomain() {
+            await destroyAllConnections();
+            resetStorage();
+            resetI18n();
+        },
+    };
+}
+/**
+ * gaon.config.ts + apps/ 를 바탕으로 배터리를 배선하고 Fastify 앱을 만든다.
+ *
+ * 배선 순서(의존):
+ *  1) DB — 다른 배터리가 이미 configureX 시점에 커넥션을 만지지는 않지만,
+ *     사용 시점(모델 조회)에 필요. 실패는 즉시 던진다.
+ *  2) Redis — 세션 배터리가 쓴다. redis 인스턴스는 앱 스펙 조립 시 주입.
+ *  3) NATS — 실시간(웹) · 비동기 잡(work)이 공유. 여기서는 웹만 배선.
+ *  4) mail · storage · i18n — 프로세스 전역 configureX() 호출.
+ *  5) createApp — 위에서 만든 세션·realtime 설정을 담아 Fastify 인스턴스 생성.
+ */
+export async function wireGaon(config, cwd = process.cwd()) {
+    const root = resolvePath(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 });
+    }
+    // 3) NATS — 웹 프로세스도 채널·잡 publish 를 위해 연결한다.
+    //    연결만으로는 부족하다 — 잡 전송 런타임(configureJobs)까지 배선해야
+    //    컨트롤러의 `.later()` 가 실제로 publish 된다. 이걸 빠뜨리면 웹에서
+    //    잡 발행 시 "잡 전송이 설정되지 않았습니다" 로 깨진다(work 는 runWork
+    //    가 이미 설정하지만 serve 는 여기서 해야 한다).
+    let nats;
+    if (config.nats) {
+        nats = await connectNats({ servers: config.nats.url, name: config.nats.name ?? 'gaon-serve' });
+        configureJobs(nats);
+    }
     // 5) 앱 스캔 · createApp.
     const apps = await resolveApps(root);
     const specs = apps.map((a) => {
@@ -170,9 +191,7 @@ export async function wireGaon(config, cwd = process.cwd()) {
                 await nats.close();
             if (redis)
                 redis.disconnect();
-            await destroyAllConnections();
-            resetStorage();
-            resetI18n();
+            await domain.closeDomain();
         },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/config",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "Gaon 루트 설정 로더·자동 배선 (gaon.config.ts · §3.3 · M9-A)",
   "type": "module",
   "license": "MIT",
@@ -25,13 +25,13 @@
   ],
   "dependencies": {
     "ioredis": "^5.4.1",
-    "@gaonjs/async": "0.7.0",
-    "@gaonjs/core": "0.2.1",
-    "@gaonjs/data": "0.13.1",
+    "@gaonjs/async": "0.8.0",
     "@gaonjs/i18n": "0.1.2",
+    "@gaonjs/data": "0.13.1",
     "@gaonjs/mail": "0.1.3",
+    "@gaonjs/core": "0.2.1",
     "@gaonjs/storage": "0.1.2",
-    "@gaonjs/web": "0.12.0"
+    "@gaonjs/web": "0.13.1"
   },
   "devDependencies": {
     "fastify": "^5.0.0"