ev-subsidy-status 0.2.0

package/src/cli.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+"use strict"
+
+const { getSubsidyStatus, searchRegions } = require("./index")
+
+function parseArgs(argv) {
+  const options = { command: "status" }
+  let index = 0
+  if (argv[0] && !argv[0].startsWith("-") && ["status", "regions"].includes(argv[0])) {
+    options.command = argv[0]
+    index = 1
+  }
+  for (; index < argv.length; index += 1) {
+    const arg = argv[index]
+    if (arg === "--region" || arg === "-r") options.region = argv[++index]
+    else if (arg === "--query" || arg === "-q") options.query = argv[++index]
+    else if (arg === "--vehicle" || arg === "--vehicle-type") options.vehicleType = argv[++index]
+    else if (arg === "--year") options.year = argv[++index]
+    else if (arg === "--category") options.category = argv[++index]
+    else if (arg === "--model") options.model = argv[++index]
+    else if (arg === "--transport") options.transport = argv[++index]
+    else if (arg === "--provider") options.provider = argv[++index]
+    else if (arg === "--cdp-url") options.cdpUrl = argv[++index]
+    else if (arg === "--timeout") options.timeoutMs = argv[++index]
+    else if (arg === "--json") options.json = true
+    else if (arg === "--help" || arg === "-h") options.help = true
+    else if (!options.region && options.command === "status") options.region = arg
+    else if (!options.query && options.command === "regions") options.query = arg
+  }
+  return options
+}
+
+function formatCount(counts) {
+  if (!counts) return "확인 불가"
+  const total = Number.isFinite(counts.total) ? `${counts.total.toLocaleString("ko-KR")}대` : "확인 불가"
+  const details = [
+    ["우선", counts.priority],
+    ["법인·기관", counts.corporate],
+    ["일반", counts.general]
+  ]
+  if (Number.isFinite(counts.taxi)) details.splice(2, 0, ["택시", counts.taxi])
+  if (Number.isFinite(counts.small_business)) details.splice(2, 0, ["중소기업", counts.small_business])
+  return `${total} (${details.filter(([, value]) => Number.isFinite(value)).map(([label, value]) => `${label} ${value.toLocaleString("ko-KR")}`).join(", ")})`
+}
+
+function formatStatus(result) {
+  const lines = [
+    `${result.region.sido_name} ${result.region.local_name} ${result.status.vehicle_label} 보조금 현황`,
+    `조회: ${result.source.fetched_at}`,
+    "",
+    `민간공고대수: ${formatCount(result.status.notice_count)}`,
+    `접수대수: ${formatCount(result.status.application_count)}`,
+    `출고대수: ${formatCount(result.status.delivered_count)}`,
+    `출고잔여대수: ${formatCount(result.status.delivery_remaining_count)}`,
+    `상태: ${result.availability.label}`,
+    `접수방법: ${result.status.application_method || "확인 불가"}`,
+    `비고: ${result.status.note || "없음"}`
+  ]
+  if (result.model_subsidy) {
+    lines.push(
+      "",
+      `모델: ${result.model_subsidy.manufacturer} ${result.model_subsidy.model}`,
+      `1대당 보조금: ${(result.model_subsidy.total_subsidy_krw || 0).toLocaleString("ko-KR")}원`,
+      `모델 기준 잔여 환산치: ${(result.remaining_budget.model_equivalent_estimate_krw || 0).toLocaleString("ko-KR")}원`
+    )
+  } else if (Array.isArray(result.model_subsidy_candidates) && result.model_subsidy_candidates.length) {
+    lines.push("", "일치하는 세부 모델:")
+    for (const item of result.model_subsidy_candidates) {
+      const subsidy = Number.isFinite(item.total_subsidy_krw)
+        ? `${item.total_subsidy_krw.toLocaleString("ko-KR")}원`
+        : "확인 불가"
+      const estimate = Number.isFinite(item.remaining_equivalent_estimate_krw)
+        ? `${item.remaining_equivalent_estimate_krw.toLocaleString("ko-KR")}원`
+        : "확인 불가"
+      lines.push(`- ${item.manufacturer} ${item.model}: 1대당 ${subsidy}, 잔여 환산치 ${estimate}`)
+    }
+  }
+  lines.push(
+    "",
+    "주의: 출고잔여대수는 실제 신청 가능 대수와 다를 수 있으며 정확한 원화 예산 잔액이 아닙니다.",
+    `출처: ${result.source.url}`
+  )
+  if (result.warnings.length) lines.push("", ...result.warnings.map((warning) => `경고: ${warning}`))
+  return lines.join("\n")
+}
+
+function printHelp(io = console) {
+  io.log(`Usage:
+  ev-subsidy-status status --region "경기 성남시" [options]
+  ev-subsidy-status regions --query "중구" [options]
+
+Options:
+  -r, --region <region>       시도와 시군구. 예: 경기 성남시
+  -q, --query <text>          regions 명령의 지역 검색어
+  --vehicle <type>            passenger/승용, cargo/화물, bus/승합
+  --year <year>               기준년도. 기본값은 현재 연도
+  --model <model>             지자체 모델별 보조금과 잔여 환산치 조회
+  --transport <transport>     기본 direct-http, 선택값 browser
+  --provider <provider>       browser 사용 시 auto, aside, browseros, chrome-cdp
+  --cdp-url <url>             사용자가 실행한 Chrome/BrowserOS CDP URL
+  --timeout <ms>              페이지 대기 시간
+  --json                      JSON 출력
+`)
+}
+
+async function main(options = parseArgs(process.argv.slice(2)), io = console) {
+  if (options.help) {
+    printHelp(io)
+    return null
+  }
+  if (options.command === "regions") {
+    const result = await searchRegions(options)
+    io.log(JSON.stringify(result, null, 2))
+    return result
+  }
+  const result = await getSubsidyStatus(options)
+  io.log(options.json ? JSON.stringify(result, null, 2) : formatStatus(result))
+  return result
+}
+
+function formatError(error) {
+  return JSON.stringify({
+    error: {
+      code: error && error.code ? error.code : "UNKNOWN",
+      message: error && error.message ? error.message : String(error),
+      details: error && error.details ? error.details : {}
+    }
+  }, null, 2)
+}
+
+function run(argv = process.argv.slice(2), io = console) {
+  return main(parseArgs(argv), io).catch((error) => {
+    io.error(formatError(error))
+    process.exitCode = 1
+  })
+}
+
+if (require.main === module) run()
+
+module.exports = {
+  formatCount,
+  formatError,
+  formatStatus,
+  main,
+  parseArgs,
+  printHelp,
+  run
+}

