@gaonjs/cli 0.2.0 → 0.4.0

package/dist/scaffold/page.js

@@ -0,0 +1,46 @@
+// @gaonjs/cli · scaffold · page (M9-B)
+//
+// `gaon g page <Path>/<Name>` — Vue 페이지(Inertia SPA · §6).
+// pageProps<K>() 로 컨트롤러 render 결과 타입을 그대로 이어받는다 —
+// 스키마→모델→컨트롤러→(생성된 라우트 지도)→페이지 체인의 마지막 고리(§6.2).
+//
+// 입력 예: `gaon g page Posts/Index` → apps/<app>/pages/Posts/Index.vue.
+// 라우트 키는 소문자·리소스 관례로 `posts#index` 를 기본값으로 넣는다 —
+// 사용자가 라우트를 다르게 걸었으면 수동 수정하면 된다(주석에 안내).
+import { toCamel } from './inflect.js';
+/**
+ * 페이지 경로에서 스캐폴드를 만든다.
+ * @param pagePath 예: 'Posts/Index' · 'Dashboard' · 'admin/Users/Show'.
+ * @param app 대상 앱.
+ */
+export function pageScaffold(pagePath, app) {
+    const trimmed = pagePath.trim().replace(/^\/+|\/+$/g, '');
+    if (!trimmed) {
+        throw new Error(`[gaon g page] 페이지 경로가 비어 있습니다.\n` +
+            `  → 예: gaon g page Posts/Index (apps/${app}/pages/Posts/Index.vue 생성)`);
+    }
+    const segments = trimmed.split('/').filter(Boolean);
+    const last = segments[segments.length - 1];
+    const parent = segments[segments.length - 2] ?? last;
+    // 라우트 키 기본값 — 폴더는 리소스명(복수·소문자), 파일은 액션명(소문자).
+    const routeKey = `${toCamel(parent).toLowerCase()}#${toCamel(last).toLowerCase()}`;
+    const filePath = `apps/${app}/pages/${trimmed}.vue`;
+    const lines = [
+        `<script setup lang="ts">`,
+        `import { pageProps } from 'gaonjs/vue'`,
+        ``,
+        `// 컨트롤러 ${routeKey} 의 render props 타입이 그대로 흐른다(§6.2).`,
+        `// 라우트 키가 다르면 이 리터럴을 바꾼다 — .gaon/routes.d.ts 가 유효한 키를 알려준다.`,
+        `const props = pageProps<'${routeKey}'>()`,
+        `</script>`,
+        ``,
+        `<template>`,
+        `  <div>`,
+        `    <h1>${last}</h1>`,
+        `    <pre>{{ props }}</pre>`,
+        `  </div>`,
+        `</template>`,
+        ``,
+    ];
+    return { path: filePath, contents: lines.join('\n') };
+}

package/dist/serve.d.ts

@@ -0,0 +1,18 @@
+export interface ServeCommandOptions {
+    readonly cwd?: string;
+    readonly json?: boolean;
+    /** 리슨 포트. 우선순위: 옵션 > config.web.port > env PORT > 3000. */
+    readonly port?: number;
+    /** 리슨 호스트. 우선순위: 옵션 > config.web.host > '0.0.0.0'. */
+    readonly host?: string;
+    /** 프로세스 시그널(테스트 주입). 기본 process. */
+    readonly signals?: {
+        on(sig: 'SIGINT' | 'SIGTERM', fn: () => void): void;
+        off(sig: 'SIGINT' | 'SIGTERM', fn: () => void): void;
+    };
+}
+/**
+ * `gaon serve` 진입점. loadDotEnv → loadGaonConfig → wireGaon → listen →
+ * SIGINT 대기 → graceful close. 예외는 stderr + exit 1.
+ */
+export declare function runServeCommand(opts?: ServeCommandOptions): Promise<void>;

package/dist/serve.js

