@clazic/kordoc 2.4.18 → 2.5.0

package/dist/setup/doctor.js

@@ -0,0 +1,288 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/setup/detect.ts
+import { spawnSync } from "child_process";
+import { existsSync } from "fs";
+import { join } from "path";
+var isWin = process.platform === "win32";
+function which(cmd) {
+  const finder = isWin ? "where" : "which";
+  const r = spawnSync(finder, [cmd], { encoding: "utf8", shell: isWin });
+  if (r.status !== 0) return void 0;
+  return r.stdout.split(/\r?\n/).find(Boolean)?.trim();
+}
+function resolveCmd(cmd, envKey) {
+  const override = process.env[envKey];
+  if (override) return override;
+  const found = which(cmd);
+  if (found) return found;
+  if (isWin) return findWinCandidate(cmd);
+  return void 0;
+}
+function findWinCandidate(cmd) {
+  const exe = cmd.endsWith(".exe") ? cmd : `${cmd}.exe`;
+  const userProfile = process.env["USERPROFILE"] ?? "C:\\Users\\Default";
+  const localAppData = process.env["LOCALAPPDATA"] ?? join(userProfile, "AppData", "Local");
+  const programFiles = process.env["ProgramFiles"] ?? "C:\\Program Files";
+  const programFilesX86 = process.env["ProgramFiles(x86)"] ?? "C:\\Program Files (x86)";
+  const isPopplerExe = ["pdftoppm.exe", "pdfinfo.exe", "pdftotext.exe"].includes(exe);
+  const isSoffice = exe === "soffice.exe";
+  if (isPopplerExe) return findPopplerWin(exe, { userProfile, localAppData, programFiles, programFilesX86 });
+  if (isSoffice) return findSofficeWin({ programFiles, programFilesX86, localAppData });
+  return void 0;
+}
+function findPopplerWin(exe, p) {
+  const scoopPath = join(p.userProfile, "scoop", "apps", "poppler", "current", "bin", exe);
+  if (existsSync(scoopPath)) return scoopPath;
+  const wingetBase = join(p.localAppData, "Microsoft", "WinGet", "Packages");
+  const wingetResult = globFirst(wingetBase, ["oschwartz10612.Poppler_*"], ["poppler-*", "Library", "bin", exe]);
+  if (wingetResult) return wingetResult;
+  const chocoBase = join("C:", "ProgramData", "chocolatey", "lib", "poppler", "tools");
+  const chocoResult = globFirst(chocoBase, ["poppler-*"], ["bin", exe]);
+  if (chocoResult) return chocoResult;
+  for (const base of [
+    join("C:", "poppler", "bin", exe),
+    join("C:", "tools", "poppler", "bin", exe),
+    join(p.programFiles, "poppler", "bin", exe),
+    join(p.programFilesX86, "poppler", "bin", exe),
+    join(p.localAppData, "Programs", "poppler", "bin", exe)
+  ]) {
+    if (existsSync(base)) return base;
+  }
+  return void 0;
+}
+function findSofficeWin(p) {
+  for (const candidate of [
+    join(p.programFiles, "LibreOffice", "program", "soffice.exe"),
+    join(p.programFilesX86, "LibreOffice", "program", "soffice.exe"),
+    join(p.localAppData, "Programs", "LibreOffice", "program", "soffice.exe"),
+    // winget 설치는 Program Files와 동일
+    join(p.programFiles, "LibreOffice 24", "program", "soffice.exe"),
+    join(p.programFiles, "LibreOffice 25", "program", "soffice.exe")
+  ]) {
+    if (existsSync(candidate)) return candidate;
+  }
+  return void 0;
+}
+function globFirst(base, wildcardSegments, rest) {
+  if (!existsSync(base)) return void 0;
+  let current = base;
+  for (const seg of wildcardSegments) {
+    if (!seg.includes("*")) {
+      current = join(current, seg);
+      if (!existsSync(current)) return void 0;
+      continue;
+    }
+    try {
+      const { readdirSync } = __require("fs");
+      const entries = readdirSync(current);
+      const pattern = seg.replace(/\*/g, ".*");
+      const re = new RegExp(`^${pattern}$`, "i");
+      const match = entries.find((e) => re.test(e));
+      if (!match) return void 0;
+      current = join(current, match);
+    } catch {
+      return void 0;
+    }
+  }
+  const final = join(current, ...rest);
+  return existsSync(final) ? final : void 0;
+}
+function probe(cmd, envKey, versionArgs = ["--version"]) {
+  const resolvedPath = resolveCmd(cmd, envKey);
+  if (!resolvedPath) return { name: cmd, found: false };
+  const v = spawnSync(resolvedPath, versionArgs, { encoding: "utf8", shell: isWin });
+  const versionLine = (v.stdout || v.stderr).split(/\r?\n/)[0]?.trim();
+  return { name: cmd, found: true, path: resolvedPath, version: versionLine };
+}
+function probeOcrToolchain() {
+  return {
+    // poppler는 --version이 비표준이므로 -v 사용
+    pdftoppm: probe("pdftoppm", "KORDOC_PDFTOPPM_PATH", ["-v"]),
+    pdfinfo: probe("pdfinfo", "KORDOC_PDFINFO_PATH", ["-v"]),
+    pdftotext: probe("pdftotext", "KORDOC_PDFTOTEXT_PATH", ["-v"]),
+    soffice: probe("soffice", "KORDOC_SOFFICE_PATH", ["--version"])
+  };
+}
+function isWSL() {
+  if (process.platform !== "linux") return false;
+  try {
+    const { readFileSync } = __require("fs");
+    const version = readFileSync("/proc/version", "utf8");
+    return /microsoft|wsl/i.test(version);
+  } catch {
+    return false;
+  }
+}
+
+// src/setup/pm.ts
+import { spawnSync as spawnSync2 } from "child_process";
+var isWin2 = process.platform === "win32";
+function which2(cmd) {
+  const finder = isWin2 ? "where" : "which";
+  const r = spawnSync2(finder, [cmd], { encoding: "utf8", shell: isWin2 });
+  return r.status === 0;
+}
+function detectPackageManager() {
+  if (process.platform === "darwin") {
+    return which2("brew") ? "brew" : "unknown";
+  }
+  if (isWin2) {
+    if (which2("winget")) return "winget";
+    if (which2("scoop")) return "scoop";
+    if (which2("choco")) return "choco";
+    return "unknown";
+  }
+  if (which2("apt-get") || which2("apt")) return "apt";
+  if (which2("dnf")) return "dnf";
+  if (which2("yum")) return "yum";
+  if (which2("pacman")) return "pacman";
+  if (which2("zypper")) return "zypper";
+  if (which2("apk")) return "apk";
+  return "unknown";
+}
+
+// src/setup/install-commands.ts
+var POPPLER_RECIPES = {
+  brew: { pm: "brew", cmd: "brew install poppler", needsSudo: false },
+  winget: { pm: "winget", cmd: "winget install --id oschwartz10612.Poppler", needsSudo: false, notes: "\uC2E4\uC874 \uD655\uC778\uB428 (winget-pkgs 25.07.0-0)" },
+  scoop: { pm: "scoop", cmd: "scoop install poppler", needsSudo: false, notes: "main \uBC84\uD0B7 \uD3EC\uD568, PATH \uC790\uB3D9 \uB4F1\uB85D" },
+  choco: { pm: "choco", cmd: "choco install poppler -y", needsSudo: true, notes: "\uAD00\uB9AC\uC790 PowerShell \uD544\uC694" },
+  apt: { pm: "apt", cmd: "sudo apt-get install -y poppler-utils", needsSudo: true },
+  dnf: { pm: "dnf", cmd: "sudo dnf install -y poppler-utils", needsSudo: true },
+  yum: { pm: "yum", cmd: "sudo yum install -y poppler-utils", needsSudo: true },
+  pacman: { pm: "pacman", cmd: "sudo pacman -S --noconfirm poppler", needsSudo: true },
+  zypper: { pm: "zypper", cmd: "sudo zypper install -y poppler-tools", needsSudo: true },
+  apk: { pm: "apk", cmd: "apk add --no-cache poppler-utils", needsSudo: false, notes: "Alpine/Docker \uCE5C\uD654" },
+  unknown: null
+};
+var LIBREOFFICE_RECIPES = {
+  brew: { pm: "brew", cmd: "brew install --cask libreoffice", needsSudo: false },
+  winget: { pm: "winget", cmd: "winget install --id TheDocumentFoundation.LibreOffice", needsSudo: false, notes: "\uC2E4\uC874 \uD655\uC778\uB428" },
+  scoop: { pm: "scoop", cmd: "scoop bucket add extras && scoop install libreoffice", needsSudo: false },
+  choco: { pm: "choco", cmd: "choco install libreoffice-fresh -y", needsSudo: true, notes: "\uAD00\uB9AC\uC790 PowerShell \uD544\uC694" },
+  apt: { pm: "apt", cmd: "sudo apt-get install -y libreoffice", needsSudo: true },
+  dnf: { pm: "dnf", cmd: "sudo dnf install -y libreoffice", needsSudo: true },
+  yum: { pm: "yum", cmd: "sudo yum install -y libreoffice", needsSudo: true },
+  pacman: { pm: "pacman", cmd: "sudo pacman -S --noconfirm libreoffice-still", needsSudo: true },
+  zypper: { pm: "zypper", cmd: "sudo zypper install -y libreoffice", needsSudo: true },
+  apk: { pm: "apk", cmd: "apk add --no-cache libreoffice", needsSudo: false, notes: "Alpine \uBBF8\uC9C0\uC6D0 \uAC00\uB2A5 \u2014 node:20-slim(Debian) \uAD8C\uC7A5" },
+  unknown: null
+};
+
+// src/setup/doctor.ts
+var hr = "\u2500".repeat(45);
+function platform() {
+  const arch = process.arch;
+  if (isWSL()) return `linux/WSL (arch: ${arch})`;
+  return `${process.platform} (arch: ${arch})`;
+}
+function icon(found) {
+  return found ? "\u2705" : "\u274C";
+}
+function pad(s, n) {
+  return s.padEnd(n);
+}
+function formatTool(name, status) {
+  const ico = icon(status.found);
+  if (!status.found) return `  ${pad(name, 10)} ${ico}  \uCC3E\uC744 \uC218 \uC5C6\uC74C`;
+  const ver = status.version ? `  (${status.version})` : "";
+  return `  ${pad(name, 10)} ${ico}  ${status.path}${ver}`;
+}
+function runDoctor(opts = {}) {
+  const toolchain = probeOcrToolchain();
+  const pm = detectPackageManager();
+  const popplerOk = toolchain.pdftoppm.found && toolchain.pdfinfo.found;
+  const sofficeOk = toolchain.soffice.found;
+  const missing = [];
+  if (!popplerOk) missing.push("poppler");
+  if (!sofficeOk) missing.push("libreoffice");
+  const out = opts.postinstall ? process.stderr : process.stdout;
+  out.write(`${hr}
+`);
+  out.write(`kordoc OCR \uC758\uC874\uC131 \uC810\uAC80
+`);
+  out.write(`${hr}
+`);
+  out.write(`\uD50C\uB7AB\uD3FC: ${platform()}
+`);
+  out.write(`\uD328\uD0A4\uC9C0 \uB9E4\uB2C8\uC800: ${pm === "unknown" ? "\uAC10\uC9C0 \uC2E4\uD328" : pm}
+`);
+  out.write(`Node.js: ${process.version}
+`);
+  out.write(`
+`);
+  out.write(`[OCR \uD30C\uC774\uD504\uB77C\uC778 \uC758\uC874\uC131]
+`);
+  out.write(`${formatTool("pdftoppm", toolchain.pdftoppm)}
+`);
+  out.write(`${formatTool("pdfinfo", toolchain.pdfinfo)}
+`);
+  out.write(`${formatTool("pdftotext", toolchain.pdftotext)}
+`);
+  out.write(`${formatTool("soffice", toolchain.soffice)}
+`);
+  if (missing.length > 0) {
+    out.write(`
+\uAD8C\uC7A5 \uC124\uCE58 \uBA85\uB839:
+`);
+    if (!popplerOk) {
+      const recipe = POPPLER_RECIPES[pm];
+      if (recipe) {
+        out.write(`  # poppler (pdftoppm/pdfinfo)
+`);
+        out.write(`  ${recipe.cmd}
+`);
+        if (recipe.notes) out.write(`  # ${recipe.notes}
+`);
+      } else {
+        out.write(`  poppler: OS\uC5D0 \uB9DE\uB294 \uBC29\uBC95\uC73C\uB85C \uC124\uCE58\uD558\uC138\uC694 (README \uCC38\uACE0)
+`);
+      }
+    }
+    if (!sofficeOk) {
+      const recipe = LIBREOFFICE_RECIPES[pm];
+      if (recipe) {
+        out.write(`
+  # LibreOffice (soffice)
+`);
+        out.write(`  ${recipe.cmd}
+`);
+        if (recipe.notes) out.write(`  # ${recipe.notes}
+`);
+      } else {
+        out.write(`  LibreOffice: OS\uC5D0 \uB9DE\uB294 \uBC29\uBC95\uC73C\uB85C \uC124\uCE58\uD558\uC138\uC694 (README \uCC38\uACE0)
+`);
+      }
+    }
+    if (process.platform === "win32") {
+      out.write(`
+  \u26A0\uFE0F  \uC124\uCE58 \uD6C4 \uC0C8 \uD130\uBBF8\uB110\uC744 \uC5F4\uAC70\uB098 PATH\uB97C \uAC31\uC2E0\uD574\uC57C \uD569\uB2C8\uB2E4.
+`);
+      out.write(`     PowerShell: $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+`);
+    }
+    out.write(`
+\uD658\uACBD\uBCC0\uC218\uB85C \uACBD\uB85C\uB97C \uC9C1\uC811 \uC9C0\uC815\uD560 \uC218\uB3C4 \uC788\uC2B5\uB2C8\uB2E4:
+`);
+    out.write(`  KORDOC_PDFTOPPM_PATH, KORDOC_PDFINFO_PATH, KORDOC_SOFFICE_PATH
+`);
+    out.write(`
+\uC790\uC138\uD55C \uC810\uAC80: npx kordoc doctor
+`);
+  }
+  out.write(`${hr}
+`);
+  const summary = missing.length === 0 ? "\uBAA8\uB4E0 \uC758\uC874\uC131\uC774 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4 \u2705" : `${missing.length}\uAC1C \uACB0\uC190 \u2014 OCR \uBAA8\uB4DC \uC0AC\uC6A9 \uC2DC \uCC28\uB2E8\uB429\uB2C8\uB2E4 (${missing.join(", ")})`;
+  out.write(`\uC694\uC57D: ${summary}
+`);
+  return { ok: missing.length === 0, missing, toolchain, pm };
+}
+export {
+  runDoctor
+};