package/src/constants.js

@@ -0,0 +1,65 @@
+"use strict"
+
+const STATUS_URL = "https://ev.or.kr/nportal/buySupprt/initSubsidyPaymentCheckAction.do"
+const MODEL_SUBSIDY_PATH = "/nportal/buySupprt/psPopupLocalCarModelPrice.do"
+
+const VEHICLE_TYPES = Object.freeze({
+  passenger: Object.freeze({
+    key: "passenger",
+    label: "전기승용",
+    carTypeCode: "11",
+    aliases: ["passenger", "car", "승용", "전기승용", "전기차"]
+  }),
+  cargo: Object.freeze({
+    key: "cargo",
+    label: "전기화물",
+    carTypeCode: "12",
+    aliases: ["cargo", "truck", "화물", "전기화물"]
+  }),
+  bus: Object.freeze({
+    key: "bus",
+    label: "전기승합",
+    carTypeCode: "13",
+    aliases: ["bus", "van", "승합", "전기승합"]
+  })
+})
+
+const SIDO_ALIASES = Object.freeze({
+  서울: ["서울", "서울시", "서울특별시"],
+  부산: ["부산", "부산시", "부산광역시"],
+  대구: ["대구", "대구시", "대구광역시"],
+  인천: ["인천", "인천시", "인천광역시"],
+  광주: ["광주", "광주시", "광주광역시"],
+  대전: ["대전", "대전시", "대전광역시"],
+  울산: ["울산", "울산시", "울산광역시"],
+  세종: ["세종", "세종시", "세종특별자치시"],
+  경기: ["경기", "경기도"],
+  강원: ["강원", "강원도", "강원특별자치도"],
+  충북: ["충북", "충청북도"],
+  충남: ["충남", "충청남도"],
+  전북: ["전북", "전라북도", "전북특별자치도"],
+  전남: ["전남", "전라남도"],
+  경북: ["경북", "경상북도"],
+  경남: ["경남", "경상남도"],
+  제주: ["제주", "제주도", "제주특별자치도"]
+})
+
+function resolveVehicleType(value) {
+  const normalized = String(value || "passenger").trim().toLowerCase()
+  for (const definition of Object.values(VEHICLE_TYPES)) {
+    if (definition.aliases.some((alias) => alias.toLowerCase() === normalized)) {
+      return definition
+    }
+  }
+  const error = new Error(`지원하지 않는 차종입니다: ${value}`)
+  error.code = "VEHICLE_TYPE_NOT_AVAILABLE"
+  throw error
+}
+
+module.exports = {
+  MODEL_SUBSIDY_PATH,
+  SIDO_ALIASES,
+  STATUS_URL,
+  VEHICLE_TYPES,
+  resolveVehicleType
+}

