@moontaiworks/fanbox-dl 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 月太げつたい🌸
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# @moontaiworks/fanbox-dl
+
+A cli downloader or a read-only TypeScript SDK for building pixivFANBOX applications.
+
+[![NPM Version](https://img.shields.io/npm/v/@moontaiworks/fanbox-dl)](https://www.npmjs.com/package/@moontaiworks/fanbox-dl)
+[![NPM Downloads](https://img.shields.io/npm/d18m/@moontaiworks/fanbox-dl)](https://www.npmjs.com/package/@moontaiworks/fanbox-dl)
+[![Documentation](https://github.com/moontaiworks/fanbox-dl/actions/workflows/docs.yml/badge.svg)](https://github.com/moontaiworks/fanbox-dl/actions/workflows/docs.yml)
+[![codecov](https://codecov.io/gh/moontaiworks/fanbox-dl/branch/main/graph/badge.svg)](https://codecov.io/gh/moontaiworks/fanbox-dl)
+
+## CLI Downloader
+
+Run the downloader through your package manager, or install it globally:
+
+```bash
+npx @moontaiworks/fanbox-dl download --creator creator-id
+```
+
+```bash
+npm install -g @moontaiworks/fanbox-dl
+fanbox-dl download --creator creator-id
+```
+
+Authenticated downloads read `FANBOX_SESSION_ID` by default:
+
+```bash
+FANBOX_SESSION_ID=your-session-id npx @moontaiworks/fanbox-dl download \
+  --supporting \
+  --output ./fanbox-downloads
+```
+
+You can also pass a cookie file exported from your logged-in browser session:
+
+```bash
+npx @moontaiworks/fanbox-dl download \
+  --creator creator-id \
+  --cookie-file ./cookies.txt
+```
+
+Preview the selected creators and posts without downloading:
+
+```bash
+npx @moontaiworks/fanbox-dl download --creator creator-id --dry-run
+```
+
+At least one creator selector is required: `--creator`, `--following`, or
+`--supporting`.
+
+### CLI Options
+
+| Option                      | Description                                                                                            | Example                          | Default             |
+| --------------------------- | ------------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------- |
+| `--creator <id>`            | Add a creator ID to download. Can be repeated.                                                         | `--creator alpha --creator beta` | None                |
+| `--following`               | Download posts from followed creators. Requires authentication.                                        | `--following`                    | `false`             |
+| `--supporting`              | Download posts from supporting creators. Requires authentication.                                      | `--supporting`                   | `false`             |
+| `--ignore-creator <id>`     | Exclude a creator ID from the selected creators. Can be repeated.                                      | `--ignore-creator beta`          | None                |
+| `--cookie <value>`          | Raw `FANBOXSESSID`, `FANBOXSESSID=...`, or a full Cookie header.                                       | `--cookie "FANBOXSESSID=..."`    | `FANBOX_SESSION_ID` |
+| `--cookie-file <path>`      | Read a raw cookie value or Netscape `cookies.txt`. FANBOX cookies are selected automatically.          | `--cookie-file ./cookies.txt`    | None                |
+| `--user-agent <value>`      | Send the same User-Agent as the browser session that produced your cookie.                             | `--user-agent "Mozilla/5.0 ..."` | random string       |
+| `--output <path>`           | Directory where downloaded creators and posts are stored.                                              | `--output ./fanbox-downloads`    | `fanbox-downloads`  |
+| `--dry-run`                 | List selected creators and discovered post summaries without writing files or requesting post details. | `--dry-run`                      | `false`             |
+| `--flat-posts`              | Store post files directly under each creator directory instead of one directory per post.              | `--flat-posts`                   | `false`             |
+| `--verify-assets`           | Verify existing asset size and SHA-256 before deciding whether to skip a file.                         | `--verify-assets`                | `false`             |
+| `--concurrency <n>`         | Maximum number of concurrent requests. Must be greater than `0`.                                       | `--concurrency 3`                | `3`                 |
+| `--request-interval-ms <n>` | Delay between request starts, in milliseconds.                                                         | `--request-interval-ms 1000`     | `0`                 |
+| `--rate-limit-pause-ms <n>` | Pause duration after HTTP 429 when FANBOX does not send `Retry-After`.                                 | `--rate-limit-pause-ms 60000`    | `60000`             |
+| `--max-retries <n>`         | Retry attempts for retryable request failures.                                                         | `--max-retries 5`                | `5`                 |
+| `--log-format json\|pretty` | Choose JSON Lines logs or human-readable logs.                                                         | `--log-format pretty`            | `json`              |
+| `--log-level <level>`       | Show logs at this level or higher. One of `debug`, `info`, `warn`, or `error`.                         | `--log-level debug`              | `info`              |
+| `--help`                    | Show CLI help.                                                                                         | `--help`                         | None                |
+
+### CLI Notes
+
+The downloader stores each post as `metadata.json`, `content.md`, and asset
+files in a per-post directory. Asset file names include a two-digit sequence
+number, so files are easy to browse in order.
+
+It keeps a per-creator `manifest.json`, skips unchanged posts, resumes `.part`
+files with HTTP Range requests when supported, and can verify existing SHA-256
+hashes with `--verify-assets`.
+
+Passing `--cookie` is convenient but may leave the session value in shell
+history. `--cookie-file` accepts either a raw cookie value or a Netscape
+`cookies.txt` export from your own logged-in browser session. When using
+`cookies.txt`, FANBOX cookies such as `FANBOXSESSID` and `cf_clearance` are
+selected automatically.
+
+Run `fanbox-dl --help` for the full CLI option list.
+
+## SDK
+
+### Installation
+
+```bash
+npm install @moontaiworks/fanbox-dl
+```
+
+### Usage
+
+FANBOX uses the `FANBOXSESSID` cookie for authenticated requests. Obtain it from
+your own browser session and keep it outside source control.
+
+```typescript
+import { FanboxClient } from "@moontaiworks/fanbox-dl";
+
+const fanbox = new FanboxClient({
+  cookie: `FANBOXSESSID=${process.env.FANBOX_SESSION_ID}`,
+});
+
+const creators = await fanbox.listFollowingCreators();
+const supportingPlans = await fanbox.listSupportingPlans();
+
+const pageUrls = await fanbox.paginateCreatorPosts({
+  creatorId: creators[0].creatorId,
+  sort: "newest",
+});
+
+const posts = await fanbox.listCreatorPosts({
+  creatorId: supportingPlans[0].creatorId,
+  limit: 10,
+  sort: "newest",
+});
+
+const post = await fanbox.getPost({ postId: posts[0].id });
+```
+
+The SDK also provides `listHomePosts()` and `listSupportingPosts()` for
+authenticated timelines. It intentionally exposes read-only endpoints: it does
+not follow creators, like posts, or create comments.
+
+### Documentation
+
+API documentation is automatically generated using [TypeDoc](https://typedoc.org/) and published to GitHub Pages.
+
+- **View the latest documentation**: [GitHub Pages](https://moontaiworks.github.io/fanbox-dl/)
+
+## Testing
+
+Tests inject a local HTTP transport and do not require a real FANBOX session.
+
+Run:
+
+```bash
+pnpm test
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/bundle/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var x=Object.defineProperty;var q=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var _=t=>{throw TypeError(t)};var W=(t,e)=>{for(var r in e)x(t,r,{get:e[r],enumerable:!0})},z=(t,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of M(e))!$.call(t,o)&&o!==r&&x(t,o,{get:()=>e[o],enumerable:!(s=q(e,o))||s.enumerable});return t};var J=t=>z(x({},"__esModule",{value:!0}),t);var L=(t,e,r)=>e.has(t)||_("Cannot "+r);var n=(t,e,r)=>(L(t,e,"read from private field"),r?r.call(t):e.get(t)),P=(t,e,r)=>e.has(t)?_("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(t):e.set(t,r),g=(t,e,r,s)=>(L(t,e,"write to private field"),s?s.call(t,r):e.set(t,r),r),i=(t,e,r)=>(L(t,e,"access private method"),r);var Pt={};W(Pt,{FanboxApiError:()=>f,FanboxClient:()=>b});module.exports=J(Pt);var C="creator.get";var O="creator.listFollowing";var w="plan.listCreator";var E="plan.listSupporting";var I="post.info";var U="post.listCreator";var F="post.listHome";var G="post.listSupporting";var N="post.paginateCreator";function B(t={}){let e={Accept:"application/json, text/plain, */*",Origin:"https://www.fanbox.cc",Referer:"https://www.fanbox.cc/","Sec-Fetch-Dest":"empty","Sec-Fetch-Mode":"cors","Sec-Fetch-Site":"same-site","User-Agent":t.userAgent??X()};return t.cookie!==void 0&&(e.Cookie=t.cookie),e}function X(){return`${Math.random().toString(36).substring(2,15)}/${Math.random().toFixed(5)}`}var k=require("http2");var Y=":authority",K=":method",Q=":path",V=":scheme",Z=":status",p,S,v,T=class{constructor(){P(this,S);P(this,p,new Map)}async close(){let e=[...n(this,p).values()];n(this,p).clear(),await Promise.all(e.map(tt))}request(e){let r=nt(e),s=i(this,S,v).call(this,r.url),o=et(r),m=s.request(o,{endStream:!r.body});return new Promise((h,d)=>{let A=!1;m.once("error",d),m.once("response",l=>{A=!0;let D=it(l[Z]);h(rt({body:m,headers:st(l),status:D}))}),m.once("close",()=>{A||d(new H("HTTP/2 stream closed before response"))}),r.body!==void 0&&pt(m,r.body).catch(l=>{m.destroy(l instanceof Error?l:new Error(String(l)))})})}};p=new WeakMap,S=new WeakSet,v=function(e){let r=e.origin,s=n(this,p).get(r);if(s&&!s.closed&&!s.destroyed)return s;let o=(0,k.connect)(r);return o.once("close",()=>{n(this,p).get(r)===o&&n(this,p).delete(r)}),o.once("error",()=>{n(this,p).get(r)===o&&n(this,p).delete(r)}),n(this,p).set(r,o),o};var H=class extends Error{constructor(e){super(e),this.name="HttpError"}};function tt(t){return t.closed||t.destroyed?Promise.resolve():new Promise(e=>{t.close(e)})}function et(t){let e={[Y]:t.url.host,[K]:t.method.toUpperCase(),[Q]:`${t.url.pathname}${t.url.search}`,[V]:t.url.protocol.slice(0,-1)};return new Headers(t.headers).forEach((r,s)=>{ot(s)||(e[s]=r)}),e}function rt(t){return{body:t.body,headers:t.headers,json:async()=>JSON.parse(await j(t.body)),ok:t.status>=200&&t.status<300,status:t.status,statusText:"",text:async()=>j(t.body)}}function st(t){let e=new Headers;for(let[r,s]of Object.entries(t))if(!(r.startsWith(":")||s===void 0))if(Array.isArray(s))for(let o of s)e.append(r,o);else e.set(r,s);return e}function ot(t){return t.startsWith(":")||t==="connection"||t==="keep-alive"||t==="proxy-connection"||t==="transfer-encoding"||t==="upgrade"}function nt(t){return typeof t=="string"||t instanceof URL?{body:void 0,headers:void 0,method:"GET",url:new URL(t)}:{body:t.body,headers:t.headers,method:t.method??"GET",url:new URL(t.url)}}function it(t){return typeof t=="number"?t:Array.isArray(t)?Number(t[0]??0):Number(t??0)}async function j(t){let e=[];for await(let r of t)e.push(at(r));return Buffer.concat(e).toString("utf8")}function at(t){return Buffer.isBuffer(t)?t:t instanceof Uint8Array||typeof t=="string"?Buffer.from(t):Buffer.from(String(t))}async function pt(t,e){if(typeof e=="string"||e instanceof Uint8Array){t.end(e);return}if(e instanceof Blob){t.end(Buffer.from(new Uint8Array(await e.arrayBuffer())));return}throw new H("Unsupported HTTP request body")}var ut="https://api.fanbox.cc",f=class extends Error{constructor(e,r){super(`FANBOX API request failed: ${e.status} ${e.statusText}`),this.name="FanboxApiError",this.body=r,this.status=e.status,this.statusText=e.statusText}},c,y,R,a,u,b=class{constructor(e={}){P(this,a);P(this,c);P(this,y);P(this,R);g(this,c,e.baseUrl??ut),g(this,y,B({cookie:e.cookie,userAgent:e.userAgent})),g(this,R,e.transport??new T)}getCreator(e){return i(this,a,u).call(this,C,e)}getPost(e){return i(this,a,u).call(this,I,e)}listCreatorPlans(e){return i(this,a,u).call(this,w,e)}listCreatorPosts(e){return i(this,a,u).call(this,U,e)}listFollowingCreators(){return i(this,a,u).call(this,O)}listHomePosts(e={}){return i(this,a,u).call(this,F,e)}listSupportingPlans(){return i(this,a,u).call(this,E)}listSupportingPosts(e={}){return i(this,a,u).call(this,G,e)}paginateCreatorPosts(e){return i(this,a,u).call(this,N,e)}};c=new WeakMap,y=new WeakMap,R=new WeakMap,a=new WeakSet,u=async function(e,r={}){let s=new URL(e,n(this,c).endsWith("/")?n(this,c):`${n(this,c)}/`);for(let[h,d]of Object.entries(r))d!==void 0&&s.searchParams.set(h,String(d));let o=await n(this,R).request({headers:n(this,y),method:"GET",url:s}),m=await mt(o);if(!o.ok)throw new f(o,m);return m.body};async function mt(t){let e=await t.text();try{return JSON.parse(e)}catch{return e}}0&&(module.exports={FanboxApiError,FanboxClient});
+//# sourceMappingURL=index.cjs.map

package/dist/bundle/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts","../../src/endpoints/creator-get.ts","../../src/endpoints/creator-list-following.ts","../../src/endpoints/plan-list-creator.ts","../../src/endpoints/plan-list-supporting.ts","../../src/endpoints/post-info.ts","../../src/endpoints/post-list-creator.ts","../../src/endpoints/post-list-home.ts","../../src/endpoints/post-list-supporting.ts","../../src/endpoints/post-paginate-creator.ts","../../src/fanbox-headers.ts","../../src/http.ts","../../src/client.ts"],"sourcesContent":["export { FanboxApiError, FanboxClient } from \"./client.js\";\nexport type * from \"./types.js\";\n","import type { Creator } from \"./models/creator.js\";\n\nexport const CREATOR_GET_PATH = \"creator.get\";\n\nexport interface GetCreatorParams {\n  creatorId: string;\n}\n\nexport type GetCreatorResult = Creator;\n","import type { CreatorSummary } from \"./models/creator.js\";\n\nexport const CREATOR_LIST_FOLLOWING_PATH = \"creator.listFollowing\";\n\nexport type ListFollowingCreatorsResult = CreatorSummary[];\n","import type { Plan } from \"./models/plan.js\";\n\nexport const PLAN_LIST_CREATOR_PATH = \"plan.listCreator\";\n\nexport interface ListCreatorPlansParams {\n  creatorId: string;\n}\n\nexport type ListCreatorPlansResult = Plan[];\n","import type { SupportingPlan } from \"./models/plan.js\";\n\nexport const PLAN_LIST_SUPPORTING_PATH = \"plan.listSupporting\";\n\nexport type ListSupportingPlansResult = SupportingPlan[];\n","import type { Post } from \"./models/post.js\";\n\nexport const POST_INFO_PATH = \"post.info\";\n\nexport interface GetPostParams {\n  postId: string;\n}\n\nexport type GetPostResult = Post;\n","import type { PostListParams, PostSort, PostSummary } from \"./models/post.js\";\n\nexport const POST_LIST_CREATOR_PATH = \"post.listCreator\";\n\nexport interface ListCreatorPostsParams extends PostListParams {\n  creatorId: string;\n  firstId?: string;\n  firstPublishedDatetime?: string;\n  sort?: PostSort;\n}\n\nexport type ListCreatorPostsResult = PostSummary[];\n","import type { PostListParams, PostSummary } from \"./models/post.js\";\n\nexport const POST_LIST_HOME_PATH = \"post.listHome\";\n\nexport type ListHomePostsParams = PostListParams;\n\nexport type ListHomePostsResult = PostSummary[];\n","import type { PostListParams, PostSummary } from \"./models/post.js\";\n\nexport const POST_LIST_SUPPORTING_PATH = \"post.listSupporting\";\n\nexport type ListSupportingPostsParams = PostListParams;\n\nexport type ListSupportingPostsResult = PostSummary[];\n","import type { PostSort } from \"./models/post.js\";\n\nexport const POST_PAGINATE_CREATOR_PATH = \"post.paginateCreator\";\n\nexport interface PaginateCreatorPostsParams {\n  creatorId: string;\n  sort?: PostSort;\n}\n\nexport type PaginateCreatorPostsResult = string[];\n","export interface FanboxRequestHeadersOptions {\n  cookie?: string;\n  userAgent?: string;\n}\n\nexport function createFanboxRequestHeaders(\n  options: FanboxRequestHeadersOptions = {},\n): Record<string, string> {\n  const headers: Record<string, string> = {\n    Accept: \"application/json, text/plain, */*\",\n    Origin: \"https://www.fanbox.cc\",\n    Referer: \"https://www.fanbox.cc/\",\n    \"Sec-Fetch-Dest\": \"empty\",\n    \"Sec-Fetch-Mode\": \"cors\",\n    \"Sec-Fetch-Site\": \"same-site\",\n    \"User-Agent\": options.userAgent ?? createRandomUserAgent(),\n  };\n  if (options.cookie !== undefined) {\n    headers.Cookie = options.cookie;\n  }\n\n  return headers;\n}\n\nexport function createRandomUserAgent(): string {\n  return `${Math.random().toString(36).substring(2, 15)}/${Math.random().toFixed(5)}`;\n}\n","import { type ClientHttp2Session, connect } from \"node:http2\";\nimport type { Readable } from \"node:stream\";\n\nconst HTTP2_HEADER_AUTHORITY = \":authority\";\nconst HTTP2_HEADER_METHOD = \":method\";\nconst HTTP2_HEADER_PATH = \":path\";\nconst HTTP2_HEADER_SCHEME = \":scheme\";\nconst HTTP2_HEADER_STATUS = \":status\";\n\nexport interface HttpRequest {\n  body?: BodyInit | undefined;\n  headers?: Headers | Record<string, string>;\n  method?: string;\n  url: string | URL;\n}\n\nexport interface HttpResponse {\n  body: Readable;\n  headers: Headers;\n  json(): Promise<unknown>;\n  ok: boolean;\n  status: number;\n  statusText: string;\n  text(): Promise<string>;\n}\n\nexport interface HttpTransport {\n  close(): Promise<void>;\n  request(request: HttpRequest | string | URL): Promise<HttpResponse>;\n}\n\ntype BodyInit = Blob | string | Uint8Array;\n\ninterface NormalizedHttpRequest {\n  body: BodyInit | undefined;\n  headers: Headers | Record<string, string> | undefined;\n  method: string;\n  url: URL;\n}\n\nexport class Http2Transport implements HttpTransport {\n  readonly #sessions = new Map<string, ClientHttp2Session>();\n\n  public async close(): Promise<void> {\n    const sessions = [...this.#sessions.values()];\n    this.#sessions.clear();\n    await Promise.all(sessions.map(closeSession));\n  }\n\n  public request(request: HttpRequest | string | URL): Promise<HttpResponse> {\n    const normalized = normalizeRequest(request);\n    const session = this.#getSession(normalized.url);\n    const headers = createHttp2Headers(normalized);\n    const stream = session.request(headers, { endStream: !normalized.body });\n\n    return new Promise((resolve, reject) => {\n      let settled = false;\n      stream.once(\"error\", reject);\n      stream.once(\"response\", (responseHeaders) => {\n        settled = true;\n        const status = parseStatus(responseHeaders[HTTP2_HEADER_STATUS]);\n        resolve(\n          createResponse({\n            body: stream,\n            headers: createResponseHeaders(responseHeaders),\n            status,\n          }),\n        );\n      });\n      stream.once(\"close\", () => {\n        if (!settled) {\n          reject(new HttpError(`HTTP/2 stream closed before response`));\n        }\n      });\n      if (normalized.body !== undefined) {\n        writeRequestBody(stream, normalized.body).catch((error: unknown) => {\n          stream.destroy(\n            error instanceof Error ? error : new Error(String(error)),\n          );\n        });\n      }\n    });\n  }\n\n  #getSession(url: URL): ClientHttp2Session {\n    const origin = url.origin;\n    const existing = this.#sessions.get(origin);\n    if (existing && !existing.closed && !existing.destroyed) {\n      return existing;\n    }\n\n    const session = connect(origin);\n    session.once(\"close\", () => {\n      if (this.#sessions.get(origin) === session) {\n        this.#sessions.delete(origin);\n      }\n    });\n    session.once(\"error\", () => {\n      if (this.#sessions.get(origin) === session) {\n        this.#sessions.delete(origin);\n      }\n    });\n    this.#sessions.set(origin, session);\n\n    return session;\n  }\n}\n\nexport class HttpError extends Error {\n  public constructor(message: string) {\n    super(message);\n    this.name = \"HttpError\";\n  }\n}\n\nfunction closeSession(session: ClientHttp2Session): Promise<void> {\n  if (session.closed || session.destroyed) {\n    return Promise.resolve();\n  }\n\n  return new Promise((resolve) => {\n    session.close(resolve);\n  });\n}\n\nfunction createHttp2Headers(\n  request: NormalizedHttpRequest,\n): Record<string, string> {\n  const headers: Record<string, string> = {\n    [HTTP2_HEADER_AUTHORITY]: request.url.host,\n    [HTTP2_HEADER_METHOD]: request.method.toUpperCase(),\n    [HTTP2_HEADER_PATH]: `${request.url.pathname}${request.url.search}`,\n    [HTTP2_HEADER_SCHEME]: request.url.protocol.slice(0, -1),\n  };\n  new Headers(request.headers).forEach((value, key) => {\n    if (!isForbiddenHttp2Header(key)) {\n      headers[key] = value;\n    }\n  });\n\n  return headers;\n}\n\nfunction createResponse(options: {\n  body: Readable;\n  headers: Headers;\n  status: number;\n}): HttpResponse {\n  return {\n    body: options.body,\n    headers: options.headers,\n    json: async () => {\n      const parsed: unknown = JSON.parse(await readText(options.body));\n      return parsed;\n    },\n    ok: options.status >= 200 && options.status < 300,\n    status: options.status,\n    statusText: \"\",\n    text: async () => readText(options.body),\n  };\n}\n\nfunction createResponseHeaders(\n  headers: NodeJS.Dict<string | string[]>,\n): Headers {\n  const result = new Headers();\n  for (const [key, value] of Object.entries(headers)) {\n    if (key.startsWith(\":\") || value === undefined) {\n      continue;\n    }\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        result.append(key, item);\n      }\n    } else {\n      result.set(key, value);\n    }\n  }\n\n  return result;\n}\n\nfunction isForbiddenHttp2Header(header: string): boolean {\n  return (\n    header.startsWith(\":\") ||\n    header === \"connection\" ||\n    header === \"keep-alive\" ||\n    header === \"proxy-connection\" ||\n    header === \"transfer-encoding\" ||\n    header === \"upgrade\"\n  );\n}\n\nfunction normalizeRequest(\n  request: HttpRequest | string | URL,\n): NormalizedHttpRequest {\n  if (typeof request === \"string\" || request instanceof URL) {\n    return {\n      body: undefined,\n      headers: undefined,\n      method: \"GET\",\n      url: new URL(request),\n    };\n  }\n\n  return {\n    body: request.body,\n    headers: request.headers,\n    method: request.method ?? \"GET\",\n    url: new URL(request.url),\n  };\n}\n\nfunction parseStatus(status: number | string | string[] | undefined): number {\n  if (typeof status === \"number\") {\n    return status;\n  }\n  if (Array.isArray(status)) {\n    return Number(status[0] ?? 0);\n  }\n\n  return Number(status ?? 0);\n}\n\nasync function readText(body: Readable): Promise<string> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of body) {\n    chunks.push(toBuffer(chunk));\n  }\n\n  return Buffer.concat(chunks).toString(\"utf8\");\n}\n\nfunction toBuffer(chunk: unknown): Buffer {\n  if (Buffer.isBuffer(chunk)) {\n    return chunk;\n  }\n  if (chunk instanceof Uint8Array) {\n    return Buffer.from(chunk);\n  }\n  if (typeof chunk === \"string\") {\n    return Buffer.from(chunk);\n  }\n\n  return Buffer.from(String(chunk));\n}\n\nasync function writeRequestBody(\n  stream: NodeJS.WritableStream,\n  body: BodyInit | undefined,\n): Promise<void> {\n  if (typeof body === \"string\" || body instanceof Uint8Array) {\n    stream.end(body);\n    return;\n  }\n  if (body instanceof Blob) {\n    stream.end(Buffer.from(new Uint8Array(await body.arrayBuffer())));\n    return;\n  }\n\n  throw new HttpError(\"Unsupported HTTP request body\");\n}\n","import type { FanboxClientOptions } from \"./client-options.js\";\nimport {\n  CREATOR_GET_PATH,\n  type GetCreatorParams,\n  type GetCreatorResult,\n} from \"./endpoints/creator-get.js\";\nimport {\n  CREATOR_LIST_FOLLOWING_PATH,\n  type ListFollowingCreatorsResult,\n} from \"./endpoints/creator-list-following.js\";\nimport type { FanboxEnvelope } from \"./endpoints/fanbox-envelope.js\";\nimport {\n  type ListCreatorPlansParams,\n  type ListCreatorPlansResult,\n  PLAN_LIST_CREATOR_PATH,\n} from \"./endpoints/plan-list-creator.js\";\nimport {\n  type ListSupportingPlansResult,\n  PLAN_LIST_SUPPORTING_PATH,\n} from \"./endpoints/plan-list-supporting.js\";\nimport {\n  type GetPostParams,\n  type GetPostResult,\n  POST_INFO_PATH,\n} from \"./endpoints/post-info.js\";\nimport {\n  type ListCreatorPostsParams,\n  type ListCreatorPostsResult,\n  POST_LIST_CREATOR_PATH,\n} from \"./endpoints/post-list-creator.js\";\nimport {\n  type ListHomePostsParams,\n  type ListHomePostsResult,\n  POST_LIST_HOME_PATH,\n} from \"./endpoints/post-list-home.js\";\nimport {\n  type ListSupportingPostsParams,\n  type ListSupportingPostsResult,\n  POST_LIST_SUPPORTING_PATH,\n} from \"./endpoints/post-list-supporting.js\";\nimport {\n  type PaginateCreatorPostsParams,\n  type PaginateCreatorPostsResult,\n  POST_PAGINATE_CREATOR_PATH,\n} from \"./endpoints/post-paginate-creator.js\";\nimport { createFanboxRequestHeaders } from \"./fanbox-headers.js\";\nimport {\n  Http2Transport,\n  type HttpResponse,\n  type HttpTransport,\n} from \"./http.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.fanbox.cc\";\n\nexport class FanboxApiError extends Error {\n  public readonly body: unknown;\n  public readonly status: number;\n  public readonly statusText: string;\n\n  public constructor(response: HttpResponse, body: unknown) {\n    super(\n      `FANBOX API request failed: ${response.status} ${response.statusText}`,\n    );\n    this.name = \"FanboxApiError\";\n    this.body = body;\n    this.status = response.status;\n    this.statusText = response.statusText;\n  }\n}\n\nexport class FanboxClient {\n  readonly #baseUrl: string;\n  readonly #headers: Record<string, string>;\n  readonly #transport: HttpTransport;\n\n  public constructor(options: FanboxClientOptions = {}) {\n    this.#baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;\n    this.#headers = createFanboxRequestHeaders({\n      cookie: options.cookie,\n      userAgent: options.userAgent,\n    });\n    this.#transport = options.transport ?? new Http2Transport();\n  }\n\n  public getCreator(params: GetCreatorParams): Promise<GetCreatorResult> {\n    return this.#get(CREATOR_GET_PATH, params);\n  }\n\n  public getPost(params: GetPostParams): Promise<GetPostResult> {\n    return this.#get(POST_INFO_PATH, params);\n  }\n\n  public listCreatorPlans(\n    params: ListCreatorPlansParams,\n  ): Promise<ListCreatorPlansResult> {\n    return this.#get(PLAN_LIST_CREATOR_PATH, params);\n  }\n\n  public listCreatorPosts(\n    params: ListCreatorPostsParams,\n  ): Promise<ListCreatorPostsResult> {\n    return this.#get(POST_LIST_CREATOR_PATH, params);\n  }\n\n  public listFollowingCreators(): Promise<ListFollowingCreatorsResult> {\n    return this.#get(CREATOR_LIST_FOLLOWING_PATH);\n  }\n\n  public listHomePosts(\n    params: ListHomePostsParams = {},\n  ): Promise<ListHomePostsResult> {\n    return this.#get(POST_LIST_HOME_PATH, params);\n  }\n\n  public listSupportingPlans(): Promise<ListSupportingPlansResult> {\n    return this.#get(PLAN_LIST_SUPPORTING_PATH);\n  }\n\n  public listSupportingPosts(\n    params: ListSupportingPostsParams = {},\n  ): Promise<ListSupportingPostsResult> {\n    return this.#get(POST_LIST_SUPPORTING_PATH, params);\n  }\n\n  public paginateCreatorPosts(\n    params: PaginateCreatorPostsParams,\n  ): Promise<PaginateCreatorPostsResult> {\n    return this.#get(POST_PAGINATE_CREATOR_PATH, params);\n  }\n\n  async #get<T>(path: string, query: object = {}): Promise<T> {\n    const url = new URL(\n      path,\n      this.#baseUrl.endsWith(\"/\") ? this.#baseUrl : `${this.#baseUrl}/`,\n    );\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined) {\n        url.searchParams.set(key, String(value));\n      }\n    }\n\n    const response = await this.#transport.request({\n      headers: this.#headers,\n      method: \"GET\",\n      url,\n    });\n    const body = await readResponseBody(response);\n    if (!response.ok) {\n      throw new FanboxApiError(response, body);\n    }\n\n    return (body as FanboxEnvelope<T>).body;\n  }\n}\n\nasync function readResponseBody(response: HttpResponse): Promise<unknown> {\n  const text = await response.text();\n  try {\n    return JSON.parse(text) as unknown;\n  } catch {\n    return text;\n  }\n}\n"],"mappings":"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","names":["index_exports","__export","FanboxApiError","FanboxClient","__toCommonJS","CREATOR_GET_PATH","CREATOR_LIST_FOLLOWING_PATH","PLAN_LIST_CREATOR_PATH","PLAN_LIST_SUPPORTING_PATH","POST_INFO_PATH","POST_LIST_CREATOR_PATH","POST_LIST_HOME_PATH","POST_LIST_SUPPORTING_PATH","POST_PAGINATE_CREATOR_PATH","createFanboxRequestHeaders","options","headers","createRandomUserAgent","import_node_http2","HTTP2_HEADER_AUTHORITY","HTTP2_HEADER_METHOD","HTTP2_HEADER_PATH","HTTP2_HEADER_SCHEME","HTTP2_HEADER_STATUS","_sessions","_Http2Transport_instances","getSession_fn","Http2Transport","__privateAdd","sessions","__privateGet","closeSession","request","normalized","normalizeRequest","session","__privateMethod","headers","createHttp2Headers","stream","resolve","reject","settled","responseHeaders","status","parseStatus","createResponse","createResponseHeaders","HttpError","writeRequestBody","error","url","origin","existing","message","value","key","isForbiddenHttp2Header","options","readText","result","item","header","body","chunks","chunk","toBuffer","DEFAULT_BASE_URL","FanboxApiError","response","body","_baseUrl","_headers","_transport","_FanboxClient_instances","get_fn","FanboxClient","options","__privateAdd","__privateSet","createFanboxRequestHeaders","Http2Transport","params","__privateMethod","CREATOR_GET_PATH","POST_INFO_PATH","PLAN_LIST_CREATOR_PATH","POST_LIST_CREATOR_PATH","CREATOR_LIST_FOLLOWING_PATH","POST_LIST_HOME_PATH","PLAN_LIST_SUPPORTING_PATH","POST_LIST_SUPPORTING_PATH","POST_PAGINATE_CREATOR_PATH","path","query","url","__privateGet","key","value","readResponseBody","text"]}

package/dist/bundle/index.d.cts

@@ -0,0 +1,296 @@
+import { Readable } from 'node:stream';
+
+interface HttpRequest {
+    body?: BodyInit | undefined;
+    headers?: Headers | Record<string, string>;
+    method?: string;
+    url: string | URL;
+}
+interface HttpResponse {
+    body: Readable;
+    headers: Headers;
+    json(): Promise<unknown>;
+    ok: boolean;
+    status: number;
+    statusText: string;
+    text(): Promise<string>;
+}
+interface HttpTransport {
+    close(): Promise<void>;
+    request(request: HttpRequest | string | URL): Promise<HttpResponse>;
+}
+type BodyInit = Blob | string | Uint8Array;
+
+interface FanboxClientOptions {
+    baseUrl?: string;
+    cookie?: string;
+    transport?: HttpTransport;
+    userAgent?: string;
+}
+
+interface FanboxUser {
+    iconUrl: string;
+    name: string;
+    userId: string;
+}
+
+interface Creator {
+    category: string;
+    coverImageUrl: null | string;
+    creatorId: string;
+    description: string;
+    hasAdultContent: boolean;
+    hasBoothShop: boolean;
+    hasPublishedPost: boolean;
+    isAcceptingRequest: boolean;
+    isFollowed: boolean;
+    isStopped: boolean;
+    isSupported: boolean;
+    profileItems: CreatorProfileItem[];
+    profileLinks: string[];
+    user: FanboxUser;
+}
+interface CreatorProfileImage {
+    id: string;
+    imageUrl: string;
+    thumbnailUrl: string;
+    type: "image";
+}
+type CreatorProfileItem = CreatorProfileImage | CreatorProfileUnknownItem;
+interface CreatorProfileUnknownItem {
+    [key: string]: unknown;
+    id: string;
+    type: string;
+}
+interface CreatorSummary {
+    creatorId: string;
+    description: string;
+    hasAdultContent: boolean;
+    iconUrl: string;
+    isFollowed: boolean;
+    isSupported: boolean;
+    name: string;
+    userId: string;
+}
+
+declare const CREATOR_GET_PATH = "creator.get";
+interface GetCreatorParams {
+    creatorId: string;
+}
+type GetCreatorResult = Creator;
+
+declare const CREATOR_LIST_FOLLOWING_PATH = "creator.listFollowing";
+type ListFollowingCreatorsResult = CreatorSummary[];
+
+interface Plan {
+    coverImageUrl: null | string;
+    creatorId: string;
+    description: string;
+    fee: number;
+    hasAdultContent: boolean;
+    id: string;
+    paymentMethod: null | string;
+    perks: string[];
+    title: string;
+    user: FanboxUser;
+}
+interface SupportingPlan extends Plan {
+    paymentMethod: string;
+}
+
+declare const PLAN_LIST_CREATOR_PATH = "plan.listCreator";
+interface ListCreatorPlansParams {
+    creatorId: string;
+}
+type ListCreatorPlansResult = Plan[];
+
+declare const PLAN_LIST_SUPPORTING_PATH = "plan.listSupporting";
+type ListSupportingPlansResult = SupportingPlan[];
+
+type ArticleBlock = ArticleFileBlock | ArticleHeaderBlock | ArticleImageBlock | ArticleParagraphBlock | ArticleUnknownBlock | ArticleUrlEmbedBlock;
+interface ArticleFileBlock {
+    fileId: string;
+    type: "file";
+}
+interface ArticleHeaderBlock {
+    text: string;
+    type: "header";
+}
+interface ArticleImageBlock {
+    imageId: string;
+    type: "image";
+}
+interface ArticleParagraphBlock {
+    text: string;
+    type: "p";
+}
+interface ArticlePost extends PostBase {
+    body: ArticlePostBody;
+    type: "article";
+}
+interface ArticlePostBody {
+    blocks: ArticleBlock[];
+    fileMap: Record<string, PostFile>;
+    imageMap: Record<string, PostImage>;
+    urlEmbedMap: Record<string, unknown>;
+}
+interface ArticleUnknownBlock {
+    [key: string]: unknown;
+    type: string;
+}
+interface ArticleUrlEmbedBlock {
+    type: "url_embed";
+    urlEmbedId: string;
+}
+interface FilePost extends PostBase {
+    body: FilePostBody;
+    type: "file";
+}
+interface FilePostBody {
+    files: PostFile[];
+    text: string;
+}
+interface ImagePost extends PostBase {
+    body: ImagePostBody;
+    type: "image";
+}
+interface ImagePostBody {
+    images: PostImage[];
+    text: string;
+}
+interface NeighboringPost {
+    id: string;
+    publishedDatetime: string;
+    title: string;
+}
+type Post = ArticlePost | FilePost | ImagePost | TextPost | UnknownPost | VideoPost;
+interface PostCover {
+    type: "cover_image" | "post_image";
+    url: string;
+}
+interface PostFile {
+    extension: string;
+    id: string;
+    name: string;
+    size: number;
+    url: string;
+}
+interface PostImage {
+    extension: string;
+    height: number;
+    id: string;
+    originalUrl: string;
+    thumbnailUrl: string;
+    width: number;
+}
+interface PostListParams {
+    limit?: number;
+    maxId?: string;
+    maxPublishedDatetime?: string;
+}
+type PostSort = "newest" | "oldest";
+interface PostSummary {
+    commentCount: number;
+    cover: null | PostCover;
+    creatorId: string;
+    excerpt: string;
+    feeRequired: number;
+    hasAdultContent: boolean;
+    id: string;
+    isCommentingRestricted: boolean;
+    isLiked: boolean;
+    isPinned: boolean;
+    isRestricted: boolean;
+    likeCount: number;
+    publishedDatetime: string;
+    tags: string[];
+    title: string;
+    updatedDatetime: string;
+    user: FanboxUser;
+}
+interface TextPost extends PostBase {
+    body: TextPostBody;
+    type: "text";
+}
+interface TextPostBody {
+    text: string;
+}
+interface UnknownPost extends PostBase {
+    type: string;
+}
+type UnknownPostBody = Record<string, unknown>;
+interface VideoPost extends PostBase {
+    body: VideoPostBody;
+    type: "video";
+}
+interface VideoPostBody {
+    text: string;
+    video: {
+        serviceProvider: string;
+        videoId: string;
+    };
+}
+interface PostBase extends Omit<PostSummary, "cover"> {
+    body: unknown;
+    coverImageUrl: null | string;
+    imageForShare: null | string;
+    nextPost: NeighboringPost | null;
+    prevPost: NeighboringPost | null;
+    type: string;
+}
+
+declare const POST_INFO_PATH = "post.info";
+interface GetPostParams {
+    postId: string;
+}
+type GetPostResult = Post;
+
+declare const POST_LIST_CREATOR_PATH = "post.listCreator";
+interface ListCreatorPostsParams extends PostListParams {
+    creatorId: string;
+    firstId?: string;
+    firstPublishedDatetime?: string;
+    sort?: PostSort;
+}
+type ListCreatorPostsResult = PostSummary[];
+
+declare const POST_LIST_HOME_PATH = "post.listHome";
+type ListHomePostsParams = PostListParams;
+type ListHomePostsResult = PostSummary[];
+
+declare const POST_LIST_SUPPORTING_PATH = "post.listSupporting";
+type ListSupportingPostsParams = PostListParams;
+type ListSupportingPostsResult = PostSummary[];
+
+declare const POST_PAGINATE_CREATOR_PATH = "post.paginateCreator";
+interface PaginateCreatorPostsParams {
+    creatorId: string;
+    sort?: PostSort;
+}
+type PaginateCreatorPostsResult = string[];
+
+declare class FanboxApiError extends Error {
+    readonly body: unknown;
+    readonly status: number;
+    readonly statusText: string;
+    constructor(response: HttpResponse, body: unknown);
+}
+declare class FanboxClient {
+    #private;
+    constructor(options?: FanboxClientOptions);
+    getCreator(params: GetCreatorParams): Promise<GetCreatorResult>;
+    getPost(params: GetPostParams): Promise<GetPostResult>;
+    listCreatorPlans(params: ListCreatorPlansParams): Promise<ListCreatorPlansResult>;
+    listCreatorPosts(params: ListCreatorPostsParams): Promise<ListCreatorPostsResult>;
+    listFollowingCreators(): Promise<ListFollowingCreatorsResult>;
+    listHomePosts(params?: ListHomePostsParams): Promise<ListHomePostsResult>;
+    listSupportingPlans(): Promise<ListSupportingPlansResult>;
+    listSupportingPosts(params?: ListSupportingPostsParams): Promise<ListSupportingPostsResult>;
+    paginateCreatorPosts(params: PaginateCreatorPostsParams): Promise<PaginateCreatorPostsResult>;
+}
+
+interface FanboxEnvelope<T> {
+    body: T;
+}
+
+export { type ArticleBlock, type ArticleFileBlock, type ArticleHeaderBlock, type ArticleImageBlock, type ArticleParagraphBlock, type ArticlePost, type ArticlePostBody, type ArticleUnknownBlock, type ArticleUrlEmbedBlock, CREATOR_GET_PATH, CREATOR_LIST_FOLLOWING_PATH, type Creator, type CreatorProfileImage, type CreatorProfileItem, type CreatorProfileUnknownItem, type CreatorSummary, FanboxApiError, FanboxClient, type FanboxClientOptions, type FanboxEnvelope, type FanboxUser, type FilePost, type FilePostBody, type GetCreatorParams, type GetCreatorResult, type GetPostParams, type GetPostResult, type ImagePost, type ImagePostBody, type ListCreatorPlansParams, type ListCreatorPlansResult, type ListCreatorPostsParams, type ListCreatorPostsResult, type ListFollowingCreatorsResult, type ListHomePostsParams, type ListHomePostsResult, type ListSupportingPlansResult, type ListSupportingPostsParams, type ListSupportingPostsResult, type NeighboringPost, PLAN_LIST_CREATOR_PATH, PLAN_LIST_SUPPORTING_PATH, POST_INFO_PATH, POST_LIST_CREATOR_PATH, POST_LIST_HOME_PATH, POST_LIST_SUPPORTING_PATH, POST_PAGINATE_CREATOR_PATH, type PaginateCreatorPostsParams, type PaginateCreatorPostsResult, type Plan, type Post, type PostCover, type PostFile, type PostImage, type PostListParams, type PostSort, type PostSummary, type SupportingPlan, type TextPost, type TextPostBody, type UnknownPost, type UnknownPostBody, type VideoPost, type VideoPostBody };