@@ -0,0 +1,79 @@
+/**
+ * @gaonjs/cli · `gaon serve` — 웹 서버 부팅 (§7 · M9-A)
+ *
+ * 운영 프로세스 3종 중 하나(serve · work · hub). cwd 관례로 gaon.config.ts
+ * 를 로드하고, apps/* 를 스캔해 자동 배선한 뒤 Fastify 를 listen 한다.
+ * SIGINT/SIGTERM 에 graceful 종료(Fastify → NATS → Redis → DB 순).
+ *
+ * env 를 먼저 로드한다 — .env 의 값이 gaon.config.ts 안의 env('KEY') 에
+ * 들어갈 수 있어야 하기 때문.
+ *
+ * 워커 수(--workers, WEB_CONCURRENCY)는 v0.8 정본이지만 컨테이너 안 기본
+ * 1워커라 M9-A 는 단일 프로세스만 다룬다. node:cluster 통합은 후속(M9-C).
+ */
+import { loadDotEnv } from '@gaonjs/core';
+import { loadGaonConfig, wireGaon, findConfigPath } from '@gaonjs/config';
+import { registerTsResolve } from './tsResolve.js';
+function humanEvent(e) {
+    switch (e.kind) {
+        case 'starting': {
+            const cfg = e.configPath ? `config=${e.configPath}` : 'config=(없음 · 기본값)';
+            const apps = e.apps.length > 0 ? `apps=[${e.apps.join(', ')}]` : 'apps=(없음)';
+            return `  gaon serve · 시작 — ${cfg} · ${apps}`;
+        }
+        case 'listening':
+            return `  ▶ 리슨 중 — ${e.url}  (Ctrl+C 로 종료)`;
+        case 'stopping':
+            return '  gaon serve · 종료 중 (graceful) ...';
+        case 'stopped':
+            return '  gaon serve · 종료';
+    }
+}
+/**
+ * `gaon serve` 진입점. loadDotEnv → loadGaonConfig → wireGaon → listen →
+ * SIGINT 대기 → graceful close. 예외는 stderr + exit 1.
+ */
+export async function runServeCommand(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const json = opts.json ?? false;
+    const signals = opts.signals ?? process;
+    // .ts 상대 import 해석기 등록 (사용자 gaon.config.ts, apps/* 로드에 필요).
+    registerTsResolve();
+    loadDotEnv(cwd);
+    const emit = (e) => {
+        if (json)
+            process.stdout.write(JSON.stringify(e) + '\n');
+        else
+            process.stdout.write(humanEvent(e) + '\n');
+    };
+    const configPath = findConfigPath(cwd);
+    const config = await loadGaonConfig(cwd);
+    const wired = await wireGaon(config, cwd);
+    emit({ kind: 'starting', configPath, apps: wired.apps.map((a) => a.name) });
+    const host = opts.host ?? config.web?.host ?? '0.0.0.0';
+    const port = opts.port ??
+        config.web?.port ??
+        (process.env.PORT ? Number(process.env.PORT) : 3000);
+    await wired.app.listen({ host, port });
+    const displayHost = host === '0.0.0.0' ? 'localhost' : host;
+    emit({ kind: 'listening', host, port, url: `http://${displayHost}:${port}` });
+    await new Promise((resolvePromise) => {
+        const stop = () => {
+            signals.off('SIGINT', stop);
+            signals.off('SIGTERM', stop);
+            emit({ kind: 'stopping' });
+            void wired
+                .close()
+                .catch((err) => {
+                const msg = err instanceof Error ? err.message : String(err);
+                process.stderr.write(`  ✗ 종료 중 오류: ${msg}\n`);
+            })
+                .finally(() => {
+                emit({ kind: 'stopped' });
+                resolvePromise();
+            });
+        };
+        signals.on('SIGINT', stop);
+        signals.on('SIGTERM', stop);
+    });
+}

package/dist/templates/auth/auth.wiring.ts.tpl

@@ -4,7 +4,7 @@ import { User } from '../../domain/models/user.js'
 
 // 세션에 심긴 userId 로 사용자를 로드한다(§7). web 은 도메인을 loadUser 로 받는다.
 export const loadUser: AuthOptions['loadUser'] = async (id) =>
-  await User.query().where('id', '=', BigInt(String(id))).first()
+  await User.where('id', '=', BigInt(String(id))).first()
 
 // this.currentUser 에 User 필드 타입을 얹는다(GaonRouteMap 과 동일 관례).
 declare module 'gaonjs/web' {

package/dist/templates/auth/session.controller.ts.tpl

@@ -10,7 +10,7 @@ export default controller({
   // POST /session — 로그인
   async create() {
     const { email, password } = this.params({ _row: {} as { email: string; password: string } })
-    const user = await User.query().where('email', '=', email).first()
+    const user = await User.where('email', '=', email).first()
     // passwordDigest 는 hidden 이지만 서버 코드에서는 투명하게 읽힌다(§4.2).
     if (user && (await verifyPassword(password, user.passwordDigest))) {
       this.auth.login(user)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Gaon CLI 구현: 제너레이터·스캐폴딩·로드맵 출력 (M1 스텁)",
   "type": "module",
   "license": "MIT",
@@ -24,11 +24,12 @@
     "README.md"
   ],
   "dependencies": {
-    "typescript": "*",
+    "typescript": "^5.9.0",
     "@gaonjs/async": "0.2.2",
+    "@gaonjs/config": "0.1.0",
     "@gaonjs/core": "0.1.4",
-    "@gaonjs/data": "0.2.3",
     "@gaonjs/mail": "0.1.0",
+    "@gaonjs/data": "0.3.0",
     "@gaonjs/web": "0.3.0"
   },
   "scripts": {