@simplysm/excel 13.0.0-beta.4 → 13.0.0-beta.44

package/tests/excel-wrapper.spec.ts

@@ -1,275 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { z } from "zod";
-import { ExcelWrapper } from "../src/excel-wrapper";
-import { DateOnly, DateTime, Time } from "@simplysm/core-common";
-
-describe("ExcelWrapper", () => {
-  const testSchema = z.object({
-    name: z.string(),
-    age: z.number(),
-    email: z.string().optional(),
-    active: z.boolean().default(false),
-  });
-
-  const displayNameMap = {
-    name: "이름",
-    age: "나이",
-    email: "이메일",
-    active: "활성화",
-  };
-
-  describe("write", () => {
-    it("레코드를 Excel로 변환할 수 있다", async () => {
-      const wrapper = new ExcelWrapper(testSchema, displayNameMap);
-
-      const records = [
-        { name: "홍길동", age: 30, email: "hong@test.com", active: true },
-        { name: "김철수", age: 25 },
-      ];
-
-      const wb = await wrapper.write("Users", records);
-      const ws = await wb.getWorksheet("Users");
-
-      // 헤더 확인
-      expect(await ws.cell(0, 0).getVal()).toBe("이름");
-      expect(await ws.cell(0, 1).getVal()).toBe("나이");
-      expect(await ws.cell(0, 2).getVal()).toBe("이메일");
-      expect(await ws.cell(0, 3).getVal()).toBe("활성화");
-
-      // 데이터 확인
-      expect(await ws.cell(1, 0).getVal()).toBe("홍길동");
-      expect(await ws.cell(1, 1).getVal()).toBe(30);
-      expect(await ws.cell(2, 0).getVal()).toBe("김철수");
-      expect(await ws.cell(2, 1).getVal()).toBe(25);
-
-      await wb.close();
-    });
-
-    it("필수 필드에 노란색 배경이 적용된다", async () => {
-      const wrapper = new ExcelWrapper(testSchema, displayNameMap);
-      const wb = await wrapper.write("Test", [{ name: "Test", age: 20 }]);
-      const ws = await wb.getWorksheet("Test");
-
-      // 필수 필드 (name, age)는 스타일이 적용됨
-      const nameStyleId = await ws.cell(0, 0).getStyleId();
-      const ageStyleId = await ws.cell(0, 1).getStyleId();
-
-      expect(nameStyleId).toBeDefined();
-      expect(ageStyleId).toBeDefined();
-
-      await wb.close();
-    });
-  });
-
-  describe("read", () => {
-    it("Excel에서 레코드를 읽을 수 있다", async () => {
-      const wrapper = new ExcelWrapper(testSchema, displayNameMap);
-
-      // 먼저 Excel 생성
-      const records = [
-        { name: "홍길동", age: 30, email: "hong@test.com", active: true },
-        { name: "김철수", age: 25, active: false },
-      ];
-
-      const wb = await wrapper.write("Users", records);
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      // Excel에서 읽기
-      const readRecords = await wrapper.read(buffer, "Users");
-
-      expect(readRecords.length).toBe(2);
-      expect(readRecords[0].name).toBe("홍길동");
-      expect(readRecords[0].age).toBe(30);
-      expect(readRecords[0].email).toBe("hong@test.com");
-      expect(readRecords[0].active).toBe(true);
-      expect(readRecords[1].name).toBe("김철수");
-      expect(readRecords[1].age).toBe(25);
-    });
-
-    it("인덱스로 워크시트를 지정할 수 있다", async () => {
-      const wrapper = new ExcelWrapper(testSchema, displayNameMap);
-
-      const records = [{ name: "Test", age: 20 }];
-      const wb = await wrapper.write("Sheet1", records);
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      const readRecords = await wrapper.read(buffer, 0);
-      expect(readRecords.length).toBe(1);
-      expect(readRecords[0].name).toBe("Test");
-    });
-  });
-
-  describe("타입 변환", () => {
-    it("문자열을 숫자로 변환할 수 있다", async () => {
-      const wrapper = new ExcelWrapper(testSchema, displayNameMap);
-
-      // 수동으로 문자열로 저장된 Excel 시뮬레이션
-      const wb = await wrapper.write("Test", [{ name: "Test", age: 25 }]);
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      const records = await wrapper.read(buffer);
-      expect(typeof records[0].age).toBe("number");
-      expect(records[0].age).toBe(25);
-    });
-
-    it("기본값이 적용된다", async () => {
-      const wrapper = new ExcelWrapper(testSchema, displayNameMap);
-
-      // active 필드 없이 저장
-      const wb = await wrapper.write("Test", [{ name: "Test", age: 20 }]);
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      const records = await wrapper.read(buffer);
-      expect(records[0].active).toBe(false); // 기본값
-    });
-  });
-
-  describe("날짜 타입 지원", () => {
-    const dateSchema = z.object({
-      title: z.string(),
-      date: z.instanceof(DateOnly).optional(),
-    });
-
-    const dateDisplayMap = {
-      title: "제목",
-      date: "날짜",
-    };
-
-    it("DateOnly 타입을 읽고 쓸 수 있다", async () => {
-      const wrapper = new ExcelWrapper(dateSchema, dateDisplayMap);
-
-      const records = [{ title: "Event 1", date: new DateOnly(2024, 6, 15) }, { title: "Event 2" }];
-
-      const wb = await wrapper.write("Events", records);
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      const readRecords = await wrapper.read(buffer, "Events");
-
-      expect(readRecords[0].title).toBe("Event 1");
-      expect(readRecords[0].date).toBeInstanceOf(DateOnly);
-      expect(readRecords[0].date!.year).toBe(2024);
-      expect(readRecords[0].date!.month).toBe(6);
-      expect(readRecords[0].date!.day).toBe(15);
-      expect(readRecords[1].date).toBeUndefined();
-    });
-
-    it("DateTime 타입을 읽고 쓸 수 있다", async () => {
-      const dateTimeSchema = z.object({
-        title: z.string(),
-        datetime: z.instanceof(DateTime).optional(),
-      });
-
-      const dateTimeDisplayMap = {
-        title: "제목",
-        datetime: "일시",
-      };
-
-      const wrapper = new ExcelWrapper(dateTimeSchema, dateTimeDisplayMap);
-
-      const records = [{ title: "Meeting", datetime: new DateTime(2024, 6, 15, 14, 30, 0) }];
-
-      const wb = await wrapper.write("Events", records);
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      const readRecords = await wrapper.read(buffer, "Events");
-
-      expect(readRecords[0].datetime).toBeInstanceOf(DateTime);
-      expect(readRecords[0].datetime!.year).toBe(2024);
-      expect(readRecords[0].datetime!.month).toBe(6);
-      expect(readRecords[0].datetime!.day).toBe(15);
-      expect(readRecords[0].datetime!.hour).toBe(14);
-      expect(readRecords[0].datetime!.minute).toBe(30);
-    });
-
-    it("Time 타입을 읽고 쓸 수 있다", async () => {
-      const timeSchema = z.object({
-        title: z.string(),
-        time: z.instanceof(Time).optional(),
-      });
-
-      const timeDisplayMap = {
-        title: "제목",
-        time: "시간",
-      };
-
-      const wrapper = new ExcelWrapper(timeSchema, timeDisplayMap);
-
-      const records = [{ title: "Alarm", time: new Time(9, 30, 0) }];
-
-      const wb = await wrapper.write("Events", records);
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      const readRecords = await wrapper.read(buffer, "Events");
-
-      expect(readRecords[0].time).toBeInstanceOf(Time);
-      expect(readRecords[0].time!.hour).toBe(9);
-      expect(readRecords[0].time!.minute).toBe(30);
-    });
-  });
-
-  describe("에러 처리", () => {
-    it("빈 데이터에서 읽으면 에러 발생", async () => {
-      const wrapper = new ExcelWrapper(testSchema, displayNameMap);
-
-      // 헤더만 있는 빈 Excel 생성
-      const wb = await wrapper.write("Empty", []);
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      await expect(wrapper.read(buffer, "Empty")).rejects.toThrow("엑셀파일에서 데이터를 찾을 수 없습니다");
-    });
-
-    it("존재하지 않는 워크시트 이름으로 읽으면 에러 발생", async () => {
-      const wrapper = new ExcelWrapper(testSchema, displayNameMap);
-
-      const wb = await wrapper.write("Test", [{ name: "Test", age: 20 }]);
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      await expect(wrapper.read(buffer, "NotExist")).rejects.toThrow();
-    });
-
-    it("존재하지 않는 워크시트 인덱스로 읽으면 에러 발생", async () => {
-      const wrapper = new ExcelWrapper(testSchema, displayNameMap);
-
-      const wb = await wrapper.write("Test", [{ name: "Test", age: 20 }]);
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      await expect(wrapper.read(buffer, 99)).rejects.toThrow();
-    });
-
-    it("스키마 검증 실패 시 워크시트 이름과 상세 오류가 포함된 에러 발생", async () => {
-      const strictSchema = z.object({
-        name: z.string().min(5), // 최소 5자 이상
-        age: z.number().min(0).max(150), // 0~150 사이
-      });
-
-      const strictDisplayMap = {
-        name: "이름",
-        age: "나이",
-      };
-
-      // 유효한 데이터로 Excel 생성
-      const wrapper = new ExcelWrapper(strictSchema, strictDisplayMap);
-      const wb = await wrapper.write("Validation", [{ name: "홍길동홍길동", age: 30 }]);
-
-      // 데이터를 직접 수정하여 검증 실패 유도
-      const ws = await wb.getWorksheet("Validation");
-      await ws.cell(1, 0).setVal("AB"); // 최소 5자 미만으로 변경
-
-      const buffer = await wb.getBytes();
-      await wb.close();
-
-      // 검증 실패 에러가 발생해야 함
-      await expect(wrapper.read(buffer, "Validation")).rejects.toThrow();
-    });
-  });
-});

