@kongyo2/nicotag-api 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kongyo2
+
+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,118 @@
+# @kongyo2/nicotag-api
+
+ニコニコ動画（nicovideo.jp）の動画 ID からタグ一覧を取得する非公式クライアントです。
+
+## 特徴
+
+- 動画 ID（`sm` / `nm` / `so` プレフィックス）の入力からタグ配列を取得
+- 4 種類の抽出器を順番に試行する多段フォールバック（cheerio → node-html-parser → 正規表現 2 種）
+- リトライ（指数バックオフ + ジッター）、タイムアウト、`AbortSignal` 対応
+- Zod による型安全なレスポンス検証
+- ランタイム依存は `zod` / `cheerio` / `node-html-parser` / `he` のみ
+- TypeScript ファースト・ESM 専用
+
+## 要件
+
+- Node.js >= 20
+
+## インストール
+
+```bash
+npm install @kongyo2/nicotag-api
+```
+
+## 使い方
+
+### タグ名一覧だけ欲しい
+
+```ts
+import { fetchVideoTags } from '@kongyo2/nicotag-api';
+
+const result = await fetchVideoTags({ videoId: 'sm9' });
+
+console.log(result.tagNames);
+// 例: ['陰陽師', 'レッツゴー！陰陽師', 'ニコニコ動画', ...]
+
+for (const tag of result.tags) {
+  console.log(tag.name, tag.isCategory, tag.isLocked);
+}
+```
+
+### 動画情報も含めて取得
+
+```ts
+import { fetchVideo } from '@kongyo2/nicotag-api';
+
+const result = await fetchVideo({ videoId: 'sm9' });
+
+console.log(result.video.title);           // 動画タイトル
+console.log(result.video.count?.view);     // 再生数
+console.log(result.tag.items.length);      // タグ数
+```
+
+### HTTP オプション（タイムアウト・リトライ・中断）
+
+```ts
+const ac = new AbortController();
+setTimeout(() => ac.abort(), 5_000);
+
+await fetchVideoTags({
+  videoId: 'sm9',
+  http: {
+    timeoutMs: 10_000,
+    signal: ac.signal,
+    retry: { maxRetries: 3, initialDelayMs: 500 },
+    userAgent: 'my-app/1.0',
+  },
+});
+```
+
+### HTML のみをパース（取得は自前で行う場合）
+
+```ts
+import { extractAndParse } from '@kongyo2/nicotag-api';
+
+const html = await (await fetch('https://www.nicovideo.jp/watch/sm9')).text();
+const { parsed, extractorUsed } = extractAndParse(html);
+
+console.log(parsed.data.response.tag.items);
+```
+
+## 動画 ID
+
+`sm` / `nm` / `so` で始まり、後ろが数字のもののみ受け付けます（例: `sm9`, `nm12345`, `so9876`）。
+不正な ID を渡した場合は `InvalidVideoIdError` が送出されます。
+
+## エラー
+
+すべての例外は `NicoTagError` のサブクラスとして送出されます。
+
+| クラス | 用途 |
+| --- | --- |
+| `InvalidVideoIdError` | 動画 ID が `/^(sm\|nm\|so)\d+$/` に一致しない |
+| `FetchError` | HTTP エラー / ネットワーク失敗 |
+| `TimeoutError` | タイムアウト |
+| `AbortError` | ユーザー側からの中断 |
+| `ExtractError` | 全抽出器が失敗（各試行内容は `attempts` に格納） |
+| `ParseError` | JSON のパース失敗 |
+| `ValidationError` | Zod スキーマ検証失敗（`issues` を含む） |
+
+## 開発
+
+```bash
+npm install
+npm run typecheck
+npm run lint
+npm test
+npm run build
+```
+
+ライブテスト（実際の nicovideo.jp にアクセス）:
+
+```bash
+NICOTAG_LIVE=1 npm run test:live
+```
+
+## ライセンス
+
+[MIT](./LICENSE) © kongyo2

package/dist/errors.js

