@fuzionx/framework 0.1.43 → 0.1.45

package/bin/fx.js

@@ -1,12 +1,12 @@
-#!/usr/bin/env node
-/**
- * fx CLI — @fuzionx/framework 내장 명령줄 도구.
- *
- * @see docs/framework/16-cli.md
- */
-import { run } from '../cli/index.js';
-
-run(process.argv.slice(2)).catch((err) => {
-    console.error(err.message || err);
-    process.exit(1);
-});
+#!/usr/bin/env node
+/**
+ * fx CLI — @fuzionx/framework 내장 명령줄 도구.
+ *
+ * @see docs/framework/16-cli.md
+ */
+import { run } from '../cli/index.js';
+
+run(process.argv.slice(2)).catch((err) => {
+    console.error(err.message || err);
+    process.exit(1);
+});

package/cli/db-sync.js

@@ -1,100 +1,100 @@
-/**
- * db:sync — 모델 기반 스키마 SQL 생성
- *
- * 사용: fx db:sync [--dry-run]
- *
- * 모델의 static 멤버(table, primaryKey, timestamps, softDelete)에서
- * CREATE TABLE SQL을 생성합니다. 실제 마이그레이션 시스템이 아닌
- * 빠른 프로토타이핑용 도구입니다.
- *
- * @see docs/framework/02-database-orm.md
- */
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import { pathToFileURL } from 'node:url';
-
-/**
- * 모델 클래스에서 CREATE TABLE SQL 생성
- * @param {typeof import('../lib/Model.js').default} ModelClass
- * @returns {string}
- */
-export function generateCreateTable(ModelClass) {
-    const table = ModelClass.table;
-    const pk = ModelClass.primaryKey || 'id';
-    const timestamps = ModelClass.timestamps !== false;
-    const softDelete = ModelClass.softDelete || false;
-
-    if (!table) return '';
-
-    const columns = [];
-
-    // 기본키
-    columns.push(`  \`${pk}\` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY`);
-
-    // timestamps
-    if (timestamps) {
-        columns.push(`  \`created_at\` DATETIME DEFAULT CURRENT_TIMESTAMP`);
-        columns.push(`  \`updated_at\` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP`);
-    }
-
-    // softDelete
-    if (softDelete) {
-        columns.push(`  \`deleted_at\` DATETIME DEFAULT NULL`);
-    }
-
-    return `CREATE TABLE IF NOT EXISTS \`${table}\` (\n${columns.join(',\n')}\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;\n`;
-}
-
-/**
- * 디렉토리의 모든 모델에서 SQL 생성
- * @param {string} modelsDir
- * @returns {Promise<string>}
- */
-export async function generateSchema(modelsDir) {
-    const sqls = [];
-
-    try {
-        const entries = await fs.readdir(modelsDir, { withFileTypes: true });
-        const files = entries
-            .filter(e => e.isFile() && e.name.endsWith('.js') && !e.name.startsWith('.'))
-            .map(e => path.join(modelsDir, e.name));
-
-        for (const file of files) {
-            const mod = await import(pathToFileURL(file).href);
-            const ModelClass = mod.default;
-            if (ModelClass?.table) {
-                sqls.push(generateCreateTable(ModelClass));
-            }
-        }
-    } catch {
-        // 디렉토리 없음
-    }
-
-    return sqls.join('\n');
-}
-
-/**
- * CLI 엔트리
- */
-export async function run(args) {
-    const dryRun = args.includes('--dry-run');
-    const modelsDir = path.resolve('app/models');
-
-    console.log(`[db:sync] Scanning ${modelsDir}...`);
-
-    const sql = await generateSchema(modelsDir);
-
-    if (!sql) {
-        console.log('[db:sync] No models found.');
-        return;
-    }
-
-    if (dryRun) {
-        console.log('\n-- DRY RUN (preview only) --\n');
-        console.log(sql);
-    } else {
-        console.log('\n-- Generated SQL --\n');
-        console.log(sql);
-        console.log('-- Execute this SQL against your database to sync schema --');
-    }
-}
+/**
+ * db:sync — 모델 기반 스키마 SQL 생성
+ *
+ * 사용: fx db:sync [--dry-run]
+ *
+ * 모델의 static 멤버(table, primaryKey, timestamps, softDelete)에서
+ * CREATE TABLE SQL을 생성합니다. 실제 마이그레이션 시스템이 아닌
+ * 빠른 프로토타이핑용 도구입니다.
+ *
+ * @see docs/framework/02-database-orm.md
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+/**
+ * 모델 클래스에서 CREATE TABLE SQL 생성
+ * @param {typeof import('../lib/Model.js').default} ModelClass
+ * @returns {string}
+ */
+export function generateCreateTable(ModelClass) {
+    const table = ModelClass.table;
+    const pk = ModelClass.primaryKey || 'id';
+    const timestamps = ModelClass.timestamps !== false;
+    const softDelete = ModelClass.softDelete || false;
+
+    if (!table) return '';
+
+    const columns = [];
+
+    // 기본키
+    columns.push(`  \`${pk}\` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY`);
+
+    // timestamps
+    if (timestamps) {
+        columns.push(`  \`created_at\` DATETIME DEFAULT CURRENT_TIMESTAMP`);
+        columns.push(`  \`updated_at\` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP`);
+    }
+
+    // softDelete
+    if (softDelete) {
+        columns.push(`  \`deleted_at\` DATETIME DEFAULT NULL`);
+    }
+
+    return `CREATE TABLE IF NOT EXISTS \`${table}\` (\n${columns.join(',\n')}\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;\n`;
+}
+
+/**
+ * 디렉토리의 모든 모델에서 SQL 생성
+ * @param {string} modelsDir
+ * @returns {Promise<string>}
+ */
+export async function generateSchema(modelsDir) {
+    const sqls = [];
+
+    try {
+        const entries = await fs.readdir(modelsDir, { withFileTypes: true });
+        const files = entries
+            .filter(e => e.isFile() && e.name.endsWith('.js') && !e.name.startsWith('.'))
+            .map(e => path.join(modelsDir, e.name));
+
+        for (const file of files) {
+            const mod = await import(pathToFileURL(file).href);
+            const ModelClass = mod.default;
+            if (ModelClass?.table) {
+                sqls.push(generateCreateTable(ModelClass));
+            }
+        }
+    } catch {
+        // 디렉토리 없음
+    }
+
+    return sqls.join('\n');
+}
+
+/**
+ * CLI 엔트리
+ */
+export async function run(args) {
+    const dryRun = args.includes('--dry-run');
+    const modelsDir = path.resolve('app/models');
+
+    console.log(`[db:sync] Scanning ${modelsDir}...`);
+
+    const sql = await generateSchema(modelsDir);
+
+    if (!sql) {
+        console.log('[db:sync] No models found.');
+        return;
+    }
+
+    if (dryRun) {
+        console.log('\n-- DRY RUN (preview only) --\n');
+        console.log(sql);
+    } else {
+        console.log('\n-- Generated SQL --\n');
+        console.log(sql);
+        console.log('-- Execute this SQL against your database to sync schema --');
+    }
+}