@gencow/core 0.1.27 → 0.1.28

package/src/__tests__/storage.test.ts

@@ -1,334 +0,0 @@
-/**
- * packages/core/src/__tests__/storage.test.ts
- *
- * Tests for createStorage() — file storage API
- * Uses temp directory for file I/O.
- *
- * Run: bun test packages/core/src/__tests__/storage.test.ts
- */
-
-import { describe, it, expect, beforeEach, afterEach } from "bun:test";
-import { createStorage } from "../storage.js";
-import * as fs from "fs/promises";
-import * as path from "path";
-import * as os from "os";
-
-describe("createStorage()", () => {
-  let tmpDir: string;
-
-  beforeEach(async () => {
-    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "gencow-storage-test-"));
-  });
-
-  afterEach(async () => {
-    await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {});
-  });
-
-  // ─── store + getUrl ─────────────────────────────────
-
-  describe("store()", () => {
-    it("File 객체를 저장하고 storageId를 반환한다", async () => {
-      const storage = createStorage(tmpDir);
-      const file = new File(["hello world"], "test.txt", { type: "text/plain" });
-
-      const id = await storage.store(file);
-      expect(typeof id).toBe("string");
-      expect(id.length).toBeGreaterThan(0);
-    });
-
-    it("저장된 파일이 디스크에 존재한다", async () => {
-      const storage = createStorage(tmpDir);
-      const file = new File(["content"], "doc.txt", { type: "text/plain" });
-
-      const id = await storage.store(file);
-      const filePath = path.join(tmpDir, id);
-      const stat = await fs.stat(filePath);
-      expect(stat.isFile()).toBe(true);
-    });
-
-    it("Blob 객체도 저장 가능하다", async () => {
-      const storage = createStorage(tmpDir);
-      const blob = new Blob(["blob content"], { type: "application/octet-stream" });
-
-      const id = await storage.store(blob);
-      expect(typeof id).toBe("string");
-    });
-
-    it("50MB 초과 파일 → 에러", async () => {
-      const storage = createStorage(tmpDir);
-      // 51MB File mock — File constructor에서 size를 직접 제어
-      const bigContent = new Uint8Array(51 * 1024 * 1024);
-      const file = new File([bigContent], "big.bin");
-
-      await expect(storage.store(file)).rejects.toThrow("File too large");
-    });
-
-    it("커스텀 filename 적용", async () => {
-      const storage = createStorage(tmpDir);
-      const file = new File(["data"], "original.txt");
-
-      const id = await storage.store(file, "custom-name.txt");
-      const meta = await storage.getMeta(id);
-      expect(meta?.name).toBe("custom-name.txt");
-    });
-  });
-
-  // ─── storeBuffer ────────────────────────────────────
-
-  describe("storeBuffer()", () => {
-    it("Buffer를 저장하고 storageId를 반환한다", async () => {
-      const storage = createStorage(tmpDir);
-      const buffer = Buffer.from("buffer content");
-
-      const id = await storage.storeBuffer(buffer, "buffer.txt", "text/plain");
-      expect(typeof id).toBe("string");
-    });
-
-    it("저장된 파일의 메타데이터가 올바르다", async () => {
-      const storage = createStorage(tmpDir);
-      const buffer = Buffer.from("meta test");
-
-      const id = await storage.storeBuffer(buffer, "meta.txt", "text/plain");
-      const meta = await storage.getMeta(id);
-      expect(meta).not.toBeNull();
-      expect(meta!.name).toBe("meta.txt");
-      expect(meta!.type).toBe("text/plain");
-      expect(meta!.size).toBe(buffer.length);
-    });
-  });
-
-  // ─── getUrl ─────────────────────────────────────────
-
-  describe("getUrl()", () => {
-    it("storageId로 URL 반환", () => {
-      const storage = createStorage(tmpDir);
-      const url = storage.getUrl("some-uuid-123");
-      expect(url).toBe("/api/storage/some-uuid-123");
-    });
-
-    it("URL 패턴이 /api/storage/{id} 형식이다", async () => {
-      const storage = createStorage(tmpDir);
-      const file = new File(["test"], "test.txt");
-      const id = await storage.store(file);
-      const url = storage.getUrl(id);
-      expect(url).toMatch(/^\/api\/storage\/.+$/);
-    });
-  });
-
-  // ─── getMeta ────────────────────────────────────────
-
-  describe("getMeta()", () => {
-    it("저장된 파일의 메타데이터를 반환한다", async () => {
-      const storage = createStorage(tmpDir);
-      const file = new File(["hello"], "hello.txt", { type: "text/plain" });
-      const id = await storage.store(file);
-
-      const meta = await storage.getMeta(id);
-      expect(meta).not.toBeNull();
-      expect(meta!.id).toBe(id);
-      expect(meta!.name).toBe("hello.txt");
-      expect(meta!.type).toContain("text/plain");
-    });
-
-    it("존재하지 않는 storageId → null 반환", async () => {
-      const storage = createStorage(tmpDir);
-      const meta = await storage.getMeta("nonexistent-id");
-      expect(meta).toBeNull();
-    });
-  });
-
-  // ─── delete ─────────────────────────────────────────
-
-  describe("delete()", () => {
-    it("파일을 삭제한다", async () => {
-      const storage = createStorage(tmpDir);
-      const file = new File(["to delete"], "delete-me.txt");
-      const id = await storage.store(file);
-
-      // 파일 존재 확인
-      const filePath = path.join(tmpDir, id);
-      const statBefore = await fs.stat(filePath);
-      expect(statBefore.isFile()).toBe(true);
-
-      // 삭제
-      await storage.delete(id);
-
-      // 파일 삭제 확인
-      const exists = await fs
-        .access(filePath)
-        .then(() => true)
-        .catch(() => false);
-      expect(exists).toBe(false);
-
-      // 메타데이터 삭제 확인
-      const meta = await storage.getMeta(id);
-      expect(meta).toBeNull();
-    });
-
-    it("존재하지 않는 storageId 삭제 시 에러 없음", async () => {
-      const storage = createStorage(tmpDir);
-      await expect(storage.delete("nonexistent-id")).resolves.toBeUndefined();
-    });
-  });
-
-  // ─── Storage Quota ──────────────────────────────────
-
-  describe("스토리지 쿼터", () => {
-    it("쿼터 초과 시 에러 (rawSql 있을 때)", async () => {
-      const mockRawSql = async (sql: string, _params?: unknown[]) => {
-        if (sql.includes("information_schema")) return []; // ensureFilesTable
-        if (sql.includes("SUM")) return [{ total: "999999999" }]; // 쿼터에 근접
-        return [];
-      };
-
-      const storage = createStorage(tmpDir, {
-        rawSql: mockRawSql,
-        storageQuota: 1000000000, // 1GB
-      });
-
-      const file = new File(["x".repeat(1024)], "test.txt");
-      await expect(storage.store(file)).rejects.toThrow("Storage quota exceeded");
-    });
-
-    it("쿼터 0 = 무제한 (에러 없음)", async () => {
-      const mockRawSql = async (sql: string, _params?: unknown[]) => {
-        if (sql.includes("information_schema")) return [];
-        if (sql.includes("SUM")) return [{ total: "999999999999" }];
-        if (sql.includes("INSERT")) return [];
-        return [];
-      };
-
-      const storage = createStorage(tmpDir, {
-        rawSql: mockRawSql,
-        storageQuota: 0, // 무제한
-      });
-
-      const file = new File(["small"], "small.txt");
-      const id = await storage.store(file);
-      expect(typeof id).toBe("string");
-    });
-  });
-});
-
-// ─── _system_files 테이블 리네이밍 관련 테스트 ────────────
-// 2026-04-10 WSOD 사고 후 추가: files → _system_files 리네이밍 검증
-// 📄 참고: docs/analysis/analysis-files-page-wsod.md
-
-describe("_system_files 시스템 테이블 네이밍", () => {
-  it("rawSql로 실행되는 모든 SQL에 old 'files' 테이블 참조가 없다", async () => {
-    const executedSql: string[] = [];
-    const mockRawSql = async (sql: string) => {
-      executedSql.push(sql);
-      if (sql.includes("SUM")) return [{ total: "0" }];
-      if (sql.includes("INSERT")) return [];
-      return [];
-    };
-
-    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "gencow-naming-"));
-    const storage = createStorage(tmpDir, { rawSql: mockRawSql });
-
-    // store 트리거 (ensureFilesTable + checkQuota + recordFileToDb)
-    const file = new File(["test"], "test.txt", { type: "text/plain" });
-    try {
-      await storage.store(file);
-    } catch {}
-
-    // 모든 실행된 SQL에서 old 테이블명 'files'가 아닌 '_system_files'만 참조하는지 확인
-    // (files 단독 참조를 찾되, _system_files는 통과)
-    for (const sql of executedSql) {
-      // "FROM files", "INTO files", "TABLE files" 같은 old 패턴이 없어야 함
-      expect(sql).not.toMatch(/\bFROM\s+files\b(?!_)/i);
-      expect(sql).not.toMatch(/\bINTO\s+files\b(?!_)/i);
-      expect(sql).not.toMatch(/\bTABLE\s+files\b(?!_)/i);
-    }
-
-    await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {});
-  });
-
-  it("쿼터 검증 SQL이 _system_files 테이블을 참조한다", async () => {
-    const executedSql: string[] = [];
-    const mockRawSql = async (sql: string) => {
-      executedSql.push(sql);
-      if (sql.includes("SUM")) return [{ total: "0" }];
-      if (sql.includes("INSERT")) return [];
-      return [];
-    };
-
-    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "gencow-quota-"));
-    const storage = createStorage(tmpDir, {
-      rawSql: mockRawSql,
-      storageQuota: 1000000000,
-    });
-
-    const file = new File(["small"], "small.txt");
-    try {
-      await storage.store(file);
-    } catch {}
-
-    // SUM 쿼리가 _system_files 테이블을 참조하는지 확인
-    const sumSql = executedSql.find((s) => s.includes("SUM"));
-    if (sumSql) {
-      expect(sumSql).toContain("_system_files");
-      expect(sumSql).not.toMatch(/FROM\s+files[^_]/);
-    }
-
-    await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {});
-  });
-
-  it("recordFileToDb SQL이 _system_files 테이블에 INSERT한다", async () => {
-    const executedSql: string[] = [];
-    const mockRawSql = async (sql: string) => {
-      executedSql.push(sql);
-      if (sql.includes("SUM")) return [{ total: "0" }];
-      return [];
-    };
-
-    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "gencow-insert-"));
-    const storage = createStorage(tmpDir, { rawSql: mockRawSql });
-
-    const file = new File(["data"], "data.txt", { type: "text/plain" });
-    try {
-      await storage.store(file);
-    } catch {}
-
-    const insertSql = executedSql.find((s) => s.includes("INSERT"));
-    if (insertSql) {
-      expect(insertSql).toContain("_system_files");
-      expect(insertSql).not.toMatch(/INTO\s+files[^_]/);
-    }
-
-    await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {});
-  });
-
-  it("delete SQL이 _system_files 테이블에서 삭제한다", async () => {
-    const executedSql: string[] = [];
-    const mockRawSql = async (sql: string) => {
-      executedSql.push(sql);
-      if (sql.includes("SUM")) return [{ total: "0" }];
-      return [];
-    };
-
-    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "gencow-delete-"));
-    const storage = createStorage(tmpDir, { rawSql: mockRawSql });
-
-    // store 후 delete
-    const file = new File(["delete-me"], "del.txt");
-    let storageId: string | undefined;
-    try {
-      storageId = await storage.store(file);
-    } catch {}
-    if (storageId) {
-      try {
-        await storage.delete(storageId);
-      } catch {}
-    }
-
-    const deleteSql = executedSql.find((s) => s.includes("DELETE"));
-    if (deleteSql) {
-      expect(deleteSql).toContain("_system_files");
-      expect(deleteSql).not.toMatch(/FROM\s+files[^_]/);
-    }
-
-    await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {});
-  });
-});

