dongnelibrary 0.3.8 → 0.3.10

package/.playwright-mcp/console-2026-03-07T15-37-14-935Z.log

@@ -0,0 +1,3 @@
+[    1255ms] [ERROR] Failed to load resource: net::ERR_NAME_NOT_RESOLVED @ https://cdn.polyfill.io/v2/polyfill.min.js?features=requestAnimationFrame,Element.prototype.classList,URL:0
+[    1475ms] Uncaught ReferenceError: proj4 is not defined
+    at <anonymous> (https://map.ngii.go.kr/openapi/wmts_ngiiMap_v6.4.3.js?apikey=956A18AC72966E2A0CABF30959636811:3:0)

package/.playwright-mcp/console-2026-03-07T16-05-56-891Z.log

@@ -0,0 +1 @@
+[    1343ms] [WARNING] cdn.tailwindcss.com should not be used in production. To use Tailwind CSS in production, install it as a PostCSS plugin or use the Tailwind CLI: https://tailwindcss.com/docs/installation @ https://cdn.tailwindcss.com/:63

package/.playwright-mcp/console-2026-03-07T16-21-56-709Z.log

@@ -0,0 +1 @@
+[     545ms] [WARNING] cdn.tailwindcss.com should not be used in production. To use Tailwind CSS in production, install it as a PostCSS plugin or use the Tailwind CLI: https://tailwindcss.com/docs/installation @ https://cdn.tailwindcss.com/:63

package/.playwright-mcp/console-2026-03-07T16-24-32-498Z.log

@@ -0,0 +1 @@
+[     541ms] [WARNING] cdn.tailwindcss.com should not be used in production. To use Tailwind CSS in production, install it as a PostCSS plugin or use the Tailwind CLI: https://tailwindcss.com/docs/installation @ https://cdn.tailwindcss.com/:63

package/API.md

@@ -1,6 +1,6 @@
 # DongneLibrary API Reference
 
-A JavaScript/TypeScript library for checking book availability across 100+ Korean public library branches in Gyeonggi Province (경기도).
+A JavaScript/TypeScript library for checking book availability across 180+ Korean public library branches.
 
 ## Installation
 
@@ -186,20 +186,20 @@ try {
 
 ---
 
-### getLibraryNames()
+### getAllLibraryNames()
 
 Returns an array of all supported library branch names.
 
 #### Returns
 
-`string[]` - Array of library names (100+ branches)
+`string[]` - Array of library names (180+ branches)
 
 #### Example
 
 ```javascript
-const libraries = dongnelibrary.getLibraryNames();
+const libraries = dongnelibrary.getAllLibraryNames();
 console.log(libraries);
-// ['가좌도서관', '갈현도서관', '경기평생교육학습관', ...]
+// ['경기중앙교육도서관', '경기평택교육도서관', '경기광주교육도서관', ...]
 ```
 
 ---
@@ -218,14 +218,55 @@ Returns a mapping of library system module names to their home URLs.
 const urls = dongnelibrary.getModuleHomeUrls();
 console.log(urls);
 // {
-//   gg: 'https://lib.goe.go.kr',
-//   gunpo: 'https://www.gunpolib.go.kr',
+//   '경기교육통합도서관': 'https://lib.goe.go.kr',
+//   '군포시도서관': 'https://www.gunpolib.go.kr',
 //   ...
 // }
 ```
 
 ---
 
+### getAllModuleNames()
+
+Returns an array of all library system module names.
+
+#### Returns
+
+`string[]` - Array of module names
+
+#### Example
+
+```javascript
+const modules = dongnelibrary.getAllModuleNames();
+console.log(modules);
+// ['경기교육통합도서관', '군포시도서관', '성남시도서관', ...]
+```
+
+---
+
+### isModuleName(name)
+
+Checks if a given name is a library system module name.
+
+#### Parameters
+
+| Parameter | Type     | Required | Description            |
+| --------- | -------- | -------- | ---------------------- |
+| `name`    | `string` | Yes      | Name to check          |
+
+#### Returns
+
+`boolean` - `true` if the name is a module name
+
+#### Example
+
+```javascript
+dongnelibrary.isModuleName("성남시도서관"); // true
+dongnelibrary.isModuleName("판교도서관"); // false (branch name, not module name)
+```
+
+---
+
 ## Types
 
 ### SearchResult
@@ -293,8 +334,9 @@ type SearchCompleteCallback = (
 | `suwon`  | 수원시도서관       | Suwon City        |
 | `yjlib`  | 여주시립도서관     | Yeoju City        |
 | `yongin` | 용인시도서관       | Yongin City       |
+| `jeju`   | 제주시도서관       | Jeju City         |
 
-Use `getLibraryNames()` to see all 100+ individual branch names.
+Use `getAllLibraryNames()` to see all 180+ individual branch names.
 
 ---
 
@@ -304,6 +346,9 @@ Use `getLibraryNames()` to see all 100+ individual branch names.
 # Interactive mode
 npx dongnelibrary -i
 
+# Interactive mode (choose by library system)
+npx dongnelibrary -m
+
 # Search specific library
 npx dongnelibrary -t "해리포터" -l "판교도서관"
 
@@ -320,7 +365,14 @@ See `dongnelibrary --help` for all options.
 The package includes TypeScript declarations. Import types directly:
 
 ```typescript
-import dongnelibrary, { SearchResult, SearchError, Book } from "dongnelibrary";
+import dongnelibrary, {
+  SearchResult,
+  SearchError,
+  SearchOptionsMain,
+  SearchCallback,
+  SearchCompleteCallback,
+  Book,
+} from "dongnelibrary";
 ```
 
 ---

package/README.md

@@ -19,6 +19,7 @@
     npm run build
 
     node ./dist/cli.js -i
+    node ./dist/cli.js -m
     node ./dist/cli.js -a
     node ./dist/cli.js -t 별 -l 남양
     node ./dist/cli.js -t 별 -l 흥천,판교
@@ -31,6 +32,7 @@
 
     npm install dongnelibrary@latest -g
     dongnelibrary -i
+    dongnelibrary -m
     dongnelibrary -a
     dongnelibrary -t 별 -l 남양
     dongnelibrary -t 별 -l 흥천,판교
@@ -43,6 +45,7 @@
 ## Run with npx
 
     npx dongnelibrary -i
+    npx dongnelibrary -m
     npx dongnelibrary -a
     npx dongnelibrary -t 별 -l 남양
     npx dongnelibrary -t 별 -l 흥천,판교
@@ -59,6 +62,7 @@
 ### run examples
 
     docker run -it --rm ghcr.io/afrontend/dongnelibrary -i
+    docker run -it --rm ghcr.io/afrontend/dongnelibrary -m
     docker run --rm ghcr.io/afrontend/dongnelibrary -a
     docker run --rm ghcr.io/afrontend/dongnelibrary -t 별 -l 남양
     docker run --rm ghcr.io/afrontend/dongnelibrary -t 별 -l 흥천,판교
@@ -74,6 +78,7 @@
 ### run examples
 
     docker run -it dongnelibrary -i
+    docker run -it dongnelibrary -m
     docker run dongnelibrary -a
     docker run dongnelibrary -t 별 -l "남양"
     docker run dongnelibrary -t 별 -l "흥천,판교"
@@ -143,8 +148,9 @@ console.log(results.length + " 개의 도서관을 검색했습니다.");
 - [오산시도서관][osan-url] (오산중앙도서관,꿈두레도서관,초평도서관,햇살마루도서관,청학도서관,양산도서관,소리울도서관,무지개도서관,고현초꿈키움도서관,쌍용예가시민개방도서관)
 - [화성시립도서관][hscity-url] (남양도서관,태안도서관,삼괴도서관,병점도서관,샘내도서관,두빛나래어린이도서관,봉담도서관,둥지나래어린이도서관,목동이음터도서관,기아행복마루도서관,화성동탄중앙도서관,송산도서관,정남도서관,비봉도서관,진안도서관,중앙이음터도서관,양감도서관,다원이음터도서관,송린이음터도서관,팔탄도서관,마도도서관,봉담커피앤북도서관,왕배푸른숲도서관,노을빛도서관,서연이음터도서관,호연이음터도서관,향남복합문화센터도서관,봉담와우도서관,늘봄이음터도서관,달빛나래어린이도서관)
 - [수원시도서관][suwon-url] (선경도서관,수원중앙도서관,창룡도서관,화서다산도서관,호매실도서관,서수원도서관,한림도서관,버드내도서관,북수원도서관,대추골도서관,일월도서관,광교홍재도서관,태장마루도서관,광교푸른숲도서관,매여울도서관,망포글빛도서관,슬기샘도서관,지혜샘어린이도서관,바른샘어린이도서관,한아름도서관,반달어린이도서관,사랑샘도서관,희망샘도서관)
-- [용인시도서관][yongin-url] (수지도서관,구성도서관,기흥도서관,남사도서관,동백도서관,동천도서관,모현도서관,보라도서관,상현도서관,서농도서관,성복도서관,용인중앙도서관,양지해밀도서관,영덕도서관,죽전도서관,청덕도서관,포곡도서관,흥덕도서관)
+- [용인시도서관][yongin-url] (수지도서관,구갈희망누리도서관,구성도서관,기흥도서관,남사도서관,동백도서관,동천도서관,모현도서관,보라도서관,상현도서관,서농도서관,성복도서관,용인중앙도서관,양지해밀도서관,영덕도서관,이동꿈틀도서관,죽전도서관,청덕도서관,포곡도서관,흥덕도서관,기흥동행정복지센터스마트도서관,기흥역스마트도서관,동천동행정복지센터스마트도서관,마북동행정복지센터스마트도서관,보정동행정복지센터스마트도서관,상갈동행정복지센터스마트도서관,상하동행정복지센터스마트도서관,성복역스마트도서관,시청스마트도서관,신봉동행정복지센터스마트도서관,역북동행정복지센터스마트도서관,용인중앙시장역스마트도서관,원삼면스마트도서관,유방어린이공원스마트도서관,죽전역스마트도서관,고림다온작은도서관,남사맑은누리작은도서관,백암면작은도서관,상현1동작은도서관,상현2동작은도서관,이동천리작은도서관)
 - [여주시립도서관][yjlib-url] (여주도서관,세종도서관,점동도서관,여주기적의도서관,흥천도서관,금사도서관,대신도서관,산북작은도서관,북내작은도서관,여주역스마트도서관,이마트스마트도서관)
+- [제주시도서관][jeju-url] (한라도서관,우당도서관,탐라도서관,제주시기적의도서관,애월도서관,조천읍도서관,한경도서관,삼매봉도서관,중앙도서관,동부도서관,서부도서관,서귀포기적의도서관,성산일출도서관,안덕산방도서관,표선도서관,꿈바당어린이도서관)
 
 ## 마무리
 
@@ -163,6 +169,7 @@ console.log(results.length + " 개의 도서관을 검색했습니다.");
     npm run suwon   # 수원시 도서관
     npm run yjlib   # 여주시 도서관
     npm run yongin  # 용인시 도서관
+    npm run jeju    # 제주시 도서관
 
 [dongnelibraryspa]: https://github.com/afrontend/dongnelibraryspa "AngularJS, Foundation을 사용한 Web UI"
 [npm-image]: https://img.shields.io/npm/v/dongnelibrary.svg
@@ -177,3 +184,4 @@ console.log(results.length + " 개의 도서관을 검색했습니다.");
 [suwon-url]: https://www.suwonlib.go.kr
 [yongin-url]: https://lib.yongin.go.kr
 [yjlib-url]: https://www.yjlib.go.kr
+[jeju-url]: https://www.jeju.go.kr/

package/dist/dongnelibrary.d.ts

@@ -1,16 +1,38 @@
-import type { SearchError, SearchResult } from "./types";
+import type { SearchCallback, SearchCompleteCallback, SearchOptionsMain, SearchResult } from "./types";
+/**
+ * Get all available library names
+ * @returns Array of all library names
+ */
 export declare const getAllLibraryNames: () => string[];
+/**
+ * Get all module names
+ * @returns Array of all module names
+ */
 export declare const getAllModuleNames: () => string[];
+/**
+ * Get home URLs for all modules
+ * @returns Record mapping module names to their home URLs
+ */
 export declare const getModuleHomeUrls: () => Record<string, string>;
+/**
+ * Check if a name corresponds to a known module
+ * @param name - Name to check
+ * @returns True if the name is a valid module name
+ */
 export declare const isModuleName: (name: string) => boolean;
-export type SearchCallback = (err: SearchError | null, result?: SearchResult) => void;
-export type SearchCompleteCallback = (err: SearchError | null, results?: SearchResult[]) => void;
-export interface SearchOptionsMain {
-    title: string;
-    libraryName: string | string[];
-    signal?: AbortSignal;
-}
+/**
+ * Asynchronously search across multiple libraries
+ * @param opt - Search options including title and library names
+ * @param onResult - Callback for individual search results
+ * @returns Promise resolving to array of search results
+ */
 export declare const searchAsync: (opt: SearchOptionsMain, onResult?: SearchCallback) => Promise<SearchResult[]>;
+/**
+ * Synchronous search wrapper that calls completion callback
+ * @param opt - Search options or null/undefined
+ * @param onResult - Callback for individual search results
+ * @param onComplete - Callback for final search results
+ */
 export declare const search: (opt: SearchOptionsMain | undefined | null, onResult?: SearchCallback, onComplete?: SearchCompleteCallback) => void;
-export type { SearchResult, SearchError, Book } from "./types";
+export type { SearchResult, SearchError, SearchOptionsMain, SearchCallback, SearchCompleteCallback, Book, } from "./types";
 //# sourceMappingURL=dongnelibrary.d.ts.map

package/dist/dongnelibrary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dongnelibrary.d.ts","sourceRoot":"","sources":["../src/dongnelibrary.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAIV,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAC;AAwCjB,eAAO,MAAM,kBAAkB,QAAO,MAAM,EACL,CAAC;AAExC,eAAO,MAAM,iBAAiB,QAAO,MAAM,EACD,CAAC;AAE3C,eAAO,MAAM,iBAAiB,QAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CACiB,CAAC;AAE5E,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OACQ,CAAC;AA4FrD,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,WAAW,GAAG,IAAI,EACvB,MAAM,CAAC,EAAE,YAAY,KAClB,IAAI,CAAC;AAEV,MAAM,MAAM,sBAAsB,GAAG,CACnC,GAAG,EAAE,WAAW,GAAG,IAAI,EACvB,OAAO,CAAC,EAAE,YAAY,EAAE,KACrB,IAAI,CAAC;AAEV,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,eAAO,MAAM,WAAW,GACtB,KAAK,iBAAiB,EACtB,WAAW,cAAc,KACxB,OAAO,CAAC,YAAY,EAAE,CAkBxB,CAAC;AAEF,eAAO,MAAM,MAAM,GACjB,KAAK,iBAAiB,GAAG,SAAS,GAAG,IAAI,EACzC,WAAW,cAAc,EACzB,aAAa,sBAAsB,KAClC,IAMF,CAAC;AAGF,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"dongnelibrary.d.ts","sourceRoot":"","sources":["../src/dongnelibrary.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAKV,cAAc,EACd,sBAAsB,EAEtB,iBAAiB,EACjB,YAAY,EACb,MAAM,SAAS,CAAC;AAqDjB;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAO,MAAM,EACH,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAAM,EACS,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CACgC,CAAC;AAE3F;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,OACkB,CAAC;AAwJ/D;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,KAAK,iBAAiB,EACtB,WAAW,cAAc,KACxB,OAAO,CAAC,YAAY,EAAE,CAkBxB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GACjB,KAAK,iBAAiB,GAAG,SAAS,GAAG,IAAI,EACzC,WAAW,cAAc,EACzB,aAAa,sBAAsB,KAClC,IAMF,CAAC;AAOF,YAAY,EACV,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,IAAI,GACL,MAAM,SAAS,CAAC"}

package/dist/dongnelibrary.js

@@ -1,4 +1,7 @@
 "use strict";
+// =============================================================================
+// IMPORTS
+// =============================================================================
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -34,20 +37,26 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.search = exports.searchAsync = exports.isModuleName = exports.getModuleHomeUrls = exports.getAllModuleNames = exports.getAllLibraryNames = void 0;
-const gg = __importStar(require("./library/gg"));
-const gunpo = __importStar(require("./library/gunpo"));
-const hscity = __importStar(require("./library/hscity"));
-const osan = __importStar(require("./library/osan"));
-const snlib = __importStar(require("./library/snlib"));
-const suwon = __importStar(require("./library/suwon"));
-const yjlib = __importStar(require("./library/yjlib"));
-const yongin = __importStar(require("./library/yongin"));
+// Local library modules
+const gg = __importStar(require("./localLibraryModule/gg"));
+const gunpo = __importStar(require("./localLibraryModule/gunpo"));
+const jeju = __importStar(require("./localLibraryModule/jeju"));
+const hscity = __importStar(require("./localLibraryModule/hscity"));
+const osan = __importStar(require("./localLibraryModule/osan"));
+const snlib = __importStar(require("./localLibraryModule/snlib"));
+const suwon = __importStar(require("./localLibraryModule/suwon"));
+const yjlib = __importStar(require("./localLibraryModule/yjlib"));
+const yongin = __importStar(require("./localLibraryModule/yongin"));
 // =============================================================================
-// Configuration
+// CONFIGURATION
 // =============================================================================
+/**
+ * List of all available library modules
+ */
 const LIBRARY_MODULES = [
     gg,
     gunpo,
+    jeju,
     hscity,
     osan,
     snlib,
@@ -55,7 +64,13 @@ const LIBRARY_MODULES = [
     yjlib,
     yongin,
 ];
+/**
+ * Error object returned when an unknown library is requested
+ */
 const UNKNOWN_LIBRARY_ERROR = { msg: "Unknown library name" };
+/**
+ * Default library entry for unknown/invalid library names
+ */
 const UNKNOWN_LIBRARY = {
     name: "Unknown",
     search: async (_opt, onResult) => {
@@ -64,28 +79,78 @@ const UNKNOWN_LIBRARY = {
     homeUrl: "",
 };
 // =============================================================================
-// Library Registry
+// LIBRARY REGISTRY
 // =============================================================================
-const allLibraryList = LIBRARY_MODULES.flatMap((module) => module.getLibraryNames().map((name) => ({
+/**
+ * Flatten all library names from modules into a single registry
+ */
+const ALL_LIBRARY_LIST = LIBRARY_MODULES.flatMap((module) => module.getLibraryNames().map((name) => ({
     name,
     search: module.search,
     homeUrl: module.homeUrl,
 })));
-const getAllLibraryNames = () => allLibraryList.map((lib) => lib.name);
+/**
+ * Get all available library names
+ * @returns Array of all library names
+ */
+const getAllLibraryNames = () => ALL_LIBRARY_LIST.map((lib) => lib.name);
 exports.getAllLibraryNames = getAllLibraryNames;
-const getAllModuleNames = () => LIBRARY_MODULES.map((m) => m.moduleName);
+/**
+ * Get all module names
+ * @returns Array of all module names
+ */
+const getAllModuleNames = () => LIBRARY_MODULES.map((module) => module.moduleName);
 exports.getAllModuleNames = getAllModuleNames;
-const getModuleHomeUrls = () => Object.fromEntries(LIBRARY_MODULES.map((m) => [m.moduleName, m.homeUrl]));
+/**
+ * Get home URLs for all modules
+ * @returns Record mapping module names to their home URLs
+ */
+const getModuleHomeUrls = () => Object.fromEntries(LIBRARY_MODULES.map((module) => [module.moduleName, module.homeUrl]));
 exports.getModuleHomeUrls = getModuleHomeUrls;
-const isModuleName = (name) => LIBRARY_MODULES.some((m) => m.moduleName === name);
+/**
+ * Check if a name corresponds to a known module
+ * @param name - Name to check
+ * @returns True if the name is a valid module name
+ */
+const isModuleName = (name) => LIBRARY_MODULES.some((module) => module.moduleName === name);
 exports.isModuleName = isModuleName;
-const getLibraryNamesInModule = (moduleName) => LIBRARY_MODULES.find((m) => m.moduleName === moduleName)?.getLibraryNames() ??
+/**
+ * Get all library names from a specific module
+ * @param moduleName - Name of the module to get libraries from
+ * @returns Array of library names in the specified module
+ */
+const getLibraryNamesInModule = (moduleName) => LIBRARY_MODULES.find((module) => module.moduleName === moduleName)?.getLibraryNames() ??
     [];
-const getLibraryRegistryEntryByName = (libraryName) => allLibraryList.find((lib) => lib.name === libraryName) ?? UNKNOWN_LIBRARY;
-const completeLibraryName = (str) => (0, exports.getAllLibraryNames)().find((name) => name.includes(str)) ?? "";
-const isValidLibraryName = (libraryName) => allLibraryList.some((lib) => lib.name === libraryName) ||
-    (0, exports.getAllModuleNames)().some((moduleName) => moduleName === libraryName);
+/**
+ * Get a library registry entry by name
+ * @param libraryName - Name of the library to find
+ * @returns Library registry entry or unknown library if not found
+ */
+const getLibraryRegistryEntryByName = (libraryName) => ALL_LIBRARY_LIST.find((lib) => lib.name === libraryName) ?? UNKNOWN_LIBRARY;
+/**
+ * Complete a partial library name to full name
+ * @param str - Partial library name to complete
+ * @returns Full library name if found, otherwise empty string
+ */
+const completeLibraryName = (str) => ALL_LIBRARY_LIST.find((lib) => lib.name.includes(str))?.name ?? "";
+/**
+ * Validate if a library name is valid
+ * @param libraryName - Name to validate
+ * @returns True if the library name is valid (exists or is a module name)
+ */
+const isValidLibraryName = (libraryName) => ALL_LIBRARY_LIST.some((lib) => lib.name === libraryName) ||
+    (0, exports.isModuleName)(libraryName);
+/**
+ * Expand module names to their constituent library names
+ * @param libraryNameList - List of library names and/or module names
+ * @returns Expanded list with module names replaced by their constituent libraries
+ */
 const expandModuleNames = (libraryNameList) => libraryNameList.flatMap((name) => (0, exports.isModuleName)(name) ? getLibraryNamesInModule(name) : [name]);
+/**
+ * Resolve library names to their actual names
+ * @param libraryName - Single library name or array of names
+ * @returns Array of resolved library names
+ */
 const resolveNameList = (libraryName) => {
     if (libraryName === "")
         return (0, exports.getAllLibraryNames)();
@@ -95,21 +160,48 @@ const resolveNameList = (libraryName) => {
         return getLibraryNamesInModule(libraryName);
     return [libraryName];
 };
+/**
+ * Resolve library names to their registry entries
+ * @param libraryName - Single library name or array of names
+ * @returns Array of registry entries for the requested libraries
+ */
 const resolveLibraryRegistryEntry = (libraryName) => resolveNameList(libraryName)
     .map(completeLibraryName)
     .filter(isValidLibraryName)
     .map(getLibraryRegistryEntryByName);
 // =============================================================================
-// Book Result Helpers
+// BOOK RESULT HELPERS
 // =============================================================================
+/**
+ * Normalize book data to ensure consistent structure
+ * @param book - Book object with potentially missing fields
+ * @returns Normalized book object with all required fields
+ */
 const normalizeBook = ({ libraryName, title, exist, bookUrl }) => ({
     libraryName,
     title,
     exist,
     bookUrl,
 });
+/**
+ * Sort books by availability (available books first)
+ * @param books - Array of books to sort
+ * @returns Sorted array with available books first
+ */
 const sortByAvailability = (books) => books.sort((a, b) => (a.exist === b.exist ? 0 : a.exist ? -1 : 1));
+/**
+ * Process a list of books by normalizing and sorting them
+ * @param books - Array of book objects to process
+ * @returns Processed and sorted array of books
+ */
 const processBooklist = (books) => sortByAvailability(books.map(normalizeBook));
+/**
+ * Perform a search on a single library
+ * @param lib - Library registry entry to search
+ * @param title - Search term
+ * @param signal - AbortSignal for cancellation support
+ * @returns Promise resolving to search result or error
+ */
 const searchLibrary = (lib, title, signal) => new Promise((resolve) => {
     lib.search({ title, libraryName: lib.name, signal }, (err, data) => {
         if (err) {
@@ -132,6 +224,12 @@ const searchLibrary = (lib, title, signal) => new Promise((resolve) => {
         });
     });
 });
+/**
+ * Asynchronously search across multiple libraries
+ * @param opt - Search options including title and library names
+ * @param onResult - Callback for individual search results
+ * @returns Promise resolving to array of search results
+ */
 const searchAsync = (opt, onResult) => {
     const { title, libraryName, signal } = opt;
     const libraries = resolveLibraryRegistryEntry(libraryName);
@@ -149,6 +247,12 @@ const searchAsync = (opt, onResult) => {
     return Promise.all(promises).then((r) => r.filter((v) => v !== null));
 };
 exports.searchAsync = searchAsync;
+/**
+ * Synchronous search wrapper that calls completion callback
+ * @param opt - Search options or null/undefined
+ * @param onResult - Callback for individual search results
+ * @param onComplete - Callback for final search results
+ */
 const search = (opt, onResult, onComplete) => {
     if (!opt || (!onResult && !onComplete)) {
         console.log("invalid search options");
@@ -157,4 +261,15 @@ const search = (opt, onResult, onComplete) => {
     (0, exports.searchAsync)(opt, onResult).then((results) => onComplete?.(null, results));
 };
 exports.search = search;
+// =============================================================================
+// API EXPORT
+// =============================================================================
+({
+    getAllLibraryNames: exports.getAllLibraryNames,
+    getAllModuleNames: exports.getAllModuleNames,
+    getModuleHomeUrls: exports.getModuleHomeUrls,
+    isModuleName: exports.isModuleName,
+    searchAsync: exports.searchAsync,
+    search: exports.search,
+});
 //# sourceMappingURL=dongnelibrary.js.map

package/dist/dongnelibrary.js.map

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

package/dist/localLibraryModule/gg.d.ts

@@ -0,0 +1,6 @@
+import type { SearchOptions, SearchResult } from "../types";
+export declare const moduleName = "\uACBD\uAE30\uAD50\uC721\uD1B5\uD569\uB3C4\uC11C\uAD00";
+export declare const homeUrl = "https://lib.goe.go.kr";
+export declare const search: (opt: SearchOptions, callback?: import("../types").SearchCallback) => Promise<SearchResult | void>;
+export declare function getLibraryNames(): string[];
+//# sourceMappingURL=gg.d.ts.map

package/dist/localLibraryModule/gg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gg.d.ts","sourceRoot":"","sources":["../../src/localLibraryModule/gg.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAIV,aAAa,EACb,YAAY,EACb,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,UAAU,2DAAc,CAAC;AACtC,eAAO,MAAM,OAAO,0BAA0B,CAAC;AA0G/C,eAAO,MAAM,MAAM,oGAA+B,CAAC;AAEnD,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C"}

package/dist/localLibraryModule/gg.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.search = exports.homeUrl = exports.moduleName = void 0;
+exports.getLibraryNames = getLibraryNames;
+const util_1 = require("../util");
+const http_1 = require("../http");
+const jsdom_1 = require("jsdom");
+exports.moduleName = "경기교육통합도서관";
+exports.homeUrl = "https://lib.goe.go.kr";
+const libraryList = [
+    { code: "MA", name: "경기중앙교육도서관" },
+    { code: "MB", name: "경기평택교육도서관" },
+    { code: "MC", name: "경기광주교육도서관" },
+    { code: "MD", name: "경기여주가남교육도서관" },
+    { code: "ME", name: "경기포천교육도서관" },
+    { code: "MF", name: "경기김포교육도서관" },
+    { code: "MG", name: "경기과천교육도서관" },
+    { code: "MH", name: "경기성남교육도서관" },
+    { code: "MJ", name: "경기화성교육도서관" },
+    { code: "MK", name: "경기의정부교육도서관" },
+    { code: "ML", name: "경기평생교육학습관" },
+];
+const getLibraryCode = (0, util_1.createLibraryCodeLookup)(libraryList);
+/**
+ * Search for books in Gyeonggi Provincial Educational Libraries.
+ */
+async function searchImpl(opt) {
+    const { title, libraryName, signal } = opt;
+    (0, util_1.validateSearchOptions)(opt);
+    const lcode = getLibraryCode(libraryName);
+    const { statusCode, body } = await (0, http_1.get)(`https://lib.goe.go.kr/gg/intro/search/index.do`, {
+        qs: {
+            booktype: "BOOKANDNONBOOK",
+            libraryCodes: lcode,
+            rowCount: 1000,
+            search_text: title,
+            viewPage: 1,
+        },
+        signal,
+    });
+    if (statusCode !== 200) {
+        throw new Error(`HTTP ${statusCode}`);
+    }
+    const dom = new jsdom_1.JSDOM(body);
+    const document = dom.window.document;
+    const counterEl = document.querySelector("#search_result > div.research-box > div.search-info > b");
+    const count = counterEl ? Number(counterEl.innerHTML) : 0;
+    const booklist = [];
+    const bookItems = document.querySelectorAll(".bif");
+    bookItems.forEach((item) => {
+        const titleElement = item.querySelector(".book-title");
+        const bookTitle = titleElement?.querySelector("span")?.textContent?.trim() ?? "";
+        const bookPath = titleElement?.getAttribute("href") ?? "";
+        const tmpUrl = bookPath
+            ? "https://lib.goe.go.kr/gg/intro/search/" + bookPath
+            : "";
+        const url = new URL(tmpUrl);
+        const regNo = url.searchParams.get("regNo");
+        const manageCode = url.searchParams.get("manageCode");
+        const booktype = url.searchParams.get("booktype");
+        const bookUrl = `https://lib.goe.go.kr/gg/intro/search/detail.do?regNo=${regNo}&manageCode=${manageCode}&booktype=${booktype}`;
+        const availability = item.querySelector(".state.typeC")?.textContent?.trim() ?? "";
+        // Find span containing "도서관" and get its next sibling's text
+        let libName = "";
+        const spans = item.querySelectorAll("span");
+        for (const span of spans) {
+            if (span.textContent?.includes("도서관")) {
+                const nextSibling = span.nextElementSibling;
+                if (nextSibling) {
+                    libName = nextSibling.textContent?.split("|")[0]?.trim() ?? "";
+                }
+                break;
+            }
+        }
+        if (bookTitle) {
+            booklist.push({
+                libraryName: libName,
+                title: bookTitle,
+                bookUrl,
+                maxoffset: count,
+                exist: availability === "대출가능",
+            });
+        }
+    });
+    return {
+        startPage: opt.startPage,
+        totalBookCount: count,
+        booklist,
+    };
+}
+exports.search = (0, util_1.wrapWithCallback)(searchImpl);
+function getLibraryNames() {
+    return (0, util_1.getLibraryNames)(libraryList);
+}
+({ moduleName: exports.moduleName, homeUrl: exports.homeUrl, search: exports.search, getLibraryNames });
+//# sourceMappingURL=gg.js.map

package/dist/localLibraryModule/gg.js.map

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