@moontaiworks/fanbox-dl 1.0.0

package/dist/cjs/downloader/manifest.js

@@ -0,0 +1,53 @@
+"use strict";
+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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _ManifestStore_creatorDirectory, _ManifestStore_manifestPath;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManifestStore = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const path_js_1 = require("./path.js");
+class ManifestStore {
+    constructor(outputDirectory, creatorId) {
+        _ManifestStore_creatorDirectory.set(this, void 0);
+        _ManifestStore_manifestPath.set(this, void 0);
+        __classPrivateFieldSet(this, _ManifestStore_creatorDirectory, node_path_1.default.join(outputDirectory, (0, path_js_1.createCreatorDirectoryName)(creatorId, outputDirectory)), "f");
+        __classPrivateFieldSet(this, _ManifestStore_manifestPath, node_path_1.default.join(__classPrivateFieldGet(this, _ManifestStore_creatorDirectory, "f"), "manifest.json"), "f");
+    }
+    async load() {
+        try {
+            return JSON.parse(await (0, promises_1.readFile)(__classPrivateFieldGet(this, _ManifestStore_manifestPath, "f"), "utf8"));
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+            return {
+                creatorId: node_path_1.default.basename(__classPrivateFieldGet(this, _ManifestStore_creatorDirectory, "f")),
+                posts: {},
+                schemaVersion: 1,
+            };
+        }
+    }
+    async save(manifest) {
+        await (0, promises_1.mkdir)(__classPrivateFieldGet(this, _ManifestStore_creatorDirectory, "f"), { recursive: true });
+        const temporaryPath = `${__classPrivateFieldGet(this, _ManifestStore_manifestPath, "f")}.tmp`;
+        await (0, promises_1.writeFile)(temporaryPath, `${JSON.stringify(manifest, null, 2)}\n`);
+        await (0, promises_1.rename)(temporaryPath, __classPrivateFieldGet(this, _ManifestStore_manifestPath, "f"));
+    }
+}
+exports.ManifestStore = ManifestStore;
+_ManifestStore_creatorDirectory = new WeakMap(), _ManifestStore_manifestPath = new WeakMap();
+//# sourceMappingURL=manifest.js.map

package/dist/cjs/downloader/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/downloader/manifest.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,+CAAsE;AACtE,0DAA6B;AAE7B,uCAAuD;AAmCvD,MAAa,aAAa;IAIxB,YAAmB,eAAuB,EAAE,SAAiB;QAHpD,kDAA0B;QAC1B,8CAAsB;QAG7B,uBAAA,IAAI,mCAAqB,mBAAI,CAAC,IAAI,CAChC,eAAe,EACf,IAAA,oCAA0B,EAAC,SAAS,EAAE,eAAe,CAAC,CACvD,MAAA,CAAC;QACF,uBAAA,IAAI,+BAAiB,mBAAI,CAAC,IAAI,CAAC,uBAAA,IAAI,uCAAkB,EAAE,eAAe,CAAC,MAAA,CAAC;IAC1E,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CACf,MAAM,IAAA,mBAAQ,EAAC,uBAAA,IAAI,mCAAc,EAAE,MAAM,CAAC,CACxB,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,MAAM,KAAK,CAAC;YACd,CAAC;YAED,OAAO;gBACL,SAAS,EAAE,mBAAI,CAAC,QAAQ,CAAC,uBAAA,IAAI,uCAAkB,CAAC;gBAChD,KAAK,EAAE,EAAE;gBACT,aAAa,EAAE,CAAC;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,QAAyB;QACzC,MAAM,IAAA,gBAAK,EAAC,uBAAA,IAAI,uCAAkB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,aAAa,GAAG,GAAG,uBAAA,IAAI,mCAAc,MAAM,CAAC;QAClD,MAAM,IAAA,oBAAS,EAAC,aAAa,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,IAAA,iBAAM,EAAC,aAAa,EAAE,uBAAA,IAAI,mCAAc,CAAC,CAAC;IAClD,CAAC;CACF;AApCD,sCAoCC"}

package/dist/cjs/downloader/markdown.d.ts

