@book000/pixivts 0.64.0-beta.8 → 0.64.0

package/README.md

@@ -72,11 +72,11 @@ Creates a `PixivClient` by exchanging the given refresh token for an access toke
 
 | Namespace | Methods |
 |---|---|
-| `illusts` | `detail`, `related`, `search`, `ranking`, `recommended`, `series`, `bookmarkAdd`, `bookmarkDelete`, `trendingTags`, `popularPreview` |
-| `novels` | `detail`, `text`, `related`, `search`, `ranking`, `recommended`, `series`, `bookmarkAdd`, `bookmarkDelete`, `trendingTags`, `popularPreview` |
-| `users` | `detail`, `detailV2`, `search`, `illusts`, `novels`, `following`, `followAdd`, `followDelete`, `related`, `recommended`, `follower`, `mypixiv`, `list`, `bookmarkTagsIllust`, `editAiShowSettings` |
+| `illusts` | `detail`, `related`, `search`, `ranking`, `recommended`, `series`, `bookmarkAdd`, `bookmarkDelete`, `mypixiv`, `trendingTags`, `popularPreview` |
+| `novels` | `detail`, `text`, `related`, `search`, `ranking`, `recommended`, `series`, `bookmarkAdd`, `bookmarkDelete`, `bookmarkUsers`, `mypixiv`, `trendingTags`, `popularPreview`, `watchlist`, `markers` |
+| `users` | `detail`, `detailV2`, `search`, `illusts`, `novels`, `following`, `followAdd`, `followDelete`, `related`, `recommended`, `follower`, `mypixiv`, `list`, `bookmarkTagsIllust`, `bookmarkTagsNovel`, `followDetail`, `editAiShowSettings`, `aiShowSettings`, `restrictedModeSettings`, `muteList`, `meState`, `hasUnreadNotifications` |
 | `users.bookmarks` | `illusts`, `novels` |
-| `manga` | `recommended` |
+| `manga` | `recommended`, `watchlist` |
 | `ugoira` | `metadata` |
 | `spotlight` | `articles` |
 | `images` | `fetch` |

package/dist/index.cjs

