@aurora-interactive/fankare-api-sdk 0.0.2 → 0.0.4

package/src/models/operations/get-message-history.ts

@@ -4,14 +4,34 @@
  */
 
 import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+import * as models from "../index.js";
 
 export type GetMessageHistoryRequest = {
   userId: number;
+  limit?: number | undefined;
+  /**
+   * Opaque cursor pointing to the last processed message ID/timestamp
+   */
+  cursor?: string | undefined;
+};
+
+/**
+ * Paginated history array of direct text messages
+ */
+export type GetMessageHistoryResponse = {
+  items?: Array<models.Message> | undefined;
+  nextCursor?: string | null | undefined;
 };
 
 /** @internal */
 export type GetMessageHistoryRequest$Outbound = {
   userId: number;
+  limit: number;
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -20,6 +40,8 @@ export const GetMessageHistoryRequest$outboundSchema: z.ZodMiniType<
   GetMessageHistoryRequest
 > = z.object({
   userId: z.int(),
+  limit: z._default(z.int(), 30),
+  cursor: z.optional(z.string()),
 });
 
 export function getMessageHistoryRequestToJSON(
@@ -29,3 +51,22 @@ export function getMessageHistoryRequestToJSON(
     GetMessageHistoryRequest$outboundSchema.parse(getMessageHistoryRequest),
   );
 }
+
+/** @internal */
+export const GetMessageHistoryResponse$inboundSchema: z.ZodMiniType<
+  GetMessageHistoryResponse,
+  unknown
+> = z.object({
+  items: types.optional(z.array(models.Message$inboundSchema)),
+  nextCursor: z.optional(z.nullable(types.string())),
+});
+
+export function getMessageHistoryResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetMessageHistoryResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetMessageHistoryResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetMessageHistoryResponse' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -3,17 +3,17 @@
  * @generated-id: 0d9ffaf774d2
  */
 
-export * from "./add-list-member.js";
-export * from "./create-list.js";
+export * from "./add-collection-member.js";
+export * from "./create-collection.js";
 export * from "./create-post.js";
+export * from "./get-collection-feed.js";
+export * from "./get-collection-members.js";
 export * from "./get-creator-posts.js";
 export * from "./get-feed.js";
-export * from "./get-list-feed.js";
-export * from "./get-list-members.js";
 export * from "./get-message-history.js";
 export * from "./get-user-profile.js";
 export * from "./login-user.js";
-export * from "./remove-list-member.js";
+export * from "./remove-collection-member.js";
 export * from "./search-users.js";
 export * from "./send-message.js";
 export * from "./subscribe-to-user.js";

package/src/models/operations/remove-collection-member.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 05d660fe0d9c
+ */
+
+import * as z from "zod/v4-mini";
+
+export type RemoveCollectionMemberRequest = {
+  collectionId: number;
+  userId: number;
+};
+
+/** @internal */
+export type RemoveCollectionMemberRequest$Outbound = {
+  collectionId: number;
+  userId: number;
+};
+
+/** @internal */
+export const RemoveCollectionMemberRequest$outboundSchema: z.ZodMiniType<
+  RemoveCollectionMemberRequest$Outbound,
+  RemoveCollectionMemberRequest
+> = z.object({
+  collectionId: z.int(),
+  userId: z.int(),
+});
+
+export function removeCollectionMemberRequestToJSON(
+  removeCollectionMemberRequest: RemoveCollectionMemberRequest,
+): string {
+  return JSON.stringify(
+    RemoveCollectionMemberRequest$outboundSchema.parse(
+      removeCollectionMemberRequest,
+    ),
+  );
+}

package/src/models/paginated-posts-response.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4d6d6852ae23
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import { Post, Post$inboundSchema } from "./post.js";
+
+export type PaginatedPostsResponse = {
+  items?: Array<Post> | undefined;
+  /**
+   * Provide this value to the next request's cursor query parameter to fetch the next block.
+   */
+  nextCursor?: string | null | undefined;
+};
+
+/** @internal */
+export const PaginatedPostsResponse$inboundSchema: z.ZodMiniType<
+  PaginatedPostsResponse,
+  unknown
+> = z.object({
+  items: types.optional(z.array(Post$inboundSchema)),
+  nextCursor: z.optional(z.nullable(types.string())),
+});
+
+export function paginatedPostsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PaginatedPostsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PaginatedPostsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaginatedPostsResponse' from JSON`,
+  );
+}