@@ -0,0 +1,4 @@
+import type { Post } from "../types.js";
+export type AssetPathMap = ReadonlyMap<string, string>;
+export declare function renderPostMarkdown(post: Post, paths: AssetPathMap): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/cjs/downloader/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/downloader/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,IAAI,EAGL,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAwC1E"}

package/dist/cjs/downloader/markdown.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPostMarkdown = renderPostMarkdown;
+function renderPostMarkdown(post, paths) {
+    let content;
+    switch (post.type) {
+        case "article":
+            content = renderArticle(post, paths);
+            break;
+        case "file": {
+            const filePost = post;
+            content = [
+                filePost.body.text,
+                ...filePost.body.files.map((file) => `[${file.name}](${assetLink(paths, `file:${file.id}`)})`),
+            ].join("\n\n");
+            break;
+        }
+        case "image": {
+            const imagePost = post;
+            content = [
+                imagePost.body.text,
+                ...imagePost.body.images.map((image) => `![${image.id}](./${assetLink(paths, `image:${image.id}`)})`),
+            ].join("\n\n");
+            break;
+        }
+        case "text":
+            content = post.body.text;
+            break;
+        case "video": {
+            const videoPost = post;
+            content = `${videoPost.body.text}\n\n${videoPost.body.video.serviceProvider}: ${videoPost.body.video.videoId}`;
+            break;
+        }
+        default:
+            content = `[unsupported post type: ${post.type}]`;
+    }
+    return `# ${post.title}\n\n${content.trim()}\n`;
+}
+function assetLink(paths, key) {
+    return paths.get(key) ?? `[missing asset: ${key}]`;
+}
+function renderArticle(post, paths) {
+    return post.body.blocks
+        .map((block) => {
+        switch (block.type) {
+            case "file":
+                return `[${String(block.fileId)}](${assetLink(paths, `file:${String(block.fileId)}`)})`;
+            case "header":
+                return `# ${String(block.text)}`;
+            case "image":
+                return `![${String(block.imageId)}](${assetLink(paths, `image:${String(block.imageId)}`)})`;
+            case "p":
+                return String(block.text);
+            case "url_embed":
+                return String(post.body.urlEmbedMap[String(block.urlEmbedId)] ?? block.urlEmbedId);
+            default:
+                return `[unsupported block: ${block.type}]`;
+        }
+    })
+        .join("\n\n");
+}
+//# sourceMappingURL=markdown.js.map

package/dist/cjs/downloader/markdown.js.map

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

package/dist/cjs/downloader/options.d.ts

@@ -0,0 +1,24 @@
+import type { LogLevel } from "./logger.js";
+export interface DownloadOptions {
+    concurrency: number;
+    cookie?: string;
+    creatorIds: string[];
+    dryRun: boolean;
+    flatPosts: boolean;
+    following: boolean;
+    ignoreCreatorIds: string[];
+    logFormat: "json" | "pretty";
+    logLevel: LogLevel;
+    maxRetries: number;
+    output: string;
+    rateLimitPauseMs: number;
+    requestIntervalMs: number;
+    supporting: boolean;
+    userAgent?: string;
+    verifyAssets: boolean;
+}
+export declare class CliUsageError extends Error {
+    constructor(message: string);
+}
+export declare function parseDownloadOptions(args: string[], env?: NodeJS.ProcessEnv): DownloadOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/cjs/downloader/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/downloader/options.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,aAAc,SAAQ,KAAK;gBACnB,OAAO,EAAE,MAAM;CAInC;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,eAAe,CA8CjB"}