package/src/errors.js

@@ -0,0 +1,39 @@
+"use strict"
+
+class EvSubsidyError extends Error {
+  constructor(code, message, details = {}) {
+    super(message)
+    this.name = "EvSubsidyError"
+    this.code = code
+    this.details = details
+  }
+}
+
+function createError(code, message, details) {
+  return new EvSubsidyError(code, message, details)
+}
+
+function wrapBrowserError(error) {
+  if (error instanceof EvSubsidyError) return error
+  const sourceCode = error && error.code
+  const code = sourceCode === "CAPTCHA_DETECTED"
+    ? "CAPTCHA_DETECTED"
+    : sourceCode === "AUTH_REQUIRED"
+      ? "AUTH_REQUIRED"
+      : sourceCode === "UNKNOWN_PROVIDER"
+        ? "BROWSER_UNAVAILABLE"
+        : sourceCode === "UNAVAILABLE" || sourceCode === "PLAYWRIGHT_UNAVAILABLE"
+          ? "BROWSER_UNAVAILABLE"
+          : "UPSTREAM_FAILED"
+  const wrapped = createError(code, error && error.message ? error.message : String(error), {
+    upstream_code: sourceCode || null
+  })
+  wrapped.cause = error
+  return wrapped
+}
+
+module.exports = {
+  EvSubsidyError,
+  createError,
+  wrapBrowserError
+}

package/src/estimate.js

@@ -0,0 +1,30 @@
+"use strict"
+
+function buildUnavailableBudget(reason = "공개 지급현황은 정확한 원화 예산 잔액을 제공하지 않습니다.") {
+  return {
+    exact_available: false,
+    exact_amount_krw: null,
+    reason,
+    model_equivalent_estimate_krw: null,
+    estimate_assumptions: []
+  }
+}
+
+function estimateModelEquivalent({ remainingCount, subsidyPerVehicleKrw }) {
+  const budget = buildUnavailableBudget()
+  if (!Number.isFinite(remainingCount) || remainingCount < 0) return budget
+  if (!Number.isFinite(subsidyPerVehicleKrw) || subsidyPerVehicleKrw <= 0) return budget
+
+  budget.model_equivalent_estimate_krw = Math.round(remainingCount * subsidyPerVehicleKrw)
+  budget.estimate_assumptions = [
+    `공식 출고잔여대수 ${remainingCount}대가 모두 선택 모델에 배정된다고 가정`,
+    `1대당 확인된 국비+지방비 ${Math.round(subsidyPerVehicleKrw)}원 적용`,
+    "구매자 특성별 추가지원과 대상군 간 물량 전환은 반영하지 않음"
+  ]
+  return budget
+}
+
+module.exports = {
+  buildUnavailableBudget,
+  estimateModelEquivalent
+}

package/src/http.js

