@gaonjs/config 0.16.1 → 0.17.0

package/dist/apps.d.ts

@@ -26,6 +26,7 @@ export declare function resolveApps(cwd?: string): Promise<DiscoveredApp[]>;
  * 를 반영해 덧붙인다. 여기서는 순수 이름·라우트·컨트롤러·hosts 만.
  *
  * hosts: app.config.ts 의 `hosts:` 배열을 그대로 옮긴다(v0.16 §3.3 · 운영
- * 도메인). 문자열 배열만 신뢰 — 잘못된 값은 조용히 무시한다.
+ * 도메인). 잘못된 항목은 조용히 버리지 않고 부팅 에러로 알린다(결정 231 · §7.5.3)
+ * — hosts 오타(빈 문자열·비문자열)로 도메인 라우팅이 조용히 빠지던 사고를 막는다.
  */
 export declare function toAppSpec(app: DiscoveredApp): AppSpec;

package/dist/apps.js

@@ -71,13 +71,25 @@ export async function resolveApps(cwd = process.cwd()) {
  * 를 반영해 덧붙인다. 여기서는 순수 이름·라우트·컨트롤러·hosts 만.
  *
  * hosts: app.config.ts 의 `hosts:` 배열을 그대로 옮긴다(v0.16 §3.3 · 운영
- * 도메인). 문자열 배열만 신뢰 — 잘못된 값은 조용히 무시한다.
+ * 도메인). 잘못된 항목은 조용히 버리지 않고 부팅 에러로 알린다(결정 231 · §7.5.3)
+ * — hosts 오타(빈 문자열·비문자열)로 도메인 라우팅이 조용히 빠지던 사고를 막는다.
  */
 export function toAppSpec(app) {
     const raw = app.appConfig?.hosts;
-    const hosts = Array.isArray(raw)
-        ? raw.filter((h) => typeof h === 'string' && h.length > 0)
-        : undefined;
+    let hosts;
+    if (raw !== undefined) {
+        if (!Array.isArray(raw)) {
+            throw new Error(`[@gaonjs/config] apps/${app.name}/app.config.ts 의 hosts 는 문자열 배열이어야 합니다(받은 타입: ${typeof raw}).\n` +
+                `  → hosts: ['app.example.com', 'www.example.com'] 형태로 지정하세요.`);
+        }
+        raw.forEach((h, i) => {
+            if (typeof h !== 'string' || h.length === 0) {
+                throw new Error(`[@gaonjs/config] apps/${app.name}/app.config.ts 의 hosts[${i}] 가 유효하지 않습니다: ${JSON.stringify(h)}.\n` +
+                    `  → 각 host 는 비어있지 않은 문자열(도메인)이어야 합니다 — 오타·빈 값·주석 잔재를 확인하세요.`);
+            }
+        });
+        hosts = raw;
+    }
     return {
         name: app.name,
         routes: app.routes,

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, wireDomain, type WiredGaon, type WiredDomain } from './wire.js';
+export { wireGaon, wireDomain, applyTimezone, 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, wireDomain } from './wire.js';
+export { wireGaon, wireDomain, applyTimezone } from './wire.js';
 // 테스트 DB 배선 (결정 111 · gaon test 격리)
 export { connectTestDatabase } from './testkit.js';

package/dist/types.d.ts

@@ -110,8 +110,9 @@ export interface GaonConfig {
     readonly i18n?: I18nConfig;
     readonly web?: WebConfig;
     /**
-     * 타임존(§3.3 정본에 명시). 현재는 문서상 값이며 M9-A 에서는 저장만 —
-     * 실 사용처(스케줄러·로깅 포맷)는 각 배터리가 후속 웨이브에서 소비한다.
+     * 타임존(§3.3 · IANA 이름 예 'Asia/Seoul'·'UTC'). 결정 230: 부팅 시 process.env.TZ 로
+     * **실제 배선**한다 — 이후 Date·로깅 타임스탬프·스케줄러(크론)가 이 값을 따른다.
+     * 유효하지 않은 IANA 이름은 부팅 에러(조용한 no-op 아님).
      */
     readonly timezone?: string;
 }

package/dist/wire.d.ts

@@ -3,6 +3,14 @@ import { Redis } from 'ioredis';
 import { type GaonNats } from '@gaonjs/async';
 import type { GaonConfig } from './types.js';
 import { type DiscoveredApp } from './apps.js';
+/**
+ * 결정 230: gaon.config.ts 의 `timezone` 을 **실제로 배선**한다(이전엔 저장만·조용한 no-op).
+ * process.env.TZ 를 세워 이후 Date·로깅 타임스탬프·스케줄러(크론)가 선언 타임존을 따르게 한다.
+ * Node 는 런타임 TZ 변경을 반영한다(실측 · 첫 Date 사용 전에 부팅 경로에서 세운다). 유효하지
+ * 않은 IANA 이름은 process.env.TZ 에 넣으면 조용히 UTC 로 떨어지므로, 넣기 전에 검증해
+ * 부팅 에러(§7.5.3)로 알린다 — 또 다른 조용한 실패를 만들지 않는다.
+ */
+export declare function applyTimezone(config: GaonConfig): void;
 /** 부팅 결과 — 이후 serve 가 listen 한다. close() 로 배선을 뒤집는다. */
 export interface WiredGaon {
     readonly app: FastifyInstance;

package/dist/wire.js

@@ -16,6 +16,28 @@ import { createApp, redisSessionStore, setValidationMessageResolver, setLocaleRe
 import { resolveApps, toAppSpec } from './apps.js';
 import { existsSync } from 'node:fs';
 import { resolve as resolvePath, join } from 'node:path';
+/**
+ * 결정 230: gaon.config.ts 의 `timezone` 을 **실제로 배선**한다(이전엔 저장만·조용한 no-op).
+ * process.env.TZ 를 세워 이후 Date·로깅 타임스탬프·스케줄러(크론)가 선언 타임존을 따르게 한다.
+ * Node 는 런타임 TZ 변경을 반영한다(실측 · 첫 Date 사용 전에 부팅 경로에서 세운다). 유효하지
+ * 않은 IANA 이름은 process.env.TZ 에 넣으면 조용히 UTC 로 떨어지므로, 넣기 전에 검증해
+ * 부팅 에러(§7.5.3)로 알린다 — 또 다른 조용한 실패를 만들지 않는다.
+ */
+export function applyTimezone(config) {
+    const tz = config.timezone;
+    if (tz === undefined)
+        return;
+    try {
+        // 유효하지 않은 존이면 RangeError(실측). 부작용 없는 검증 전용 호출.
+        new Intl.DateTimeFormat('en-US', { timeZone: tz });
+    }
+    catch {
+        throw new Error(`[@gaonjs/config] timezone = ${JSON.stringify(tz)} 는 유효한 IANA 타임존이 아닙니다.\n` +
+            `  → gaon.config.ts 의 timezone 을 'Asia/Seoul'·'UTC'·'America/New_York' 같은 IANA 이름으로 지정하세요\n` +
+            `    (목록: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).`);
+    }
+    process.env.TZ = tz;
+}
 /**
  * gaon.config.ts 의 **프로세스 전역 도메인 배터리**(DB 커넥션·메일·스토리지·
  * i18n)를 배선한다. serve(웹)와 work(워커)가 함께 태우는 공통 경로다 — 잡
@@ -25,6 +47,8 @@ import { resolve as resolvePath, join } from 'node:path';
  */
 export async function wireDomain(config, cwd = process.cwd()) {
     const root = resolvePath(cwd);
+    // 0) 타임존 — 어떤 배터리보다 먼저 적용해 이후 Date·로깅·스케줄러가 선언 타임존을 본다(결정 230).
+    applyTimezone(config);
     // 1) DB 커넥션 — 키별로 등록(main + 명명 커넥션 · §4.5). 실 연결은 첫 쿼리에서(pool lazy).
     if (config.db) {
         for (const [key, cfg] of Object.entries(config.db)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/config",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Gaon 루트 설정 로더·자동 배선 (gaon.config.ts)",
   "type": "module",
   "license": "MIT",
@@ -25,13 +25,13 @@
   ],
   "dependencies": {
     "ioredis": "^5.4.1",
-    "@gaonjs/core": "0.2.2",
-    "@gaonjs/async": "0.13.0",
-    "@gaonjs/data": "0.16.3",
-    "@gaonjs/mail": "0.2.1",
-    "@gaonjs/storage": "0.1.3",
-    "@gaonjs/i18n": "0.2.1",
-    "@gaonjs/web": "0.19.1"
+    "@gaonjs/core": "0.2.3",
+    "@gaonjs/async": "0.15.0",
+    "@gaonjs/data": "0.17.0",
+    "@gaonjs/i18n": "0.2.2",
+    "@gaonjs/mail": "0.3.0",
+    "@gaonjs/storage": "0.1.4",
+    "@gaonjs/web": "0.19.2"
   },
   "devDependencies": {
     "fastify": "^5.0.0"