package/src/models/register-request.ts

@@ -7,15 +7,17 @@ import * as z from "zod/v4-mini";
 
 export type RegisterRequest = {
   username: string;
+  email: string;
   password: string;
-  displayName?: string | undefined;
+  displayName: string;
 };
 
 /** @internal */
 export type RegisterRequest$Outbound = {
   username: string;
+  email: string;
   password: string;
-  displayName?: string | undefined;
+  displayName: string;
 };
 
 /** @internal */
@@ -24,8 +26,9 @@ export const RegisterRequest$outboundSchema: z.ZodMiniType<
   RegisterRequest
 > = z.object({
   username: z.string(),
+  email: z.string(),
   password: z.string(),
-  displayName: z.optional(z.string()),
+  displayName: z.string(),
 });
 
 export function registerRequestToJSON(

package/src/models/user-profile.ts

@@ -12,7 +12,6 @@ import { User, User$inboundSchema } from "./user.js";
 
 export type UserProfile = {
   user?: User | undefined;
-  avatarUrl?: string | null | undefined;
   followersCount?: number | undefined;
   followingCount?: number | undefined;
 };
@@ -21,7 +20,6 @@ export type UserProfile = {
 export const UserProfile$inboundSchema: z.ZodMiniType<UserProfile, unknown> = z
   .object({
     user: types.optional(User$inboundSchema),
-    avatarUrl: z.optional(z.nullable(types.string())),
     followersCount: types.optional(types.number()),
     followingCount: types.optional(types.number()),
   });

package/src/models/user.ts

@@ -5,22 +5,68 @@
 
 import * as z from "zod/v4-mini";
 import { safeParse } from "../lib/schemas.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
+export const AccountStatus = {
+  Active: "ACTIVE",
+  Suspended: "SUSPENDED",
+  Deactivated: "DEACTIVATED",
+} as const;
+export type AccountStatus = OpenEnum<typeof AccountStatus>;
+
 export type User = {
   id?: number | undefined;
   username?: string | undefined;
+  email?: string | undefined;
   displayName?: string | undefined;
+  bio?: string | null | undefined;
+  /**
+   * Fully qualified URI mapping to the SeaweedFS avatar reference asset path
+   */
+  avatarUrl?: string | null | undefined;
+  /**
+   * Fully qualified URI mapping to the SeaweedFS profile header banner path
+   */
+  bannerUrl?: string | null | undefined;
+  /**
+   * Flags if this user account can build premium feeds and process media timelines
+   */
+  isCreator?: boolean | undefined;
+  /**
+   * System verified identity indicator badge validation toggle
+   */
+  isVerified?: boolean | undefined;
+  /**
+   * Monthly paywall gate pricing valuation tier for premium feed access
+   */
+  subscriptionPrice?: number | undefined;
+  accountStatus?: AccountStatus | undefined;
   createdAt?: Date | undefined;
 };
 
+/** @internal */
+export const AccountStatus$inboundSchema: z.ZodMiniType<
+  AccountStatus,
+  unknown
+> = openEnums.inboundSchema(AccountStatus);
+
 /** @internal */
 export const User$inboundSchema: z.ZodMiniType<User, unknown> = z.object({
   id: types.optional(types.number()),
   username: types.optional(types.string()),
+  email: types.optional(types.string()),
   displayName: types.optional(types.string()),
+  bio: z.optional(z.nullable(types.string())),
+  avatarUrl: z.optional(z.nullable(types.string())),
+  bannerUrl: z.optional(z.nullable(types.string())),
+  isCreator: types.optional(types.boolean()),
+  isVerified: types.optional(types.boolean()),
+  subscriptionPrice: types.optional(types.number()),
+  accountStatus: types.optional(AccountStatus$inboundSchema),
   createdAt: types.optional(types.date()),
 });
 

package/src/sdk/creator-timelines.ts

@@ -10,20 +10,19 @@ import { unwrapAsync } from "../types/fp.js";
 
 export class CreatorTimelines extends ClientSDK {
   /**
-   * Get a specific creator's timeline
-   *
-   * @remarks
-   * Retrieves individual posts uploaded strictly by the requested user account.
+   * Get a specific creator's timeline with pagination
    */
   async getCreatorPosts(
     userId: number,
     limit?: number | undefined,
+    cursor?: string | undefined,
     options?: RequestOptions,
-  ): Promise<Array<models.Post>> {
+  ): Promise<models.PaginatedPostsResponse> {
     return unwrapAsync(creatorTimelinesGetCreatorPosts(
       this,
       userId,
       limit,
+      cursor,
       options,
     ));
   }

package/src/sdk/custom-collections.ts

@@ -0,0 +1,88 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 26de8c8c4014
+ */
+
+import { customCollectionsAddCollectionMember } from "../funcs/custom-collections-add-collection-member.js";
+import { customCollectionsCreateCollection } from "../funcs/custom-collections-create-collection.js";
+import { customCollectionsGetCollectionMembers } from "../funcs/custom-collections-get-collection-members.js";
+import { customCollectionsGetCollections } from "../funcs/custom-collections-get-collections.js";
+import { customCollectionsRemoveCollectionMember } from "../funcs/custom-collections-remove-collection-member.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class CustomCollections extends ClientSDK {
+  /**
+   * Get all collections created by the user
+   */
+  async getCollections(
+    options?: RequestOptions,
+  ): Promise<Array<models.Collection>> {
+    return unwrapAsync(customCollectionsGetCollections(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Create a new custom grouping collection
+   */
+  async createCollection(
+    request: operations.CreateCollectionRequest,
+    options?: RequestOptions,
+  ): Promise<models.Collection> {
+    return unwrapAsync(customCollectionsCreateCollection(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get all members belonging to a custom collection
+   */
+  async getCollectionMembers(
+    collectionId: number,
+    options?: RequestOptions,
+  ): Promise<Array<models.User>> {
+    return unwrapAsync(customCollectionsGetCollectionMembers(
+      this,
+      collectionId,
+      options,
+    ));
+  }
+
+  /**
+   * Add a user to a custom collection
+   */
+  async addCollectionMember(
+    collectionId: number,
+    body: operations.AddCollectionMemberRequestBody,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(customCollectionsAddCollectionMember(
+      this,
+      collectionId,
+      body,
+      options,
+    ));
+  }
+
+  /**
+   * Remove a user from a custom collection
+   */
+  async removeCollectionMember(
+    collectionId: number,
+    userId: number,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(customCollectionsRemoveCollectionMember(
+      this,
+      collectionId,
+      userId,
+      options,
+    ));
+  }
+}

package/src/sdk/direct-messaging.ts

@@ -8,14 +8,12 @@ import { directMessagingGetMessageHistory } from "../funcs/direct-messaging-get-
 import { directMessagingSendMessage } from "../funcs/direct-messaging-send-message.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class DirectMessaging extends ClientSDK {
   /**
    * Fetch active DM threads
-   *
-   * @remarks
-   * Gets recent conversation summary records containing index context of opposing communication profiles.
    */
   async getConversations(
     options?: RequestOptions,
@@ -27,15 +25,19 @@ export class DirectMessaging extends ClientSDK {
   }
 
   /**
-   * Load message history with a specific creator
+   * Load message history with a specific user with pagination
    */
   async getMessageHistory(
     userId: number,
+    limit?: number | undefined,
+    cursor?: string | undefined,
     options?: RequestOptions,
-  ): Promise<Array<models.Message>> {
+  ): Promise<operations.GetMessageHistoryResponse> {
     return unwrapAsync(directMessagingGetMessageHistory(
       this,
       userId,
+      limit,
+      cursor,
       options,
     ));
   }

package/src/sdk/posts.ts

@@ -4,8 +4,8 @@
  */
 
 import { postsCreatePost } from "../funcs/posts-create-post.js";
+import { postsGetCollectionFeed } from "../funcs/posts-get-collection-feed.js";
 import { postsGetFeed } from "../funcs/posts-get-feed.js";
-import { postsGetListFeed } from "../funcs/posts-get-list-feed.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
@@ -13,16 +13,13 @@ import { unwrapAsync } from "../types/fp.js";
 
 export class Posts extends ClientSDK {
   /**
-   * Get the consolidated timeline feed
-   *
-   * @remarks
-   * Retrieves posts from users the current authenticated user is subscribed to.
+   * Get the consolidated timeline feed with pagination
    */
   async getFeed(
     limit?: number | undefined,
     cursor?: string | undefined,
     options?: RequestOptions,
-  ): Promise<operations.GetFeedResponse> {
+  ): Promise<models.PaginatedPostsResponse> {
     return unwrapAsync(postsGetFeed(
       this,
       limit,
@@ -33,9 +30,6 @@ export class Posts extends ClientSDK {
 
   /**
    * Create a post blueprint requesting batch upload slots
-   *
-   * @remarks
-   * Accepts a list of metadata parts for grids/carousels and responds with multiple presigned destination configurations mapped out of SeaweedFS routing rules.
    */
   async createPost(
     request: models.CreatePostRequest,
@@ -49,17 +43,19 @@ export class Posts extends ClientSDK {
   }
 
   /**
-   * Get a timeline filtered strictly by members of this list
+   * Get a timeline filtered strictly by members of this collection with pagination
    */
-  async getListFeed(
-    listId: number,
+  async getCollectionFeed(
+    collectionId: number,
     limit?: number | undefined,
+    cursor?: string | undefined,
     options?: RequestOptions,
-  ): Promise<Array<models.Post>> {
-    return unwrapAsync(postsGetListFeed(
+  ): Promise<models.PaginatedPostsResponse> {
+    return unwrapAsync(postsGetCollectionFeed(
       this,
-      listId,
+      collectionId,
       limit,
+      cursor,
       options,
     ));
   }

package/src/sdk/sdk.ts

@@ -6,7 +6,7 @@
 import { ClientSDK } from "../lib/sdks.js";
 import { Authentication } from "./authentication.js";
 import { CreatorTimelines } from "./creator-timelines.js";
-import { CustomLists } from "./custom-lists.js";
+import { CustomCollections } from "./custom-collections.js";
 import { DirectMessaging } from "./direct-messaging.js";
 import { Posts } from "./posts.js";
 import { Subscriptions } from "./subscriptions.js";
@@ -43,8 +43,8 @@ export class FankareSDK extends ClientSDK {
     return (this._directMessaging ??= new DirectMessaging(this._options));
   }
 
-  private _customLists?: CustomLists;
-  get customLists(): CustomLists {
-    return (this._customLists ??= new CustomLists(this._options));
+  private _customCollections?: CustomCollections;
+  get customCollections(): CustomCollections {
+    return (this._customCollections ??= new CustomCollections(this._options));
   }
 }

package/src/sdk/user-discovery.ts

@@ -13,9 +13,6 @@ import { unwrapAsync } from "../types/fp.js";
 export class UserDiscovery extends ClientSDK {
   /**
    * Search global user profiles
-   *
-   * @remarks
-   * Queries the global database for user profiles matching a search string.
    */
   async searchUsers(
     query: string,
@@ -30,9 +27,6 @@ export class UserDiscovery extends ClientSDK {
 
   /**
    * Retrieve user profile metadata
-   *
-   * @remarks
-   * Fetches a user's target profile metrics including counts and media references.
    */
   async getUserProfile(
     userId: number,
@@ -47,9 +41,6 @@ export class UserDiscovery extends ClientSDK {
 
   /**
    * Get subscriptions list
-   *
-   * @remarks
-   * Retrieves an array of all users the current caller is subscribed to for initializing active client button states.
    */
   async getFollowing(
     options?: RequestOptions,

package/src/models/operations/add-list-member.ts

@@ -1,59 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: d2fa5284fdc4
- */
-
-import * as z from "zod/v4-mini";
-
-export type AddListMemberRequestBody = {
-  userId: number;
-};
-
-export type AddListMemberRequest = {
-  listId: number;
-  body: AddListMemberRequestBody;
-};
-
-/** @internal */
-export type AddListMemberRequestBody$Outbound = {
-  userId: number;
-};
-
-/** @internal */
-export const AddListMemberRequestBody$outboundSchema: z.ZodMiniType<
-  AddListMemberRequestBody$Outbound,
-  AddListMemberRequestBody
-> = z.object({
-  userId: z.int(),
-});
-
-export function addListMemberRequestBodyToJSON(
-  addListMemberRequestBody: AddListMemberRequestBody,
-): string {
-  return JSON.stringify(
-    AddListMemberRequestBody$outboundSchema.parse(addListMemberRequestBody),
-  );
-}
-
-/** @internal */
-export type AddListMemberRequest$Outbound = {
-  listId: number;
-  body: AddListMemberRequestBody$Outbound;
-};
-
-/** @internal */
-export const AddListMemberRequest$outboundSchema: z.ZodMiniType<
-  AddListMemberRequest$Outbound,
-  AddListMemberRequest
-> = z.object({
-  listId: z.int(),
-  body: z.lazy(() => AddListMemberRequestBody$outboundSchema),
-});
-
-export function addListMemberRequestToJSON(
-  addListMemberRequest: AddListMemberRequest,
-): string {
-  return JSON.stringify(
-    AddListMemberRequest$outboundSchema.parse(addListMemberRequest),
-  );
-}

package/src/models/operations/create-list.ts

@@ -1,31 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: d66b3381784b
- */
-
-import * as z from "zod/v4-mini";
-
-export type CreateListRequest = {
-  listName: string;
-};
-
-/** @internal */
-export type CreateListRequest$Outbound = {
-  listName: string;
-};
-
-/** @internal */
-export const CreateListRequest$outboundSchema: z.ZodMiniType<
-  CreateListRequest$Outbound,
-  CreateListRequest
-> = z.object({
-  listName: z.string(),
-});
-
-export function createListRequestToJSON(
-  createListRequest: CreateListRequest,
-): string {
-  return JSON.stringify(
-    CreateListRequest$outboundSchema.parse(createListRequest),
-  );
-}

package/src/models/operations/get-list-feed.ts

@@ -1,34 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: a0ba779f152e
- */
-
-import * as z from "zod/v4-mini";
-
-export type GetListFeedRequest = {
-  listId: number;
-  limit?: number | undefined;
-};
-
-/** @internal */
-export type GetListFeedRequest$Outbound = {
-  listId: number;
-  limit: number;
-};
-
-/** @internal */
-export const GetListFeedRequest$outboundSchema: z.ZodMiniType<
-  GetListFeedRequest$Outbound,
-  GetListFeedRequest
-> = z.object({
-  listId: z.int(),
-  limit: z._default(z.int(), 20),
-});
-
-export function getListFeedRequestToJSON(
-  getListFeedRequest: GetListFeedRequest,
-): string {
-  return JSON.stringify(
-    GetListFeedRequest$outboundSchema.parse(getListFeedRequest),
-  );
-}