pixivflow 2.16.0 → 2.16.1

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "type": "commonjs",
   "name": "pixivflow",
-  "version": "2.16.0",
+  "version": "2.16.1",
   "private": true
 }

package/dist/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BUILD = void 0;
 // GENERATED by scripts/write-version.js — do not edit manually.
-exports.BUILD = { version: '2.16.0', commit: '1542ffc9b516' };
+exports.BUILD = { version: '2.16.1', commit: '180f23d510a0' };
 //# sourceMappingURL=version.js.map

package/dist/webui/package.json

@@ -1,6 +1,6 @@
 {
   "type": "commonjs",
   "name": "pixivflow-webui-backend",
-  "version": "2.16.0",
+  "version": "2.16.1",
   "description": "PixivFlow WebUI Backend - CommonJS module"
 }

package/node_modules/@redtidev/pixiv-client/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 redtidev1918
+
+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/node_modules/@redtidev/pixiv-client/README.md

@@ -0,0 +1,103 @@
+# @redtidev/pixiv-client
+
+Independent, reusable **Pixiv App API client kit** for TypeScript/Node.js.
+
+It knows Pixiv. It does **not** know your application: no config schema, no
+database, no browser login, no scheduler. It currently lives as an npm
+workspace package inside the PixivFlow monorepo and is intentionally **not
+yet published** (see "When to split out" below).
+
+```ts
+import { createPixivClient, StaticTokenProvider } from '@redtidev/pixiv-client';
+
+const pixiv = createPixivClient({ auth: new StaticTokenProvider(process.env.PIXIV_ACCESS_TOKEN!) });
+
+const illust = await pixiv.illustrations.get(123_456);
+const page   = await pixiv.illustrations.searchPage({ word: '風景', limit: 30 });
+const bytes  = await pixiv.media.fetch(illust.meta_single_page!.original_image_url!);
+```
+
+## Features
+
+- **Auth port, not login implementation** — inject anything implementing
+  `AccessTokenProvider` (optionally `RefreshableAccessTokenProvider`). Browser
+  OAuth/PKCE, puppeteer and python helpers stay in the host application.
+- **One transport** for every call: base URL, App headers, Bearer auth,
+  timeout (`AbortController`), HTTP(S) proxy (undici) and SOCKS proxy
+  (axios + socks-proxy-agent), response parsing, typed errors.
+- **Typed errors** — `PixivNotFoundError`, `PixivRateLimitError`,
+  `PixivAuthenticationError`, `PixivServerError`, `PixivNetworkError`,
+  `PixivTimeoutError`, `PixivCircuitOpenError`, ... classify with `instanceof`,
+  never with `message.includes('429')`.
+- **Single 429 gate** — one global rate limiter paces all requests and applies
+  one shared cooldown. No nested retries, no request storms.
+- **Slot-reservation pacing** — concurrent callers are serialized to
+  t, t+interval, t+2·interval ... (the old coordinator woke them in a burst).
+- **Conservative defaults**: 1000 ms minimum interval, jitter 25 %, first 429
+  cooldown 60 s, exponential 60→120→240→480 s capped at 15 min, Retry-After
+  always honored as a floor.
+- **Penalty decay** — one success never clears the penalty; it decays after a
+  configurable run (default 20) of consecutive successes.
+- **Circuit breaker** — repeated 429s OPEN the gate; requests fast-fail with
+  `PixivCircuitOpenError`; after the cooldown a single half-open probe tests
+  recovery.
+- **Persistent state port** — inject a `RateLimitStateStore` (e.g. an SQLite
+  adapter) so restarts/deploys remember an active cooldown. Default is
+  in-memory.
+- **In-flight coalescing** — 10 concurrent `get(123)` calls make 1 HTTP
+  request.
+- **Pagination without auto-crawl** — `searchPage`/`rankingPage` plus the
+  optional `paginate()` helper; always bounded by `limit`/`maxPages` and
+  `AbortSignal`-aware.
+- **Structured events** via `onEvent` (`request_start`, `request_retry`,
+  `rate_limited`, `circuit_opened`, `auth_refresh`, ...). No credentials are
+  ever logged or emitted.
+
+## Retry ownership
+
+| Failure                         | Owner                                        |
+| ------------------------------- | -------------------------------------------- |
+| network reset / timeout / 5xx   | transport retries (default 2), linear backoff|
+| 429 while circuit CLOSED        | transport waits the shared gate cooldown     |
+| 429 after circuit OPEN threshold| fails fast; durable retry belongs to the host (scheduler/outbox) |
+| 401                             | one `refreshAccessToken()` + retry, then error|
+| 400 / 403 / 404                 | never retried                                |
+
+The kit never rotates proxies or IPs on 429 and never alternates between the
+App and Web API to dodge rate limits. Endpoint-capability fallback (the novel
+text v2→v1/ajax chain) is allowed; anti-rate-limit rotation is not.
+
+## API surface
+
+- `createPixivClient(options)` / `new PixivClient(options)`
+- `pixiv.illustrations` — `get/detail`, `detailWithTags`, `searchPage`,
+  `search`, `rankingPage`, `ranking`, `userWorksPage`, `listByUser`,
+  `ugoiraMetadata`
+- `pixiv.novels` — `get/detail`, `detailCompatible`, `detailWithTags`,
+  `searchPage`, `search`, `rankingPage`, `ranking`, `userWorksPage`,
+  `listByUser`, `listSeries`, `text`
+- `pixiv.tags.autocomplete(word)`
+- `pixiv.users.user(userId)` (Pixiv removed `/v1/user/profile`, so there is no "current user" endpoint)
+- `pixiv.media.fetch(url)` → `ArrayBuffer`
+- `pixiv.getRateLimitStatus()` — `{ circuitState, cooldownRemainingMs, penaltyLevel, last429At, nextAllowedInMs }`
+
+The package has zero knowledge of host types (`TargetConfig`, schedulers,
+SQLite, delivery, …). Mapping a host query into kit options is the host's
+job, e.g. `mapTargetToPixivQuery(target): IllustSearchOptions`.
+
+## When to split out into its own repo
+
+Do **not** split yet. Split only once both hold:
+
+1. A second real consumer exists (another bot, an Electron client, a
+   standalone downloader …) — PixivFlow alone does not justify cross-repo
+   version coordination.
+2. The public API has run stable for a while and the host adapter has stopped
+   churning.
+
+At that point: history-split `packages/pixiv-client` → its own repo →
+publish `@redtidev/pixiv-client` and depend on the released version.
+
+## License
+
+MIT

