@moontaiworks/fanbox-dl 1.0.0

package/dist/esm/client.js

@@ -0,0 +1,102 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _FanboxClient_instances, _FanboxClient_baseUrl, _FanboxClient_headers, _FanboxClient_transport, _FanboxClient_get;
+import { CREATOR_GET_PATH, } from "./endpoints/creator-get.js";
+import { CREATOR_LIST_FOLLOWING_PATH, } from "./endpoints/creator-list-following.js";
+import { PLAN_LIST_CREATOR_PATH, } from "./endpoints/plan-list-creator.js";
+import { PLAN_LIST_SUPPORTING_PATH, } from "./endpoints/plan-list-supporting.js";
+import { POST_INFO_PATH, } from "./endpoints/post-info.js";
+import { POST_LIST_CREATOR_PATH, } from "./endpoints/post-list-creator.js";
+import { POST_LIST_HOME_PATH, } from "./endpoints/post-list-home.js";
+import { POST_LIST_SUPPORTING_PATH, } from "./endpoints/post-list-supporting.js";
+import { POST_PAGINATE_CREATOR_PATH, } from "./endpoints/post-paginate-creator.js";
+import { createFanboxRequestHeaders } from "./fanbox-headers.js";
+import { Http2Transport, } from "./http.js";
+const DEFAULT_BASE_URL = "https://api.fanbox.cc";
+export class FanboxApiError extends Error {
+    constructor(response, body) {
+        super(`FANBOX API request failed: ${response.status} ${response.statusText}`);
+        this.name = "FanboxApiError";
+        this.body = body;
+        this.status = response.status;
+        this.statusText = response.statusText;
+    }
+}
+export class FanboxClient {
+    constructor(options = {}) {
+        _FanboxClient_instances.add(this);
+        _FanboxClient_baseUrl.set(this, void 0);
+        _FanboxClient_headers.set(this, void 0);
+        _FanboxClient_transport.set(this, void 0);
+        __classPrivateFieldSet(this, _FanboxClient_baseUrl, options.baseUrl ?? DEFAULT_BASE_URL, "f");
+        __classPrivateFieldSet(this, _FanboxClient_headers, createFanboxRequestHeaders({
+            cookie: options.cookie,
+            userAgent: options.userAgent,
+        }), "f");
+        __classPrivateFieldSet(this, _FanboxClient_transport, options.transport ?? new Http2Transport(), "f");
+    }
+    getCreator(params) {
+        return __classPrivateFieldGet(this, _FanboxClient_instances, "m", _FanboxClient_get).call(this, CREATOR_GET_PATH, params);
+    }
+    getPost(params) {
+        return __classPrivateFieldGet(this, _FanboxClient_instances, "m", _FanboxClient_get).call(this, POST_INFO_PATH, params);
+    }
+    listCreatorPlans(params) {
+        return __classPrivateFieldGet(this, _FanboxClient_instances, "m", _FanboxClient_get).call(this, PLAN_LIST_CREATOR_PATH, params);
+    }
+    listCreatorPosts(params) {
+        return __classPrivateFieldGet(this, _FanboxClient_instances, "m", _FanboxClient_get).call(this, POST_LIST_CREATOR_PATH, params);
+    }
+    listFollowingCreators() {
+        return __classPrivateFieldGet(this, _FanboxClient_instances, "m", _FanboxClient_get).call(this, CREATOR_LIST_FOLLOWING_PATH);
+    }
+    listHomePosts(params = {}) {
+        return __classPrivateFieldGet(this, _FanboxClient_instances, "m", _FanboxClient_get).call(this, POST_LIST_HOME_PATH, params);
+    }
+    listSupportingPlans() {
+        return __classPrivateFieldGet(this, _FanboxClient_instances, "m", _FanboxClient_get).call(this, PLAN_LIST_SUPPORTING_PATH);
+    }
+    listSupportingPosts(params = {}) {
+        return __classPrivateFieldGet(this, _FanboxClient_instances, "m", _FanboxClient_get).call(this, POST_LIST_SUPPORTING_PATH, params);
+    }
+    paginateCreatorPosts(params) {
+        return __classPrivateFieldGet(this, _FanboxClient_instances, "m", _FanboxClient_get).call(this, POST_PAGINATE_CREATOR_PATH, params);
+    }
+}
+_FanboxClient_baseUrl = new WeakMap(), _FanboxClient_headers = new WeakMap(), _FanboxClient_transport = new WeakMap(), _FanboxClient_instances = new WeakSet(), _FanboxClient_get = async function _FanboxClient_get(path, query = {}) {
+    const url = new URL(path, __classPrivateFieldGet(this, _FanboxClient_baseUrl, "f").endsWith("/") ? __classPrivateFieldGet(this, _FanboxClient_baseUrl, "f") : `${__classPrivateFieldGet(this, _FanboxClient_baseUrl, "f")}/`);
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined) {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    const response = await __classPrivateFieldGet(this, _FanboxClient_transport, "f").request({
+        headers: __classPrivateFieldGet(this, _FanboxClient_headers, "f"),
+        method: "GET",
+        url,
+    });
+    const body = await readResponseBody(response);
+    if (!response.ok) {
+        throw new FanboxApiError(response, body);
+    }
+    return body.body;
+};
+async function readResponseBody(response) {
+    const text = await response.text();
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/downloader/asset.d.ts

@@ -0,0 +1,30 @@
+import { type HttpResponse, type HttpTransport } from "../http.js";
+import type { RequestScheduler } from "./scheduler.js";
+export interface AssetDownloaderOptions {
+    headers?: Record<string, string>;
+    scheduler: RequestScheduler;
+    transport?: HttpTransport;
+}
+export interface AssetDownloadOptions {
+    publishedDatetime: string;
+    relativePath: string;
+    rootDirectory: string;
+    url: string;
+}
+export interface AssetDownloadResult {
+    bytes: number;
+    sha256: string;
+}
+export declare class AssetDownloader {
+    #private;
+    constructor(options: AssetDownloaderOptions);
+    download(options: AssetDownloadOptions): Promise<AssetDownloadResult>;
+}
+export declare class AssetDownloadError extends Error {
+    readonly body: unknown;
+    readonly status: number;
+    readonly statusText: string;
+    readonly url: string;
+    constructor(response: HttpResponse, url: string, body: unknown);
+}
+//# sourceMappingURL=asset.d.ts.map

package/dist/esm/downloader/asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../../../src/downloader/asset.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAe;;gBAKP,OAAO,EAAE,sBAAsB;IAMrC,QAAQ,CACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CA8ChC;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,IAAI,EAAE,OAAO,CAAC;IAC9B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAET,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAQtE"}

package/dist/esm/downloader/asset.js

@@ -0,0 +1,91 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AssetDownloader_headers, _AssetDownloader_scheduler, _AssetDownloader_transport;
+import { createHash } from "node:crypto";
+import { createReadStream, createWriteStream } from "node:fs";
+import { mkdir, rename, stat, utimes } from "node:fs/promises";
+import path from "node:path";
+import { pipeline } from "node:stream/promises";
+import { Http2Transport, } from "../http.js";
+import { assertPathBudget } from "./path.js";
+export class AssetDownloader {
+    constructor(options) {
+        _AssetDownloader_headers.set(this, void 0);
+        _AssetDownloader_scheduler.set(this, void 0);
+        _AssetDownloader_transport.set(this, void 0);
+        __classPrivateFieldSet(this, _AssetDownloader_headers, options.headers ?? {}, "f");
+        __classPrivateFieldSet(this, _AssetDownloader_scheduler, options.scheduler, "f");
+        __classPrivateFieldSet(this, _AssetDownloader_transport, options.transport ?? new Http2Transport(), "f");
+    }
+    async download(options) {
+        const destination = path.join(options.rootDirectory, options.relativePath);
+        const temporaryPath = `${destination}.part`;
+        assertPathBudget(temporaryPath);
+        await mkdir(path.dirname(destination), { recursive: true });
+        const partialBytes = await stat(temporaryPath)
+            .then((result) => result.size)
+            .catch(() => 0);
+        const headers = { ...__classPrivateFieldGet(this, _AssetDownloader_headers, "f") };
+        if (partialBytes > 0) {
+            headers.Range = `bytes=${partialBytes}-`;
+        }
+        const response = await __classPrivateFieldGet(this, _AssetDownloader_scheduler, "f").request(() => __classPrivateFieldGet(this, _AssetDownloader_transport, "f").request({
+            headers,
+            method: "GET",
+            url: options.url,
+        }));
+        if (!response.ok) {
+            throw new AssetDownloadError(response, options.url, await readResponseBody(response));
+        }
+        await pipeline(response.body, createWriteStream(temporaryPath, {
+            flags: response.status === 206 && partialBytes > 0 ? "a" : "w",
+        }));
+        await rename(temporaryPath, destination);
+        const modified = response.headers.get("Last-Modified");
+        const timestamp = modified
+            ? new Date(modified)
+            : new Date(options.publishedDatetime);
+        await utimes(destination, timestamp, timestamp);
+        return {
+            bytes: (await stat(destination)).size,
+            sha256: await hashFile(destination),
+        };
+    }
+}
+_AssetDownloader_headers = new WeakMap(), _AssetDownloader_scheduler = new WeakMap(), _AssetDownloader_transport = new WeakMap();
+export class AssetDownloadError extends Error {
+    constructor(response, url, body) {
+        super(`Asset download failed: ${response.status} ${url}`);
+        this.name = "AssetDownloadError";
+        this.body = body;
+        this.status = response.status;
+        this.statusText = response.statusText;
+        this.url = url;
+    }
+}
+async function hashFile(filePath) {
+    const hash = createHash("sha256");
+    for await (const chunk of createReadStream(filePath)) {
+        hash.update(chunk);
+    }
+    return hash.digest("hex");
+}
+async function readResponseBody(response) {
+    const text = await response.text();
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=asset.js.map

package/dist/esm/downloader/asset.js.map

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

package/dist/esm/downloader/cli.d.ts

@@ -0,0 +1,8 @@
+import { type HttpTransport } from "../http.js";
+export interface RunCliDependencies {
+    transport?: HttpTransport;
+    write?: (line: string) => void;
+}
+export declare const DOWNLOAD_HELP = "Usage: fanbox-dl download [options]\n\nDownload FANBOX posts for selected creators.\n\nSelectors:\n  --creator <id>            Add a creator ID. Can be repeated.\n  --following               Add all followed creators.\n  --supporting              Add all supporting creators.\n  --ignore-creator <id>     Exclude a creator ID. Can be repeated.\n\nAuth:\n  --cookie <value>          Raw session ID or FANBOXSESSID=... cookie.\n  --cookie-file <path>      Read raw cookie or Netscape cookies.txt.\n  --user-agent <value>      Send the User-Agent from your logged-in browser.\n  FANBOX_SESSION_ID         Environment fallback.\n  FANBOX_USER_AGENT         User-Agent environment fallback.\n\nDownload:\n  --output <path>           Output directory. Default: fanbox-downloads.\n  --dry-run                 List creators/posts without downloading or writing.\n  --flat-posts              Store post files directly under each creator.\n  --verify-assets           Verify existing asset size and SHA-256 locally.\n\nRequests:\n  --concurrency <n>         Concurrent requests. Default: 3.\n  --request-interval-ms <n> Delay between request starts. Default: 0.\n  --rate-limit-pause-ms <n> Pause after 429 without Retry-After. Default: 60000.\n  --max-retries <n>         Retry attempts. Default: 5.\n\nOutput:\n  --log-format json|pretty  Default: json.\n  --log-level <level>       debug|info|warn|error. Default: info.\n  --help                    Show this help.\n";
+export declare function runCli(args: string[], env?: NodeJS.ProcessEnv, dependencies?: RunCliDependencies): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/esm/downloader/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/downloader/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAWhE,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,aAAa,w7CAiCzB,CAAC;AAEF,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,YAAY,GAAE,kBAAuB,GACpC,OAAO,CAAC,MAAM,CAAC,CAqHjB"}

package/dist/esm/downloader/cli.js

@@ -0,0 +1,164 @@
+import { FanboxClient } from "../client.js";
+import { createFanboxRequestHeaders } from "../fanbox-headers.js";
+import { Http2Transport } from "../http.js";
+import { AssetDownloader } from "./asset.js";
+import { discoverCreatorPosts } from "./discovery.js";
+import { logDebugErrorResponse } from "./errors.js";
+import { createLogger } from "./logger.js";
+import { CliUsageError, parseDownloadOptions } from "./options.js";
+import { assertPathBudget } from "./path.js";
+import { resolveCreatorIds } from "./resolver.js";
+import { RequestScheduler } from "./scheduler.js";
+import { syncCreator } from "./sync.js";
+export const DOWNLOAD_HELP = `Usage: fanbox-dl download [options]
+
+Download FANBOX posts for selected creators.
+
+Selectors:
+  --creator <id>            Add a creator ID. Can be repeated.
+  --following               Add all followed creators.
+  --supporting              Add all supporting creators.
+  --ignore-creator <id>     Exclude a creator ID. Can be repeated.
+
+Auth:
+  --cookie <value>          Raw session ID or FANBOXSESSID=... cookie.
+  --cookie-file <path>      Read raw cookie or Netscape cookies.txt.
+  --user-agent <value>      Send the User-Agent from your logged-in browser.
+  FANBOX_SESSION_ID         Environment fallback.
+  FANBOX_USER_AGENT         User-Agent environment fallback.
+
+Download:
+  --output <path>           Output directory. Default: fanbox-downloads.
+  --dry-run                 List creators/posts without downloading or writing.
+  --flat-posts              Store post files directly under each creator.
+  --verify-assets           Verify existing asset size and SHA-256 locally.
+
+Requests:
+  --concurrency <n>         Concurrent requests. Default: 3.
+  --request-interval-ms <n> Delay between request starts. Default: 0.
+  --rate-limit-pause-ms <n> Pause after 429 without Retry-After. Default: 60000.
+  --max-retries <n>         Retry attempts. Default: 5.
+
+Output:
+  --log-format json|pretty  Default: json.
+  --log-level <level>       debug|info|warn|error. Default: info.
+  --help                    Show this help.
+`;
+export async function runCli(args, env = process.env, dependencies = {}) {
+    const write = dependencies.write ?? ((line) => process.stderr.write(`${line}\n`));
+    if (args.includes("--help") || args.includes("-h")) {
+        write(DOWNLOAD_HELP);
+        return 0;
+    }
+    let logger;
+    let transportToClose;
+    try {
+        const options = parseDownloadOptions(args, env);
+        assertPathBudget(options.output);
+        logger = createLogger({
+            format: options.logFormat,
+            level: options.logLevel,
+            write: dependencies.write,
+        });
+        const transport = dependencies.transport ?? new Http2Transport();
+        transportToClose = dependencies.transport ? undefined : transport;
+        const requestHeaders = createFanboxRequestHeaders({
+            cookie: options.cookie,
+            userAgent: options.userAgent,
+        });
+        const scheduler = new RequestScheduler({
+            concurrency: options.concurrency,
+            logger,
+            maxRetries: options.maxRetries,
+            rateLimitPauseMs: options.rateLimitPauseMs,
+            requestIntervalMs: options.requestIntervalMs,
+        });
+        const client = new FanboxClient({
+            cookie: requestHeaders.Cookie,
+            transport: {
+                close: () => transport.close(),
+                request: (request) => scheduler.request(() => transport.request(request)),
+            },
+            userAgent: requestHeaders["User-Agent"],
+        });
+        const creatorIds = await resolveCreatorIds(client, options);
+        if (options.dryRun) {
+            for (const creatorId of creatorIds) {
+                logger.info("dry-run.creator", "Dry-run creator selected", {
+                    creatorId,
+                });
+                for (const post of await discoverCreatorPosts(client, creatorId, {
+                    logger,
+                })) {
+                    logger.info("dry-run.post", "Dry-run post discovered", {
+                        creatorId,
+                        postId: post.id,
+                        restricted: post.isRestricted,
+                        title: post.title,
+                        updatedDatetime: post.updatedDatetime,
+                    });
+                }
+            }
+            return 0;
+        }
+        const assetDownloader = new AssetDownloader({
+            headers: requestHeaders,
+            scheduler,
+            transport,
+        });
+        let failed = false;
+        for (const creatorId of creatorIds) {
+            logger.info("creator.sync.start", "Creator sync started", { creatorId });
+            try {
+                const manifest = await syncCreator({
+                    assetDownloader,
+                    client,
+                    creatorId,
+                    flatPosts: options.flatPosts,
+                    logger,
+                    outputDirectory: options.output,
+                    verifyAssets: options.verifyAssets,
+                });
+                failed || (failed = hasFailures(manifest));
+                logger.info("creator.sync.complete", "Creator sync completed", {
+                    creatorId,
+                });
+            }
+            catch (error) {
+                failed = true;
+                logDebugErrorResponse(logger, error);
+                logger.error("creator.sync.failed", "Creator sync failed", {
+                    creatorId,
+                    error: String(error),
+                });
+            }
+        }
+        return failed ? 1 : 0;
+    }
+    catch (error) {
+        const usage = error instanceof CliUsageError;
+        const message = String(error);
+        if (usage) {
+            write(`${message}\n\n${DOWNLOAD_HELP}`);
+        }
+        else {
+            if (logger) {
+                logDebugErrorResponse(logger, error);
+            }
+            write(JSON.stringify({
+                event: "cli.failed",
+                level: "error",
+                msg: message,
+                time: new Date().toISOString(),
+            }));
+        }
+        return usage ? 2 : 1;
+    }
+    finally {
+        await transportToClose?.close();
+    }
+}
+function hasFailures(manifest) {
+    return Object.values(manifest.posts).some((post) => post?.status === "failed");
+}
+//# sourceMappingURL=cli.js.map

package/dist/esm/downloader/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/downloader/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAsB,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAOxC,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC5B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAc,EACd,MAAyB,OAAO,CAAC,GAAG,EACpC,eAAmC,EAAE;IAErC,MAAM,KAAK,GACT,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;IAC9E,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,aAAa,CAAC,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAA0B,CAAC;IAC/B,IAAI,gBAA2C,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAChD,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,GAAG,YAAY,CAAC;YACpB,MAAM,EAAE,OAAO,CAAC,SAAS;YACzB,KAAK,EAAE,OAAO,CAAC,QAAQ;YACvB,KAAK,EAAE,YAAY,CAAC,KAAK;SAC1B,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,IAAI,IAAI,cAAc,EAAE,CAAC;QACjE,gBAAgB,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAClE,MAAM,cAAc,GAAG,0BAA0B,CAAC;YAChD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC;YACrC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM;YACN,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC7C,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;YAC9B,MAAM,EAAE,cAAc,CAAC,MAAM;YAC7B,SAAS,EAAE;gBACT,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE;gBAC9B,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CACnB,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;aACtD;YACD,SAAS,EAAE,cAAc,CAAC,YAAY,CAAC;SACxC,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,0BAA0B,EAAE;oBACzD,SAAS;iBACV,CAAC,CAAC;gBACH,KAAK,MAAM,IAAI,IAAI,MAAM,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE;oBAC/D,MAAM;iBACP,CAAC,EAAE,CAAC;oBACH,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,yBAAyB,EAAE;wBACrD,SAAS;wBACT,MAAM,EAAE,IAAI,CAAC,EAAE;wBACf,UAAU,EAAE,IAAI,CAAC,YAAY;wBAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;wBACjB,eAAe,EAAE,IAAI,CAAC,eAAe;qBACtC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC;YAC1C,OAAO,EAAE,cAAc;YACvB,SAAS;YACT,SAAS;SACV,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,sBAAsB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC;oBACjC,eAAe;oBACf,MAAM;oBACN,SAAS;oBACT,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM;oBACN,eAAe,EAAE,OAAO,CAAC,MAAM;oBAC/B,YAAY,EAAE,OAAO,CAAC,YAAY;iBACnC,CAAC,CAAC;gBACH,MAAM,KAAN,MAAM,GAAK,WAAW,CAAC,QAAQ,CAAC,EAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,wBAAwB,EAAE;oBAC7D,SAAS;iBACV,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,IAAI,CAAC;gBACd,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACrC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,qBAAqB,EAAE;oBACzD,SAAS;oBACT,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,KAAK,YAAY,aAAa,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,GAAG,OAAO,OAAO,aAAa,EAAE,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,IAAI,MAAM,EAAE,CAAC;gBACX,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACvC,CAAC;YACD,KAAK,CACH,IAAI,CAAC,SAAS,CAAC;gBACb,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,OAAO;gBACd,GAAG,EAAE,OAAO;gBACZ,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC/B,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAClB,QAAiD;IAEjD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CACvC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CACpC,CAAC;AACJ,CAAC"}

package/dist/esm/downloader/discovery.d.ts

@@ -0,0 +1,12 @@
+import type { ListCreatorPostsParams, PaginateCreatorPostsParams, PostSummary } from "../types.js";
+import type { Logger } from "./logger.js";
+export interface CreatorPostClient {
+    listCreatorPosts(params: ListCreatorPostsParams): Promise<PostSummary[]>;
+    paginateCreatorPosts(params: PaginateCreatorPostsParams): Promise<string[]>;
+}
+export interface DiscoverCreatorPostsOptions {
+    logger?: Logger;
+    pageSize?: number;
+}
+export declare function discoverCreatorPosts(client: CreatorPostClient, creatorId: string, options?: DiscoverCreatorPostsOptions): Promise<PostSummary[]>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/esm/downloader/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/downloader/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAK1C,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACzE,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,WAAW,EAAE,CAAC,CAqDxB"}

package/dist/esm/downloader/discovery.js

@@ -0,0 +1,84 @@
+import { logDebugErrorResponse } from "./errors.js";
+import { silentLogger } from "./logger.js";
+const DEFAULT_PAGE_SIZE = 300;
+export async function discoverCreatorPosts(client, creatorId, options = {}) {
+    const logger = options.logger ?? silentLogger;
+    const pageSize = options.pageSize ?? DEFAULT_PAGE_SIZE;
+    const found = new Map();
+    let cursor = {
+        creatorId,
+        limit: pageSize,
+        sort: "newest",
+    };
+    for (;;) {
+        let page;
+        try {
+            page = await client.listCreatorPosts(cursor);
+        }
+        catch (error) {
+            logDebugErrorResponse(logger, error, { creatorId });
+            logger.warn("post.discovery.fallback", "Direct cursor failed; using paginateCreator", {
+                creatorId,
+                error: String(error),
+            });
+            await fallbackPaginate(client, creatorId, found);
+            break;
+        }
+        const added = addPosts(page, found);
+        if (page.length < pageSize) {
+            break;
+        }
+        if (added === 0) {
+            logger.warn("post.discovery.fallback", "Direct cursor made no progress; using paginateCreator", {
+                creatorId,
+            });
+            await fallbackPaginate(client, creatorId, found);
+            break;
+        }
+        const last = page.at(-1);
+        cursor = {
+            creatorId,
+            firstId: last.id,
+            firstPublishedDatetime: last.publishedDatetime,
+            limit: pageSize,
+            sort: "newest",
+        };
+    }
+    return [...found.values()];
+}
+function addPosts(posts, found) {
+    let added = 0;
+    for (const post of posts) {
+        if (!found.has(post.id)) {
+            added += 1;
+            found.set(post.id, post);
+        }
+    }
+    return added;
+}
+function cursorFromUrl(url) {
+    const parsed = new URL(url);
+    const creatorId = parsed.searchParams.get("creatorId");
+    if (!creatorId) {
+        return undefined;
+    }
+    return {
+        creatorId,
+        firstId: parsed.searchParams.get("firstId") ?? undefined,
+        firstPublishedDatetime: parsed.searchParams.get("firstPublishedDatetime") ?? undefined,
+        limit: Number(parsed.searchParams.get("limit") ?? DEFAULT_PAGE_SIZE),
+        sort: "newest",
+    };
+}
+async function fallbackPaginate(client, creatorId, found) {
+    for (const url of await client.paginateCreatorPosts({
+        creatorId,
+        sort: "newest",
+    })) {
+        const cursor = cursorFromUrl(url);
+        if (cursor) {
+            addPosts(await client.listCreatorPosts(cursor), found);
+        }
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/esm/downloader/discovery.js.map

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

package/dist/esm/downloader/errors.d.ts

@@ -0,0 +1,5 @@
+import type { HttpResponse } from "../http.js";
+import type { LogFields, Logger } from "./logger.js";
+export declare function logDebugErrorResponse(logger: Logger, error: unknown, fields?: LogFields): void;
+export declare function logDebugResponse(logger: Logger, response: HttpResponse, fields?: LogFields): Promise<void>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/downloader/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/downloader/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQrD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,SAAc,GACrB,IAAI,CAWN;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,EACtB,MAAM,GAAE,SAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/esm/downloader/errors.js

@@ -0,0 +1,36 @@
+export function logDebugErrorResponse(logger, error, fields = {}) {
+    if (!isResponseLikeError(error)) {
+        return;
+    }
+    logger.debug("api.response.error", "HTTP error response", {
+        ...fields,
+        body: error.body,
+        status: error.status,
+        statusText: error.statusText,
+    });
+}
+export async function logDebugResponse(logger, response, fields = {}) {
+    logger.debug("api.response.error", "HTTP error response", {
+        ...fields,
+        body: await readResponseBody(response),
+        status: response.status,
+        statusText: response.statusText,
+    });
+}
+function isResponseLikeError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "body" in error &&
+        "status" in error &&
+        typeof error.status === "number");
+}
+async function readResponseBody(response) {
+    const text = await response.text();
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/downloader/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/downloader/errors.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,KAAc,EACd,SAAoB,EAAE;IAEtB,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO;IACT,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,qBAAqB,EAAE;QACxD,GAAG,MAAM;QACT,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,QAAsB,EACtB,SAAoB,EAAE;IAEtB,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,qBAAqB,EAAE;QACxD,GAAG,MAAM;QACT,IAAI,EAAE,MAAM,gBAAgB,CAAC,QAAQ,CAAC;QACtC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,QAAQ,IAAI,KAAK;QACjB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CACjC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAsB;IACpD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/esm/downloader/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/downloader/index.d.ts.map

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

package/dist/esm/downloader/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { runCli } from "./cli.js";
+void runCli(process.argv.slice(2)).then((exitCode) => {
+    process.exitCode = exitCode;
+});
+//# sourceMappingURL=index.js.map

package/dist/esm/downloader/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/downloader/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;IACnD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC9B,CAAC,CAAC,CAAC"}

package/dist/esm/downloader/logger.d.ts

@@ -0,0 +1,16 @@
+export interface CreateLoggerOptions {
+    format?: "json" | "pretty";
+    level?: LogLevel;
+    write?: (line: string) => void;
+}
+export type LogFields = Record<string, unknown>;
+export interface Logger {
+    debug(event: string, message: string, fields?: LogFields): void;
+    error(event: string, message: string, fields?: LogFields): void;
+    info(event: string, message: string, fields?: LogFields): void;
+    warn(event: string, message: string, fields?: LogFields): void;
+}
+export type LogLevel = "debug" | "error" | "info" | "warn";
+export declare function createLogger(options?: CreateLoggerOptions): Logger;
+export declare const silentLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/esm/downloader/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/downloader/logger.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAChE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CAChE;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAS3D,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA0CtE;AAED,eAAO,MAAM,YAAY,EAAE,MAK1B,CAAC"}