@gencow/core 0.1.24 → 0.1.26

package/src/__tests__/storage.test.ts

@@ -8,314 +8,327 @@
  */
 
 import { describe, it, expect, beforeEach, afterEach } from "bun:test";
-import { createStorage } from "../storage";
+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;
+  let tmpDir: string;
 
-    beforeEach(async () => {
-        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "gencow-storage-test-"));
-    });
+  beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "gencow-storage-test-"));
+  });
 
-    afterEach(async () => {
-        await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {});
-    });
+  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");
-        });
-    });
+  // ─── store + getUrl ─────────────────────────────────
 
-    // ─── storeBuffer ────────────────────────────────────
+  describe("store()", () => {
+    it("File 객체를 저장하고 storageId를 반환한다", async () => {
+      const storage = createStorage(tmpDir);
+      const file = new File(["hello world"], "test.txt", { type: "text/plain" });
 
-    describe("storeBuffer()", () => {
-        it("Buffer를 저장하고 storageId를 반환한다", async () => {
-            const storage = createStorage(tmpDir);
-            const buffer = Buffer.from("buffer content");
+      const id = await storage.store(file);
+      expect(typeof id).toBe("string");
+      expect(id.length).toBeGreaterThan(0);
+    });
 
-            const id = await storage.storeBuffer(buffer, "buffer.txt", "text/plain");
-            expect(typeof id).toBe("string");
-        });
+    it("저장된 파일이 디스크에 존재한다", async () => {
+      const storage = createStorage(tmpDir);
+      const file = new File(["content"], "doc.txt", { type: "text/plain" });
 
-        it("저장된 파일의 메타데이터가 올바르다", async () => {
-            const storage = createStorage(tmpDir);
-            const buffer = Buffer.from("meta test");
+      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.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);
-        });
+      const id = await storage.store(blob);
+      expect(typeof id).toBe("string");
     });
 
-    // ─── 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\/.+$/);
-        });
+    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");
     });
 
-    // ─── 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();
-        });
+    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");
     });
+  });
 
-    // ─── delete ─────────────────────────────────────────
+  // ─── storeBuffer ────────────────────────────────────
 
-    describe("delete()", () => {
-        it("파일을 삭제한다", async () => {
-            const storage = createStorage(tmpDir);
-            const file = new File(["to delete"], "delete-me.txt");
-            const id = await storage.store(file);
+  describe("storeBuffer()", () => {
+    it("Buffer를 저장하고 storageId를 반환한다", async () => {
+      const storage = createStorage(tmpDir);
+      const buffer = Buffer.from("buffer content");
 
-            // 파일 존재 확인
-            const filePath = path.join(tmpDir, id);
-            const statBefore = await fs.stat(filePath);
-            expect(statBefore.isFile()).toBe(true);
+      const id = await storage.storeBuffer(buffer, "buffer.txt", "text/plain");
+      expect(typeof id).toBe("string");
+    });
 
-            // 삭제
-            await storage.delete(id);
+    it("저장된 파일의 메타데이터가 올바르다", async () => {
+      const storage = createStorage(tmpDir);
+      const buffer = Buffer.from("meta test");
 
-            // 파일 삭제 확인
-            const exists = await fs.access(filePath).then(() => true).catch(() => false);
-            expect(exists).toBe(false);
+      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);
+    });
+  });
 
-            // 메타데이터 삭제 확인
-            const meta = await storage.getMeta(id);
-            expect(meta).toBeNull();
-        });
+  // ─── getUrl ─────────────────────────────────────────
 
-        it("존재하지 않는 storageId 삭제 시 에러 없음", async () => {
-            const storage = createStorage(tmpDir);
-            await expect(storage.delete("nonexistent-id")).resolves.toBeUndefined();
-        });
+  describe("getUrl()", () => {
+    it("storageId로 URL 반환", () => {
+      const storage = createStorage(tmpDir);
+      const url = storage.getUrl("some-uuid-123");
+      expect(url).toBe("/api/storage/some-uuid-123");
     });
 
-    // ─── 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");
-        });
+    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\/.+$/);
     });
-});
+  });
 
-// ─── _system_files 테이블 리네이밍 관련 테스트 ────────────
-// 2026-04-10 WSOD 사고 후 추가: files → _system_files 리네이밍 검증
-// 📄 참고: docs/analysis/analysis-files-page-wsod.md
+  // ─── getMeta ────────────────────────────────────────
 
-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(() => {});
+  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("쿼터 검증 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("존재하지 않는 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("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 [];
-        };
+    it("존재하지 않는 storageId 삭제 시 에러 없음", async () => {
+      const storage = createStorage(tmpDir);
+      await expect(storage.delete("nonexistent-id")).resolves.toBeUndefined();
+    });
+  });
 
-        const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "gencow-insert-"));
-        const storage = createStorage(tmpDir, { rawSql: mockRawSql });
+  // ─── Storage Quota ──────────────────────────────────
 
-        const file = new File(["data"], "data.txt", { type: "text/plain" });
-        try { await storage.store(file); } catch {}
+  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 insertSql = executedSql.find(s => s.includes("INSERT"));
-        if (insertSql) {
-            expect(insertSql).toContain("_system_files");
-            expect(insertSql).not.toMatch(/INTO\s+files[^_]/);
-        }
+      const storage = createStorage(tmpDir, {
+        rawSql: mockRawSql,
+        storageQuota: 1000000000, // 1GB
+      });
 
-        await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {});
+      const file = new File(["x".repeat(1024)], "test.txt");
+      await expect(storage.store(file)).rejects.toThrow("Storage quota exceeded");
     });
 
-    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(() => {});
+    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 +1,8 @@
 {
-    "extends": "../../tsconfig.json",
-    "compilerOptions": {
-        "noEmit": true
-    },
-    "include": ["./**/*.ts"],
-    "exclude": []
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true
+  },
+  "include": ["./**/*.ts"],
+  "exclude": []
 }