package/node_modules/@redtidev/pixiv-client/dist/app-api/exports.d.ts

@@ -0,0 +1,6 @@
+export { IllustrationsApi } from './illustrations';
+export { NovelsApi } from './novels';
+export { TagsApi } from './tags';
+export { MediaApi } from './media';
+export { UsersApi } from './users';
+//# sourceMappingURL=exports.d.ts.map

package/node_modules/@redtidev/pixiv-client/dist/app-api/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/app-api/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}

package/node_modules/@redtidev/pixiv-client/dist/app-api/exports.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsersApi = exports.MediaApi = exports.TagsApi = exports.NovelsApi = exports.IllustrationsApi = void 0;
+var illustrations_1 = require("./illustrations");
+Object.defineProperty(exports, "IllustrationsApi", { enumerable: true, get: function () { return illustrations_1.IllustrationsApi; } });
+var novels_1 = require("./novels");
+Object.defineProperty(exports, "NovelsApi", { enumerable: true, get: function () { return novels_1.NovelsApi; } });
+var tags_1 = require("./tags");
+Object.defineProperty(exports, "TagsApi", { enumerable: true, get: function () { return tags_1.TagsApi; } });
+var media_1 = require("./media");
+Object.defineProperty(exports, "MediaApi", { enumerable: true, get: function () { return media_1.MediaApi; } });
+var users_1 = require("./users");
+Object.defineProperty(exports, "UsersApi", { enumerable: true, get: function () { return users_1.UsersApi; } });
+//# sourceMappingURL=exports.js.map

package/node_modules/@redtidev/pixiv-client/dist/app-api/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../src/app-api/exports.ts"],"names":[],"mappings":";;;AAAA,iDAAmD;AAA1C,iHAAA,gBAAgB,OAAA;AACzB,mCAAqC;AAA5B,mGAAA,SAAS,OAAA;AAClB,+BAAiC;AAAxB,+FAAA,OAAO,OAAA;AAChB,iCAAmC;AAA1B,iGAAA,QAAQ,OAAA;AACjB,iCAAmC;AAA1B,iGAAA,QAAQ,OAAA"}

package/node_modules/@redtidev/pixiv-client/dist/app-api/illustrations.d.ts

