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

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

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ca5a5edf4af7
+ */
+
+import * as z from "zod/v4-mini";
+import * as models from "../index.js";
+
+export type UpdatePostRequest = {
+  postId: number;
+  body: models.UpdatePostRequest;
+};
+
+/** @internal */
+export type UpdatePostRequest$Outbound = {
+  postId: number;
+  body: models.UpdatePostRequest$Outbound;
+};
+
+/** @internal */
+export const UpdatePostRequest$outboundSchema: z.ZodMiniType<
+  UpdatePostRequest$Outbound,
+  UpdatePostRequest
+> = z.object({
+  postId: z.int(),
+  body: models.UpdatePostRequest$outboundSchema,
+});
+
+export function updatePostRequestToJSON(
+  updatePostRequest: UpdatePostRequest,
+): string {
+  return JSON.stringify(
+    UpdatePostRequest$outboundSchema.parse(updatePostRequest),
+  );
+}

package/src/models/post.ts

@@ -5,26 +5,51 @@
 
 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";
 import { MediaAsset, MediaAsset$inboundSchema } from "./media-asset.js";
 
+/**
+ * DRAFT posts are only visible to the owning creator. PUBLISHED posts appear in subscriber feeds.
+ */
+export const PostStatus = {
+  Draft: "DRAFT",
+  Published: "PUBLISHED",
+} as const;
+/**
+ * DRAFT posts are only visible to the owning creator. PUBLISHED posts appear in subscriber feeds.
+ */
+export type PostStatus = OpenEnum<typeof PostStatus>;
+
 export type Post = {
   id?: number | undefined;
   userId?: number | undefined;
-  caption?: string | undefined;
+  caption?: string | null | undefined;
+  /**
+   * DRAFT posts are only visible to the owning creator. PUBLISHED posts appear in subscriber feeds.
+   */
+  status?: PostStatus | undefined;
   assets?: Array<MediaAsset> | undefined;
   createdAt?: Date | undefined;
+  updatedAt?: Date | undefined;
 };
 
+/** @internal */
+export const PostStatus$inboundSchema: z.ZodMiniType<PostStatus, unknown> =
+  openEnums.inboundSchema(PostStatus);
+
 /** @internal */
 export const Post$inboundSchema: z.ZodMiniType<Post, unknown> = z.object({
   id: types.optional(types.number()),
   userId: types.optional(types.number()),
-  caption: types.optional(types.string()),
+  caption: z.optional(z.nullable(types.string())),
+  status: types.optional(PostStatus$inboundSchema),
   assets: types.optional(z.array(MediaAsset$inboundSchema)),
   createdAt: types.optional(types.date()),
+  updatedAt: types.optional(types.date()),
 });
 
 export function postFromJSON(

package/src/models/profile-media-confirm-request.ts

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 798bece0ede8
+ */
+
+import * as z from "zod/v4-mini";
+
+export type ProfileMediaConfirmRequest = {
+  /**
+   * The mediaKey value returned by the corresponding upload-url response. The gateway verifies a HMAC signature embedded in the key to prevent clients from supplying arbitrary paths.
+   */
+  mediaKey: string;
+};
+
+/** @internal */
+export type ProfileMediaConfirmRequest$Outbound = {
+  mediaKey: string;
+};
+
+/** @internal */
+export const ProfileMediaConfirmRequest$outboundSchema: z.ZodMiniType<
+  ProfileMediaConfirmRequest$Outbound,
+  ProfileMediaConfirmRequest
+> = z.object({
+  mediaKey: z.string(),
+});
+
+export function profileMediaConfirmRequestToJSON(
+  profileMediaConfirmRequest: ProfileMediaConfirmRequest,
+): string {
+  return JSON.stringify(
+    ProfileMediaConfirmRequest$outboundSchema.parse(profileMediaConfirmRequest),
+  );
+}

package/src/models/profile-media-upload-request.ts

@@ -0,0 +1,55 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a4c6edf5ee58
+ */
+
+import * as z from "zod/v4-mini";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * MIME type of the file to be uploaded. Must be an accepted image type.
+ */
+export const ProfileMediaUploadRequestContentType = {
+  ImageJpeg: "image/jpeg",
+  ImagePng: "image/png",
+  ImageWebp: "image/webp",
+} as const;
+/**
+ * MIME type of the file to be uploaded. Must be an accepted image type.
+ */
+export type ProfileMediaUploadRequestContentType = ClosedEnum<
+  typeof ProfileMediaUploadRequestContentType
+>;
+
+export type ProfileMediaUploadRequest = {
+  /**
+   * MIME type of the file to be uploaded. Must be an accepted image type.
+   */
+  contentType: ProfileMediaUploadRequestContentType;
+};
+
+/** @internal */
+export const ProfileMediaUploadRequestContentType$outboundSchema: z.ZodMiniEnum<
+  typeof ProfileMediaUploadRequestContentType
+> = z.enum(ProfileMediaUploadRequestContentType);
+
+/** @internal */
+export type ProfileMediaUploadRequest$Outbound = {
+  contentType: string;
+};
+
+/** @internal */
+export const ProfileMediaUploadRequest$outboundSchema: z.ZodMiniType<
+  ProfileMediaUploadRequest$Outbound,
+  ProfileMediaUploadRequest
+> = z.object({
+  contentType: ProfileMediaUploadRequestContentType$outboundSchema,
+});
+
+export function profileMediaUploadRequestToJSON(
+  profileMediaUploadRequest: ProfileMediaUploadRequest,
+): string {
+  return JSON.stringify(
+    ProfileMediaUploadRequest$outboundSchema.parse(profileMediaUploadRequest),
+  );
+}

package/src/models/profile-media-upload-response.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1829b849d292
+ */
+
+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 ProfileMediaUploadResponse = {
+  /**
+   * Presigned HTTP PUT URL targeting the SeaweedFS volume. The client must issue a single PUT request with the binary file body and the matching Content-Type header. The URL is valid for the duration indicated by expiresInSeconds.
+   */
+  uploadUrl?: string | undefined;
+  /**
+   * The canonical SeaweedFS object key that will be persisted to the user record upon confirm. The client does not need to parse or store this value; it is echoed back in the confirm request body.
+   */
+  mediaKey?: string | undefined;
+  /**
+   * Number of seconds from now until the presigned URL expires.
+   */
+  expiresInSeconds?: number | undefined;
+};
+
+/** @internal */
+export const ProfileMediaUploadResponse$inboundSchema: z.ZodMiniType<
+  ProfileMediaUploadResponse,
+  unknown
+> = z.object({
+  uploadUrl: types.optional(types.string()),
+  mediaKey: types.optional(types.string()),
+  expiresInSeconds: types.optional(types.number()),
+});
+
+export function profileMediaUploadResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<ProfileMediaUploadResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ProfileMediaUploadResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ProfileMediaUploadResponse' from JSON`,
+  );
+}

