@natsuneko-laboratory/catalyst-sdk 0.7.2 → 1.0.0-alpha.2

package/dist/index.d.mts

@@ -34,11 +34,41 @@ interface EgeriaUserProfile {
     website: string;
     additionalWebsites: string[];
 }
+/** The `profileEmoji` shown alongside a "standard" (unicode) emoji value. */
+interface ProfileEmojiStandard {
+    type: "standard";
+    value: string;
+    imageUrl: string;
+}
+/** The `profileEmoji` shown when the user selected one of their custom reactions. */
+interface ProfileEmojiCustom {
+    type: "custom";
+    id: string;
+    shortcode: string;
+    displayName: string;
+    imageUrl: string;
+    width: number;
+    height: number;
+}
+/** Discriminated union (on `type`) modeling the response's `profileEmoji` field. */
+type ProfileEmoji = ProfileEmojiStandard | ProfileEmojiCustom;
+/** Request-shaped `profileEmoji` variant for `PATCH /egeria/v1/me` (fewer fields than the response). */
+interface ProfileEmojiStandardRequest {
+    type: "standard";
+    value: string;
+}
+/** Request-shaped `profileEmoji` variant referencing an existing custom reaction by id. */
+interface ProfileEmojiCustomRequest {
+    type: "custom";
+    customReactionId: string;
+}
+type ProfileEmojiRequest = ProfileEmojiStandardRequest | ProfileEmojiCustomRequest;
 interface EgeriaUser {
     id: string;
     screenName: string;
     displayName: string;
-    profile?: EgeriaUserProfile;
+    profile?: EgeriaUserProfile | null;
+    profileEmoji?: ProfileEmoji | null;
 }
 interface EgeriaUserWrapper {
     user: EgeriaUser;
@@ -50,11 +80,12 @@ interface EgeriaUpdateProfileRequest {
     screenName?: string;
     displayName?: string;
     profile?: EgeriaUserProfile;
+    profileEmoji?: ProfileEmojiRequest | null;
 }
 
 interface MediaMetadata {
-    width?: number;
-    height?: number;
+    width: number | null;
+    height: number | null;
     isSensitive: boolean;
     isSpoiler: boolean;
 }
@@ -62,8 +93,10 @@ interface Media {
     id: string;
     alt: string;
     url: string;
-    metadata?: MediaMetadata;
+    order: number;
+    metadata: MediaMetadata | null;
     privacyMetadata?: boolean;
+    blurhash?: string | null;
 }
 interface MediaUploadUrls {
     url: string;
@@ -71,7 +104,7 @@ interface MediaUploadUrls {
 }
 interface CatalystMediaWithMetadata {
     url: string;
-    alt: string;
+    alt?: string;
     width: number;
     height: number;
     bytes: number;
@@ -79,25 +112,142 @@ interface CatalystMediaWithMetadata {
 interface MediaDeleteRequest {
     url: string;
 }
-interface MediaDownloadRequest {
+
+interface CatalystReaction {
+    name: string;
+    symbol: string;
+    url: string;
+    count: number;
+    hasSelfReaction?: boolean;
+    customReactionId?: string;
+}
+interface CatalystReactions {
+    reactions: Record<string, CatalystReaction>;
+}
+interface CatalystCustomReaction {
+    id: string;
+    name: string;
+    symbol: string;
     url: string;
 }
+type CatalystCustomReactionStatus = "active" | "moderated" | "hidden" | "disabled";
+type CatalystCustomReactionVisibility = "private" | "followers" | "public";
+type SupporterTier = "none" | "tier_0" | "tier_1" | "tier_2" | "tier_3" | "tier_4" | "tier_5";
+interface CatalystUserCustomReaction {
+    id: string;
+    shortcode: string;
+    displayName: string;
+    imageUrl: string;
+    mimeType: string;
+    sortOrder: number;
+    status: CatalystCustomReactionStatus;
+    visibility: CatalystCustomReactionVisibility;
+    createdAt: string;
+}
+interface CatalystCustomReactionList {
+    plan: SupporterTier;
+    limit: number;
+    used: number;
+    items: CatalystUserCustomReaction[];
+}
+interface UpdateCustomReactionRequest {
+    displayName?: string;
+    sortOrder?: number;
+}
+
+interface CatalystContestRank {
+    id: string;
+    name: string;
+    description?: string;
+    count: number;
+    prize: string;
+    winners: EgeriaUser[];
+}
+type CatalystContestState = "draft" | "published" | "opening" | "closing" | "voting" | "electing" | "closed";
+interface CatalystContest {
+    slug: string;
+    draft: boolean;
+    state: CatalystContestState;
+    title: string;
+    description: string;
+    theme: string;
+    terms: string;
+    headerUrl: string;
+    bannerUrl: string;
+    organizer: EgeriaUser;
+    winnersOpenAt: string;
+    winnersMessageSendAt: string;
+    publishedAt: string;
+    since: string;
+    until: string;
+    allowSensitive: boolean;
+    maxMediaPerEntry: number | null;
+    voting: {
+        since: string;
+        until: string;
+        maxVotes: number;
+        isEnable: boolean;
+    };
+    ranks: CatalystContestRank[];
+}
+interface CatalystContestWrapper {
+    contest: CatalystContest;
+}
+interface CatalystContestsWrapper {
+    contests: CatalystContest[];
+}
+/** The current user's remaining vote allowance for a contest. */
+interface CatalystUserVoteRights {
+    remaining: number;
+    statuses: string[];
+}
 
 type CatalystStatusPrivacy = "public" | "quiet_public" | "followers" | "private";
+type CatalystStatusContest = Pick<CatalystContest, "slug" | "title" | "headerUrl" | "bannerUrl">;
 interface CatalystStatus {
     id: string;
     body: string;
-    user?: EgeriaUser;
+    user: EgeriaUser | null;
     medias: Media[];
+    contest: CatalystStatusContest | null;
     createdAt: string;
-    updatedAt?: string;
+    /** @deprecated 常に空配列。リアクションは reactions()/bulkStatusReactions() を利用すること */
+    reactions: unknown[];
+}
+interface CatalystStatusVisitor {
+    favorite: boolean;
+    reactions?: string[];
 }
-interface CatalystStatusWrapper {
+interface CatalystStatusV1_1 {
+    id: string;
+    body: string;
+    user: EgeriaUser | null;
+    medias: Media[];
+    contest: Pick<CatalystStatusContest, "slug" | "title" | "headerUrl"> | null;
+    reactions: Record<string, Omit<CatalystReaction, "hasSelfReaction">>;
+    createdAt: string;
+    updatedAt: string;
+    visitor?: CatalystStatusVisitor;
+    privacy: CatalystStatusPrivacy;
+}
+/** Wrapper for `GET /catalyst/v1/status/{id}` (`{"status": StatusV1_0Response}`). */
+interface CatalystStatusV1Wrapper {
     status: CatalystStatus;
 }
+/** Wrapper for `GET /catalyst/v1.1/status/{id}` (`{"status": StatusV1_1Response}`). */
+interface CatalystStatusV1_1Wrapper {
+    status: CatalystStatusV1_1;
+}
+/** Wrapper for `GET /catalyst/v1/random` (`{"status": StatusV1_0Response | null}`). */
+interface CatalystRandomStatusWrapper {
+    status: CatalystStatus | null;
+}
 interface CatalystStatuses {
     statuses: CatalystStatus[];
 }
+interface CatalystStatusesV1_1 {
+    statuses: CatalystStatusV1_1[];
+}
 interface CatalystCreateStatusRequest {
     description: string;
     isNsfw: boolean;
@@ -124,39 +274,69 @@ interface CatalystAlbum {
     user: EgeriaUser;
     statuses: CatalystStatus[];
 }
+/** Wrapper for the `{"albums": [...]}` response shape, e.g. `GET /catalyst/v1/status/{id}/albums`. */
+interface CatalystAlbumsWrapper {
+    albums: CatalystAlbum[];
+}
 interface CatalystSmartAlbum {
     id: string;
     name: string;
     description: string;
     isAllowNsfw: boolean;
     isAllowOthers: boolean;
-    since?: string;
-    until?: string;
+    since?: string | null;
+    until?: string | null;
     isPublic: boolean;
     mode: CatalystAlbumDisplayMode;
-    user?: EgeriaUser;
-    type?: string;
+    user: EgeriaUser | null;
     statuses: CatalystStatus[];
     hashtags: string[];
 }
 interface CatalystSmartAlbums {
     albums: CatalystSmartAlbum[];
 }
-interface CatalystCreateAlbumRequest {
-    title: string;
+/** A "type"-discriminated album, returned by album-by-me/by-user/search endpoints which mix
+ * plain albums and smart albums in the same list (`AlbumOrSmartAlbumResponse`). */
+interface CatalystAlbumOrSmartAlbum {
+    id: string;
+    name: string;
     description: string;
+    hashtags: string[];
+    isAllowNsfw: boolean;
+    isAllowOthers: boolean;
     isPublic: boolean;
+    since: string | null;
+    until: string | null;
     mode: CatalystAlbumDisplayMode;
+    user: EgeriaUser;
+    statuses: CatalystStatus[];
+    type: "album" | "smart-album";
+}
+interface CatalystAlbumOrSmartAlbums {
+    albums: CatalystAlbumOrSmartAlbum[];
+}
+interface CatalystCreateAlbumRequest {
+    title: string;
+    description?: string;
+    isPublic?: boolean;
+    mode?: CatalystAlbumDisplayMode;
 }
 interface CatalystEditAlbumRequest {
     title: string;
-    description: string;
-    isPublic: boolean;
-    mode: CatalystAlbumDisplayMode;
+    description?: string;
+    isPublic?: boolean;
+    mode?: CatalystAlbumDisplayMode;
+}
+/** Shared request body for `PUT /catalyst/v1/album/by/id/{id}` (both insert and remove). */
+interface CatalystInsertOrRemoveStatusAlbumRequest {
+    insert?: string;
+    remove?: string;
 }
+/** @deprecated use {@link CatalystInsertOrRemoveStatusAlbumRequest} */
 interface CatalystInsertToAlbumRequest {
     insert: string;
 }
+/** @deprecated use {@link CatalystInsertOrRemoveStatusAlbumRequest} */
 interface CatalystRemoveFromAlbumRequest {
     remove: string;
 }
@@ -168,7 +348,7 @@ interface CatalystCreateSmartAlbumRequest {
     until?: string;
     isAllowNsfw?: boolean;
     isAllowOthers?: boolean;
-    isPublic: boolean;
+    isPublic?: boolean;
     mode?: CatalystAlbumDisplayMode;
 }
 interface CatalystEditSmartAlbumRequest {
@@ -179,47 +359,74 @@ interface CatalystEditSmartAlbumRequest {
     until?: string;
     isAllowNsfw?: boolean;
     isAllowOthers?: boolean;
-    isPublic: boolean;
+    isPublic?: boolean;
     mode?: CatalystAlbumDisplayMode;
 }
-
-interface CatalystReaction {
-    name: string;
-    symbol: string;
-    url: string;
-    count: number;
-    hasSelfReaction?: boolean;
-}
-interface CatalystReactions {
-    reactions: Record<string, CatalystReaction>;
-}
-interface CatalystCustomReaction {
-    id: string;
-    name: string;
-    symbol: string;
-    url: string;
-}
-type CatalystCustomReactionStatus = "active" | "moderated" | "hidden" | "disabled";
-type SupporterTier = "none" | "tier_0" | "tier_1" | "tier_2" | "tier_3" | "tier_4" | "tier_5";
-interface CatalystUserCustomReaction {
+type CatalystAlbumBookTemplate = "photo-book" | "record-book";
+type CatalystAlbumBookQuality = "web" | "print";
+type CatalystAlbumBookTocType = "per-post" | "page-only";
+type CatalystAlbumBookStatus = "pending" | "processing" | "completed" | "failed";
+/** `AlbumBookResponse` — a generated photo/record book for an album or smart album. */
+interface CatalystAlbumBook {
     id: string;
-    shortcode: string;
-    displayName: string;
-    imageUrl: string;
-    mimeType: string;
-    sortOrder: number;
-    status: CatalystCustomReactionStatus;
-    createdAt: string;
+    albumId: string | null;
+    smartAlbumId: string | null;
+    template: CatalystAlbumBookTemplate;
+    quality: CatalystAlbumBookQuality;
+    coverImageUrl: string | null;
+    subtitle: string | null;
+    customText: string | null;
+    showBody: boolean;
+    showDate: boolean;
+    showUrl: boolean;
+    tocType: CatalystAlbumBookTocType | null;
+    colophonText: string | null;
+    status: CatalystAlbumBookStatus;
+    errorMessage: string | null;
+    downloadUrl: string | null;
+    expiresAt: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+/** Request body for `POST /catalyst/v1/{album,smart-album}/by/id/{id}/book` (`CreateAlbumBook`). */
+interface CatalystCreateAlbumBookRequest {
+    template: CatalystAlbumBookTemplate;
+    quality: CatalystAlbumBookQuality;
+    coverImageUrl?: string;
+    subtitle?: string;
+    customText?: string;
+    showBody?: boolean;
+    showDate?: boolean;
+    showUrl?: boolean;
+    showQrCode?: boolean;
+    tocType?: CatalystAlbumBookTocType;
+    colophonText?: string;
 }
-interface CatalystCustomReactionList {
-    plan: SupporterTier;
-    limit: number;
-    used: number;
-    items: CatalystUserCustomReaction[];
-}
-interface UpdateCustomReactionRequest {
-    displayName?: string;
-    sortOrder?: number;
+
+/** Generic `{"result": boolean}` response shape used by many mutation endpoints. */
+interface CatalystResult {
+    result: boolean;
+}
+/** Generic `{"value": number}` response shape used by reaction toggle endpoints. */
+interface CatalystReactionValue {
+    value: number;
+}
+/** Generic `{"message": string}` response shape. */
+interface CatalystMessage {
+    message: string;
+}
+/** Total/offset counters used by several list endpoints. */
+interface CountInfo {
+    total: number;
+    offset: number;
+}
+/** Page cursor metadata used by several list endpoints. */
+interface PageInfo {
+    min: number;
+    max: number;
+    current: number;
+    next: number | null;
+    prev: number | null;
 }
 
 interface CatalystRelationships {
@@ -231,43 +438,55 @@ interface CatalystRelationships {
 interface CatalystRelationshipRequest {
     userId: string;
 }
+/** Following/follower counts for a user. */
+interface CatalystRelationshipsCount {
+    followings: number | null;
+    followers: number | null;
+}
+/** Paginated list of a user's followers or followings. */
+interface CatalystFollowingOrFollowersList {
+    items: EgeriaUser[];
+    count: CountInfo;
+    page: PageInfo;
+}
 
+interface CatalystCreateFleetMediaPlacement {
+    posX: number;
+    posY: number;
+    scale?: number;
+    rotation?: number;
+}
 interface CatalystCreateFleetMedia {
     url: string;
+    alt?: string;
     width: number;
     height: number;
     bytes: number;
-    placement: {
-        posX: number;
-        posY: number;
-        scale: number;
-        rotation: number;
-    };
-    alt?: string | undefined;
+    placement: CatalystCreateFleetMediaPlacement;
 }
 interface CatalystCreateFleetText {
-    backgroundColor: string;
     body: string;
-    textStyle: "default" | "bold" | "serif" | "handwriting";
-    textAlignment: "left" | "center" | "right";
-    color: string;
+    backgroundColor?: string;
+    textStyle?: "default" | "bold" | "serif" | "handwriting";
+    textAlignment?: "left" | "center" | "right";
+    color?: string;
     posX: number;
     posY: number;
-    scale: number;
-    rotation: number;
+    scale?: number;
+    rotation?: number;
 }
 interface CatalystCreateFleetSticker {
     posX: number;
     posY: number;
-    scale: number;
-    rotation: number;
+    scale?: number;
+    rotation?: number;
     emoji: string;
 }
 interface CatalystCreateFleetRequest {
-    backgroundColor: string;
-    texts: CatalystCreateFleetText[];
+    backgroundColor?: string;
+    texts?: CatalystCreateFleetText[];
     media: CatalystCreateFleetMedia;
-    stickers: CatalystCreateFleetSticker[];
+    stickers?: CatalystCreateFleetSticker[];
 }
 interface CatalystFleetText {
     id: string;
@@ -304,6 +523,7 @@ interface CatalystFleetMedia {
 interface CatalystFleet extends CatalystReactions {
     id: string;
     backgroundColor: string;
+    renderedImageUrl: string | null;
     user: EgeriaUser;
     texts: CatalystFleetText[];
     media: CatalystFleetMedia | null;
@@ -322,117 +542,6 @@ interface CatalystFleetRing {
     fleetCount: number;
 }
 
-interface CatalystCreateContestRequest {
-    title: string;
-    description: string;
-    theme: string;
-}
-interface CatalystEditContestRequest {
-    title?: string;
-    description?: string;
-    theme?: string;
-    terms?: string;
-    headerUrl?: string;
-    bannerUrl?: string;
-    winnersOpenAt?: string;
-    winnersMessageSendAt?: string;
-    publishedAt?: string;
-    application?: {
-        since?: string;
-        until?: string;
-        allowSensitive: boolean;
-        maxMediaPerEntry?: number;
-    };
-    voting?: {
-        since?: string;
-        until?: string;
-        maxVotes?: number;
-        isEnableVoting?: boolean;
-    };
-    ranks?: Omit<CatalystContestRank, "id" | "winners">[];
-}
-interface CatalystContestRank {
-    id: string;
-    name: string;
-    description?: string;
-    count: number;
-    prize: string;
-    winners: EgeriaUser[];
-}
-interface CatalystContest {
-    slug: string;
-    draft: boolean;
-    state: string;
-    title: string;
-    description: string;
-    theme: string;
-    terms: string;
-    headerUrl: string;
-    bannerUrl: string;
-    winnersOpenAt: string;
-    winnersMessageSendAt: string;
-    publishedAt: string;
-    since: string;
-    until: string;
-    allowSensitive: boolean;
-    maxMediaPerEntry: number | null;
-    voting: {
-        since: string;
-        until: string;
-        maxVotes: number;
-        isEnable: boolean;
-    };
-    winners: {
-        since: string;
-        until: string;
-    };
-    ranks: CatalystContestRank[];
-}
-interface CatalystContestAward {
-    id: string;
-    name: string;
-    winners: CatalystStatus & {
-        message?: string | null;
-        commentary?: string | null;
-        attachment?: {
-            name: string;
-            id: string;
-        } | null;
-    }[];
-    order: number;
-    count: number;
-    remaining: number;
-}
-interface CatalystSetContestAwardRequest {
-    status: string;
-    message?: string;
-    commentary?: string;
-}
-interface CatalystUnsetContestAwardRequest {
-    status: string;
-    message?: string;
-    commentary?: string;
-}
-interface CatalystContestCollaborator {
-    user: Omit<EgeriaUser, "profile">;
-    role: "admin" | "collaborator" | "contributor";
-}
-interface CatalystContestAddCollaboratorRequest {
-    userId: string;
-    role: "collaborator" | "contributor";
-}
-interface CatalystContestRemoveCollaboratorRequest {
-    userId: string;
-}
-interface CatalystContestPolls {
-    status: CatalystStatus;
-    count: number;
-}
-interface CatalystUserVoteRights {
-    remaining: number;
-    statuses: string[];
-}
-
 interface ReportRequest {
     reason: "nsfw" | "tos_violation" | "harassment" | "spam" | "other";
     description?: string;
@@ -456,242 +565,221 @@ interface CatalystAnnouncement {
     until: string;
     url: string | null;
 }
+/** Wrapper for the `{"announcements": [...]}` response shape. */
+interface CatalystAnnouncementsWrapper {
+    announcements: CatalystAnnouncement[];
+}
 
 interface ProfileTag {
     id: string;
     name: string;
     normalizedName: string;
 }
+/** Wrapper for the `{"tags": [...]}` response shape. */
+interface ProfileTagsWrapper {
+    tags: ProfileTag[];
+}
 interface ProfileTagSuggestion {
     id: string;
     name: string;
     usageCount: number;
 }
+/** Wrapper for the `{"tags": [...]}` response shape (profile tag suggestions). */
+interface ProfileTagSuggestionsWrapper {
+    tags: ProfileTagSuggestion[];
+}
 interface ProfileTagUser extends EgeriaUser {
     matchedTags: string[];
 }
+/** Summary information for a profile tag (used within {@link ProfileTagUsersResult}). */
+interface ProfileTagSummary {
+    name: string;
+    usageCount: number;
+}
+/** Result of listing users by profile tag, including cursor-based pagination. */
+interface ProfileTagUsersResult {
+    tag: ProfileTagSummary;
+    users: ProfileTagUser[];
+    nextCursor: string | null;
+}
 interface UpdateProfileTagsRequest {
     tags: string[];
 }
 
+/** A single month bucket in the status archive. */
+interface CatalystArchiveMonth {
+    year: number;
+    month: number;
+    count: number;
+}
+/** Wrapper for the `{"months": [...]}` response shape. */
+interface CatalystArchiveMonths {
+    months: CatalystArchiveMonth[];
+}
+
+/** A single entry in the "rich" trending list (`GET /catalyst/v1/trend?format=rich`). */
+interface CatalystRichTrendingItem {
+    tag: string;
+    rank: number;
+    previousRank: number | null;
+    movement: "up" | "down" | "same" | "new";
+}
+
 declare class CatalystClient {
     private readonly http;
     constructor(http: HttpClient);
     createAlbum(data: CatalystCreateAlbumRequest): Promise<Identity>;
     getAlbum(id: string, opts?: {
+        limit?: number;
         since?: string;
         until?: string;
     }): Promise<CatalystAlbum>;
-    editAlbum(id: string, data: CatalystEditAlbumRequest): Promise<void>;
-    insertToAlbum(id: string, data: CatalystInsertToAlbumRequest): Promise<void>;
-    removeFromAlbum(id: string, data: CatalystRemoveFromAlbumRequest): Promise<void>;
-    deleteAlbum(id: string): Promise<void>;
-    listAlbums(username: string, includeSmartAlbums?: boolean): Promise<CatalystSmartAlbums>;
-    searchAlbums(q: string, includeSmartAlbums?: boolean): Promise<CatalystSmartAlbums>;
+    insertToAlbum(id: string, statusId: string): Promise<CatalystResult>;
+    removeFromAlbum(id: string, statusId: string): Promise<CatalystResult>;
+    editAlbum(id: string, data: CatalystEditAlbumRequest): Promise<CatalystResult>;
+    deleteAlbum(id: string): Promise<CatalystResult>;
+    getAlbumBooks(id: string): Promise<CatalystAlbumBook[]>;
+    createAlbumBook(id: string, data: CatalystCreateAlbumBookRequest): Promise<CatalystAlbumBook>;
+    getAlbumBook(id: string, bookId: string): Promise<CatalystAlbumBook>;
+    regenerateAlbumBook(id: string, bookId: string): Promise<CatalystAlbumBook>;
+    getAlbumsByMe(includeSmartAlbums?: boolean): Promise<CatalystAlbumOrSmartAlbum[]>;
+    listAlbums(username: string, includeSmartAlbum?: boolean): Promise<CatalystAlbumOrSmartAlbum[]>;
+    searchAlbums(q?: string, includeSmartAlbum?: boolean, until?: string): Promise<CatalystAlbumOrSmartAlbum[]>;
+    announcements(): Promise<CatalystAnnouncement[]>;
+    block(userId: string): Promise<CatalystResult>;
+    unblock(userId: string): Promise<CatalystResult>;
+    getContestsByMe(): Promise<CatalystContest[]>;
+    getContestBySlug(slug: string): Promise<CatalystContest>;
+    contestTimeline(slug: string): Promise<CatalystStatus[]>;
+    getContestVotes(slug: string): Promise<CatalystUserVoteRights>;
+    addContestVote(slug: string, status: string): Promise<CatalystResult>;
+    removeContestVote(slug: string, status: string): Promise<CatalystResult>;
+    getContestsByUser(userId: string): Promise<CatalystContest[]>;
+    currentContests(): Promise<CatalystContest[]>;
+    searchContests(q?: string, state?: string, id?: string): Promise<CatalystContest[]>;
     customReactions(): Promise<CatalystCustomReaction[]>;
-    customUserReactions(): Promise<CatalystCustomReactionList>;
+    getCustomUserReactions(): Promise<CatalystCustomReactionList>;
+    /**
+     * Creates a custom reaction. `data` must include the `image`, `shortcode`, `displayName` and
+     * `visibility` ("private" | "followers" | "public") fields as multipart form fields.
+     */
     createCustomReaction(data: FormData): Promise<CatalystUserCustomReaction>;
-    updateCustomReaction(id: string, data: UpdateCustomReactionRequest): Promise<void>;
+    updateCustomReaction(id: string, data: UpdateCustomReactionRequest): Promise<CatalystUserCustomReaction>;
     deleteCustomReaction(id: string): Promise<void>;
-    block(data: CatalystRelationshipRequest): Promise<void>;
-    unblock(data: CatalystRelationshipRequest): Promise<void>;
-    relationships(id: string): Promise<CatalystRelationships>;
-    follow(data: CatalystRelationshipRequest): Promise<void>;
-    remove(data: CatalystRelationshipRequest): Promise<void>;
-    followings(id: string, opts?: {
+    createFleet(data: CatalystCreateFleetRequest): Promise<Identity>;
+    fleetByUsername(username: string): Promise<CatalystFleet[]>;
+    fleets(): Promise<CatalystFleetRing[]>;
+    fleetById(id: string): Promise<CatalystFleet>;
+    deleteFleet(id: string): Promise<CatalystResult>;
+    reactFleet(id: string, symbol: string): Promise<CatalystReactionValue>;
+    unreactFleet(id: string, symbol: string): Promise<CatalystReactionValue>;
+    viewFleet(id: string): Promise<CatalystResult>;
+    fleetViewers(id: string): Promise<CatalystFleetViewer[]>;
+    getPrivacySettings(): Promise<CatalystPrivacySettings>;
+    updatePrivacySettings(data: CatalystPrivacySettingsRequest): Promise<CatalystPrivacySettings>;
+    updateProfileTags(data: UpdateProfileTagsRequest): Promise<ProfileTag[]>;
+    profileTagSuggestions(q: string): Promise<ProfileTagSuggestion[]>;
+    getUsersByProfileTag(name: string, cursor?: string): Promise<ProfileTagUsersResult>;
+    getProfileTagsByUser(id: string): Promise<ProfileTag[]>;
+    randomStatus(): Promise<CatalystStatus | null>;
+    randomStatusV1_1(): Promise<CatalystStatusV1_1>;
+    onThisDay(): Promise<CatalystStatusV1_1>;
+    createStatus(data: CatalystCreateStatusRequest): Promise<Identity>;
+    getStatus(id: string): Promise<CatalystStatus>;
+    getStatusV1_1(id: string): Promise<CatalystStatusV1_1>;
+    editStatus(id: string, description: string): Promise<Identity>;
+    deleteStatus(id: string): Promise<CatalystMessage>;
+    albumsInStatus(id: string): Promise<CatalystAlbum[]>;
+    isFavorited(id: string): Promise<boolean>;
+    favorite(id: string): Promise<CatalystResult>;
+    unfavorite(id: string): Promise<CatalystResult>;
+    reactions(id: string): Promise<Record<string, CatalystReaction>>;
+    reactWithCustomReaction(id: string, customReactionId: string): Promise<void>;
+    unreactWithCustomReaction(id: string, customReactionId: string): Promise<void>;
+    react(id: string, symbol: string): Promise<CatalystReactionValue>;
+    unreact(id: string, symbol: string): Promise<CatalystReactionValue>;
+    reportStatus(id: string, data: ReportRequest): Promise<Identity>;
+    bulkStatusReactions(ids: string[]): Promise<Record<string, Record<string, CatalystReaction>>>;
+    follow(userId: string): Promise<CatalystResult>;
+    remove(userId: string): Promise<CatalystResult>;
+    relationshipCounts(username: string): Promise<CatalystRelationshipsCount>;
+    followers(username: string, opts?: {
         page?: number;
-    }): Promise<{
-        items: EgeriaUser[];
-        count: {
-            total: number;
-            offset: number;
-        };
-        page: {
-            min: number;
-            max: number;
-            current: number;
-            next: number | null;
-            prev: number | null;
-        };
-    }>;
-    followers(id: string, opts?: {
+    }): Promise<CatalystFollowingOrFollowersList>;
+    followings(username: string, opts?: {
         page?: number;
-    }): Promise<{
-        items: EgeriaUser[];
-        count: {
-            total: number;
-            offset: number;
-        };
-        page: {
-            min: number;
-            max: number;
-            current: number;
-            next: number | null;
-            prev: number | null;
-        };
-    }>;
-    relationshipCounts(id: string): Promise<{
-        followers: number | null;
-        followings: number | null;
-    }>;
+    }): Promise<CatalystFollowingOrFollowersList>;
+    relationships(id: string): Promise<CatalystRelationships>;
     createSmartAlbum(data: CatalystCreateSmartAlbumRequest): Promise<Identity>;
     getSmartAlbum(id: string, opts?: {
+        limit?: number;
         since?: string;
         until?: string;
     }): Promise<CatalystSmartAlbum>;
-    editSmartAlbum(id: string, data: CatalystEditSmartAlbumRequest): Promise<void>;
-    deleteSmartAlbum(id: string): Promise<void>;
-    searchSmartAlbum(q: string): Promise<CatalystSmartAlbums>;
-    createStatus(data: CatalystCreateStatusRequest): Promise<Identity>;
-    getStatus(id: string): Promise<CatalystStatusWrapper>;
-    editStatus(id: string, data: CatalystEditStatusRequest): Promise<void>;
-    deleteStatus(id: string): Promise<void>;
-    isFavorited(id: string): Promise<boolean>;
-    favorite(id: string): Promise<void>;
-    unfavorite(id: string): Promise<void>;
-    reactions(id: string): Promise<CatalystReactions>;
-    albumsInStatus(id: string): Promise<CatalystSmartAlbums>;
-    react(id: string, symbol: string): Promise<void>;
-    unreact(id: string, symbol: string): Promise<void>;
-    contestTimeline(slug: string, opts?: {
+    editSmartAlbum(id: string, data: CatalystEditSmartAlbumRequest): Promise<CatalystSmartAlbum>;
+    deleteSmartAlbum(id: string): Promise<CatalystResult>;
+    getSmartAlbumBooks(id: string): Promise<CatalystAlbumBook[]>;
+    createSmartAlbumBook(id: string, data: CatalystCreateAlbumBookRequest): Promise<CatalystAlbumBook>;
+    getSmartAlbumBook(id: string, bookId: string): Promise<CatalystAlbumBook>;
+    regenerateSmartAlbumBook(id: string, bookId: string): Promise<CatalystAlbumBook>;
+    listSmartAlbumsByUser(userId: string): Promise<CatalystSmartAlbum[]>;
+    searchSmartAlbums(q?: string): Promise<CatalystSmartAlbum[]>;
+    archiveTimeline(opts: {
+        year: number;
+        month: number;
+        day?: number;
+        since?: string;
+        until?: string;
+        userId?: string;
+        limit?: number;
+        excludeSensitive?: boolean;
+    }): Promise<CatalystStatus[]>;
+    archiveMonths(): Promise<CatalystArchiveMonth[]>;
+    timelineByContestSlug(slug: string, opts?: {
         since?: string;
         until?: string;
-    }): Promise<CatalystStatuses>;
+    }): Promise<CatalystStatus[]>;
     favoriteTimeline(opts?: {
         since?: string;
         until?: string;
-    }): Promise<CatalystStatuses>;
-    firehoseTimeline(opts?: {
+    }): Promise<CatalystStatusV1_1[]>;
+    firehoseTimelineV1(opts?: {
         since?: string;
         until?: string;
     }): Promise<CatalystStatus[]>;
     galleryTimeline(opts?: {
         since?: string;
         until?: string;
-    }): Promise<CatalystStatuses>;
-    homeTimeline(opts?: {
-        since?: string;
-        until?: string;
     }): Promise<CatalystStatus[]>;
+    homeTimelineV1(): Promise<CatalystStatus[]>;
     searchTimeline(opts?: {
         q?: string;
         exact?: boolean;
         since?: string;
         until?: string;
-    }): Promise<CatalystStatuses>;
+    }): Promise<CatalystStatus[]>;
     userTimeline(username: string, opts?: {
-        trimUser?: boolean;
-        excludeSensitive?: boolean;
         since?: string;
         until?: string;
-    }): Promise<CatalystStatuses>;
+        limit?: number;
+        excludeSensitive?: boolean;
+    }): Promise<CatalystStatus[]>;
     userGalleryTimeline(username: string, opts?: {
         since?: string;
         until?: string;
-    }): Promise<CatalystStatuses>;
-    trend(): Promise<string[]>;
-    createFleet(data: CatalystCreateFleetRequest): Promise<void>;
-    fleetById(id: string): Promise<CatalystFleet>;
-    deleteFleet(id: string): Promise<void>;
-    viewFleet(id: string): Promise<void>;
-    fleetViewers(id: string): Promise<CatalystFleetViewer[]>;
-    reactFleet(id: string, symbol: string): Promise<void>;
-    unreactFleet(id: string, symbol: string): Promise<void>;
-    fleets(): Promise<CatalystFleetRing[]>;
-    fleetByUsername(username: string): Promise<CatalystFleet[]>;
-    createContest(data: CatalystCreateContestRequest): Promise<Identity>;
-    getContestsByMe(): Promise<CatalystContest[]>;
-    getContestBySlug(slug: string): Promise<{
-        contest: CatalystContest;
-    }>;
-    editContest(slug: string, data: CatalystEditContestRequest): Promise<void>;
-    getContestAwards(slug: string): Promise<{
-        awards: CatalystContestAward[];
-    }>;
-    setContestAward(slug: string, id: string, data: CatalystSetContestAwardRequest): Promise<void>;
-    unsetContestAward(slug: string, id: string, data: CatalystUnsetContestAwardRequest): Promise<void>;
-    getContestCollaborators(slug: string): Promise<{
-        collaborators: string[];
-    }>;
-    addContestCollaborator(slug: string, data: CatalystContestAddCollaboratorRequest): Promise<void>;
-    removeContestCollaborator(slug: string, data: CatalystContestRemoveCollaboratorRequest): Promise<void>;
-    copyContest(slug: string): Promise<Identity>;
-    getAccessPermissionOfContest(slug: string): Promise<{
-        result: "admin" | "collaborator" | "contributor" | "guest";
-    }>;
-    publishContest(slug: string): Promise<Identity>;
-    addContestVoteToStatus(slug: string, id: string): Promise<void>;
-    removeContestVoteFromStatus(slug: string, id: string): Promise<void>;
-    getContestVotes(slug: string): Promise<CatalystUserVoteRights>;
-    searchContest(state: string, q?: string): Promise<{
-        contests: CatalystContest[];
-    }>;
-    reportStatus(id: string, data: ReportRequest): Promise<void>;
-    getPrivacySettings(): Promise<CatalystPrivacySettings>;
-    updatePrivacySettings(data: CatalystPrivacySettingsRequest): Promise<CatalystPrivacySettings>;
-    announcements(): Promise<{
-        announcements: CatalystAnnouncement[];
-    }>;
-    updateProfileTags(data: UpdateProfileTagsRequest): Promise<{
-        tags: ProfileTag[];
-    }>;
-    profileTagSuggestions(q: string): Promise<{
-        tags: ProfileTagSuggestion[];
-    }>;
-    getUsersByProfileTag(name: string, cursor?: string): Promise<{
-        items: ProfileTagUser[];
-        cursor: string | null;
-    }>;
-    getProfileTagsByUser(id: string): Promise<{
-        tags: ProfileTag[];
-    }>;
-    randomStatus(): Promise<{
-        status: CatalystStatus | null;
-    }>;
-    randomStatusByHashtag(q: string): Promise<{
-        status: CatalystStatus | null;
-    }>;
-    bulkStatusReactions(ids: string[]): Promise<{
-        reactions: Record<string, CatalystReactions>;
-    }>;
-    archiveTimeline(opts: {
-        year: number;
-        month: number;
-        day?: number;
+    }): Promise<CatalystStatus[]>;
+    firehoseTimeline(opts?: {
         since?: string;
         until?: string;
-        userId?: string;
-        limit?: number;
-        trimUser?: boolean;
-        excludeSensitive?: boolean;
-    }): Promise<{
-        statuses: CatalystStatus[];
-    }>;
-    archiveMonths(): Promise<{
-        months: {
-            year: number;
-            month: number;
-            count: number;
-        }[];
-    }>;
-    currentContests(): Promise<{
-        contests: CatalystContest[];
-    }>;
-    getContestsByUser(username: string): Promise<{
-        contests: CatalystContest[];
-    }>;
-    getContestPolls(slug: string): Promise<{
-        polls: {
-            status: CatalystStatus;
-            count: number;
-        }[];
-    }>;
-    getAlbumsByMe(includeSmartAlbums?: boolean): Promise<{
-        albums: CatalystAlbum[];
-    }>;
-    listSmartAlbumsByUser(username: string): Promise<{
-        albums: CatalystSmartAlbum[];
-    }>;
+        trimVisitor?: boolean;
+    }): Promise<CatalystStatusV1_1[]>;
+    homeTimeline(opts?: {
+        since?: string;
+        until?: string;
+        trimVisitor?: boolean;
+    }): Promise<CatalystStatusV1_1[]>;
+    trend(): Promise<string[] | null>;
+    richTrend(): Promise<CatalystRichTrendingItem[] | null>;
 }
 
 declare class EgeriaClient {
@@ -704,11 +792,137 @@ declare class EgeriaClient {
     userByUsername(username: string): Promise<EgeriaUserWrapper | undefined>;
 }
 
+interface EpiclesePlatform {
+    id: string;
+    name: string;
+    description: string;
+    url: string | null;
+    startAt: string | null;
+}
+interface EpiclesePlatformsWrapper {
+    platforms: EpiclesePlatform[];
+}
+interface EpiclesePlatformWrapper {
+    platform: EpiclesePlatform;
+}
+interface EpicleseAuthor {
+    id: string;
+    platformIdentifier: string;
+    platform: EpiclesePlatform | null;
+    name: string;
+}
+interface EpicleseAuthorWrapper {
+    author: EpicleseAuthor;
+}
+/** Paginated result of `GET /epiclese/v1/authors`. */
+interface EpicleseAuthorsResult {
+    items: EpicleseAuthor[];
+    count: CountInfo;
+    page: PageInfo;
+}
+interface EpicleseWorld {
+    id: string;
+    platformIdentifier: string;
+    platform: EpiclesePlatform | null;
+    name: string;
+    author: EpicleseAuthor | null;
+}
+interface EpicleseWorldWrapper {
+    world: EpicleseWorld | null;
+}
+/** Internal wrapper for `GET /epiclese/v1/worlds` (`{"items": [...]}`, unwrapped by the client). */
+interface EpicleseWorldsWrapper {
+    items: EpicleseWorld[];
+}
+interface EpicleseCreateAuthorRequest {
+    id?: string;
+    platformIdentifier: string;
+    platform: string;
+    name: string;
+}
+interface EpicleseCreateWorldRequest {
+    id?: string;
+    platformIdentifier: string;
+    platform: string;
+    name: string;
+    author: EpicleseCreateAuthorRequest | null;
+}
+interface EpicleseCreateStatusMetadataReferenceRequest {
+    x: number;
+    y: number;
+    /** UUID referencing another tag entry within the same batch request. */
+    reference?: string;
+    type: string;
+    name: string;
+    description?: string;
+    externalUrl?: string;
+    author?: EpicleseCreateAuthorRequest;
+}
+interface EpicleseCreateStatusMetadataTagRequest {
+    id: string;
+    platform?: string;
+    world?: EpicleseCreateWorldRequest;
+    users?: {
+        id: string;
+    }[];
+    reference: EpicleseCreateStatusMetadataReferenceRequest[];
+    privacyMetadata?: boolean;
+}
+interface EpicleseStatusMetadataReference {
+    type: string;
+    name: string;
+    description: string;
+    externalUrl: string | null;
+    author: EpicleseAuthor;
+    x: number;
+    y: number;
+    reference: string;
+}
+interface EpicleseStatusMetadataTag {
+    platform: string | null;
+    world: EpicleseWorld | null;
+    users: EgeriaUser[];
+    reference: EpicleseStatusMetadataReference[];
+    additionalData?: Record<string, string>;
+    additionalData2?: Record<string, {
+        value: string;
+        ref: string | null;
+    }>;
+}
+/** `EpicleseStatusMetadataResponse` — a map keyed by tag id. */
+type EpicleseStatusMetadata = Record<string, EpicleseStatusMetadataTag>;
+
+/** Client for Epiclese (world/author metadata) API endpoints. */
+declare class EpicleseClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    getAuthors(q?: string, platform?: string): Promise<EpicleseAuthorsResult>;
+    createAuthor(data: EpicleseCreateAuthorRequest): Promise<EpicleseAuthor>;
+    getPlatforms(): Promise<EpiclesePlatform[]>;
+    getPlatform(id: string): Promise<EpiclesePlatform>;
+    getStatusMetadata(statusId: string): Promise<EpicleseStatusMetadata>;
+    createStatusMetadata(statusId: string, tags: EpicleseCreateStatusMetadataTagRequest[]): Promise<EpicleseStatusMetadata>;
+    getWorlds(q?: string, platform?: string, offset?: number): Promise<EpicleseWorld[]>;
+    createWorld(data: EpicleseCreateWorldRequest): Promise<EpicleseWorld | null>;
+    resolveWorld(platform: string, name: string): Promise<EpicleseWorld | null>;
+}
+
+/** Client for Feature Flags API endpoints. */
+declare class FeatureFlagsClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Gets the feature flags enabled for the current user. */
+    me(): Promise<string[]>;
+}
+
 declare class MediaClient {
     private readonly http;
     constructor(http: HttpClient);
-    download(data: MediaDownloadRequest): Promise<ArrayBuffer>;
-    delete(data: MediaDeleteRequest): Promise<void>;
+    /** Gets a signed URL for uploading media (v1). */
+    uploadV1(): Promise<MediaUploadUrls>;
+    /** Deletes media by URL. */
+    delete(url: string): Promise<boolean>;
+    /** Gets a signed URL for uploading media (v2). */
     upload(): Promise<MediaUploadUrls>;
 }
 
@@ -729,7 +943,7 @@ interface Notification {
     id: string;
     title: string;
     isGrouped: boolean;
-    belongsTo: Record<string, unknown>;
+    belongsTo?: Record<string, unknown>;
     entities: NotificationGroup[];
     hasMore: boolean;
     read: boolean;
@@ -750,19 +964,26 @@ declare class SteambirdClient {
     readonly ISSUER_CATALYST_USER_MESSAGE = "natsuneko-laboratory:catalyst-message";
     readonly ISSUER_EGERIA_SYSTEM_MESSAGE = "natsuneko-laboratory:egeria";
     constructor(http: HttpClient);
-    notifications(issuer: string, opts?: {
+    /** Gets notifications for a specific issuer, or all issuers if omitted. */
+    notifications(issuer?: string, opts?: {
         since?: string;
         until?: string;
-    }): Promise<Notifications>;
-    read(id: string): Promise<void>;
-    readAll(issuer?: string): Promise<void>;
-    unreads(issuers?: string[]): Promise<NotificationUnreadCount>;
+    }): Promise<Notification[]>;
+    read(id: string): Promise<CatalystResult>;
+    readAll(issuer?: string): Promise<CatalystResult>;
+    unreads(issuer?: string, issuers?: string[]): Promise<NotificationUnreadCount>;
 }
 
 interface Token {
     accessToken: string;
     refreshToken: string;
     tokenType: string;
+    /** Present on responses from the real token-exchange endpoint (e.g. "read write"). */
+    scope?: string;
+    /** ISO8601 timestamp string for when the access token expires. */
+    expiresAt?: string;
+    /** Seconds until the access token expires. */
+    expiresIn?: number;
 }
 
 declare class PKCE {
@@ -824,6 +1045,8 @@ declare class CatalystTS {
     get egeria(): EgeriaClient;
     get media(): MediaClient;
     get steambird(): SteambirdClient;
+    get epiclese(): EpicleseClient;
+    get featureFlags(): FeatureFlagsClient;
 }
 
 declare class ApiError extends Error {
@@ -844,74 +1067,132 @@ declare const PUBLIC_API_ENDPOINT = "https://api.natsuneko.com";
 declare const PUBLIC_GRAPHQL_ENDPOINT = "https://graphql.natsuneko.com";
 declare const PUBLIC_AUTHORIZE_ENDPOINT = "https://accounts.natsuneko.com/authorize";
 
+/** Wrapper for the `{"flags": [...]}` response shape of `GET /feature-flags/v1/me`. */
+interface FeatureFlagsResponse {
+    flags: string[];
+}
+
 declare const CatalystEndpoint: {
     readonly createAlbum: (data: CatalystCreateAlbumRequest) => Endpoint;
     readonly getAlbum: (id: string, opts?: {
+        limit?: number;
         since?: string;
         until?: string;
     }) => Endpoint;
+    readonly insertToAlbum: (id: string, statusId: string) => Endpoint;
+    readonly removeFromAlbum: (id: string, statusId: string) => Endpoint;
     readonly editAlbum: (id: string, data: CatalystEditAlbumRequest) => Endpoint;
-    readonly insertToAlbum: (id: string, data: CatalystInsertToAlbumRequest) => Endpoint;
-    readonly removeFromAlbum: (id: string, data: CatalystRemoveFromAlbumRequest) => Endpoint;
     readonly deleteAlbum: (id: string) => Endpoint;
-    readonly listAlbums: (username: string, includeSmartAlbums?: boolean) => Endpoint;
-    readonly searchAlbum: (q: string, includeSmartAlbums?: boolean) => Endpoint;
+    readonly getAlbumBooks: (id: string) => Endpoint;
+    readonly createAlbumBook: (id: string, data: CatalystCreateAlbumBookRequest) => Endpoint;
+    readonly getAlbumBook: (id: string, bookId: string) => Endpoint;
+    readonly regenerateAlbumBook: (id: string, bookId: string) => Endpoint;
+    readonly getAlbumsByMe: (includeSmartAlbums?: boolean) => Endpoint;
+    readonly listAlbums: (username: string, includeSmartAlbum?: boolean) => Endpoint;
+    readonly searchAlbums: (q?: string, includeSmartAlbum?: boolean, until?: string) => Endpoint;
+    readonly announcements: () => Endpoint;
+    readonly block: (userId: string) => Endpoint;
+    readonly unblock: (userId: string) => Endpoint;
+    readonly getContestsByMe: () => Endpoint;
+    readonly getContestBySlug: (slug: string) => Endpoint;
+    readonly contestTimeline: (slug: string) => Endpoint;
+    readonly getContestVotes: (slug: string) => Endpoint;
+    readonly addContestVote: (slug: string, status: string) => Endpoint;
+    readonly removeContestVote: (slug: string, status: string) => Endpoint;
+    readonly getContestsByUser: (userId: string) => Endpoint;
+    readonly currentContests: () => Endpoint;
+    readonly searchContests: (q?: string, state?: string, id?: string) => Endpoint;
     readonly customReactions: () => Endpoint;
-    readonly customUserReactions: () => Endpoint;
+    readonly getCustomUserReactions: () => Endpoint;
     readonly createCustomReaction: (data: FormData) => Endpoint;
     readonly updateCustomReaction: (id: string, data: UpdateCustomReactionRequest) => Endpoint;
     readonly deleteCustomReaction: (id: string) => Endpoint;
-    readonly block: (data: CatalystRelationshipRequest) => Endpoint;
-    readonly unblock: (data: CatalystRelationshipRequest) => Endpoint;
-    readonly relationships: (id: string) => Endpoint;
-    readonly follow: (data: CatalystRelationshipRequest) => Endpoint;
-    readonly remove: (data: CatalystRelationshipRequest) => Endpoint;
-    readonly followings: (username: string, opts?: {
+    readonly createFleet: (data: CatalystCreateFleetRequest) => Endpoint;
+    readonly fleetByUsername: (username: string) => Endpoint;
+    readonly fleets: () => Endpoint;
+    readonly fleetById: (id: string) => Endpoint;
+    readonly deleteFleet: (id: string) => Endpoint;
+    readonly reactFleet: (id: string, symbol: string) => Endpoint;
+    readonly unreactFleet: (id: string, symbol: string) => Endpoint;
+    readonly viewFleet: (id: string) => Endpoint;
+    readonly fleetViewers: (id: string) => Endpoint;
+    readonly getPrivacySettings: () => Endpoint;
+    readonly updatePrivacySettings: (data: CatalystPrivacySettingsRequest) => Endpoint;
+    readonly updateProfileTags: (data: UpdateProfileTagsRequest) => Endpoint;
+    readonly profileTagSuggestions: (q: string) => Endpoint;
+    readonly getUsersByProfileTag: (name: string, cursor?: string) => Endpoint;
+    readonly getProfileTagsByUser: (id: string) => Endpoint;
+    readonly randomStatus: () => Endpoint;
+    readonly randomStatusV1_1: () => Endpoint;
+    readonly onThisDay: () => Endpoint;
+    readonly createStatus: (data: CatalystCreateStatusRequest) => Endpoint;
+    readonly getStatus: (id: string) => Endpoint;
+    readonly getStatusV1_1: (id: string) => Endpoint;
+    readonly editStatus: (id: string, data: CatalystEditStatusRequest) => Endpoint;
+    readonly deleteStatus: (id: string) => Endpoint;
+    readonly albumsInStatus: (id: string) => Endpoint;
+    readonly isFavorited: (id: string) => Endpoint;
+    readonly favorite: (id: string) => Endpoint;
+    readonly unfavorite: (id: string) => Endpoint;
+    readonly reactions: (id: string) => Endpoint;
+    readonly reactWithCustomReaction: (id: string, customReactionId: string) => Endpoint;
+    readonly unreactWithCustomReaction: (id: string, customReactionId: string) => Endpoint;
+    readonly react: (id: string, symbol: string) => Endpoint;
+    readonly unreact: (id: string, symbol: string) => Endpoint;
+    readonly reportStatus: (id: string, data: ReportRequest) => Endpoint;
+    readonly bulkStatusReactions: (ids: string[]) => Endpoint;
+    readonly follow: (userId: string) => Endpoint;
+    readonly remove: (userId: string) => Endpoint;
+    readonly relationshipCounts: (username: string) => Endpoint;
+    readonly followers: (username: string, opts?: {
         page?: number;
     }) => Endpoint;
-    readonly followers: (username: string, opts?: {
+    readonly followings: (username: string, opts?: {
         page?: number;
     }) => Endpoint;
-    readonly relationshipCounts: (username: string) => Endpoint;
+    readonly relationships: (id: string) => Endpoint;
     readonly createSmartAlbum: (data: CatalystCreateSmartAlbumRequest) => Endpoint;
     readonly getSmartAlbum: (id: string, opts?: {
+        limit?: number;
         since?: string;
         until?: string;
     }) => Endpoint;
     readonly editSmartAlbum: (id: string, data: CatalystEditSmartAlbumRequest) => Endpoint;
     readonly deleteSmartAlbum: (id: string) => Endpoint;
-    readonly searchSmartAlbum: (q: string) => Endpoint;
-    readonly createStatus: (data: CatalystCreateStatusRequest) => Endpoint;
-    readonly getStatus: (id: string) => Endpoint;
-    readonly editStatus: (id: string, data: CatalystEditStatusRequest) => Endpoint;
-    readonly deleteStatus: (id: string) => Endpoint;
-    readonly isFavorited: (id: string) => Endpoint;
-    readonly favorite: (id: string) => Endpoint;
-    readonly unfavorite: (id: string) => Endpoint;
-    readonly reactions: (id: string) => Endpoint;
-    readonly albumsInStatus: (id: string) => Endpoint;
-    readonly react: (id: string, symbol: string) => Endpoint;
-    readonly unreact: (id: string, symbol: string) => Endpoint;
-    readonly contestTimeline: (slug: string, opts?: {
+    readonly getSmartAlbumBooks: (id: string) => Endpoint;
+    readonly createSmartAlbumBook: (id: string, data: CatalystCreateAlbumBookRequest) => Endpoint;
+    readonly getSmartAlbumBook: (id: string, bookId: string) => Endpoint;
+    readonly regenerateSmartAlbumBook: (id: string, bookId: string) => Endpoint;
+    readonly listSmartAlbumsByUser: (userId: string) => Endpoint;
+    readonly searchSmartAlbums: (q?: string) => Endpoint;
+    readonly archiveTimeline: (opts: {
+        year: number;
+        month: number;
+        day?: number;
         since?: string;
         until?: string;
+        userId?: string;
+        limit?: number;
+        excludeSensitive?: boolean;
     }) => Endpoint;
-    readonly favoriteTimeline: (opts?: {
+    readonly archiveMonths: () => Endpoint;
+    readonly timelineByContestSlug: (slug: string, opts?: {
         since?: string;
         until?: string;
     }) => Endpoint;
-    readonly firehoseTimeline: (opts?: {
+    readonly favoriteTimeline: (opts?: {
         since?: string;
         until?: string;
     }) => Endpoint;
-    readonly galleryTimeline: (opts?: {
+    readonly firehoseTimelineV1: (opts?: {
         since?: string;
         until?: string;
     }) => Endpoint;
-    readonly homeTimeline: (opts?: {
+    readonly galleryTimeline: (opts?: {
         since?: string;
         until?: string;
     }) => Endpoint;
+    readonly homeTimelineV1: () => Endpoint;
     readonly searchTimeline: (opts?: {
         q?: string;
         exact?: boolean;
@@ -919,70 +1200,27 @@ declare const CatalystEndpoint: {
         until?: string;
     }) => Endpoint;
     readonly userTimeline: (username: string, opts?: {
-        trimUser?: boolean;
-        excludeSensitive?: boolean;
         since?: string;
         until?: string;
+        limit?: number;
+        excludeSensitive?: boolean;
     }) => Endpoint;
     readonly userGalleryTimeline: (username: string, opts?: {
         since?: string;
         until?: string;
     }) => Endpoint;
-    readonly trend: () => Endpoint;
-    readonly createFleet: (data: CatalystCreateFleetRequest) => Endpoint;
-    readonly fleetById: (id: string) => Endpoint;
-    readonly deleteFleet: (id: string) => Endpoint;
-    readonly viewFleet: (id: string) => Endpoint;
-    readonly fleetViewers: (id: string) => Endpoint;
-    readonly reactFleet: (id: string, symbol: string) => Endpoint;
-    readonly unreactFleet: (id: string, symbol: string) => Endpoint;
-    readonly fleets: () => Endpoint;
-    readonly fleetByUsername: (username: string) => Endpoint;
-    readonly createContest: (data: CatalystCreateContestRequest) => Endpoint;
-    readonly getContestsByMe: () => Endpoint;
-    readonly getContestBySlug: (slug: string) => Endpoint;
-    readonly editContest: (slug: string, data: CatalystEditContestRequest) => Endpoint;
-    readonly getContestAwards: (slug: string) => Endpoint;
-    readonly setContestAward: (slug: string, id: string, data: CatalystSetContestAwardRequest) => Endpoint;
-    readonly unsetContestAward: (slug: string, id: string, data: CatalystUnsetContestAwardRequest) => Endpoint;
-    readonly getContestCollaborators: (slug: string) => Endpoint;
-    readonly addContestCollaborator: (slug: string, data: CatalystContestAddCollaboratorRequest) => Endpoint;
-    readonly removeContestCollaborator: (slug: string, data: CatalystContestRemoveCollaboratorRequest) => Endpoint;
-    readonly copyContest: (slug: string) => Endpoint;
-    readonly getAccessPermissionOfContest: (slug: string) => Endpoint;
-    readonly getContestPolls: (slug: string) => Endpoint;
-    readonly publishContest: (slug: string) => Endpoint;
-    readonly addContestVoteToStatus: (slug: string, id: string) => Endpoint;
-    readonly removeContestVoteFromStatus: (slug: string, id: string) => Endpoint;
-    readonly getContestVotes: (slug: string) => Endpoint;
-    readonly searchContest: (state: string, q?: string) => Endpoint;
-    readonly reportStatus: (id: string, data: ReportRequest) => Endpoint;
-    readonly getPrivacySettings: () => Endpoint;
-    readonly updatePrivacySettings: (data: CatalystPrivacySettingsRequest) => Endpoint;
-    readonly announcements: () => Endpoint;
-    readonly updateProfileTags: (data: UpdateProfileTagsRequest) => Endpoint;
-    readonly profileTagSuggestions: (q: string) => Endpoint;
-    readonly getUsersByProfileTag: (name: string, cursor?: string) => Endpoint;
-    readonly getProfileTagsByUser: (id: string) => Endpoint;
-    readonly randomStatus: () => Endpoint;
-    readonly randomStatusByHashtag: (q: string) => Endpoint;
-    readonly bulkStatusReactions: (ids: string[]) => Endpoint;
-    readonly archiveTimeline: (opts: {
-        year: number;
-        month: number;
-        day?: number;
+    readonly firehoseTimeline: (opts?: {
         since?: string;
         until?: string;
-        userId?: string;
-        limit?: number;
-        trimUser?: boolean;
-        excludeSensitive?: boolean;
+        trimVisitor?: boolean;
     }) => Endpoint;
-    readonly archiveMonths: () => Endpoint;
-    readonly currentContests: () => Endpoint;
-    readonly getContestsByUser: (username: string) => Endpoint;
-    readonly getAlbumsByMe: (includeSmartAlbums?: boolean) => Endpoint;
-    readonly listSmartAlbumsByUser: (username: string) => Endpoint;
+    readonly homeTimeline: (opts?: {
+        since?: string;
+        until?: string;
+        trimVisitor?: boolean;
+    }) => Endpoint;
+    readonly trend: () => Endpoint;
+    readonly richTrend: () => Endpoint;
 };
 
 declare const EgeriaEndpoint: {
@@ -993,20 +1231,38 @@ declare const EgeriaEndpoint: {
     readonly userByUsername: (username: string) => Endpoint;
 };
 
+declare const EpicleseEndpoint: {
+    readonly getAuthors: (q?: string, platform?: string) => Endpoint;
+    readonly createAuthor: (data: EpicleseCreateAuthorRequest) => Endpoint;
+    readonly getPlatforms: () => Endpoint;
+    readonly getPlatform: (id: string) => Endpoint;
+    readonly getStatusMetadata: (statusId: string) => Endpoint;
+    readonly createStatusMetadata: (statusId: string, data: EpicleseCreateStatusMetadataTagRequest[]) => Endpoint;
+    readonly getWorlds: (q?: string, platform?: string, offset?: number) => Endpoint;
+    readonly createWorld: (data: EpicleseCreateWorldRequest) => Endpoint;
+    readonly resolveWorld: (platform: string, name: string) => Endpoint;
+};
+
+declare const FeatureFlagsEndpoint: {
+    readonly me: () => Endpoint;
+};
+
 declare const MediaEndpoint: {
-    readonly download: (data: MediaDownloadRequest) => Endpoint;
+    /** Gets a signed URL for uploading media (v1). */
+    readonly uploadV1: () => Endpoint;
     readonly delete: (data: MediaDeleteRequest) => Endpoint;
+    /** Gets a signed URL for uploading media (v2). */
     readonly upload: () => Endpoint;
 };
 
 declare const SteambirdEndpoint: {
-    readonly notifications: (issuer: string, opts?: {
+    readonly notifications: (issuer?: string, opts?: {
         since?: string;
         until?: string;
     }) => Endpoint;
     readonly read: (id: string) => Endpoint;
     readonly readAll: (issuer?: string) => Endpoint;
-    readonly unreads: (issuers?: string[]) => Endpoint;
+    readonly unreads: (issuer?: string, issuers?: string[]) => Endpoint;
 };
 
 declare class AuthInterceptor implements RequestInterceptor {
@@ -1031,4 +1287,4 @@ declare class LoggingInterceptor implements RequestInterceptor {
     retry(request: Request, error: unknown): Promise<boolean>;
 }
 
-export { ApiError, AuthInterceptor, type CatalystAlbum, type CatalystAlbumDisplayMode, type CatalystAnnouncement, CatalystClient, type CatalystContest, type CatalystContestAddCollaboratorRequest, type CatalystContestAward, type CatalystContestCollaborator, type CatalystContestPolls, type CatalystContestRank, type CatalystContestRemoveCollaboratorRequest, type CatalystCreateAlbumRequest, type CatalystCreateContestRequest, type CatalystCreateFleetMedia, type CatalystCreateFleetRequest, type CatalystCreateFleetSticker, type CatalystCreateFleetText, type CatalystCreateSmartAlbumRequest, type CatalystCreateStatusRequest, type CatalystCustomReaction, type CatalystCustomReactionList, type CatalystCustomReactionStatus, type CatalystEditAlbumRequest, type CatalystEditContestRequest, type CatalystEditSmartAlbumRequest, type CatalystEditStatusRequest, CatalystEndpoint, CatalystError, type CatalystFleet, type CatalystFleetMedia, type CatalystFleetRing, type CatalystFleetSticker, type CatalystFleetText, type CatalystFleetViewer, type CatalystInsertToAlbumRequest, type CatalystMediaWithMetadata, type CatalystPrivacySettings, type CatalystPrivacySettingsRequest, type CatalystReaction, type CatalystReactions, type CatalystRelationshipRequest, type CatalystRelationships, type CatalystRemoveFromAlbumRequest, type CatalystSetContestAwardRequest, type CatalystSmartAlbum, type CatalystSmartAlbums, type CatalystStatus, type CatalystStatusPrivacy, type CatalystStatusWrapper, type CatalystStatuses, CatalystTS, type CatalystTSOptions, type CatalystUnsetContestAwardRequest, type CatalystUserCustomReaction, type CatalystUserVoteRights, EgeriaClient, EgeriaEndpoint, type EgeriaUpdateProfileRequest, type EgeriaUser, type EgeriaUserProfile, type EgeriaUserWrapper, type EgeriaUsers, type Endpoint, HttpClient, type HttpMethod, ISSUER_CATALYST_SYSTEM_MESSAGE, ISSUER_CATALYST_USER_MESSAGE, ISSUER_EGERIA_SYSTEM_MESSAGE, type Identity, LoggingInterceptor, type Media, MediaClient, type MediaDeleteRequest, type MediaDownloadRequest, MediaEndpoint, type MediaMetadata, type MediaUploadUrls, type Notification, type NotificationAdditionalContext, type NotificationGroup, type NotificationUnreadCount, type Notifications, OAuth, OAuthError, PKCE, PUBLIC_API_ENDPOINT, PUBLIC_AUTHORIZE_ENDPOINT, PUBLIC_GRAPHQL_ENDPOINT, type ProfileTag, type ProfileTagSuggestion, type ProfileTagUser, type ReportRequest, type RequestInterceptor, SteambirdClient, SteambirdEndpoint, type SupporterTier, type Token, type UpdateCustomReactionRequest, type UpdateProfileTagsRequest, UserAgentInterceptor };
+export { ApiError, AuthInterceptor, type CatalystAlbum, type CatalystAlbumBook, type CatalystAlbumBookQuality, type CatalystAlbumBookStatus, type CatalystAlbumBookTemplate, type CatalystAlbumBookTocType, type CatalystAlbumDisplayMode, type CatalystAlbumOrSmartAlbum, type CatalystAlbumOrSmartAlbums, type CatalystAlbumsWrapper, type CatalystAnnouncement, type CatalystAnnouncementsWrapper, type CatalystArchiveMonth, type CatalystArchiveMonths, CatalystClient, type CatalystContest, type CatalystContestRank, type CatalystContestState, type CatalystContestWrapper, type CatalystContestsWrapper, type CatalystCreateAlbumBookRequest, type CatalystCreateAlbumRequest, type CatalystCreateFleetMedia, type CatalystCreateFleetMediaPlacement, type CatalystCreateFleetRequest, type CatalystCreateFleetSticker, type CatalystCreateFleetText, type CatalystCreateSmartAlbumRequest, type CatalystCreateStatusRequest, type CatalystCustomReaction, type CatalystCustomReactionList, type CatalystCustomReactionStatus, type CatalystCustomReactionVisibility, type CatalystEditAlbumRequest, type CatalystEditSmartAlbumRequest, type CatalystEditStatusRequest, CatalystEndpoint, CatalystError, type CatalystFleet, type CatalystFleetMedia, type CatalystFleetRing, type CatalystFleetSticker, type CatalystFleetText, type CatalystFleetViewer, type CatalystFollowingOrFollowersList, type CatalystInsertOrRemoveStatusAlbumRequest, type CatalystInsertToAlbumRequest, type CatalystMediaWithMetadata, type CatalystMessage, type CatalystPrivacySettings, type CatalystPrivacySettingsRequest, type CatalystRandomStatusWrapper, type CatalystReaction, type CatalystReactionValue, type CatalystReactions, type CatalystRelationshipRequest, type CatalystRelationships, type CatalystRelationshipsCount, type CatalystRemoveFromAlbumRequest, type CatalystResult, type CatalystRichTrendingItem, type CatalystSmartAlbum, type CatalystSmartAlbums, type CatalystStatus, type CatalystStatusContest, type CatalystStatusPrivacy, type CatalystStatusV1Wrapper, type CatalystStatusV1_1, type CatalystStatusV1_1Wrapper, type CatalystStatusVisitor, type CatalystStatuses, type CatalystStatusesV1_1, CatalystTS, type CatalystTSOptions, type CatalystUserCustomReaction, type CatalystUserVoteRights, type CountInfo, EgeriaClient, EgeriaEndpoint, type EgeriaUpdateProfileRequest, type EgeriaUser, type EgeriaUserProfile, type EgeriaUserWrapper, type EgeriaUsers, type Endpoint, type EpicleseAuthor, type EpicleseAuthorWrapper, type EpicleseAuthorsResult, EpicleseClient, type EpicleseCreateAuthorRequest, type EpicleseCreateStatusMetadataReferenceRequest, type EpicleseCreateStatusMetadataTagRequest, type EpicleseCreateWorldRequest, EpicleseEndpoint, type EpiclesePlatform, type EpiclesePlatformWrapper, type EpiclesePlatformsWrapper, type EpicleseStatusMetadata, type EpicleseStatusMetadataReference, type EpicleseStatusMetadataTag, type EpicleseWorld, type EpicleseWorldWrapper, type EpicleseWorldsWrapper, FeatureFlagsClient, FeatureFlagsEndpoint, type FeatureFlagsResponse, HttpClient, type HttpMethod, ISSUER_CATALYST_SYSTEM_MESSAGE, ISSUER_CATALYST_USER_MESSAGE, ISSUER_EGERIA_SYSTEM_MESSAGE, type Identity, LoggingInterceptor, type Media, MediaClient, type MediaDeleteRequest, MediaEndpoint, type MediaMetadata, type MediaUploadUrls, type Notification, type NotificationAdditionalContext, type NotificationGroup, type NotificationUnreadCount, type Notifications, OAuth, OAuthError, PKCE, PUBLIC_API_ENDPOINT, PUBLIC_AUTHORIZE_ENDPOINT, PUBLIC_GRAPHQL_ENDPOINT, type PageInfo, type ProfileEmoji, type ProfileEmojiCustom, type ProfileEmojiCustomRequest, type ProfileEmojiRequest, type ProfileEmojiStandard, type ProfileEmojiStandardRequest, type ProfileTag, type ProfileTagSuggestion, type ProfileTagSuggestionsWrapper, type ProfileTagSummary, type ProfileTagUser, type ProfileTagUsersResult, type ProfileTagsWrapper, type ReportRequest, type RequestInterceptor, SteambirdClient, SteambirdEndpoint, type SupporterTier, type Token, type UpdateCustomReactionRequest, type UpdateProfileTagsRequest, UserAgentInterceptor };