@@ -0,0 +1,30 @@
+import type { Transport } from '../transport/transport';
+import type { PixivIllust, PixivTag, UgoiraMetadata, Paginated } from '../models';
+import type { IllustRankingMode, IllustSearchOptions, OnePageResult, RankingOptions, UserWorksOptions } from './options';
+/** Illustration endpoints of the Pixiv public App API. */
+export declare class IllustrationsApi {
+    private readonly transport;
+    constructor(transport: Transport);
+    get(id: number, signal?: AbortSignal): Promise<PixivIllust>;
+    detail(id: number, signal?: AbortSignal): Promise<PixivIllust>;
+    detailWithTags(id: number, signal?: AbortSignal): Promise<{
+        illust: PixivIllust;
+        tags: PixivTag[];
+    }>;
+    /** One user-works page (type=illust). Use {@link listByUser} for walking. */
+    userWorksPage(userId: string, cursor: string | null, options?: UserWorksOptions): Promise<OnePageResult<PixivIllust>>;
+    /** User illustrations, walking next_url up to `limit` (default 30). */
+    listByUser(userId: string, options?: UserWorksOptions): Promise<PixivIllust[]>;
+    rankingPage(mode: IllustRankingMode, options?: RankingOptions, cursor?: string | null): Promise<OnePageResult<PixivIllust>>;
+    ranking(mode: IllustRankingMode, options?: RankingOptions): Promise<PixivIllust[]>;
+    /** One illustration search page. PixivFlow uses this for date-aware paging. */
+    searchPage(options: IllustSearchOptions, cursor?: string | null): Promise<OnePageResult<PixivIllust>>;
+    /**
+     * Search illustrations, walking next_url up to `limit` (default 30).
+     * NOTE: hosts that must stop early on a date boundary or merge tag unions
+     * should call {@link searchPage} in their own loop (PixivFlow does).
+     */
+    search(options: IllustSearchOptions): Promise<Paginated<PixivIllust>>;
+    ugoiraMetadata(illustId: number, signal?: AbortSignal): Promise<UgoiraMetadata>;
+}
+//# sourceMappingURL=illustrations.d.ts.map

package/node_modules/@redtidev/pixiv-client/dist/app-api/illustrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"illustrations.d.ts","sourceRoot":"","sources":["../../src/app-api/illustrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEzH,0DAA0D;AAC1D,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAEjD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAIrD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ9D,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAC9D,MAAM,EAAE,WAAW,CAAC;QACpB,IAAI,EAAE,QAAQ,EAAE,CAAC;KAClB,CAAC;IAUF,6EAA6E;IACvE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IAgB/H,uEAAuE;IACjE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAalF,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,GAAE,cAAmB,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IAgBrI,OAAO,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAa5F,+EAA+E;IACzE,UAAU,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IAwBjH;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAarE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;CAOtF"}

