@gaonjs/config 0.25.12 → 0.26.0

package/dist/types.d.ts

@@ -68,10 +68,14 @@ export interface StorageConfig {
     readonly default: string;
     readonly disks: Record<string, StorageDiskConfig>;
 }
-/** i18n — locales/ 로드 + 요청별 로케일 협상 옵션(결정 159 · 13차 W1). */
+/**
+ * i18n — 카탈로그 로드 + 요청별 로케일 협상 옵션(결정 159 · 13차 W1).
+ *
+ * 결정 459: 카탈로그 **위치는 관례로 고정**됐다(`domain/locales/` · `apps/<앱>/locales/`).
+ * 옛 `dir` 은 제거됐다 — 위치가 관례면 `dir` 은 "정답이 둘" 을 만든다. 남아 있으면
+ * doctor `i18n-layout` 이 error 로 잡는다.
+ */
 export interface I18nConfig {
-    /** locales/ 디렉토리 경로 (cwd 기준 상대). 생략 시 'locales'. */
-    readonly dir?: string;
     /** 기본 언어. */
     readonly fallbackLng: string;
     /** 허용 언어(생략 시 locales 폴더 하위 언어들). */

package/dist/wire.js

@@ -12,8 +12,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, currentLanguage, languages, t, } from '@gaonjs/i18n';
-import { createApp, redisSessionStore, setValidationMessageResolver, setLocaleResolver, } from '@gaonjs/web';
+import { buildI18nConfig, configureI18n, loadProjectLocales, projectLanguages, resetI18n, detectLanguage, enterApp, enterLanguage, currentLanguage, languages, t, } from '@gaonjs/i18n';
+import { createApp, redisSessionStore, setAppScopeEnter, setValidationMessageResolver, setLocaleResolver, } from '@gaonjs/web';
 import { resolveApps, toAppSpec } from './apps.js';
 import { existsSync } from 'node:fs';
 import { resolve as resolvePath, join } from 'node:path';
@@ -224,39 +224,40 @@ export async function configureNonDbBatteries(config, cwd = process.cwd(), opts
         }
         configureStorage({ default: config.storage.default, disks });
     }
