pixivflow 2.17.0 → 2.18.0

package/dist/storage/drivers/NodeSqliteDriver.js.map

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

package/dist/storage/drivers/SqliteDriver.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Minimal SQLite driver contract for the storage layer.
+ *
+ * Everything under `src/storage/` talks to SQLite through this interface and nothing
+ * else. The binding is a deployment concern (it decides whether `npm install -g pixivflow`
+ * compiles native code), so it lives behind one seam: swapping `node:sqlite` for another
+ * binding stays a change to one file instead of a sweep over every repository.
+ *
+ * The shapes intentionally mirror the synchronous better-sqlite3 API the repositories were
+ * written against, so call sites keep working unchanged:
+ *   - `prepare()` returns a reusable statement;
+ *   - a statement accepts an optional leading named-parameter object followed by
+ *     positional parameters (`stmt.run({ id }, 'extra')`);
+ *   - `.get()` returns `undefined` when no row matches.
+ *
+ * Bindings differ in their defaults, so implementations are responsible for normalising
+ * them (see `NodeSqliteDriver` for the lock-wait and foreign-key details).
+ */
+export interface SqliteRunResult {
+    /** Number of rows changed. Normalised to `number` so `changes === 0` keeps working. */
+    changes: number;
+    /** Rowid of the last inserted row. Normalised to `number` for the same reason. */
+    lastInsertRowid: number;
+}
+export interface SqliteStatement {
+    run(...params: unknown[]): SqliteRunResult;
+    get(...params: unknown[]): unknown;
+    all(...params: unknown[]): unknown[];
+}
+export interface SqliteDriver {
+    prepare(sql: string): SqliteStatement;
+    /** Execute one or more statements, discarding any result rows. */
+    exec(sql: string): void;
+    /**
+     * Apply or read a PRAGMA.
+     *
+     * Accepts either the pragma body (`journal_mode = WAL`) or a full statement
+     * (`PRAGMA integrity_check;`), so both calling styles survive the binding swap.
+     *
+     * Follows better-sqlite3's shape: a single-row/single-column result collapses to that
+     * scalar, a multi-row result (e.g. `table_info`) comes back as an array of row objects,
+     * and a statement that yields nothing returns `undefined`.
+     */
+    pragma(sql: string): unknown;
+    /**
+     * Wrap `fn` in a transaction and return a function that runs it.
+     *
+     * Nested calls join the outer transaction rather than starting a second one — the
+     * storage layer nests legitimately (a service-level transaction calling repository
+     * methods that are themselves transactional).
+     */
+    transaction<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R;
+    close(): void;
+}
+//# sourceMappingURL=SqliteDriver.d.ts.map

package/dist/storage/drivers/SqliteDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteDriver.d.ts","sourceRoot":"","sources":["../../../src/storage/drivers/SqliteDriver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC;IAC3C,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IAEtC,kEAAkE;IAClE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;;;;;;;OASG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IAE9E,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/storage/drivers/SqliteDriver.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Minimal SQLite driver contract for the storage layer.
+ *
+ * Everything under `src/storage/` talks to SQLite through this interface and nothing
+ * else. The binding is a deployment concern (it decides whether `npm install -g pixivflow`
+ * compiles native code), so it lives behind one seam: swapping `node:sqlite` for another
+ * binding stays a change to one file instead of a sweep over every repository.
+ *
+ * The shapes intentionally mirror the synchronous better-sqlite3 API the repositories were
+ * written against, so call sites keep working unchanged:
+ *   - `prepare()` returns a reusable statement;
+ *   - a statement accepts an optional leading named-parameter object followed by
+ *     positional parameters (`stmt.run({ id }, 'extra')`);
+ *   - `.get()` returns `undefined` when no row matches.
+ *
+ * Bindings differ in their defaults, so implementations are responsible for normalising
+ * them (see `NodeSqliteDriver` for the lock-wait and foreign-key details).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SqliteDriver.js.map

package/dist/storage/drivers/SqliteDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteDriver.js","sourceRoot":"","sources":["../../../src/storage/drivers/SqliteDriver.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/storage/repositories/BaseRepository.d.ts