package/dist/{utils-DHOODYKU.js → utils-RBXHHCLI.js}

@@ -9,7 +9,7 @@ import {
   sanitizeError,
   sanitizeHref,
   toArrayBuffer
-} from "./chunk-W2KDIKDF.js";
+} from "./chunk-IJGNPAK2.js";
 import "./chunk-ZWE3DS7E.js";
 export {
   KordocError,
@@ -22,4 +22,4 @@ export {
   sanitizeHref,
   toArrayBuffer
 };
-//# sourceMappingURL=utils-DHOODYKU.js.map
+//# sourceMappingURL=utils-RBXHHCLI.js.map

package/dist/utils-RBXHHCLI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{watch-YGIU7RN7.js → watch-FRLS6FKE.js}

@@ -2,14 +2,16 @@
 import {
   detectFormat,
   parse
-} from "./chunk-T7EBS5XP.js";
-import "./chunk-YW5G6BCJ.js";
+} from "./chunk-NKUNXGWI.js";
+import "./chunk-CPTOBJJD.js";
+import "./chunk-THBLCND6.js";
+import "./chunk-AEWWERJ5.js";
 import {
   toArrayBuffer
-} from "./chunk-W2KDIKDF.js";
+} from "./chunk-IJGNPAK2.js";
 import "./chunk-MOL7MDBG.js";
