@gaonjs/config 0.10.0 → 0.12.0

package/dist/testkit.d.ts

@@ -1,9 +1,10 @@
 export interface TestDbHandle {
-    /** 등록한 모든 커넥션을 종료한다(afterAll 에서 호출). */
+    /** 등록한 모든 커넥션을 종료하고 배터리를 리셋한다(afterAll 에서 호출). */
     close(): Promise<void>;
 }
 /**
- * 테스트용 DB 커넥션을 등록한다(결정 111). 각 커넥션을 `<db>_test` 로 파생해
- * poolMax:1 로 붙인다. 반환값의 close() 를 afterAll 에서 호출해 정리한다.
+ * 테스트용 DB 커넥션 + DB 외 배터리(mail·storage·i18n)를 배선한다(결정 111·136).
+ * 각 커넥션을 `<db>_test` 로 파생해 poolMax:1 로 붙이고, 스토리지·메일을 테스트
+ * 격리 값으로 배선한다. 반환값의 close() 를 afterAll 에서 호출해 정리한다.
  */
 export declare function connectTestDatabase(cwd?: string): Promise<TestDbHandle>;

package/dist/testkit.js

@@ -1,15 +1,23 @@
-// @gaonjs/config · 테스트 DB 커넥션 배선 (결정 111)
+// @gaonjs/config · 테스트 DB·배터리 배선 (결정 111 · 결정 136)
 //
 // gaon.config 의 각 커넥션을 `<db>_test` 로 파생해 등록한다 — `gaon test` 가 미리
 // 만들어 마이그레이션한 그 DB 다. 스캐폴드 `test/setup.ts` 가 부트스트랩으로 쓰고,
 // 매 테스트 뒤 `truncateAll()` 로 격리한다(§9 실 인프라 · 근거는 결정 111).
 //
-// wireGaon 과 달리 Redis·NATS·mail 은 배선하지 않는다 — DB 격리만 담당한다.
+// Redis·NATS 는 배선하지 않는다(웹 전용). mail·storage·i18n 은 serve·work 와 같은
+// 경로(configureNonDbBatteries)로 배선한다 — 스토리지·메일을 쓰는 잡·서비스가
+// 테스트에서도 운영과 같은 코드로 돌아야 한다(결정 136 · "wireDomain 안 태워 테스트만
+// 깨지던" 사각). 스토리지 s3 버킷은 `<bucket>-test`, 로컬 root 는 `<root>-test` 로
+// 격리한다(<db>_test 대칭). MailPit 은 dev 이자 테스트 sink(캡처 · 외부 발송 없음).
 import { loadGaonConfig } from './load.js';
+import { configureNonDbBatteries } from './wire.js';
+import { resetStorage } from '@gaonjs/storage';
+import { resetI18n } from '@gaonjs/i18n';
 import { createDb, registerConnection, deriveTestDatabaseConfig, destroyAllConnections, } from '@gaonjs/data';
 /**
- * 테스트용 DB 커넥션을 등록한다(결정 111). 각 커넥션을 `<db>_test` 로 파생해
- * poolMax:1 로 붙인다. 반환값의 close() 를 afterAll 에서 호출해 정리한다.
+ * 테스트용 DB 커넥션 + DB 외 배터리(mail·storage·i18n)를 배선한다(결정 111·136).
+ * 각 커넥션을 `<db>_test` 로 파생해 poolMax:1 로 붙이고, 스토리지·메일을 테스트
+ * 격리 값으로 배선한다. 반환값의 close() 를 afterAll 에서 호출해 정리한다.
  */
 export async function connectTestDatabase(cwd = process.cwd()) {
     const config = await loadGaonConfig(cwd);
@@ -20,9 +28,16 @@ export async function connectTestDatabase(cwd = process.cwd()) {
             registerConnection(key, createDb(testCfg), base.adapter);
         }
     }
+    // 결정 136: 스토리지·메일·i18n 을 serve·work 와 같은 경로로 배선(테스트 격리 값).
+    await configureNonDbBatteries(config, cwd, {
+        bucketFor: (b) => `${b}-test`,
+        localRootFor: (r) => `${r}-test`,
+    });
     return {
         close: async () => {
             await destroyAllConnections();
+            resetStorage();
+            resetI18n();
         },
     };
 }

package/dist/wire.d.ts

@@ -27,6 +27,24 @@ export interface WiredDomain {
  * 세션·NATS 잡 발행·Fastify)은 여기 두지 않는다 — wireGaon 이 이 위에 얹는다.
  */
 export declare function wireDomain(config: GaonConfig, cwd?: string): Promise<WiredDomain>;
