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

package/src/funcs/user-discovery-get-user-follower-count.ts

@@ -0,0 +1,172 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 788aa2ce6d6e
+ */
+
+import * as z from "zod/v4-mini";
+import { FankareSDKCore } from "../core.js";
+import { 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";
+
+/**
+ * Fetch a specific user's follower count
+ */
+export function userDiscoveryGetUserFollowerCount(
+  client: FankareSDKCore,
+  userId: number,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.FollowerCountResponse,
+    | FankareSDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    userId,
+    options,
+  ));
+}
+
+async function $do(
+  client: FankareSDKCore,
+  userId: number,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.FollowerCountResponse,
+      | FankareSDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const input: operations.GetUserFollowerCountRequest = {
+    userId: userId,
+  };
+
+  const parsed = safeParse(
+    input,
+    (value) =>
+      z.parse(operations.GetUserFollowerCountRequest$outboundSchema, value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    userId: encodeSimple("userId", payload.userId, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/users/{userId}/followers/count")(pathParams);
+
+  const headers = new Headers(compactMap({
+    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: "getUserFollowerCount",
+    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: "GET",
+    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.FollowerCountResponse,
+    | FankareSDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.FollowerCountResponse$inboundSchema),
+    M.fail([401, 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/funcs/user-discovery-get-user-followers.ts

@@ -0,0 +1,186 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4085e9ab1118
+ */
+
+import * as z from "zod/v4-mini";
+import { FankareSDKCore } from "../core.js";
+import { encodeFormQuery, 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";
+
+/**
+ * Fetch a specific user's paginated list of followers
+ */
+export function userDiscoveryGetUserFollowers(
+  client: FankareSDKCore,
+  userId: number,
+  limit?: number | undefined,
+  cursor?: string | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.PaginatedFollowersResponse,
+    | FankareSDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    userId,
+    limit,
+    cursor,
+    options,
+  ));
+}
+
+async function $do(
+  client: FankareSDKCore,
+  userId: number,
+  limit?: number | undefined,
+  cursor?: string | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.PaginatedFollowersResponse,
+      | FankareSDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const input: operations.GetUserFollowersRequest = {
+    userId: userId,
+    limit: limit,
+    cursor: cursor,
+  };
+
+  const parsed = safeParse(
+    input,
+    (value) =>
+      z.parse(operations.GetUserFollowersRequest$outboundSchema, value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    userId: encodeSimple("userId", payload.userId, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/users/{userId}/followers")(pathParams);
+
+  const query = encodeFormQuery({
+    "cursor": payload.cursor,
+    "limit": payload.limit,
+  });
+
+  const headers = new Headers(compactMap({
+    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: "getUserFollowers",
+    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: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    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.PaginatedFollowersResponse,
+    | FankareSDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, models.PaginatedFollowersResponse$inboundSchema),
+    M.fail([401, 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.5",
+  openapiDocVersion: "1.1.0",
+  sdkVersion: "0.1.1",
   genVersion: "2.911.0",
-  userAgent: "speakeasy-sdk/typescript 0.0.5 2.911.0 1.0.0 openapi",
+  userAgent: "speakeasy-sdk/typescript 0.1.1 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/comment.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 31da50e38c51
+ */
+
+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 { User, User$inboundSchema } from "./user.js";
+
+export type Comment = {
+  id: number;
+  postId: number;
+  user: User;
+  content: string;
+  createdAt: Date;
+};
+
+/** @internal */
+export const Comment$inboundSchema: z.ZodMiniType<Comment, unknown> = z.object({
+  id: types.number(),
+  postId: types.number(),
+  user: User$inboundSchema,
+  content: types.string(),
+  createdAt: types.date(),
+});
+
+export function commentFromJSON(
+  jsonString: string,
+): SafeParseResult<Comment, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Comment$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Comment' from JSON`,
+  );
+}

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

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1281f847c1db
+ */
+
+import * as z from "zod/v4-mini";
+
+export type CreateCommentRequest = {
+  /**
+   * The textual content of the comment.
+   */
+  content: string;
+};
+
+/** @internal */
+export type CreateCommentRequest$Outbound = {
+  content: string;
+};
+
+/** @internal */
+export const CreateCommentRequest$outboundSchema: z.ZodMiniType<
+  CreateCommentRequest$Outbound,
+  CreateCommentRequest
+> = z.object({
+  content: z.string(),
+});
+
+export function createCommentRequestToJSON(
+  createCommentRequest: CreateCommentRequest,
+): string {
+  return JSON.stringify(
+    CreateCommentRequest$outboundSchema.parse(createCommentRequest),
+  );
+}

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(