-import "./chunk-7FMKAV4P.js";
-import "./chunk-34WIGIQC.js";
+import "./chunk-Y4WFKJ5P.js";
+import "./chunk-YW5G6BCJ.js";
 import "./chunk-I6YC6ZGK.js";
 import "./chunk-ZWE3DS7E.js";
 
@@ -137,4 +139,4 @@ async function sendWebhook(url, payload) {
 export {
   watchDirectory
 };
-//# sourceMappingURL=watch-YGIU7RN7.js.map
+//# sourceMappingURL=watch-FRLS6FKE.js.map

package/dist/{watch-YGIU7RN7.js.map → watch-FRLS6FKE.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/watch.ts"],"sourcesContent":["/** 디렉토리 감시 모드 — 새 문서 자동 변환 + Webhook 알림 */\n\nimport { watch, readFileSync, writeFileSync, mkdirSync, statSync, existsSync } from \"fs\"\nimport { basename, resolve, extname, sep } from \"path\"\nimport { parse, detectFormat } from \"./index.js\"\nimport { toArrayBuffer } from \"./utils.js\"\nimport type { WatchOptions } from \"./types.js\"\n\nconst SUPPORTED_EXTENSIONS = new Set([\".hwp\", \".hwpx\", \".pdf\", \".xlsx\", \".docx\"])\nconst DEBOUNCE_MS = 1000\n/** 파일 쓰기 완료 판정: 연속 2회 동일 크기 확인 간격 */\nconst STABLE_CHECK_MS = 300\nconst MAX_FILE_SIZE = 500 * 1024 * 1024\n\n/**\n * 디렉토리를 감시하여 새 문서 파일을 자동 변환.\n *\n * @example\n * ```bash\n * kordoc watch ./incoming -d ./output --webhook https://api.example.com/docs\n * ```\n */\nexport async function watchDirectory(options: WatchOptions): Promise<void> {\n  const { dir, outDir, webhook, format = \"markdown\", pages, silent } = options\n\n  if (!existsSync(dir)) throw new Error(`디렉토리를 찾을 수 없습니다: ${dir}`)\n  if (webhook) validateWebhookUrl(webhook)\n  if (outDir) mkdirSync(outDir, { recursive: true })\n\n  const log = silent ? () => {} : (msg: string) => process.stderr.write(msg + \"\\n\")\n  log(`[kordoc watch] 감시 시작: ${resolve(dir)}`)\n  if (outDir) log(`[kordoc watch] 출력: ${resolve(outDir)}`)\n  if (webhook) log(`[kordoc watch] 웹훅: ${webhook}`)\n\n  // 디바운스 맵\n  const pending = new Map<string, ReturnType<typeof setTimeout>>()\n\n  /** 파일 크기가 안정화될 때까지 대기 (쓰기 완료 감지) */\n  const waitForStableSize = async (absPath: string): Promise<number> => {\n    let prevSize = statSync(absPath).size\n    await new Promise(r => setTimeout(r, STABLE_CHECK_MS))\n    if (!existsSync(absPath)) return 0\n    const currSize = statSync(absPath).size\n    if (currSize !== prevSize) {\n      // 크기가 변했으면 한 번 더 대기\n      await new Promise(r => setTimeout(r, STABLE_CHECK_MS))\n      if (!existsSync(absPath)) return 0\n      return statSync(absPath).size\n    }\n    return currSize\n  }\n\n  const processFile = async (filePath: string) => {\n    const ext = extname(filePath).toLowerCase()\n    if (!SUPPORTED_EXTENSIONS.has(ext)) return\n\n    const fileName = basename(filePath)\n    try {\n      const absPath = resolve(dir, filePath)\n      // 경로 순회 방지 — 감시 디렉토리 외부 파일 차단\n      const realDir = resolve(dir)\n      const dirWithSep = realDir.endsWith(sep) ? realDir : realDir + sep\n      if (!absPath.startsWith(dirWithSep) && absPath !== realDir) return\n      if (!existsSync(absPath)) return\n\n      const fileSize = await waitForStableSize(absPath)\n      if (fileSize > MAX_FILE_SIZE || fileSize === 0) return\n\n      log(`[kordoc watch] 변환 중: ${fileName}`)\n\n      const buffer = readFileSync(absPath)\n      const arrayBuffer = toArrayBuffer(buffer)\n      const parseOptions = pages ? { pages } : undefined\n      const result = await parse(arrayBuffer, parseOptions)\n\n      if (!result.success) {\n        log(`[kordoc watch] 실패: ${fileName} — ${result.error}`)\n        await sendWebhook(webhook, { file: fileName, format: detectFormat(arrayBuffer), success: false, error: result.error })\n        return\n      }\n\n      const output = format === \"json\" ? JSON.stringify(result, null, 2) : result.markdown\n\n      if (outDir) {\n        const outExt = format === \"json\" ? \".json\" : \".md\"\n        const outPath = resolve(outDir, fileName.replace(/\\.[^.]+$/, outExt))\n        writeFileSync(outPath, output, \"utf-8\")\n        log(`[kordoc watch] 완료: ${fileName} → ${basename(outPath)}`)\n      } else {\n        process.stdout.write(output + \"\\n\")\n      }\n\n      await sendWebhook(webhook, {\n        file: fileName,\n        format: result.fileType,\n        success: true,\n        markdown: format === \"markdown\" ? output.substring(0, 1000) : undefined,\n      })\n    } catch (err) {\n      log(`[kordoc watch] 에러: ${fileName} — ${err instanceof Error ? err.message : err}`)\n    }\n  }\n\n  const handler = (_event: string | null, filename: string | Buffer | null) => {\n    if (!filename) return\n    const filePath = filename.toString()\n    const existing = pending.get(filePath)\n    if (existing) clearTimeout(existing)\n    pending.set(filePath, setTimeout(() => {\n      pending.delete(filePath)\n      processFile(filePath).catch(() => {})\n    }, DEBOUNCE_MS))\n  }\n\n  // fs.watch recursive: Node 18+ macOS/Windows, Node 22+ Linux\n  // Linux Node 22 미만은 recursive 미지원 → graceful degradation (최상위 디렉토리만 감시)\n  try {\n    watch(dir, { recursive: true }, handler)\n  } catch {\n    process.stderr.write(\"[kordoc watch] 경고: 하위 디렉토리 감시 미지원 (Node.js 22+ 또는 macOS/Windows 필요) — 최상위만 감시\\n\")\n    watch(dir, handler)\n  }\n\n  // 프로세스 종료 방지 (Ctrl+C로 종료)\n  return new Promise(() => {})\n}\n\n/** Webhook URL 검증 — SSRF 방지: http/https만 허용, localhost/private IP 차단 */\nfunction validateWebhookUrl(url: string): void {\n  let parsed: URL\n  try {\n    parsed = new URL(url)\n  } catch {\n    throw new Error(`유효하지 않은 webhook URL: ${url}`)\n  }\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new Error(`허용되지 않는 webhook 프로토콜: ${parsed.protocol}`)\n  }\n  const hostname = parsed.hostname.toLowerCase()\n  if (\n    hostname === \"localhost\" ||\n    hostname === \"[::1]\" ||\n    hostname.startsWith(\"127.\") ||\n    hostname.startsWith(\"10.\") ||\n    hostname.startsWith(\"192.168.\") ||\n    /^172\\.(1[6-9]|2\\d|3[01])\\./.test(hostname) ||\n    hostname === \"0.0.0.0\" ||\n    hostname.startsWith(\"169.254.\") ||\n    hostname.endsWith(\".local\") ||\n    // IPv6 사설 대역\n    hostname.startsWith(\"[fc\") ||\n    hostname.startsWith(\"[fd\") ||\n    hostname.startsWith(\"[fe80:\") ||\n    hostname === \"[::0]\" ||\n    hostname === \"[::]\" ||\n    // 클라우드 메타데이터 엔드포인트\n    hostname === \"metadata.google.internal\" ||\n    hostname === \"metadata.google\" ||\n    // 16진수/8진수 IP 인코딩 우회 방지\n    /^0x[0-9a-f]+$/i.test(hostname) ||\n    /^0[0-7]+$/.test(hostname)\n  ) {\n    throw new Error(`내부 네트워크 대상 webhook은 허용되지 않습니다: ${hostname}`)\n  }\n}\n\nasync function sendWebhook(url: string | undefined, payload: Record<string, unknown>): Promise<void> {\n  if (!url) return\n  try {\n    validateWebhookUrl(url)\n    await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ ...payload, timestamp: new Date().toISOString() }),\n    })\n  } catch {\n    // webhook 실패는 조용히 무시\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/watch.ts"],"sourcesContent":["/** 디렉토리 감시 모드 — 새 문서 자동 변환 + Webhook 알림 */\n\nimport { watch, readFileSync, writeFileSync, mkdirSync, statSync, existsSync } from \"fs\"\nimport { basename, resolve, extname, sep } from \"path\"\nimport { parse, detectFormat } from \"./index.js\"\nimport { toArrayBuffer } from \"./utils.js\"\nimport type { WatchOptions } from \"./types.js\"\n\nconst SUPPORTED_EXTENSIONS = new Set([\".hwp\", \".hwpx\", \".pdf\", \".xlsx\", \".docx\"])\nconst DEBOUNCE_MS = 1000\n/** 파일 쓰기 완료 판정: 연속 2회 동일 크기 확인 간격 */\nconst STABLE_CHECK_MS = 300\nconst MAX_FILE_SIZE = 500 * 1024 * 1024\n\n/**\n * 디렉토리를 감시하여 새 문서 파일을 자동 변환.\n *\n * @example\n * ```bash\n * kordoc watch ./incoming -d ./output --webhook https://api.example.com/docs\n * ```\n */\nexport async function watchDirectory(options: WatchOptions): Promise<void> {\n  const { dir, outDir, webhook, format = \"markdown\", pages, silent } = options\n\n  if (!existsSync(dir)) throw new Error(`디렉토리를 찾을 수 없습니다: ${dir}`)\n  if (webhook) validateWebhookUrl(webhook)\n  if (outDir) mkdirSync(outDir, { recursive: true })\n\n  const log = silent ? () => {} : (msg: string) => process.stderr.write(msg + \"\\n\")\n  log(`[kordoc watch] 감시 시작: ${resolve(dir)}`)\n  if (outDir) log(`[kordoc watch] 출력: ${resolve(outDir)}`)\n  if (webhook) log(`[kordoc watch] 웹훅: ${webhook}`)\n\n  // 디바운스 맵\n  const pending = new Map<string, ReturnType<typeof setTimeout>>()\n\n  /** 파일 크기가 안정화될 때까지 대기 (쓰기 완료 감지) */\n  const waitForStableSize = async (absPath: string): Promise<number> => {\n    let prevSize = statSync(absPath).size\n    await new Promise(r => setTimeout(r, STABLE_CHECK_MS))\n    if (!existsSync(absPath)) return 0\n    const currSize = statSync(absPath).size\n    if (currSize !== prevSize) {\n      // 크기가 변했으면 한 번 더 대기\n      await new Promise(r => setTimeout(r, STABLE_CHECK_MS))\n      if (!existsSync(absPath)) return 0\n      return statSync(absPath).size\n    }\n    return currSize\n  }\n\n  const processFile = async (filePath: string) => {\n    const ext = extname(filePath).toLowerCase()\n    if (!SUPPORTED_EXTENSIONS.has(ext)) return\n\n    const fileName = basename(filePath)\n    try {\n      const absPath = resolve(dir, filePath)\n      // 경로 순회 방지 — 감시 디렉토리 외부 파일 차단\n      const realDir = resolve(dir)\n      const dirWithSep = realDir.endsWith(sep) ? realDir : realDir + sep\n      if (!absPath.startsWith(dirWithSep) && absPath !== realDir) return\n      if (!existsSync(absPath)) return\n\n      const fileSize = await waitForStableSize(absPath)\n      if (fileSize > MAX_FILE_SIZE || fileSize === 0) return\n\n      log(`[kordoc watch] 변환 중: ${fileName}`)\n\n      const buffer = readFileSync(absPath)\n      const arrayBuffer = toArrayBuffer(buffer)\n      const parseOptions = pages ? { pages } : undefined\n      const result = await parse(arrayBuffer, parseOptions)\n\n      if (!result.success) {\n        log(`[kordoc watch] 실패: ${fileName} — ${result.error}`)\n        await sendWebhook(webhook, { file: fileName, format: detectFormat(arrayBuffer), success: false, error: result.error })\n        return\n      }\n\n      const output = format === \"json\" ? JSON.stringify(result, null, 2) : result.markdown\n\n      if (outDir) {\n        const outExt = format === \"json\" ? \".json\" : \".md\"\n        const outPath = resolve(outDir, fileName.replace(/\\.[^.]+$/, outExt))\n        writeFileSync(outPath, output, \"utf-8\")\n        log(`[kordoc watch] 완료: ${fileName} → ${basename(outPath)}`)\n      } else {\n        process.stdout.write(output + \"\\n\")\n      }\n\n      await sendWebhook(webhook, {\n        file: fileName,\n        format: result.fileType,\n        success: true,\n        markdown: format === \"markdown\" ? output.substring(0, 1000) : undefined,\n      })\n    } catch (err) {\n      log(`[kordoc watch] 에러: ${fileName} — ${err instanceof Error ? err.message : err}`)\n    }\n  }\n\n  const handler = (_event: string | null, filename: string | Buffer | null) => {\n    if (!filename) return\n    const filePath = filename.toString()\n    const existing = pending.get(filePath)\n    if (existing) clearTimeout(existing)\n    pending.set(filePath, setTimeout(() => {\n      pending.delete(filePath)\n      processFile(filePath).catch(() => {})\n    }, DEBOUNCE_MS))\n  }\n\n  // fs.watch recursive: Node 18+ macOS/Windows, Node 22+ Linux\n  // Linux Node 22 미만은 recursive 미지원 → graceful degradation (최상위 디렉토리만 감시)\n  try {\n    watch(dir, { recursive: true }, handler)\n  } catch {\n    process.stderr.write(\"[kordoc watch] 경고: 하위 디렉토리 감시 미지원 (Node.js 22+ 또는 macOS/Windows 필요) — 최상위만 감시\\n\")\n    watch(dir, handler)\n  }\n\n  // 프로세스 종료 방지 (Ctrl+C로 종료)\n  return new Promise(() => {})\n}\n\n/** Webhook URL 검증 — SSRF 방지: http/https만 허용, localhost/private IP 차단 */\nfunction validateWebhookUrl(url: string): void {\n  let parsed: URL\n  try {\n    parsed = new URL(url)\n  } catch {\n    throw new Error(`유효하지 않은 webhook URL: ${url}`)\n  }\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new Error(`허용되지 않는 webhook 프로토콜: ${parsed.protocol}`)\n  }\n  const hostname = parsed.hostname.toLowerCase()\n  if (\n    hostname === \"localhost\" ||\n    hostname === \"[::1]\" ||\n    hostname.startsWith(\"127.\") ||\n    hostname.startsWith(\"10.\") ||\n    hostname.startsWith(\"192.168.\") ||\n    /^172\\.(1[6-9]|2\\d|3[01])\\./.test(hostname) ||\n    hostname === \"0.0.0.0\" ||\n    hostname.startsWith(\"169.254.\") ||\n    hostname.endsWith(\".local\") ||\n    // IPv6 사설 대역\n    hostname.startsWith(\"[fc\") ||\n    hostname.startsWith(\"[fd\") ||\n    hostname.startsWith(\"[fe80:\") ||\n    hostname === \"[::0]\" ||\n    hostname === \"[::]\" ||\n    // 클라우드 메타데이터 엔드포인트\n    hostname === \"metadata.google.internal\" ||\n    hostname === \"metadata.google\" ||\n    // 16진수/8진수 IP 인코딩 우회 방지\n    /^0x[0-9a-f]+$/i.test(hostname) ||\n    /^0[0-7]+$/.test(hostname)\n  ) {\n    throw new Error(`내부 네트워크 대상 webhook은 허용되지 않습니다: ${hostname}`)\n  }\n}\n\nasync function sendWebhook(url: string | undefined, payload: Record<string, unknown>): Promise<void> {\n  if (!url) return\n  try {\n    validateWebhookUrl(url)\n    await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ ...payload, timestamp: new Date().toISOString() }),\n    })\n  } catch {\n    // webhook 실패는 조용히 무시\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clazic/kordoc",
-  "version": "2.4.18",
+  "version": "2.5.0",
   "description": "Parse Korean documents (HWP, HWPX, PDF, XLSX, DOCX) to Markdown",
   "type": "module",
   "exports": {
@@ -18,9 +18,11 @@
     "kordoc-mcp": "dist/mcp.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "scripts"
   ],
   "scripts": {
+    "postinstall": "node scripts/postinstall.cjs",
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "node --import tsx --test tests/*.test.ts",
@@ -62,11 +64,12 @@
     "commander": "^14.0.3",
     "exceljs": "^4.4.0",
     "jszip": "^3.10.1",
-    "libreoffice-convert": "^1.8.1",
     "pdfjs-dist": "^5.6.205",
-    "tesseract.js": "^7.0.0",
     "zod": "^4.3.6"
   },
+  "optionalDependencies": {
+    "libreoffice-convert": "^1.8.1"
+  },
   "devDependencies": {
     "@types/node": "^18.19.130",
     "pdfjs-dist": "^5.6.205",

package/scripts/postinstall.cjs

@@ -0,0 +1,27 @@
+"use strict"
+// postinstall — 검사·안내 전용. 절대 자동 설치하지 않으며 항상 exit 0.
+const { spawnSync } = require("node:child_process")
+const fs = require("node:fs")
+const path = require("node:path")
+
+// 건너뛰는 조건: CI, 프로덕션 모드, 스킵 플래그, 잘못된 lifecycle
+const skip =
+  process.env.CI === "true" ||
+  process.env.KORDOC_SKIP_DOCTOR === "1" ||
+  process.env.npm_config_production === "true" ||
+  process.env.npm_lifecycle_event !== "postinstall"
+
+if (skip) process.exit(0)
+
+try {
+  // dist/setup/doctor.cjs가 없으면 (git clone 직후 등) 조용히 종료
+  const entry = path.join(__dirname, "..", "dist", "setup", "doctor.cjs")
+  if (!fs.existsSync(entry)) process.exit(0)
+
+  const result = spawnSync(process.execPath, [entry, "--postinstall"], { stdio: "inherit" })
+  // doctor 결과와 무관하게 항상 성공으로 끝낸다 — npm install 차단 금지
+} catch (_e) {
+  // 어떤 오류도 npm install을 실패시키지 않는다
+}
+
+process.exit(0)

package/dist/chunk-34WIGIQC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ocr/cli-provider.ts"],"sourcesContent":["/**\n * CLI 기반 OCR 프로바이더\n *\n * gemini / claude / codex / ollama CLI를 subprocess로 호출하여\n * PDF 페이지 이미지를 Markdown으로 변환.\n *\n * 이미지 전달 방식:\n * - gemini:  -p \"프롬프트 @이미지경로\"  (@ 파일 참조)\n * - claude:  -p \"프롬프트 @이미지경로\"  (@ 파일 참조, --print 모드)\n * - codex:   exec -i 이미지경로 \"프롬프트\"  (-i/--image 플래그)\n * - ollama:  REST API (localhost:11434) — CLI는 이미지 입력 미지원\n */\n\nimport { spawnSync } from \"child_process\"\nimport { writeFileSync, readFileSync, unlinkSync, mkdirSync } from \"fs\"\nimport { join } from \"path\"\nimport { tmpdir } from \"os\"\nimport type { OcrMode, StructuredOcrResult } from \"../types.js\"\n\n/** OCR 프롬프트 — 모든 CLI 공통 */\nconst OCR_PROMPT = `이 PDF 페이지 이미지에서 텍스트와 테이블을 추출하여 순수 Markdown으로 변환하세요.\n규칙:\n- 테이블은 Markdown 테이블 문법 사용 (| 구분, |---|---| 헤더 구분선 포함)\n- 병합된 셀은 해당 위치에 내용 기재\n- 헤딩은 글자 크기에 따라 ## ~ ###### 사용\n- 리스트는 - 또는 1. 사용\n- 이미지, 도형 등 비텍스트 요소는 무시\n- 원문의 읽기 순서와 구조를 유지\n- \\`\\`\\`로 감싸지 말고 순수 Markdown만 출력`\n\n/** 임시 디렉토리 (프로세스당 1회 생성)\n *\n * gemini CLI는 /tmp/ 등 시스템 임시 디렉토리를 워크스페이스 외부로 간주하여\n * @파일참조 시 접근을 거부할 수 있음. cwd 하위 폴더를 사용하면 모든 CLI에서 접근 가능.\n *\n * ⚠️ .gitignore에 포함된 경로(예: .kordoc-tmp/)는 gemini CLI가 무시하므로\n * 반드시 gitignore되지 않는 이름 사용. 파일은 try/finally로 즉시 정리.\n */\nlet _tempDir: string | null = null\nfunction getTempDir(): string {\n  if (!_tempDir) {\n    _tempDir = join(process.cwd(), \".kordoc_ocr_tmp\")\n    mkdirSync(_tempDir, { recursive: true })\n  }\n  return _tempDir\n}\n\n/**\n * CLI OcrProvider 생성.\n *\n * @param mode - 사용할 CLI (gemini, claude, codex, ollama)\n * @returns OcrProvider 함수 (StructuredOcrResult 반환)\n */\nexport function createCliOcrProvider(\n  mode: Exclude<OcrMode, \"auto\" | \"off\" | \"tesseract\">\n): (pageImage: Uint8Array, pageNumber: number, mimeType: \"image/png\") => Promise<StructuredOcrResult> {\n  return async (pageImage: Uint8Array, pageNumber: number): Promise<StructuredOcrResult> => {\n    const tempPath = join(getTempDir(), `page-${pageNumber}.png`)\n\n    try {\n      writeFileSync(tempPath, pageImage)\n\n      let output: string\n      if (mode === \"ollama\") {\n        output = await callOllamaApi(tempPath)\n      } else {\n        output = callCli(mode, tempPath)\n      }\n\n      return { markdown: stripCodeFence(output.trim()) }\n    } finally {\n      try { unlinkSync(tempPath) } catch { /* 임시 파일 정리 실패 무시 */ }\n    }\n  }\n}\n\n/**\n * 출력 텍스트에서 사용량·속도 제한 에러 감지.\n * 해당 메시지가 포함된 경우 throw하여 다음 엔진으로 fallback 트리거.\n */\nfunction checkForLimitError(output: string, mode: string): void {\n  const lower = output.toLowerCase()\n  if (lower.includes(\"usage limit\") || lower.includes(\"rate limit\")) {\n    throw new Error(`${mode} 사용량/속도 제한: ${output.trim().slice(0, 200)}`)\n  }\n}\n\n/**\n * CLI 실행 — gemini / claude / codex\n *\n * @throws CLI 실행 실패 또는 타임아웃(180초) 시 Error\n */\nfunction callCli(mode: string, imagePath: string): string {\n  // codex는 --output-last-message로 대화 헤더 없는 깔끔한 출력 사용\n  if (mode === \"codex\") {\n    return callCodexCli(imagePath)\n  }\n\n  const args = buildCliArgs(mode, imagePath)\n\n  const result = spawnSync(mode, args, {\n    encoding: \"utf-8\",\n    timeout: 600_000,\n    maxBuffer: 10 * 1024 * 1024,\n    shell: process.platform === \"win32\",\n    // claude: /tmp에서 실행하여 프로젝트 CLAUDE.md의 규칙 간섭 방지\n    ...(mode === \"claude\" ? { cwd: tmpdir() } : {}),\n  })\n\n  if (result.error) {\n    throw new Error(`${mode} CLI 실행 실패: ${result.error.message}`)\n  }\n  if (result.status !== 0) {\n    const errMsg = result.stderr?.trim() || `exit code ${result.status}`\n    throw new Error(`${mode} OCR 실패: ${errMsg}`)\n  }\n\n  const output = result.stdout || \"\"\n  checkForLimitError(output, mode)\n  return output\n}\n\n/**\n * codex exec 실행 — --output-last-message로 대화 헤더 없는 깔끔한 출력.\n * 인자 순서: `codex exec <prompt> --image <file> --output-last-message <outfile>`\n */\nfunction callCodexCli(imagePath: string): string {\n  // 출력 파일은 /tmp/ 사용 — codex sandbox는 cwd 내 쓰기를 막을 수 있음\n  const outPath = join(tmpdir(), `kordoc-codex-out-${Date.now()}.txt`)\n  try {\n    const args = [\"exec\", OCR_PROMPT, \"--image\", imagePath, \"--output-last-message\", outPath]\n    const model = process.env.KORDOC_CODEX_MODEL\n    if (model) args.push(\"--model\", model)\n\n    const result = spawnSync(\"codex\", args, {\n      encoding: \"utf-8\",\n      timeout: 180_000,\n      maxBuffer: 10 * 1024 * 1024,\n      input: \"\",  // stdin EOF 즉시 전달 (대화형 입력 차단)\n      shell: process.platform === \"win32\",\n    })\n\n    if (result.error) {\n      throw new Error(`codex CLI 실행 실패: ${result.error.message}`)\n    }\n    if (result.status !== 0) {\n      const errMsg = result.stderr?.trim() || `exit code ${result.status}`\n      throw new Error(`codex OCR 실패: ${errMsg}`)\n    }\n\n    // --output-last-message 파일에서 읽기 (없으면 stdout 폴백)\n    let text: string\n    try {\n      text = readFileSync(outPath, \"utf-8\")\n    } catch {\n      text = result.stdout || \"\"\n    }\n    checkForLimitError(text, \"codex\")\n    return text\n  } finally {\n    try { unlinkSync(outPath) } catch { /* 무시 */ }\n  }\n}\n\n/**\n * CLI별 인자 배열 생성.\n *\n * gemini:  [\"--prompt\", \"프롬프트 @이미지경로\", \"--yolo\"]\n *   - -y/--yolo: 자동 승인 (OCR은 도구 사용 없으므로 실질적 영향 없음)\n *   - @ 파일 참조로 이미지를 컨텍스트에 포함\n *\n * claude:  [\"--print\", \"프롬프트 @이미지경로\"]\n *   - --print(-p): 비대화형 출력 모드\n *   - @ 파일 참조로 이미지를 컨텍스트에 포함\n *\n * codex: callCodexCli()에서 별도 처리\n *   - `codex exec <prompt> --image <file> --output-last-message <outfile>`\n *   - 프롬프트가 --image보다 앞에 위치해야 함 (인자 순서 중요)\n *\n * ⚠️ CLI 버전에 따라 문법이 다를 수 있음. 업데이트 시 --help 재확인 필요.\n */\nfunction buildCliArgs(mode: string, imagePath: string): string[] {\n  const normalizedPath = imagePath.replace(/\\\\/g, \"/\")\n  const promptWithImage = `${OCR_PROMPT}\n\n이미지: @${normalizedPath}`\n\n  switch (mode) {\n    case \"gemini\": {\n      const args = [\"--prompt\", promptWithImage, \"--yolo\"]\n      const model = process.env.KORDOC_GEMINI_MODEL\n      if (model) args.push(\"--model\", model)\n      return args\n    }\n\n    case \"claude\": {\n      const args = [\"--print\", promptWithImage]\n      const model = process.env.KORDOC_CLAUDE_MODEL\n      if (model) args.push(\"--model\", model)\n      return args\n    }\n\n    default:\n      throw new Error(`지원하지 않는 CLI: ${mode}`)\n  }\n}\n\n/**\n * Ollama REST API 호출 — CLI는 이미지 입력을 지원하지 않으므로 API 직접 사용.\n *\n * 기본 모델: KORDOC_OLLAMA_MODEL 환경변수 또는 \"gemma4:27b\"\n * 기본 호스트: KORDOC_OLLAMA_HOST 환경변수 또는 \"http://localhost:11434\"\n *\n * @throws Ollama 서버 미실행 또는 응답 오류 시 Error\n */\nasync function callOllamaApi(imagePath: string): Promise<string> {\n  const { readFileSync } = await import(\"fs\")\n  const imageBase64 = readFileSync(imagePath).toString(\"base64\")\n\n  const model = process.env.KORDOC_OLLAMA_MODEL || \"qwen3-vl:8b\"\n  const host = process.env.KORDOC_OLLAMA_HOST || \"http://localhost:11434\"\n  const timeoutMs = Number(process.env.KORDOC_OLLAMA_TIMEOUT) || 120_000\n\n  const response = await fetch(`${host}/api/chat`, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({\n      model,\n      messages: [{\n        role: \"user\",\n        content: OCR_PROMPT,\n        images: [imageBase64],\n      }],\n      stream: false,\n    }),\n    signal: AbortSignal.timeout(timeoutMs),\n  })\n\n  if (!response.ok) {\n    throw new Error(`Ollama API 오류: ${response.status} ${response.statusText}`)\n  }\n\n  const data = await response.json() as { message?: { content?: string } }\n  return data.message?.content || \"\"\n}\n\n/**\n * LLM 출력에서 코드 펜스 제거.\n * LLM이 가끔 결과를 ```markdown ... ``` 으로 감싸는 경우 처리.\n */\nfunction stripCodeFence(text: string): string {\n  const match = text.match(/^```(?:markdown|md)?\\s*([\\s\\S]*?)```\\s*$/m)\n  return match ? match[1].trim() : text\n}\n"],"mappings":"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","names":["readFileSync"]}

package/dist/chunk-7FMKAV4P.js

@@ -1,56 +0,0 @@
-#!/usr/bin/env node
-
-// src/ocr/tesseract-provider.ts
-import { createWorker } from "tesseract.js";
-async function createTesseractProvider() {
-  const worker = await createWorker("kor+eng");
-  let terminated = false;
-  const provider = async (pageImage, _pageNumber, _mimeType) => {
-    const { data } = await worker.recognize(pageImage);
-    return data.text;
-  };
-  provider.terminate = async () => {
-    if (!terminated) {
-      await worker.terminate();
-      terminated = true;
-    }
-  };
-  return provider;
-}
-async function createTesseractPoolProvider(concurrency) {
-  const workers = await Promise.all(
-    Array.from({ length: concurrency }, () => createWorker("kor+eng"))
-  );
-  const idle = [...workers];
-  const waitQueue = [];
-  function acquire() {
-    if (idle.length > 0) return Promise.resolve(idle.pop());
-    return new Promise((resolve) => waitQueue.push(resolve));
-  }
-  function release(w) {
-    if (waitQueue.length > 0) {
-      waitQueue.shift()(w);
-    } else {
-      idle.push(w);
-    }
-  }
-  const provider = async (pageImage, _pageNumber, _mimeType) => {
-    const w = await acquire();
-    try {
-      const { data } = await w.recognize(pageImage);
-      return data.text;
-    } finally {
-      release(w);
-    }
-  };
-  provider.terminate = async () => {
-    await Promise.all(workers.map((w) => w.terminate()));
-  };
-  return provider;
-}
-
-export {
-  createTesseractProvider,
-  createTesseractPoolProvider
-};
-//# sourceMappingURL=chunk-7FMKAV4P.js.map

package/dist/chunk-7FMKAV4P.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ocr/tesseract-provider.ts"],"sourcesContent":["/**\n * Tesseract.js 기반 OCR 프로바이더\n *\n * tesseract.js는 bundled 의존성으로 별도 설치 불필요.\n * Vision LLM CLI가 없을 때의 최후 fallback으로 자동 사용.\n *\n * 특성:\n * - 순수 텍스트만 반환 (테이블/헤딩 구조 복원 불가)\n * - 한글 인식률 약 85-90% (깨끗한 이미지 기준)\n * - 완전 오프라인 동작 (API 키 불필요)\n */\n\nimport { createWorker } from \"tesseract.js\"\nimport type { OcrProvider } from \"../types.js\"\n\n/**\n * Tesseract.js OcrProvider 생성.\n *\n * 워커를 1회 생성하여 재사용 (매 페이지마다 초기화 방지).\n * 문서 처리 완료 후 terminate()로 워커 정리.\n *\n * @returns OcrProvider 함수 (+ terminate 메서드)\n */\nexport async function createTesseractProvider(): Promise<OcrProvider & { terminate: () => Promise<void> }> {\n  // kor+eng: 한글 + 영문 동시 인식 (한국 공문서 특성)\n  const worker = await createWorker(\"kor+eng\")\n  let terminated = false\n\n  const provider = async (\n    pageImage: Uint8Array,\n    _pageNumber: number,\n    _mimeType: \"image/png\"\n  ): Promise<string> => {\n    const { data } = await worker.recognize(pageImage)\n    return data.text\n  }\n\n  ;(provider as OcrProvider & { terminate: () => Promise<void> }).terminate = async () => {\n    if (!terminated) {\n      await worker.terminate()\n      terminated = true\n    }\n  }\n\n  return provider as OcrProvider & { terminate: () => Promise<void> }\n}\n\n/**\n * Tesseract.js 워커 풀 기반 병렬 OcrProvider 생성.\n *\n * N개 워커를 동시 생성하여 여러 페이지를 병렬로 OCR 처리.\n * acquire/release 패턴으로 동시 실행 안전성 보장.\n * 대량 이미지 기반 PDF(예: 300페이지) 처리 속도 향상에 효과적.\n *\n * @param concurrency - 동시 워커 수 (권장: CPU 코어 수)\n * @returns OcrProvider 함수 (+ terminate 메서드)\n */\nexport async function createTesseractPoolProvider(\n  concurrency: number\n): Promise<OcrProvider & { terminate: () => Promise<void> }> {\n  // N개 워커를 동시 초기화 (Promise.all로 병렬 생성)\n  const workers = await Promise.all(\n    Array.from({ length: concurrency }, () => createWorker(\"kor+eng\"))\n  )\n\n  // 유휴 워커 큐 (초기에는 모든 워커가 유휴 상태)\n  const idle: typeof workers = [...workers]\n  // 워커를 기다리는 콜백 큐\n  const waitQueue: ((w: (typeof workers)[0]) => void)[] = []\n\n  /** 유휴 워커를 획득 (없으면 대기) */\n  function acquire(): Promise<(typeof workers)[0]> {\n    if (idle.length > 0) return Promise.resolve(idle.pop()!)\n    return new Promise(resolve => waitQueue.push(resolve))\n  }\n\n  /** 사용 완료된 워커를 반환 (대기 중인 호출자에게 우선 전달) */\n  function release(w: (typeof workers)[0]): void {\n    if (waitQueue.length > 0) {\n      // 대기 중인 요청자에게 즉시 전달\n      waitQueue.shift()!(w)\n    } else {\n      idle.push(w)\n    }\n  }\n\n  // 병렬 호출 안전 프로바이더 — 각 호출이 acquire/release로 워커를 독점 사용\n  const provider = async (\n    pageImage: Uint8Array,\n    _pageNumber: number,\n    _mimeType: \"image/png\"\n  ): Promise<string> => {\n    const w = await acquire()\n    try {\n      const { data } = await w.recognize(pageImage)\n      return data.text\n    } finally {\n      // 성공/실패 무관하게 워커 반환\n      release(w)\n    }\n  }\n\n  // 모든 워커 정리 메서드\n  ;(provider as OcrProvider & { terminate: () => Promise<void> }).terminate = async () => {\n    await Promise.all(workers.map(w => w.terminate()))\n  }\n\n  return provider as OcrProvider & { terminate: () => Promise<void> }\n}\n"],"mappings":";;;AAYA,SAAS,oBAAoB;AAW7B,eAAsB,0BAAqF;AAEzG,QAAM,SAAS,MAAM,aAAa,SAAS;AAC3C,MAAI,aAAa;AAEjB,QAAM,WAAW,OACf,WACA,aACA,cACoB;AACpB,UAAM,EAAE,KAAK,IAAI,MAAM,OAAO,UAAU,SAAS;AACjD,WAAO,KAAK;AAAA,EACd;AAEC,EAAC,SAA8D,YAAY,YAAY;AACtF,QAAI,CAAC,YAAY;AACf,YAAM,OAAO,UAAU;AACvB,mBAAa;AAAA,IACf;AAAA,EACF;AAEA,SAAO;AACT;AAYA,eAAsB,4BACpB,aAC2D;AAE3D,QAAM,UAAU,MAAM,QAAQ;AAAA,IAC5B,MAAM,KAAK,EAAE,QAAQ,YAAY,GAAG,MAAM,aAAa,SAAS,CAAC;AAAA,EACnE;AAGA,QAAM,OAAuB,CAAC,GAAG,OAAO;AAExC,QAAM,YAAkD,CAAC;AAGzD,WAAS,UAAwC;AAC/C,QAAI,KAAK,SAAS,EAAG,QAAO,QAAQ,QAAQ,KAAK,IAAI,CAAE;AACvD,WAAO,IAAI,QAAQ,aAAW,UAAU,KAAK,OAAO,CAAC;AAAA,EACvD;AAGA,WAAS,QAAQ,GAA8B;AAC7C,QAAI,UAAU,SAAS,GAAG;AAExB,gBAAU,MAAM,EAAG,CAAC;AAAA,IACtB,OAAO;AACL,WAAK,KAAK,CAAC;AAAA,IACb;AAAA,EACF;AAGA,QAAM,WAAW,OACf,WACA,aACA,cACoB;AACpB,UAAM,IAAI,MAAM,QAAQ;AACxB,QAAI;AACF,YAAM,EAAE,KAAK,IAAI,MAAM,EAAE,UAAU,SAAS;AAC5C,aAAO,KAAK;AAAA,IACd,UAAE;AAEA,cAAQ,CAAC;AAAA,IACX;AAAA,EACF;AAGC,EAAC,SAA8D,YAAY,YAAY;AACtF,UAAM,QAAQ,IAAI,QAAQ,IAAI,OAAK,EAAE,UAAU,CAAC,CAAC;AAAA,EACnD;AAEA,SAAO;AACT;","names":[]}