-    // i18n — locales/ 로드 후 초기화.
+    // i18n — 두 소유자(domain/locales · apps/*/locales)를 읽어 초기화(결정 459).
     if (config.i18n) {
-        const dir = config.i18n.dir ?? 'locales';
-        const abs = dir.startsWith('/') ? dir : join(root, dir);
-        const resources = loadLocales(abs);
+        const project = loadProjectLocales(root);
+        const langs = projectLanguages(project);
         // 결정 353: i18n 을 켰는데 카탈로그가 비면 fail-loud — 이전엔 무경고로 부팅해
-        // 모든 t() 가 원문 키를 화면에 노출했다(배포 이미지 locales 누락·dir 오타 무신호).
-        if (Object.keys(resources).length === 0) {
-            throw new Error(`i18n 이 설정됐지만 로케일 카탈로그가 비어 있습니다: ${abs}\n` +
-                `  → ${dir}/${config.i18n.fallbackLng}/frontend.json (화면 문구) 또는\n` +
-                `     ${dir}/${config.i18n.fallbackLng}/backend.json (메일·잡·검증 등 서버 전용 문구)을 만드세요 — 결정 454.\n` +
-                `  → 단일 파일 레이아웃(${dir}/${config.i18n.fallbackLng}.json)도 계속 지원합니다(서버 전용으로 취급).\n` +
-                `  → gaon.config.ts 의 i18n.dir 이 실제 카탈로그 폴더를 가리키는지 확인하세요.\n` +
+        // 모든 t() 가 원문 키를 화면에 노출했다(배포 이미지 locales 누락 무신호).
+        // 결정 459 §6-E: 판정 대상이 2소유자로 늘었다 — **둘 다 비어야** 공허다.
+        if (langs.length === 0) {
+            throw new Error(`i18n 이 설정됐지만 로케일 카탈로그가 하나도 없습니다: ${root} (결정 459)\n` +
+                `  → 화면 문구: apps/<앱>/locales/${config.i18n.fallbackLng}/frontend.json (앱마다 필수)\n` +
+                `  → 도메인 공통 서버 문구(메일·잡·검증): domain/locales/${config.i18n.fallbackLng}/backend.json\n` +
+                `  → 그 앱 컨트롤러 전용 서버 문구: apps/<앱>/locales/${config.i18n.fallbackLng}/backend.json (선택)\n` +
+                `  → 루트 locales/ 는 더 이상 읽지 않습니다(결정 459) — gaon doctor --fix 로 이관하세요.\n` +
                 `  (이 상태로 부팅하면 모든 t() 가 번역 대신 원문 키를 노출합니다 — 결정 353)`);
         }
-        // 결정 353: fallbackLng·supportedLngs 가 지목한 로케일 파일이 통째로 없으면 fail-loud —
-        // 이전엔 협상이 그 로케일을 골라 주고 전 키가 fallback 언어로 폴백돼, 로케일 하나가
-        // 조용히 다른 언어로 나갔다(locale-parity 는 존재 파일만 비교해 못 잡는 사각).
-        const missing = [config.i18n.fallbackLng, ...(config.i18n.supportedLngs ?? [])].filter((lng, i, arr) => arr.indexOf(lng) === i && !resources[lng]);
+        // 결정 353: fallbackLng·supportedLngs 가 지목한 로케일이 어느 소유자에게도 없으면
+        // fail-loud — 이전엔 협상이 그 로케일을 골라 주고 전 키가 fallback 언어로 폴백돼,
+        // 로케일 하나가 조용히 다른 언어로 나갔다.
+        const missing = [config.i18n.fallbackLng, ...(config.i18n.supportedLngs ?? [])].filter((lng, i, arr) => arr.indexOf(lng) === i && !langs.includes(lng));
         if (missing.length > 0) {
-            throw new Error(`i18n 설정이 지목한 로케일의 카탈로그가 없습니다: ${missing.join(', ')}\n` +
-                `  → ${dir}/ 에 ${missing.map((l) => `${l}/frontend.json`).join(' · ')} 또는 ${missing
-                    .map((l) => `${l}/backend.json`)
-                    .join(' · ')} 을 추가하거나(결정 454 분리 레이아웃),\n` +
-                `  → 단일 파일 레이아웃이면 ${missing.map((l) => `${l}.json`).join(' · ')} 을 추가하거나,\n` +
+            throw new Error(`i18n 설정이 지목한 로케일의 카탈로그가 없습니다: ${missing.join(', ')} (결정 459)\n` +
+                `  → 각 앱에 ${missing.map((l) => `apps/<앱>/locales/${l}/frontend.json`).join(' · ')} 을 추가하거나,\n` +
+                `  → 도메인 공통 문구면 ${missing.map((l) => `domain/locales/${l}/backend.json`).join(' · ')} 을 추가하거나,\n` +
                 `  → gaon.config.ts 의 fallbackLng/supportedLngs 에서 해당 로케일을 제거하세요.\n` +
                 `  (카탈로그가 없는 로케일은 전 화면이 fallback 언어로 조용히 대체됩니다 — 결정 353)`);
         }
-        await configureI18n({
-            resources,
+        await configureI18n(buildI18nConfig(project, {
             fallbackLng: config.i18n.fallbackLng,
             supportedLngs: config.i18n.supportedLngs,
-        });
+        }));
+        // 결정 459: 앱 스코프 ALS 배선 — 앱 스코프 onRequest 훅이 이 콜백으로 앱 이름을
+        // 심어 t() 가 `app:<이름>` → `domain` 으로 해석한다(web→i18n 하드 의존 회피 ·
+        // setLocaleResolver·setValidationMessageResolver 와 동형 역전).
+        setAppScopeEnter((app) => enterApp(app));
         // 결정 183(옵션 C): 검증 사유를 요청 로케일로 로케일화한다. web 은 안정적 코드만
         // 노출하고, 앱이 locales/ 의 예약 namespace `validation.<code>` 로 번역을 준다.
         // 키가 없으면 defaultValue(web 내장 fallback)로 떨어져 거동이 보존된다. t() 는
@@ -466,6 +467,9 @@ async function assembleApp(config, root, domain, redis, nats) {
             setServiceTxWrapper(undefined);
             // 결정 214: 로케일 리졸버 해제 — 다음 인스턴스(비-i18n 일 수 있음)로 stale 로케일 누출 방지.
             setLocaleResolver(undefined);
+            // 결정 459: 앱 스코프 진입 훅도 같은 이유로 해제한다(다음 인스턴스가 비-i18n 이면
+            // 죽은 enterApp 이 남아 ALS 에 stale 앱 이름을 심는다).
+            setAppScopeEnter(undefined);
             // 결정 202: 락·캐시 백엔드 해제 + redis 종료는 closeDomain 이 소유한다(serve·work 공통 ·
             // wireDomain 이 배선했으므로 해제도 거기서). serve 는 여기서 중복 해제하지 않는다.
             await domain.closeDomain();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/config",
-  "version": "0.25.12",
+  "version": "0.26.0",
   "description": "Gaon 루트 설정 로더·자동 배선 (gaon.config.ts)",
   "type": "module",
   "license": "MIT",
@@ -30,14 +30,14 @@
   ],
   "dependencies": {
     "ioredis": "^5.4.1",
-    "@gaonjs/adapter-mongo": "0.5.4",
-    "@gaonjs/i18n": "0.4.1",
     "@gaonjs/core": "0.3.0",
-    "@gaonjs/data": "0.26.2",
+    "@gaonjs/adapter-mongo": "0.5.4",
     "@gaonjs/async": "0.22.0",
+    "@gaonjs/data": "0.26.2",
+    "@gaonjs/mail": "0.5.4",
+    "@gaonjs/i18n": "0.5.0",
     "@gaonjs/storage": "0.1.6",
-    "@gaonjs/web": "0.32.1",
-    "@gaonjs/mail": "0.5.3"
+    "@gaonjs/web": "0.33.0"
   },
   "devDependencies": {
     "fastify": "^5.0.0"