package/node_modules/@redtidev/pixiv-client/dist/app-api/illustrations.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IllustrationsApi = void 0;
+/** Illustration endpoints of the Pixiv public App API. */
+class IllustrationsApi {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    get(id, signal) {
+        return this.detail(id, signal);
+    }
+    async detail(id, signal) {
+        const res = await this.transport.request(`/v1/illust/detail?illust_id=${encodeURIComponent(String(id))}`, { method: 'GET', signal });
+        return res.illust;
+    }
+    async detailWithTags(id, signal) {
+        const res = await this.transport.request(`/v1/illust/detail?illust_id=${encodeURIComponent(String(id))}`, { method: 'GET', signal });
+        const tags = res.illust.tags ?? [];
+        const { tags: _omit, ...illust } = res.illust;
+        return { illust, tags };
+    }
+    /** One user-works page (type=illust). Use {@link listByUser} for walking. */
+    async userWorksPage(userId, cursor, options = {}) {
+        let url;
+        if (cursor) {
+            url = cursor;
+        }
+        else {
+            const params = new URLSearchParams({ user_id: userId, type: 'illust', filter: 'for_ios' });
+            if (options.offset)
+                params.set('offset', String(options.offset));
+            url = `/v1/user/illusts?${params.toString()}`;
+        }
+        const res = await this.transport.request(url, {
+            method: 'GET',
+            signal: options.signal,
+        });
+        return { items: res.illusts ?? [], next: res.next_url ?? null };
+    }
+    /** User illustrations, walking next_url up to `limit` (default 30). */
+    async listByUser(userId, options = {}) {
+        const limit = options.limit ?? 30;
+        const out = [];
+        let cursor = null;
+        do {
+            const page = await this.userWorksPage(userId, cursor, options);
+            out.push(...page.items);
+            cursor = page.next;
+            if (!page.items.length)
+                break;
+        } while (cursor && out.length < limit);
+        return out.slice(0, limit);
+    }
+    async rankingPage(mode, options = {}, cursor = null) {
+        let url;
+        if (cursor) {
+            url = cursor;
+        }
+        else {
+            const params = new URLSearchParams({ mode, filter: 'for_ios' });
+            if (options.date)
+                params.set('date', options.date);
+            url = `/v1/illust/ranking?${params.toString()}`;
+        }
+        const res = await this.transport.request(url, {
+            method: 'GET',
+            signal: options.signal,
+        });
+        return { items: res.illusts ?? [], next: res.next_url ?? null };
+    }
+    async ranking(mode, options = {}) {
+        const limit = options.limit;
+        const out = [];
+        let cursor = null;
+        do {
+            const page = await this.rankingPage(mode, options, cursor);
+            out.push(...page.items);
+            cursor = page.next;
+            if (!page.items.length)
+                break;
+        } while (cursor && (limit === undefined || out.length < limit));
+        return limit !== undefined ? out.slice(0, limit) : out;
+    }
+    /** One illustration search page. PixivFlow uses this for date-aware paging. */
+    async searchPage(options, cursor = null) {
+        let url;
+        if (cursor) {
+            url = cursor;
+        }
+        else {
+            const paramsObj = {
+                word: options.word,
+                search_target: options.searchTarget ?? 'partial_match_for_tags',
+                include_translated_tag_results: options.includeTranslatedTagResults === false ? 'false' : 'true',
+            };
+            if (!options.includeR18)
+                paramsObj.filter = 'for_ios';
+            const params = new URLSearchParams(paramsObj);
+            params.set('sort', options.sort ?? 'date_desc');
+            if (options.startDate)
+                params.set('start_date', options.startDate);
+            if (options.endDate)
+                params.set('end_date', options.endDate);
+            url = `/v1/search/illust?${params.toString()}`;
+        }
+        const res = await this.transport.request(url, {
+            method: 'GET',
+            signal: options.signal,
+        });
+        return { items: res.illusts ?? [], next: res.next_url ?? null };
+    }
+    /**
+     * Search illustrations, walking next_url up to `limit` (default 30).
+     * NOTE: hosts that must stop early on a date boundary or merge tag unions
+     * should call {@link searchPage} in their own loop (PixivFlow does).
+     */
+    async search(options) {
+        const limit = options.limit ?? 30;
+        const out = [];
+        let cursor = options.cursor ?? null;
+        do {
+            const page = await this.searchPage(options, cursor);
+            out.push(...page.items);
+            cursor = page.next;
+            if (!page.items.length)
+                break;
+        } while (cursor && out.length < limit);
+        return { items: out.slice(0, limit), nextCursor: cursor };
+    }
+    async ugoiraMetadata(illustId, signal) {
+        const res = await this.transport.request(`/v1/ugoira/metadata?illust_id=${encodeURIComponent(String(illustId))}`, { method: 'GET', signal });
+        return res.ugoira_metadata;
+    }
+}
+exports.IllustrationsApi = IllustrationsApi;
+//# sourceMappingURL=illustrations.js.map

package/node_modules/@redtidev/pixiv-client/dist/app-api/illustrations.js.map

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

package/node_modules/@redtidev/pixiv-client/dist/app-api/media.d.ts