@@ -0,0 +1,332 @@
+"use strict"
+
+const { MODEL_SUBSIDY_PATH, SIDO_ALIASES, STATUS_URL, resolveVehicleType } = require("./constants")
+const { createError } = require("./errors")
+const {
+  attachModelEstimate,
+  buildStatusResult,
+  normalizeRegionKey,
+  normalizeText,
+  parseModelSubsidyRows,
+  parseStatusRows
+} = require("./parse")
+const { decodeProtectedHtml, extractPnpScriptUrl } = require("./pnp")
+
+const DEFAULT_TIMEOUT_MS = 30000
+const DEFAULT_HEADERS = Object.freeze({
+  accept: "text/html,application/xhtml+xml",
+  "accept-language": "ko-KR,ko;q=0.9",
+  "user-agent": "ev-subsidy-status/0.1 (+https://github.com/NomaDamas/k-skill)"
+})
+
+let cachedPnp = null
+
+function decodeHtmlEntities(value) {
+  return String(value)
+    .replace(/&#x([0-9a-f]+);/gi, (_, hex) => String.fromCodePoint(Number.parseInt(hex, 16)))
+    .replace(/&#(\d+);/g, (_, number) => String.fromCodePoint(Number(number)))
+    .replace(/ /gi, " ")
+    .replace(/&/gi, "&")
+    .replace(/&lt;/gi, "<")
+    .replace(/&gt;/gi, ">")
+    .replace(/&quot;/gi, "\"")
+    .replace(/&#39;|&apos;/gi, "'")
+}
+
+function htmlToText(value) {
+  return normalizeText(decodeHtmlEntities(String(value)
+    .replace(/<br\s*\/?>/gi, "\n")
+    .replace(/<\/(?:p|div|li)>/gi, "\n")
+    .replace(/<[^>]*>/g, " ")))
+}
+
+function parseNoticeFiles(cellHtml) {
+  const items = []
+  const pattern = /<(a|button)\b([^>]*)>([\s\S]*?)<\/\1>|<input\b([^>]*)>/gi
+  let match
+  while ((match = pattern.exec(cellHtml))) {
+    const attributes = match[2] || match[4] || ""
+    const attribute = (name) => {
+      const found = attributes.match(new RegExp(`\\b${name}=(['"])([\\s\\S]*?)\\1`, "i"))
+      return decodeHtmlEntities(found ? found[2] : "")
+    }
+    const label = match[1]
+      ? htmlToText(match[3])
+      : attribute("value")
+    const onclick = attribute("onclick")
+    const title = attribute("title")
+    if (label || onclick) items.push({ label, title, onclick })
+  }
+  return items
+}
+
+function extractStatusRows(html) {
+  const tables = Array.from(String(html).matchAll(/<table\b[^>]*>([\s\S]*?)<\/table>/gi), (match) => match[1])
+  const table = tables.find((candidate) => /출고잔여/.test(htmlToText(candidate)))
+  if (!table) throw createError("DOM_CHANGED", "공식 지급현황 표를 찾지 못했습니다.")
+
+  const bodyMatch = table.match(/<tbody\b[^>]*>([\s\S]*?)<\/tbody>/i)
+  const body = bodyMatch ? bodyMatch[1] : table
+  const rows = []
+  for (const rowMatch of body.matchAll(/<tr\b[^>]*>([\s\S]*?)<\/tr>/gi)) {
+    const cellHtml = Array.from(rowMatch[1].matchAll(/<td\b[^>]*>([\s\S]*?)<\/td>/gi), (match) => match[1])
+    if (cellHtml.length < 10) continue
+    const cells = cellHtml.map(htmlToText)
+    const codeMatch = cellHtml[3].match(/goDownloadFile\(\s*['"][^'"]+['"]\s*,\s*['"]([^'"]+)['"]/i)
+    rows.push({
+      cells,
+      local_code: codeMatch ? codeMatch[1] : null,
+      notice_files: parseNoticeFiles(cellHtml[3])
+    })
+  }
+  if (!rows.length) throw createError("RESULT_EMPTY", "공식 지급현황 표에 데이터 행이 없습니다.")
+  return rows
+}
+
+function extractModelSubsidySnapshot(html) {
+  const candidates = Array.from(String(html).matchAll(/<table\b[^>]*>([\s\S]*?)<\/table>/gi), (match) => {
+    const table = match[1]
+    const headers = Array.from(table.matchAll(/<th\b[^>]*>([\s\S]*?)<\/th>/gi), (header) => htmlToText(header[1]))
+    const rows = Array.from(table.matchAll(/<tr\b[^>]*>([\s\S]*?)<\/tr>/gi), (row) =>
+      Array.from(row[1].matchAll(/<td\b[^>]*>([\s\S]*?)<\/td>/gi), (cell) => htmlToText(cell[1]))
+    ).filter((cells) => cells.length >= 6)
+    return { headers, rows }
+  }).filter((candidate) =>
+    candidate.rows.length > 0 &&
+    /제조사/.test(candidate.headers.join(" ")) &&
+    /모델/.test(candidate.headers.join(" ")) &&
+    /국비/.test(candidate.headers.join(" "))
+  ).sort((a, b) => b.rows.length - a.rows.length)
+
+  if (!candidates.length) {
+    throw createError("DOM_CHANGED", "공식 모델별 보조금 표를 찾지 못했습니다.")
+  }
+  return candidates[0]
+}
+
+function canonicalSidoFromQuery(query) {
+  const key = normalizeRegionKey(query)
+  return Object.entries(SIDO_ALIASES).find(([, aliases]) =>
+    aliases.some((alias) => key.includes(normalizeRegionKey(alias)))
+  )?.[0] || null
+}
+
+function localMatches(query, localName) {
+  const key = normalizeRegionKey(query)
+  const local = normalizeRegionKey(localName)
+  if (key.includes(local)) return true
+  const short = local.replace(/(시|군|구)$/u, "")
+  return short.length >= 2 && key.includes(short)
+}
+
+function resolveRegionFromRows(query, rawRows) {
+  if (!normalizeText(query)) throw createError("REGION_REQUIRED", "조회할 시도와 시군구를 입력하세요.")
+  const explicitSido = canonicalSidoFromQuery(query)
+  const matches = rawRows.filter((row) => {
+    const [sidoName, localName] = row.cells
+    if (explicitSido && normalizeRegionKey(sidoName) !== normalizeRegionKey(explicitSido)) return false
+    return localMatches(query, localName)
+  }).map((row) => ({
+    sidoName: row.cells[0],
+    sidoCode: row.local_code ? `${row.local_code.slice(0, 2)}00` : null,
+    localName: row.cells[1],
+    localCode: row.local_code
+  }))
+  const unique = Array.from(new Map(matches.map((item) => [`${item.sidoName}:${item.localName}`, item])).values())
+  if (!unique.length) throw createError("REGION_NOT_FOUND", `공식 지급현황에서 "${query}" 지역을 찾지 못했습니다.`)
+  if (unique.length > 1) {
+    throw createError("REGION_AMBIGUOUS", `"${query}"에 해당하는 지역이 여러 곳입니다. 시도를 함께 입력하세요.`, {
+      candidates: unique
+    })
+  }
+  return unique[0]
+}
+
+async function fetchText(url, options = {}) {
+  const fetchImpl = options.fetch || globalThis.fetch
+  if (typeof fetchImpl !== "function") throw createError("UPSTREAM_FAILED", "사용 가능한 fetch 구현이 없습니다.")
+  const timeoutMs = Number.isFinite(Number(options.timeoutMs)) ? Number(options.timeoutMs) : DEFAULT_TIMEOUT_MS
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), timeoutMs)
+  try {
+    const response = await fetchImpl(url, {
+      ...options.request,
+      headers: { ...DEFAULT_HEADERS, ...(options.request && options.request.headers) },
+      signal: controller.signal
+    })
+    if (!response.ok) {
+      throw createError("UPSTREAM_FAILED", `공식 사이트가 HTTP ${response.status}를 반환했습니다.`, {
+        status: response.status
+      })
+    }
+    return response.text()
+  } catch (error) {
+    if (error.name === "AbortError") throw createError("UPSTREAM_TIMEOUT", "공식 사이트 응답 시간이 초과되었습니다.")
+    throw error
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+async function fetchDecodedStatusHtml(options = {}) {
+  const vehicle = resolveVehicleType(options.vehicleType)
+  const year = Number(options.year || new Date().getFullYear())
+  const body = new URLSearchParams({
+    car_type: vehicle.carTypeCode,
+    year1: String(year),
+    localDo_cd: "all",
+    local_cd1: "all"
+  })
+  const shellHtml = await fetchText(STATUS_URL, {
+    ...options,
+    request: {
+      method: "POST",
+      headers: { "content-type": "application/x-www-form-urlencoded;charset=UTF-8" },
+      body: body.toString()
+    }
+  })
+  if (!/<meta[^>]+name=['"]penc['"]/i.test(shellHtml)) return { html: shellHtml, vehicle, year }
+
+  const pnpUrl = extractPnpScriptUrl(shellHtml, STATUS_URL)
+  if (!cachedPnp || cachedPnp.url !== pnpUrl || options.fetch) {
+    cachedPnp = {
+      url: pnpUrl,
+      source: await fetchText(pnpUrl, options)
+    }
+  }
+  const html = decodeProtectedHtml(shellHtml, cachedPnp.source)
+  const selectedYear = html.match(/<option\b[^>]*value=['"](\d{4})['"][^>]*selected/i)?.[1]
+  if (selectedYear && Number(selectedYear) !== year) {
+    throw createError("YEAR_NOT_AVAILABLE", `${year}년 지급현황을 공식 페이지에서 선택할 수 없습니다.`)
+  }
+  return { html, vehicle, year }
+}
+
+async function fetchDecodedModelHtml(options = {}) {
+  const vehicle = options.vehicle || resolveVehicleType(options.vehicleType)
+  const year = Number(options.year || new Date().getFullYear())
+  const modelUrl = new URL(MODEL_SUBSIDY_PATH, STATUS_URL).toString()
+  const body = new URLSearchParams({
+    year: String(year),
+    year1: String(year),
+    local_cd: String(options.localCode),
+    car_type: vehicle.carTypeCode
+  })
+  const shellHtml = await fetchText(modelUrl, {
+    ...options,
+    request: {
+      method: "POST",
+      headers: { "content-type": "application/x-www-form-urlencoded;charset=UTF-8" },
+      body: body.toString()
+    }
+  })
+  if (!/<meta[^>]+name=['"]penc['"]/i.test(shellHtml)) {
+    return { html: shellHtml, modelUrl }
+  }
+
+  const pnpUrl = extractPnpScriptUrl(shellHtml, modelUrl)
+  if (!cachedPnp || cachedPnp.url !== pnpUrl || options.fetch) {
+    cachedPnp = {
+      url: pnpUrl,
+      source: await fetchText(pnpUrl, options)
+    }
+  }
+  return {
+    html: decodeProtectedHtml(shellHtml, cachedPnp.source),
+    modelUrl
+  }
+}
+
+async function getSubsidyStatusHttp(options = {}) {
+  const { html, vehicle, year } = await fetchDecodedStatusHtml(options)
+  const rawRows = extractStatusRows(html)
+  const region = resolveRegionFromRows(options.region, rawRows)
+  const rows = parseStatusRows(rawRows, { localName: region.localName, vehicleType: vehicle.key })
+  const result = buildStatusResult({
+    query: {
+      region: options.region,
+      year,
+      vehicle_type: vehicle.key,
+      category: options.category || "all",
+      model: options.model || null
+    },
+    region,
+    rows,
+    sourceUrl: STATUS_URL
+  })
+  result.transport = "direct-http"
+  if (options.model) {
+    try {
+      const modelResponse = await fetchDecodedModelHtml({
+        ...options,
+        localCode: region.localCode,
+        vehicle
+      })
+      const parsed = parseModelSubsidyRows(extractModelSubsidySnapshot(modelResponse.html), {
+        model: options.model
+      })
+      const remainingCount = result.availability.official_remaining_count
+      result.model_subsidy_candidates = parsed.items.map((item) => ({
+        ...item,
+        remaining_equivalent_estimate_krw:
+          Number.isFinite(remainingCount) && Number.isFinite(item.total_subsidy_krw)
+            ? remainingCount * item.total_subsidy_krw
+            : null
+      }))
+      result.model_subsidy_source_url = modelResponse.modelUrl
+
+      if (parsed.items.length === 1) {
+        Object.assign(result, attachModelEstimate(result, parsed.items[0]))
+      } else if (parsed.items.length > 1) {
+        result.warnings.push(
+          `"${options.model}"에 해당하는 세부 모델이 ${parsed.items.length}개입니다. 트림별 보조금과 잔여 환산치를 구분해 확인하세요.`
+        )
+      } else {
+        result.model_lookup_error = {
+          code: "MODEL_LOOKUP_FAILED",
+          message: `공식 모델별 보조금 표에서 "${options.model}"을 찾지 못했습니다.`
+        }
+        result.warnings.push(result.model_lookup_error.message)
+      }
+    } catch (error) {
+      result.model_lookup_error = {
+        code: error && error.code ? error.code : "MODEL_LOOKUP_FAILED",
+        message: error && error.message ? error.message : String(error)
+      }
+      result.warnings.push(`모델별 보조금 조회 실패: ${result.model_lookup_error.message}`)
+    }
+  }
+  return result
+}
+
+async function searchRegionsHttp(options = {}) {
+  const query = normalizeText(options.query)
+  if (!query) throw createError("REGION_REQUIRED", "검색할 지역명을 입력하세요.")
+  const { html } = await fetchDecodedStatusHtml({ ...options, vehicleType: "passenger" })
+  const rows = extractStatusRows(html)
+  const items = rows.filter((row) => localMatches(query, row.cells[1])).map((row) => ({
+    sido_name: row.cells[0],
+    sido_code: row.local_code ? `${row.local_code.slice(0, 2)}00` : null,
+    local_name: row.cells[1],
+    local_code: row.local_code
+  }))
+  return {
+    query,
+    items: Array.from(new Map(items.map((item) => [`${item.sido_name}:${item.local_name}`, item])).values()),
+    source_url: STATUS_URL,
+    transport: "direct-http"
+  }
+}
+
+module.exports = {
+  decodeHtmlEntities,
+  extractModelSubsidySnapshot,
+  extractStatusRows,
+  fetchDecodedModelHtml,
+  fetchDecodedStatusHtml,
+  getSubsidyStatusHttp,
+  htmlToText,
+  parseNoticeFiles,
+  resolveRegionFromRows,
+  searchRegionsHttp
+}

package/src/index.js

@@ -0,0 +1,61 @@
+"use strict"
+
+const { getSubsidyStatus: getSubsidyStatusBrowser, searchRegions: searchRegionsBrowser } = require("./browser")
+const { getSubsidyStatusHttp, searchRegionsHttp } = require("./http")
+const { STATUS_URL, VEHICLE_TYPES, resolveVehicleType } = require("./constants")
+const { EvSubsidyError } = require("./errors")
+const { classifyAvailability } = require("./availability")
+const { buildUnavailableBudget, estimateModelEquivalent } = require("./estimate")
+const {
+  attachModelEstimate,
+  buildStatusResult,
+  formatKst,
+  normalizeRegionKey,
+  normalizeText,
+  parseModelSubsidyRows,
+  parseMoneyKrw,
+  parseNumberCell,
+  parseStatusRows
+} = require("./parse")
+
+function browserRequested(options = {}) {
+  return options.transport === "browser" ||
+    Boolean(options.page || options.runtime || options.provider || options.cdpUrl)
+}
+
+async function getSubsidyStatus(options = {}) {
+  return browserRequested(options)
+    ? getSubsidyStatusBrowser(options)
+    : getSubsidyStatusHttp(options)
+}
+
+async function searchRegions(options = {}) {
+  return browserRequested(options)
+    ? searchRegionsBrowser(options)
+    : searchRegionsHttp(options)
+}
+
+module.exports = {
+  EvSubsidyError,
+  STATUS_URL,
+  VEHICLE_TYPES,
+  attachModelEstimate,
+  buildStatusResult,
+  buildUnavailableBudget,
+  classifyAvailability,
+  estimateModelEquivalent,
+  formatKst,
+  getSubsidyStatus,
+  getSubsidyStatusBrowser,
+  getSubsidyStatusHttp,
+  normalizeRegionKey,
+  normalizeText,
+  parseModelSubsidyRows,
+  parseMoneyKrw,
+  parseNumberCell,
+  parseStatusRows,
+  resolveVehicleType,
+  searchRegions,
+  searchRegionsBrowser,
+  searchRegionsHttp
+}