@clazic/kordoc 2.5.2 → 2.6.0

package/README.md

@@ -126,6 +126,25 @@ if (result.success) {
 }
 ```
 
+### PDF 변환 (HWP/HWPX → PDF)
+
+```typescript
+import { convertToPdf } from "@clazic/kordoc"
+import { readFileSync, writeFileSync } from "fs"
+
+const buffer = readFileSync("사업계획서.hwp")
+const result = await convertToPdf(buffer)
+
+if (result.success) {
+  writeFileSync("사업계획서.pdf", result.pdf)
+  console.log(`변환 완료: ${result.sourceFormat} → PDF`)
+} else {
+  console.error(`변환 실패: ${result.error}`)
+}
+```
+
+**요구사항**: 시스템에 [LibreOffice](https://www.libreoffice.org/)가 설치되어 있어야 합니다.
+
 ### 문서 비교 (신구대조표)
 
 ```typescript
@@ -272,6 +291,11 @@ kordoc convert 보고서.md -o 최종보고서.hwpx     # 출력 경로 지정
 kordoc convert 보고서.md --image-dir ./이미지   # 이미지 폴더 지정
 kordoc convert 보고서.md --template 기본.hwpx  # HWPX 템플릿 적용
 
+# HWP/HWPX → PDF 변환
+kordoc convert-pdf 사업계획서.hwp               # → 사업계획서.pdf
+kordoc convert-pdf 보고서.hwpx -o 결과.pdf      # 출력 경로 지정
+kordoc convert-pdf 문서.hwp --pages 1-3        # 페이지 범위
+
 # 폴더 감시 모드
 kordoc watch ./수신함 -d ./변환결과              # 폴더 감시 모드
 kordoc watch ./문서 --webhook https://api/hook  # 웹훅 알림
@@ -381,12 +405,13 @@ HWP 5.x를 제외한 모든 포맷 지원. 설치 없이 바로 연결 가능합
 }
 ```
 
-**8개 도구:**
+**9개 도구:**
 
 | 도구 | 설명 |
 |------|------|
 | `parse_document` | HWP/HWPX/PDF/XLSX/DOCX → 마크다운 (메타데이터·이미지 포함, `image_dir` 지원) |
 | `convert_document` | Markdown → HWPX 또는 XLSX 변환 (이미지 폴더·템플릿 지원) |
+| `convert_to_pdf` | HWP/HWPX → PDF 변환 (페이지 범위·타임아웃 지원) |
 | `detect_format` | 매직 바이트로 포맷 감지 |
 | `parse_metadata` | 메타데이터만 빠르게 추출 |
 | `parse_pages` | 특정 페이지 범위만 파싱 |
@@ -406,6 +431,7 @@ HWP 5.x를 제외한 모든 포맷 지원. 설치 없이 바로 연결 가능합
 | `parsePdf(buffer, options?)` | PDF 전용 |
 | `parseXlsx(buffer, options?)` | XLSX 전용 |
 | `parseDocx(buffer, options?)` | DOCX 전용 |
+| `convertToPdf(input, options?)` | HWP/HWPX → PDF 변환 |
 | `detectFormat(buffer)` | `"hwpx" \| "hwp" \| "pdf" \| "xlsx" \| "docx" \| "unknown"` |
 
 ### 고급 함수
@@ -429,6 +455,8 @@ import type {
   FormField, FormResult,
   OcrProvider, WatchOptions,
   MarkdownToXlsxOptions,
+  // PDF 변환 타입
+  ConvertToPdfOptions, ConvertToPdfResult,
 } from "@clazic/kordoc"
 ```
 

package/dist/{chunk-5CILZHRW.js → chunk-TND4YFBV.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/utils.ts
-var VERSION = true ? "2.5.1" : "0.0.0-dev";
+var VERSION = true ? "2.5.2" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;
@@ -105,4 +105,4 @@ export {
   classifyError,
   normalizeKordocError
 };
-//# sourceMappingURL=chunk-5CILZHRW.js.map
+//# sourceMappingURL=chunk-TND4YFBV.js.map

package/dist/{chunk-25ZYYLVP.js → chunk-TS3F57LY.js}

@@ -7,7 +7,7 @@ import {
   precheckZipSize,
   sanitizeHref,
   toArrayBuffer
-} from "./chunk-5CILZHRW.js";
+} from "./chunk-TND4YFBV.js";
 import {
   parsePageRange
 } from "./chunk-MOL7MDBG.js";
@@ -6686,7 +6686,7 @@ function mergeKoreanLines(text) {
 }
 
 // src/index.ts
-import { readFile } from "fs/promises";
+import { readFile as readFile2 } from "fs/promises";
 
 // src/xlsx/parser.ts
 import JSZip3 from "jszip";
@@ -9821,10 +9821,161 @@ async function markdownToXlsx(markdown, options) {
   return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
 }
 
-// src/pipeline/unified-ocr.ts
-import { performance } from "perf_hooks";
+// src/convert/index.ts
+import { readFile } from "fs/promises";
+
+// src/convert/libreoffice.ts
 import libre from "libreoffice-convert";
+
+// src/convert/error.ts
+var ConvertError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "ConvertError";
+  }
+};
+
+// src/convert/libreoffice.ts
 var libreConvert = libre.convert;