package/dist/chunk-7NOZFYH6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ocr/auto-detect.ts"],"sourcesContent":["/**\n * OCR CLI 자동 탐색\n *\n * 탐색 순서: codex → gemini → claude → ollama → tesseract.js\n * CLI는 which(unix) / where(win) 명령어로 PATH 존재 확인.\n * tesseract.js는 bundled 의존성이므로 항상 사용 가능 (최후 fallback).\n */\n\nimport { execSync } from \"child_process\"\nimport type { OcrMode } from \"../types.js\"\n\n/** CLI 탐색 우선순위 */\nconst CLI_PRIORITY = [\"codex\", \"gemini\", \"claude\", \"ollama\"] as const\n\n/**\n * 시스템에 설치된 OCR 도구를 우선순위대로 탐색.\n * tesseract.js는 bundled 의존성이므로 CLI를 찾지 못해도 항상 \"tesseract\" 반환.\n * @returns 사용 가능한 OcrMode (null 반환 없음)\n */\nexport function detectAvailableOcr(): OcrMode {\n  // 1. CLI 프로그램 탐색 (codex → gemini → claude → ollama)\n  for (const cli of CLI_PRIORITY) {\n    if (isCliInstalled(cli)) return cli\n  }\n\n  // 2. tesseract.js — bundled 의존성, 항상 사용 가능\n  return \"tesseract\"\n}\n\n/**\n * 특정 CLI가 시스템 PATH에 있는지 확인.\n * which(unix) 또는 where(win32) 사용.\n */\nfunction isCliInstalled(name: string): boolean {\n  try {\n    const cmd = process.platform === \"win32\" ? \"where\" : \"which\"\n    execSync(`${cmd} ${name}`, { stdio: \"ignore\", timeout: 3000 })\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * auto 모드에서 시도할 fallback 체인 반환.\n * 설치된 CLI만 포함하며, tesseract는 항상 마지막에 추가.\n */\nexport function getAutoFallbackChain(): OcrMode[] {\n  const chain: OcrMode[] = []\n  for (const cli of CLI_PRIORITY) {\n    if (isCliInstalled(cli)) chain.push(cli)\n  }\n  chain.push(\"tesseract\")\n  return chain\n}\n\n/**\n * 수동 지정된 OcrMode 유효성 검증.\n * --ocr gemini 등 강제 지정 시 호출.\n * @throws 해당 CLI가 설치되지 않은 경우 Error (tesseract는 항상 통과)\n */\nexport function validateOcrMode(mode: OcrMode): void {\n  if (mode === \"auto\" || mode === \"off\" || mode === \"tesseract\") return\n\n  if (!isCliInstalled(mode)) {\n    throw new Error(`'${mode}' CLI가 설치되지 않았습니다.\\n${getInstallGuide(mode)}`)\n  }\n}\n\n/** CLI별 설치 안내 메시지 */\nfunction getInstallGuide(mode: string): string {\n  const guides: Record<string, string> = {\n    gemini: \"설치: https://ai.google.dev/gemini-api/docs/cli\",\n    claude: \"설치: npm install -g @anthropic-ai/claude-code 또는 https://claude.ai/code\",\n    codex:  \"설치: npm install -g @openai/codex 또는 https://github.com/openai/codex\",\n    ollama: \"설치: brew install ollama 또는 https://ollama.com/download\",\n  }\n  return guides[mode] || `'${mode}'을(를) 설치해주세요.`\n}\n\n/**\n * AI CLI가 없어 tesseract.js로 fallback할 때 표시할 안내 메시지.\n */\nexport function getTesseractFallbackMessage(): string {\n  return [\n    \"설치된 AI CLI가 없어 내장 tesseract.js로 OCR을 수행합니다.\",\n    \"더 나은 품질(테이블/헤딩 구조 보존)을 위해 AI CLI 설치를 권장합니다:\",\n    \"\",\n    \"  [권장] Codex CLI:   npm install -g @openai/codex\",\n    \"         Gemini CLI:  https://ai.google.dev/gemini-api/docs/cli\",\n    \"         Claude CLI:  npm install -g @anthropic-ai/claude-code\",\n    \"         Ollama:      brew install ollama (+ ollama pull gemma4:27b)\",\n  ].join(\"\\n\")\n}\n"],"mappings":";;;AAQA,SAAS,gBAAgB;AAIzB,IAAM,eAAe,CAAC,SAAS,UAAU,UAAU,QAAQ;AAOpD,SAAS,qBAA8B;AAE5C,aAAW,OAAO,cAAc;AAC9B,QAAI,eAAe,GAAG,EAAG,QAAO;AAAA,EAClC;AAGA,SAAO;AACT;AAMA,SAAS,eAAe,MAAuB;AAC7C,MAAI;AACF,UAAM,MAAM,QAAQ,aAAa,UAAU,UAAU;AACrD,aAAS,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,OAAO,UAAU,SAAS,IAAK,CAAC;AAC7D,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMO,SAAS,uBAAkC;AAChD,QAAM,QAAmB,CAAC;AAC1B,aAAW,OAAO,cAAc;AAC9B,QAAI,eAAe,GAAG,EAAG,OAAM,KAAK,GAAG;AAAA,EACzC;AACA,QAAM,KAAK,WAAW;AACtB,SAAO;AACT;AAOO,SAAS,gBAAgB,MAAqB;AACnD,MAAI,SAAS,UAAU,SAAS,SAAS,SAAS,YAAa;AAE/D,MAAI,CAAC,eAAe,IAAI,GAAG;AACzB,UAAM,IAAI,MAAM,IAAI,IAAI;AAAA,EAAuB,gBAAgB,IAAI,CAAC,EAAE;AAAA,EACxE;AACF;AAGA,SAAS,gBAAgB,MAAsB;AAC7C,QAAM,SAAiC;AAAA,IACrC,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,OAAQ;AAAA,IACR,QAAQ;AAAA,EACV;AACA,SAAO,OAAO,IAAI,KAAK,IAAI,IAAI;AACjC;AAKO,SAAS,8BAAsC;AACpD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;","names":[]}