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

package/src/models/media-asset.ts

@@ -17,18 +17,24 @@ export const MediaAssetMediaType = {
 } as const;
 export type MediaAssetMediaType = OpenEnum<typeof MediaAssetMediaType>;
 
-export const Status = {
+export const MediaAssetStatus = {
   Processing: "PROCESSING",
   Ready: "READY",
   Failed: "FAILED",
 } as const;
-export type Status = OpenEnum<typeof Status>;
+export type MediaAssetStatus = OpenEnum<typeof MediaAssetStatus>;
 
 export type MediaAsset = {
   id?: number | undefined;
-  mediaUrl?: string | undefined;
+  /**
+   * Fully qualified URL to the processed output file in SeaweedFS. Null while the asset is still PROCESSING.
+   */
+  mediaUrl?: string | null | undefined;
   mediaType?: MediaAssetMediaType | undefined;
-  status?: Status | undefined;
+  status?: MediaAssetStatus | undefined;
+  /**
+   * Zero-based display order of the asset within the post carousel.
+   */
   sortOrder?: number | undefined;
 };
 
@@ -39,16 +45,18 @@ export const MediaAssetMediaType$inboundSchema: z.ZodMiniType<
 > = openEnums.inboundSchema(MediaAssetMediaType);
 
 /** @internal */
-export const Status$inboundSchema: z.ZodMiniType<Status, unknown> = openEnums
-  .inboundSchema(Status);
+export const MediaAssetStatus$inboundSchema: z.ZodMiniType<
+  MediaAssetStatus,
+  unknown
+> = openEnums.inboundSchema(MediaAssetStatus);
 
 /** @internal */
 export const MediaAsset$inboundSchema: z.ZodMiniType<MediaAsset, unknown> = z
   .object({
     id: types.optional(types.number()),
-    mediaUrl: types.optional(types.string()),
+    mediaUrl: z.optional(z.nullable(types.string())),
     mediaType: types.optional(MediaAssetMediaType$inboundSchema),
-    status: types.optional(Status$inboundSchema),
+    status: types.optional(MediaAssetStatus$inboundSchema),
     sortOrder: types.optional(types.number()),
   });
 

package/src/models/operations/asset-processing-callback.ts

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

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

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

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

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

package/src/models/operations/index.ts

@@ -4,13 +4,15 @@
  */
 
 export * from "./add-collection-member.js";
+export * from "./asset-processing-callback.js";
 export * from "./create-collection.js";
-export * from "./create-post.js";
+export * from "./delete-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-message-history.js";
+export * from "./get-post.js";
 export * from "./get-user-profile.js";
 export * from "./login-user.js";
 export * from "./remove-collection-member.js";
@@ -18,3 +20,4 @@ export * from "./search-users.js";
 export * from "./send-message.js";
 export * from "./subscribe-to-user.js";
 export * from "./unsubscribe-from-user.js";
+export * from "./update-post.js";

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,7 +10,7 @@ export type RegisterRequest = {
   email: string;
   password: string;
   displayName: string;
-  bio: string;
+  bio?: string | null | undefined;
 };
 
 /** @internal */
@@ -19,7 +19,7 @@ export type RegisterRequest$Outbound = {
   email: string;
   password: string;
   displayName: string;
-  bio: string;
+  bio?: string | null | undefined;
 };
 
 /** @internal */
@@ -31,7 +31,7 @@ export const RegisterRequest$outboundSchema: z.ZodMiniType<
   email: z.string(),
   password: z.string(),
   displayName: z.string(),
-  bio: 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,
+    ));
+  }
+}