package/src/models/register-request.ts

@@ -10,6 +10,7 @@ export type RegisterRequest = {
   email: string;
   password: string;
   displayName: string;
+  bio?: string | null | undefined;
 };
 
 /** @internal */
@@ -18,6 +19,7 @@ export type RegisterRequest$Outbound = {
   email: string;
   password: string;
   displayName: string;
+  bio?: string | null | undefined;
 };
 
 /** @internal */
@@ -29,6 +31,7 @@ export const RegisterRequest$outboundSchema: z.ZodMiniType<
   email: z.string(),
   password: z.string(),
   displayName: z.string(),
+  bio: z.optional(z.nullable(z.string())),
 });
 
 export function registerRequestToJSON(

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

@@ -0,0 +1,56 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 718707107a86
+ */
+
+import * as z from "zod/v4-mini";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Set to PUBLISHED to make the post visible to subscribers. The server validates that all asset slots are in READY status before allowing the transition. Cannot be used to revert a published post to DRAFT.
+ */
+export const UpdatePostRequestStatus = {
+  Published: "PUBLISHED",
+} as const;
+/**
+ * Set to PUBLISHED to make the post visible to subscribers. The server validates that all asset slots are in READY status before allowing the transition. Cannot be used to revert a published post to DRAFT.
+ */
+export type UpdatePostRequestStatus = ClosedEnum<
+  typeof UpdatePostRequestStatus
+>;
+
+export type UpdatePostRequest = {
+  caption?: string | null | undefined;
+  /**
+   * Set to PUBLISHED to make the post visible to subscribers. The server validates that all asset slots are in READY status before allowing the transition. Cannot be used to revert a published post to DRAFT.
+   */
+  status?: UpdatePostRequestStatus | undefined;
+};
+
+/** @internal */
+export const UpdatePostRequestStatus$outboundSchema: z.ZodMiniEnum<
+  typeof UpdatePostRequestStatus
+> = z.enum(UpdatePostRequestStatus);
+
+/** @internal */
+export type UpdatePostRequest$Outbound = {
+  caption?: string | null | undefined;
+  status?: string | undefined;
+};
+
+/** @internal */
+export const UpdatePostRequest$outboundSchema: z.ZodMiniType<
+  UpdatePostRequest$Outbound,
+  UpdatePostRequest
+> = z.object({
+  caption: z.optional(z.nullable(z.string())),
+  status: z.optional(UpdatePostRequestStatus$outboundSchema),
+});
+
+export function updatePostRequestToJSON(
+  updatePostRequest: UpdatePostRequest,
+): string {
+  return JSON.stringify(
+    UpdatePostRequest$outboundSchema.parse(updatePostRequest),
+  );
+}

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/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/posts.ts

@@ -4,11 +4,13 @@
  */
 
 import { postsCreatePost } from "../funcs/posts-create-post.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 { postsGetPost } from "../funcs/posts-get-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 +31,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 +47,53 @@ 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,
+    ));
+  }
+
   /**
    * Get a timeline filtered strictly by members of this collection with pagination
    */

package/src/sdk/sdk.ts

@@ -8,6 +8,8 @@ import { Authentication } from "./authentication.js";
 import { CreatorTimelines } from "./creator-timelines.js";
 import { CustomCollections } from "./custom-collections.js";
 import { DirectMessaging } from "./direct-messaging.js";
+import { Internal } from "./internal.js";
+import { Me } from "./me.js";
 import { Posts } from "./posts.js";
 import { Subscriptions } from "./subscriptions.js";
 import { UserDiscovery } from "./user-discovery.js";
@@ -18,6 +20,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 +45,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));