package/tests/image-insert.spec.ts

@@ -1,188 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { ExcelWorkbook } from "../src/excel-workbook";
-
-// globalThis.window가 없으면 Node.js 환경
-declare const window: unknown;
-// Node.js 전용 타입 (browser 환경에서도 타입체크가 통과되도록)
-declare const require: (id: string) => unknown;
-
-/**
- * PNG 파일 로드 (Node/브라우저 환경 분기)
- */
-async function loadPngFile(): Promise<Uint8Array> {
-  const url = new URL("./fixtures/logo.png", import.meta.url);
-
-  // Node 환경: fs 사용
-  if (typeof window === "undefined") {
-    const fs = require("fs") as { readFileSync: (path: string) => Uint8Array };
-    const { fileURLToPath } = require("url") as { fileURLToPath: (url: URL) => string };
-    const filePath = fileURLToPath(url);
-    return new Uint8Array(fs.readFileSync(filePath));
-  }
-
-  // 브라우저 환경: fetch 사용
-  const response = await fetch(url);
-  const arrayBuffer = await response.arrayBuffer();
-  return new Uint8Array(arrayBuffer);
-}
-
-/**
- * 통합 테스트: ExcelWorksheet.addImage 동작 검증
- */
-
-describe("ExcelWorksheet.addImage integration", () => {
-  it("should write media, drawing, drawing rels, worksheet rel and content types", async () => {
-    const wb = new ExcelWorkbook();
-    const ws = await wb.createWorksheet("Sheet1");
-
-    const bytes = await loadPngFile();
-
-    // call addImage (the single entry API)
-    await ws.addImage({
-      bytes,
-      ext: "png",
-      from: { r: 0, c: 0 },
-      to: { r: 2, c: 2 },
-    });
-
-    // --- 1) media 존재 및 내용 검사
-    const mediaPath = `xl/media/image1.png`;
-    const mediaObj = await (ws as any)._zipCache.get(mediaPath);
-    expect(mediaObj).toBeDefined();
-    expect(mediaObj instanceof Uint8Array).toBe(true);
-    expect(mediaObj).toEqual(bytes);
-
-    // --- 2) Content Types 에 media / drawing override 존재
-    const types = await (ws as any)._zipCache.get("[Content_Types].xml");
-    expect(types).toBeDefined();
-    // types는 ExcelXmlContentType 인스턴스일 가능성이 높음
-    const overrides = types.data?.Types?.Override ?? [];
-    expect(overrides.some((o: any) => o.$.PartName === "/xl/media/image1.png")).toBeTruthy();
-    expect(overrides.some((o: any) => o.$.PartName === "/xl/drawings/drawing1.xml")).toBeTruthy();
-
-    // --- 3) drawing xml(객체) 존재 및 a:blip r:embed가 rId로 설정되어 있는지 확인
-    const drawingPath = "xl/drawings/drawing1.xml";
-    const drawingObj = await (ws as any)._zipCache.get(drawingPath);
-    expect(drawingObj).toBeDefined();
-
-    // drawingObj는 객체(ExcelXmlDrawing)일 가능성이 높음 — 내부 구조 확인
-    const wsDr = drawingObj?.data?.wsDr;
-    expect(wsDr).toBeDefined();
-    const anchors = wsDr.twoCellAnchor ?? [];
-    expect(anchors.length).toBeGreaterThan(0);
-    const pic = anchors[0].pic?.[0];
-    expect(pic).toBeDefined();
-    const aBlip = pic?.blipFill?.[0]?.["a:blip"]?.[0];
-    expect(aBlip).toBeDefined();
-    const embedVal = aBlip?.$?.["r:embed"];
-    expect(typeof embedVal === "string" && /^rId\d+$/.test(embedVal)).toBeTruthy();
-
-    // --- 4) drawing rels 존재 및 media target 참조
-    const drawingRels = await (ws as any)._zipCache.get("xl/drawings/_rels/drawing1.xml.rels");
-    expect(drawingRels).toBeDefined();
-    const relsArr = drawingRels?.data?.Relationships?.Relationship ?? [];
-    expect(relsArr.some((r: any) => r.$.Target === "../media/image1.png")).toBeTruthy();
-
-    // --- 5) worksheet rels에 drawing rel 추가 및 worksheet xml에 <drawing r:id="..."/> 존재
-    const sheetFileName = (ws as any)._targetFileName; // e.g., "sheet1.xml"
-    const sheetRelsPath = `xl/worksheets/_rels/${sheetFileName}.rels`;
-    const sheetRels = await (ws as any)._zipCache.get(sheetRelsPath);
-    expect(sheetRels).toBeDefined();
-    const sheetRelsArr = sheetRels?.data?.Relationships?.Relationship ?? [];
-    expect(
-      sheetRelsArr.some((r: any) => r.$.Target != null && r.$.Target.indexOf("/drawings/drawing") !== -1),
-    ).toBeTruthy();
-
-    const wsXml = await (ws as any)._zipCache.get(`xl/worksheets/${sheetFileName}`);
-    expect(wsXml).toBeDefined();
-    expect(Array.isArray(wsXml.data?.worksheet?.drawing)).toBeTruthy();
-    const drawingElems = wsXml.data.worksheet.drawing;
-    expect(drawingElems.some((d: any) => d.$ != null && d.$["r:id"] != null)).toBeTruthy();
-
-    // Buffer 생성 검증
-    const resultBuffer = await wb.getBytes();
-    expect(resultBuffer).toBeDefined();
-    expect(resultBuffer.length).toBeGreaterThan(0);
-  });
-
-  it("같은 워크시트에 여러 이미지를 삽입할 수 있다", async () => {
-    const wb = new ExcelWorkbook();
-    const ws = await wb.createWorksheet("Sheet1");
-
-    const bytes = await loadPngFile();
-
-    // 첫 번째 이미지 삽입
-    await ws.addImage({
-      bytes,
-      ext: "png",
-      from: { r: 0, c: 0 },
-      to: { r: 2, c: 2 },
-    });
-
-    // 두 번째 이미지 삽입 (다른 위치)
-    await ws.addImage({
-      bytes,
-      ext: "png",
-      from: { r: 3, c: 0 },
-      to: { r: 5, c: 2 },
-    });
-
-    // --- 1) 두 개의 media 파일이 각각 생성되었는지 확인
-    const media1 = await (ws as any)._zipCache.get("xl/media/image1.png");
-    const media2 = await (ws as any)._zipCache.get("xl/media/image2.png");
-    expect(media1).toBeDefined();
-    expect(media2).toBeDefined();
-    expect(media1 instanceof Uint8Array).toBe(true);
-    expect(media2 instanceof Uint8Array).toBe(true);
-
-    // --- 2) Content Types에 두 이미지가 모두 등록되었는지 확인
-    const types = await (ws as any)._zipCache.get("[Content_Types].xml");
-    const overrides = types.data?.Types?.Override ?? [];
-    expect(overrides.some((o: any) => o.$.PartName === "/xl/media/image1.png")).toBeTruthy();
-    expect(overrides.some((o: any) => o.$.PartName === "/xl/media/image2.png")).toBeTruthy();
-
-    // --- 3) drawing xml에 두 개의 anchor가 있는지 확인
-    const drawingObj = await (ws as any)._zipCache.get("xl/drawings/drawing1.xml");
-    const anchors = drawingObj?.data?.wsDr?.twoCellAnchor ?? [];
-    expect(anchors.length).toBe(2);
-
-    // 첫 번째 이미지 anchor
-    const pic1 = anchors[0].pic?.[0];
-    expect(pic1).toBeDefined();
-    const embed1 = pic1?.blipFill?.[0]?.["a:blip"]?.[0]?.$?.["r:embed"];
-    expect(embed1).toBeDefined();
-
-    // 두 번째 이미지 anchor
-    const pic2 = anchors[1].pic?.[0];
-    expect(pic2).toBeDefined();
-    const embed2 = pic2?.blipFill?.[0]?.["a:blip"]?.[0]?.$?.["r:embed"];
-    expect(embed2).toBeDefined();
-
-    // 서로 다른 rId인지 확인
-    expect(embed1).not.toBe(embed2);
-
-    // --- 4) drawing rels에 두 이미지에 대한 관계가 있는지 확인
-    const drawingRels = await (ws as any)._zipCache.get("xl/drawings/_rels/drawing1.xml.rels");
-    const relsArr = drawingRels?.data?.Relationships?.Relationship ?? [];
-    expect(relsArr.some((r: any) => r.$.Target === "../media/image1.png")).toBeTruthy();
-    expect(relsArr.some((r: any) => r.$.Target === "../media/image2.png")).toBeTruthy();
-
-    // Buffer 생성 검증
-    const resultBuffer = await wb.getBytes();
-    expect(resultBuffer).toBeDefined();
-    expect(resultBuffer.length).toBeGreaterThan(0);
-  });
-
-  it("지원되지 않는 확장자는 에러 발생", async () => {
-    const wb = new ExcelWorkbook();
-    const ws = await wb.createWorksheet("Sheet1");
-
-    await expect(
-      ws.addImage({
-        bytes: new Uint8Array([0, 1, 2, 3]),
-        ext: "xyz123",
-        from: { r: 0, c: 0 },
-      }),
-    ).rejects.toThrow("MIME 타입을 확인할 수 없습니다");
-  });
-});