@@ -1191,6 +1191,16 @@ var IllustResource = class {
 		})), this.#http, (page) => page.illusts);
 	}
 	/**
+	* Fetches illusts posted by the authenticated account's mypixiv (mutual
+	* follow) users.
+	* GET /v2/illust/mypixiv
+	*
+	* @param params - Request parameters
+	*/
+	mypixiv(params = {}) {
+		return PaginatedResultAsync.fromResultAsync(this.#http.get("/v2/illust/mypixiv", buildParams({ offset: params.offset })), this.#http, (page) => page.illusts);
+	}
+	/**
 	* Fetches comments posted on an illust.
 	* GET /v3/illust/comments
 	*
@@ -1286,6 +1296,18 @@ function parseWebviewNovel(html) {
 }
 //#endregion
 //#region src/resources/novels.ts
+/**
+* Formats a view timestamp as ISO 8601 with milliseconds and the local UTC
+* offset of that instant. Strings are returned unchanged.
+*/
+function formatViewedAt(value) {
+	if (typeof value === "string") return value;
+	const pad = (n, width = 2) => String(n).padStart(width, "0");
+	const offsetMinutes = -value.getTimezoneOffset();
+	const sign = offsetMinutes < 0 ? "-" : "+";
+	const absOffset = Math.abs(offsetMinutes);
+	return `${value.getFullYear()}-${pad(value.getMonth() + 1)}-${pad(value.getDate())}T${pad(value.getHours())}:${pad(value.getMinutes())}:${pad(value.getSeconds())}.${pad(value.getMilliseconds(), 3)}${sign}${pad(Math.floor(absOffset / 60))}:${pad(absOffset % 60)}`;
+}
 /** Methods for the novel API namespace. */
 var NovelResource = class {
 	#http;
@@ -1425,18 +1447,27 @@ var NovelResource = class {
 	}
 	/**
 	* Fetches recommended novels.
-	* GET /v1/novel/recommended
+	* GET /v1/novel/recommended, or POST /v1/novel/recommended when
+	* `params.viewed` is non-empty.
 	*
 	* @param params - Request parameters
 	*/
 	recommended(params = {}) {
-		return PaginatedResultAsync.fromResultAsync(this.#http.get("/v1/novel/recommended", buildParams({
+		const path = "/v1/novel/recommended";
+		const query = {
 			filter: params.filter ?? "for_ios",
 			includeRankingNovels: true,
 			includePrivacyPolicy: true,
 			offset: params.offset,
 			maxBookmarkIdForRecommend: params.maxBookmarkIdForRecommend
-		})), this.#http, (page) => page.novels);
+		};
+		const viewed = params.viewed ?? [];
+		const first = viewed.length > 0 ? this.#http.post(path, buildParams({
+			...query,
+			viewNovelIds: viewed.map((entry) => entry.id),
+			viewNovelDatetimes: viewed.map((entry) => formatViewedAt(entry.viewedAt))
+		}).toString()) : this.#http.get(path, buildParams(query));
+		return PaginatedResultAsync.fromResultAsync(first, this.#http, (page) => page.novels);
 	}
 	/**
 	* Fetches a novel series.
@@ -1451,6 +1482,24 @@ var NovelResource = class {
 		})), this.#http, (page) => page.novels);
 	}
 	/**
+	* Fetches the authenticated user's novel series watchlist.
+	* GET /v1/watchlist/novel
+	*
+	* Takes no parameters; later pages follow the server-provided `next_url`.
+	*/
+	watchlist() {
+		return PaginatedResultAsync.fromResultAsync(this.#http.get("/v1/watchlist/novel"), this.#http, (page) => page.series);
+	}
+	/**
+	* Fetches the novels with a saved reading position (marker).
+	* GET /v2/novel/markers
+	*
+	* Takes no parameters; later pages follow the server-provided `next_url`.
+	*/
+	markers() {
+		return PaginatedResultAsync.fromResultAsync(this.#http.get("/v2/novel/markers"), this.#http, (page) => page.markedNovels);
+	}
+	/**
 	* Adds a novel bookmark.
 	* POST /v2/novel/bookmark/add
 	*
@@ -1475,6 +1524,18 @@ var NovelResource = class {
 		return this.#http.post("/v1/novel/bookmark/delete", body.toString());
 	}
 	/**
+	* Fetches the users who bookmarked a novel.
+	* GET /v1/novel/bookmark/users
+	*
+	* @param params - Request parameters
+	*/
+	bookmarkUsers(params) {
+		return PaginatedResultAsync.fromResultAsync(this.#http.get("/v1/novel/bookmark/users", buildParams({
+			novelId: params.novelId,
+			offset: params.offset
+		})), this.#http, (page) => page.users);
+	}
+	/**
 	* Fetches novels posted by users the authenticated account follows.
 	* GET /v1/novel/follow
 	*
@@ -1487,6 +1548,19 @@ var NovelResource = class {
 		})), this.#http, (page) => page.novels);
 	}
 	/**
+	* Fetches novels posted by the authenticated account's mypixiv (mutual
+	* follow) users.
+	* GET /v1/novel/mypixiv
+	*
+	* The endpoint ignores `offset`. Paginate with `maxNovelId`, or follow
+	* `next_url` via `.pages()` / `.items()`.
+	*
+	* @param params - Request parameters
+	*/
+	mypixiv(params = {}) {
+		return PaginatedResultAsync.fromResultAsync(this.#http.get("/v1/novel/mypixiv", buildParams({ maxNovelId: params.maxNovelId })), this.#http, (page) => page.novels);
+	}
+	/**
 	* Fetches comments posted on a novel.
 	* GET /v3/novel/comments
 	*
@@ -1799,6 +1873,28 @@ var UserResource = class {
 		})), this.#http, (page) => page.bookmarkTags);
 	}
 	/**
+	* Fetches a user's novel bookmark tags, with the number of bookmarks under each tag.
+	* GET /v1/user/bookmark-tags/novel
+	*
+	* @param params - Request parameters
+	*/
+	bookmarkTagsNovel(params) {
+		return PaginatedResultAsync.fromResultAsync(this.#http.get("/v1/user/bookmark-tags/novel", buildParams({
+			userId: params.userId,
+			restrict: params.restrict ?? "public",
+			offset: params.offset
+		})), this.#http, (page) => page.bookmarkTags);
+	}
+	/**
+	* Fetches whether the authenticated user follows a user, and with which visibility.
+	* GET /v1/user/follow/detail
+	*
+	* @param params - Request parameters
+	*/
+	followDetail(params) {
+		return this.#http.get("/v1/user/follow/detail", buildParams({ userId: params.userId }));
+	}
+	/**
 	* Edits the authenticated user's AI-generated-work display setting.
 	* POST /v1/user/ai-show-settings/edit
 	*
@@ -1808,6 +1904,41 @@ var UserResource = class {
 		const body = buildParams({ setting: params.setting });
 		return this.#http.post("/v1/user/ai-show-settings/edit", body.toString());
 	}
+	/**
+	* Fetches the authenticated user's AI-generated-work display setting.
+	* GET /v1/user/ai-show-settings
+	*/
+	aiShowSettings() {
+		return this.#http.get("/v1/user/ai-show-settings");
+	}
+	/**
+	* Fetches the authenticated user's restricted-mode setting.
+	* GET /v1/user/restricted-mode-settings
+	*/
+	restrictedModeSettings() {
+		return this.#http.get("/v1/user/restricted-mode-settings");
+	}
+	/**
+	* Fetches the authenticated user's mute list.
+	* GET /v1/mute/list
+	*/
+	muteList() {
+		return this.#http.get("/v1/mute/list");
+	}
+	/**
+	* Fetches the authenticated user's account state and profile.
+	* GET /v1/user/me/state
+	*/
+	meState() {
+		return this.#http.get("/v1/user/me/state");
+	}
+	/**
+	* Fetches whether the authenticated user has unread notifications.
+	* GET /v1/notification/has-unread-notifications
+	*/
+	hasUnreadNotifications() {
+		return this.#http.get("/v1/notification/has-unread-notifications");
+	}
 };
 //#endregion
 //#region src/resources/manga.ts
@@ -1831,6 +1962,15 @@ var MangaResource = class {
 			offset: params.offset
 		})), this.#http, (page) => page.illusts);
 	}
+	/**
+	* Fetches the authenticated user's manga series watchlist.
+	* GET /v1/watchlist/manga
+	*
+	* Takes no parameters; later pages follow the server-provided `next_url`.
+	*/
+	watchlist() {
+		return PaginatedResultAsync.fromResultAsync(this.#http.get("/v1/watchlist/manga"), this.#http, (page) => page.series);
+	}
 };
 //#endregion
 //#region src/resources/ugoira.ts