bjd-code 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 song
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,119 @@
 # bjd-code (법정동 코드)
 
-[국토교통부_전국 법정동_20201119 API](https://www.data.go.kr/tcs/dss/selectFileDataDetailView.do?publicDataPk=15063424) 를 이용합니다.
+[국토교통부_전국 법정동 CSV](https://www.data.go.kr/tcs/dss/selectFileDataDetailView.do?publicDataPk=15063424) 데이터를 파싱, 필터링, 트리 구조화하는 Node.js/TypeScript 라이브러리.
 
-1. worker threads를 이용하여 
+## 기능
+
+- CSV 파싱 (EUC-KR/UTF-8 자동 처리, worker_threads 지원)
+- 시도/시군구/읍면동/리 레벨별 필터링
+- 이름 검색
+- 트리 구조 변환 (시도 → 시군구 → 읍면동 → 리)
+- CLI 도구 (다운로드, 파싱, 필터링, 트리, 검색)
+
+## 설치
+
+```bash
+npm install bjd-code
+```
+
+## 빠른 시작
+
+```bash
+# 1. 데이터 다운로드 (~/.bjd-code/data.csv에 저장)
+bjd download
+
+# 2. 바로 사용 (파일 경로 생략 가능)
+bjd parse --pretty
+bjd filter --level sido --pretty
+bjd tree --pretty
+bjd search 강남구
+```
+
+## 사용법
+
+### 라이브러리
+
+```typescript
+import { parseCSV, filterSido, buildTree, loadTree, searchByName, downloadCSV } from 'bjd-code';
+
+// 데이터 다운로드 (최초 1회)
+await downloadCSV();
+
+// CSV 파싱 (경로 생략 시 ~/.bjd-code/data.csv 사용)
+const records = await parseCSV();
+
+// 직접 파일 경로 지정도 가능
+const records2 = await parseCSV({ filePath: './my-data.csv' });
+
+// 시도만 추출
+const sidos = filterSido(records);
+
+// 트리 구조 빌드
+const tree = buildTree(records.filter(r => r.isActive));
+
+// 편의 함수 (파싱 + 트리 한번에)
+const tree2 = await loadTree();
+
+// 이름 검색
+const results = searchByName(records, '종로구');
+```
+
+### CLI
+
+```bash
+# 데이터 다운로드
+bjd download                       # ~/.bjd-code/data.csv에 저장
+bjd download -o ./data/bjd.csv     # 경로 지정
+bjd download --url <url>           # URL 직접 지정
+
+# 전체 데이터 파싱
+bjd parse                          # 다운로드된 데이터 사용
+bjd parse ./my-data.csv            # 파일 경로 직접 지정
+
+# 레벨별 필터링
+bjd filter --level sido --pretty
+bjd filter ./data.csv --level sigungu
+
+# 트리 구조
+bjd tree --pretty -o tree.json
+
+# 이름 검색
+bjd search 강남구
+
+# 공통 옵션
+#   --include-inactive   폐지된 코드 포함
+#   --pretty             JSON 포맷팅
+#   -o, --output <file>  파일로 저장
+#   --encoding <enc>     CSV 인코딩 (기본: euc-kr)
+```
+
+## 코드 구조
+
+법정동 코드는 10자리 숫자로 구성:
+
+| 위치 | 자릿수 | 레벨 | 예시 |
+|------|--------|------|------|
+| 1-2 | 시도 | `sido` | 11 (서울) |
+| 3-5 | 시군구 | `sigungu` | 110 (종로구) |
+| 6-8 | 읍면동 | `eupmyeondong` | 101 (청운동) |
+| 9-10 | 리 | `ri` | 21 (송산리) |
+
+뒷자리가 0으로 채워진 패턴으로 레벨을 판단합니다:
+- `1100000000` → 시도 (서울특별시)
+- `1111000000` → 시군구 (종로구)
+- `1111010100` → 읍면동 (청운동)
+- `4372025021` → 리 (송산리)
+
+## 개발
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## 기술 스택
+
+- Node.js 24+, ESM
+- TypeScript, Vitest
+- csv-parse, iconv-lite, commander

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+import { writeFileSync } from 'node:fs';
+import { Command, InvalidArgumentError } from 'commander';
+import { parseCSV } from '../core/parser.js';
+import { filterByLevel, searchByName } from '../core/filter.js';
+import { buildTree } from '../core/tree.js';
+import { downloadCSV, MANUAL_INSTRUCTIONS } from '../core/download.js';
+const VALID_LEVELS = ['sido', 'sigungu', 'eupmyeondong', 'ri'];
+function parseLevel(value) {
+    if (!VALID_LEVELS.includes(value)) {
+        throw new InvalidArgumentError(`유효하지 않은 레벨: "${value}" (가능한 값: ${VALID_LEVELS.join(', ')})`);
+    }
+    return value;
+}
+const program = new Command();
+program
+    .name('bjd')
+    .description('법정동 코드 파싱/필터링/트리 구조화 CLI')
+    .version('0.1.0');
+function output(data, opts) {
+    const json = opts.pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+    if (opts.output) {
+        writeFileSync(opts.output, json, 'utf-8');
+        console.log(`결과가 ${opts.output}에 저장되었습니다.`);
+    }
+    else {
+        console.log(json);
+    }
+}
+function addCommonOptions(cmd) {
+    return cmd
+        .option('-f, --file <path>', 'CSV 파일 경로 (기본: ~/.bjd-code/data.csv)')
+        .option('--include-inactive', '폐지된 코드 포함', false)
+        .option('--pretty', 'JSON 예쁘게 출력', false)
+        .option('-o, --output <file>', '결과를 파일로 저장')
+        .option('--encoding <encoding>', 'CSV 인코딩', 'euc-kr');
+}
+function handleError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`오류: ${message}`);
+    process.exit(1);
+}
+program
+    .command('download')
+    .description('법정동 코드 CSV 다운로드')
+    .option('--url <url>', '다운로드 URL 직접 지정')
+    .option('-o, --output <path>', '저장 경로 (기본: ~/.bjd-code/data.csv)')
+    .action(async (opts) => {
+    try {
+        console.log('다운로드 중...');
+        const savedPath = await downloadCSV({ url: opts.url, outputPath: opts.output });
+        console.log(`저장 완료: ${savedPath}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`다운로드 실패: ${message}`);
+        console.error(`\n수동 다운로드 방법:\n${MANUAL_INSTRUCTIONS}`);
+        process.exit(1);
+    }
+});
+addCommonOptions(program
+    .command('parse')
+    .description('CSV 파일을 파싱하여 전체 데이터 JSON 출력')).action(async (opts) => {
+    try {
+        const records = await parseCSV({ filePath: opts.file, encoding: opts.encoding, useWorker: false });
+        const result = opts.includeInactive ? records : records.filter((r) => r.isActive);
+        output(result, opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+addCommonOptions(program
+    .command('filter')
+    .description('레벨별 필터링')
+    .requiredOption('--level <level>', '필터 레벨 (sido, sigungu, eupmyeondong, ri)', parseLevel)).action(async (opts) => {
+    try {
+        const records = await parseCSV({ filePath: opts.file, encoding: opts.encoding, useWorker: false });
+        const filterOpts = { includeInactive: opts.includeInactive };
+        const result = filterByLevel(records, opts.level, filterOpts);
+        output(result, opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+addCommonOptions(program
+    .command('tree')
+    .description('트리 구조 JSON 출력')).action(async (opts) => {
+    try {
+        const records = await parseCSV({ filePath: opts.file, encoding: opts.encoding, useWorker: false });
+        const active = opts.includeInactive ? records : records.filter((r) => r.isActive);
+        const tree = buildTree(active);
+        output(tree, opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+addCommonOptions(program
+    .command('search <query>')
+    .description('이름으로 검색')).action(async (query, opts) => {
+    try {
+        const records = await parseCSV({ filePath: opts.file, encoding: opts.encoding, useWorker: false });
+        const filterOpts = { includeInactive: opts.includeInactive };
+        const result = searchByName(records, query, filterOpts);
+        output(result, opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core/download.d.ts

@@ -0,0 +1,12 @@
+import { DATA_DIR } from '../utils/paths.js';
+export interface DownloadOptions {
+    /** 다운로드 URL (기본: data.go.kr) */
+    url?: string;
+    /** 저장 경로 (기본: ~/.bjd-code/data.csv) */
+    outputPath?: string;
+}
+/** 법정동 코드 CSV 다운로드 */
+export declare function downloadCSV(options?: DownloadOptions): Promise<string>;
+declare const MANUAL_INSTRUCTIONS: string;
+export { MANUAL_INSTRUCTIONS, DATA_DIR };
+//# sourceMappingURL=download.d.ts.map

package/dist/core/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/core/download.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAoB,MAAM,mBAAmB,CAAC;AAK/D,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sBAAsB;AACtB,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB5E;AAED,QAAA,MAAM,mBAAmB,QAIgC,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC"}

package/dist/core/download.js

@@ -0,0 +1,34 @@
+import { createWriteStream, mkdirSync } from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
+import { dirname } from 'node:path';
+import { DATA_DIR, DEFAULT_CSV_PATH } from '../utils/paths.js';
+const DOWNLOAD_URL = 'https://www.data.go.kr/cmm/cmm/fileDownload.do?atchFileId=FILE_000000002647058&fileDetailSn=1';
+/** 법정동 코드 CSV 다운로드 */
+export async function downloadCSV(options) {
+    const url = options?.url ?? DOWNLOAD_URL;
+    const outputPath = options?.outputPath ?? DEFAULT_CSV_PATH;
+    mkdirSync(dirname(outputPath), { recursive: true });
+    const response = await fetch(url, {
+        headers: {
+            'User-Agent': 'bjd-code/0.1.0',
+        },
+        redirect: 'follow',
+    });
+    if (!response.ok) {
+        throw new Error(`다운로드 실패 (HTTP ${response.status}). 수동으로 다운로드하세요:\n${MANUAL_INSTRUCTIONS}`);
+    }
+    if (!response.body) {
+        throw new Error('응답 본문이 비어있습니다.');
+    }
+    const body = Readable.fromWeb(response.body);
+    await pipeline(body, createWriteStream(outputPath));
+    return outputPath;
+}
+const MANUAL_INSTRUCTIONS = `
+1. https://www.data.go.kr/tcs/dss/selectFileDataDetailView.do?publicDataPk=15063424 접속
+2. CSV 파일 다운로드
+3. 다운로드한 파일을 다음 경로에 저장: ${DEFAULT_CSV_PATH}
+   또는 CLI 사용 시 파일 경로를 직접 지정: bjd parse ./파일경로.csv`.trim();
+export { MANUAL_INSTRUCTIONS, DATA_DIR };
+//# sourceMappingURL=download.js.map

package/dist/core/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/core/download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,YAAY,GAChB,+FAA+F,CAAC;AASlG,sBAAsB;AACtB,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAyB;IACzD,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,YAAY,CAAC;IACzC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,gBAAgB,CAAC;IAE3D,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,OAAO,EAAE;YACP,YAAY,EAAE,gBAAgB;SAC/B;QACD,QAAQ,EAAE,QAAQ;KACnB,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,MAAM,qBAAqB,mBAAmB,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAgD,CAAC,CAAC;IACzF,MAAM,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IAEpD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,mBAAmB,GAAG;;;0BAGF,gBAAgB;kDACQ,CAAC,IAAI,EAAE,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC"}

package/dist/core/filter.d.ts

@@ -0,0 +1,14 @@
+import type { BjdLevel, BjdRecord, FilterOptions } from '../types/index.js';
+/** 시도 필터링 */
+export declare function filterSido(records: BjdRecord[], options?: FilterOptions): BjdRecord[];
+/** 시군구 필터링 */
+export declare function filterSigungu(records: BjdRecord[], options?: FilterOptions): BjdRecord[];
+/** 읍면동 필터링 */
+export declare function filterEupmyeondong(records: BjdRecord[], options?: FilterOptions): BjdRecord[];
+/** 리 필터링 */
+export declare function filterRi(records: BjdRecord[], options?: FilterOptions): BjdRecord[];
+/** 레벨별 필터링 (단일 순회) */
+export declare function filterByLevel(records: BjdRecord[], level: BjdLevel, options?: FilterOptions): BjdRecord[];
+/** 이름 부분 검색 (단일 순회) */
+export declare function searchByName(records: BjdRecord[], query: string, options?: FilterOptions): BjdRecord[];
+//# sourceMappingURL=filter.d.ts.map

package/dist/core/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/core/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE5E,aAAa;AACb,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,CAErF;AAED,cAAc;AACd,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,CAExF;AAED,cAAc;AACd,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,CAE7F;AAED,YAAY;AACZ,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,CAEnF;AAED,sBAAsB;AACtB,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,EAAE,EACpB,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,SAAS,EAAE,CAGb;AAED,uBAAuB;AACvB,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,EAAE,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,SAAS,EAAE,CAKb"}

package/dist/core/filter.js

@@ -0,0 +1,30 @@
+/** 시도 필터링 */
+export function filterSido(records, options) {
+    return filterByLevel(records, 'sido', options);
+}
+/** 시군구 필터링 */
+export function filterSigungu(records, options) {
+    return filterByLevel(records, 'sigungu', options);
+}
+/** 읍면동 필터링 */
+export function filterEupmyeondong(records, options) {
+    return filterByLevel(records, 'eupmyeondong', options);
+}
+/** 리 필터링 */
+export function filterRi(records, options) {
+    return filterByLevel(records, 'ri', options);
+}
+/** 레벨별 필터링 (단일 순회) */
+export function filterByLevel(records, level, options) {
+    const includeInactive = options?.includeInactive ?? false;
+    return records.filter((r) => r.level === level && (includeInactive || r.isActive));
+}
+/** 이름 부분 검색 (단일 순회) */
+export function searchByName(records, query, options) {
+    const q = query.trim();
+    if (!q)
+        return [];
+    const includeInactive = options?.includeInactive ?? false;
+    return records.filter((r) => r.name.includes(q) && (includeInactive || r.isActive));
+}
+//# sourceMappingURL=filter.js.map

package/dist/core/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/core/filter.ts"],"names":[],"mappings":"AAEA,aAAa;AACb,MAAM,UAAU,UAAU,CAAC,OAAoB,EAAE,OAAuB;IACtE,OAAO,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,cAAc;AACd,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,OAAuB;IACzE,OAAO,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,cAAc;AACd,MAAM,UAAU,kBAAkB,CAAC,OAAoB,EAAE,OAAuB;IAC9E,OAAO,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,YAAY;AACZ,MAAM,UAAU,QAAQ,CAAC,OAAoB,EAAE,OAAuB;IACpE,OAAO,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,aAAa,CAC3B,OAAoB,EACpB,KAAe,EACf,OAAuB;IAEvB,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe,IAAI,KAAK,CAAC;IAC1D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,YAAY,CAC1B,OAAoB,EACpB,KAAa,EACb,OAAuB;IAEvB,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe,IAAI,KAAK,CAAC;IAC1D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/core/parser.d.ts

@@ -0,0 +1,5 @@
+import type { BjdRecord, ParseOptions } from '../types/index.js';
+export { normalizeRow } from '../utils/normalize.js';
+/** CSV 파싱 → BjdRecord[] */
+export declare function parseCSV(options?: ParseOptions): Promise<BjdRecord[]>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/core/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EAIb,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAgErD,2BAA2B;AAC3B,wBAAsB,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAO3E"}

package/dist/core/parser.js

@@ -0,0 +1,70 @@
+import { Worker } from 'node:worker_threads';
+import { createReadStream } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { parse } from 'csv-parse';
+import iconv from 'iconv-lite';
+import { normalizeRow } from '../utils/normalize.js';
+import { resolveDataPath } from '../utils/paths.js';
+export { normalizeRow } from '../utils/normalize.js';
+// vitest에서는 .ts 소스를 실행하므로 dist/ 경로로 우회
+const isSource = import.meta.url.endsWith('.ts');
+const WORKER_PATH = isSource
+    ? new URL('../../dist/worker/csv-worker.js', import.meta.url)
+    : new URL('../worker/csv-worker.js', import.meta.url);
+/** 메인 스레드에서 CSV 파싱 (폴백) */
+async function parseInMainThread(filePath, encoding) {
+    return new Promise((resolve, reject) => {
+        const records = [];
+        const fileStream = createReadStream(filePath);
+        const decoder = encoding.toLowerCase() === 'utf-8' || encoding.toLowerCase() === 'utf8'
+            ? fileStream
+            : fileStream.pipe(iconv.decodeStream(encoding));
+        const csvParser = parse({
+            columns: true,
+            skip_empty_lines: true,
+            trim: true,
+            bom: true,
+        });
+        decoder.pipe(csvParser);
+        csvParser.on('data', (row) => {
+            const record = normalizeRow(row);
+            if (record) {
+                records.push(record);
+            }
+        });
+        csvParser.on('end', () => resolve(records));
+        csvParser.on('error', reject);
+    });
+}
+/** Worker를 사용하여 CSV 파싱 */
+async function parseWithWorker(filePath, encoding) {
+    return new Promise((resolve, reject) => {
+        const workerDataPayload = { filePath, encoding };
+        const worker = new Worker(fileURLToPath(WORKER_PATH), {
+            workerData: workerDataPayload,
+        });
+        worker.on('message', (msg) => {
+            if (msg.type === 'result') {
+                resolve(msg.data);
+            }
+            else {
+                reject(new Error(msg.message));
+            }
+        });
+        worker.on('error', reject);
+        worker.on('exit', (exitCode) => {
+            if (exitCode !== 0) {
+                reject(new Error(`Worker exited with code ${exitCode}`));
+            }
+        });
+    });
+}
+/** CSV 파싱 → BjdRecord[] */
+export async function parseCSV(options) {
+    const { filePath, encoding = 'euc-kr', useWorker = true } = options ?? {};
+    const resolved = resolveDataPath(filePath);
+    return useWorker
+        ? parseWithWorker(resolved, encoding)
+        : parseInMainThread(resolved, encoding);
+}
+//# sourceMappingURL=parser.js.map

package/dist/core/parser.js.map

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

package/dist/core/tree.d.ts

@@ -0,0 +1,15 @@
+import type { BjdRecord, BjdTreeNode } from '../types/index.js';
+/**
+ * BjdRecord[] → 트리 구조 빌드 (O(n) 단일 패스)
+ * 시도 → 시군구 → 읍면동 → 리 계층
+ */
+export declare function buildTree(records: BjdRecord[]): BjdTreeNode[];
+/**
+ * 특정 코드 프리픽스 기준 서브트리 빌드
+ */
+export declare function buildSubTree(records: BjdRecord[], prefix: string): BjdTreeNode[];
+/**
+ * 트리 → 배열 평탄화 (깊이 우선)
+ */
+export declare function flattenTree(nodes: BjdTreeNode[]): BjdTreeNode[];
+//# sourceMappingURL=tree.d.ts.map

package/dist/core/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/core/tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,WAAW,EAAE,CAmC7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAGhF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAc/D"}

package/dist/core/tree.js

@@ -0,0 +1,95 @@
+/**
+ * BjdRecord[] → 트리 구조 빌드 (O(n) 단일 패스)
+ * 시도 → 시군구 → 읍면동 → 리 계층
+ */
+export function buildTree(records) {
+    const roots = [];
+    const nodeMap = new Map();
+    // 이미 정렬되어 있으면 복사/정렬 skip
+    const sorted = isSorted(records)
+        ? records
+        : [...records].sort((a, b) => a.code.localeCompare(b.code));
+    for (const record of sorted) {
+        const node = {
+            code: getCodeSegment(record),
+            fullCode: record.code,
+            name: record.names[record.names.length - 1],
+            level: record.level,
+            children: [],
+        };
+        nodeMap.set(record.code, node);
+        const parentKey = getParentKey(record);
+        if (parentKey) {
+            const parent = nodeMap.get(parentKey);
+            if (parent) {
+                parent.children.push(node);
+            }
+            else {
+                // 부모가 없으면 루트에 추가
+                roots.push(node);
+            }
+        }
+        else {
+            roots.push(node);
+        }
+    }
+    return roots;
+}
+/**
+ * 특정 코드 프리픽스 기준 서브트리 빌드
+ */
+export function buildSubTree(records, prefix) {
+    const filtered = records.filter((r) => r.code.startsWith(prefix));
+    return buildTree(filtered);
+}
+/**
+ * 트리 → 배열 평탄화 (깊이 우선)
+ */
+export function flattenTree(nodes) {
+    const result = [];
+    function walk(nodeList) {
+        for (const node of nodeList) {
+            result.push(node);
+            if (node.children.length > 0) {
+                walk(node.children);
+            }
+        }
+    }
+    walk(nodes);
+    return result;
+}
+/** 해당 레벨의 코드 조각 추출 */
+function getCodeSegment(record) {
+    switch (record.level) {
+        case 'sido':
+            return record.sidoCode;
+        case 'sigungu':
+            return record.sigunguCode;
+        case 'eupmyeondong':
+            return record.eupmyeondongCode;
+        case 'ri':
+            return record.riCode;
+    }
+}
+/** 배열이 코드 기준 정렬 상태인지 확인 */
+function isSorted(records) {
+    for (let i = 1; i < records.length; i++) {
+        if (records[i].code < records[i - 1].code)
+            return false;
+    }
+    return true;
+}
+/** 부모 노드의 전체 코드 계산 */
+function getParentKey(record) {
+    switch (record.level) {
+        case 'sido':
+            return null;
+        case 'sigungu':
+            return record.sidoCode + '00000000';
+        case 'eupmyeondong':
+            return record.sidoCode + record.sigunguCode + '00000';
+        case 'ri':
+            return record.sidoCode + record.sigunguCode + record.eupmyeondongCode + '00';
+    }
+}
+//# sourceMappingURL=tree.js.map

package/dist/core/tree.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export type { RawBjdRow, BjdRecord, BjdLevel, BjdTreeNode, FilterOptions, ParseOptions, } from './types/index.js';
+export { extractSidoCode, extractSigunguCode, extractEupmyeondongCode, extractRiCode, determineLevel, isValidCode, getParentCode, } from './utils/code.js';
+export { parseCSV, normalizeRow } from './core/parser.js';
+export { filterSido, filterSigungu, filterEupmyeondong, filterRi, filterByLevel, searchByName, } from './core/filter.js';
+export { buildTree, buildSubTree, flattenTree } from './core/tree.js';
+export { downloadCSV } from './core/download.js';
+export type { DownloadOptions } from './core/download.js';
+export { DEFAULT_CSV_PATH, hasDefaultData, resolveDataPath } from './utils/paths.js';
+import type { BjdRecord, BjdTreeNode, BjdLevel, ParseOptions, FilterOptions } from './types/index.js';
+/** parse + buildTree 편의 함수 */
+export declare function loadTree(options?: ParseOptions): Promise<BjdTreeNode[]>;
+/** parse + filter 편의 함수 */
+export declare function loadFiltered(options?: ParseOptions & {
+    level?: BjdLevel;
+    query?: string;
+} & FilterOptions): Promise<BjdRecord[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGrF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKtG,8BAA8B;AAC9B,wBAAsB,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAI7E;AAED,2BAA2B;AAC3B,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,YAAY,GAAG;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,GAC5E,OAAO,CAAC,SAAS,EAAE,CAAC,CActB"}