kordoc 2.2.3 → 2.2.5

package/dist/{watch-H672QAW2.js.map → watch-NSBABJ4A.js.map}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kordoc",
-  "version": "2.2.3",
+  "version": "2.2.5",
   "description": "Parse Korean documents (HWP, HWPX, PDF, XLSX, DOCX) to Markdown",
   "type": "module",
   "exports": {