@@ -1,14 +1,14 @@
-import DatabaseDriver from 'better-sqlite3';
+import type { SqliteDriver } from '../drivers/SqliteDriver';
 /**
  * Base repository class that provides access to the database instance
  * All repositories should extend this class
  */
 export declare abstract class BaseRepository {
-    protected readonly db: DatabaseDriver.Database;
-    constructor(db: DatabaseDriver.Database);
+    protected readonly db: SqliteDriver;
+    constructor(db: SqliteDriver);
     /**
      * Get the database instance
      */
-    protected getDatabase(): DatabaseDriver.Database;
+    protected getDatabase(): SqliteDriver;
 }
 //# sourceMappingURL=BaseRepository.d.ts.map

package/dist/storage/repositories/BaseRepository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/BaseRepository.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,gBAAgB,CAAC;AAE5C;;;GAGG;AACH,8BAAsB,cAAc;IACtB,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC,QAAQ;gBAA3B,EAAE,EAAE,cAAc,CAAC,QAAQ;IAE1D;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,cAAc,CAAC,QAAQ;CAGjD"}
+{"version":3,"file":"BaseRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/BaseRepository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;GAGG;AACH,8BAAsB,cAAc;IACtB,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,YAAY;gBAAhB,EAAE,EAAE,YAAY;IAE/C;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,YAAY;CAGtC"}

