pal-crawl 2.0.5 → 2.2.1

package/dist/likms.js

@@ -0,0 +1,151 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LikmsCrawler = void 0;
+const url_1 = require("url");
+const cheerio = __importStar(require("cheerio"));
+const config_1 = require("./config");
+const http_client_1 = require("./http-client");
+/**
+ * 국회 의안정보시스템(likms.assembly.go.kr) 크롤러.
+ *
+ * 의안상세 페이지(billDetailPage.do)는 심사정보 탭 내용을 빈 div에 AJAX(POST)로
+ * 채우므로, 정적 HTML만으로는 제안이유를 읽을 수 없다.
+ *
+ * 실제 흐름 (billDetail.js 기준):
+ *   1. GET  /bill/bi/billDetailPage.do?billId=...&currMenuNo=2600044
+ *      → 숨김 폼(#form)에 billId, billNo, billKindCd 등 파라미터 포함
+ *   2. POST /bill/bi/bill/detail/billInfo.do (폼 파라미터 직렬화)
+ *      → 심사정보 탭 조각 HTML 반환
+ *   3. 조각의 <pre id="prntSummary"> 안에 제안이유 및 주요내용이 들어 있음
+ *
+ * PAL(입법예고) 상세 페이지에서 제안이유가 비어 있는 의안의 contentId(=PRC_...)
+ * 는 동일한 ID로 이 시스템에서 조회할 수 있다.
+ */
+class LikmsCrawler {
+    constructor(config) {
+        this.httpClient = new http_client_1.HttpClient({
+            userAgent: config?.userAgent ?? config_1.Config.UserAgent,
+            timeout: config?.timeout ?? 10000,
+            retryCount: config?.retryCount ?? 3,
+            customHeaders: config?.customHeaders ?? {},
+        });
+    }
+    buildDetailPageUrl(billId) {
+        const url = new url_1.URL(config_1.Config.LIKMS_DETAIL_PAGE_URL, config_1.Config.LIKMS_DOMAIN);
+        url.searchParams.set('billId', billId);
+        url.searchParams.set('currMenuNo', config_1.Config.LIKMS_CURR_MENU_NO);
+        return url;
+    }
+    /** 의안상세 페이지 HTML을 반환합니다. */
+    async getDetailPageHTML(billId) {
+        const normalized = billId.trim();
+        if (!normalized) {
+            throw new Error('billId is required');
+        }
+        return this.httpClient.get(this.buildDetailPageUrl(normalized));
+    }
+    /**
+     * 의안상세 페이지의 숨김 폼(#form input[type=hidden]) 파라미터를 추출합니다.
+     * billInfo.do AJAX 요청은 이 파라미터들에 심사정보 섹션의 렌더링 조건이 걸려
+     * 있어 원본 페이지에서 그대로 가져와야 한다.
+     */
+    parseDetailFormParams(html) {
+        const $ = cheerio.load(html);
+        const params = {};
+        $('#form input[type="hidden"]').each((_, el) => {
+            const name = $(el).attr('name');
+            if (!name) {
+                return;
+            }
+            params[name] = $(el).attr('value') ?? '';
+        });
+        return params;
+    }
+    /** 심사정보 탭 조각 HTML을 POST로 반환합니다. */
+    async getBillInfoHTML(params) {
+        const url = new url_1.URL(config_1.Config.LIKMS_BILL_INFO_URL, config_1.Config.LIKMS_DOMAIN);
+        const body = new URLSearchParams(params).toString();
+        return this.httpClient.post(url, body);
+    }
+    /** 심사정보 탭 조각 HTML에서 제안이유 및 주요내용을 파싱하여 반환합니다. */
+    parseProposalReason(fragmentHtml) {
+        const $ = cheerio.load(fragmentHtml);
+        const pre = $('#prntSummary').first();
+        if (!pre.length) {
+            return null;
+        }
+        const clone = pre.clone();
+        clone.find('br').replaceWith('\n');
+        const lines = clone
+            .text()
+            .replace(/\u00a0/g, ' ')
+            .replace(/\r/g, '')
+            .split('\n')
+            .map((line) => line.replace(/\s+/g, ' ').trim())
+            .filter(Boolean);
+        // 첫 줄이 섹션 제목("제안이유 및 주요내용")을 반복하는 경우 제거
+        if (lines[0]?.replace(/\s+/g, '') === '제안이유및주요내용') {
+            lines.shift();
+        }
+        const text = lines.join('\n');
+        return text || null;
+    }
+    /**
+     * billId(PAL contentId와 동일)로 제안이유 및 주요내용을 조회합니다.
+     * 네트워크·파싱 실패를 절대 던지지 않고 null을 반환해 호출부가 안전하게
+     * 동작하도록 한다.
+     */
+    async getProposalReason(billId) {
+        const normalized = billId.trim();
+        if (!normalized) {
+            return null;
+        }
+        try {
+            const detailHtml = await this.getDetailPageHTML(normalized);
+            const params = this.parseDetailFormParams(detailHtml);
+            if (!params.billId) {
+                params.billId = normalized;
+            }
+            const fragmentHtml = await this.getBillInfoHTML(params);
+            return this.parseProposalReason(fragmentHtml);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.LikmsCrawler = LikmsCrawler;
+//# sourceMappingURL=likms.js.map

package/dist/likms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"likms.js","sourceRoot":"","sources":["../src/likms.ts"],"names":[],"mappings":"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"}

package/dist/likms.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/likms.test.js

@@ -0,0 +1,313 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const pal_1 = require("./pal");
+const likms_1 = require("./likms");
+// ─── HTML Fixtures (실제 캡처 구조를 축약) ─────────────────────────────────────
+const LIKMS_DETAIL_PAGE_HTML = `
+<div class="content" id="content">
+  <div class="page_title">
+    <h3 class="detailh3">[2221798] 유아교육법 일부개정법률안(김문수의원 등 12인)</h3>
+  </div>
+  <div class="content">
+    <form id="form" name="form">
+      <input type="hidden" id="billId" name="billId" value="PRC_G2G6E0D9E2Z3A1Y7Z5X1Y0W4E9E6D5">
+      <input type="hidden" id="billNo" name="billNo" value="2221798">
+      <input type="hidden" id="billKindCd" name="billKindCd" value="BKC_0004">
+      <input type="hidden" id="currCmtName" name="currCmtName" value="위원회 심사">
+      <input type="hidden" id="reexamYn" name="reexamYn" value="N">
+      <input type="hidden" id="mainUpdateBillYn" name="mainUpdateBillYn" value="N">
+      <input type="hidden" id="billGbnCd" name="billGbnCd" value="">
+      <input type="hidden" id="tmprAnYn" name="tmprAnYn" value="N">
+      <input type="hidden" id="headMemo" name="headMemo" value="Y">
+      <input type="hidden" id="headMemoInfo" name="headMemoInfo" value="비용추계요구서 제출됨.">
+      <input type="hidden" id="withdrawCnt" name="withdrawCnt" value="0">
+      <input type="hidden" id="intrsBillCnt" name="intrsBillCnt" value="0">
+      <input type="hidden" id="stageMemo" name="stageMemo" value="N"/>
+    </form>
+  </div>
+</div>
+`;
+const LIKMS_BILL_INFO_FRAGMENT_HTML = `
+<div id="tab_billInfo_sect">
+    <div class="container bill_info" id="container" style="height: auto;">
+        <form id="billInfoForm">
+            <div class="bill_info_div div_on" id="stage_list">
+                <div class="theme_title_wrap"><h3>심사진행단계</h3></div>
+            </div>
+            <div id="rcp_list" class="theme_area bill_info_div">
+                <div class="theme_list">
+                    <h3>접수정보</h3>
+                    <div>
+                        <h4>의안접수정보</h4>
+                        <table class="align_center">
+                            <tbody id="insc-rcp-row">
+                            <tr>
+                                <td class="billNo"><i>의안번호</i><span>2221798</span></td>
+                                <td class="proposeDt"><i>제안일자</i><span>2026-10-06</span></td>
+                            </tr>
+                            </tbody>
+                        </table>
+                    </div>
+                </div>
+                <div class="theme_list" id="prntsummary-sect">
+                    <div>
+                        <h4>제안이유 및 주요내용</h4>
+                        <pre id="prntSummary" class="theme_list_summary" style="height: 130px;">
+제안이유 및 주요내용
+
+  현행 「유아교육법」은 원장 등 교원의 유아생활지도에 관한 근거를 두고 있으며, 정당한 유아생활지도에 대해서는 「아동복지법」상 신체적 학대행위로 보지 아니하도록 규정하고 있음.
+  그런데 정서적 학대 및 방임의 개념이 포괄적으로 규정되어 있어 유치원에서 이루어지는 정당한 교육활동이나 생활지도까지 아동학대로 신고ㆍ조사되는 등 교육활동이 위축되고 있다는 지적이 있음.
+  이에 「아동복지법」 제17조제2항에 따라 원장과 교원이 교육활동 과정에서 하여서는 아니 되는 행위를 구체적으로 규정하여 정당한 교육활동을 보장하고 유아를 보호하려는 것임(안 제21조의3제4항 신설).
+
+
+참고사항
+
+  이 법률안은 김문수의원이 대표발의한 「아동복지법 일부개정법률안」(의안번호 제21797호)의 의결을 전제로 하는 것이므로 같은 법률안이 의결되지 아니하거나 수정의결되는 경우에는 이에 맞추어 조정되어야 할 것임.</pre>
+                    </div>
+                    <div class="member_list_more">
+                        <a href="javascript:;" id="btnPrntSummaryMore" class="closed">+더보기</a>
+                    </div>
+                </div>
+            </div>
+        </form>
+    </div>
+</div>
+`;
+const LIKMS_BILL_INFO_FRAGMENT_NO_REASON_HTML = `
+<div id="tab_billInfo_sect">
+    <div id="rcp_list" class="theme_area bill_info_div">
+        <div class="theme_list">
+            <h3>접수정보</h3>
+        </div>
+    </div>
+</div>
+`;
+const PAL_CONTENT_HTML_EMPTY_REASON = `
+<div class="card-wrap">
+    <div class="item">
+        <h4>제안이유 및 주요내용</h4>
+        <div class="desc">
+
+        </div>
+    </div>
+    <div class="item">
+        <h4>의견제출 방법</h4>
+        <div class="desc">
+            서울시 영등포구 의사당대로 1(여의도동) 교육위원회
+        </div>
+    </div>
+</div>
+`;
+const PAL_CONTENT_HTML_WITH_REASON = `
+<div class="card-wrap">
+    <div class="item">
+        <h4>제안이유 및 주요내용</h4>
+        <div class="desc">
+            현행법은 과태료 처분 기준이 없어 문제라는 지적이 있음.
+            이에 과태료 부과 기준을 신설하려는 것임.
+        </div>
+    </div>
+</div>
+`;
+const EXPECTED_LIKMS_REASON = [
+    '현행 「유아교육법」은 원장 등 교원의 유아생활지도에 관한 근거를 두고 있으며, 정당한 유아생활지도에 대해서는 「아동복지법」상 신체적 학대행위로 보지 아니하도록 규정하고 있음.',
+    '그런데 정서적 학대 및 방임의 개념이 포괄적으로 규정되어 있어 유치원에서 이루어지는 정당한 교육활동이나 생활지도까지 아동학대로 신고ㆍ조사되는 등 교육활동이 위축되고 있다는 지적이 있음.',
+    '이에 「아동복지법」 제17조제2항에 따라 원장과 교원이 교육활동 과정에서 하여서는 아니 되는 행위를 구체적으로 규정하여 정당한 교육활동을 보장하고 유아를 보호하려는 것임(안 제21조의3제4항 신설).',
+    '참고사항',
+    '이 법률안은 김문수의원이 대표발의한 「아동복지법 일부개정법률안」(의안번호 제21797호)의 의결을 전제로 하는 것이므로 같은 법률안이 의결되지 아니하거나 수정의결되는 경우에는 이에 맞추어 조정되어야 할 것임.',
+].join('\n');
+const TEST_BILL_ID = 'PRC_G2G6E0D9E2Z3A1Y7Z5X1Y0W4E9E6D5';
+const getLikmsHttpClient = (crawler) => crawler.httpClient;
+// ─── LikmsCrawler ─────────────────────────────────────────────────────────────
+describe('LikmsCrawler', () => {
+    describe('parseDetailFormParams', () => {
+        const crawler = new likms_1.LikmsCrawler();
+        test('extracts hidden form params from detail page', () => {
+            const params = crawler.parseDetailFormParams(LIKMS_DETAIL_PAGE_HTML);
+            expect(params.billId).toBe(TEST_BILL_ID);
+            expect(params.billNo).toBe('2221798');
+            expect(params.billKindCd).toBe('BKC_0004');
+            expect(params.tmprAnYn).toBe('N');
+            expect(params.reexamYn).toBe('N');
+            expect(params.withdrawCnt).toBe('0');
+        });
+        test('keeps empty-valued params (rendering condition)', () => {
+            const params = crawler.parseDetailFormParams(LIKMS_DETAIL_PAGE_HTML);
+            expect(params.billGbnCd).toBe('');
+        });
+        test('returns empty object when form is absent', () => {
+            expect(crawler.parseDetailFormParams('<div>no form</div>')).toEqual({});
+        });
+    });
+    describe('parseProposalReason', () => {
+        const crawler = new likms_1.LikmsCrawler();
+        test('extracts reason from #prntSummary and strips repeated heading', () => {
+            const reason = crawler.parseProposalReason(LIKMS_BILL_INFO_FRAGMENT_HTML);
+            expect(reason).toBe(EXPECTED_LIKMS_REASON);
+        });
+        test('reason does not contain the repeated section heading', () => {
+            const reason = crawler.parseProposalReason(LIKMS_BILL_INFO_FRAGMENT_HTML);
+            expect(reason).not.toMatch(/^제안이유/);
+            expect(reason).not.toContain('의안접수정보');
+        });
+        test('returns null when fragment has no #prntSummary', () => {
+            expect(crawler.parseProposalReason(LIKMS_BILL_INFO_FRAGMENT_NO_REASON_HTML)).toBeNull();
+        });
+        test('returns null when #prntSummary is empty', () => {
+            expect(crawler.parseProposalReason('<pre id="prntSummary"></pre>')).toBe(null);
+        });
+        test('returns null when #prntSummary contains only the heading', () => {
+            expect(crawler.parseProposalReason('<pre id="prntSummary">제안이유 및 주요내용</pre>')).toBeNull();
+        });
+        test('converts <br> tags to newlines', () => {
+            const reason = crawler.parseProposalReason('<pre id="prntSummary">제안이유 및 주요내용\n첫 줄<br>두 줄</pre>');
+            expect(reason).toBe('첫 줄\n두 줄');
+        });
+    });
+    describe('getProposalReason', () => {
+        const crawler = new likms_1.LikmsCrawler();
+        test('fetches detail page then posts fragment endpoint', async () => {
+            const httpClient = getLikmsHttpClient(crawler);
+            const getSpy = jest
+                .spyOn(httpClient, 'get')
+                .mockResolvedValue(LIKMS_DETAIL_PAGE_HTML);
+            const postSpy = jest
+                .spyOn(httpClient, 'post')
+                .mockResolvedValue(LIKMS_BILL_INFO_FRAGMENT_HTML);
+            const reason = await crawler.getProposalReason(`  ${TEST_BILL_ID}  `);
+            expect(reason).toBe(EXPECTED_LIKMS_REASON);
+            const getUrl = getSpy.mock.calls[0][0];
+            expect(getUrl.toString()).toContain('https://likms.assembly.go.kr/bill/bi/billDetailPage.do');
+            expect(getUrl.searchParams.get('billId')).toBe(TEST_BILL_ID);
+            expect(getUrl.searchParams.get('currMenuNo')).toBe('2600044');
+            const [postUrl, postBody] = postSpy.mock.calls[0];
+            expect(postUrl.toString()).toContain('https://likms.assembly.go.kr/bill/bi/bill/detail/billInfo.do');
+            expect(postBody).toContain(`billId=${TEST_BILL_ID}`);
+            expect(postBody).toContain('billNo=2221798');
+            expect(postBody).toContain('billKindCd=BKC_0004');
+            getSpy.mockRestore();
+            postSpy.mockRestore();
+        });
+        test('returns null when fragment has no proposal reason', async () => {
+            const httpClient = getLikmsHttpClient(crawler);
+            const getSpy = jest
+                .spyOn(httpClient, 'get')
+                .mockResolvedValue(LIKMS_DETAIL_PAGE_HTML);
+            const postSpy = jest
+                .spyOn(httpClient, 'post')
+                .mockResolvedValue(LIKMS_BILL_INFO_FRAGMENT_NO_REASON_HTML);
+            await expect(crawler.getProposalReason(TEST_BILL_ID)).resolves.toBeNull();
+            getSpy.mockRestore();
+            postSpy.mockRestore();
+        });
+        test('never throws when detail page fetch fails', async () => {
+            const httpClient = getLikmsHttpClient(crawler);
+            const getSpy = jest
+                .spyOn(httpClient, 'get')
+                .mockRejectedValue(new Error('network down'));
+            await expect(crawler.getProposalReason(TEST_BILL_ID)).resolves.toBeNull();
+            getSpy.mockRestore();
+        });
+        test('never throws when fragment post fails', async () => {
+            const httpClient = getLikmsHttpClient(crawler);
+            const getSpy = jest
+                .spyOn(httpClient, 'get')
+                .mockResolvedValue(LIKMS_DETAIL_PAGE_HTML);
+            const postSpy = jest
+                .spyOn(httpClient, 'post')
+                .mockRejectedValue(new Error('Bad Request'));
+            await expect(crawler.getProposalReason(TEST_BILL_ID)).resolves.toBeNull();
+            getSpy.mockRestore();
+            postSpy.mockRestore();
+        });
+        test('returns null for empty billId without network calls', async () => {
+            const httpClient = getLikmsHttpClient(crawler);
+            const getSpy = jest.spyOn(httpClient, 'get');
+            const postSpy = jest.spyOn(httpClient, 'post');
+            await expect(crawler.getProposalReason('')).resolves.toBeNull();
+            await expect(crawler.getProposalReason('   ')).resolves.toBeNull();
+            expect(getSpy).not.toHaveBeenCalled();
+            expect(postSpy).not.toHaveBeenCalled();
+            getSpy.mockRestore();
+            postSpy.mockRestore();
+        });
+    });
+    describe('getDetailPageHTML', () => {
+        const crawler = new likms_1.LikmsCrawler();
+        test('throws when billId is empty', async () => {
+            await expect(crawler.getDetailPageHTML('')).rejects.toThrow('billId is required');
+        });
+    });
+});
+// ─── PalCrawl ↔ LikmsCrawler 연계 ─────────────────────────────────────────────
+describe('PalCrawl hydrateProposalReason', () => {
+    const setup = (config) => {
+        const pal = new pal_1.PalCrawl(config);
+        const palHttp = pal
+            .httpClient;
+        const likms = pal.likms;
+        return { pal, palHttp, likmsHttp: likms.httpClient };
+    };
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    test('fills empty proposalReason from likms (getContent)', async () => {
+        const { pal, palHttp, likmsHttp } = setup();
+        jest.spyOn(palHttp, 'get').mockResolvedValue(PAL_CONTENT_HTML_EMPTY_REASON);
+        jest.spyOn(likmsHttp, 'get').mockResolvedValue(LIKMS_DETAIL_PAGE_HTML);
+        jest
+            .spyOn(likmsHttp, 'post')
+            .mockResolvedValue(LIKMS_BILL_INFO_FRAGMENT_HTML);
+        const content = await pal.getContent(TEST_BILL_ID);
+        expect(content.proposalReason).toBe(EXPECTED_LIKMS_REASON);
+    });
+    test('fills empty proposalReason from likms (getDoneContent)', async () => {
+        const { pal, palHttp, likmsHttp } = setup();
+        jest.spyOn(palHttp, 'get').mockResolvedValue(PAL_CONTENT_HTML_EMPTY_REASON);
+        jest.spyOn(likmsHttp, 'get').mockResolvedValue(LIKMS_DETAIL_PAGE_HTML);
+        jest
+            .spyOn(likmsHttp, 'post')
+            .mockResolvedValue(LIKMS_BILL_INFO_FRAGMENT_HTML);
+        const content = await pal.getDoneContent(TEST_BILL_ID);
+        expect(content.proposalReason).toBe(EXPECTED_LIKMS_REASON);
+    });
+    test('skips likms when PAL proposalReason already exists', async () => {
+        const { pal, palHttp, likmsHttp } = setup();
+        jest.spyOn(palHttp, 'get').mockResolvedValue(PAL_CONTENT_HTML_WITH_REASON);
+        const getSpy = jest.spyOn(likmsHttp, 'get');
+        const postSpy = jest.spyOn(likmsHttp, 'post');
+        const content = await pal.getContent(TEST_BILL_ID);
+        expect(content.proposalReason).toContain('과태료 부과 기준');
+        expect(getSpy).not.toHaveBeenCalled();
+        expect(postSpy).not.toHaveBeenCalled();
+    });
+    test('skips likms when hydrateProposalReason is false', async () => {
+        const { pal, palHttp, likmsHttp } = setup({ hydrateProposalReason: false });
+        jest.spyOn(palHttp, 'get').mockResolvedValue(PAL_CONTENT_HTML_EMPTY_REASON);
+        const getSpy = jest.spyOn(likmsHttp, 'get');
+        const postSpy = jest.spyOn(likmsHttp, 'post');
+        const content = await pal.getContent(TEST_BILL_ID);
+        expect(content.proposalReason).toBeNull();
+        expect(getSpy).not.toHaveBeenCalled();
+        expect(postSpy).not.toHaveBeenCalled();
+    });
+    test('keeps null proposalReason when likms lookup fails', async () => {
+        const { pal, palHttp, likmsHttp } = setup();
+        jest.spyOn(palHttp, 'get').mockResolvedValue(PAL_CONTENT_HTML_EMPTY_REASON);
+        jest.spyOn(likmsHttp, 'get').mockRejectedValue(new Error('network down'));
+        const content = await pal.getContent(TEST_BILL_ID);
+        expect(content.proposalReason).toBeNull();
+        expect(content.title).toBe('');
+    });
+    test('keeps null proposalReason when likms has no reason either', async () => {
+        const { pal, palHttp, likmsHttp } = setup();
+        jest.spyOn(palHttp, 'get').mockResolvedValue(PAL_CONTENT_HTML_EMPTY_REASON);
+        jest.spyOn(likmsHttp, 'get').mockResolvedValue(LIKMS_DETAIL_PAGE_HTML);
+        jest
+            .spyOn(likmsHttp, 'post')
+            .mockResolvedValue(LIKMS_BILL_INFO_FRAGMENT_NO_REASON_HTML);
+        const content = await pal.getContent(TEST_BILL_ID);
+        expect(content.proposalReason).toBeNull();
+    });
+});
+//# sourceMappingURL=likms.test.js.map

package/dist/likms.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"likms.test.js","sourceRoot":"","sources":["../src/likms.test.ts"],"names":[],"mappings":"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"}

package/dist/pal.d.ts

@@ -1,4 +1,4 @@
-import { type Browser } from 'puppeteer';
+import type { Browser } from 'puppeteer';
 import { type ITableData, type IContentData, type ISearchResult, type INsmBillItem, type INsmBillDetail, type INsmSearchResult } from './parser';
 export type { IAttachment, ITableData, IContentData, ISearchResult, INsmAttachment, INsmBillItem, INsmBillDetail, INsmSearchResult, } from './parser';
 export interface ScreenshotOptions {
@@ -17,6 +17,12 @@ export interface PalCrawlConfig {
     screenshot?: ScreenshotOptions;
     /** 목록의 잘린 법안 제목을 상세 페이지에서 보정할지 여부 */
     hydrateTruncatedTitles?: boolean;
+    /**
+     * PAL 상세 페이지에서 제안이유가 비어 있을 때 국회 의안정보시스템
+     * (likms.assembly.go.kr)에서 제안이유를 보정할지 여부 (기본값: true).
+     * 보정 실패 시 기존 값(null)을 그대로 유지하며 오류를 던지지 않습니다.
+     */
+    hydrateProposalReason?: boolean;
 }
 export interface ISearchQuery {
     pageIndex?: number;
@@ -57,6 +63,8 @@ export declare abstract class ScreenshotBase {
 export declare class PalCrawl extends ScreenshotBase {
     private readonly httpClient;
     private readonly parser;
+    private readonly likms;
+    private readonly hydrateProposalReason;
     constructor(config?: PalCrawlConfig);
     /** 진행 중인 입법예고 목록 페이지 스크린샷을 반환합니다. */
     getPalScreenshot(): Promise<Buffer>;
@@ -77,6 +85,12 @@ export declare class PalCrawl extends ScreenshotBase {
     get(): Promise<ITableData[]>;
     /** ID로 진행 중인 입법예고의 법률안 상세 페이지 HTML을 반환합니다. */
     getContentHTML(id: string): Promise<string>;
+    /**
+     * PAL 상세 페이지에서 파싱한 제안이유가 비어 있으면 국회 의안정보시스템
+     * (likms)에서 같은 의안의 제안이유를 조회해 채웁니다.
+     * 보정 실패·의안 없음 등의 경우 기존 결과를 그대로 반환합니다.
+     */
+    private hydrateProposalReasonIfEmpty;
     /** ID로 진행 중인 입법예고의 법률안 상세 정보를 조회합니다. */
     getContent(id: string): Promise<IContentData>;
     /** 완료된 입법예고 목록 페이지의 HTML을 반환합니다. */