package/src/__tests__/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "noEmit": true
-  },
-  "include": ["./**/*.ts"],
-  "exclude": []
-}

package/src/__tests__/validator.test.ts

@@ -1,323 +0,0 @@
-/**
- * packages/core/src/__tests__/validator.test.ts
- *
- * Tests for the `v` validator module — runtime argument validation.
- *
- * Run: bun test packages/core/src/__tests__/validator.test.ts
- */
-
-import { describe, it, expect } from "bun:test";
-import { v, parseArgs, GencowValidationError } from "../v.js";
-
-// ─── v.string() ─────────────────────────────────────────
-
-describe("v.string()", () => {
-  const validator = v.string();
-
-  it("문자열 통과", () => {
-    expect(validator.parse("hello")).toBe("hello");
-  });
-
-  it("빈 문자열 통과", () => {
-    expect(validator.parse("")).toBe("");
-  });
-
-  it("숫자 → 에러", () => {
-    expect(() => validator.parse(42)).toThrow("Expected string");
-  });
-
-  it("불리언 → 에러", () => {
-    expect(() => validator.parse(true)).toThrow("Expected string");
-  });
-
-  it("null → 에러", () => {
-    expect(() => validator.parse(null)).toThrow("Expected string");
-  });
-
-  it("undefined → 에러", () => {
-    expect(() => validator.parse(undefined)).toThrow("Expected string");
-  });
-});
-
-// ─── v.number() ─────────────────────────────────────────
-
-describe("v.number()", () => {
-  const validator = v.number();
-
-  it("정수 통과", () => {
-    expect(validator.parse(42)).toBe(42);
-  });
-
-  it("실수 통과", () => {
-    expect(validator.parse(3.14)).toBe(3.14);
-  });
-
-  it("0 통과", () => {
-    expect(validator.parse(0)).toBe(0);
-  });
-
-  it("음수 통과", () => {
-    expect(validator.parse(-10)).toBe(-10);
-  });
-
-  it("숫자 문자열 → 자동 변환", () => {
-    expect(validator.parse("42")).toBe(42);
-  });
-
-  it("비숫자 문자열 → 에러", () => {
-    expect(() => validator.parse("abc")).toThrow("Expected number");
-  });
-
-  it("불리언 → 에러", () => {
-    expect(() => validator.parse(true)).toThrow("Expected number");
-  });
-
-  it("NaN 입력 → 에러", () => {
-    expect(() => validator.parse(NaN)).toThrow("Expected number");
-  });
-});
-
-// ─── v.boolean() ────────────────────────────────────────
-
-describe("v.boolean()", () => {
-  const validator = v.boolean();
-
-  it("true 통과", () => {
-    expect(validator.parse(true)).toBe(true);
-  });
-
-  it("false 통과", () => {
-    expect(validator.parse(false)).toBe(false);
-  });
-
-  it("문자열 → 에러", () => {
-    expect(() => validator.parse("true")).toThrow("Expected boolean");
-  });
-
-  it("숫자 → 에러", () => {
-    expect(() => validator.parse(1)).toThrow("Expected boolean");
-  });
-});
-
-// ─── v.any() ────────────────────────────────────────────
-
-describe("v.any()", () => {
-  const validator = v.any();
-
-  it("모든 값 통과 — 문자열", () => {
-    expect(validator.parse("hello")).toBe("hello");
-  });
-
-  it("모든 값 통과 — 숫자", () => {
-    expect(validator.parse(42)).toBe(42);
-  });
-
-  it("모든 값 통과 — null", () => {
-    expect(validator.parse(null)).toBe(null);
-  });
-
-  it("모든 값 통과 — undefined", () => {
-    expect(validator.parse(undefined)).toBe(undefined);
-  });
-
-  it("모든 값 통과 — 객체", () => {
-    const obj = { key: "value" };
-    expect(validator.parse(obj)).toBe(obj);
-  });
-});
-
-// ─── v.optional() ───────────────────────────────────────
-
-describe("v.optional()", () => {
-  const validator = v.optional(v.string());
-
-  it("문자열 통과", () => {
-    expect(validator.parse("hello")).toBe("hello");
-  });
-
-  it("undefined → undefined 반환", () => {
-    expect(validator.parse(undefined)).toBe(undefined);
-  });
-
-  it("null → undefined 반환", () => {
-    expect(validator.parse(null)).toBe(undefined);
-  });
-
-  it("숫자 → 에러 (내부 validator 적용)", () => {
-    expect(() => validator.parse(42)).toThrow("Expected string");
-  });
-});
-
-// ─── v.array() ──────────────────────────────────────────
-
-describe("v.array()", () => {
-  const validator = v.array(v.string());
-
-  it("문자열 배열 통과", () => {
-    expect(validator.parse(["a", "b", "c"])).toEqual(["a", "b", "c"]);
-  });
-
-  it("빈 배열 통과", () => {
-    expect(validator.parse([])).toEqual([]);
-  });
-
-  it("비배열 → 에러", () => {
-    expect(() => validator.parse("not array")).toThrow("Expected array");
-  });
-
-  it("원소 타입 불일치 → 에러", () => {
-    expect(() => validator.parse([1, 2, 3])).toThrow("Expected string");
-  });
-
-  it("혼합 배열 → 에러", () => {
-    expect(() => validator.parse(["ok", 42])).toThrow("Expected string");
-  });
-});
-
-// ─── v.object() ─────────────────────────────────────────
-
-describe("v.object()", () => {
-  const validator = v.object({
-    name: v.string(),
-    age: v.number(),
-  });
-
-  it("유효한 객체 통과", () => {
-    expect(validator.parse({ name: "Alice", age: 30 })).toEqual({ name: "Alice", age: 30 });
-  });
-
-  it("비객체 → 에러", () => {
-    expect(() => validator.parse("string")).toThrow("Expected object");
-  });
-
-  it("null → 에러", () => {
-    expect(() => validator.parse(null)).toThrow("Expected object");
-  });
-
-  it("필드 타입 불일치 → 에러", () => {
-    expect(() => validator.parse({ name: 42, age: 30 })).toThrow("Expected string");
-  });
-
-  it("필드 누락 → inner validator 에러", () => {
-    expect(() => validator.parse({ name: "Alice" })).toThrow("Expected number");
-  });
-});
-
-// ─── 복합 중첩 검증 ────────────────────────────────────
-
-describe("복합 중첩 검증", () => {
-  it("v.optional(v.array(v.string()))", () => {
-    const validator = v.optional(v.array(v.string()));
-    expect(validator.parse(undefined)).toBe(undefined);
-    expect(validator.parse(["a", "b"])).toEqual(["a", "b"]);
-    expect(() => validator.parse([1])).toThrow("Expected string");
-  });
-
-  it("v.array(v.object(...))", () => {
-    const validator = v.array(
-      v.object({
-        id: v.number(),
-        label: v.string(),
-      }),
-    );
-    expect(
-      validator.parse([
-        { id: 1, label: "A" },
-        { id: 2, label: "B" },
-      ]),
-    ).toEqual([
-      { id: 1, label: "A" },
-      { id: 2, label: "B" },
-    ]);
-  });
-
-  it("v.object({ tags: v.array(v.string()), meta: v.optional(v.object(...)) })", () => {
-    const validator = v.object({
-      tags: v.array(v.string()),
-      meta: v.optional(v.object({ key: v.string() })),
-    });
-    expect(validator.parse({ tags: ["a"], meta: undefined })).toEqual({ tags: ["a"], meta: undefined });
-    expect(validator.parse({ tags: [], meta: { key: "val" } })).toEqual({ tags: [], meta: { key: "val" } });
-  });
-});
-
-// ─── parseArgs() ────────────────────────────────────────
-
-describe("parseArgs()", () => {
-  it("schema 없으면 args 그대로 반환", () => {
-    expect(parseArgs(null, { foo: 1 })).toEqual({ foo: 1 });
-    expect(parseArgs(undefined, "hello")).toBe("hello");
-  });
-
-  it("Validator 스키마로 직접 파싱", () => {
-    const schema = v.string();
-    expect(parseArgs(schema, "hello")).toBe("hello");
-  });
-
-  it("Validator 스키마 검증 실패 → GencowValidationError", () => {
-    const schema = v.string();
-    expect(() => parseArgs(schema, 42)).toThrow(GencowValidationError);
-  });
-
-  it("Shorthand record 스키마 (Convex 스타일)", () => {
-    const schema = { title: v.string(), count: v.number() };
-    expect(parseArgs(schema, { title: "Hello", count: 5 })).toEqual({ title: "Hello", count: 5 });
-  });
-
-  it("Shorthand record 검증 실패 → GencowValidationError + 필드명 포함", () => {
-    const schema = { title: v.string(), count: v.number() };
-    try {
-      parseArgs(schema, { title: 42, count: 5 });
-      expect(true).toBe(false); // 여기 도달하면 안 됨
-    } catch (e) {
-      expect(e).toBeInstanceOf(GencowValidationError);
-      expect((e as Error).message).toContain("title");
-    }
-  });
-
-  it("Shorthand record에 비객체 전달 → GencowValidationError", () => {
-    const schema = { title: v.string() };
-    expect(() => parseArgs(schema, "not an object")).toThrow(GencowValidationError);
-  });
-
-  it("GencowValidationError.statusCode === 400", () => {
-    const err = new GencowValidationError("test");
-    expect(err.statusCode).toBe(400);
-    expect(err.name).toBe("GencowValidationError");
-  });
-
-  // ─── 빈 스키마 passthrough (FormData 업로드 버그 회귀 방지) ────
-
-  it("빈 스키마 {} → args 전체 passthrough (FormData file 필드 보존)", () => {
-    const schema = {};
-    const args = { file: new File(["hello"], "test.txt"), _mutation: "upload.store" };
-    const result = parseArgs(schema, args);
-    // 빈 스키마이므로 args가 그대로 반환되어야 함 (file 포함)
-    expect(result).toBe(args); // 참조 동일
-    expect(result.file).toBeInstanceOf(File);
-    expect(result._mutation).toBe("upload.store");
-  });
-
-  it("빈 스키마 {} + 일반 객체 → passthrough", () => {
-    const schema = {};
-    const args = { name: "test", count: 42, nested: { a: 1 } };
-    const result = parseArgs(schema, args);
-    expect(result).toBe(args);
-    expect(result.name).toBe("test");
-    expect(result.count).toBe(42);
-  });
-
-  it("빈 스키마 {} + 빈 args {} → 빈 객체 반환", () => {
-    const result = parseArgs({}, {});
-    expect(result).toEqual({});
-  });
-
-  it("키가 있는 스키마는 여전히 지정된 키만 추출 (file 제거됨)", () => {
-    const schema = { title: v.string() };
-    const args = { title: "hello", file: "should-be-stripped", extra: 123 };
-    const result = parseArgs(schema, args);
-    expect(result).toEqual({ title: "hello" });
-    expect(result.file).toBeUndefined();
-    expect(result.extra).toBeUndefined();
-  });
-});