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

package/src/funcs/posts-get-feed.ts

@@ -23,15 +23,13 @@ import {
 } from "../models/errors/http-client-errors.js";
 import { ResponseValidationError } from "../models/errors/response-validation-error.js";
 import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
+import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Get the consolidated timeline feed
- *
- * @remarks
- * Retrieves posts from users the current authenticated user is subscribed to.
+ * Get the consolidated timeline feed with pagination
  */
 export function postsGetFeed(
   client: FankareSDKCore,
@@ -40,7 +38,7 @@ export function postsGetFeed(
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    operations.GetFeedResponse,
+    models.PaginatedPostsResponse,
     | FankareSDKError
     | ResponseValidationError
     | ConnectionError
@@ -67,7 +65,7 @@ async function $do(
 ): Promise<
   [
     Result<
-      operations.GetFeedResponse,
+      models.PaginatedPostsResponse,
       | FankareSDKError
       | ResponseValidationError
       | ConnectionError
@@ -156,7 +154,7 @@ async function $do(
   const response = doResult.value;
 
   const [result] = await M.match<
-    operations.GetFeedResponse,
+    models.PaginatedPostsResponse,
     | FankareSDKError
     | ResponseValidationError
     | ConnectionError
@@ -166,7 +164,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, operations.GetFeedResponse$inboundSchema),
+    M.json(200, models.PaginatedPostsResponse$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
   )(response, req);

package/src/funcs/user-discovery-get-following.ts

@@ -27,9 +27,6 @@ import { Result } from "../types/fp.js";
 
 /**
  * Get subscriptions list
- *
- * @remarks
- * Retrieves an array of all users the current caller is subscribed to for initializing active client button states.
  */
 export function userDiscoveryGetFollowing(
   client: FankareSDKCore,

package/src/funcs/user-discovery-get-user-profile.ts

@@ -30,9 +30,6 @@ import { Result } from "../types/fp.js";
 
 /**
  * Retrieve user profile metadata
- *
- * @remarks
- * Fetches a user's target profile metrics including counts and media references.
  */
 export function userDiscoveryGetUserProfile(
   client: FankareSDKCore,

package/src/funcs/user-discovery-search-users.ts

@@ -30,9 +30,6 @@ import { Result } from "../types/fp.js";
 
 /**
  * Search global user profiles
- *
- * @remarks
- * Queries the global database for user profiles matching a search string.
  */
 export function userDiscoverySearchUsers(
   client: FankareSDKCore,

package/src/lib/config.ts

@@ -62,7 +62,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "0.0.2",
+  sdkVersion: "0.0.3",
   genVersion: "2.911.0",
-  userAgent: "speakeasy-sdk/typescript 0.0.2 2.911.0 1.0.0 openapi",
+  userAgent: "speakeasy-sdk/typescript 0.0.3 2.911.0 1.0.0 openapi",
 } as const;

package/src/models/{custom-list.ts → collection.ts}

@@ -1,6 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: 0a4b6dee450f
+ * @generated-id: 9bda8d9a0042
  */
 
 import * as z from "zod/v4-mini";
@@ -9,26 +9,26 @@ import { Result as SafeParseResult } from "../types/fp.js";
 import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
-export type CustomList = {
+export type Collection = {
   id?: number | undefined;
   ownerId?: number | undefined;
   listName?: string | undefined;
 };
 
 /** @internal */
-export const CustomList$inboundSchema: z.ZodMiniType<CustomList, unknown> = z
+export const Collection$inboundSchema: z.ZodMiniType<Collection, unknown> = z
   .object({
     id: types.optional(types.number()),
     ownerId: types.optional(types.number()),
     listName: types.optional(types.string()),
   });
 
-export function customListFromJSON(
+export function collectionFromJSON(
   jsonString: string,
-): SafeParseResult<CustomList, SDKValidationError> {
+): SafeParseResult<Collection, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => CustomList$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'CustomList' from JSON`,
+    (x) => Collection$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Collection' from JSON`,
   );
 }

package/src/models/conversation.ts

@@ -12,9 +12,6 @@ import { Message, Message$inboundSchema } from "./message.js";
 import { User, User$inboundSchema } from "./user.js";
 
 export type Conversation = {
-  /**
-   * Computed target thread pairing hash identity string
-   */
   id?: string | undefined;
   recipient?: User | undefined;
   lastMessage?: Message | undefined;

package/src/models/index.ts

@@ -3,12 +3,13 @@
  * @generated-id: f93644b0f37e
  */
 
+export * from "./collection.js";
 export * from "./conversation.js";
 export * from "./create-post-request.js";
-export * from "./custom-list.js";
 export * from "./login-request.js";
 export * from "./media-asset.js";
 export * from "./message.js";
+export * from "./paginated-posts-response.js";
 export * from "./post.js";
 export * from "./register-request.js";
 export * from "./security.js";

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

@@ -0,0 +1,61 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ea82695590d7
+ */
+
+import * as z from "zod/v4-mini";
+
+export type AddCollectionMemberRequestBody = {
+  userId: number;
+};
+
+export type AddCollectionMemberRequest = {
+  collectionId: number;
+  body: AddCollectionMemberRequestBody;
+};
+
+/** @internal */
+export type AddCollectionMemberRequestBody$Outbound = {
+  userId: number;
+};
+
+/** @internal */
+export const AddCollectionMemberRequestBody$outboundSchema: z.ZodMiniType<
+  AddCollectionMemberRequestBody$Outbound,
+  AddCollectionMemberRequestBody
+> = z.object({
+  userId: z.int(),
+});
+
+export function addCollectionMemberRequestBodyToJSON(
+  addCollectionMemberRequestBody: AddCollectionMemberRequestBody,
+): string {
+  return JSON.stringify(
+    AddCollectionMemberRequestBody$outboundSchema.parse(
+      addCollectionMemberRequestBody,
+    ),
+  );
+}
+
+/** @internal */
+export type AddCollectionMemberRequest$Outbound = {
+  collectionId: number;
+  body: AddCollectionMemberRequestBody$Outbound;
+};
+
+/** @internal */
+export const AddCollectionMemberRequest$outboundSchema: z.ZodMiniType<
+  AddCollectionMemberRequest$Outbound,
+  AddCollectionMemberRequest
+> = z.object({
+  collectionId: z.int(),
+  body: z.lazy(() => AddCollectionMemberRequestBody$outboundSchema),
+});
+
+export function addCollectionMemberRequestToJSON(
+  addCollectionMemberRequest: AddCollectionMemberRequest,
+): string {
+  return JSON.stringify(
+    AddCollectionMemberRequest$outboundSchema.parse(addCollectionMemberRequest),
+  );
+}

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

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

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

@@ -18,7 +18,7 @@ export type UploadSlot = {
 };
 
 /**
- * Post processing metadata accepted. Collection upload instructions map generated.
+ * Post metadata accepted. Collection upload instructions map generated.
  */
 export type CreatePostResponse = {
   postId?: number | undefined;

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

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1f1776a98715
+ */
+
+import * as z from "zod/v4-mini";
+
+export type GetCollectionFeedRequest = {
+  collectionId: number;
+  limit?: number | undefined;
+  /**
+   * Opaque cursor mapping to timestamp index values for timeline layout pagination
+   */
+  cursor?: string | undefined;
+};
+
+/** @internal */
+export type GetCollectionFeedRequest$Outbound = {
+  collectionId: number;
+  limit: number;
+  cursor?: string | undefined;
+};
+
+/** @internal */
+export const GetCollectionFeedRequest$outboundSchema: z.ZodMiniType<
+  GetCollectionFeedRequest$Outbound,
+  GetCollectionFeedRequest
+> = z.object({
+  collectionId: z.int(),
+  limit: z._default(z.int(), 20),
+  cursor: z.optional(z.string()),
+});
+
+export function getCollectionFeedRequestToJSON(
+  getCollectionFeedRequest: GetCollectionFeedRequest,
+): string {
+  return JSON.stringify(
+    GetCollectionFeedRequest$outboundSchema.parse(getCollectionFeedRequest),
+  );
+}

package/src/models/operations/get-collection-members.ts

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

package/src/models/operations/get-creator-posts.ts

@@ -8,12 +8,17 @@ import * as z from "zod/v4-mini";
 export type GetCreatorPostsRequest = {
   userId: number;
   limit?: number | undefined;
+  /**
+   * Opaque cursor pointing to the last post timestamp/ID for pagination
+   */
+  cursor?: string | undefined;
 };
 
 /** @internal */
 export type GetCreatorPostsRequest$Outbound = {
   userId: number;
   limit: number;
+  cursor?: string | undefined;
 };
 
 /** @internal */
@@ -23,6 +28,7 @@ export const GetCreatorPostsRequest$outboundSchema: z.ZodMiniType<
 > = z.object({
   userId: z.int(),
   limit: z._default(z.int(), 20),
+  cursor: z.optional(z.string()),
 });
 
 export function getCreatorPostsRequestToJSON(

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

@@ -4,25 +4,15 @@
  */
 
 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 GetFeedRequest = {
   limit?: number | undefined;
+  /**
+   * Opaque cursor pointing to the last item timestamp for pagination
+   */
   cursor?: string | undefined;
 };
 
-/**
- * A list of feed posts
- */
-export type GetFeedResponse = {
-  items?: Array<models.Post> | undefined;
-  nextCursor?: string | null | undefined;
-};
-
 /** @internal */
 export type GetFeedRequest$Outbound = {
   limit: number;
@@ -41,22 +31,3 @@ export const GetFeedRequest$outboundSchema: z.ZodMiniType<
 export function getFeedRequestToJSON(getFeedRequest: GetFeedRequest): string {
   return JSON.stringify(GetFeedRequest$outboundSchema.parse(getFeedRequest));
 }
-
-/** @internal */
-export const GetFeedResponse$inboundSchema: z.ZodMiniType<
-  GetFeedResponse,
-  unknown
-> = z.object({
-  items: types.optional(z.array(models.Post$inboundSchema)),
-  nextCursor: z.optional(z.nullable(types.string())),
-});
-
-export function getFeedResponseFromJSON(
-  jsonString: string,
-): SafeParseResult<GetFeedResponse, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => GetFeedResponse$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'GetFeedResponse' from JSON`,
-  );
-}

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/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,
     ));
   }