@@ -0,0 +1,16 @@
+import type { Transport } from '../transport/transport';
+/**
+ * Media (binary) fetch. The kit returns BYTES only; where to save, naming,
+ * unzip/ugoira→GIF conversion and download history are host concerns.
+ */
+export declare class MediaApi {
+    private readonly transport;
+    constructor(transport: Transport);
+    /** Download a media URL (images, ugoira zips) as ArrayBuffer. */
+    fetch(url: string, options?: {
+        referer?: string;
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<ArrayBuffer>;
+}
+//# sourceMappingURL=media.d.ts.map

package/node_modules/@redtidev/pixiv-client/dist/app-api/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/app-api/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;GAGG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAEjD,iEAAiE;IACjE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;CASnH"}

package/node_modules/@redtidev/pixiv-client/dist/app-api/media.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaApi = void 0;
+/**
+ * Media (binary) fetch. The kit returns BYTES only; where to save, naming,
+ * unzip/ugoira→GIF conversion and download history are host concerns.
+ */
+class MediaApi {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /** Download a media URL (images, ugoira zips) as ArrayBuffer. */
+    fetch(url, options) {
+        return this.transport.fetchBinary(url, {
+            method: 'GET',
+            headers: { Referer: options?.referer ?? 'https://app-api.pixiv.net/' },
+            skipAuth: true,
+            timeoutMs: options?.timeoutMs,
+            signal: options?.signal,
+        });
+    }
+}
+exports.MediaApi = MediaApi;
+//# sourceMappingURL=media.js.map

package/node_modules/@redtidev/pixiv-client/dist/app-api/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/app-api/media.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,QAAQ;IACU;IAA7B,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD,iEAAiE;IACjE,KAAK,CAAC,GAAW,EAAE,OAAwE;QACzF,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE;YACrC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,4BAA4B,EAAE;YACtE,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CAAC,CAAC;IACL,CAAC;CACF;AAbD,4BAaC"}

package/node_modules/@redtidev/pixiv-client/dist/app-api/novels.d.ts

@@ -0,0 +1,43 @@
+import type { Transport } from '../transport/transport';
+import type { PixivNovel, PixivNovelTextResponse, PixivTag, Paginated } from '../models';
+import type { NovelRankingMode, NovelSearchOptions, OnePageResult, RankingOptions, UserWorksOptions } from './options';
+/** Novel endpoints of the Pixiv public App API (+ required webview fallback). */
+export declare class NovelsApi {
+    private readonly transport;
+    constructor(transport: Transport);
+    /** Novel detail (v2 endpoint). */
+    get(id: number, signal?: AbortSignal): Promise<PixivNovel>;
+    detail(id: number, signal?: AbortSignal): Promise<PixivNovel>;
+    /**
+     * Detail + tags. v2 is primary; v1 is a CAPABILITY fallback for works whose
+     * v2 endpoint is missing (404/'end-point' responses), not a 429 workaround.
+     */
+    detailWithTags(id: number, signal?: AbortSignal): Promise<{
+        novel: PixivNovel;
+        tags: PixivTag[];
+    }>;
+    /** v2 with v1 capability fallback (matches legacy behavior). */
+    detailCompatible(id: number, signal?: AbortSignal): Promise<PixivNovel>;
+    userWorksPage(userId: string, cursor: string | null, options?: UserWorksOptions): Promise<OnePageResult<PixivNovel>>;
+    listByUser(userId: string, options?: UserWorksOptions): Promise<PixivNovel[]>;
+    rankingPage(mode: NovelRankingMode, options?: RankingOptions, cursor?: string | null): Promise<OnePageResult<PixivNovel>>;
+    ranking(mode: NovelRankingMode, options?: RankingOptions): Promise<PixivNovel[]>;
+    searchPage(options: NovelSearchOptions, cursor?: string | null): Promise<OnePageResult<PixivNovel>>;
+    search(options: NovelSearchOptions): Promise<Paginated<PixivNovel>>;
+    listSeries(seriesId: number, signal?: AbortSignal): Promise<PixivNovel[]>;
+    /**
+     * Novel text with the proven three-tier fallback chain:
+     * webview v2 (gallery-dl style) -> legacy app-api v1 -> www.pixiv.net ajax.
+     * Only a genuinely non-empty body counts as success.
+     * These are ENDPOINT CAPABILITY fallbacks, never 429 rotation.
+     */
+    text(novelId: number, options?: {
+        browserUserAgent?: string;
+        signal?: AbortSignal;
+    }): Promise<PixivNovelTextResponse>;
+    private splitTags;
+    private isMissingEndpoint;
+    private nonEmptyText;
+    private messageOf;
+}
+//# sourceMappingURL=novels.d.ts.map

package/node_modules/@redtidev/pixiv-client/dist/app-api/novels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"novels.d.ts","sourceRoot":"","sources":["../../src/app-api/novels.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAa,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACpG,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAKvH,iFAAiF;AACjF,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAEjD,kCAAkC;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAQnE;;;OAGG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IAiBxG,gEAAgE;IAC1D,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAavE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAgBxH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAajF,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,GAAE,cAAmB,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAgBnI,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAapF,UAAU,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAuBzG,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAanE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA6B/E;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA8D/H,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,SAAS;CAGlB"}