+/** DB 외 배터리 배선 옵션. 테스트 하네스가 격리 값을 주입할 때 쓴다(결정 136). */
+export interface NonDbBatteryOptions {
+    /**
+     * s3 디스크 버킷명 변환기. 테스트 하네스가 `<bucket>-test` 로 격리할 때 준다
+     * (`<db>_test` 대칭). 생략 = 원본 버킷 그대로. 로컬 디스크는 root 를 변환한다.
+     */
+    readonly bucketFor?: (bucket: string) => string;
+    /** 로컬 디스크 root 변환기(테스트 임시 디렉터리 격리). 생략 = 원본 그대로. */
+    readonly localRootFor?: (root: string) => string;
+}
+/**
+ * mail · storage · i18n 을 프로세스 전역에 배선한다(결정 136). wireDomain(serve·work)
+ * 과 테스트 하네스(connectTestDatabase)가 공유하는 단일 경로다 — 스토리지·메일을
+ * 쓰는 잡·서비스가 테스트에서도 운영과 같은 코드로 돌아야 한다("wireDomain 안 태워
+ * 테스트만 깨지던" 사각 · §13.9). DB 는 여기서 다루지 않는다(테스트는 <db>_test 로,
+ * 운영은 config.db 로 각자 등록).
+ */
+export declare function configureNonDbBatteries(config: GaonConfig, cwd?: string, opts?: NonDbBatteryOptions): Promise<void>;
 /**
  * gaon.config.ts + apps/ 를 바탕으로 배터리를 배선하고 Fastify 앱을 만든다.
  *

package/dist/wire.js

@@ -32,7 +32,29 @@ export async function wireDomain(config, cwd = process.cwd()) {
             registerConnection(key, db, cfg.adapter);
         }
     }
-    // 2) mail — SMTP 전송(개발은 MailPit, 운영은 실 SMTP).
+    // 2~4) mail · storage · i18n — DB 외 프로세스 전역 배터리. serve·work·테스트
+    //       하네스가 공유한다(결정 136 · gaon test 도 이 경로를 태워야 스토리지·메일
+    //       잡이 테스트에서 실제로 돈다).
+    await configureNonDbBatteries(config, root);
+    return {
+        config,
+        async closeDomain() {
+            await destroyAllConnections();
+            resetStorage();
+            resetI18n();
+        },
+    };
+}
+/**
+ * mail · storage · i18n 을 프로세스 전역에 배선한다(결정 136). wireDomain(serve·work)
+ * 과 테스트 하네스(connectTestDatabase)가 공유하는 단일 경로다 — 스토리지·메일을
+ * 쓰는 잡·서비스가 테스트에서도 운영과 같은 코드로 돌아야 한다("wireDomain 안 태워
+ * 테스트만 깨지던" 사각 · §13.9). DB 는 여기서 다루지 않는다(테스트는 <db>_test 로,
+ * 운영은 config.db 로 각자 등록).
+ */
+export async function configureNonDbBatteries(config, cwd = process.cwd(), opts = {}) {
+    const root = resolvePath(cwd);
+    // mail — SMTP 전송(개발·테스트는 MailPit sink, 운영은 실 SMTP).
     if (config.mail) {
         const m = config.mail;
         configureMailer({
@@ -45,18 +67,19 @@ export async function wireDomain(config, cwd = process.cwd()) {
             defaultFrom: m.defaultFrom,
         });
     }
-    // 3) storage — 로컬(기본) 또는 S3.
+    // storage — 로컬(기본) 또는 S3. 테스트는 버킷/roots 를 격리 값으로 변환(opts).
     if (config.storage) {
         const disks = {};
         for (const [name, d] of Object.entries(config.storage.disks)) {
             if (d.driver === 'local') {
                 // root 는 프로젝트 상대 경로면 cwd 로 절대화.
-                const root2 = d.root.startsWith('/') ? d.root : join(root, d.root);
+                const base = d.root.startsWith('/') ? d.root : join(root, d.root);
+                const root2 = opts.localRootFor ? opts.localRootFor(base) : base;
                 disks[name] = localDisk({ root: root2, baseUrl: d.publicUrl });
             }
             else {
                 disks[name] = s3Disk({
-                    bucket: d.bucket,
+                    bucket: opts.bucketFor ? opts.bucketFor(d.bucket) : d.bucket,
                     region: d.region,
                     endpoint: d.endpoint,
                     credentials: d.accessKeyId && d.secretAccessKey
@@ -69,7 +92,7 @@ export async function wireDomain(config, cwd = process.cwd()) {
         }
         configureStorage({ default: config.storage.default, disks });
     }
-    // 4) i18n — locales/ 로드 후 초기화.
+    // i18n — locales/ 로드 후 초기화.
     if (config.i18n) {
         const dir = config.i18n.dir ?? 'locales';
         const abs = dir.startsWith('/') ? dir : join(root, dir);
@@ -80,14 +103,6 @@ export async function wireDomain(config, cwd = process.cwd()) {
             supportedLngs: config.i18n.supportedLngs,
         });
     }
-    return {
-        config,
-        async closeDomain() {
-            await destroyAllConnections();
-            resetStorage();
-            resetI18n();
-        },
-    };
 }
 /**
  * gaon.config.ts + apps/ 를 바탕으로 배터리를 배선하고 Fastify 앱을 만든다.
@@ -169,6 +184,8 @@ export async function wireGaon(config, cwd = process.cwd()) {
         cookieSecret: config.web?.cookieSecret,
         // 보안 기본값 조정(생략 시 코어 기본값 전부 켬 · CLAUDE.md 규칙 8).
         security: config.web?.security,
+        // 결정 131: 스토리지 오리진 CSP 자동 배선(설정 있으면 img-src·connect-src 에 부착).
+        storageOrigins: storageCspOrigins(config.storage),
         // 클라이언트 IP 정책(결정 120 · 생략 시 'direct'). 프록시 뒤 배치면 선언.
         clientIp: config.web?.clientIp,
         realtime: nats ? { nats, hubAddr: config.hub?.addr, heartbeatMs: config.hub?.heartbeatMs } : undefined,
@@ -197,3 +214,41 @@ export async function wireGaon(config, cwd = process.cwd()) {
 }
 // redisSessionStore 는 참조만 유지(트리 셰이킹 방지 · 향후 캐시 재사용).
 void redisSessionStore;
+/**
+ * 결정 131: storage 설정에서 CSP 오리진을 계산한다(s3 드라이버만). endpoint = 브라우저 직접
+ * presigned PUT/GET 오리진(connect-src) 겸 presigned 표시 폴백(img-src). publicUrl = 공개/CDN
+ * 표시 오리진(img-src). 로컬 디스크는 same-origin 상대 URL 이라 CSP 와 무관(제외). 오리진은
+ * `new URL(v).origin`(scheme+host+port) 만 — 경로·쿼리는 배제한다.
+ */
+function storageCspOrigins(storage) {
+    if (!storage)
+        return undefined;
+    const img = new Set();
+    const connect = new Set();
+    for (const [name, d] of Object.entries(storage.disks)) {
+        if (d.driver !== 's3')
+            continue; // 로컬 디스크(상대 baseUrl)는 same-origin — CSP 불필요
+        if (d.endpoint) {
+            const origin = parseStorageOrigin(d.endpoint, `storage.disks.${name}.endpoint`);
+            connect.add(origin);
+            img.add(origin);
+        }
+        if (d.publicUrl) {
+            img.add(parseStorageOrigin(d.publicUrl, `storage.disks.${name}.publicUrl`));
+        }
+    }
+    if (img.size === 0 && connect.size === 0)
+        return undefined;
+    return { img: [...img], connect: [...connect] };
+}
+/** 절대 URL 의 오리진(scheme+host+port)만 뽑는다. 비절대 URL 은 부팅 에러(수리 안내 · §7.5.3). */
+function parseStorageOrigin(value, where) {
+    try {
+        return new URL(value).origin;
+    }
+    catch {
+        throw new Error(`[@gaonjs/config] ${where} = ${JSON.stringify(value)} 가 절대 URL 이 아닙니다(CSP 오리진 계산 불가).\n` +
+            `  → gaon.config.ts 의 storage 설정에서 scheme+host 를 갖춘 절대 URL 로 지정하세요` +
+            ` (예: 'https://cdn.example.com' · 'http://127.0.0.1:9000').`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/config",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Gaon 루트 설정 로더·자동 배선 (gaon.config.ts · §3.3 · M9-A)",
   "type": "module",
   "license": "MIT",
@@ -26,12 +26,12 @@
   "dependencies": {
     "ioredis": "^5.4.1",
     "@gaonjs/async": "0.8.0",
+    "@gaonjs/core": "0.2.1",
+    "@gaonjs/data": "0.14.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.13.1"
+    "@gaonjs/web": "0.14.0",
+    "@gaonjs/storage": "0.1.2"
   },
   "devDependencies": {
     "fastify": "^5.0.0"