package/dist/cjs/downloader/options.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliUsageError = void 0;
+exports.parseDownloadOptions = parseDownloadOptions;
+const node_fs_1 = require("node:fs");
+const node_util_1 = require("node:util");
+class CliUsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CliUsageError";
+    }
+}
+exports.CliUsageError = CliUsageError;
+function parseDownloadOptions(args, env = process.env) {
+    const { values } = parseDownloadArgs(args);
+    const creatorIds = values.creator ?? [];
+    if (creatorIds.length === 0 && !values.following && !values.supporting) {
+        throw new CliUsageError("at least one creator selector is required");
+    }
+    if (values["log-format"] !== "json" && values["log-format"] !== "pretty") {
+        throw new CliUsageError("log-format must be json or pretty");
+    }
+    if (!isLogLevel(values["log-level"])) {
+        throw new CliUsageError("log-level must be debug, info, warn, or error");
+    }
+    const cookieFile = values["cookie-file"];
+    const cookie = normalizeCookie(values.cookie ??
+        (cookieFile === undefined
+            ? undefined
+            : (0, node_fs_1.readFileSync)(cookieFile, "utf8")) ??
+        env.FANBOX_SESSION_ID);
+    return {
+        concurrency: parsePositiveInteger("concurrency", values.concurrency),
+        cookie,
+        creatorIds,
+        dryRun: values["dry-run"],
+        flatPosts: values["flat-posts"],
+        following: values.following,
+        ignoreCreatorIds: values["ignore-creator"] ?? [],
+        logFormat: values["log-format"],
+        logLevel: values["log-level"],
+        maxRetries: parseNonNegativeInteger("max-retries", values["max-retries"]),
+        output: values.output,
+        rateLimitPauseMs: parseNonNegativeInteger("rate-limit-pause-ms", values["rate-limit-pause-ms"]),
+        requestIntervalMs: parseNonNegativeInteger("request-interval-ms", values["request-interval-ms"]),
+        supporting: values.supporting,
+        userAgent: values["user-agent"],
+        verifyAssets: values["verify-assets"],
+    };
+}
+function isFanboxCookieDomain(domain) {
+    const normalized = domain.replace(/^\./, "").toLowerCase();
+    return normalized === "fanbox.cc" || normalized.endsWith(".fanbox.cc");
+}
+function isLogLevel(value) {
+    return (value === "debug" ||
+        value === "info" ||
+        value === "warn" ||
+        value === "error");
+}
+function normalizeCookie(cookie) {
+    const value = cookie?.trim();
+    if (!value) {
+        return undefined;
+    }
+    const cookies = parseNetscapeCookies(value);
+    if (cookies.length > 0) {
+        return cookies.map(({ name, value }) => `${name}=${value}`).join("; ");
+    }
+    return value.includes("=") ? value : `FANBOXSESSID=${value}`;
+}
+function parseDownloadArgs(args) {
+    try {
+        return (0, node_util_1.parseArgs)({
+            allowPositionals: false,
+            args: args.slice(1),
+            options: {
+                concurrency: { default: "3", type: "string" },
+                cookie: { type: "string" },
+                "cookie-file": { type: "string" },
+                creator: { multiple: true, type: "string" },
+                "dry-run": { default: false, type: "boolean" },
+                "flat-posts": { default: false, type: "boolean" },
+                following: { default: false, type: "boolean" },
+                "ignore-creator": { multiple: true, type: "string" },
+                "log-format": { default: "json", type: "string" },
+                "log-level": { default: "info", type: "string" },
+                "max-retries": { default: "5", type: "string" },
+                output: { default: "fanbox-downloads", type: "string" },
+                "rate-limit-pause-ms": { default: "60000", type: "string" },
+                "request-interval-ms": { default: "0", type: "string" },
+                supporting: { default: false, type: "boolean" },
+                "user-agent": { type: "string" },
+                "verify-assets": { default: false, type: "boolean" },
+            },
+            strict: true,
+        });
+    }
+    catch (error) {
+        throw new CliUsageError(error.message);
+    }
+}
+function parseNetscapeCookies(value) {
+    const cookies = [];
+    for (const line of value.split(/\r?\n/)) {
+        if (!line || line.startsWith("#")) {
+            continue;
+        }
+        const columns = line.split("\t");
+        if (columns.length < 7) {
+            continue;
+        }
+        const [domain, , , , , name, cookieValue] = columns;
+        if (!isFanboxCookieDomain(domain)) {
+            continue;
+        }
+        cookies.push({ name, value: cookieValue });
+    }
+    return cookies;
+}
+function parseNonNegativeInteger(name, value) {
+    const number = Number(value);
+    if (!Number.isSafeInteger(number) || number < 0) {
+        throw new CliUsageError(`${name} must be a non-negative integer`);
+    }
+    return number;
+}
+function parsePositiveInteger(name, value) {
+    const number = parseNonNegativeInteger(name, value);
+    if (number === 0) {
+        throw new CliUsageError(`${name} must be a positive integer`);
+    }
+    return number;
+}
+//# sourceMappingURL=options.js.map

