@aurora-interactive/fankare-api-sdk 0.0.5 → 0.1.1

package/src/models/update-profile-request.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 689ebe29e921
+ */
+
+import * as z from "zod/v4-mini";
+
+/**
+ * All fields are optional; only supplied fields are updated.
+ */
+export type UpdateProfileRequest = {
+  displayName?: string | undefined;
+  bio?: string | null | undefined;
+};
+
+/** @internal */
+export type UpdateProfileRequest$Outbound = {
+  displayName?: string | undefined;
+  bio?: string | null | undefined;
+};
+
+/** @internal */
+export const UpdateProfileRequest$outboundSchema: z.ZodMiniType<
+  UpdateProfileRequest$Outbound,
+  UpdateProfileRequest
+> = z.object({
+  displayName: z.optional(z.string()),
+  bio: z.optional(z.nullable(z.string())),
+});
+
+export function updateProfileRequestToJSON(
+  updateProfileRequest: UpdateProfileRequest,
+): string {
+  return JSON.stringify(
+    UpdateProfileRequest$outboundSchema.parse(updateProfileRequest),
+  );
+}

package/src/models/upload-slot.ts

@@ -0,0 +1,53 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e1f3fc29096e
+ */
+
+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";
+
+export type UploadSlot = {
+  /**
+   * ID of the post_assets row created for this slot.
+   */
+  assetId?: number | undefined;
+  /**
+   * Zero-based index matching the position in the original assets array.
+   */
+  sortOrder?: number | undefined;
+  /**
+   * Presigned HTTP PUT URL pointing directly at a SeaweedFS volume node. The client must PUT the raw binary file body with the Content-Type header matching the declared contentType. No additional form fields are required.
+   */
+  uploadUrl?: string | undefined;
+  /**
+   * The SeaweedFS object key pre-allocated for this asset (e.g. posts/42/0_a1b2c3.jpg). Stored in post_assets.media_key immediately; Celery uses this as the source path.
+   */
+  mediaKey?: string | undefined;
+  /**
+   * UTC datetime after which the presigned URL is no longer valid. Typically 15 minutes from issuance.
+   */
+  expiresAt?: Date | undefined;
+};
+
+/** @internal */
+export const UploadSlot$inboundSchema: z.ZodMiniType<UploadSlot, unknown> = z
+  .object({
+    assetId: types.optional(types.number()),
+    sortOrder: types.optional(types.number()),
+    uploadUrl: types.optional(types.string()),
+    mediaKey: types.optional(types.string()),
+    expiresAt: types.optional(types.date()),
+  });
+
+export function uploadSlotFromJSON(
+  jsonString: string,
+): SafeParseResult<UploadSlot, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => UploadSlot$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'UploadSlot' from JSON`,
+  );
+}

package/src/models/user.ts

@@ -40,6 +40,10 @@ export type User = {
    * System verified identity indicator badge validation toggle
    */
   isVerified?: boolean | undefined;
+  /**
+   * Indicates if the user is a curated/featured creator showcased on guest pages
+   */
+  isFeatured?: boolean | undefined;
   /**
    * Monthly paywall gate pricing valuation tier for premium feed access
    */
@@ -65,6 +69,7 @@ export const User$inboundSchema: z.ZodMiniType<User, unknown> = z.object({
   bannerUrl: z.optional(z.nullable(types.string())),
   isCreator: types.optional(types.boolean()),
   isVerified: types.optional(types.boolean()),
+  isFeatured: types.optional(types.boolean()),
   subscriptionPrice: types.optional(types.number()),
   accountStatus: types.optional(AccountStatus$inboundSchema),
   createdAt: types.optional(types.date()),

package/src/sdk/creators-discovery.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: fd5248f58055
+ */
+
+import { creatorsDiscoveryGetFeaturedCreators } from "../funcs/creators-discovery-get-featured-creators.js";
+import { creatorsDiscoveryGetTrendingCreators } from "../funcs/creators-discovery-get-trending-creators.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class CreatorsDiscovery extends ClientSDK {
+  /**
+   * Fetch a curated list of featured creators for the Guest Landing page
+   */
+  async getFeaturedCreators(
+    limit?: number | undefined,
+    options?: RequestOptions,
+  ): Promise<Array<models.User>> {
+    return unwrapAsync(creatorsDiscoveryGetFeaturedCreators(
+      this,
+      limit,
+      options,
+    ));
+  }
+
+  /**
+   * Fetch popular creators to discover in the sidebar
+   */
+  async getTrendingCreators(
+    limit?: number | undefined,
+    options?: RequestOptions,
+  ): Promise<Array<models.User>> {
+    return unwrapAsync(creatorsDiscoveryGetTrendingCreators(
+      this,
+      limit,
+      options,
+    ));
+  }
+}

package/src/sdk/internal.ts

@@ -0,0 +1,32 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 479f87bfe8ae
+ */
+
+import { internalAssetProcessingCallback } from "../funcs/internal-asset-processing-callback.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Internal extends ClientSDK {
+  /**
+   * [Internal] Celery worker callback to update the processing status of a single post asset
+   *
+   * @remarks
+   * This endpoint is called exclusively by the internal Python/Celery media processing service after a transcoding or image optimisation job completes or fails. It is not intended to be called by external clients. The endpoint MUST be protected by a shared-secret header (X-Internal-Token) validated against an environment variable. On a READY transition the worker also supplies the finalised media_key (the canonical SeaweedFS path of the processed output file). On FAILED the worker may optionally supply a human-readable error reason for observability logging.
+   */
+  async assetProcessingCallback(
+    postId: number,
+    assetId: number,
+    body: models.AssetProcessingCallbackRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(internalAssetProcessingCallback(
+      this,
+      postId,
+      assetId,
+      body,
+      options,
+    ));
+  }
+}

package/src/sdk/me.ts

@@ -0,0 +1,98 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: eeeab1031f91
+ */
+
+import { meConfirmAvatarUpload } from "../funcs/me-confirm-avatar-upload.js";
+import { meConfirmBannerUpload } from "../funcs/me-confirm-banner-upload.js";
+import { meGetMe } from "../funcs/me-get-me.js";
+import { meRequestAvatarUploadUrl } from "../funcs/me-request-avatar-upload-url.js";
+import { meRequestBannerUploadUrl } from "../funcs/me-request-banner-upload-url.js";
+import { meUpdateMe } from "../funcs/me-update-me.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Me extends ClientSDK {
+  /**
+   * Get the authenticated user's own profile
+   */
+  async getMe(
+    options?: RequestOptions,
+  ): Promise<models.User> {
+    return unwrapAsync(meGetMe(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Update the authenticated user's profile text fields
+   */
+  async updateMe(
+    request: models.UpdateProfileRequest,
+    options?: RequestOptions,
+  ): Promise<models.User> {
+    return unwrapAsync(meUpdateMe(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Request a presigned URL to upload or replace the authenticated user's avatar image
+   */
+  async requestAvatarUploadUrl(
+    request: models.ProfileMediaUploadRequest,
+    options?: RequestOptions,
+  ): Promise<models.ProfileMediaUploadResponse> {
+    return unwrapAsync(meRequestAvatarUploadUrl(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Confirm a completed avatar upload and atomically update the user record
+   */
+  async confirmAvatarUpload(
+    request: models.ProfileMediaConfirmRequest,
+    options?: RequestOptions,
+  ): Promise<models.User> {
+    return unwrapAsync(meConfirmAvatarUpload(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Request a presigned URL to upload or replace the authenticated user's profile banner image
+   */
+  async requestBannerUploadUrl(
+    request: models.ProfileMediaUploadRequest,
+    options?: RequestOptions,
+  ): Promise<models.ProfileMediaUploadResponse> {
+    return unwrapAsync(meRequestBannerUploadUrl(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Confirm a completed banner upload and atomically update the user record
+   */
+  async confirmBannerUpload(
+    request: models.ProfileMediaConfirmRequest,
+    options?: RequestOptions,
+  ): Promise<models.User> {
+    return unwrapAsync(meConfirmBannerUpload(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/notifications.ts

@@ -0,0 +1,55 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3d0b195b882f
+ */
+
+import { notificationsGetNotifications } from "../funcs/notifications-get-notifications.js";
+import { notificationsGetUnreadNotificationCount } from "../funcs/notifications-get-unread-notification-count.js";
+import { notificationsMarkNotificationsAsRead } from "../funcs/notifications-mark-notifications-as-read.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Notifications extends ClientSDK {
+  /**
+   * Fetch a paginated feed of notifications for the authenticated user
+   */
+  async getNotifications(
+    limit?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.PaginatedNotificationsResponse> {
+    return unwrapAsync(notificationsGetNotifications(
+      this,
+      limit,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Fetch the count of unread notifications for the authenticated user
+   */
+  async getUnreadNotificationCount(
+    options?: RequestOptions,
+  ): Promise<models.UnreadCountResponse> {
+    return unwrapAsync(notificationsGetUnreadNotificationCount(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Mark notifications as read
+   */
+  async markNotificationsAsRead(
+    request: models.MarkNotificationsReadRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(notificationsMarkNotificationsAsRead(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/posts.ts

@@ -3,12 +3,20 @@
  * @generated-id: 6787631da7f6
  */
 
+import { postsCreateComment } from "../funcs/posts-create-comment.js";
 import { postsCreatePost } from "../funcs/posts-create-post.js";
+import { postsDeleteComment } from "../funcs/posts-delete-comment.js";
+import { postsDeletePost } from "../funcs/posts-delete-post.js";
 import { postsGetCollectionFeed } from "../funcs/posts-get-collection-feed.js";
 import { postsGetFeed } from "../funcs/posts-get-feed.js";
+import { postsGetPostComments } from "../funcs/posts-get-post-comments.js";
+import { postsGetPostLikes } from "../funcs/posts-get-post-likes.js";
+import { postsGetPost } from "../funcs/posts-get-post.js";
+import { postsLikePost } from "../funcs/posts-like-post.js";
+import { postsUnlikePost } from "../funcs/posts-unlike-post.js";
+import { postsUpdatePost } from "../funcs/posts-update-post.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 Posts extends ClientSDK {
@@ -29,12 +37,15 @@ export class Posts extends ClientSDK {
   }
 
   /**
-   * Create a post blueprint requesting batch upload slots
+   * Initiate a new post: reserve asset slots and receive presigned upload URLs
+   *
+   * @remarks
+   * Creates a post record in DRAFT status and reserves one upload slot per declared asset, returning a presigned PUT URL for each. The client uploads each file directly to SeaweedFS using the provided URL. After all uploads are complete the client calls PATCH /posts/{postId} to publish the post. The post is not visible in any feed until it reaches the PUBLISHED status.
    */
   async createPost(
     request: models.CreatePostRequest,
     options?: RequestOptions,
-  ): Promise<operations.CreatePostResponse> {
+  ): Promise<models.CreatePostResponse> {
     return unwrapAsync(postsCreatePost(
       this,
       request,
@@ -42,6 +53,149 @@ export class Posts extends ClientSDK {
     ));
   }
 
+  /**
+   * Fetch a single post by ID, including all asset statuses
+   */
+  async getPost(
+    postId: number,
+    options?: RequestOptions,
+  ): Promise<models.Post> {
+    return unwrapAsync(postsGetPost(
+      this,
+      postId,
+      options,
+    ));
+  }
+
+  /**
+   * Publish or update a post
+   *
+   * @remarks
+   * Used to publish a DRAFT post once all asset uploads are complete, or to update the caption of an already-published post. Setting status to PUBLISHED triggers a server-side check that all required assets have been received by the object store before making the post visible in feeds. A post with assets still in PROCESSING state cannot be published.
+   */
+  async updatePost(
+    postId: number,
+    body: models.UpdatePostRequest,
+    options?: RequestOptions,
+  ): Promise<models.Post> {
+    return unwrapAsync(postsUpdatePost(
+      this,
+      postId,
+      body,
+      options,
+    ));
+  }
+
+  /**
+   * Delete a post and cascade-delete all associated assets from object storage
+   */
+  async deletePost(
+    postId: number,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(postsDeletePost(
+      this,
+      postId,
+      options,
+    ));
+  }
+
+  /**
+   * Fetch the list of users who liked a post
+   */
+  async getPostLikes(
+    postId: number,
+    limit?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.PaginatedLikesResponse> {
+    return unwrapAsync(postsGetPostLikes(
+      this,
+      postId,
+      limit,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Like a post
+   */
+  async likePost(
+    postId: number,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(postsLikePost(
+      this,
+      postId,
+      options,
+    ));
+  }
+
+  /**
+   * Unlike a post
+   */
+  async unlikePost(
+    postId: number,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(postsUnlikePost(
+      this,
+      postId,
+      options,
+    ));
+  }
+
+  /**
+   * Fetch paginated comments for a post
+   */
+  async getPostComments(
+    postId: number,
+    limit?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.PaginatedCommentsResponse> {
+    return unwrapAsync(postsGetPostComments(
+      this,
+      postId,
+      limit,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Add a comment to a post
+   */
+  async createComment(
+    postId: number,
+    body: models.CreateCommentRequest,
+    options?: RequestOptions,
+  ): Promise<models.Comment> {
+    return unwrapAsync(postsCreateComment(
+      this,
+      postId,
+      body,
+      options,
+    ));
+  }
+
+  /**
+   * Delete a comment from a post
+   */
+  async deleteComment(
+    postId: number,
+    commentId: number,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(postsDeleteComment(
+      this,
+      postId,
+      commentId,
+      options,
+    ));
+  }
+
   /**
    * Get a timeline filtered strictly by members of this collection with pagination
    */

package/src/sdk/sdk.ts

@@ -6,8 +6,12 @@
 import { ClientSDK } from "../lib/sdks.js";
 import { Authentication } from "./authentication.js";
 import { CreatorTimelines } from "./creator-timelines.js";
+import { CreatorsDiscovery } from "./creators-discovery.js";
 import { CustomCollections } from "./custom-collections.js";
 import { DirectMessaging } from "./direct-messaging.js";
+import { Internal } from "./internal.js";
+import { Me } from "./me.js";
+import { Notifications } from "./notifications.js";
 import { Posts } from "./posts.js";
 import { Subscriptions } from "./subscriptions.js";
 import { UserDiscovery } from "./user-discovery.js";
@@ -18,6 +22,11 @@ export class FankareSDK extends ClientSDK {
     return (this._authentication ??= new Authentication(this._options));
   }
 
+  private _me?: Me;
+  get me(): Me {
+    return (this._me ??= new Me(this._options));
+  }
+
   private _userDiscovery?: UserDiscovery;
   get userDiscovery(): UserDiscovery {
     return (this._userDiscovery ??= new UserDiscovery(this._options));
@@ -38,6 +47,11 @@ export class FankareSDK extends ClientSDK {
     return (this._posts ??= new Posts(this._options));
   }
 
+  private _internal?: Internal;
+  get internal(): Internal {
+    return (this._internal ??= new Internal(this._options));
+  }
+
   private _directMessaging?: DirectMessaging;
   get directMessaging(): DirectMessaging {
     return (this._directMessaging ??= new DirectMessaging(this._options));
@@ -47,4 +61,14 @@ export class FankareSDK extends ClientSDK {
   get customCollections(): CustomCollections {
     return (this._customCollections ??= new CustomCollections(this._options));
   }
+
+  private _notifications?: Notifications;
+  get notifications(): Notifications {
+    return (this._notifications ??= new Notifications(this._options));
+  }
+
+  private _creatorsDiscovery?: CreatorsDiscovery;
+  get creatorsDiscovery(): CreatorsDiscovery {
+    return (this._creatorsDiscovery ??= new CreatorsDiscovery(this._options));
+  }
 }

package/src/sdk/user-discovery.ts

@@ -3,7 +3,11 @@
  * @generated-id: 7746ccedcc95
  */
 
+import { userDiscoveryGetFollowerCount } from "../funcs/user-discovery-get-follower-count.js";
+import { userDiscoveryGetFollowers } from "../funcs/user-discovery-get-followers.js";
 import { userDiscoveryGetFollowing } from "../funcs/user-discovery-get-following.js";
+import { userDiscoveryGetUserFollowerCount } from "../funcs/user-discovery-get-user-follower-count.js";
+import { userDiscoveryGetUserFollowers } from "../funcs/user-discovery-get-user-followers.js";
 import { userDiscoveryGetUserProfile } from "../funcs/user-discovery-get-user-profile.js";
 import { userDiscoverySearchUsers } from "../funcs/user-discovery-search-users.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
@@ -50,4 +54,64 @@ export class UserDiscovery extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Fetch the authenticated user's paginated list of followers
+   */
+  async getFollowers(
+    limit?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.PaginatedFollowersResponse> {
+    return unwrapAsync(userDiscoveryGetFollowers(
+      this,
+      limit,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Fetch the authenticated user's follower count
+   */
+  async getFollowerCount(
+    options?: RequestOptions,
+  ): Promise<models.FollowerCountResponse> {
+    return unwrapAsync(userDiscoveryGetFollowerCount(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Fetch a specific user's paginated list of followers
+   */
+  async getUserFollowers(
+    userId: number,
+    limit?: number | undefined,
+    cursor?: string | undefined,
+    options?: RequestOptions,
+  ): Promise<models.PaginatedFollowersResponse> {
+    return unwrapAsync(userDiscoveryGetUserFollowers(
+      this,
+      userId,
+      limit,
+      cursor,
+      options,
+    ));
+  }
+
+  /**
+   * Fetch a specific user's follower count
+   */
+  async getUserFollowerCount(
+    userId: number,
+    options?: RequestOptions,
+  ): Promise<models.FollowerCountResponse> {
+    return unwrapAsync(userDiscoveryGetUserFollowerCount(
+      this,
+      userId,
+      options,
+    ));
+  }
 }