package/dist/storage/repositories/BaseRepository.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseRepository.js","sourceRoot":"","sources":["../../../src/storage/repositories/BaseRepository.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAsB,cAAc;IACH;IAA/B,YAA+B,EAA2B;QAA3B,OAAE,GAAF,EAAE,CAAyB;IAAG,CAAC;IAE9D;;OAEG;IACO,WAAW;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF;AATD,wCASC"}
+{"version":3,"file":"BaseRepository.js","sourceRoot":"","sources":["../../../src/storage/repositories/BaseRepository.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAsB,cAAc;IACH;IAA/B,YAA+B,EAAgB;QAAhB,OAAE,GAAF,EAAE,CAAc;IAAG,CAAC;IAEnD;;OAEG;IACO,WAAW;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF;AATD,wCASC"}

package/dist/storage/repositories/DownloadRepository.d.ts

@@ -1,5 +1,6 @@
 import { BaseRepository } from './BaseRepository';
 import { DownloadRecordInput } from '../Database';
+import type { SqliteDriver } from '../drivers/SqliteDriver';
 /**
  * Repository for managing download records
  * Facade pattern that combines query, write, and stats repositories
@@ -8,7 +9,7 @@ export declare class DownloadRepository extends BaseRepository {
     private readonly queryRepo;
     private readonly writeRepo;
     private readonly statsRepo;
-    constructor(db: import('better-sqlite3').Database);
+    constructor(db: SqliteDriver);
     hasDownloaded(pixivId: string, type: 'illustration' | 'novel'): boolean;
     isDownloaded(pixivId: string, type: 'illustration' | 'novel', filePath: string): boolean;
     getDownloadedIds(pixivIds: string[], type: 'illustration' | 'novel'): Set<string>;

package/dist/storage/repositories/DownloadRepository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DownloadRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/DownloadRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAKlD;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,EAAE,EAAE,OAAO,gBAAgB,EAAE,QAAQ;IAQ1C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,OAAO;IAIvE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;IAIjF,kBAAkB,CAAC,OAAO,EAAE;QACjC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;QACzD,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KAC5B;;;;;;;;;;;;;;;;;IAIM,wBAAwB,CAC7B,SAAS,EAAE,MAAM,EAAE,EACnB,IAAI,EAAE,cAAc,GAAG,OAAO,GAC7B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIf,kBAAkB,CACvB,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO;;;;;;;;;;IAK1B,uBAAuB,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO;;;;;;;;;;IAK1B,oBAAoB,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;IAKjC,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAIjD,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAIjD,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,GAAG,OAAO,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM;IAIF,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,MAAM;IAKhF,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO;;;;;IAI9D,gBAAgB;;;;;;IAIhB,WAAW,CAAC,KAAK,GAAE,MAAW;;;;IAI9B,cAAc,CAAC,KAAK,GAAE,MAAW;;;;CAGzC"}
+{"version":3,"file":"DownloadRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/DownloadRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,EAAE,EAAE,YAAY;IAQrB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,OAAO;IAIvE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;IAIjF,kBAAkB,CAAC,OAAO,EAAE;QACjC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;QACzD,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KAC5B;;;;;;;;;;;;;;;;;IAIM,wBAAwB,CAC7B,SAAS,EAAE,MAAM,EAAE,EACnB,IAAI,EAAE,cAAc,GAAG,OAAO,GAC7B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIf,kBAAkB,CACvB,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO;;;;;;;;;;IAK1B,uBAAuB,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO;;;;;;;;;;IAK1B,oBAAoB,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;IAKjC,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAIjD,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAIjD,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,GAAG,OAAO,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM;IAIF,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,MAAM;IAKhF,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO;;;;;IAI9D,gBAAgB;;;;;;IAIhB,WAAW,CAAC,KAAK,GAAE,MAAW;;;;IAI9B,cAAc,CAAC,KAAK,GAAE,MAAW;;;;CAGzC"}

package/dist/storage/repositories/DownloadRepository.js.map

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

package/dist/storage/repositories/RateLimitStateRepository.d.ts

@@ -2,7 +2,7 @@ import type { RateLimitState, RateLimitStateStore } from '@redtidev/pixiv-client
 import { BaseRepository } from './BaseRepository';
 /**
  * Host-side SQLite adapter for the kit's RateLimitStateStore port.
- * Sync better-sqlite3 calls satisfy the async interface trivially.
+ * Sync SQLite calls satisfy the async interface trivially.
  */
 export declare class SQLiteRateLimitStateStore extends BaseRepository implements RateLimitStateStore {
     load(scope: string): RateLimitState | null;

package/dist/storage/repositories/RateLimitStateRepository.js

@@ -4,7 +4,7 @@ exports.SQLiteRateLimitStateStore = void 0;
 const BaseRepository_1 = require("./BaseRepository");
 /**
  * Host-side SQLite adapter for the kit's RateLimitStateStore port.
- * Sync better-sqlite3 calls satisfy the async interface trivially.
+ * Sync SQLite calls satisfy the async interface trivially.
  */
 class SQLiteRateLimitStateStore extends BaseRepository_1.BaseRepository {
     load(scope) {

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.17.0', commit: '09c99aa117ac' };
+exports.BUILD = { version: '2.18.0', commit: '2ce5c9705daf' };
 //# sourceMappingURL=version.js.map

package/dist/webui/package.json

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

package/node_modules/@redtidev/pixiv-client/README.en.md

@@ -0,0 +1,105 @@
+# @redtidev/pixiv-client
+
+**English** | [中文](./README.md)
+
+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/README.md

@@ -1,11 +1,12 @@
 # @redtidev/pixiv-client
 
-Independent, reusable **Pixiv App API client kit** for TypeScript/Node.js.
+[English](./README.en.md) | **中文**
 
-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).
+面向 TypeScript/Node.js 的独立、可复用的 **Pixiv App API 客户端 kit**。
+
+它懂 Pixiv，但**不懂你的应用**：没有配置 schema、没有数据库、没有浏览器登录、
+没有调度器。它目前作为 npm 工作区包存在于 PixivFlow 单仓库内，且有意
+**尚未发布**（见下文「何时拆分到独立仓库」）。
 
 ```ts
 import { createPixivClient, StaticTokenProvider } from '@redtidev/pixiv-client';
@@ -17,87 +18,80 @@ 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                                        |
+## 特性
+
+- **认证端口，而非登录实现** —— 注入任何实现了 `AccessTokenProvider`
+  （可选 `RefreshableAccessTokenProvider`）的对象。浏览器 OAuth/PKCE、
+  puppeteer 与 python 辅助逻辑留在宿主应用中。
+- **单一传输层**服务所有调用：base URL、App 头、Bearer 认证、超时
+  （`AbortController`）、HTTP(S) 代理（undici）与 SOCKS 代理
+  （axios + socks-proxy-agent）、响应解析、类型化错误。
+- **类型化错误** —— `PixivNotFoundError`、`PixivRateLimitError`、
+  `PixivAuthenticationError`、`PixivServerError`、`PixivNetworkError`、
+  `PixivTimeoutError`、`PixivCircuitOpenError` 等，用 `instanceof` 分类，
+  绝不用 `message.includes('429')`。
+- **单一 429 闸门** —— 一个全局限速器为所有请求节流，并施加同一份冷却。
+  没有嵌套重试，也没有请求风暴。
+- **槽位预约式节流** —— 并发调用方被串行化到 t、t+interval、
+  t+2·interval…（旧的协调器会把它们在同一瞬间唤醒）。
+- **保守默认值**：最小间隔 1000 ms，抖动 25 %，首次 429 冷却 60 s，
+  指数退避 60→120→240→480 s，上限 15 min，Retry-After 始终作为下限被遵守。
+- **惩罚衰减** —— 一次成功绝不会清除惩罚；需连续成功达到可配置次数
+  （默认 20）后才衰减。
+- **熔断器** —— 反复 429 会 OPEN 闸门；请求以 `PixivCircuitOpenError`
+  快速失败；冷却结束后以一次半开探测检验恢复情况。
+- **持久化状态端口** —— 注入 `RateLimitStateStore`（例如 SQLite 适配器），
+  让重启 / 部署后仍记得生效中的冷却。默认是内存实现。
+- **在途请求合并** —— 10 个并发的 `get(123)` 只会发出 1 次 HTTP 请求。
+- **分页但不自动爬取** —— `searchPage`/`rankingPage` 加上可选的
+  `paginate()` 辅助函数；始终受 `limit`/`maxPages` 约束，并支持
+  `AbortSignal`。
+- **结构化事件**（通过 `onEvent`）：`request_start`、`request_retry`、
+  `rate_limited`、`circuit_opened`、`auth_refresh` 等。凭据绝不会被记录或发出。
+
+## 重试归属
+
+| 失败 | 归属方 |
 | ------------------------------- | -------------------------------------------- |
-| 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                                |
+| 网络重置 / 超时 / 5xx | 传输层重试（默认 2 次），线性退避 |
+| 熔断处于 CLOSED 时的 429 | 传输层等待共享闸门冷却 |
+| 超过熔断 OPEN 阈值后的 429 | 快速失败；持久化重试属于宿主（调度器 / outbox） |
+| 401 | 一次 `refreshAccessToken()` + 重试，随后报错 |
+| 400 / 403 / 404 | 永不重试 |
 
-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.
+该 kit 绝不会在 429 时轮换代理或 IP，也绝不在 App API 与 Web API 之间
+切换以规避速率限制。端点能力回退（小说正文 v2→v1/ajax 链）是允许的；
+反速率限制的轮换不允许。
 
-## API surface
+## API 接口面
 
 - `createPixivClient(options)` / `new PixivClient(options)`
-- `pixiv.illustrations` — `get/detail`, `detailWithTags`, `searchPage`,
-  `search`, `rankingPage`, `ranking`, `userWorksPage`, `listByUser`,
+- `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.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.users.user(userId)`（Pixiv 已移除 `/v1/user/profile`，因此没有「当前用户」端点）
 - `pixiv.media.fetch(url)` → `ArrayBuffer`
-- `pixiv.getRateLimitStatus()` — `{ circuitState, cooldownRemainingMs, penaltyLevel, last429At, nextAllowedInMs }`
+- `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`.
+该包对宿主类型（`TargetConfig`、调度器、SQLite、投递等）一无所知。
+把宿主查询映射为 kit 选项是宿主的职责，例如
+`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.
+1. 出现第二个真实消费方（另一个 bot、一个 Electron 客户端、一个独立
+   下载器等）—— 仅靠 PixivFlow 不足以支撑跨仓库的版本协调。
+2. 公开 API 已稳定运行一段时间，且宿主适配器已不再频繁变动。
 
-At that point: history-split `packages/pixiv-client` → its own repo →
-publish `@redtidev/pixiv-client` and depend on the released version.
+到那时：用 history-split 把 `packages/pixiv-client` 拆到独立仓库 →
+发布 `@redtidev/pixiv-client` 并依赖已发布版本。
 
-## License
+## 许可证
 
 MIT

package/node_modules/@redtidev/pixiv-client/dist/rate-limit/RateLimitGate.d.ts

@@ -49,7 +49,7 @@ export declare class RateLimitGate {
     private reservationQueue;
     /**
      * Synchronously warm the state from a state store whose load() is sync
-     * (MemoryRateLimitStateStore, better-sqlite3, ...). Reservation in
+     * (MemoryRateLimitStateStore, node:sqlite-backed stores, ...). Reservation in
      * {@link acquire} then happens with NO preceding await, which is what makes
      * concurrent callers serialize (A 0s, B 1s, C 2s ...).
      */

package/node_modules/@redtidev/pixiv-client/dist/rate-limit/RateLimitGate.js

@@ -84,7 +84,7 @@ class RateLimitGate {
     reservationQueue = Promise.resolve();
     /**
      * Synchronously warm the state from a state store whose load() is sync
-     * (MemoryRateLimitStateStore, better-sqlite3, ...). Reservation in
+     * (MemoryRateLimitStateStore, node:sqlite-backed stores, ...). Reservation in
      * {@link acquire} then happens with NO preceding await, which is what makes
      * concurrent callers serialize (A 0s, B 1s, C 2s ...).
      */

package/node_modules/@redtidev/pixiv-client/src/rate-limit/RateLimitGate.ts

@@ -104,7 +104,7 @@ export class RateLimitGate {
 
   /**
    * Synchronously warm the state from a state store whose load() is sync
-   * (MemoryRateLimitStateStore, better-sqlite3, ...). Reservation in
+   * (MemoryRateLimitStateStore, node:sqlite-backed stores, ...). Reservation in
    * {@link acquire} then happens with NO preceding await, which is what makes
    * concurrent callers serialize (A 0s, B 1s, C 2s ...).
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixivflow",
-  "version": "2.17.0",
+  "version": "2.18.0",
   "description": "🎨 智能的 Pixiv 自动化下载工具 - 支持批量下载插画和小说、定时任务、Docker部署 | Intelligent Pixiv Automation Downloader with batch download, scheduler, and Docker support",
   "repository": {
     "type": "git",
@@ -37,6 +37,7 @@
     "test:scheduled": "jest --runTestsByPath src/__tests__/integration/download-flow.test.ts",
     "test:concurrency": "jest --runTestsByPath src/__tests__/utils/concurrency.test.ts",
     "test:performance": "jest --runInBand src/__tests__/performance",
+    "smoke:package": "node scripts/package-smoke.mjs",
     "benchmark": "npm run test:performance",
     "analyze:complexity": "node scripts/analyze-complexity.js",
     "analyze:unused": "npx ts-prune",
@@ -88,7 +89,6 @@
     "tags:cleanup:dry-run": "./scripts/cleanup-github-tags.sh --dry-run"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
     "@types/cors": "^2.8.19",
     "@types/express": "^4.17.21",
     "@types/jest": "^29.5.0",
@@ -100,7 +100,6 @@
     "kill-port": "^2.0.1",
     "nodemon": "^3.1.14",
     "npm-run-all": "^4.1.5",
-    "puppeteer": "^24.43.1",
     "ts-jest": "^29.4.12",
     "typescript": "^5.6.2"
   },
@@ -118,27 +117,27 @@
   "dependencies": {
     "@redtidev/pixiv-client": "0.1.0",
     "axios": "^1.20.0",
-    "better-sqlite3": "^12.11.1",
     "cors": "^2.8.6",
     "cron-parser": "^4.9.0",
     "express": "^4.22.2",
     "franc-min": "^6.2.0",
     "node-cron": "^4.6.0",
-    "pixiv-token-getter": "^2.4.0",
+    "pixiv-token-getter": "^2.6.1",
+    "puppeteer-core": "^25.9.0",
     "socket.io": "^4.8.3",
     "socks-proxy-agent": "^8.0.5",
     "undici": "^6.28.0"
   },
   "engines": {
-    "node": ">=22.12.0",
+    "node": ">=22.13.0",
     "npm": ">=9.0.0"
   },
   "files": [
     "dist/",
-    "config/standalone.config.example.json",
+    "config/examples/",
     "config/fly-two-bots.example.json",
     "README.md",
-    "README_EN.md",
+    "README.en.md",
     "LICENSE"
   ],
   "keywords": [