@fuzionx/framework 0.1.2

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@fuzionx/framework",
+  "version": "0.1.2",
+  "type": "module",
+  "description": "Full-stack MVC framework built on @fuzionx/core — Controller, Service, Model, Middleware, DI, EventBus",
+  "main": "index.js",
+  "bin": {
+    "fx": "./bin/fx.js"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./testing": "./testing/index.js",
+    "./cli": "./cli/index.js"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "framework",
+    "mvc",
+    "controller",
+    "service",
+    "model",
+    "fuzionx"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/saytohenry/fuzionx"
+  },
+  "dependencies": {
+    "@fuzionx/core": "^0.1.2",
+    "better-sqlite3": "^12.8.0",
+    "knex": "^3.2.5",
+    "mongoose": "^9.3.2",
+    "mysql2": "^3.20.0",
+    "pg": "^8.20.0"
+  },
+  "devDependencies": {
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "index.js",
+    "lib/",
+    "testing/"
+  ]
+}

package/testing/index.js

@@ -0,0 +1,232 @@
+/**
+ * @fuzionx/testing — 테스트 헬퍼
+ *
+ * in-process HTTP 클라이언트, 인증 헬퍼, DB 어설션.
+ *
+ * @see docs/framework/20-testing.md
+ */
+import Application from '../lib/Application.js';
+import Context from '../lib/Context.js';
+
+/**
+ * 테스트용 앱 생성 (서버 미시작)
+ * @param {object} [opts] - Application 옵션
+ * @returns {Promise<TestApp>}
+ */
+export async function createApp(opts = {}) {
+    const app = new Application(opts);
+    await app.boot();
+    return new TestApp(app);
+}
+
+export class TestApp {
+    constructor(app) {
+        this.app = app;
+        this.config = app.config;
+        this.db = app.db;
+    }
+
+    /**
+     * HTTP 클라이언트 생성
+     * @returns {TestClient}
+     */
+    client() {
+        return new TestClient(this.app);
+    }
+
+    /**
+     * DB 어설션 헬퍼
+     */
+    get assert() {
+        return new DbAssert(this.app);
+    }
+
+    async cleanup() {
+        // DB 연결 해제 등
+    }
+}
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  TestClient — in-process HTTP
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+export class TestClient {
+    constructor(app) {
+        this._app = app;
+    }
+
+    get(url) { return new RequestBuilder(this._app, 'GET', url); }
+    post(url) { return new RequestBuilder(this._app, 'POST', url); }
+    put(url) { return new RequestBuilder(this._app, 'PUT', url); }
+    patch(url) { return new RequestBuilder(this._app, 'PATCH', url); }
+    delete(url) { return new RequestBuilder(this._app, 'DELETE', url); }
+}
+
+export class RequestBuilder {
+    constructor(app, method, url) {
+        this._app = app;
+        this._method = method;
+        this._url = url;
+        this._headers = {};
+        this._body = null;
+        this._query = {};
+    }
+
+    json(data) {
+        this._body = data;
+        this._headers['content-type'] = 'application/json';
+        return this;
+    }
+
+    form(data) {
+        this._body = data;
+        this._headers['content-type'] = 'application/x-www-form-urlencoded';
+        return this;
+    }
+
+    header(key, value) {
+        this._headers[key.toLowerCase()] = value;
+        return this;
+    }
+
+    query(params) {
+        Object.assign(this._query, params);
+        return this;
+    }
+
+    cookie(name, value) {
+        const existing = this._headers['cookie'] || '';
+        this._headers['cookie'] = existing ? `${existing}; ${name}=${value}` : `${name}=${value}`;
+        return this;
+    }
+
+    loginAs(user) {
+        // 세션에 userId 설정 (시뮬레이션)
+        this._headers['x-test-user-id'] = String(user.id || user);
+        return this;
+    }
+
+    withToken(token) {
+        this._headers['authorization'] = `Bearer ${token}`;
+        return this;
+    }
+
+    /**
+     * 요청 실행
+     * @returns {Promise<TestResponse>}
+     */
+    async then(resolve, reject) {
+        try {
+            const rawReq = {
+                method: this._method,
+                url: this._url,
+                path: this._url.split('?')[0],
+                query: this._query,
+                params: {},
+                headers: this._headers,
+                body: this._body,
+                remoteIp: '127.0.0.1',
+            };
+
+            const ctx = new Context(rawReq, this._app);
+
+            // TODO: 실제 라우터 매칭 + 미들웨어 체인 실행
+            // 지금은 ctx를 반환하여 기본 응답 구조만 테스트 가능
+
+            const response = new TestResponse(ctx);
+            resolve(response);
+        } catch (err) {
+            if (reject) reject(err); else throw err;
+        }
+    }
+}
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  TestResponse — 응답 어설션
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+export class TestResponse {
+    constructor(ctx) {
+        this._ctx = ctx;
+        this.status = ctx._statusCode;
+        this.headers = ctx._headers;
+        this.body = ctx._body ? tryParseJSON(ctx._body) : null;
+    }
+
+    assertStatus(code) {
+        if (this.status !== code) {
+            throw new Error(`Expected status ${code}, got ${this.status}`);
+        }
+        return this;
+    }
+
+    assertBody(expected) {
+        const actual = JSON.stringify(this.body);
+        const exp = JSON.stringify(expected);
+        if (actual !== exp) {
+            throw new Error(`Body mismatch:\nExpected: ${exp}\nActual: ${actual}`);
+        }
+        return this;
+    }
+
+    assertBodyContains(subset) {
+        for (const [key, value] of Object.entries(subset)) {
+            if (JSON.stringify(this.body?.[key]) !== JSON.stringify(value)) {
+                throw new Error(`Body missing ${key}: ${value}`);
+            }
+        }
+        return this;
+    }
+
+    assertBodyHas(key) {
+        if (!(key in (this.body || {}))) {
+            throw new Error(`Body missing key: ${key}`);
+        }
+        return this;
+    }
+
+    assertHeader(key, value) {
+        const actual = this.headers[key];
+        if (value !== undefined && actual !== value) {
+            throw new Error(`Header '${key}' expected '${value}', got '${actual}'`);
+        }
+        if (value === undefined && actual === undefined) {
+            throw new Error(`Header '${key}' not present`);
+        }
+        return this;
+    }
+
+    assertRedirect(url) {
+        if (this.status < 300 || this.status >= 400) {
+            throw new Error(`Expected redirect, got ${this.status}`);
+        }
+        if (url && this.headers['Location'] !== url) {
+            throw new Error(`Expected redirect to ${url}, got ${this.headers['Location']}`);
+        }
+        return this;
+    }
+}
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  DB Assert (스텁)
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+export class DbAssert {
+    constructor(app) { this._app = app; }
+
+    async hasInDatabase(table, where) {
+        // Phase 5+ DB 연동 후 구현
+    }
+
+    async missingFromDatabase(table, where) {
+        // Phase 5+ DB 연동 후 구현
+    }
+
+    async countInDatabase(table, count, where) {
+        // Phase 5+ DB 연동 후 구현
+    }
+}
+
+function tryParseJSON(str) {
+    try { return JSON.parse(str); } catch { return str; }
+}