bjd-code 0.0.1 → 0.1.0

package/dist/index.js

@@ -0,0 +1,37 @@
+// Code utilities
+export { extractSidoCode, extractSigunguCode, extractEupmyeondongCode, extractRiCode, determineLevel, isValidCode, getParentCode, } from './utils/code.js';
+// Parser
+export { parseCSV, normalizeRow } from './core/parser.js';
+// Filters
+export { filterSido, filterSigungu, filterEupmyeondong, filterRi, filterByLevel, searchByName, } from './core/filter.js';
+// Tree
+export { buildTree, buildSubTree, flattenTree } from './core/tree.js';
+// Download
+export { downloadCSV } from './core/download.js';
+// Paths
+export { DEFAULT_CSV_PATH, hasDefaultData, resolveDataPath } from './utils/paths.js';
+import { parseCSV } from './core/parser.js';
+import { filterByLevel, searchByName } from './core/filter.js';
+import { buildTree } from './core/tree.js';
+/** parse + buildTree 편의 함수 */
+export async function loadTree(options) {
+    const records = await parseCSV(options);
+    const active = records.filter((r) => r.isActive);
+    return buildTree(active);
+}
+/** parse + filter 편의 함수 */
+export async function loadFiltered(options) {
+    const records = await parseCSV(options);
+    const filterOpts = { includeInactive: options?.includeInactive };
+    if (options?.query) {
+        return searchByName(records, options.query, filterOpts);
+    }
+    if (options?.level) {
+        return filterByLevel(records, options.level, filterOpts);
+    }
+    if (!options?.includeInactive) {
+        return records.filter((r) => r.isActive);
+    }
+    return records;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,SAAS;AACT,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE1D,UAAU;AACV,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO;AACP,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEtE,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIrF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,8BAA8B;AAC9B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAsB;IACnD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,2BAA2B;AAC3B,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA6E;IAE7E,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,UAAU,GAAkB,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAEhF,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,OAAO,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,70 @@
+/** CSV 원본 행 (한글 컬럼명) */
+export interface RawBjdRow {
+    법정동코드: string;
+    법정동명: string;
+    폐지여부: string;
+}
+/** 법정동 레벨 */
+export type BjdLevel = 'sido' | 'sigungu' | 'eupmyeondong' | 'ri';
+/** 정규화된 법정동 레코드 */
+export interface BjdRecord {
+    /** 전체 10자리 코드 */
+    code: string;
+    /** 시도 코드 (1-2자리) */
+    sidoCode: string;
+    /** 시군구 코드 (3-5자리) */
+    sigunguCode: string;
+    /** 읍면동 코드 (6-8자리) */
+    eupmyeondongCode: string;
+    /** 리 코드 (9-10자리) */
+    riCode: string;
+    /** 법정동명 (전체) */
+    name: string;
+    /** 공백 분리된 이름 배열 */
+    names: string[];
+    /** 행정 레벨 */
+    level: BjdLevel;
+    /** 현행 사용 여부 */
+    isActive: boolean;
+}
+/** 트리 노드 */
+export interface BjdTreeNode {
+    /** 해당 레벨의 코드 조각 */
+    code: string;
+    /** 전체 10자리 코드 */
+    fullCode: string;
+    /** 이름 */
+    name: string;
+    /** 행정 레벨 */
+    level: BjdLevel;
+    /** 하위 노드 */
+    children: BjdTreeNode[];
+}
+/** 필터 옵션 */
+export interface FilterOptions {
+    /** 폐지된 코드 포함 여부 (기본 false) */
+    includeInactive?: boolean;
+}
+/** 파싱 옵션 */
+export interface ParseOptions {
+    /** CSV 파일 경로 (미지정 시 ~/.bjd-code/data.csv 사용) */
+    filePath?: string;
+    /** 인코딩 (기본 'euc-kr') */
+    encoding?: string;
+    /** worker_threads 사용 여부 (기본 true) */
+    useWorker?: boolean;
+}
+/** Worker → 메인 메시지 */
+export type WorkerMessage = {
+    type: 'result';
+    data: BjdRecord[];
+} | {
+    type: 'error';
+    message: string;
+};
+/** 메인 → Worker 데이터 */
+export interface WorkerData {
+    filePath: string;
+    encoding: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,aAAa;AACb,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAAC;AAElE,mBAAmB;AACnB,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY;IACZ,KAAK,EAAE,QAAQ,CAAC;IAChB,eAAe;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,YAAY;AACZ,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS;IACT,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,QAAQ,CAAC;IAChB,YAAY;IACZ,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,YAAY;AACZ,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,YAAY;AACZ,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,sBAAsB;AACtB,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,sBAAsB;AACtB,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/code.d.ts

@@ -0,0 +1,34 @@
+import type { BjdLevel } from '../types/index.js';
+/**
+ * 10자리 코드에서 시도 코드(1-2자리) 추출
+ */
+export declare function extractSidoCode(code: string): string;
+/**
+ * 10자리 코드에서 시군구 코드(3-5자리) 추출
+ */
+export declare function extractSigunguCode(code: string): string;
+/**
+ * 10자리 코드에서 읍면동 코드(6-8자리) 추출
+ */
+export declare function extractEupmyeondongCode(code: string): string;
+/**
+ * 10자리 코드에서 리 코드(9-10자리) 추출
+ */
+export declare function extractRiCode(code: string): string;
+/**
+ * 뒷자리 0 패턴으로 행정 레벨 판단
+ * - 시도: XX00000000 (3~10자리 모두 0)
+ * - 시군구: XXXXX00000 (6~10자리 모두 0)
+ * - 읍면동: XXXXXXXX00 (9~10자리 모두 0)
+ * - 리: XXXXXXXXXX (0이 아닌 9~10자리)
+ */
+export declare function determineLevel(code: string): BjdLevel;
+/**
+ * 코드 유효성 검증 (10자리 숫자)
+ */
+export declare function isValidCode(code: string): boolean;
+/**
+ * 부모 코드 계산 (상위 레벨의 전체 10자리 코드)
+ */
+export declare function getParentCode(code: string, level: BjdLevel): string | null;
+//# sourceMappingURL=code.d.ts.map

package/dist/utils/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/utils/code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAerD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAW1E"}

package/dist/utils/code.js

@@ -0,0 +1,68 @@
+/**
+ * 10자리 코드에서 시도 코드(1-2자리) 추출
+ */
+export function extractSidoCode(code) {
+    return code.substring(0, 2);
+}
+/**
+ * 10자리 코드에서 시군구 코드(3-5자리) 추출
+ */
+export function extractSigunguCode(code) {
+    return code.substring(2, 5);
+}
+/**
+ * 10자리 코드에서 읍면동 코드(6-8자리) 추출
+ */
+export function extractEupmyeondongCode(code) {
+    return code.substring(5, 8);
+}
+/**
+ * 10자리 코드에서 리 코드(9-10자리) 추출
+ */
+export function extractRiCode(code) {
+    return code.substring(8, 10);
+}
+/**
+ * 뒷자리 0 패턴으로 행정 레벨 판단
+ * - 시도: XX00000000 (3~10자리 모두 0)
+ * - 시군구: XXXXX00000 (6~10자리 모두 0)
+ * - 읍면동: XXXXXXXX00 (9~10자리 모두 0)
+ * - 리: XXXXXXXXXX (0이 아닌 9~10자리)
+ */
+export function determineLevel(code) {
+    const sigungu = code.substring(2, 5);
+    const eupmyeondong = code.substring(5, 8);
+    const ri = code.substring(8, 10);
+    if (sigungu === '000' && eupmyeondong === '000' && ri === '00') {
+        return 'sido';
+    }
+    if (eupmyeondong === '000' && ri === '00') {
+        return 'sigungu';
+    }
+    if (ri === '00') {
+        return 'eupmyeondong';
+    }
+    return 'ri';
+}
+/**
+ * 코드 유효성 검증 (10자리 숫자)
+ */
+export function isValidCode(code) {
+    return /^\d{10}$/.test(code);
+}
+/**
+ * 부모 코드 계산 (상위 레벨의 전체 10자리 코드)
+ */
+export function getParentCode(code, level) {
+    switch (level) {
+        case 'sido':
+            return null;
+        case 'sigungu':
+            return code.substring(0, 2) + '00000000';
+        case 'eupmyeondong':
+            return code.substring(0, 5) + '00000';
+        case 'ri':
+            return code.substring(0, 8) + '00';
+    }
+}
+//# sourceMappingURL=code.js.map

package/dist/utils/code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/utils/code.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjC,IAAI,OAAO,KAAK,KAAK,IAAI,YAAY,KAAK,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAC/D,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,YAAY,KAAK,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAChB,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAe;IACzD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC;QAC3C,KAAK,cAAc;YACjB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC;QACxC,KAAK,IAAI;YACP,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/utils/normalize.d.ts

@@ -0,0 +1,4 @@
+import type { BjdRecord, RawBjdRow } from '../types/index.js';
+/** RawBjdRow → BjdRecord 변환 */
+export declare function normalizeRow(row: RawBjdRow): BjdRecord | null;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/utils/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/utils/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAU9D,+BAA+B;AAC/B,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAkB7D"}

package/dist/utils/normalize.js

@@ -0,0 +1,21 @@
+import { extractSidoCode, extractSigunguCode, extractEupmyeondongCode, extractRiCode, determineLevel, isValidCode, } from './code.js';
+/** RawBjdRow → BjdRecord 변환 */
+export function normalizeRow(row) {
+    const code = row.법정동코드.trim();
+    if (!isValidCode(code))
+        return null;
+    const name = row.법정동명.trim();
+    const names = name.split(/\s+/).filter(Boolean);
+    return {
+        code,
+        sidoCode: extractSidoCode(code),
+        sigunguCode: extractSigunguCode(code),
+        eupmyeondongCode: extractEupmyeondongCode(code),
+        riCode: extractRiCode(code),
+        name,
+        names,
+        level: determineLevel(code),
+        isActive: row.폐지여부.trim() === '존재',
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/utils/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/utils/normalize.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,+BAA+B;AAC/B,MAAM,UAAU,YAAY,CAAC,GAAc;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEhD,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC;QAC/B,WAAW,EAAE,kBAAkB,CAAC,IAAI,CAAC;QACrC,gBAAgB,EAAE,uBAAuB,CAAC,IAAI,CAAC;QAC/C,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC;QAC3B,IAAI;QACJ,KAAK;QACL,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC;QAC3B,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI;KACnC,CAAC;AACJ,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,13 @@
+/** 기본 데이터 디렉토리 (~/.bjd-code/) */
+export declare const DATA_DIR: string;
+/** 기본 CSV 파일 경로 */
+export declare const DEFAULT_CSV_PATH: string;
+/** 기본 CSV 파일이 존재하는지 확인 */
+export declare function hasDefaultData(): boolean;
+/**
+ * 파일 경로를 결정한다.
+ * 명시적 경로가 있으면 그대로 사용, 없으면 기본 경로 사용.
+ * 기본 경로에 파일이 없으면 에러.
+ */
+export declare function resolveDataPath(filePath?: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAIA,iCAAiC;AACjC,eAAO,MAAM,QAAQ,QAA+B,CAAC;AAErD,mBAAmB;AACnB,eAAO,MAAM,gBAAgB,QAA6B,CAAC;AAE3D,0BAA0B;AAC1B,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/dist/utils/paths.js

@@ -0,0 +1,24 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+/** 기본 데이터 디렉토리 (~/.bjd-code/) */
+export const DATA_DIR = join(homedir(), '.bjd-code');
+/** 기본 CSV 파일 경로 */
+export const DEFAULT_CSV_PATH = join(DATA_DIR, 'data.csv');
+/** 기본 CSV 파일이 존재하는지 확인 */
+export function hasDefaultData() {
+    return existsSync(DEFAULT_CSV_PATH);
+}
+/**
+ * 파일 경로를 결정한다.
+ * 명시적 경로가 있으면 그대로 사용, 없으면 기본 경로 사용.
+ * 기본 경로에 파일이 없으면 에러.
+ */
+export function resolveDataPath(filePath) {
+    if (filePath)
+        return filePath;
+    if (hasDefaultData())
+        return DEFAULT_CSV_PATH;
+    throw new Error('데이터 파일을 찾을 수 없습니다. 먼저 `bjd download`를 실행하거나 CSV 파일 경로를 지정하세요.');
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,iCAAiC;AACjC,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAErD,mBAAmB;AACnB,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAE3D,0BAA0B;AAC1B,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,cAAc,EAAE;QAAE,OAAO,gBAAgB,CAAC;IAC9C,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;AACJ,CAAC"}

package/dist/worker/csv-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=csv-worker.d.ts.map

package/dist/worker/csv-worker.d.ts.map

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

package/dist/worker/csv-worker.js

@@ -0,0 +1,33 @@
+import { parentPort, workerData } from 'node:worker_threads';
+import { createReadStream } from 'node:fs';
+import { parse } from 'csv-parse';
+import iconv from 'iconv-lite';
+import { normalizeRow } from '../utils/normalize.js';
+const { filePath, encoding } = workerData;
+const records = [];
+const fileStream = createReadStream(filePath);
+const decoder = encoding.toLowerCase() === 'utf-8' || encoding.toLowerCase() === 'utf8'
+    ? fileStream
+    : fileStream.pipe(iconv.decodeStream(encoding));
+const parser = parse({
+    columns: true,
+    skip_empty_lines: true,
+    trim: true,
+    bom: true,
+});
+decoder.pipe(parser);
+parser.on('data', (row) => {
+    const record = normalizeRow(row);
+    if (record) {
+        records.push(record);
+    }
+});
+parser.on('end', () => {
+    const msg = { type: 'result', data: records };
+    parentPort.postMessage(msg);
+});
+parser.on('error', (err) => {
+    const msg = { type: 'error', message: err.message };
+    parentPort.postMessage(msg);
+});
+//# sourceMappingURL=csv-worker.js.map

package/dist/worker/csv-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-worker.js","sourceRoot":"","sources":["../../src/worker/csv-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,UAAwB,CAAC;AAExD,MAAM,OAAO,GAAgB,EAAE,CAAC;AAEhC,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,KAAK,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM;IACrF,CAAC,CAAC,UAAU;IACZ,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AAElD,MAAM,MAAM,GAAG,KAAK,CAAC;IACnB,OAAO,EAAE,IAAI;IACb,gBAAgB,EAAE,IAAI;IACtB,IAAI,EAAE,IAAI;IACV,GAAG,EAAE,IAAI;CACV,CAAC,CAAC;AAEH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAc,EAAE,EAAE;IACnC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;IACpB,MAAM,GAAG,GAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC7D,UAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;IAChC,MAAM,GAAG,GAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IACnE,UAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,17 +1,47 @@
 {
   "name": "bjd-code",
-  "version": "0.0.1",
-  "description": "법정동 코드 api",
-  "main": "index.ts",
-  "repository": "https://github.com/SimDaSong/bjd-code.git",
-  "author": "SimDaSong <song98987@korea.ac.kr>",
+  "version": "0.1.0",
+  "description": "법정동 코드 파싱, 필터링, 트리 구조화 라이브러리",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "bjd": "./dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "법정동",
+    "bjd",
+    "korea",
+    "address",
+    "administrative-district"
+  ],
   "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0"
+  },
   "dependencies": {
-    "axios": "^0.24.0"
+    "commander": "^12.1.0",
+    "csv-parse": "^5.6.0",
+    "iconv-lite": "^0.6.3"
   },
-  "type": "module",
   "devDependencies": {
-    "@types/node": "^16.11.12",
-    "ts-node": "^10.4.0"
+    "@types/node": "^20.17.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
   }
 }

package/.idea/bjd-code.iml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="WEB_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$">
-      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
-      <excludeFolder url="file://$MODULE_DIR$/temp" />
-      <excludeFolder url="file://$MODULE_DIR$/tmp" />
-    </content>
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>

package/.idea/jsLibraryMappings.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="JavaScriptLibraryMappings">
-    <includedPredefinedLibrary name="Node.js Core" />
-  </component>
-</project>

package/.idea/misc.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="JavaScriptSettings">
-    <option name="languageLevel" value="ES6" />
-  </component>
-</project>

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/bjd-code.iml" filepath="$PROJECT_DIR$/.idea/bjd-code.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>

package/index.ts

@@ -1,122 +0,0 @@
-import {Worker} from 'worker_threads'
-import {getData} from "./helper";
-//
-import * as path from 'path';
-const __dirname = path.resolve();
-// const envInfo = require('./worker.js');
-
-const workerPath = path.join(__dirname, './worker.js');
-// let resultArr = new Array(envInfo.numThreads + 1);
-// const perPage = 10000;
-var nStart = new Date().getTime();      //시작시간 체크(단위 ms)
-
-/**
- currentCount: 10,
- data: [
- {
-'과거법정동코드': '13131607',
-      '리명': '신리',
-      '법정동코드': '4175045027',
-      '삭제일자': '2001-03-21',
-      '생성일자': '1988-04-23',
-      '순위': '0',
-      '시군구명': '화성군',
-      '시도명': '경기도',
-      '읍면동명': '동탄면'
- }]
- matchCount: 46203,
- page: 1,
- perPage: 10,
- totalCount: 46203
- */
-
-const data = await getData(1, 1);
-console.log(data.totalCount);
-const {totalCount} = data;
-
-const perPage = 5000;
-const threadSize = Math.floor(totalCount / perPage) + 1;
-const totalData: any[] = [];
-// for (let i = 1; i<= threadSize; i++) {
-//     totalData.push(...(await getData(i, perPage)).data);
-// }
-// console.log(totalData.length)
-
-
-// if (envInfo.useThread) {
-
-// if (isMainThread) {
-//     const worker = new Worker(__filename);
-//     worker.once('message', (message) => {
-//         console.log(message);  // Prints 'Hello, world!'.
-//     });
-//     worker.postMessage('Hello, world!');
-// } else {
-//     // When a message from the parent thread is received, send it back:
-//     parentPort.once('message', (message) => {
-//         parentPort.postMessage(message);
-//     });
-// }
-var mySet = new Set();
-var myMap = new Map();
-
-/*
-법정동 코드 (10자리) : 실제주소
-
-시도(2)+시군구(3)+읍면동(3)+리(2)
-
-ex> 경기도(41) + 화성시(590) + 향남면(390) + 수직리(32)
-
-      경기도(41) + 화성시(590) + 동탄면(420) + 석우리(24)
- */
-const d = async () => {
-    let count = 0;
-    for (let i = 1; i <= threadSize; i++) {
-        let myWorker = new Worker(workerPath);
-        myWorker.postMessage(i);
-        //INFO: 스레드로부터 데이터를 받음
-        myWorker.on('message', result => {
-            console.log(`${myWorker.threadId}`);
-            totalData.push(...result.data);
-            result.data.filter(res => res['삭제일자'] === '').forEach(res => {
-                mySet.add(res['시도명'])
-                myMap.set(res['법정동코드'].substr(0, 2), res['시도명'])
-            })
-            count++;
-
-            if (count === threadSize) {
-                var nEnd = new Date().getTime();      //종료시간 체크(단위 ms)
-
-                var nDiff = nEnd - nStart;      //두 시간차 계산(단위 ms)
-                console.log(nDiff + "ms");
-
-                console.log(totalData)
-                console.log(mySet)
-                console.log(myMap)
-            }
-        });
-    }
-}
-
-await d();
-console.log('dd')
-
-// } else {
-//     console.time('main');
-//     for (let i = 0; i < envInfo.numThreads; i++) {
-//         resultArr[i] = doSomething();
-//     }
-//     console.timeEnd('main');
-//
-//     for (let i = 0; i < envInfo.numThreads; i++) {
-//         console.log(`result : ${resultArr[i]}`);
-//     }
-// }
-//
-// function doSomething() {
-//     let data = 0;
-//     for (let i = 0; i < envInfo.jobSize; i++) {
-//         data += i;
-//     }
-//     return data;
-// }