@@ -0,0 +1,69 @@
+export class NicoTagError extends Error {
+    name = 'NicoTagError';
+    url;
+    videoId;
+    attempt;
+    constructor(message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        if (options.url !== undefined)
+            this.url = options.url;
+        if (options.videoId !== undefined)
+            this.videoId = options.videoId;
+        if (options.attempt !== undefined)
+            this.attempt = options.attempt;
+    }
+}
+export class InvalidVideoIdError extends NicoTagError {
+    name = 'InvalidVideoIdError';
+}
+export class FetchError extends NicoTagError {
+    name = 'FetchError';
+    status;
+    statusText;
+    constructor(message, options = {}) {
+        super(message, options);
+        if (options.status !== undefined)
+            this.status = options.status;
+        if (options.statusText !== undefined)
+            this.statusText = options.statusText;
+    }
+}
+export class TimeoutError extends NicoTagError {
+    name = 'TimeoutError';
+}
+export class AbortError extends NicoTagError {
+    name = 'AbortError';
+}
+export class ExtractError extends NicoTagError {
+    name = 'ExtractError';
+    attempts;
+    constructor(message, attempts, options = {}) {
+        super(message, options);
+        this.attempts = attempts;
+    }
+}
+export class ParseError extends NicoTagError {
+    name = 'ParseError';
+    snippet;
+    constructor(message, options = {}) {
+        super(message, options);
+        if (options.snippet !== undefined)
+            this.snippet = options.snippet;
+    }
+}
+export class ValidationError extends NicoTagError {
+    name = 'ValidationError';
+    issues;
+    constructor(message, issues, options = {}) {
+        super(message, options);
+        this.issues = issues;
+    }
+}
+export function describeError(error) {
+    if (error instanceof Error) {
+        const causeMsg = error.cause instanceof Error ? `: ${error.cause.message}` : '';
+        return `${error.name}: ${error.message}${causeMsg}`;
+    }
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/extractors/cheerio.js

@@ -0,0 +1,17 @@
+import * as cheerio from 'cheerio';
+export const cheerioExtractor = {
+    name: 'cheerio',
+    extract(html) {
+        const $ = cheerio.load(html, { xml: false });
+        const tag = $('meta[name="server-response"]').first();
+        if (tag.length === 0) {
+            throw new Error('meta[name="server-response"] not found via cheerio');
+        }
+        const content = tag.attr('content');
+        if (content === undefined || content.length === 0) {
+            throw new Error('content attribute of server-response meta is empty (cheerio)');
+        }
+        return content;
+    },
+};
+//# sourceMappingURL=cheerio.js.map

package/dist/extractors/cheerio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cheerio.js","sourceRoot":"","sources":["../../src/extractors/cheerio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,IAAI,EAAE,SAAS;IACf,OAAO,CAAC,IAAY;QAClB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC,KAAK,EAAE,CAAC;QACtD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC"}

package/dist/extractors/index.js

@@ -0,0 +1,24 @@
+import { cheerioExtractor } from './cheerio.js';
+import { nodeHtmlParserExtractor } from './node-html-parser.js';
+import { regexHeExtractor } from './regex-he.js';
+import { regexManualExtractor } from './regex-manual.js';
+export { cheerioExtractor, nodeHtmlParserExtractor, regexHeExtractor, regexManualExtractor };
+export const DEFAULT_EXTRACTOR_CHAIN = Object.freeze([
+    cheerioExtractor,
+    nodeHtmlParserExtractor,
+    regexHeExtractor,
+    regexManualExtractor,
+]);
+export function getExtractor(name) {
+    switch (name) {
+        case 'cheerio':
+            return cheerioExtractor;
+        case 'node-html-parser':
+            return nodeHtmlParserExtractor;
+        case 'regex-he':
+            return regexHeExtractor;
+        case 'regex-manual':
+            return regexManualExtractor;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/extractors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extractors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;AAG7F,MAAM,CAAC,MAAM,uBAAuB,GAAyB,MAAM,CAAC,MAAM,CAAC;IACzE,gBAAgB;IAChB,uBAAuB;IACvB,gBAAgB;IAChB,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,gBAAgB,CAAC;QAC1B,KAAK,kBAAkB;YACrB,OAAO,uBAAuB,CAAC;QACjC,KAAK,UAAU;YACb,OAAO,gBAAgB,CAAC;QAC1B,KAAK,cAAc;YACjB,OAAO,oBAAoB,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/extractors/manual-decode.js

@@ -0,0 +1,41 @@
+const NAMED = Object.freeze({
+    amp: '&',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+    nbsp: ' ',
+});
+export function decodeHtmlEntitiesManual(input) {
+    return input.replace(/&(#[xX][0-9a-fA-F]+|#\d+|[a-zA-Z][a-zA-Z0-9]+);/g, (match, body) => {
+        if (body.startsWith('#x') || body.startsWith('#X')) {
+            const code = Number.parseInt(body.slice(2), 16);
+            if (Number.isFinite(code) && code >= 0 && code <= 0x10ffff) {
+                try {
+                    return String.fromCodePoint(code);
+                }
+                catch {
+                    return match;
+                }
+            }
+            return match;
+        }
+        if (body.startsWith('#')) {
+            const code = Number.parseInt(body.slice(1), 10);
+            if (Number.isFinite(code) && code >= 0 && code <= 0x10ffff) {
+                try {
+                    return String.fromCodePoint(code);
+                }
+                catch {
+                    return match;
+                }
+            }
+            return match;
+        }
+        const named = NAMED[body];
+        if (named !== undefined)
+            return named;
+        return match;
+    });
+}
+//# sourceMappingURL=manual-decode.js.map

package/dist/extractors/manual-decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-decode.js","sourceRoot":"","sources":["../../src/extractors/manual-decode.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC5D,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;CACV,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAO,KAAK,CAAC,OAAO,CAClB,kDAAkD,EAClD,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QACtB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC3D,IAAI,CAAC;oBACH,OAAO,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBACpC,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC3D,IAAI,CAAC;oBACH,OAAO,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBACpC,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/extractors/node-html-parser.js

@@ -0,0 +1,19 @@
+import { parse } from 'node-html-parser';
+import { decodeHtmlEntitiesManual } from './manual-decode.js';
+export const nodeHtmlParserExtractor = {
+    name: 'node-html-parser',
+    extract(html) {
+        const root = parse(html, { lowerCaseTagName: false, comment: false });
+        const tag = root.querySelector('meta[name="server-response"]') ??
+            root.querySelector("meta[name='server-response']");
+        if (!tag) {
+            throw new Error('meta[name="server-response"] not found via node-html-parser');
+        }
+        const raw = tag.getAttribute('content');
+        if (raw === undefined || raw === null || raw.length === 0) {
+            throw new Error('content attribute is empty (node-html-parser)');
+        }
+        return decodeHtmlEntitiesManual(raw);
+    },
+};
+//# sourceMappingURL=node-html-parser.js.map

package/dist/extractors/node-html-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-html-parser.js","sourceRoot":"","sources":["../../src/extractors/node-html-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,MAAM,CAAC,MAAM,uBAAuB,GAAc;IAChD,IAAI,EAAE,kBAAkB;IACxB,OAAO,CAAC,IAAY;QAClB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,GACP,IAAI,CAAC,aAAa,CAAC,8BAA8B,CAAC;YAClD,IAAI,CAAC,aAAa,CAAC,8BAA8B,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;CACF,CAAC"}

package/dist/extractors/regex-he.js

@@ -0,0 +1,20 @@
+import he from 'he';
+const META_RE_NAME_FIRST = /<meta\s+name=["']server-response["']\s+content=(?:"([^"]*)"|'([^']*)')/i;
+const META_RE_CONTENT_FIRST = /<meta\s+content=(?:"([^"]*)"|'([^']*)')\s+name=["']server-response["']/i;
+export const regexHeExtractor = {
+    name: 'regex-he',
+    extract(html) {
+        const m1 = META_RE_NAME_FIRST.exec(html);
+        const captured = m1
+            ? (m1[1] ?? m1[2])
+            : (() => {
+                const m2 = META_RE_CONTENT_FIRST.exec(html);
+                return m2 ? (m2[1] ?? m2[2]) : undefined;
+            })();
+        if (captured === undefined || captured.length === 0) {
+            throw new Error('meta[name="server-response"] not found via regex-he');
+        }
+        return he.decode(captured);
+    },
+};
+//# sourceMappingURL=regex-he.js.map

package/dist/extractors/regex-he.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex-he.js","sourceRoot":"","sources":["../../src/extractors/regex-he.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB,MAAM,kBAAkB,GACtB,yEAAyE,CAAC;AAC5E,MAAM,qBAAqB,GACzB,yEAAyE,CAAC;AAE5E,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,IAAI,EAAE,UAAU;IAChB,OAAO,CAAC,IAAY;QAClB,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,EAAE;YACjB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC,GAAG,EAAE;gBACJ,MAAM,EAAE,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5C,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3C,CAAC,CAAC,EAAE,CAAC;QACT,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}

package/dist/extractors/regex-manual.js

@@ -0,0 +1,20 @@
+import { decodeHtmlEntitiesManual } from './manual-decode.js';
+const META_RE_NAME_FIRST = /<meta\s+name=["']server-response["']\s+content=(?:"([^"]*)"|'([^']*)')/i;
+const META_RE_CONTENT_FIRST = /<meta\s+content=(?:"([^"]*)"|'([^']*)')\s+name=["']server-response["']/i;
+export const regexManualExtractor = {
+    name: 'regex-manual',
+    extract(html) {
+        const m1 = META_RE_NAME_FIRST.exec(html);
+        const captured = m1
+            ? (m1[1] ?? m1[2])
+            : (() => {
+                const m2 = META_RE_CONTENT_FIRST.exec(html);
+                return m2 ? (m2[1] ?? m2[2]) : undefined;
+            })();
+        if (captured === undefined || captured.length === 0) {
+            throw new Error('meta[name="server-response"] not found via regex-manual');
+        }
+        return decodeHtmlEntitiesManual(captured);
+    },
+};
+//# sourceMappingURL=regex-manual.js.map

package/dist/extractors/regex-manual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex-manual.js","sourceRoot":"","sources":["../../src/extractors/regex-manual.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,MAAM,kBAAkB,GACtB,yEAAyE,CAAC;AAC5E,MAAM,qBAAqB,GACzB,yEAAyE,CAAC;AAE5E,MAAM,CAAC,MAAM,oBAAoB,GAAc;IAC7C,IAAI,EAAE,cAAc;IACpB,OAAO,CAAC,IAAY;QAClB,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,EAAE;YACjB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC,GAAG,EAAE;gBACJ,MAAM,EAAE,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5C,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3C,CAAC,CAAC,EAAE,CAAC;QACT,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC"}

package/dist/extractors/types.js

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

package/dist/extractors/types.js.map

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

package/dist/fetcher.js

@@ -0,0 +1,145 @@
+import { AbortError, FetchError, TimeoutError, describeError } from './errors.js';
+export const DEFAULT_USER_AGENT = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36';
+const DEFAULT_RETRY = {
+    maxRetries: 4,
+    initialDelayMs: 300,
+    maxDelayMs: 5_000,
+    jitterRatio: 0.3,
+};
+const RETRYABLE_STATUS = new Set([408, 425, 429, 500, 502, 503, 504]);
+export async function fetchTextWithRetry(url, options = {}) {
+    const retry = { ...DEFAULT_RETRY, ...options.retry };
+    const timeoutMs = options.timeoutMs ?? 15_000;
+    const userAgent = options.userAgent ?? DEFAULT_USER_AGENT;
+    const acceptLanguage = options.acceptLanguage ?? 'ja,en;q=0.9';
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const sleep = options.sleep ?? defaultSleep;
+    if (options.signal?.aborted) {
+        throw new AbortError('Fetch aborted before start', { url });
+    }
+    const headers = {
+        'User-Agent': userAgent,
+        'Accept-Language': acceptLanguage,
+        Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8',
+        ...options.headers,
+    };
+    let lastError;
+    for (let attempt = 0; attempt <= retry.maxRetries; attempt += 1) {
+        if (options.signal?.aborted) {
+            throw new AbortError('Fetch aborted', { url, attempt });
+        }
+        const timeoutCtl = new AbortController();
+        const userSignal = options.signal;
+        const onUserAbort = () => {
+            timeoutCtl.abort(new AbortError('User aborted', { url, attempt }));
+        };
+        if (userSignal)
+            userSignal.addEventListener('abort', onUserAbort, { once: true });
+        const timer = setTimeout(() => {
+            timeoutCtl.abort(new TimeoutError(`Fetch timed out after ${timeoutMs}ms`, { url, attempt }));
+        }, timeoutMs);
+        try {
+            const response = await fetchImpl(url, {
+                method: 'GET',
+                headers,
+                signal: timeoutCtl.signal,
+                redirect: options.redirect ?? 'follow',
+            });
+            if (response.ok) {
+                const text = await response.text();
+                return { text, url: response.url || url, status: response.status, attempts: attempt + 1 };
+            }
+            const retryable = RETRYABLE_STATUS.has(response.status);
+            const err = new FetchError(`HTTP ${response.status} ${response.statusText} for ${url}`, {
+                url,
+                attempt,
+                status: response.status,
+                statusText: response.statusText,
+            });
+            if (!retryable || attempt === retry.maxRetries) {
+                throw err;
+            }
+            lastError = err;
+        }
+        catch (error) {
+            if (error instanceof FetchError && !RETRYABLE_STATUS.has(error.status ?? 0)) {
+                throw error;
+            }
+            if (isAbortFromUser(error, userSignal)) {
+                throw error instanceof AbortError
+                    ? error
+                    : new AbortError('Fetch aborted', { url, attempt, cause: error });
+            }
+            if (isTimeoutAbort(error, timeoutCtl)) {
+                lastError = new TimeoutError(`Fetch timed out after ${timeoutMs}ms`, {
+                    url,
+                    attempt,
+                    cause: error,
+                });
+            }
+            else if (error instanceof FetchError) {
+                lastError = error;
+            }
+            else {
+                lastError = new FetchError(`Network error: ${describeError(error)}`, {
+                    url,
+                    attempt,
+                    cause: error,
+                });
+            }
+            if (attempt === retry.maxRetries) {
+                throw lastError;
+            }
+        }
+        finally {
+            clearTimeout(timer);
+            if (userSignal)
+                userSignal.removeEventListener('abort', onUserAbort);
+        }
+        const delay = computeBackoff(attempt, retry);
+        await sleep(delay, options.signal);
+    }
+    throw lastError instanceof Error
+        ? lastError
+        : new FetchError('Unknown fetch failure', { url, cause: lastError });
+}
+function computeBackoff(attempt, retry) {
+    const exp = retry.initialDelayMs * 2 ** attempt;
+    const capped = Math.min(exp, retry.maxDelayMs);
+    const jitter = capped * retry.jitterRatio * (Math.random() * 2 - 1);
+    return Math.max(0, Math.floor(capped + jitter));
+}
+function defaultSleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new AbortError('Sleep aborted'));
+            return;
+        }
+        const timer = setTimeout(() => {
+            if (signal)
+                signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new AbortError('Sleep aborted'));
+        };
+        if (signal)
+            signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+function isAbortFromUser(error, userSignal) {
+    if (!userSignal?.aborted)
+        return false;
+    if (error instanceof AbortError)
+        return true;
+    return error instanceof DOMException && error.name === 'AbortError';
+}
+function isTimeoutAbort(error, timeoutCtl) {
+    if (!timeoutCtl.signal.aborted)
+        return false;
+    if (error instanceof TimeoutError)
+        return true;
+    return error instanceof DOMException && error.name === 'AbortError';
+}
+//# sourceMappingURL=fetcher.js.map