+async function assertSofficeAvailable() {
+  const { runCommand } = await import("./utils-F66K7PXH.js");
+  try {
+    await runCommand("soffice", ["--version"]);
+  } catch {
+    throw new ConvertError(
+      "SOFFICE_NOT_FOUND",
+      "soffice\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. LibreOffice\uB97C \uC124\uCE58\uD574 \uC8FC\uC138\uC694."
+    );
+  }
+}
+async function convertBuffer(buffer, targetExt, timeoutMs = 6e4) {
+  return new Promise((resolve2, reject) => {
+    const timer = setTimeout(() => {
+      reject(
+        new ConvertError("TIMEOUT", `\uBCC0\uD658 \uD0C0\uC784\uC544\uC6C3 (${timeoutMs}ms \uCD08\uACFC)`)
+      );
+    }, timeoutMs);
+    libreConvert(buffer, targetExt, void 0, (err, done) => {
+      clearTimeout(timer);
+      if (err || !done) {
+        reject(
+          new ConvertError(
+            "CONVERT_FAILED",
+            err?.message ?? "LibreOffice \uBCC0\uD658 \uC2E4\uD328"
+          )
+        );
+        return;
+      }
+      resolve2(done);
+    });
+  });
+}
+
+// src/convert/index.ts
+var isConverting = false;
+var queue = [];
+async function acquireConvertLock() {
+  if (!isConverting) {
+    isConverting = true;
+    return () => {
+      isConverting = false;
+      const next = queue.shift();
+      next?.();
+    };
+  }
+  return new Promise((resolve2) => {
+    queue.push(() => {
+      isConverting = true;
+      resolve2(() => {
+        isConverting = false;
+        const next = queue.shift();
+        next?.();
+      });
+    });
+  });
+}
+async function convertToPdf(input, options) {
+  let buffer;
+  try {
+    if (typeof input === "string") {
+      buffer = await readFile(input);
+    } else if (Buffer.isBuffer(input)) {
+      buffer = input;
+    } else {
+      buffer = Buffer.from(input);
+    }
+  } catch (err) {
+    return {
+      success: false,
+      code: "PARSE_ERROR",
+      error: `\uC785\uB825 \uC77D\uAE30 \uC2E4\uD328: ${err instanceof Error ? err.message : String(err)}`,
+      stage: "detect"
+    };
+  }
+  const MAX_FILE_SIZE = 500 * 1024 * 1024;
+  if (buffer.length > MAX_FILE_SIZE) {
+    return {
+      success: false,
+      code: "FILE_TOO_LARGE",
+      error: `\uD30C\uC77C \uD06C\uAE30 \uCD08\uACFC: ${(buffer.length / 1024 / 1024).toFixed(1)}MB (\uCD5C\uB300 500MB)`,
+      stage: "detect"
+    };
+  }
+  const format = detectFormat(toArrayBuffer(buffer));
+  if (format !== "hwp" && format !== "hwpx") {
+    return {
+      success: false,
+      code: "UNSUPPORTED_FORMAT",
+      error: `\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD3EC\uB9F7\uC785\uB2C8\uB2E4: ${format}`,
+      stage: "detect"
+    };
+  }
+  try {
+    await assertSofficeAvailable();
+  } catch (err) {
+    if (err instanceof ConvertError) {
+      return {
+        success: false,
+        code: err.code,
+        error: err.message,
+        stage: "validate"
+      };
+    }
+    throw err;
+  }
+  const releaseLock = await acquireConvertLock();
+  try {
+    options?.onProgress?.(10, "convert");
+    const pdf = await convertBuffer(buffer, ".pdf", options?.timeoutMs);
+    options?.onProgress?.(100, "done");
+    return {
+      success: true,
+      pdf: new Uint8Array(pdf),
+      sourceFormat: format
+    };
+  } catch (err) {
+    if (err instanceof ConvertError) {
+      return {
+        success: false,
+        code: err.code,
+        error: err.message,
+        stage: "convert"
+      };
+    }
+    return {
+      success: false,
+      code: classifyError(err),
+      error: err instanceof Error ? err.message : "\uBCC0\uD658 \uC2E4\uD328",
+      stage: "convert"
+    };
+  } finally {
+    releaseLock();
+  }
+}
+
+// src/pipeline/unified-ocr.ts
+import { performance } from "perf_hooks";
 var OCR_PROMPT = [
   "\uC774 PDF \uD398\uC774\uC9C0 \uC774\uBBF8\uC9C0\uC5D0\uC11C \uD14D\uC2A4\uD2B8\uC640 \uD45C\uB97C \uCD94\uCD9C\uD558\uC5EC Markdown\uC73C\uB85C \uBCC0\uD658\uD558\uACE0, OCR \uC624\uC778\uC2DD \uC624\uB958\uB97C \uC989\uC2DC \uAD50\uC815\uD558\uC5EC \uCD5C\uC885 \uACB0\uACFC\uBB3C\uC744 \uCD9C\uB825\uD558\uC138\uC694.",
   "",
@@ -9864,7 +10015,7 @@ async function parse2(input, options) {
   let buffer;
   if (typeof input === "string") {
     try {
-      const buf = await readFile(input);
+      const buf = await readFile2(input);
       buffer = toArrayBuffer(buf);
     } catch (err) {
       const msg = err instanceof Error && "code" in err && err.code === "ENOENT" ? `\uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input}` : `\uD30C\uC77C \uC77D\uAE30 \uC2E4\uD328: ${input}`;
@@ -10199,6 +10350,7 @@ export {
   extractFormFields,
   markdownToHwpx,
   markdownToXlsx,
+  convertToPdf,
   parse2 as parse
 };
 /*! Bundled license information:
@@ -10206,4 +10358,4 @@ export {
 cfb/cfb.js:
   (*! crc32.js (C) 2014-present SheetJS -- http://sheetjs.com *)
 */
-//# sourceMappingURL=chunk-25ZYYLVP.js.map
+//# sourceMappingURL=chunk-TS3F57LY.js.map