@clazic/kordoc 2.4.19 → 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-YUAT7LFD.js → utils-RBXHHCLI.js}

@@ -9,7 +9,7 @@ import {
   sanitizeError,
   sanitizeHref,
   toArrayBuffer
-} from "./chunk-MZN7PLTZ.js";
+} from "./chunk-IJGNPAK2.js";
 import "./chunk-ZWE3DS7E.js";
 export {
   KordocError,
@@ -22,4 +22,4 @@ export {
   sanitizeHref,
   toArrayBuffer
 };
-//# sourceMappingURL=utils-YUAT7LFD.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-WEOFVVDO.js → watch-FRLS6FKE.js}

@@ -2,10 +2,13 @@
 import {
   detectFormat,
   parse
-} from "./chunk-463YQ2WL.js";
+} from "./chunk-NKUNXGWI.js";
+import "./chunk-CPTOBJJD.js";
+import "./chunk-THBLCND6.js";
+import "./chunk-AEWWERJ5.js";
 import {
   toArrayBuffer
-} from "./chunk-MZN7PLTZ.js";
+} from "./chunk-IJGNPAK2.js";
 import "./chunk-MOL7MDBG.js";
 import "./chunk-Y4WFKJ5P.js";
 import "./chunk-YW5G6BCJ.js";
@@ -136,4 +139,4 @@ async function sendWebhook(url, payload) {
 export {
   watchDirectory
 };
-//# sourceMappingURL=watch-WEOFVVDO.js.map
+//# sourceMappingURL=watch-FRLS6FKE.js.map

package/dist/{watch-WEOFVVDO.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.19",
+  "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,10 +64,12 @@
     "commander": "^14.0.3",
     "exceljs": "^4.4.0",
     "jszip": "^3.10.1",
-    "libreoffice-convert": "^1.8.1",
     "pdfjs-dist": "^5.6.205",
     "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)