naverseries-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 re0nyaa
+
+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

@@ -0,0 +1,158 @@
+# naverseries-sdk
+
+> 네이버 시리즈(series.naver.com) 비공식 TypeScript SDK
+
+[![npm version](https://img.shields.io/npm/v/naverseries-sdk.svg)](https://www.npmjs.com/package/naverseries-sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+- **Undici** 커넥션 풀링 기반 고성능 HTTP
+- **Full-Jitter** 지수백오프 자동 재시도
+- **LRU + TTL** 인메모리 캐시
+- 비동기 제너레이터 **스트리밍 검색** (`searchStream`)
+- 인터셉터 지원 (`onRequest / onResponse / onError / onRetry`)
+- 완전한 **TypeScript** 타입 정의 제공
+
+---
+
+## 설치
+
+```bash
+npm install naverseries-sdk
+# or
+pnpm add naverseries-sdk
+```
+
+---
+
+## 빠른 시작
+
+```typescript
+import NaverSeriesClient from 'naverseries-sdk'
+
+const client = new NaverSeriesClient({
+    cache: true,       // 인메모리 캐시 활성화
+    cacheTtlMs: 60000, // 캐시 TTL 60초
+    maxRetries: 3,     // 최대 재시도 횟수
+    timeout: 10000,    // 요청 타임아웃 10초
+})
+
+// 검색
+const result = await client.search({ keyword: '환생', page: 1 })
+console.log(result.items[0].title) // "66666년 만에 환생한 흑마법사 [독점]"
+
+// TOP 100
+const top100 = await client.getTop100()
+console.log(top100[0].rank, top100[0].title)
+
+// 작품 상세
+const detail = await client.getNovelDetail('5553059')
+console.log(detail.title, detail.authorName)
+
+await client.close()
+```
+
+---
+
+## API
+
+### `new NaverSeriesClient(options?)`
+
+| 옵션 | 타입 | 기본값 | 설명 |
+|---|---|---|---|
+| `cache` | `boolean \| CacheStore` | `false` | 캐시 활성화 또는 커스텀 캐시 |
+| `cacheTtlMs` | `number` | `60000` | 캐시 TTL (ms) |
+| `timeout` | `number` | `10000` | 요청 타임아웃 (ms) |
+| `maxRetries` | `number` | `3` | 최대 재시도 횟수 |
+| `userAgent` | `string` | Chrome UA | 커스텀 User-Agent |
+| `poolOptions` | `ConnectionPoolOptions` | — | Undici 커넥션 풀 설정 |
+| `interceptors` | `Interceptors` | — | 요청/응답 인터셉터 |
+| `logger` | `Logger` | — | 커스텀 로거 |
+
+### 메서드
+
+| 메서드 | 반환 | 설명 |
+|---|---|---|
+| `search(options)` | `SearchResult` | 키워드 검색 (page, type 지원) |
+| `searchStream(options)` | `AsyncIterableIterator` | 스트리밍 검색 제너레이터 |
+| `getTop100()` | `RankingNovelItem[]` | 실시간 TOP 100 랭킹 |
+| `getRankingByGenre(code)` | `RankingNovelItem[]` | 장르별 랭킹 |
+| `getNovelDetail(novelId)` | `NovelDetail` | 작품 상세 정보 |
+| `getEpisodes(novelId)` | `EpisodeListResult` | 에피소드 목록 |
+| `getGenres()` | `CategoryItem[]` | 장르 카테고리 목록 |
+| `getNovelByName(keyword)` | `{ searchItem, detail }` | 이름 검색 + 상세 일괄 조회 |
+| `getCacheStats()` | `CacheStats \| undefined` | 캐시 통계 |
+| `clearCache()` | `void` | 캐시 초기화 |
+| `close()` | `Promise<void>` | 커넥션 풀 종료 |
+
+---
+
+## 사용 예제
+
+### 스트리밍 검색
+
+```typescript
+for await (const novel of client.searchStream({ keyword: '로판', maxPages: 3 })) {
+    console.log(novel.title, novel.authorName)
+}
+```
+
+### 이름으로 바로 상세 조회
+
+```typescript
+const { searchItem, detail } = await client.getNovelByName('전지적 독자 시점')
+console.log(detail.title) // 전지적 독자 시점
+```
+
+### 인터셉터
+
+```typescript
+const client = new NaverSeriesClient({
+    interceptors: {
+        onRequest: ({ url }) => console.log('→', url),
+        onResponse: ({ url, latencyMs }) => console.log('←', url, latencyMs + 'ms'),
+        onError: ({ error }) => console.error(error),
+    }
+})
+```
+
+### 에러 핸들링
+
+```typescript
+import {
+    NaverSeriesNotFoundError,
+    NaverSeriesRateLimitError,
+    NaverSeriesTimeoutError,
+} from 'naverseries-sdk/errors'
+
+try {
+    const detail = await client.getNovelDetail('invalid-id')
+} catch (err) {
+    if (err instanceof NaverSeriesNotFoundError) {
+        console.log('작품 없음')
+    } else if (err instanceof NaverSeriesRateLimitError) {
+        console.log('요청 한도 초과, retryAfter:', err.retryAfterMs)
+    }
+}
+```
+
+### 서브패스 임포트
+
+```typescript
+import { NaverSeriesClient } from 'naverseries-sdk/client'
+import type { NovelDetail, RankingNovelItem } from 'naverseries-sdk/types'
+import { NaverSeriesNotFoundError } from 'naverseries-sdk/errors'
+import { MemoryTtlCache } from 'naverseries-sdk/cache'
+```
+
+---
+
+## 주의사항
+
+이 SDK는 **비공식**이며 네이버 시리즈의 HTML 구조 변경 시 동작하지 않을 수 있습니다.  
+상업적 용도 사용 시 [네이버 이용약관](https://www.naver.com/rules/service.html)을 반드시 확인하세요.
+
+---
+
+## License
+
+[MIT](LICENSE)

package/dist/src/cache.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LRU + TTL 인메모리 캐시 구현체
+ */
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    hitRatio: number;
+    evictions: number;
+    size: number;
+}
+export declare class MemoryTtlCache {
+    private store;
+    private stats;
+    private defaultTtlMs;
+    constructor(options?: {
+        defaultTtlMs?: number;
+    });
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T, ttlMs?: number): void;
+    delete(key: string): void;
+    clear(): void;
+    getStats(): CacheStats;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACf;AAOD,qBAAa,cAAc;IACvB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,YAAY,CAAQ;gBAEhB,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO;IAInD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAgBlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAOnD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;IAKb,QAAQ,IAAI,UAAU;CAUzB"}

package/dist/src/cache.js

@@ -0,0 +1,47 @@
+export class MemoryTtlCache {
+    store = new Map();
+    stats = { hits: 0, misses: 0, evictions: 0 };
+    defaultTtlMs;
+    constructor(options = {}) {
+        this.defaultTtlMs = options.defaultTtlMs ?? 60000;
+    }
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            return undefined;
+        }
+        if (Date.now() > entry.expiresAt) {
+            this.store.delete(key);
+            this.stats.misses++;
+            this.stats.evictions++;
+            return undefined;
+        }
+        this.stats.hits++;
+        return entry.value;
+    }
+    set(key, value, ttlMs) {
+        this.store.set(key, {
+            value,
+            expiresAt: Date.now() + (ttlMs ?? this.defaultTtlMs),
+        });
+    }
+    delete(key) {
+        this.store.delete(key);
+    }
+    clear() {
+        this.store.clear();
+        this.stats = { hits: 0, misses: 0, evictions: 0 };
+    }
+    getStats() {
+        const total = this.stats.hits + this.stats.misses;
+        return {
+            hits: this.stats.hits,
+            misses: this.stats.misses,
+            hitRatio: total === 0 ? 0 : this.stats.hits / total,
+            evictions: this.stats.evictions,
+            size: this.store.size,
+        };
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/src/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,cAAc;IACf,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAA;IAC1C,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAA;IAC5C,YAAY,CAAQ;IAE5B,YAAY,UAAqC,EAAE;QAC/C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAA;IACrD,CAAC;IAED,GAAG,CAAI,GAAW;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAA;YACnB,OAAO,SAAS,CAAA;QACpB,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACtB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAA;YACnB,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAA;YACtB,OAAO,SAAS,CAAA;QACpB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;QACjB,OAAO,KAAK,CAAC,KAAU,CAAA;IAC3B,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAc;QACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAChB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;SACvD,CAAC,CAAA;IACN,CAAC;IAED,MAAM,CAAC,GAAW;QACd,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;IAED,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;QAClB,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAA;IACrD,CAAC;IAED,QAAQ;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;QACjD,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACzB,QAAQ,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK;YACnD,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS;YAC/B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;SACxB,CAAA;IACL,CAAC;CACJ"}

package/dist/src/client.d.ts

@@ -0,0 +1,102 @@
+import type { CacheStats } from "./cache.js";
+import type { CategoryItem, EpisodeListResult, NaverSeriesClientOptions, NovelDetail, NovelSearchResultItem, RankingNovelItem, SearchOptions, SearchResult, SearchStreamOptions } from "./types.js";
+export interface RequestOptions {
+    timeout?: number;
+    maxRetries?: number;
+    skipCache?: boolean;
+    cacheTtlMs?: number;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+/**
+ * 네이버 시리즈(series.naver.com) 비공식 TypeScript 클라이언트
+ *
+ * - Undici 커넥션 풀링
+ * - Full-Jitter 지수백오프 재시도
+ * - LRU+TTL 인메모리 캐시
+ * - 인터셉터 (onRequest / onResponse / onError / onRetry)
+ * - 비동기 제너레이터 스트리밍 검색 (searchStream)
+ */
+export declare class NaverSeriesClient {
+    private baseUrl;
+    private userAgent;
+    private timeoutMs;
+    private maxRetries;
+    private cacheStore?;
+    private cacheTtlMs;
+    private logger?;
+    private interceptors;
+    private dispatcher;
+    constructor(options?: NaverSeriesClientOptions);
+    /**
+     * 저수준 HTTP 요청 (캐시 / 재시도 / 인터셉터 포함)
+     * HTML 응답의 경우 string으로, JSON이면 파싱된 객체로 반환
+     */
+    request<T = string>(endpoint: string, method?: "GET" | "POST", params?: Record<string, any>, options?: RequestOptions): Promise<T>;
+    /**
+     * 소설 / 웹툰 통합 검색
+     * @example
+     * const result = await client.search({ keyword: '환생', page: 1, type: 'novel' })
+     */
+    search(options: SearchOptions, requestOptions?: RequestOptions): Promise<SearchResult>;
+    /**
+     * 검색 결과를 비동기 제너레이터로 스트리밍 순회
+     * @example
+     * for await (const novel of client.searchStream({ keyword: '환생', maxPages: 3 })) {
+     *     console.log(novel.title)
+     * }
+     */
+    searchStream(options: SearchStreamOptions, requestOptions?: RequestOptions): AsyncIterableIterator<NovelSearchResultItem>;
+    /**
+     * 소설 TOP 100 랭킹 조회
+     * @example
+     * const top100 = await client.getTop100()
+     */
+    getTop100(requestOptions?: RequestOptions): Promise<RankingNovelItem[]>;
+    /**
+     * 장르별 랭킹 목록 조회
+     * @param genreCode 장르 코드 (예: "romance", "fantasy", "bl")
+     * @example
+     * const items = await client.getRankingByGenre('romance')
+     */
+    getRankingByGenre(genreCode: string, requestOptions?: RequestOptions): Promise<RankingNovelItem[]>;
+    /** 랭킹 HTML 공통 파서 */
+    private _parseRankingList;
+    /**
+     * 작품 상세 정보 조회
+     * @param novelId productNo (예: "5553059")
+     * @example
+     * const detail = await client.getNovelDetail('5553059')
+     */
+    getNovelDetail(novelId: string | number, requestOptions?: RequestOptions): Promise<NovelDetail>;
+    /**
+     * 작품의 에피소드 목록 조회
+     * @param novelId productNo
+     * @example
+     * const eps = await client.getEpisodes('5553059')
+     */
+    getEpisodes(novelId: string | number, requestOptions?: RequestOptions): Promise<EpisodeListResult>;
+    /**
+     * 장르 카테고리 목록 조회
+     * @example
+     * const genres = await client.getGenres()
+     */
+    getGenres(requestOptions?: RequestOptions): Promise<CategoryItem[]>;
+    /**
+     * 키워드로 검색 후 첫 번째 결과의 상세 정보까지 반환 (편의 메서드)
+     * @example
+     * const { searchItem, detail } = await client.getNovelByName('전지적 독자 시점')
+     */
+    getNovelByName(keyword: string, requestOptions?: RequestOptions): Promise<{
+        searchItem: NovelSearchResultItem;
+        detail: NovelDetail;
+    }>;
+    /** 캐시 통계 반환 */
+    getCacheStats(): CacheStats | undefined;
+    /** 캐시 전체 비우기 */
+    clearCache(): void;
+    /** 커넥션 풀 정상 종료 */
+    close(): Promise<void>;
+}
+export default NaverSeriesClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAW5C,OAAO,KAAK,EAER,YAAY,EAIZ,iBAAiB,EAGjB,wBAAwB,EACxB,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAEhB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACtB,MAAM,YAAY,CAAA;AAwBnB,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,WAAW,CAAA;CACvB;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAY;IAC/B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,UAAU,CAAO;gBAEb,OAAO,GAAE,wBAA6B;IA+BlD;;;OAGG;IACG,OAAO,CAAC,CAAC,GAAG,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,KAAK,GAAG,MAAc,EAC9B,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAChC,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,CAAC,CAAC;IA8Ib;;;;OAIG;IACG,MAAM,CACR,OAAO,EAAE,aAAa,EACtB,cAAc,CAAC,EAAE,cAAc,GAChC,OAAO,CAAC,YAAY,CAAC;IA8CxB;;;;;;OAMG;IACI,YAAY,CACf,OAAO,EAAE,mBAAmB,EAC5B,cAAc,CAAC,EAAE,cAAc,GAChC,qBAAqB,CAAC,qBAAqB,CAAC;IAyB/C;;;;OAIG;IACG,SAAS,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAW7E;;;;;OAKG;IACG,iBAAiB,CACnB,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,cAAc,GAChC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAe9B,oBAAoB;IACpB,OAAO,CAAC,iBAAiB;IAuCzB;;;;;OAKG;IACG,cAAc,CAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,cAAc,CAAC,EAAE,cAAc,GAChC,OAAO,CAAC,WAAW,CAAC;IAyDvB;;;;;OAKG;IACG,WAAW,CACb,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,cAAc,CAAC,EAAE,cAAc,GAChC,OAAO,CAAC,iBAAiB,CAAC;IA2C7B;;;;OAIG;IACG,SAAS,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2BzE;;;;OAIG;IACG,cAAc,CAChB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,cAAc,GAChC,OAAO,CAAC;QAAE,UAAU,EAAE,qBAAqB,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC;IAatE,eAAe;IACf,aAAa,IAAI,UAAU,GAAG,SAAS;IAIvC,gBAAgB;IAChB,UAAU,IAAI,IAAI;IAIlB,kBAAkB;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAED,eAAe,iBAAiB,CAAA"}

package/dist/src/client.js

@@ -0,0 +1,450 @@
+import { Agent, fetch as undiciFetch } from "undici";
+import * as cheerio from "cheerio";
+import { MemoryTtlCache } from "./cache.js";
+import { NaverSeriesApiError, NaverSeriesError, NaverSeriesNetworkError, NaverSeriesNotFoundError, NaverSeriesRateLimitError, NaverSeriesTimeoutError, NaverSeriesValidationError, } from "./errors.js";
+import { withRetry } from "./retry.js";
+// ── 내부 유틸 ────────────────────────────────────────────
+/** href에서 productNo 추출 */
+function extractProductNo(href, base) {
+    try {
+        const u = new URL(href, base);
+        return u.searchParams.get("productNo") ?? "";
+    }
+    catch {
+        return "";
+    }
+}
+/** 제목에서 화수/완결 suffix 제거 */
+function cleanTitle(raw) {
+    return raw
+        .split("\n")[0]
+        .replace(/\(총\s*\d+화.*?\)/g, "")
+        .trim();
+}
+/**
+ * 네이버 시리즈(series.naver.com) 비공식 TypeScript 클라이언트
+ *
+ * - Undici 커넥션 풀링
+ * - Full-Jitter 지수백오프 재시도
+ * - LRU+TTL 인메모리 캐시
+ * - 인터셉터 (onRequest / onResponse / onError / onRetry)
+ * - 비동기 제너레이터 스트리밍 검색 (searchStream)
+ */
+export class NaverSeriesClient {
+    baseUrl;
+    userAgent;
+    timeoutMs;
+    maxRetries;
+    cacheStore;
+    cacheTtlMs;
+    logger;
+    interceptors;
+    dispatcher;
+    constructor(options = {}) {
+        this.baseUrl = (options.baseUrl ?? "https://series.naver.com").replace(/\/+$/, "");
+        this.userAgent =
+            options.userAgent ??
+                "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+        this.timeoutMs = options.timeout ?? 10000;
+        this.maxRetries = options.maxRetries ?? 3;
+        this.cacheTtlMs = options.cacheTtlMs ?? 60000;
+        this.logger = options.logger;
+        this.interceptors = options.interceptors ?? {};
+        if (options.cache === true) {
+            this.cacheStore = new MemoryTtlCache({ defaultTtlMs: this.cacheTtlMs });
+        }
+        else if (options.cache && typeof options.cache === "object") {
+            this.cacheStore = options.cache;
+        }
+        const pool = options.poolOptions ?? {};
+        this.dispatcher = new Agent({
+            connections: pool.connections ?? 128,
+            pipelining: pool.pipelining ?? 10,
+            keepAliveTimeout: pool.keepAliveTimeout ?? 30000,
+            keepAliveMaxTimeout: pool.keepAliveMaxTimeout ?? 600000,
+            connect: { timeout: pool.connectTimeout ?? 10000 },
+        });
+    }
+    // ── 저수준 HTTP ───────────────────────────────────────
+    /**
+     * 저수준 HTTP 요청 (캐시 / 재시도 / 인터셉터 포함)
+     * HTML 응답의 경우 string으로, JSON이면 파싱된 객체로 반환
+     */
+    async request(endpoint, method = "GET", params = {}, options = {}) {
+        let fullUrl = endpoint.startsWith("http")
+            ? endpoint
+            : `${this.baseUrl}${endpoint.startsWith("/") ? "" : "/"}${endpoint}`;
+        const defaultHeaders = {
+            "User-Agent": this.userAgent,
+            Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+            "Accept-Language": "ko-KR,ko;q=0.9",
+            Referer: `${this.baseUrl}/`,
+            ...options.headers,
+        };
+        if (method === "GET" && Object.keys(params).length > 0) {
+            const urlObj = new URL(fullUrl);
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined && v !== null)
+                    urlObj.searchParams.append(k, String(v));
+            }
+            fullUrl = urlObj.toString();
+        }
+        const cacheKey = `${method}:${fullUrl}`;
+        if (method === "GET" && !options.skipCache && this.cacheStore) {
+            const cached = this.cacheStore.get(cacheKey);
+            if (cached !== undefined) {
+                this.logger?.debug(`[Cache HIT] ${fullUrl}`);
+                return cached;
+            }
+        }
+        const timeoutMs = options.timeout ?? this.timeoutMs;
+        const maxRetries = options.maxRetries ?? this.maxRetries;
+        const execute = async () => {
+            const controller = new AbortController();
+            let timerId;
+            const startTime = Date.now();
+            if (timeoutMs > 0) {
+                timerId = setTimeout(() => controller.abort(), timeoutMs);
+            }
+            const signal = options.signal
+                ? typeof AbortSignal.any === "function"
+                    ? AbortSignal.any([options.signal, controller.signal])
+                    : controller.signal
+                : controller.signal;
+            try {
+                if (this.interceptors.onRequest) {
+                    await this.interceptors.onRequest({
+                        url: fullUrl,
+                        headers: defaultHeaders,
+                        params,
+                        timestamp: startTime,
+                    });
+                }
+                this.logger?.debug(`[HTTP ${method}] ${fullUrl}`);
+                const res = await undiciFetch(fullUrl, {
+                    method,
+                    headers: defaultHeaders,
+                    body: method === "POST" ? JSON.stringify(params) : undefined,
+                    signal,
+                    dispatcher: this.dispatcher,
+                });
+                const latencyMs = Date.now() - startTime;
+                if (timerId)
+                    clearTimeout(timerId);
+                if (res.status === 404) {
+                    throw new NaverSeriesNotFoundError(`리소스 없음: ${fullUrl}`, undefined, fullUrl);
+                }
+                if (res.status === 429) {
+                    const retryAfter = res.headers.get("retry-after");
+                    throw new NaverSeriesRateLimitError("요청 한도 초과 (429)", retryAfter ? parseInt(retryAfter, 10) * 1000 : undefined, fullUrl);
+                }
+                const text = await res.text();
+                if (!res.ok) {
+                    throw new NaverSeriesApiError(`HTTP ${res.status}`, res.status, undefined, text, fullUrl);
+                }
+                // JSON 시도 → 실패 시 raw text 반환
+                let responseData = text;
+                try {
+                    responseData = JSON.parse(text);
+                }
+                catch { /* HTML 응답 */ }
+                if (this.interceptors.onResponse) {
+                    await this.interceptors.onResponse({
+                        url: fullUrl,
+                        status: res.status,
+                        data: responseData,
+                        latencyMs,
+                        fromCache: false,
+                    });
+                }
+                if (method === "GET" && !options.skipCache && this.cacheStore) {
+                    this.cacheStore.set(cacheKey, responseData, options.cacheTtlMs ?? this.cacheTtlMs);
+                }
+                return responseData;
+            }
+            catch (err) {
+                const latencyMs = Date.now() - startTime;
+                if (timerId)
+                    clearTimeout(timerId);
+                let finalError;
+                if (err.name === "AbortError" || controller.signal.aborted) {
+                    finalError = new NaverSeriesTimeoutError(`요청 시간 초과 (${timeoutMs}ms)`, timeoutMs, fullUrl);
+                }
+                else if (err instanceof NaverSeriesError) {
+                    finalError = err;
+                }
+                else {
+                    finalError = new NaverSeriesNetworkError(err.message ?? "네트워크 오류", err, fullUrl);
+                }
+                if (this.interceptors.onError) {
+                    await this.interceptors.onError({ url: fullUrl, error: finalError, latencyMs });
+                }
+                throw finalError;
+            }
+        };
+        return withRetry(execute, {
+            maxRetries,
+            baseDelayMs: 300,
+            maxDelayMs: 3000,
+            logger: this.logger,
+            onRetry: this.interceptors.onRetry,
+            url: fullUrl,
+        });
+    }
+    // ── 검색 ─────────────────────────────────────────────
+    /**
+     * 소설 / 웹툰 통합 검색
+     * @example
+     * const result = await client.search({ keyword: '환생', page: 1, type: 'novel' })
+     */
+    async search(options, requestOptions) {
+        if (!options.keyword?.trim()) {
+            throw new NaverSeriesValidationError("keyword는 필수 값입니다.", "keyword");
+        }
+        const type = options.type ?? "novel";
+        const html = await this.request("/search/search.series", "GET", { t: type, q: options.keyword.trim(), page: options.page ?? 1 }, requestOptions);
+        const $ = cheerio.load(html);
+        const items = [];
+        $(".lst_list li").each((_, el) => {
+            const $el = $(el);
+            const href = $el.find("h3 a").attr("href") ?? "";
+            const rawTitle = $el.find("h3 a").text().trim();
+            // 총 N화/완결 파싱
+            const epMatch = rawTitle.match(/총\s*(\d+)화/);
+            const isComplete = rawTitle.includes("완결");
+            const item = {
+                novelId: extractProductNo(href, this.baseUrl),
+                title: cleanTitle(rawTitle),
+                authorName: $el.find(".author").text().trim(),
+                score: $el.find("em.score_num").text().trim() || undefined,
+                updatedAt: $el.find(".date").text().trim() || undefined,
+                episodeCount: epMatch ? parseInt(epMatch[1], 10) : undefined,
+                isComplete,
+                thumbnailUrl: $el.find(".pic img").attr("src") ?? undefined,
+                freeLabel: $el.find("em.ico_onlyfree2, em.ico_free").text().trim() || undefined,
+                link: href ? `${this.baseUrl}${href}` : "",
+            };
+            items.push(item);
+        });
+        // 다음 페이지 여부: 페이지네이션이 JS 렌더링이어서 아이템 수로 추론
+        const hasNext = items.length >= 20;
+        return { items, hasNext };
+    }
+    /**
+     * 검색 결과를 비동기 제너레이터로 스트리밍 순회
+     * @example
+     * for await (const novel of client.searchStream({ keyword: '환생', maxPages: 3 })) {
+     *     console.log(novel.title)
+     * }
+     */
+    async *searchStream(options, requestOptions) {
+        if (!options.keyword?.trim()) {
+            throw new NaverSeriesValidationError("keyword는 필수 값입니다.", "keyword");
+        }
+        let page = 1;
+        const maxPages = options.maxPages ?? Number.MAX_SAFE_INTEGER;
+        while (page <= maxPages) {
+            const result = await this.search({ keyword: options.keyword, page, type: options.type }, requestOptions);
+            if (result.items.length === 0)
+                break;
+            for (const item of result.items)
+                yield item;
+            if (!result.hasNext)
+                break;
+            page++;
+        }
+    }
+    // ── 랭킹 ─────────────────────────────────────────────
+    /**
+     * 소설 TOP 100 랭킹 조회
+     * @example
+     * const top100 = await client.getTop100()
+     */
+    async getTop100(requestOptions) {
+        const html = await this.request("/novel/top100List.series", "GET", {}, requestOptions);
+        return this._parseRankingList(html);
+    }
+    /**
+     * 장르별 랭킹 목록 조회
+     * @param genreCode 장르 코드 (예: "romance", "fantasy", "bl")
+     * @example
+     * const items = await client.getRankingByGenre('romance')
+     */
+    async getRankingByGenre(genreCode, requestOptions) {
+        if (!genreCode?.trim()) {
+            throw new NaverSeriesValidationError("genreCode는 필수 값입니다.", "genreCode");
+        }
+        const html = await this.request(`/novel/categoryList.series`, "GET", { categoryTypeCode: genreCode }, requestOptions);
+        return this._parseRankingList(html);
+    }
+    /** 랭킹 HTML 공통 파서 */
+    _parseRankingList(html) {
+        const $ = cheerio.load(html);
+        const items = [];
+        $(".comic_top_lst li, .lst_type1 li").each((i, el) => {
+            const $el = $(el);
+            const href = $el.find("a.pic").attr("href") ?? $el.find("h3 a").attr("href") ?? "";
+            const rawTitle = ($el.find("h3 a").text() || $el.find(".tit").text()).trim();
+            // 순위 변동 파악
+            let rankChange;
+            if ($el.find(".ico_new, .new").length)
+                rankChange = "new";
+            else if ($el.find(".ico_up, .up").length)
+                rankChange = "up";
+            else if ($el.find(".ico_down, .down").length)
+                rankChange = "down";
+            else
+                rankChange = "same";
+            // 순위 번호
+            const rankText = $el.find(".top_num em, .no1, .no2, .no3").text().trim();
+            const rank = rankText ? parseInt(rankText, 10) : i + 1;
+            items.push({
+                rank,
+                novelId: extractProductNo(href, this.baseUrl),
+                title: cleanTitle(rawTitle),
+                authorName: $el.find(".author").text().trim(),
+                score: $el.find("em.score_num").text().trim() || undefined,
+                thumbnailUrl: $el.find(".pic img").attr("src") ?? undefined,
+                rankChange,
+                isNew: rankChange === "new",
+                freeLabel: $el.find("em.ico_onlyfree2, em.ico_free").text().trim() || undefined,
+                link: href ? `${this.baseUrl}${href}` : "",
+            });
+        });
+        return items;
+    }
+    // ── 작품 상세 ─────────────────────────────────────────
+    /**
+     * 작품 상세 정보 조회
+     * @param novelId productNo (예: "5553059")
+     * @example
+     * const detail = await client.getNovelDetail('5553059')
+     */
+    async getNovelDetail(novelId, requestOptions) {
+        if (!novelId) {
+            throw new NaverSeriesValidationError("novelId는 필수 값입니다.", "novelId");
+        }
+        const html = await this.request(`/novel/detail.series`, "GET", { productNo: String(novelId) }, requestOptions);
+        const $ = cheerio.load(html);
+        // 제목: <title> 태그에서 가장 정확하게 추출
+        const pageTitle = $("title").text().trim();
+        // "작품명 : 네이버 시리즈" 형식에서 추출
+        const title = pageTitle.split(":")[0].trim();
+        const authorName = $(".author").first().text().trim();
+        const score = $("em.score_num").first().text().trim() || undefined;
+        // 설명문 - JS 렌더링 전에도 일부 포함될 수 있음
+        const description = $(".dsc_txt, p.txt, .desc").first().text().trim() || undefined;
+        // 장르
+        const genres = [];
+        $(".genre_area a, .category a").each((_, el) => {
+            const g = $(el).text().trim();
+            if (g)
+                genres.push(g);
+        });
+        // 에피소드 수/완결 여부
+        const epContainer = $("[class*='episode'], .ep_count, .lst_view").first();
+        const episodeCountText = $("dt:contains('총 회차') + dd, .total_episode").text().trim();
+        const epMatch = episodeCountText.match(/\d+/);
+        const episodeCount = epMatch ? parseInt(epMatch[0], 10) : undefined;
+        const isComplete = html.includes("완결") || html.includes("complete");
+        const thumbnailUrl = $(".book_area img, .pic img").first().attr("src") ?? undefined;
+        return {
+            novelId: String(novelId),
+            title,
+            authorName,
+            score,
+            description,
+            thumbnailUrl,
+            genres: genres.length > 0 ? genres : undefined,
+            isComplete,
+            episodeCount,
+            link: `${this.baseUrl}/novel/detail.series?productNo=${novelId}`,
+        };
+    }
+    // ── 에피소드 목록 ─────────────────────────────────────
+    /**
+     * 작품의 에피소드 목록 조회
+     * @param novelId productNo
+     * @example
+     * const eps = await client.getEpisodes('5553059')
+     */
+    async getEpisodes(novelId, requestOptions) {
+        if (!novelId) {
+            throw new NaverSeriesValidationError("novelId는 필수 값입니다.", "novelId");
+        }
+        const html = await this.request(`/novel/detail.series`, "GET", { productNo: String(novelId) }, requestOptions);
+        const $ = cheerio.load(html);
+        const items = [];
+        $("[class*='episode'] li, .lst_view li").each((i, el) => {
+            const $el = $(el);
+            const href = $el.find("a").first().attr("href") ?? "";
+            const title = $el.find(".title, a").first().text().trim();
+            const isFree = $el.find(".free, .ico_free, em.free").length > 0 ||
+                $el.find("em.ico_onlyfree2").length > 0;
+            const uploadedAt = $el.find(".date").text().trim() || undefined;
+            if (!title)
+                return;
+            items.push({
+                episodeId: href
+                    ? (new URL(href, this.baseUrl).searchParams.get("no") ?? undefined)
+                    : undefined,
+                title,
+                link: href.startsWith("http") ? href : `${this.baseUrl}${href}`,
+                isFree,
+                uploadedAt,
+                episodeNumber: i + 1,
+            });
+        });
+        return { novelId: String(novelId), items };
+    }
+    // ── 카테고리 / 장르 ───────────────────────────────────
+    /**
+     * 장르 카테고리 목록 조회
+     * @example
+     * const genres = await client.getGenres()
+     */
+    async getGenres(requestOptions) {
+        const html = await this.request("/novel/categoryList.series", "GET", { categoryTypeCode: "genre" }, requestOptions);
+        const $ = cheerio.load(html);
+        const items = [];
+        $(".category_area li a, .gnb_sub a").each((_, el) => {
+            const name = $(el).text().trim();
+            const href = $(el).attr("href") ?? "";
+            if (!name || !href)
+                return;
+            const code = new URL(href, this.baseUrl).searchParams.get("categoryTypeCode") ?? href;
+            items.push({ name, code, link: `${this.baseUrl}${href}` });
+        });
+        return items;
+    }
+    // ── 이름으로 검색 → 상세 일괄 ─────────────────────────
+    /**
+     * 키워드로 검색 후 첫 번째 결과의 상세 정보까지 반환 (편의 메서드)
+     * @example
+     * const { searchItem, detail } = await client.getNovelByName('전지적 독자 시점')
+     */
+    async getNovelByName(keyword, requestOptions) {
+        const result = await this.search({ keyword, page: 1 }, requestOptions);
+        if (result.items.length === 0) {
+            throw new NaverSeriesNotFoundError(`"${keyword}"에 해당하는 작품을 찾지 못했습니다.`);
+        }
+        const searchItem = result.items[0];
+        const detail = await this.getNovelDetail(searchItem.novelId, requestOptions);
+        return { searchItem, detail };
+    }
+    // ── 캐시 / 리소스 ─────────────────────────────────────
+    /** 캐시 통계 반환 */
+    getCacheStats() {
+        return this.cacheStore?.getStats ? this.cacheStore.getStats() : undefined;
+    }
+    /** 캐시 전체 비우기 */
+    clearCache() {
+        this.cacheStore?.clear();
+    }
+    /** 커넥션 풀 정상 종료 */
+    async close() {
+        await this.dispatcher.close();
+    }
+}
+export default NaverSeriesClient;
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

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

package/dist/src/errors.d.ts

@@ -0,0 +1,30 @@
+export declare class NaverSeriesError extends Error {
+    readonly cause?: (Error | unknown) | undefined;
+    readonly url?: string | undefined;
+    constructor(message: string, cause?: (Error | unknown) | undefined, url?: string | undefined);
+}
+export declare class NaverSeriesApiError extends NaverSeriesError {
+    readonly statusCode?: number | undefined;
+    readonly errorCode?: string | number | undefined;
+    readonly rawData?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, errorCode?: string | number | undefined, rawData?: any | undefined, url?: string);
+}
+export declare class NaverSeriesNetworkError extends NaverSeriesError {
+    constructor(message: string, cause?: Error | unknown, url?: string);
+}
+export declare class NaverSeriesTimeoutError extends NaverSeriesError {
+    readonly timeoutMs?: number | undefined;
+    constructor(message: string, timeoutMs?: number | undefined, url?: string);
+}
+export declare class NaverSeriesNotFoundError extends NaverSeriesError {
+    constructor(message: string, cause?: Error | unknown, url?: string);
+}
+export declare class NaverSeriesRateLimitError extends NaverSeriesError {
+    readonly retryAfterMs?: number | undefined;
+    constructor(message: string, retryAfterMs?: number | undefined, url?: string);
+}
+export declare class NaverSeriesValidationError extends NaverSeriesError {
+    readonly field?: string | undefined;
+    constructor(message: string, field?: string | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAiB,SAAQ,KAAK;aAGnB,KAAK,CAAC,GAAE,KAAK,GAAG,OAAO;aACvB,GAAG,CAAC,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,GAAE,KAAK,GAAG,OAAO,aAAA,EACvB,GAAG,CAAC,EAAE,MAAM,YAAA;CAKnC;AAED,qBAAa,mBAAoB,SAAQ,gBAAgB;aAGjC,UAAU,CAAC,EAAE,MAAM;aACnB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;aAC3B,OAAO,CAAC,EAAE,GAAG;gBAH7B,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,YAAA,EAC3B,OAAO,CAAC,EAAE,GAAG,YAAA,EAC7B,GAAG,CAAC,EAAE,MAAM;CAKnB;AAED,qBAAa,uBAAwB,SAAQ,gBAAgB;gBAC7C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM;CAIrE;AAED,qBAAa,uBAAwB,SAAQ,gBAAgB;aACZ,SAAS,CAAC,EAAE,MAAM;gBAAnD,OAAO,EAAE,MAAM,EAAkB,SAAS,CAAC,EAAE,MAAM,YAAA,EAAE,GAAG,CAAC,EAAE,MAAM;CAIhF;AAED,qBAAa,wBAAyB,SAAQ,gBAAgB;gBAC9C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM;CAIrE;AAED,qBAAa,yBAA0B,SAAQ,gBAAgB;aAGvC,YAAY,CAAC,EAAE,MAAM;gBADrC,OAAO,EAAE,MAAM,EACC,YAAY,CAAC,EAAE,MAAM,YAAA,EACrC,GAAG,CAAC,EAAE,MAAM;CAKnB;AAED,qBAAa,0BAA2B,SAAQ,gBAAgB;aACf,KAAK,CAAC,EAAE,MAAM;gBAA/C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,MAAM,YAAA;CAI9D"}

package/dist/src/errors.js

@@ -0,0 +1,59 @@
+export class NaverSeriesError extends Error {
+    cause;
+    url;
+    constructor(message, cause, url) {
+        super(message);
+        this.cause = cause;
+        this.url = url;
+        this.name = "NaverSeriesError";
+    }
+}
+export class NaverSeriesApiError extends NaverSeriesError {
+    statusCode;
+    errorCode;
+    rawData;
+    constructor(message, statusCode, errorCode, rawData, url) {
+        super(message, undefined, url);
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+        this.rawData = rawData;
+        this.name = "NaverSeriesApiError";
+    }
+}
+export class NaverSeriesNetworkError extends NaverSeriesError {
+    constructor(message, cause, url) {
+        super(message, cause, url);
+        this.name = "NaverSeriesNetworkError";
+    }
+}
+export class NaverSeriesTimeoutError extends NaverSeriesError {
+    timeoutMs;
+    constructor(message, timeoutMs, url) {
+        super(message, undefined, url);
+        this.timeoutMs = timeoutMs;
+        this.name = "NaverSeriesTimeoutError";
+    }
+}
+export class NaverSeriesNotFoundError extends NaverSeriesError {
+    constructor(message, cause, url) {
+        super(message, cause, url);
+        this.name = "NaverSeriesNotFoundError";
+    }
+}
+export class NaverSeriesRateLimitError extends NaverSeriesError {
+    retryAfterMs;
+    constructor(message, retryAfterMs, url) {
+        super(message, undefined, url);
+        this.retryAfterMs = retryAfterMs;
+        this.name = "NaverSeriesRateLimitError";
+    }
+}
+export class NaverSeriesValidationError extends NaverSeriesError {
+    field;
+    constructor(message, field) {
+        super(message);
+        this.field = field;
+        this.name = "NaverSeriesValidationError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGnB;IACA;IAHpB,YACI,OAAe,EACC,KAAuB,EACvB,GAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,UAAK,GAAL,KAAK,CAAkB;QACvB,QAAG,GAAH,GAAG,CAAS;QAG5B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAClC,CAAC;CACJ;AAED,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IAGjC;IACA;IACA;IAJpB,YACI,OAAe,EACC,UAAmB,EACnB,SAA2B,EAC3B,OAAa,EAC7B,GAAY;QAEZ,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAA;QALd,eAAU,GAAV,UAAU,CAAS;QACnB,cAAS,GAAT,SAAS,CAAkB;QAC3B,YAAO,GAAP,OAAO,CAAM;QAI7B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACrC,CAAC;CACJ;AAED,MAAM,OAAO,uBAAwB,SAAQ,gBAAgB;IACzD,YAAY,OAAe,EAAE,KAAuB,EAAE,GAAY;QAC9D,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACzC,CAAC;CACJ;AAED,MAAM,OAAO,uBAAwB,SAAQ,gBAAgB;IACZ;IAA7C,YAAY,OAAe,EAAkB,SAAkB,EAAE,GAAY;QACzE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAA;QADW,cAAS,GAAT,SAAS,CAAS;QAE3D,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACzC,CAAC;CACJ;AAED,MAAM,OAAO,wBAAyB,SAAQ,gBAAgB;IAC1D,YAAY,OAAe,EAAE,KAAuB,EAAE,GAAY;QAC9D,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;IAC1C,CAAC;CACJ;AAED,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAGvC;IAFpB,YACI,OAAe,EACC,YAAqB,EACrC,GAAY;QAEZ,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAA;QAHd,iBAAY,GAAZ,YAAY,CAAS;QAIrC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;IAC3C,CAAC;CACJ;AAED,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IACf;IAA7C,YAAY,OAAe,EAAkB,KAAc;QACvD,KAAK,CAAC,OAAO,CAAC,CAAA;QAD2B,UAAK,GAAL,KAAK,CAAS;QAEvD,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;IAC5C,CAAC;CACJ"}

package/dist/src/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./cache.js";
+export * from "./retry.js";
+export * from "./client.js";
+import { NaverSeriesClient } from "./client.js";
+export default NaverSeriesClient;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,eAAe,iBAAiB,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./cache.js";
+export * from "./retry.js";
+export * from "./client.js";
+import { NaverSeriesClient } from "./client.js";
+export default NaverSeriesClient;
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,eAAe,iBAAiB,CAAA"}

package/dist/src/retry.d.ts

@@ -0,0 +1,11 @@
+import { Logger } from "./types.js";
+export interface RetryOptions {
+    maxRetries: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    logger?: Logger;
+    onRetry?: (error: Error, attempt: number, delayMs: number) => Promise<void> | void;
+    url?: string;
+}
+export declare function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/src/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEnC,MAAM,WAAW,YAAY;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAClF,GAAG,CAAC,EAAE,MAAM,CAAA;CACf;AAeD,wBAAsB,SAAS,CAAC,CAAC,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,YAAY,GACtB,OAAO,CAAC,CAAC,CAAC,CAyBZ"}

package/dist/src/retry.js

@@ -0,0 +1,36 @@
+function isRetryable(err) {
+    // 429, 5xx, 네트워크 에러 재시도
+    if (err?.statusCode && err.statusCode < 500 && err.statusCode !== 429)
+        return false;
+    if (err?.name === "NaverSeriesNotFoundError")
+        return false;
+    if (err?.name === "NaverSeriesValidationError")
+        return false;
+    return true;
+}
+function fullJitterDelay(base, max, attempt) {
+    const cap = Math.min(max, base * 2 ** attempt);
+    return Math.random() * cap;
+}
+export async function withRetry(fn, options) {
+    const { maxRetries, baseDelayMs = 300, maxDelayMs = 3000, logger, onRetry, url } = options;
+    let lastError = new Error("unknown");
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            if (attempt >= maxRetries || !isRetryable(err)) {
+                throw lastError;
+            }
+            const delayMs = fullJitterDelay(baseDelayMs, maxDelayMs, attempt);
+            logger?.warn(`[Retry ${attempt + 1}/${maxRetries}] ${url ?? ""} - ${lastError.message} (delay: ${delayMs.toFixed(0)}ms)`);
+            if (onRetry)
+                await onRetry(lastError, attempt + 1, delayMs);
+            await new Promise((r) => setTimeout(r, delayMs));
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/src/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"AAYA,SAAS,WAAW,CAAC,GAAQ;IACzB,wBAAwB;IACxB,IAAI,GAAG,EAAE,UAAU,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG;QAAE,OAAO,KAAK,CAAA;IACnF,IAAI,GAAG,EAAE,IAAI,KAAK,0BAA0B;QAAE,OAAO,KAAK,CAAA;IAC1D,IAAI,GAAG,EAAE,IAAI,KAAK,4BAA4B;QAAE,OAAO,KAAK,CAAA;IAC5D,OAAO,IAAI,CAAA;AACf,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,GAAW,EAAE,OAAe;IAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,IAAI,OAAO,CAAC,CAAA;IAC9C,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAA;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,EAAoB,EACpB,OAAqB;IAErB,MAAM,EAAE,UAAU,EAAE,WAAW,GAAG,GAAG,EAAE,UAAU,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAA;IAC1F,IAAI,SAAS,GAAU,IAAI,KAAK,CAAC,SAAS,CAAC,CAAA;IAE3C,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAA;QACrB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YAE/D,IAAI,OAAO,IAAI,UAAU,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7C,MAAM,SAAS,CAAA;YACnB,CAAC;YAED,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;YACjE,MAAM,EAAE,IAAI,CACR,UAAU,OAAO,GAAG,CAAC,IAAI,UAAU,KAAK,GAAG,IAAI,EAAE,MAAM,SAAS,CAAC,OAAO,YAAY,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC9G,CAAA;YAED,IAAI,OAAO;gBAAE,MAAM,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,CAAC,CAAA;YAC3D,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;QACpD,CAAC;IACL,CAAC;IAED,MAAM,SAAS,CAAA;AACnB,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,125 @@
+export interface Logger {
+    debug(message: string, ...meta: any[]): void;
+    info(message: string, ...meta: any[]): void;
+    warn(message: string, ...meta: any[]): void;
+    error(message: string, ...meta: any[]): void;
+}
+export interface Interceptors {
+    onRequest?: (req: RequestContext) => Promise<void> | void;
+    onResponse?: (res: ResponseContext) => Promise<void> | void;
+    onError?: (ctx: ErrorContext) => Promise<void> | void;
+    onRetry?: (error: Error, attempt: number, delayMs: number) => Promise<void> | void;
+}
+export interface RequestContext {
+    url: string;
+    headers: Record<string, string>;
+    params: Record<string, any>;
+    timestamp: number;
+}
+export interface ResponseContext {
+    url: string;
+    status: number;
+    data: any;
+    latencyMs: number;
+    fromCache: boolean;
+}
+export interface ErrorContext {
+    url: string;
+    error: Error;
+    latencyMs: number;
+}
+export interface ConnectionPoolOptions {
+    connections?: number;
+    pipelining?: number;
+    keepAliveTimeout?: number;
+    keepAliveMaxTimeout?: number;
+    connectTimeout?: number;
+}
+export interface CacheStore {
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T, ttlMs?: number): void;
+    delete(key: string): void;
+    clear(): void;
+    getStats?(): import("./cache.js").CacheStats;
+}
+export interface NaverSeriesClientOptions {
+    baseUrl?: string;
+    userAgent?: string;
+    timeout?: number;
+    maxRetries?: number;
+    cache?: boolean | CacheStore;
+    cacheTtlMs?: number;
+    logger?: Logger;
+    interceptors?: Interceptors;
+    poolOptions?: ConnectionPoolOptions;
+}
+export type ContentType = 'novel' | 'webtoon' | 'all';
+export interface SearchOptions {
+    keyword: string;
+    page?: number;
+    type?: ContentType;
+}
+export interface SearchStreamOptions {
+    keyword: string;
+    maxPages?: number;
+    type?: ContentType;
+}
+export interface NovelSearchResultItem {
+    novelId: string;
+    title: string;
+    authorName: string;
+    score?: string;
+    updatedAt?: string;
+    episodeCount?: number;
+    isComplete?: boolean;
+    thumbnailUrl?: string;
+    freeLabel?: string;
+    link: string;
+}
+export interface SearchResult {
+    items: NovelSearchResultItem[];
+    hasNext: boolean;
+}
+export type RankingType = 'top100' | 'daily' | 'weekly' | 'monthly';
+export interface RankingNovelItem {
+    rank: number;
+    novelId: string;
+    title: string;
+    authorName: string;
+    score?: string;
+    thumbnailUrl?: string;
+    rankChange?: 'up' | 'down' | 'new' | 'same';
+    isNew?: boolean;
+    freeLabel?: string;
+    link: string;
+}
+export interface NovelDetail {
+    novelId: string;
+    title: string;
+    authorName: string;
+    score?: string;
+    description?: string;
+    thumbnailUrl?: string;
+    genres?: string[];
+    isComplete?: boolean;
+    episodeCount?: number;
+    link: string;
+}
+export interface EpisodeItem {
+    episodeId?: string;
+    title: string;
+    link: string;
+    isFree: boolean;
+    uploadedAt?: string;
+    episodeNumber?: number;
+}
+export interface EpisodeListResult {
+    novelId: string;
+    items: EpisodeItem[];
+}
+export interface CategoryItem {
+    name: string;
+    code: string;
+    link: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

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

package/dist/src/types.js.map

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

package/package.json

@@ -0,0 +1,86 @@
+{
+    "name": "naverseries-sdk",
+    "version": "1.0.0",
+    "description": "네이버 시리즈 비공식 TypeScript API 클라이언트",
+    "type": "module",
+    "main": "./dist/src/index.js",
+    "types": "./dist/src/index.d.ts",
+    "module": "./dist/src/index.js",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/re0nyaa/naverseries-sdk.git"
+    },
+    "bugs": {
+        "url": "https://github.com/re0nyaa/naverseries-sdk/issues"
+    },
+    "homepage": "https://github.com/re0nyaa/naverseries-sdk#readme",
+    "keywords": [
+        "naver",
+        "series",
+        "naver-series",
+        "novel",
+        "webtoon",
+        "sdk",
+        "scraper",
+        "typescript",
+        "api"
+    ],
+    "author": "re0nyaa",
+    "license": "MIT",
+    "exports": {
+        ".": {
+            "types": "./dist/src/index.d.ts",
+            "import": "./dist/src/index.js",
+            "require": "./dist/src/index.js"
+        },
+        "./client": {
+            "types": "./dist/src/client.d.ts",
+            "import": "./dist/src/client.js",
+            "require": "./dist/src/client.js"
+        },
+        "./types": {
+            "types": "./dist/src/types.d.ts",
+            "import": "./dist/src/types.js",
+            "require": "./dist/src/types.js"
+        },
+        "./errors": {
+            "types": "./dist/src/errors.d.ts",
+            "import": "./dist/src/errors.js",
+            "require": "./dist/src/errors.js"
+        },
+        "./cache": {
+            "types": "./dist/src/cache.d.ts",
+            "import": "./dist/src/cache.js",
+            "require": "./dist/src/cache.js"
+        },
+        "./retry": {
+            "types": "./dist/src/retry.d.ts",
+            "import": "./dist/src/retry.js",
+            "require": "./dist/src/retry.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "prepublishOnly": "pnpm build",
+        "start": "node --import tsx/esm demo.ts",
+        "demo": "node --import tsx/esm demo.ts",
+        "build": "tsc -p tsconfig.build.json",
+        "typecheck": "tsc --noEmit"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "dependencies": {
+        "cheerio": "^1.0.0",
+        "undici": "^6.21.1"
+    },
+    "devDependencies": {
+        "@types/node": "^22.0.0",
+        "tsx": "^4.23.15",
+        "typescript": "^5.5.0"
+    }
+}