@gaonjs/config 0.1.0 → 0.2.0

package/dist/apps.d.ts

@@ -23,6 +23,9 @@ export interface DiscoveredApp {
 export declare function resolveApps(cwd?: string): Promise<DiscoveredApp[]>;
 /**
  * DiscoveredApp 을 AppSpec 으로 변환. 세션·인증 옵션은 wire.ts 가 config
- * 를 반영해 덧붙인다. 여기서는 순수 이름·라우트·컨트롤러만.
+ * 를 반영해 덧붙인다. 여기서는 순수 이름·라우트·컨트롤러·hosts 만.
+ *
+ * hosts: app.config.ts 의 `hosts:` 배열을 그대로 옮긴다(v0.16 §3.3 · 운영
+ * 도메인). 문자열 배열만 신뢰 — 잘못된 값은 조용히 무시한다.
  */
 export declare function toAppSpec(app: DiscoveredApp): AppSpec;

package/dist/apps.js

@@ -68,13 +68,21 @@ export async function resolveApps(cwd = process.cwd()) {
 }
 /**
  * DiscoveredApp 을 AppSpec 으로 변환. 세션·인증 옵션은 wire.ts 가 config
- * 를 반영해 덧붙인다. 여기서는 순수 이름·라우트·컨트롤러만.
+ * 를 반영해 덧붙인다. 여기서는 순수 이름·라우트·컨트롤러·hosts 만.
+ *
+ * hosts: app.config.ts 의 `hosts:` 배열을 그대로 옮긴다(v0.16 §3.3 · 운영
+ * 도메인). 문자열 배열만 신뢰 — 잘못된 값은 조용히 무시한다.
  */
 export function toAppSpec(app) {
+    const raw = app.appConfig?.hosts;
+    const hosts = Array.isArray(raw)
+        ? raw.filter((h) => typeof h === 'string' && h.length > 0)
+        : undefined;
     return {
         name: app.name,
         routes: app.routes,
         controllers: app.controllers,
         channels: app.channels,
+        hosts,
     };
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { defineConfig, type GaonConfig, type DbConfig, type RedisConfig, type NatsConfig, type HubConfig, type MailConfig, type StorageConfig, type StorageDiskConfig, type I18nConfig, type WebConfig, } from './types.js';
+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';

package/dist/index.js

@@ -6,7 +6,7 @@
 //
 // `gaon serve`/`gaon dev` 가 loadGaonConfig + wireGaon 을 조립해서
 // Fastify 인스턴스를 만들고 listen 한다.
-export { defineConfig, } from './types.js';
+export { defineConfig, defineAppConfig, } from './types.js';
 export { loadGaonConfig, findConfigPath } from './load.js';
 export { resolveApps, toAppSpec, } from './apps.js';
 export { wireGaon } from './wire.js';

package/dist/types.d.ts

@@ -95,3 +95,38 @@ export interface GaonConfig {
  * 반환값은 그대로 통과시켜 IDE 자동완성·형 검사만 제공한다.
  */
 export declare function defineConfig(config: GaonConfig): GaonConfig;
+/**
+ * 앱 세션 옵션(§7 · 앱별 세션 완전 분리). AppSpec.session 과 정합하지만
+ * 여기서는 사용자 마주(app.config.ts) 타입만 얇게 유지한다 — 실 세션 배선은
+ * wire.ts 가 Redis 인스턴스를 주입해 완성한다.
+ */
+export interface AppSessionConfig {
+    /** 서명 비밀 · env('APP_<NAME>_SESSION_SECRET') 관례 권장. */
+    readonly secret: string;
+    /** 세션 쿠키 이름(생략 시 관례: <app>_session). */
+    readonly cookieName?: string;
+    /** 세션 TTL(초). 생략 시 배터리 기본. */
+    readonly ttlSeconds?: number;
+}
+/**
+ * 앱별 설정 — apps/<app>/app.config.ts (v0.16 §3.3).
+ *
+ * 잘 지은 앱의 app.config.ts 는 거의 비어 있어야 한다(§1.1 ②). 관례에서
+ * 벗어날 때만 값을 채운다:
+ *  - hosts: 이 앱이 응답할 도메인 목록. 생략 시 URL 프리픽스 관례만 사용.
+ *  - session: 세션 옵션(secret · 쿠키 이름 등).
+ *  - prefix: URL 프리픽스 관례를 명시적으로 덮어쓴다(고급).
+ *
+ * 개발 모드에서는 `<앱이름>.localhost` 로도 접근된다(v0.11 · §3.3) —
+ * hosts 를 비워도 이 로컬 관례는 자동으로 성립한다.
+ */
+export interface AppConfig {
+    /** 이 앱이 응답할 도메인 목록(운영). 예: ['admin.example.com']. */
+    readonly hosts?: readonly string[];
+    /** 세션 옵션 — 미지정 시 세션 배터리는 이 앱에서 꺼져 있다. */
+    readonly session?: AppSessionConfig;
+    /** URL 프리픽스 명시 덮어쓰기. 생략 시 관례: web→'/', 그 외→'/<name>'. */
+    readonly prefix?: string;
+}
+/** 타입 안전 헬퍼 — `export default defineAppConfig({...})`. */
+export declare function defineAppConfig(config: AppConfig): AppConfig;

package/dist/types.js

@@ -15,3 +15,7 @@
 export function defineConfig(config) {
     return config;
 }
+/** 타입 안전 헬퍼 — `export default defineAppConfig({...})`. */
+export function defineAppConfig(config) {
+    return config;
+}

package/dist/wire.js

@@ -8,7 +8,7 @@
 // 필수이므로 auth 앱은 명시적으로 secret 을 제공해야 한다(env 로 주입 권장).
 import { Redis } from 'ioredis';
 import { createDb, registerConnection, destroyAllConnections, } from '@gaonjs/data';
-import { connectNats } from '@gaonjs/async';
+import { connectNats, configureJobs } from '@gaonjs/async';
 import { configureMailer, smtpTransport } from '@gaonjs/mail';
 import { configureStorage, localDisk, s3Disk, resetStorage } from '@gaonjs/storage';
 import { configureI18n, loadLocales, resetI18n } from '@gaonjs/i18n';
@@ -41,9 +41,14 @@ export async function wireGaon(config, cwd = process.cwd()) {
         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).
     if (config.mail) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/config",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Gaon 루트 설정 로더·자동 배선 (gaon.config.ts · §3.3 · M9-A)",
   "type": "module",
   "license": "MIT",
@@ -23,20 +23,20 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json"
+  },
   "dependencies": {
-    "ioredis": "^5.4.1",
-    "@gaonjs/async": "0.2.2",
-    "@gaonjs/mail": "0.1.0",
-    "@gaonjs/storage": "0.1.0",
-    "@gaonjs/web": "0.3.0",
-    "@gaonjs/data": "0.3.0",
-    "@gaonjs/core": "0.1.4",
-    "@gaonjs/i18n": "0.1.0"
+    "@gaonjs/async": "workspace:*",
+    "@gaonjs/core": "workspace:*",
+    "@gaonjs/data": "workspace:*",
+    "@gaonjs/i18n": "workspace:*",
+    "@gaonjs/mail": "workspace:*",
+    "@gaonjs/storage": "workspace:*",
+    "@gaonjs/web": "workspace:*",
+    "ioredis": "^5.4.1"
   },
   "devDependencies": {
     "fastify": "^5.0.0"
-  },
-  "scripts": {
-    "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json"
   }
-}
+}