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

package/src/funcs/posts-update-post.ts

@@ -0,0 +1,179 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c35894cf389e
+ */
+
+import * as z from "zod/v4-mini";
+import { FankareSDKCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import { FankareSDKError } from "../models/errors/fankare-sdk-error.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} 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";
+
+/**
+ * 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.
+ */
+export function postsUpdatePost(
+  client: FankareSDKCore,
+  postId: number,
+  body: models.UpdatePostRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.Post,
+    | FankareSDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    postId,
+    body,
+    options,
+  ));
+}
+
+async function $do(
+  client: FankareSDKCore,
+  postId: number,
+  body: models.UpdatePostRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.Post,
+      | FankareSDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const input: operations.UpdatePostRequest = {
+    postId: postId,
+    body: body,
+  };
+
+  const parsed = safeParse(
+    input,
+    (value) => z.parse(operations.UpdatePostRequest$outboundSchema, value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body$ = encodeJSON("body", payload.body, { explode: true });
+
+  const pathParams = {
+    postId: encodeSimple("postId", payload.postId, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/posts/{postId}")(pathParams);
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearerAuth);
+  const securityInput = secConfig == null ? {} : { bearerAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "updatePost",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearerAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "PATCH",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body$,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    models.Post,
+    | FankareSDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.Post$inboundSchema),
+    M.fail([400, 401, 403, 404, "4XX"]),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -61,8 +61,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 
 export const SDK_METADATA = {
   language: "typescript",
-  openapiDocVersion: "1.0.0",
-  sdkVersion: "0.0.4",
+  openapiDocVersion: "1.1.0",
+  sdkVersion: "0.1.0",
   genVersion: "2.911.0",
-  userAgent: "speakeasy-sdk/typescript 0.0.4 2.911.0 1.0.0 openapi",
+  userAgent: "speakeasy-sdk/typescript 0.1.0 2.911.0 1.1.0 openapi",
 } as const;

package/src/models/asset-declaration.ts

@@ -0,0 +1,84 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 382ff0659e0a
+ */
+
+import * as z from "zod/v4-mini";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Logical media category used to route the Celery processing task.
+ */
+export const AssetDeclarationMediaType = {
+  Image: "IMAGE",
+  Video: "VIDEO",
+} as const;
+/**
+ * Logical media category used to route the Celery processing task.
+ */
+export type AssetDeclarationMediaType = ClosedEnum<
+  typeof AssetDeclarationMediaType
+>;
+
+/**
+ * MIME type of the file to be uploaded. Must match the mediaType category.
+ */
+export const AssetDeclarationContentType = {
+  ImageJpeg: "image/jpeg",
+  ImagePng: "image/png",
+  ImageWebp: "image/webp",
+  ImageGif: "image/gif",
+  VideoMp4: "video/mp4",
+  VideoQuicktime: "video/quicktime",
+  VideoXMatroska: "video/x-matroska",
+} as const;
+/**
+ * MIME type of the file to be uploaded. Must match the mediaType category.
+ */
+export type AssetDeclarationContentType = ClosedEnum<
+  typeof AssetDeclarationContentType
+>;
+
+export type AssetDeclaration = {
+  /**
+   * Logical media category used to route the Celery processing task.
+   */
+  mediaType: AssetDeclarationMediaType;
+  /**
+   * MIME type of the file to be uploaded. Must match the mediaType category.
+   */
+  contentType: AssetDeclarationContentType;
+};
+
+/** @internal */
+export const AssetDeclarationMediaType$outboundSchema: z.ZodMiniEnum<
+  typeof AssetDeclarationMediaType
+> = z.enum(AssetDeclarationMediaType);
+
+/** @internal */
+export const AssetDeclarationContentType$outboundSchema: z.ZodMiniEnum<
+  typeof AssetDeclarationContentType
+> = z.enum(AssetDeclarationContentType);
+
+/** @internal */
+export type AssetDeclaration$Outbound = {
+  mediaType: string;
+  contentType: string;
+};
+
+/** @internal */
+export const AssetDeclaration$outboundSchema: z.ZodMiniType<
+  AssetDeclaration$Outbound,
+  AssetDeclaration
+> = z.object({
+  mediaType: AssetDeclarationMediaType$outboundSchema,
+  contentType: AssetDeclarationContentType$outboundSchema,
+});
+
+export function assetDeclarationToJSON(
+  assetDeclaration: AssetDeclaration,
+): string {
+  return JSON.stringify(
+    AssetDeclaration$outboundSchema.parse(assetDeclaration),
+  );
+}

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

@@ -0,0 +1,68 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b75d6ac67429
+ */
+
+import * as z from "zod/v4-mini";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * The terminal processing outcome reported by the Celery worker.
+ */
+export const AssetProcessingCallbackRequestStatus = {
+  Ready: "READY",
+  Failed: "FAILED",
+} as const;
+/**
+ * The terminal processing outcome reported by the Celery worker.
+ */
+export type AssetProcessingCallbackRequestStatus = ClosedEnum<
+  typeof AssetProcessingCallbackRequestStatus
+>;
+
+export type AssetProcessingCallbackRequest = {
+  /**
+   * The terminal processing outcome reported by the Celery worker.
+   */
+  status: AssetProcessingCallbackRequestStatus;
+  /**
+   * The canonical SeaweedFS path of the transcoded/optimised output file. Required when status is READY. The gateway overwrites post_assets.media_key with this value so that mediaUrl is derived from the processed file, not the raw upload.
+   */
+  finalMediaKey?: string | null | undefined;
+  /**
+   * Human-readable failure reason for logging and observability. Only meaningful when status is FAILED.
+   */
+  errorReason?: string | null | undefined;
+};
+
+/** @internal */
+export const AssetProcessingCallbackRequestStatus$outboundSchema: z.ZodMiniEnum<
+  typeof AssetProcessingCallbackRequestStatus
+> = z.enum(AssetProcessingCallbackRequestStatus);
+
+/** @internal */
+export type AssetProcessingCallbackRequest$Outbound = {
+  status: string;
+  finalMediaKey?: string | null | undefined;
+  errorReason?: string | null | undefined;
+};
+
+/** @internal */
+export const AssetProcessingCallbackRequest$outboundSchema: z.ZodMiniType<
+  AssetProcessingCallbackRequest$Outbound,
+  AssetProcessingCallbackRequest
+> = z.object({
+  status: AssetProcessingCallbackRequestStatus$outboundSchema,
+  finalMediaKey: z.optional(z.nullable(z.string())),
+  errorReason: z.optional(z.nullable(z.string())),
+});
+
+export function assetProcessingCallbackRequestToJSON(
+  assetProcessingCallbackRequest: AssetProcessingCallbackRequest,
+): string {
+  return JSON.stringify(
+    AssetProcessingCallbackRequest$outboundSchema.parse(
+      assetProcessingCallbackRequest,
+    ),
+  );
+}

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

@@ -4,49 +4,27 @@
  */
 
 import * as z from "zod/v4-mini";
-import { ClosedEnum } from "../types/enums.js";
-
-export const CreatePostRequestMediaType = {
-  Image: "IMAGE",
-  Video: "VIDEO",
-} as const;
-export type CreatePostRequestMediaType = ClosedEnum<
-  typeof CreatePostRequestMediaType
->;
-
-export type Asset = {
-  mediaType: CreatePostRequestMediaType;
-};
+import {
+  AssetDeclaration,
+  AssetDeclaration$Outbound,
+  AssetDeclaration$outboundSchema,
+} from "./asset-declaration.js";
 
 export type CreatePostRequest = {
-  caption: string;
-  assets: Array<Asset>;
-};
-
-/** @internal */
-export const CreatePostRequestMediaType$outboundSchema: z.ZodMiniEnum<
-  typeof CreatePostRequestMediaType
-> = z.enum(CreatePostRequestMediaType);
-
-/** @internal */
-export type Asset$Outbound = {
-  mediaType: string;
+  /**
+   * Optional caption for the post. May be set now or supplied later via PATCH.
+   */
+  caption?: string | null | undefined;
+  /**
+   * Ordered list of media assets to attach to this post. The array index determines sort_order.
+   */
+  assets: Array<AssetDeclaration>;
 };
 
-/** @internal */
-export const Asset$outboundSchema: z.ZodMiniType<Asset$Outbound, Asset> = z
-  .object({
-    mediaType: CreatePostRequestMediaType$outboundSchema,
-  });
-
-export function assetToJSON(asset: Asset): string {
-  return JSON.stringify(Asset$outboundSchema.parse(asset));
-}
-
 /** @internal */
 export type CreatePostRequest$Outbound = {
-  caption: string;
-  assets: Array<Asset$Outbound>;
+  caption?: string | null | undefined;
+  assets: Array<AssetDeclaration$Outbound>;
 };
 
 /** @internal */
@@ -54,8 +32,8 @@ export const CreatePostRequest$outboundSchema: z.ZodMiniType<
   CreatePostRequest$Outbound,
   CreatePostRequest
 > = z.object({
-  caption: z.string(),
-  assets: z.array(z.lazy(() => Asset$outboundSchema)),
+  caption: z.optional(z.nullable(z.string())),
+  assets: z.array(AssetDeclaration$outboundSchema),
 });
 
 export function createPostRequestToJSON(

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

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: dd751a66d133
+ */
+
+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 { UploadSlot, UploadSlot$inboundSchema } from "./upload-slot.js";
+
+export type CreatePostResponse = {
+  /**
+   * ID of the newly created DRAFT post.
+   */
+  postId?: number | undefined;
+  /**
+   * One entry per declared asset, in the same order as the request.
+   */
+  uploadSlots?: Array<UploadSlot> | undefined;
+};
+
+/** @internal */
+export const CreatePostResponse$inboundSchema: z.ZodMiniType<
+  CreatePostResponse,
+  unknown
+> = z.object({
+  postId: types.optional(types.number()),
+  uploadSlots: types.optional(z.array(UploadSlot$inboundSchema)),
+});
+
+export function createPostResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CreatePostResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreatePostResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreatePostResponse' from JSON`,
+  );
+}

package/src/models/index.ts

@@ -3,16 +3,25 @@
  * @generated-id: f93644b0f37e
  */
 
+export * from "./asset-declaration.js";
+export * from "./asset-processing-callback-request.js";
 export * from "./collection.js";
 export * from "./conversation.js";
 export * from "./create-post-request.js";
+export * from "./create-post-response.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 "./profile-media-confirm-request.js";
+export * from "./profile-media-upload-request.js";
+export * from "./profile-media-upload-response.js";
 export * from "./register-request.js";
 export * from "./security.js";
 export * from "./send-message-request.js";
+export * from "./update-post-request.js";
+export * from "./update-profile-request.js";
+export * from "./upload-slot.js";
 export * from "./user-profile.js";
 export * from "./user.js";

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";