@kongyo2/nicotag-api 0.1.0

package/dist-types/video-id.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const VideoIdSchema: z.ZodString;
+export type VideoId = z.infer<typeof VideoIdSchema>;
+export declare function isValidVideoId(input: string): input is VideoId;
+export declare function assertVideoId(input: string): asserts input is VideoId;
+export declare function normalizeVideoId(input: string): VideoId;
+//# sourceMappingURL=video-id.d.ts.map

package/dist-types/video-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-id.d.ts","sourceRoot":"","sources":["../src/video-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,aAAa,aAIqC,CAAC;AAEhE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,CAE9D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAOrE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIvD"}

package/dist-types/watch.d.ts

@@ -0,0 +1,40 @@
+import { type Extractor, type ExtractorName } from './extractors/index.js';
+import { type ExtractorAttempt } from './errors.js';
+import { type HttpFetchOptions } from './fetcher.js';
+import type { ServerResponse, TagItem, TagSection, VideoSection } from './types.js';
+export type FetchVideoOptions = {
+    videoId: string;
+    baseUrl?: string;
+    extractors?: readonly Extractor[];
+    http?: HttpFetchOptions;
+};
+export type FetchTagsResult = {
+    readonly url: string;
+    readonly fetchedAt: string;
+    readonly videoId: string;
+    readonly tags: ReadonlyArray<TagItem>;
+    readonly tagNames: ReadonlyArray<string>;
+    readonly extractorUsed: ExtractorName;
+    readonly fetchAttempts: number;
+    readonly extractorAttempts: ReadonlyArray<ExtractorAttempt>;
+};
+export type FetchVideoResult = {
+    readonly url: string;
+    readonly fetchedAt: string;
+    readonly videoId: string;
+    readonly video: VideoSection;
+    readonly tag: TagSection;
+    readonly serverResponse: ServerResponse;
+    readonly extractorUsed: ExtractorName;
+    readonly fetchAttempts: number;
+    readonly extractorAttempts: ReadonlyArray<ExtractorAttempt>;
+};
+export declare function fetchVideoTags(options: FetchVideoOptions): Promise<FetchTagsResult>;
+export declare function fetchVideo(options: FetchVideoOptions): Promise<FetchVideoResult>;
+export type ParseHtmlResult = {
+    readonly parsed: ServerResponse;
+    readonly extractorUsed: ExtractorName;
+    readonly attempts: ReadonlyArray<ExtractorAttempt>;
+};
+export declare function extractAndParse(html: string, extractors?: readonly Extractor[]): ParseHtmlResult;
+//# sourceMappingURL=watch.d.ts.map

package/dist-types/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAgB,KAAK,gBAAgB,EAA+B,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIpF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CAC7D,CAAC;AAEF,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAYzF;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuBtF;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CACpD,CAAC;AAEF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,SAAS,EAA4B,GACzD,eAAe,CAqBjB"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@kongyo2/nicotag-api",
+  "version": "0.1.0",
+  "description": "Unofficial alternative client for fetching nicovideo.jp video tags by video id via HTML scraping with multi-fallback parsers.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kongyo2/nicotag-api.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist-types/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist-types/index.d.ts",
+  "files": [
+    "dist",
+    "dist-types"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "node -e \"const f=require('fs');for(const d of ['dist','dist-types','.tsbuildinfo']){try{f.rmSync(d,{recursive:true,force:true});}catch{}}\"",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check:file": "oxlint",
+    "lint": "oxlint --silent",
+    "lint:strict": "oxlint --deny-warnings",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:live": "vitest run --reporter=verbose tests/live.test.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "nicovideo",
+    "niconico",
+    "tags",
+    "scraper",
+    "unofficial-api"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "cheerio": "^1.0.0",
+    "he": "^1.2.0",
+    "node-html-parser": "^6.1.13",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/he": "^1.2.3",
+    "@types/node": "^22.5.0",
+    "oxlint": "^0.9.0",
+    "prettier": "^3.3.3",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.6"
+  }
+}