package/dist/fetcher.js.map

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

package/dist/index.js

@@ -0,0 +1,10 @@
+export { fetchVideoTags, fetchVideo, extractAndParse, } from './watch.js';
+export { buildWatchUrl, WATCH_BASE_URL } from './url.js';
+export { VideoIdSchema, isValidVideoId, assertVideoId, normalizeVideoId, } from './video-id.js';
+export { fetchTextWithRetry, DEFAULT_USER_AGENT, } from './fetcher.js';
+export { TagItemSchema, TagSectionSchema, VideoCountSchema, VideoSectionSchema, ServerResponseSchema, } from './types.js';
+export { NicoTagError, InvalidVideoIdError, FetchError, TimeoutError, AbortError, ExtractError, ParseError, ValidationError, describeError, } from './errors.js';
+export { cheerioExtractor, nodeHtmlParserExtractor, regexHeExtractor, regexManualExtractor, DEFAULT_EXTRACTOR_CHAIN, getExtractor, } from './extractors/index.js';
+export { parseServerResponseJson } from './parsers/server-response.js';
+export { decodeHtmlEntitiesManual } from './extractors/manual-decode.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,UAAU,EACV,eAAe,GAKhB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,cAAc,EAA6B,MAAM,UAAU,CAAC;AAEpF,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,gBAAgB,GAEjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GAInB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GAKrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,eAAe,EACf,aAAa,GAGd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,GAGb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/parsers/server-response.js

@@ -0,0 +1,28 @@
+import { ZodError } from 'zod';
+import { ParseError, ValidationError } from '../errors.js';
+import { ServerResponseSchema } from '../types.js';
+export function parseServerResponseJson(jsonText) {
+    let raw;
+    try {
+        raw = JSON.parse(jsonText);
+    }
+    catch (error) {
+        const snippet = jsonText.length > 200 ? `${jsonText.slice(0, 200)}…` : jsonText;
+        throw new ParseError('Failed to JSON.parse server-response content', {
+            cause: error,
+            snippet,
+        });
+    }
+    try {
+        return ServerResponseSchema.parse(raw);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            throw new ValidationError('server-response payload failed schema validation', error.issues, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=server-response.js.map

package/dist/parsers/server-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-response.js","sourceRoot":"","sources":["../../src/parsers/server-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAuB,MAAM,aAAa,CAAC;AAExE,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;QAChF,MAAM,IAAI,UAAU,CAAC,8CAA8C,EAAE;YACnE,KAAK,EAAE,KAAK;YACZ,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC;QACH,OAAO,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,eAAe,CAAC,kDAAkD,EAAE,KAAK,CAAC,MAAM,EAAE;gBAC1F,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}