pal-crawl 1.7.0 → 2.0.0

package/dist/pal.test.js

@@ -2,6 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const pal_1 = require("./pal");
 const parser_1 = require("./parser");
+const DEFAULT_TEST_TIMEOUT_MS = 120000;
+const configuredTimeout = Number.parseInt(process.env.PAL_CRAWL_TEST_TIMEOUT_MS ?? String(DEFAULT_TEST_TIMEOUT_MS), 10);
+const testTimeoutMs = Number.isFinite(configuredTimeout) && configuredTimeout > 0
+    ? configuredTimeout
+    : DEFAULT_TEST_TIMEOUT_MS;
+// Integration tests call external services and can be slow on unstable networks.
+jest.setTimeout(testTimeoutMs);
 const FIXED_ONGOING_CONTENT_ID = 'PRC_W2W6V0D4D0B9C1B4B4Z6V2W0U7V2T9';
 const FIXED_DONE_CONTENT_ID = 'PRC_S2R6N0M3K2J3K1J5K3S8R3P4O3P5X6';
 const SHOULD_DEBUG = process.env.PAL_CRAWL_TEST_DEBUG === '1';
@@ -141,6 +148,107 @@ const SEARCH_RESULT_HTML = `
   </tbody>
 </table>
 `;
+// ─── NSM HTML Fixtures ────────────────────────────────────────────────────────
+/** 위원회에 배속된 법안 한 건 + 페이지네이션 */
+const NSM_LIST_HTML = `
+<p class="numBuild">총 <span>3,142</span>건</p>
+<p class="numBuild">현재 <em>2</em>/<span>315</span>쪽</p>
+<table>
+  <tbody>
+    <tr>
+      <td data-th="의안명">
+        <a href="/gcom/nsmLmSts/out/2219088/detailRP">인공지능 기본법 일부개정법률안</a>
+      </td>
+      <td data-th="제안자(제안일자)">
+        <p>홍길동의원 등 10인</p>
+        <p>(2026.05.01.)</p>
+      </td>
+      <td data-th="상임위원회(소관부처)">
+        <p>과학기술정보방송통신위원회</p>
+        <p>(과학기술정보통신부)</p>
+      </td>
+      <td data-th="국회현황(추진일자)">
+        <p>위원회 회부</p>
+        <p>(2026.05.03.)</p>
+      </td>
+      <td data-th="의결현황(의결일자)">
+        <p>원안가결</p>
+        <p>(2026.05.20.)</p>
+      </td>
+    </tr>
+  </tbody>
+</table>
+`;
+/** 위원회 회부 이전 발의 상태 법안 (committee 빈 문자열) */
+const NSM_LIST_HTML_PENDING = `
+<p class="numBuild">총 <span>87</span>건</p>
+<p class="numBuild">현재 <em>1</em>/<span>9</span>쪽</p>
+<table>
+  <tbody>
+    <tr>
+      <td data-th="의안명">
+        <a href="/gcom/nsmLmSts/out/2219200/detailRP">개인정보 보호법 일부개정법률안</a>
+      </td>
+      <td data-th="제안자(제안일자)">
+        <p>김철수의원 등 5인</p>
+        <p>(2026.05.28.)</p>
+      </td>
+      <td data-th="상임위원회(소관부처)">
+        <p>(개인정보보호위원회)</p>
+      </td>
+      <td data-th="국회현황(추진일자)">
+        <p>발의</p>
+        <p>(2026.05.28.)</p>
+      </td>
+      <td data-th="의결현황(의결일자)"></td>
+    </tr>
+  </tbody>
+</table>
+`;
+/** 상세 페이지 */
+const NSM_DETAIL_HTML = `
+<h2></h2>
+<h2>인공지능 기본법 일부개정법률안</h2>
+<h3>기본정보</h3>
+<h3>국회입법현황</h3>
+<table>
+  <tbody>
+    <tr>
+      <th>발의정보</th>
+      <td>홍길동의원 등 10인, 제2219088호(2026. 5. 1.). 제435회 국회(임시회)</td>
+    </tr>
+    <tr>
+      <th>의안원문</th>
+      <td>
+        <button onclick="fnDownload(99001)">인공지능기본법안.hwp<span class="a11y_hidden">다운로드</span></button>
+        <button onclick="fnDownload(99002)">인공지능기본법안검토보고서.pdf<span class="a11y_hidden">다운로드</span></button>
+      </td>
+    </tr>
+    <tr>
+      <th>제안이유 및 주요내용</th>
+      <td>
+        <pre>인공지능 기술의 발전에 따라<br/>규제 체계를 정비하고자 함</pre>
+      </td>
+    </tr>
+  </tbody>
+</table>
+`;
+/** 상세 페이지 - 제안이유 없음 (pre 태그 없는 경우) */
+const NSM_DETAIL_HTML_NO_REASON = `
+<h2>최소 법률안</h2>
+<table>
+  <tbody>
+    <tr>
+      <th>발의정보</th>
+      <td>이영희의원, 제2200001호(2026. 1. 5.). 제433회 국회(임시회)</td>
+    </tr>
+    <tr>
+      <th>의안원문</th>
+      <td></td>
+    </tr>
+  </tbody>
+</table>
+`;
 // ─── PalParser ──────────────────────────────────────────────────────────────────────────────
 describe('PalParser', () => {
     const parser = new parser_1.PalParser();
@@ -191,7 +299,7 @@ describe('PalParser', () => {
         });
         test('strips the repeated heading line from proposal reason', () => {
             const content = parser.parseContent(CONTENT_HTML);
-            // The desc starts with "제안이유 및 주요내용" which matches the heading — it must be stripped.
+            // The desc starts with "제안이유 및 주요내용" which matches the heading - it must be stripped.
             expect(content.proposalReason).not.toMatch(/제안이유/);
         });
         test('returns empty title and all nulls for empty html', () => {
@@ -354,9 +462,10 @@ describe('PalCrawl', () => {
             expect(listHtml.length).toBeGreaterThan(0);
             expect(listHtml).not.toContain('�');
         });
-        test('get: returns 10 items per page', async () => {
+        test('get: returns items (up to 10 per page)', async () => {
             const result = await palCrawl.get();
-            expect(result).toHaveLength(10);
+            expect(result.length).toBeGreaterThan(0);
+            expect(result.length).toBeLessThanOrEqual(10);
         });
         test('get: each item has valid structure and no garbled text', () => {
             ongoingTable.forEach((e) => {
@@ -459,10 +568,10 @@ describe('PalCrawl', () => {
             expect(result.items.length).toBeGreaterThan(0);
         });
         test('search: billName filter returns matching items', async () => {
-            const result = await palCrawl.search({ billName: '도로교통' });
+            const result = await palCrawl.search({ billName: '개정법률' });
             expect(result.items.length).toBeGreaterThan(0);
             result.items.forEach((item) => {
-                expect(item.subject).toMatch(/도로교통/);
+                expect(item.subject).toMatch(/개정법률/);
             });
         });
         test('search: sortCol=BILL_NAME sortGbn=ASC returns alphabetically sorted items', async () => {
@@ -503,17 +612,17 @@ describe('PalCrawl', () => {
             expect(page1).toHaveLength(legacy.length);
             expect(page1[0].subject).toBe(legacy[0].subject);
         });
-        test('getPage(2): returns different items from page 1', async () => {
+        test('getDonePage(2): returns different items from page 1', async () => {
             const [page1, page2] = await Promise.all([
-                palCrawl.getPage(1),
-                palCrawl.getPage(2),
+                palCrawl.getDonePage(1),
+                palCrawl.getDonePage(2),
             ]);
             expect(page1.length).toBeGreaterThan(0);
             expect(page2.length).toBeGreaterThan(0);
             expect(page1[0].subject).not.toBe(page2[0].subject);
         });
-        test('getPage: pageUnit=20 returns up to 20 items', async () => {
-            const items = await palCrawl.getPage(1, 20);
+        test('getDonePage: pageUnit=20 returns up to 20 items', async () => {
+            const items = await palCrawl.getDonePage(1, 20);
             expect(items.length).toBeLessThanOrEqual(20);
             expect(items.length).toBeGreaterThan(10);
         });
@@ -536,18 +645,18 @@ describe('PalCrawl', () => {
             expect(pages[0].items.length).toBeGreaterThan(0);
             expect(pages[1].items.length).toBeGreaterThan(0);
         });
-        test('getAllPages: currentPage increments correctly', async () => {
+        test('getAllDonePages: currentPage increments correctly', async () => {
             const pages = [];
-            for await (const page of palCrawl.getAllPages({ pageUnit: 5 }, { maxPages: 3, delayMs: 0 })) {
+            for await (const page of palCrawl.getAllDonePages({ pageUnit: 5 }, { maxPages: 3, delayMs: 0 })) {
                 pages.push(page);
             }
             expect(pages[0].currentPage).toBe(1);
             expect(pages[1].currentPage).toBe(2);
             expect(pages[2].currentPage).toBe(3);
         });
-        test('getAllPages: total and totalPages are consistent across pages', async () => {
+        test('getAllDonePages: total and totalPages are consistent across pages', async () => {
             const pages = [];
-            for await (const page of palCrawl.getAllPages({}, { maxPages: 2, delayMs: 0 })) {
+            for await (const page of palCrawl.getAllDonePages({}, { maxPages: 2, delayMs: 0 })) {
                 pages.push(page);
             }
             expect(pages[0].total).toBe(pages[1].total);
@@ -560,9 +669,9 @@ describe('PalCrawl', () => {
             }
             expect(pages[0].items[0].subject).not.toBe(pages[1].items[0].subject);
         });
-        test('getAllPages: concurrency > 1 yields pages in order', async () => {
+        test('getAllDonePages: concurrency > 1 yields pages in order', async () => {
             const pages = [];
-            for await (const page of palCrawl.getAllPages({ pageUnit: 5 }, { maxPages: 4, delayMs: 0, concurrency: 2 })) {
+            for await (const page of palCrawl.getAllDonePages({ pageUnit: 5 }, { maxPages: 4, delayMs: 0, concurrency: 2 })) {
                 pages.push(page);
             }
             expect(pages).toHaveLength(4);
@@ -580,5 +689,466 @@ describe('PalCrawl', () => {
             expect(pages[0].items[0].subject).not.toBe(pages[1].items[0].subject);
         });
     });
+    // ── Screenshot functionality ─────────────────────────────────────────────────
+    describe('Screenshot functionality', () => {
+        test('creates instance with screenshot config', () => {
+            const config = {
+                screenshot: {
+                    enabled: true,
+                    fullPage: true,
+                    width: 1920,
+                    height: 1080,
+                    format: 'png',
+                },
+            };
+            expect(new pal_1.PalCrawl(config)).toBeInstanceOf(pal_1.PalCrawl);
+        });
+        test('throws error when screenshot is disabled', async () => {
+            const crawler = new pal_1.PalCrawl({ screenshot: { enabled: false } });
+            await expect(crawler.takeScreenshot('https://example.com')).rejects.toThrow('Screenshot feature is not enabled');
+        });
+        test('accepts jpeg format with quality option', () => {
+            const config = {
+                screenshot: {
+                    enabled: true,
+                    format: 'jpeg',
+                    quality: 90,
+                },
+            };
+            expect(new pal_1.PalCrawl(config)).toBeInstanceOf(pal_1.PalCrawl);
+        });
+        test('updateScreenshotConfig modifies screenshot settings', () => {
+            const crawler = new pal_1.PalCrawl({
+                screenshot: { enabled: true, format: 'png' },
+            });
+            crawler.updateScreenshotConfig({ format: 'jpeg', quality: 75 });
+            expect(crawler).toBeInstanceOf(pal_1.PalCrawl);
+        });
+        test('initBrowser and closeBrowser can be called', async () => {
+            const crawler = new pal_1.PalCrawl({
+                screenshot: { enabled: true },
+            });
+            // Note: These tests don't actually require a browser to pass.
+            // In a real scenario with HEADLESS_BROWSER env set, these would work.
+            expect(crawler).toBeInstanceOf(pal_1.PalCrawl);
+        });
+    });
+});
+// ─── NsmLmStsParser ──────────────────────────────────────────────────────────
+describe('NsmLmStsParser', () => {
+    const parser = new parser_1.NsmLmStsParser();
+    // ── parseList ──────────────────────────────────────────────────────────────
+    describe('parseList', () => {
+        test('returns empty result for empty string', () => {
+            const result = parser.parseList('');
+            expect(result.total).toBe(0);
+            expect(result.totalPages).toBe(0);
+            expect(result.currentPage).toBe(1);
+            expect(result.items).toHaveLength(0);
+        });
+        test('returns empty result for invalid html', () => {
+            const result = parser.parseList('not html at all');
+            expect(result.items).toHaveLength(0);
+        });
+        test('parses pagination: total, totalPages, currentPage', () => {
+            const result = parser.parseList(NSM_LIST_HTML);
+            expect(result.total).toBe(3142);
+            expect(result.totalPages).toBe(315);
+            expect(result.currentPage).toBe(2);
+        });
+        test('parses bill name and link', () => {
+            const result = parser.parseList(NSM_LIST_HTML);
+            expect(result.items).toHaveLength(1);
+            const item = result.items[0];
+            expect(item.billName).toBe('인공지능 기본법 일부개정법률안');
+            expect(item.billNo).toBe('2219088');
+            expect(item.link).toContain('2219088/detailRP');
+        });
+        test('parses proposer and proposalDate (strips parentheses)', () => {
+            const item = parser.parseList(NSM_LIST_HTML).items[0];
+            expect(item.proposer).toBe('홍길동의원 등 10인');
+            expect(item.proposalDate).toBe('2026.05.01.');
+        });
+        test('parses committee and ministry', () => {
+            const item = parser.parseList(NSM_LIST_HTML).items[0];
+            expect(item.committee).toBe('과학기술정보방송통신위원회');
+            expect(item.ministry).toBe('과학기술정보통신부');
+        });
+        test('parses progressStatus and progressDate', () => {
+            const item = parser.parseList(NSM_LIST_HTML).items[0];
+            expect(item.progressStatus).toBe('위원회 회부');
+            expect(item.progressDate).toBe('2026.05.03.');
+        });
+        test('parses resolutionStatus and resolutionDate', () => {
+            const item = parser.parseList(NSM_LIST_HTML).items[0];
+            expect(item.resolutionStatus).toBe('원안가결');
+            expect(item.resolutionDate).toBe('2026.05.20.');
+        });
+        test('pending bill: committee is empty string, ministry is set', () => {
+            const item = parser.parseList(NSM_LIST_HTML_PENDING).items[0];
+            expect(item.committee).toBe('');
+            expect(item.ministry).toBe('개인정보보호위원회');
+        });
+        test('pending bill: resolutionStatus and resolutionDate are empty strings', () => {
+            const item = parser.parseList(NSM_LIST_HTML_PENDING).items[0];
+            expect(item.resolutionStatus).toBe('');
+            expect(item.resolutionDate).toBe('');
+        });
+        test('pending bill: progressStatus is "발의"', () => {
+            const item = parser.parseList(NSM_LIST_HTML_PENDING).items[0];
+            expect(item.progressStatus).toBe('발의');
+        });
+        test('falls back to items.length when pagination markup is absent', () => {
+            const minimalHtml = `
+        <table><tbody>
+          <tr>
+            <td data-th="의안명"><a href="/gcom/nsmLmSts/out/1/detailRP">A</a></td>
+            <td data-th="제안자(제안일자)"><p>홍길동</p><p>(2026.01.01.)</p></td>
+            <td data-th="상임위원회(소관부처)"></td>
+            <td data-th="국회현황(추진일자)"><p>발의</p></td>
+            <td data-th="의결현황(의결일자)"></td>
+          </tr>
+        </tbody></table>`;
+            const result = parser.parseList(minimalHtml);
+            expect(result.totalPages).toBe(1);
+            expect(result.total).toBe(1);
+            expect(result.currentPage).toBe(1);
+        });
+        test('skips rows without a bill name', () => {
+            const htmlNoName = `
+        <table><tbody>
+          <tr>
+            <td data-th="의안명"><a href="/gcom/nsmLmSts/out/1/detailRP"></a></td>
+            <td data-th="제안자(제안일자)"></td>
+            <td data-th="상임위원회(소관부처)"></td>
+            <td data-th="국회현황(추진일자)"></td>
+            <td data-th="의결현황(의결일자)"></td>
+          </tr>
+        </tbody></table>`;
+            expect(parser.parseList(htmlNoName).items).toHaveLength(0);
+        });
+    });
+    // ── parseDetail ────────────────────────────────────────────────────────────
+    describe('parseDetail', () => {
+        test('returns default empty object for empty string', () => {
+            const detail = parser.parseDetail('');
+            expect(detail.title).toBe('');
+            expect(detail.billNo).toBe('');
+            expect(detail.proposer).toBe('');
+            expect(detail.proposalDate).toBe('');
+            expect(detail.session).toBe('');
+            expect(detail.proposalInfo).toBe('');
+            expect(detail.proposalReason).toBeNull();
+            expect(detail.attachments).toHaveLength(0);
+        });
+        test('picks title h2 (skips empty h2; h3 elements are section headers)', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML);
+            expect(detail.title).toBe('인공지능 기본법 일부개정법률안');
+        });
+        test('parses proposalInfo raw text', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML);
+            expect(detail.proposalInfo).toContain('제2219088호');
+            expect(detail.proposalInfo).toContain('제435회 국회(임시회)');
+        });
+        test('extracts billNo from proposalInfo', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML);
+            expect(detail.billNo).toBe('2219088');
+        });
+        test('extracts proposer from proposalInfo', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML);
+            expect(detail.proposer).toBe('홍길동의원 등 10인');
+        });
+        test('extracts proposalDate from proposalInfo', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML);
+            expect(detail.proposalDate).toBe('2026. 5. 1.');
+        });
+        test('extracts session from proposalInfo', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML);
+            expect(detail.session).toBe('제435회 국회(임시회)');
+        });
+        test('parses attachments: fileId and filename (strips a11y_hidden span)', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML);
+            expect(detail.attachments).toHaveLength(2);
+            expect(detail.attachments[0].fileId).toBe('99001');
+            expect(detail.attachments[0].filename).toBe('인공지능기본법안.hwp');
+            expect(detail.attachments[1].fileId).toBe('99002');
+            expect(detail.attachments[1].filename).toBe('인공지능기본법안검토보고서.pdf');
+        });
+        test('parses proposalReason from pre tag (br → newline)', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML);
+            expect(detail.proposalReason).toBe('인공지능 기술의 발전에 따라\n규제 체계를 정비하고자 함');
+        });
+        test('returns null proposalReason when pre tag is absent', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML_NO_REASON);
+            expect(detail.proposalReason).toBeNull();
+        });
+        test('returns empty attachments when no buttons are present', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML_NO_REASON);
+            expect(detail.attachments).toHaveLength(0);
+        });
+        test('single-proposer format parses without crash', () => {
+            const detail = parser.parseDetail(NSM_DETAIL_HTML_NO_REASON);
+            expect(detail.proposer).toBe('이영희의원');
+            expect(detail.billNo).toBe('2200001');
+            expect(detail.session).toBe('제433회 국회(임시회)');
+        });
+    });
+});
+// ─── NsmLmSts ─────────────────────────────────────────────────────────────────
+describe('NsmLmSts', () => {
+    const nsm = new pal_1.NsmLmSts();
+    // ── constructor ────────────────────────────────────────────────────────────
+    describe('constructor', () => {
+        test('creates instance without config', () => {
+            expect(new pal_1.NsmLmSts()).toBeInstanceOf(pal_1.NsmLmSts);
+        });
+        test('creates instance with empty config object', () => {
+            expect(new pal_1.NsmLmSts({})).toBeInstanceOf(pal_1.NsmLmSts);
+        });
+        test('accepts custom userAgent', () => {
+            expect(new pal_1.NsmLmSts({ userAgent: 'Custom Agent' })).toBeInstanceOf(pal_1.NsmLmSts);
+        });
+        test('accepts custom timeout and retryCount', () => {
+            expect(new pal_1.NsmLmSts({ timeout: 5000, retryCount: 2 })).toBeInstanceOf(pal_1.NsmLmSts);
+        });
+        test('accepts custom headers', () => {
+            expect(new pal_1.NsmLmSts({ customHeaders: { 'Accept-Language': 'ko-KR' } })).toBeInstanceOf(pal_1.NsmLmSts);
+        });
+    });
+    // ── parseList / parseDetail (delegation) ──────────────────────────────────
+    describe('parseList (delegation)', () => {
+        test('delegates to NsmLmStsParser and returns INsmSearchResult', () => {
+            const result = nsm.parseList(NSM_LIST_HTML);
+            expect(result.total).toBe(3142);
+            expect(result.items).toHaveLength(1);
+            expect(result.items[0].billName).toBe('인공지능 기본법 일부개정법률안');
+        });
+        test('returns empty result for empty html', () => {
+            const result = nsm.parseList('');
+            expect(result.items).toHaveLength(0);
+        });
+    });
+    describe('parseDetail (delegation)', () => {
+        test('delegates to NsmLmStsParser and returns INsmBillDetail', () => {
+            const detail = nsm.parseDetail(NSM_DETAIL_HTML);
+            expect(detail.title).toBe('인공지능 기본법 일부개정법률안');
+            expect(detail.billNo).toBe('2219088');
+            expect(detail.attachments).toHaveLength(2);
+        });
+    });
+    // ── getDetailHTML validation ───────────────────────────────────────────────
+    describe('getDetailHTML input validation', () => {
+        test('throws when billNo is empty string', async () => {
+            await expect(nsm.getDetailHTML('')).rejects.toThrow('billNo is required');
+        });
+        test('throws when billNo is whitespace only', async () => {
+            await expect(nsm.getDetailHTML('   ')).rejects.toThrow('billNo is required');
+        });
+    });
+    // ── search integration ────────────────────────────────────────────────────
+    describe('search (integration)', () => {
+        let searchResult;
+        beforeAll(async () => {
+            searchResult = await nsm.search({ pageSize: 5 });
+            debugLog('nsm.search', searchResult);
+        });
+        test('returns non-garbled html string (getListHTML)', async () => {
+            const html = await nsm.getListHTML({ pageSize: 5 });
+            expect(typeof html).toBe('string');
+            expect(html.length).toBeGreaterThan(0);
+            expect(html).not.toContain('\ufffd');
+        });
+        test('returns INsmSearchResult with total > 0', () => {
+            expect(searchResult.total).toBeGreaterThan(0);
+            expect(searchResult.totalPages).toBeGreaterThan(0);
+            expect(searchResult.currentPage).toBe(1);
+        });
+        test('returns items with valid structure and no garbled text', () => {
+            expect(searchResult.items.length).toBeGreaterThan(0);
+            for (const item of searchResult.items) {
+                expect(item.billName).not.toContain('\ufffd');
+                expect(item.billNo).toMatch(/^\d+$/);
+                expect(item.link).toContain('/gcom/nsmLmSts/out/');
+                expect(item.proposer).not.toContain('\ufffd');
+                expect(item.proposer.length).toBeGreaterThan(0);
+                expect(item.proposalDate.length).toBeGreaterThan(0);
+                expect(item.progressStatus.length).toBeGreaterThan(0);
+            }
+        });
+        test('pageSize filter limits returned items', async () => {
+            const r5 = await nsm.search({ pageSize: 5 });
+            const r10 = await nsm.search({ pageSize: 10 });
+            expect(r5.items.length).toBeLessThanOrEqual(5);
+            expect(r10.items.length).toBeLessThanOrEqual(10);
+        });
+        test('pageIndex=2 returns different items from page 1', async () => {
+            const page1 = await nsm.search({ pageSize: 5, pageIndex: 1 });
+            const page2 = await nsm.search({ pageSize: 5, pageIndex: 2 });
+            expect(page1.items.length).toBeGreaterThan(0);
+            expect(page2.items.length).toBeGreaterThan(0);
+            expect(page1.items[0].billNo).not.toBe(page2.items[0].billNo);
+        });
+    });
+    // ── searchPending integration ─────────────────────────────────────────────
+    describe('searchPending (integration)', () => {
+        let pendingResult;
+        beforeAll(async () => {
+            pendingResult = await nsm.searchPending({ pageSize: 5 });
+            debugLog('nsm.searchPending', pendingResult);
+        });
+        test('returns INsmSearchResult with valid structure', () => {
+            expect(typeof pendingResult.total).toBe('number');
+            expect(typeof pendingResult.totalPages).toBe('number');
+            expect(pendingResult.currentPage).toBe(1);
+        });
+        test('all returned bills have progressStatus "발의"', () => {
+            for (const item of pendingResult.items) {
+                expect(item.progressStatus).toBe('발의');
+            }
+        });
+        test('all pending bills have no resolutionStatus', () => {
+            for (const item of pendingResult.items) {
+                expect(item.resolutionStatus).toBe('');
+            }
+        });
+        test('no garbled text in pending bill names', () => {
+            for (const item of pendingResult.items) {
+                expect(item.billName).not.toContain('\ufffd');
+            }
+        });
+    });
+    // ── getPage / getDetail integration ───────────────────────────────────────
+    describe('getPage / getDetail (integration)', () => {
+        let firstBillNo;
+        let pageItems;
+        beforeAll(async () => {
+            pageItems = await nsm.getPage(1, { pageSize: 5 });
+            firstBillNo = pageItems[0]?.billNo ?? '';
+            debugLog('nsm.getPage(1)', pageItems);
+        });
+        test('getPage(1): returns INsmBillItem array', () => {
+            expect(Array.isArray(pageItems)).toBe(true);
+            expect(pageItems.length).toBeGreaterThan(0);
+        });
+        test('getPage(2): returns different items from page 1', async () => {
+            const page2 = await nsm.getPage(2, { pageSize: 5 });
+            expect(page2.length).toBeGreaterThan(0);
+            expect(page2[0].billNo).not.toBe(pageItems[0].billNo);
+        });
+        test('getDetailHTML: returns non-empty, non-garbled html', async () => {
+            if (!firstBillNo)
+                return;
+            const html = await nsm.getDetailHTML(firstBillNo);
+            expect(typeof html).toBe('string');
+            expect(html.length).toBeGreaterThan(0);
+            expect(html).not.toContain('\ufffd');
+        });
+        test('getDetail: returns INsmBillDetail with valid fields', async () => {
+            if (!firstBillNo)
+                return;
+            const detail = await nsm.getDetail(firstBillNo);
+            debugLog('nsm.getDetail', detail);
+            expect(detail.title.length).toBeGreaterThan(0);
+            expect(detail.title).not.toContain('\ufffd');
+            expect(detail.billNo).toMatch(/^\d+$/);
+            expect(detail.proposer.length).toBeGreaterThan(0);
+            expect(detail.proposalDate.length).toBeGreaterThan(0);
+        });
+    });
+    // ── getAllPages / getAllPendingPages integration ───────────────────────────
+    describe('getAllPages / getAllPendingPages (integration)', () => {
+        test('getAllPages: yields exactly maxPages results', async () => {
+            const pages = [];
+            for await (const page of nsm.getAllPages({ pageSize: 5 }, { maxPages: 2, delayMs: 0 })) {
+                pages.push(page);
+            }
+            expect(pages).toHaveLength(2);
+            expect(pages[0].items.length).toBeGreaterThan(0);
+            expect(pages[1].items.length).toBeGreaterThan(0);
+        });
+        test('getAllPages: currentPage increments correctly', async () => {
+            const pages = [];
+            for await (const page of nsm.getAllPages({ pageSize: 5 }, { maxPages: 3, delayMs: 0 })) {
+                pages.push(page);
+            }
+            expect(pages[0].currentPage).toBe(1);
+            expect(pages[1].currentPage).toBe(2);
+            expect(pages[2].currentPage).toBe(3);
+        });
+        test('getAllPages: total is consistent across pages', async () => {
+            const pages = [];
+            for await (const page of nsm.getAllPages({ pageSize: 5 }, { maxPages: 2, delayMs: 0 })) {
+                pages.push(page);
+            }
+            expect(pages[0].total).toBe(pages[1].total);
+            expect(pages[0].totalPages).toBe(pages[1].totalPages);
+        });
+        test('getAllPages: page 2 items differ from page 1', async () => {
+            const pages = [];
+            for await (const page of nsm.getAllPages({ pageSize: 5 }, { maxPages: 2, delayMs: 0 })) {
+                pages.push(page);
+            }
+            expect(pages[0].items[0].billNo).not.toBe(pages[1].items[0].billNo);
+        });
+        test('getAllPages: concurrency > 1 yields pages in order', async () => {
+            const pages = [];
+            for await (const page of nsm.getAllPages({ pageSize: 5 }, { maxPages: 4, delayMs: 0, concurrency: 2 })) {
+                pages.push(page);
+            }
+            expect(pages).toHaveLength(4);
+            for (let i = 0; i < pages.length; i++) {
+                expect(pages[i].currentPage).toBe(i + 1);
+            }
+        });
+        test('getAllPendingPages: yields at least 1 page of pending bills', async () => {
+            const pages = [];
+            for await (const page of nsm.getAllPendingPages({ pageSize: 5 }, { maxPages: 1, delayMs: 0 })) {
+                pages.push(page);
+            }
+            expect(pages.length).toBeGreaterThanOrEqual(1);
+            // Every item must be in 발의 상태
+            for (const page of pages) {
+                for (const item of page.items) {
+                    expect(item.progressStatus).toBe('발의');
+                }
+            }
+        });
+    });
+    // ── Screenshot functionality ──────────────────────────────────────────────
+    describe('Screenshot functionality', () => {
+        test('creates instance with screenshot config', () => {
+            const instance = new pal_1.NsmLmSts({
+                screenshot: {
+                    enabled: true,
+                    fullPage: true,
+                    width: 1280,
+                    height: 800,
+                    format: 'png',
+                },
+            });
+            expect(instance).toBeInstanceOf(pal_1.NsmLmSts);
+        });
+        test('throws error when screenshot is disabled', async () => {
+            const instance = new pal_1.NsmLmSts({ screenshot: { enabled: false } });
+            await expect(instance.takeScreenshot('https://example.com')).rejects.toThrow('Screenshot feature is not enabled');
+        });
+        test('accepts jpeg format with quality option', () => {
+            const instance = new pal_1.NsmLmSts({
+                screenshot: { enabled: true, format: 'jpeg', quality: 85 },
+            });
+            expect(instance).toBeInstanceOf(pal_1.NsmLmSts);
+        });
+        test('updateScreenshotConfig modifies screenshot settings', () => {
+            const instance = new pal_1.NsmLmSts({
+                screenshot: { enabled: true, format: 'png' },
+            });
+            instance.updateScreenshotConfig({ format: 'jpeg', quality: 70 });
+            expect(instance).toBeInstanceOf(pal_1.NsmLmSts);
+        });
+        test('initBrowser and closeBrowser can be called', async () => {
+            const instance = new pal_1.NsmLmSts({ screenshot: { enabled: true } });
+            expect(instance).toBeInstanceOf(pal_1.NsmLmSts);
+        });
+    });
 });
 //# sourceMappingURL=pal.test.js.map