@book000/pixivts 0.58.0 → 0.59.0

package/dist/index.d.cts

@@ -377,7 +377,7 @@ declare class HttpClient {
  *   - `.pages()` is an async generator that yields each page
  *   - `.items()` is an async generator that yields individual items across all pages
  *
- * Pagination uses the `next_url` field returned by list endpoints. The URL is
+ * Pagination uses the `nextUrl` field returned by list endpoints. The URL is
  * fetched via `HttpClient.getAbsolute()` which reuses the same auth / retry /
  * interceptor pipeline as regular requests.
  */
@@ -385,17 +385,17 @@ declare class HttpClient {
 /**
  * A page returned by a pixiv list endpoint.
  *
- * Must have a `next_url` field (null when there are no more pages).
+ * Must have a `nextUrl` field (null when there are no more pages).
  */
 interface PagedResponse {
     /** URL to the next page, or `null` when there are no more pages. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /**
  * A `ResultAsync<TPage, PixivError>` with additional `.pages()` / `.items()`
  * async generators for consuming paginated pixiv list responses.
  *
- * Returned by all resource methods that produce a `next_url` field.
+ * Returned by all resource methods that produce a `nextUrl` field.
  */
 declare class PaginatedResultAsync<TPage extends PagedResponse, TItem> extends ResultAsync<TPage, PixivError> {
     #private;
@@ -481,8 +481,8 @@ interface ParsedNextUrl {
  * @example
  * ```ts
  * const page = await client.users.bookmarks.illusts({ userId: client.userId })
- * if (page.isOk && page.value.next_url) {
- *   const cursor = parseNextUrl(page.value.next_url)
+ * if (page.isOk && page.value.nextUrl) {
+ *   const cursor = parseNextUrl(page.value.nextUrl)
  *   // Resume later:
  *   const next = await client.users.bookmarks.illusts({
  *     userId: client.userId,
@@ -497,11 +497,11 @@ interface ParsedNextUrl {
 declare function parseNextUrl(url: string): ParsedNextUrl;
 
 /**
- * Public option types for @book000/pixivts.
+ * Public option constants for @book000/pixivts.
  *
- * Each option is exported as both a runtime `const` object (for enum-like
- * access, e.g. `BookmarkRestrict.PUBLIC`) and a TypeScript `type` (so plain
- * string literals such as `'public'` are also accepted).
+ * Each option is exported as a runtime `const` object for enum-like access
+ * (e.g. `BookmarkRestrict.PUBLIC`). Plain string literals are also accepted
+ * wherever these values are used as parameters.
  *
  * @example
  * ```ts
@@ -526,7 +526,6 @@ declare const SearchTarget: {
     readonly TITLE_AND_CAPTION: "title_and_caption";
     readonly KEYWORD: "keyword";
 };
-type SearchTarget = (typeof SearchTarget)[keyof typeof SearchTarget];
 /**
  * Sort order for search results.
  *
@@ -539,7 +538,6 @@ declare const SearchSort: {
     readonly DATE_ASC: "date_asc";
     readonly POPULAR_DESC: "popular_desc";
 };
-type SearchSort = (typeof SearchSort)[keyof typeof SearchSort];
 /**
  * Date range filter for search results.
  *
@@ -552,7 +550,6 @@ declare const SearchDuration: {
     readonly WITHIN_LAST_WEEK: "within_last_week";
     readonly WITHIN_LAST_MONTH: "within_last_month";
 };
-type SearchDuration = (typeof SearchDuration)[keyof typeof SearchDuration];
 /**
  * Ranking mode for illust rankings.
  *
@@ -573,7 +570,6 @@ declare const RankingMode: {
     readonly DAY_FEMALE_R18: "day_female_r18";
     readonly DAY_R18_AI: "day_r18_ai";
 };
-type RankingMode = (typeof RankingMode)[keyof typeof RankingMode];
 /**
  * Ranking mode for novel rankings.
  *
@@ -589,7 +585,6 @@ declare const NovelRankingMode: {
     readonly WEEK_R18: "week_r18";
     readonly DAY_R18_AI: "day_r18_ai";
 };
-type NovelRankingMode = (typeof NovelRankingMode)[keyof typeof NovelRankingMode];
 /**
  * Visibility restriction for bookmarks.
  *
@@ -600,7 +595,6 @@ declare const BookmarkRestrict: {
     readonly PUBLIC: "public";
     readonly PRIVATE: "private";
 };
-type BookmarkRestrict = (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
 /**
  * Visibility restriction for follows.
  *
@@ -611,7 +605,6 @@ declare const FollowRestrict: {
     readonly PUBLIC: "public";
     readonly PRIVATE: "private";
 };
-type FollowRestrict = (typeof FollowRestrict)[keyof typeof FollowRestrict];
 /**
  * OS filter used to request works compatible with the given platform.
  *
@@ -622,7 +615,6 @@ declare const OSFilter: {
     readonly FOR_IOS: "for_ios";
     readonly FOR_ANDROID: "for_android";
 };
-type OSFilter = (typeof OSFilter)[keyof typeof OSFilter];
 /**
  * Work type filter for user illust listings.
  *
@@ -633,7 +625,6 @@ declare const UserIllustType: {
     readonly ILLUST: "illust";
     readonly MANGA: "manga";
 };
-type UserIllustType = (typeof UserIllustType)[keyof typeof UserIllustType];
 
 /**
  * Public types for @book000/pixivts.
@@ -652,12 +643,12 @@ type UserIllustType = (typeof UserIllustType)[keyof typeof UserIllustType];
  */
 interface ImageUrls {
     /** 360×360 thumbnail */
-    square_medium: string;
+    squareMedium: string;
     /** Long side ≤ 540 px */
     medium: string;
     /** Width ≤ 600 px, height ≤ 1200 px */
     large: string;
-    /** Original image (present in `meta_pages` entries only) */
+    /** Original image (present in `metaPages` entries only) */
     original?: string;
 }
 /** Profile image URLs for a user. */
@@ -683,22 +674,22 @@ interface PixivUser {
     /** Login account name (distinct from the display `name`). */
     account: string;
     /** Set of profile image URLs at different sizes. */
-    profile_image_urls: ProfileImageUrls;
+    profileImageUrls: ProfileImageUrls;
     /** Whether the authenticated user follows this user. */
-    is_followed?: boolean;
+    isFollowed?: boolean;
     /** Whether this user has blocked access by the authenticated user. */
-    is_access_blocking_user?: boolean;
+    isAccessBlockingUser?: boolean;
     /** Whether this user accepts illustration commission requests. */
-    is_accept_request?: boolean;
+    isAcceptRequest?: boolean;
 }
 /** Tag on a work. */
 interface Tag {
     /** Tag name in Japanese. */
     name: string;
     /** Translated tag name, or `null` if no translation is available. */
-    translated_name: string | null;
+    translatedName: string | null;
     /** Whether the tag was added by the work's uploader. */
-    added_by_uploaded_user?: boolean;
+    addedByUploadedUser?: boolean;
 }
 /** Series information embedded in a work item. */
 interface Series {
@@ -719,12 +710,12 @@ interface PrivacyPolicy {
 /** Original-image URL for a single-page illust. */
 interface MetaSinglePage {
     /** Direct URL to the original-resolution image. */
-    original_image_url: string;
+    originalImageUrl: string;
 }
 /** Per-page image URLs for a multi-page work (manga). */
 interface MetaPages {
     /** Full set of image URLs for this page, including the original. */
-    image_urls: Required<ImageUrls>;
+    imageUrls: Required<ImageUrls>;
 }
 /**
  * A pixiv illust or manga work item as returned by the API.
@@ -745,7 +736,7 @@ interface PixivIllustItem {
     /** Work category: illustration, manga, or animated illustration. */
     type: 'illust' | 'manga' | 'ugoira';
     /** Thumbnail image URLs at various sizes. */
-    image_urls: ImageUrls;
+    imageUrls: ImageUrls;
     /** Work caption / description (may contain HTML). */
     caption: string;
     /** Content restriction level (0 = public, 1 = mypixiv-only, 2 = private). */
@@ -757,46 +748,46 @@ interface PixivIllustItem {
     /** Creation tools listed by the author (e.g. "Photoshop"). */
     tools: string[];
     /** ISO 8601 date-time string of when the work was posted. */
-    create_date: string;
+    createDate: string;
     /** Number of images in a multi-page work (1 for single-page). */
-    page_count: number;
+    pageCount: number;
     /** Canvas width in pixels. */
     width: number;
     /** Canvas height in pixels. */
     height: number;
     /** Sanity / sensitivity level assigned by the pixiv content filter. */
-    sanity_level: number;
+    sanityLevel: number;
     /** Age restriction: 0 = all-ages, 1 = R-18, 2 = R-18G */
-    x_restrict: number;
+    xRestrict: number;
     /** Series this work belongs to, or `null` if not part of a series. */
     series: Series | null;
     /**
-     * For single-page works: `{ original_image_url: string }`.
+     * For single-page works: `{ originalImageUrl: string }`.
      * For multi-page works: `{}` (empty object).
      */
-    meta_single_page: MetaSinglePage | Record<string, never>;
+    metaSinglePage: MetaSinglePage | Record<string, never>;
     /** Per-page image URLs for multi-page works (empty array for single-page). */
-    meta_pages: MetaPages[];
+    metaPages: MetaPages[];
     /** Total number of views. */
-    total_view: number;
+    totalView: number;
     /** Total number of bookmarks. */
-    total_bookmarks: number;
+    totalBookmarks: number;
     /** Whether the authenticated user has bookmarked this work. */
-    is_bookmarked: boolean;
+    isBookmarked: boolean;
     /** Whether the work is publicly visible. */
     visible: boolean;
     /** Whether the work is muted for the authenticated user. */
-    is_muted: boolean;
+    isMuted: boolean;
     /** Total number of comments (may be absent on some endpoints). */
-    total_comments?: number;
+    totalComments?: number;
     /** AI-generated content flag: 0 = no AI, 1 = partial AI, 2 = fully AI */
-    illust_ai_type: number;
+    illustAiType: number;
     /** Book-style rendering flag (0 = normal, 1 = book). */
-    illust_book_style: number;
+    illustBookStyle: number;
     /** Controls who can post comments (may be absent). */
-    comment_access_control?: number;
+    commentAccessControl?: number;
     /** Additional access-restriction attributes (may be absent). */
-    restriction_attributes?: string[];
+    restrictionAttributes?: string[];
 }
 /** Illust series metadata returned by GET /v1/illust/series. */
 interface IllustSeriesDetail {
@@ -807,13 +798,13 @@ interface IllustSeriesDetail {
     /** Series description / caption. */
     caption: string;
     /** Cover image URLs. */
-    cover_image_urls: {
+    coverImageUrls: {
         medium: string;
     };
     /** Number of works in the series. */
-    series_work_count: number;
+    seriesWorkCount: number;
     /** ISO 8601 date-time string of when the series was created. */
-    create_date: string;
+    createDate: string;
     /** Canvas width of the cover image in pixels. */
     width: number;
     /** Canvas height of the cover image in pixels. */
@@ -821,7 +812,7 @@ interface IllustSeriesDetail {
     /** Author of the series. */
     user: PixivUser;
     /** Whether the authenticated user has added this series to their watchlist. */
-    watchlist_added: boolean;
+    watchlistAdded: boolean;
 }
 /**
  * A pixiv novel work item as returned by the API.
@@ -843,19 +834,19 @@ interface PixivNovelItem {
     /** Content restriction level (0 = public, 1 = mypixiv-only, 2 = private). */
     restrict: number;
     /** Age restriction: 0 = all-ages, 1 = R-18, 2 = R-18G */
-    x_restrict: number;
+    xRestrict: number;
     /** Whether the novel is an original work (not fan fiction). */
-    is_original: boolean;
+    isOriginal: boolean;
     /** Cover image URLs. */
-    image_urls: ImageUrls;
+    imageUrls: ImageUrls;
     /** ISO 8601 date-time string of when the novel was posted. */
-    create_date: string;
+    createDate: string;
     /** Tags attached to the novel. */
     tags: Tag[];
     /** Number of pages (word-count chunks). */
-    page_count: number;
+    pageCount: number;
     /** Total character count of the novel body. */
-    text_length: number;
+    textLength: number;
     /** Author of the novel. */
     user: PixivUser;
     /**
@@ -865,25 +856,25 @@ interface PixivNovelItem {
      */
     series: Series | Record<string, never>;
     /** Whether the authenticated user has bookmarked this novel. */
-    is_bookmarked: boolean;
+    isBookmarked: boolean;
     /** Total number of bookmarks. */
-    total_bookmarks: number;
+    totalBookmarks: number;
     /** Total number of views. */
-    total_view: number;
+    totalView: number;
     /** Whether the novel is publicly visible. */
     visible: boolean;
     /** Total number of comments. */
-    total_comments: number;
+    totalComments: number;
     /** Whether the novel is muted for the authenticated user. */
-    is_muted: boolean;
+    isMuted: boolean;
     /** Whether the novel is restricted to mutual followers (mypixiv). */
-    is_mypixiv_only: boolean;
-    /** Whether the novel contains explicit content beyond the `x_restrict` flag. */
-    is_x_restricted: boolean;
+    isMypixivOnly: boolean;
+    /** Whether the novel contains explicit content beyond the `xRestrict` flag. */
+    isXRestricted: boolean;
     /** AI-generated content flag: 0 = no AI, 1 = partial AI, 2 = fully AI */
-    novel_ai_type: number;
+    novelAiType: number;
     /** Controls who can post comments (may be absent). */
-    comment_access_control?: number;
+    commentAccessControl?: number;
 }
 /** Novel series details returned by GET /v2/novel/series. */
 interface NovelSeriesDetail {
@@ -894,21 +885,21 @@ interface NovelSeriesDetail {
     /** Series description / caption. */
     caption: string;
     /** Whether every novel in the series is original (not fan fiction). */
-    is_original: boolean;
+    isOriginal: boolean;
     /** Whether the series has been marked as concluded by the author. */
-    is_concluded: boolean;
+    isConcluded: boolean;
     /** Number of novels in the series. */
-    content_count: number;
+    contentCount: number;
     /** Total character count across all novels in the series. */
-    total_character_count: number;
+    totalCharacterCount: number;
     /** Author of the series. */
     user: PixivUser;
     /** Human-readable series label / tagline. */
-    display_text: string;
+    displayText: string;
     /** AI-generated content flag: 0 = no AI, 1 = partial AI, 2 = fully AI */
-    novel_ai_type: number;
+    novelAiType: number;
     /** Whether the authenticated user has added this series to their watchlist. */
-    watchlist_added: boolean;
+    watchlistAdded: boolean;
 }
 /** User item with self-introduction; embedded in GET /v1/user/detail. */
 type PixivUserItem = PixivUser & {
@@ -926,47 +917,47 @@ interface PixivUserProfile {
     /** Birth date string (YYYY-MM-DD format, may be partial). */
     birth: string;
     /** Birth day portion (MM-DD format). */
-    birth_day: string;
+    birthDay: string;
     /** Birth year. */
-    birth_year: number;
+    birthYear: number;
     /** Region / prefecture. */
     region: string;
     /** Internal address ID. */
-    address_id: number;
+    addressId: number;
     /** Two-letter country code (ISO 3166-1 alpha-2). */
-    country_code: string;
+    countryCode: string;
     /** Occupation / job description. */
     job: string;
     /** Internal job category ID. */
-    job_id: number;
+    jobId: number;
     /** Number of users this user follows. */
-    total_follow_users: number;
+    totalFollowUsers: number;
     /** Number of mutual-follow (mypixiv) connections. */
-    total_mypixiv_users: number;
+    totalMypixivUsers: number;
     /** Total number of public illusts. */
-    total_illusts: number;
+    totalIllusts: number;
     /** Total number of public manga works. */
-    total_manga: number;
+    totalManga: number;
     /** Total number of public novels. */
-    total_novels: number;
+    totalNovels: number;
     /** Total number of publicly bookmarked illusts. */
-    total_illust_bookmarks_public: number;
+    totalIllustBookmarksPublic: number;
     /** Total number of illust series. */
-    total_illust_series: number;
+    totalIllustSeries: number;
     /** Total number of novel series. */
-    total_novel_series: number;
+    totalNovelSeries: number;
     /** Profile background image URL, or `null` if not set. */
-    background_image_url: string | null;
+    backgroundImageUrl: string | null;
     /** Linked Twitter/X account name (without @). */
-    twitter_account: string;
+    twitterAccount: string;
     /** Twitter/X profile URL, or `null` if not set. */
-    twitter_url: string | null;
+    twitterUrl: string | null;
     /** Pawoo profile URL, or `null` if not set. */
-    pawoo_url: string | null;
+    pawooUrl: string | null;
     /** Whether the user has a premium (paid) account. */
-    is_premium: boolean;
+    isPremium: boolean;
     /** Whether the user has set a custom profile image. */
-    is_using_custom_profile_image: boolean;
+    isUsingCustomProfileImage: boolean;
 }
 /** Visibility settings for a user's profile fields. */
 interface PixivUserProfilePublicity {
@@ -975,9 +966,9 @@ interface PixivUserProfilePublicity {
     /** Visibility of the region field. */
     region: Publicity;
     /** Visibility of the birth-day field. */
-    birth_day: Publicity;
+    birthDay: Publicity;
     /** Visibility of the birth-year field. */
-    birth_year: Publicity;
+    birthYear: Publicity;
     /** Visibility of the job field. */
     job: Publicity;
     /** Whether the Pawoo account link is visible. */
@@ -1010,7 +1001,7 @@ interface PixivUserProfileWorkspace {
     /** Free-text comment about the workspace. */
     comment: string;
     /** Workspace image URL, or `null` if not set. */
-    workspace_image_url: string | null;
+    workspaceImageUrl: string | null;
 }
 /**
  * Preview item for a user in the GET /v1/user/following response.
@@ -1025,7 +1016,7 @@ interface PixivUserPreviewItem {
     /** A small sample of the user's recent novels. */
     novels: PixivNovelItem[];
     /** Whether this user is muted by the authenticated user. */
-    is_muted: boolean;
+    isMuted: boolean;
 }
 /** URLs for ugoira frame archives (ZIP files). */
 interface ZipUrls {
@@ -1042,24 +1033,28 @@ interface Frame {
 /** Ugoira metadata as returned by GET /v1/ugoira/metadata. */
 interface PixivUgoiraItem {
     /** Archive URLs for the frame ZIP. */
-    zip_urls: ZipUrls;
+    zipUrls: ZipUrls;
     /** Per-frame timing data (in order). */
     frames: Frame[];
 }
 /**
- * Shape of the JSON body returned by the pixiv API on error.
+ * Camelized shape of the JSON error body returned by the pixiv API.
+ *
+ * The pixiv wire format uses `snake_case` field names (e.g. `user_message`);
+ * `HttpClient` applies `camelizeKeys()` before returning, so all fields here
+ * are `lowerCamelCase`.
  */
 interface PixivApiErrorBody {
-    /** Error payload returned by the pixiv API. */
+    /** Error payload returned by the pixiv API (keys camelized). */
     error: {
         /** Localised error message intended for end users. */
-        user_message: string;
+        userMessage: string;
         /** Internal error message. */
         message: string;
         /** Short error reason / code. */
         reason: string;
         /** Additional details for the user-facing message (may be absent). */
-        user_message_details?: Record<string, unknown>;
+        userMessageDetails?: Record<string, unknown>;
     };
 }
 /** Response shape for GET /v1/illust/detail. */
@@ -1076,49 +1071,49 @@ interface IllustListPage {
      *
      * Only present on search responses; absent on related/ranking/recommended endpoints.
      */
-    show_ai?: boolean;
+    showAi?: boolean;
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Page response for GET /v1/illust/recommended. */
 interface IllustRecommendedPage {
     /** Recommended illusts. */
     illusts: PixivIllustItem[];
     /** Ranking illusts included alongside recommendations. */
-    ranking_illusts: PixivIllustItem[];
+    rankingIllusts: PixivIllustItem[];
     /** Whether an ongoing contest exists. */
-    contest_exists: boolean;
+    contestExists: boolean;
     /** Privacy-policy notice (present on the first page). */
-    privacy_policy?: PrivacyPolicy;
+    privacyPolicy?: PrivacyPolicy;
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Page response for GET /v1/illust/series. */
 interface IllustSeriesPage {
     /** Metadata for the series. */
-    illust_series_detail: IllustSeriesDetail;
+    illustSeriesDetail: IllustSeriesDetail;
     /** First illust in the series. */
-    illust_series_first_illust: PixivIllustItem;
+    illustSeriesFirstIllust: PixivIllustItem;
     /** Illusts on this page. */
     illusts: PixivIllustItem[];
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Page response for GET /v1/manga/recommended. */
 interface MangaRecommendedPage {
     /** Recommended manga works. */
     illusts: PixivIllustItem[];
     /** Ranking manga works included alongside recommendations. */
-    ranking_illusts: PixivIllustItem[];
+    rankingIllusts: PixivIllustItem[];
     /** Privacy-policy notice (present on the first page). */
-    privacy_policy?: PrivacyPolicy;
+    privacyPolicy?: PrivacyPolicy;
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Response shape for GET /v1/ugoira/metadata. */
 interface UgoiraMetadataResponse {
     /** Ugoira metadata (ZIP URLs and per-frame timings). */
-    ugoira_metadata: PixivUgoiraItem;
+    ugoiraMetadata: PixivUgoiraItem;
 }
 /** Response shape for GET /v2/novel/detail. */
 interface NovelDetailResponse {
@@ -1134,33 +1129,33 @@ interface NovelListPage {
      *
      * Only present on search responses; absent on related/ranking/recommended endpoints.
      */
-    show_ai?: boolean;
+    showAi?: boolean;
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Page response for GET /v1/novel/recommended. */
 interface NovelRecommendedPage {
     /** Recommended novels. */
     novels: PixivNovelItem[];
     /** Ranking novels included alongside recommendations. */
-    ranking_novels: PixivNovelItem[];
+    rankingNovels: PixivNovelItem[];
     /** Privacy-policy notice (present on the first page). */
-    privacy_policy?: PrivacyPolicy;
+    privacyPolicy?: PrivacyPolicy;
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Page response for GET /v2/novel/series. */
 interface NovelSeriesPage {
     /** Metadata for the series. */
-    novel_series_detail: NovelSeriesDetail;
+    novelSeriesDetail: NovelSeriesDetail;
     /** First novel in the series. */
-    novel_series_first_novel: PixivNovelItem;
+    novelSeriesFirstNovel: PixivNovelItem;
     /** Most recently published novel in the series. */
-    novel_series_latest_novel: PixivNovelItem;
+    novelSeriesLatestNovel: PixivNovelItem;
     /** Novels on this page. */
     novels: PixivNovelItem[];
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Response shape for GET /v1/user/detail. */
 interface UserDetailResponse {
@@ -1169,7 +1164,7 @@ interface UserDetailResponse {
     /** Detailed profile data. */
     profile: PixivUserProfile;
     /** Visibility settings for profile fields. */
-    profile_publicity: PixivUserProfilePublicity;
+    profilePublicity: PixivUserProfilePublicity;
     /** Workspace / desk-setup information. */
     workspace: PixivUserProfileWorkspace;
 }
@@ -1180,7 +1175,7 @@ interface UserIllustsPage {
     /** Illusts on this page. */
     illusts: PixivIllustItem[];
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Page response for GET /v1/user/novels. */
 interface UserNovelsPage {
@@ -1189,28 +1184,28 @@ interface UserNovelsPage {
     /** Novels on this page. */
     novels: PixivNovelItem[];
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Page response for GET /v1/user/bookmarks/illust. */
 interface UserBookmarksIllustPage {
     /** Bookmarked illusts on this page. */
     illusts: PixivIllustItem[];
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Page response for GET /v1/user/bookmarks/novel. */
 interface UserBookmarksNovelPage {
     /** Bookmarked novels on this page. */
     novels: PixivNovelItem[];
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 /** Page response for GET /v1/user/following. */
 interface UserFollowingPage {
     /** User preview items on this page. */
-    user_previews: PixivUserPreviewItem[];
+    userPreviews: PixivUserPreviewItem[];
     /** URL to the next page, or `null` when this is the last page. */
-    next_url: string | null;
+    nextUrl: string | null;
 }
 
 /**
@@ -1222,7 +1217,7 @@ interface IllustDetailParams {
     /** ID of the illust to fetch. */
     illustId: number;
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
 }
 /** Parameters for fetching related illusts. */
 interface IllustRelatedParams {
@@ -1231,24 +1226,24 @@ interface IllustRelatedParams {
     /** Additional seed illust IDs to influence recommendations. */
     seedIllustIds?: number[];
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
 }
 /** Parameters for searching illusts. */
 interface IllustSearchParams {
     /** Search keyword. */
     word: string;
     /** How to match the keyword against works (default: `"partial_match_for_tags"`). */
-    searchTarget?: SearchTarget;
+    searchTarget?: (typeof SearchTarget)[keyof typeof SearchTarget];
     /** Sort order for results (default: `"date_desc"`). */
-    sort?: SearchSort;
+    sort?: (typeof SearchSort)[keyof typeof SearchSort];
     /** Date range preset filter (omit for no restriction). */
-    duration?: SearchDuration;
+    duration?: (typeof SearchDuration)[keyof typeof SearchDuration];
     /** Start date for a custom date range (YYYY-MM-DD; requires `endDate`). */
     startDate?: string;
     /** End date for a custom date range (YYYY-MM-DD; requires `startDate`). */
     endDate?: string;
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** AI-generated content filter: `0` = hide AI works, `1` = show only AI works. */
     searchAiType?: 0 | 1;
     /** Zero-based offset for pagination. */
@@ -1257,9 +1252,9 @@ interface IllustSearchParams {
 /** Parameters for fetching the illust ranking. */
 interface IllustRankingParams {
     /** Ranking category (default: `"day"`). */
-    mode?: RankingMode;
+    mode?: (typeof RankingMode)[keyof typeof RankingMode];
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** Specific date to fetch rankings for (YYYY-MM-DD; omit for the latest). */
     date?: string;
     /** Zero-based offset for pagination. */
@@ -1268,7 +1263,7 @@ interface IllustRankingParams {
 /** Parameters for fetching recommended illusts. */
 interface IllustRecommendedParams {
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** Zero-based offset for pagination. */
     offset?: number;
     /**
@@ -1287,14 +1282,14 @@ interface IllustSeriesParams {
     /** ID of the illust series to fetch. */
     illustSeriesId: number;
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
 }
 /** Parameters for adding an illust bookmark. */
 interface IllustBookmarkAddParams {
     /** ID of the illust to bookmark. */
     illustId: number;
     /** Bookmark visibility (default: `"public"`). */
-    restrict?: BookmarkRestrict;
+    restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
     /** Tags to attach to the bookmark. */
     tags?: string[];
 }
@@ -1413,13 +1408,13 @@ interface NovelSearchParams {
     /** Search keyword. */
     word: string;
     /** How to match the keyword against works (default: `"partial_match_for_tags"`). */
-    searchTarget?: SearchTarget;
+    searchTarget?: (typeof SearchTarget)[keyof typeof SearchTarget];
     /** Sort order for results (default: `"date_desc"`). */
-    sort?: SearchSort;
+    sort?: (typeof SearchSort)[keyof typeof SearchSort];
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** Date range preset filter (omit for no restriction). */
-    duration?: SearchDuration;
+    duration?: (typeof SearchDuration)[keyof typeof SearchDuration];
     /** Start date for a custom date range (YYYY-MM-DD; requires `endDate`). */
     startDate?: string;
     /** End date for a custom date range (YYYY-MM-DD; requires `startDate`). */
@@ -1432,9 +1427,9 @@ interface NovelSearchParams {
 /** Parameters for fetching the novel ranking. */
 interface NovelRankingParams {
     /** Ranking category (default: `"day"`). */
-    mode?: NovelRankingMode;
+    mode?: (typeof NovelRankingMode)[keyof typeof NovelRankingMode];
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** Specific date to fetch rankings for (YYYY-MM-DD; omit for the latest). */
     date?: string;
     /** Zero-based offset for pagination. */
@@ -1443,7 +1438,7 @@ interface NovelRankingParams {
 /** Parameters for fetching recommended novels. */
 interface NovelRecommendedParams {
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** Zero-based offset for pagination. */
     offset?: number;
     /**
@@ -1464,7 +1459,7 @@ interface NovelBookmarkAddParams {
     /** ID of the novel to bookmark. */
     novelId: number;
     /** Bookmark visibility (default: `"public"`). */
-    restrict?: BookmarkRestrict;
+    restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
     /** Tags to attach to the bookmark. */
     tags?: string[];
 }
@@ -1578,9 +1573,9 @@ interface UserBookmarksIllustParams {
     /** ID of the user whose bookmarks to fetch. */
     userId: number;
     /** Visibility of the bookmarks to return (default: `"public"`). */
-    restrict?: BookmarkRestrict;
+    restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** Limit results to bookmarks with this tag. */
     tag?: string;
     /** Fetch bookmarks older than this bookmark ID (cursor-based pagination). */
@@ -1593,9 +1588,9 @@ interface UserBookmarksNovelParams {
     /** ID of the user whose bookmarks to fetch. */
     userId: number;
     /** Visibility of the bookmarks to return (default: `"public"`). */
-    restrict?: BookmarkRestrict;
+    restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** Limit results to bookmarks with this tag. */
     tag?: string;
     /** Fetch bookmarks older than this bookmark ID (cursor-based pagination). */
@@ -1608,16 +1603,16 @@ interface UserDetailParams {
     /** ID of the user to fetch. */
     userId: number;
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
 }
 /** Parameters for fetching a user's illusts. */
 interface UserIllustsParams {
     /** ID of the user whose illusts to fetch. */
     userId: number;
     /** Work type to filter by (omit to return both illusts and manga). */
-    type?: UserIllustType;
+    type?: (typeof UserIllustType)[keyof typeof UserIllustType];
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** Zero-based offset for pagination. */
     offset?: number;
 }
@@ -1626,7 +1621,7 @@ interface UserNovelsParams {
     /** ID of the user whose novels to fetch. */
     userId: number;
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** Zero-based offset for pagination. */
     offset?: number;
 }
@@ -1635,7 +1630,7 @@ interface UserFollowingParams {
     /** ID of the user whose following list to fetch. */
     userId: number;
     /** Visibility of the follows to return (default: `"public"`). */
-    restrict?: FollowRestrict;
+    restrict?: (typeof FollowRestrict)[keyof typeof FollowRestrict];
     /** Zero-based offset for pagination. */
     offset?: number;
 }
@@ -1644,7 +1639,7 @@ interface UserFollowAddParams {
     /** ID of the user to follow. */
     userId: number;
     /** Visibility of the follow (default: `"public"`). */
-    restrict?: FollowRestrict;
+    restrict?: (typeof FollowRestrict)[keyof typeof FollowRestrict];
 }
 /** Parameters for unfollowing a user. */
 interface UserFollowDeleteParams {
@@ -1671,8 +1666,8 @@ declare class UserBookmarksResource {
      * // Resume from a saved cursor
      * import { parseNextUrl } from '@book000/pixivts'
      * const page = await client.users.bookmarks.illusts({ userId: client.userId })
-     * if (page.isOk && page.value.next_url) {
-     *   const cursor = parseNextUrl(page.value.next_url)
+     * if (page.isOk && page.value.nextUrl) {
+     *   const cursor = parseNextUrl(page.value.nextUrl)
      *   const next = await client.users.bookmarks.illusts({
      *     userId: client.userId,
      *     maxBookmarkId: cursor.maxBookmarkId,
@@ -1754,7 +1749,7 @@ declare class UserResource {
 /** Parameters for fetching recommended manga. */
 interface MangaRecommendedParams {
     /** OS filter to apply (default: `"for_ios"`). */
-    filter?: OSFilter;
+    filter?: (typeof OSFilter)[keyof typeof OSFilter];
     /** Zero-based offset for pagination. */
     offset?: number;
 }
@@ -1866,6 +1861,25 @@ declare class PixivClient {
      * ```
      */
     get userId(): number;
+    /**
+     * Returns the current OAuth access token.
+     *
+     * The access token is short-lived and changes after each call to
+     * {@link PixivClient.of} and after each automatic token refresh triggered
+     * by a 401 response.
+     *
+     * @returns The current bearer access token string
+     */
+    getAccessToken(): string;
+    /**
+     * Returns the current OAuth refresh token.
+     *
+     * The refresh token is long-lived and is used to obtain new access tokens.
+     * It may rotate after a successful token refresh.
+     *
+     * @returns The current refresh token string
+     */
+    getRefreshToken(): string;
     /**
      * Creates a PixivClient by refreshing the given token.
      *