package/dist/cjs/downloader/options.js.map

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

package/dist/cjs/downloader/path.d.ts

@@ -0,0 +1,15 @@
+export interface SanitizePathComponentOptions {
+    maxBytes?: number;
+    reserveBytes?: number;
+    suffix?: string;
+}
+export declare function assertPathBudget(absolutePath: string, maxBytes?: number): void;
+export declare function createCreatorDirectoryName(creatorId: string, outputDirectory: string): string;
+export declare function createPostDirectoryName(post: {
+    id: string;
+    publishedDatetime: string;
+    title: string;
+}, parentDirectory?: string): string;
+export declare function sanitizePathComponent(value: string, options?: SanitizePathComponentOptions): string;
+export declare function sanitizePathComponentForDirectory(value: string, directory: string, options?: SanitizePathComponentOptions): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/cjs/downloader/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/downloader/path.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,SAAqB,GAC5B,IAAI,CAMN;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,MAAM,CAIR;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IACJ,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf,EACD,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAWR;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,4BAAiC,GACzC,MAAM,CAiBR;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,4BAAiC,GACzC,MAAM,CAiBR"}

package/dist/cjs/downloader/path.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertPathBudget = assertPathBudget;
+exports.createCreatorDirectoryName = createCreatorDirectoryName;
+exports.createPostDirectoryName = createPostDirectoryName;
+exports.sanitizePathComponent = sanitizePathComponent;
+exports.sanitizePathComponentForDirectory = sanitizePathComponentForDirectory;
+const node_path_1 = __importDefault(require("node:path"));
+const DEFAULT_COMPONENT_BYTES = 120;
+const DEFAULT_PATH_BYTES = 240;
+const RESERVED_NAMES = /^(?:AUX|CON|NUL|PRN|COM[1-9]|LPT[1-9])(?:\..*)?$/i;
+const RESERVED_PREFIX = /^(?:AUX|CON|NUL|PRN|COM[1-9]|LPT[1-9])(?=$|[. <>:"/\\|?*])/i;
+const SEGMENTER = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+function assertPathBudget(absolutePath, maxBytes = DEFAULT_PATH_BYTES) {
+    if (Buffer.byteLength(node_path_1.default.resolve(absolutePath)) > maxBytes) {
+        throw new Error(`Path exceeds ${maxBytes} byte path budget: ${absolutePath}`);
+    }
+}
+function createCreatorDirectoryName(creatorId, outputDirectory) {
+    return sanitizePathComponentForDirectory(creatorId, outputDirectory, {
+        reserveBytes: Buffer.byteLength(`${node_path_1.default.sep}manifest.json`),
+    });
+}
+function createPostDirectoryName(post, parentDirectory) {
+    const date = post.publishedDatetime.slice(0, 10);
+    const prefix = `${date}_${post.id}_`;
+    const options = {
+        maxBytes: DEFAULT_COMPONENT_BYTES - Buffer.byteLength(prefix),
+        reserveBytes: Buffer.byteLength(`${prefix}${node_path_1.default.sep}metadata.json`),
+    };
+    const title = parentDirectory
+        ? sanitizePathComponentForDirectory(post.title, parentDirectory, options)
+        : sanitizePathComponent(post.title, options);
+    return `${prefix}${title}`;
+}
+function sanitizePathComponent(value, options = {}) {
+    const maxBytes = options.maxBytes ?? DEFAULT_COMPONENT_BYTES;
+    const suffix = options.suffix ?? "";
+    let sanitized = Array.from(SEGMENTER.segment(value), ({ segment }) => segment)
+        .map((character) => (character.charCodeAt(0) <= 31 ? "_" : character))
+        .join("")
+        .replaceAll(/[<>:"/\\|?*]/g, "_")
+        .replaceAll(/[. ]+$/g, "");
+    if (RESERVED_NAMES.test(sanitized) || RESERVED_PREFIX.test(value)) {
+        sanitized = `_${sanitized}`;
+    }
+    if (!sanitized) {
+        sanitized = "_";
+    }
+    const suffixBytes = Buffer.byteLength(suffix);
+    return `${truncateUtf8(sanitized, Math.max(0, maxBytes - suffixBytes))}${suffix}`;
+}
+function sanitizePathComponentForDirectory(value, directory, options = {}) {
+    const availableBytes = DEFAULT_PATH_BYTES -
+        Buffer.byteLength(node_path_1.default.resolve(directory)) -
+        Buffer.byteLength(node_path_1.default.sep) -
+        (options.reserveBytes ?? 0);
+    if (availableBytes <= Buffer.byteLength(options.suffix ?? "")) {
+        throw new Error(`Directory leaves no room in path budget: ${directory}`);
+    }
+    return sanitizePathComponent(value, {
+        ...options,
+        maxBytes: Math.min(options.maxBytes ?? DEFAULT_COMPONENT_BYTES, availableBytes),
+    });
+}
+function truncateUtf8(value, maxBytes) {
+    let result = "";
+    for (const { segment: character } of SEGMENTER.segment(value)) {
+        if (Buffer.byteLength(result + character) > maxBytes) {
+            break;
+        }
+        result += character;
+    }
+    return result;
+}
+//# sourceMappingURL=path.js.map

package/dist/cjs/downloader/path.js.map

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

package/dist/cjs/downloader/resolver.d.ts

@@ -0,0 +1,16 @@
+export interface CreatorResolverClient {
+    listFollowingCreators(): Promise<{
+        creatorId: string;
+    }[]>;
+    listSupportingPlans(): Promise<{
+        creatorId: string;
+    }[]>;
+}
+export interface ResolveCreatorIdsOptions {
+    creatorIds: string[];
+    following: boolean;
+    ignoreCreatorIds: string[];
+    supporting: boolean;
+}
+export declare function resolveCreatorIds(client: CreatorResolverClient, options: ResolveCreatorIdsOptions): Promise<string[]>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/cjs/downloader/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/downloader/resolver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IAC1D,mBAAmB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB"}

package/dist/cjs/downloader/resolver.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCreatorIds = resolveCreatorIds;
+async function resolveCreatorIds(client, options) {
+    const creatorIds = new Set(options.creatorIds);
+    if (options.following) {
+        for (const creator of await client.listFollowingCreators()) {
+            creatorIds.add(creator.creatorId);
+        }
+    }
+    if (options.supporting) {
+        for (const plan of await client.listSupportingPlans()) {
+            creatorIds.add(plan.creatorId);
+        }
+    }
+    for (const ignored of options.ignoreCreatorIds) {
+        creatorIds.delete(ignored);
+    }
+    return [...creatorIds];
+}
+//# sourceMappingURL=resolver.js.map

package/dist/cjs/downloader/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/downloader/resolver.ts"],"names":[],"mappings":";;AAYA,8CAoBC;AApBM,KAAK,UAAU,iBAAiB,CACrC,MAA6B,EAC7B,OAAiC;IAEjC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,KAAK,MAAM,OAAO,IAAI,MAAM,MAAM,CAAC,qBAAqB,EAAE,EAAE,CAAC;YAC3D,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,MAAM,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC;YACtD,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC/C,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC;AACzB,CAAC"}

package/dist/cjs/downloader/scheduler.d.ts

@@ -0,0 +1,19 @@
+import type { HttpResponse } from "../http.js";
+import type { Logger } from "./logger.js";
+export interface RequestSchedulerOptions {
+    concurrency: number;
+    logger?: Logger;
+    maxRetries?: number;
+    now?: () => number;
+    rateLimitPauseMs?: number;
+    requestIntervalMs?: number;
+    sleep?: (milliseconds: number) => Promise<void>;
+}
+export declare class RequestScheduler {
+    #private;
+    constructor(options: RequestSchedulerOptions);
+    pause(milliseconds: number): void;
+    request(operation: () => Promise<HttpResponse>): Promise<HttpResponse>;
+    run<T>(operation: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/cjs/downloader/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/downloader/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,qBAAa,gBAAgB;;gBAaR,OAAO,EAAE,uBAAuB;IAa5C,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAClB,SAAS,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,GACrC,OAAO,CAAC,YAAY,CAAC;IAoCX,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAiC7D"}

package/dist/cjs/downloader/scheduler.js

@@ -0,0 +1,124 @@
+"use strict";
+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 _RequestScheduler_instances, _RequestScheduler_active, _RequestScheduler_concurrency, _RequestScheduler_logger, _RequestScheduler_maxRetries, _RequestScheduler_nextStartAt, _RequestScheduler_now, _RequestScheduler_pausedUntil, _RequestScheduler_rateLimitPauseMs, _RequestScheduler_requestIntervalMs, _RequestScheduler_sleep, _RequestScheduler_waiting, _RequestScheduler_acquire, _RequestScheduler_release, _RequestScheduler_waitToStart;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestScheduler = void 0;
+const errors_js_1 = require("./errors.js");
+const logger_js_1 = require("./logger.js");
+class RequestScheduler {
+    constructor(options) {
+        _RequestScheduler_instances.add(this);
+        _RequestScheduler_active.set(this, 0);
+        _RequestScheduler_concurrency.set(this, void 0);
+        _RequestScheduler_logger.set(this, void 0);
+        _RequestScheduler_maxRetries.set(this, void 0);
+        _RequestScheduler_nextStartAt.set(this, 0);
+        _RequestScheduler_now.set(this, void 0);
+        _RequestScheduler_pausedUntil.set(this, 0);
+        _RequestScheduler_rateLimitPauseMs.set(this, void 0);
+        _RequestScheduler_requestIntervalMs.set(this, void 0);
+        _RequestScheduler_sleep.set(this, void 0);
+        _RequestScheduler_waiting.set(this, []);
+        if (!Number.isSafeInteger(options.concurrency) || options.concurrency < 1) {
+            throw new Error("concurrency must be a positive integer");
+        }
+        __classPrivateFieldSet(this, _RequestScheduler_concurrency, options.concurrency, "f");
+        __classPrivateFieldSet(this, _RequestScheduler_logger, options.logger ?? logger_js_1.silentLogger, "f");
+        __classPrivateFieldSet(this, _RequestScheduler_maxRetries, options.maxRetries ?? 5, "f");
+        __classPrivateFieldSet(this, _RequestScheduler_now, options.now ?? Date.now, "f");
+        __classPrivateFieldSet(this, _RequestScheduler_rateLimitPauseMs, options.rateLimitPauseMs ?? 60000, "f");
+        __classPrivateFieldSet(this, _RequestScheduler_requestIntervalMs, options.requestIntervalMs ?? 0, "f");
+        __classPrivateFieldSet(this, _RequestScheduler_sleep, options.sleep ?? defaultSleep, "f");
+    }
+    pause(milliseconds) {
+        __classPrivateFieldSet(this, _RequestScheduler_pausedUntil, Math.max(__classPrivateFieldGet(this, _RequestScheduler_pausedUntil, "f"), __classPrivateFieldGet(this, _RequestScheduler_now, "f").call(this) + milliseconds), "f");
+    }
+    async request(operation) {
+        let attempt = 0;
+        for (;;) {
+            try {
+                const response = await this.run(operation);
+                if (!isRetryableStatus(response.status) ||
+                    attempt >= __classPrivateFieldGet(this, _RequestScheduler_maxRetries, "f")) {
+                    return response;
+                }
+                await (0, errors_js_1.logDebugResponse)(__classPrivateFieldGet(this, _RequestScheduler_logger, "f"), response, {
+                    attempt: attempt + 1,
+                });
+                if (response.status === 429) {
+                    const pauseMs = parseRetryAfter(response, __classPrivateFieldGet(this, _RequestScheduler_now, "f").call(this)) ?? __classPrivateFieldGet(this, _RequestScheduler_rateLimitPauseMs, "f");
+                    this.pause(pauseMs);
+                    __classPrivateFieldGet(this, _RequestScheduler_logger, "f").warn("request.rate-limit.pause", "Rate limit reached; pausing requests", { pauseMs });
+                }
+            }
+            catch (error) {
+                if (attempt >= __classPrivateFieldGet(this, _RequestScheduler_maxRetries, "f")) {
+                    throw error;
+                }
+            }
+            __classPrivateFieldGet(this, _RequestScheduler_logger, "f").warn("request.retry", "Retrying request", {
+                attempt: attempt + 1,
+            });
+            attempt += 1;
+        }
+    }
+    async run(operation) {
+        await __classPrivateFieldGet(this, _RequestScheduler_instances, "m", _RequestScheduler_acquire).call(this);
+        try {
+            await __classPrivateFieldGet(this, _RequestScheduler_instances, "m", _RequestScheduler_waitToStart).call(this);
+            return await operation();
+        }
+        finally {
+            __classPrivateFieldGet(this, _RequestScheduler_instances, "m", _RequestScheduler_release).call(this);
+        }
+    }
+}
+exports.RequestScheduler = RequestScheduler;
+_RequestScheduler_active = new WeakMap(), _RequestScheduler_concurrency = new WeakMap(), _RequestScheduler_logger = new WeakMap(), _RequestScheduler_maxRetries = new WeakMap(), _RequestScheduler_nextStartAt = new WeakMap(), _RequestScheduler_now = new WeakMap(), _RequestScheduler_pausedUntil = new WeakMap(), _RequestScheduler_rateLimitPauseMs = new WeakMap(), _RequestScheduler_requestIntervalMs = new WeakMap(), _RequestScheduler_sleep = new WeakMap(), _RequestScheduler_waiting = new WeakMap(), _RequestScheduler_instances = new WeakSet(), _RequestScheduler_acquire = async function _RequestScheduler_acquire() {
+    if (__classPrivateFieldGet(this, _RequestScheduler_active, "f") >= __classPrivateFieldGet(this, _RequestScheduler_concurrency, "f")) {
+        await new Promise((resolve) => __classPrivateFieldGet(this, _RequestScheduler_waiting, "f").push(resolve));
+    }
+    __classPrivateFieldSet(this, _RequestScheduler_active, __classPrivateFieldGet(this, _RequestScheduler_active, "f") + 1, "f");
+}, _RequestScheduler_release = function _RequestScheduler_release() {
+    __classPrivateFieldSet(this, _RequestScheduler_active, __classPrivateFieldGet(this, _RequestScheduler_active, "f") - 1, "f");
+    __classPrivateFieldGet(this, _RequestScheduler_waiting, "f").shift()?.();
+}, _RequestScheduler_waitToStart = async function _RequestScheduler_waitToStart() {
+    for (;;) {
+        const now = __classPrivateFieldGet(this, _RequestScheduler_now, "f").call(this);
+        const delay = Math.max(__classPrivateFieldGet(this, _RequestScheduler_pausedUntil, "f"), __classPrivateFieldGet(this, _RequestScheduler_nextStartAt, "f")) - now;
+        if (delay <= 0) {
+            __classPrivateFieldSet(this, _RequestScheduler_nextStartAt, now + __classPrivateFieldGet(this, _RequestScheduler_requestIntervalMs, "f"), "f");
+            return;
+        }
+        await __classPrivateFieldGet(this, _RequestScheduler_sleep, "f").call(this, delay);
+    }
+};
+function defaultSleep(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+function isRetryableStatus(status) {
+    return status === 408 || status === 429 || status >= 500;
+}
+function parseRetryAfter(response, now) {
+    const retryAfter = response.headers.get("Retry-After");
+    if (!retryAfter) {
+        return undefined;
+    }
+    const seconds = Number(retryAfter);
+    if (Number.isFinite(seconds)) {
+        return Math.max(0, seconds * 1000);
+    }
+    const date = Date.parse(retryAfter);
+    return Number.isNaN(date) ? undefined : Math.max(0, date - now);
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/cjs/downloader/scheduler.js.map

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