@fuzionx/framework 0.1.39 → 0.1.42

package/testing/index.js

@@ -1,232 +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; }
-}
+/**
+ * @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; }
+}