rozod 6.7.1 → 6.8.0

package/lib/endpoints/thumbnailsv1.d.ts

@@ -1,39 +1,6 @@
 import { z } from "zod";
 import { endpoint } from "..";
 
-const Roblox_Web_Responses_Thumbnails_ThumbnailResponse = z.object({
-  targetId: z.number().int(),
-  state: z.enum([
-    "Error",
-    "Completed",
-    "InReview",
-    "Pending",
-    "Blocked",
-    "TemporarilyUnavailable",
-  ]),
-  imageUrl: z.string(),
-  version: z.string(),
-});
-const Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_ =
-  z.object({
-    data: z.array(Roblox_Web_Responses_Thumbnails_ThumbnailResponse),
-  });
-const Roblox_Web_WebAPI_Models_ApiErrorModel = z.object({
-  code: z.number().int(),
-  message: z.string(),
-  userFacingMessage: z.string(),
-  field: z.string(),
-  fieldData: z.object({}),
-});
-const Roblox_Thumbnails_Api_Models_UniverseThumbnailsResponse = z.object({
-  universeId: z.number().int(),
-  error: Roblox_Web_WebAPI_Models_ApiErrorModel,
-  thumbnails: z.array(Roblox_Web_Responses_Thumbnails_ThumbnailResponse),
-});
-const Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Thumbnails_Api_Models_UniverseThumbnailsResponse_ =
-  z.object({
-    data: z.array(Roblox_Thumbnails_Api_Models_UniverseThumbnailsResponse),
-  });
 const Roblox_Thumbnails_Apis_Models_ThumbnailBatchRequest = z.object({
   requestId: z.string(),
   targetId: z.number().int(),
@@ -65,27 +32,8 @@ const Roblox_Thumbnails_Apis_Models_ThumbnailBatchRequest = z.object({
   isCircular: z.boolean(),
   accessContext: z.string(),
   headShape: z.string(),
+  includeBackground: z.boolean(),
 });
-const Roblox_Web_Responses_Thumbnails_ThumbnailBatchResponse = z.object({
-  requestId: z.string(),
-  errorCode: z.number().int(),
-  errorMessage: z.string(),
-  targetId: z.number().int(),
-  state: z.enum([
-    "Error",
-    "Completed",
-    "InReview",
-    "Pending",
-    "Blocked",
-    "TemporarilyUnavailable",
-  ]),
-  imageUrl: z.string(),
-  version: z.string(),
-});
-const Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailBatchResponse_ =
-  z.object({
-    data: z.array(Roblox_Web_Responses_Thumbnails_ThumbnailBatchResponse),
-  });
 
 /**
  * @api GET https://thumbnails.roblox.com/v1/asset-thumbnail-animated
@@ -111,7 +59,7 @@ export const getAssetThumbnailAnimated = endpoint({
     assetId: z.number().int(),
     "Roblox-Place-Id": z.number().int().optional(),
   },
-  response: Roblox_Web_Responses_Thumbnails_ThumbnailResponse,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -208,8 +156,7 @@ export const getAssets = endpoint({
     format: z.enum(["Png", "Jpeg", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -256,7 +203,7 @@ export const getAssetsThumbnail3d = endpoint({
     useGltf: z.boolean().optional(),
     "Roblox-Place-Id": z.number().int().optional(),
   },
-  response: Roblox_Web_Responses_Thumbnails_ThumbnailResponse,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -300,8 +247,7 @@ export const getBadgesIcons = endpoint({
     format: z.enum(["Png", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -353,8 +299,7 @@ export const postBatch = endpoint({
     "Roblox-Place-Id": z.number().int().optional(),
   },
   body: z.array(Roblox_Thumbnails_Apis_Models_ThumbnailBatchRequest),
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailBatchResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -406,8 +351,7 @@ export const getBundlesThumbnails = endpoint({
     format: z.enum(["Png", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -455,8 +399,7 @@ export const getDeveloperProductsIcons = endpoint({
     format: z.enum(["Png", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -504,8 +447,7 @@ export const getGamePasses = endpoint({
     format: z.enum(["Png", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -561,8 +503,7 @@ export const getGamesUniverseidThumbnails = endpoint({
     format: z.enum(["Png", "Jpeg", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -633,8 +574,7 @@ export const getGamesIcons = endpoint({
     format: z.enum(["Png", "Jpeg", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -702,8 +642,7 @@ export const getGamesMultigetThumbnails = endpoint({
     format: z.enum(["Png", "Jpeg", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Thumbnails_Api_Models_UniverseThumbnailsResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -751,8 +690,7 @@ export const getGroupsIcons = endpoint({
     format: z.enum(["Png", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -817,8 +755,7 @@ export const getPlacesGameicons = endpoint({
     format: z.enum(["Png", "Jpeg", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -839,6 +776,7 @@ export const getPlacesGameicons = endpoint({
  * @api GET https://thumbnails.roblox.com/v1/users/avatar
  * @summary Get Avatar Full body shots for the given CSV of userIds
  * @param userIds CSV for the userIds to get avatar full body shots
+ * @param includeBackground Whether to include a background in the thumbnail (defaults to false)
  * @param size The thumbnail size, formatted widthxheight
  * @param format The thumbnail format
  * @param isCircular The circle thumbnail output parameter, true or false
@@ -852,6 +790,10 @@ export const getUsersAvatar = endpoint({
     userIds: {
       style: "form",
     },
+    includeBackground: {
+      style: "form",
+      explode: true,
+    },
     size: {
       style: "form",
       explode: true,
@@ -867,6 +809,7 @@ export const getUsersAvatar = endpoint({
   },
   parameters: {
     userIds: z.array(z.number()),
+    includeBackground: z.boolean().optional(),
     size: z
       .enum([
         "30x30",
@@ -889,8 +832,7 @@ export const getUsersAvatar = endpoint({
     format: z.enum(["Png", "Jpeg", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -921,7 +863,7 @@ export const getUsersAvatar3d = endpoint({
   parameters: {
     userId: z.number().int(),
   },
-  response: Roblox_Web_Responses_Thumbnails_ThumbnailResponse,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -933,6 +875,7 @@ export const getUsersAvatar3d = endpoint({
  * @api GET https://thumbnails.roblox.com/v1/users/avatar-bust
  * @summary Get Avatar Busts for the given CSV of userIds
  * @param userIds CSV for the userIds to get avatar headshots
+ * @param includeBackground Whether to include a background in the thumbnail (defaults to false)
  * @param size The thumbnail size, formatted widthxheight
  * @param format The thumbnail format
  * @param isCircular The circle thumbnail output parameter, true or false
@@ -946,6 +889,10 @@ export const getUsersAvatarBust = endpoint({
     userIds: {
       style: "form",
     },
+    includeBackground: {
+      style: "form",
+      explode: true,
+    },
     size: {
       style: "form",
       explode: true,
@@ -961,6 +908,7 @@ export const getUsersAvatarBust = endpoint({
   },
   parameters: {
     userIds: z.array(z.number()),
+    includeBackground: z.boolean().optional(),
     size: z
       .enum([
         "48x48",
@@ -978,8 +926,7 @@ export const getUsersAvatarBust = endpoint({
     format: z.enum(["Png", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -995,6 +942,7 @@ export const getUsersAvatarBust = endpoint({
  * @api GET https://thumbnails.roblox.com/v1/users/avatar-headshot
  * @summary Get Avatar Headshots for the given CSV of userIds
  * @param userIds CSV for the userIds to get avatar headshots
+ * @param includeBackground Whether to include a background in the thumbnail (defaults to false)
  * @param size The thumbnail size, formatted widthxheight
  * @param format The thumbnail format
  * @param isCircular The circle thumbnail output parameter, true or false
@@ -1008,6 +956,10 @@ export const getUsersAvatarHeadshot = endpoint({
     userIds: {
       style: "form",
     },
+    includeBackground: {
+      style: "form",
+      explode: true,
+    },
     size: {
       style: "form",
       explode: true,
@@ -1023,6 +975,7 @@ export const getUsersAvatarHeadshot = endpoint({
   },
   parameters: {
     userIds: z.array(z.number()),
+    includeBackground: z.boolean().optional(),
     size: z
       .enum([
         "48x48",
@@ -1042,8 +995,7 @@ export const getUsersAvatarHeadshot = endpoint({
     format: z.enum(["Png", "Jpeg", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,
@@ -1074,13 +1026,14 @@ export const getUsersOutfit3d = endpoint({
   parameters: {
     outfitId: z.number().int(),
   },
-  response: Roblox_Web_Responses_Thumbnails_ThumbnailResponse,
+  response: z.void(),
   errors: [],
 });
 /**
  * @api GET https://thumbnails.roblox.com/v1/users/outfits
  * @summary Get outfits for the given CSV of userOutfitIds
  * @param userOutfitIds CSV for the userOutfitIds to get user outfits
+ * @param includeBackground Whether to include a background in the thumbnail (defaults to false)
  * @param size The thumbnail size, formatted widthxheight
  * @param format The thumbnail format
  * @param isCircular The circle thumbnail output parameter, true or false
@@ -1094,6 +1047,10 @@ export const getUsersOutfits = endpoint({
     userOutfitIds: {
       style: "form",
     },
+    includeBackground: {
+      style: "form",
+      explode: true,
+    },
     size: {
       style: "form",
       explode: true,
@@ -1109,12 +1066,12 @@ export const getUsersOutfits = endpoint({
   },
   parameters: {
     userOutfitIds: z.array(z.number()),
+    includeBackground: z.boolean().optional(),
     size: z.enum(["150x150", "420x420"]).optional().default("150x150"),
     format: z.enum(["Png", "Webp"]).optional().default("Png"),
     isCircular: z.union([z.literal(true), z.literal(false)]).optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
+  response: z.void(),
   errors: [
     {
       status: 400,

package/lib/endpoints/thumbnailsv1.js

@@ -58,6 +58,7 @@ const Roblox_Thumbnails_Apis_Models_ThumbnailBatchRequest = zod_1.z.object({
     isCircular: zod_1.z.boolean(),
     accessContext: zod_1.z.string(),
     headShape: zod_1.z.string(),
+    includeBackground: zod_1.z.boolean(),
 });
 const Roblox_Web_Responses_Thumbnails_ThumbnailBatchResponse = zod_1.z.object({
     requestId: zod_1.z.string(),
@@ -788,6 +789,7 @@ exports.getPlacesGameicons = (0, __1.endpoint)({
  * @param size The thumbnail size, formatted widthxheight
  * @param format The thumbnail format
  * @param isCircular The circle thumbnail output parameter, true or false
+ * @param includeBackground Whether to include a background in the thumbnail (defaults to false)
  */
 exports.getUsersAvatar = (0, __1.endpoint)({
     method: 'GET',
@@ -810,6 +812,10 @@ exports.getUsersAvatar = (0, __1.endpoint)({
             style: 'form',
             explode: true,
         },
+        includeBackground: {
+            style: 'form',
+            explode: true,
+        },
     },
     parameters: {
         userIds: zod_1.z.array(zod_1.z.number()),
@@ -834,6 +840,7 @@ exports.getUsersAvatar = (0, __1.endpoint)({
             .default('30x30'),
         format: zod_1.z.enum(['Png', 'Jpeg', 'Webp']).optional().default('Png'),
         isCircular: zod_1.z.union([zod_1.z.literal(true), zod_1.z.literal(false)]).optional(),
+        includeBackground: zod_1.z.boolean().optional(),
     },
     response: Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
     errors: [
@@ -881,6 +888,7 @@ exports.getUsersAvatar3d = (0, __1.endpoint)({
  * @param size The thumbnail size, formatted widthxheight
  * @param format The thumbnail format
  * @param isCircular The circle thumbnail output parameter, true or false
+ * @param includeBackground Whether to include a background in the thumbnail (defaults to false)
  */
 exports.getUsersAvatarBust = (0, __1.endpoint)({
     method: 'GET',
@@ -903,6 +911,10 @@ exports.getUsersAvatarBust = (0, __1.endpoint)({
             style: 'form',
             explode: true,
         },
+        includeBackground: {
+            style: 'form',
+            explode: true,
+        },
     },
     parameters: {
         userIds: zod_1.z.array(zod_1.z.number()),
@@ -912,6 +924,7 @@ exports.getUsersAvatarBust = (0, __1.endpoint)({
             .default('48x48'),
         format: zod_1.z.enum(['Png', 'Webp']).optional().default('Png'),
         isCircular: zod_1.z.union([zod_1.z.literal(true), zod_1.z.literal(false)]).optional(),
+        includeBackground: zod_1.z.boolean().optional(),
     },
     response: Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
     errors: [
@@ -932,6 +945,7 @@ exports.getUsersAvatarBust = (0, __1.endpoint)({
  * @param size The thumbnail size, formatted widthxheight
  * @param format The thumbnail format
  * @param isCircular The circle thumbnail output parameter, true or false
+ * @param includeBackground Whether to include a background in the thumbnail (defaults to false)
  */
 exports.getUsersAvatarHeadshot = (0, __1.endpoint)({
     method: 'GET',
@@ -954,6 +968,10 @@ exports.getUsersAvatarHeadshot = (0, __1.endpoint)({
             style: 'form',
             explode: true,
         },
+        includeBackground: {
+            style: 'form',
+            explode: true,
+        },
     },
     parameters: {
         userIds: zod_1.z.array(zod_1.z.number()),
@@ -975,6 +993,7 @@ exports.getUsersAvatarHeadshot = (0, __1.endpoint)({
             .default('48x48'),
         format: zod_1.z.enum(['Png', 'Jpeg', 'Webp']).optional().default('Png'),
         isCircular: zod_1.z.union([zod_1.z.literal(true), zod_1.z.literal(false)]).optional(),
+        includeBackground: zod_1.z.boolean().optional(),
     },
     response: Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
     errors: [
@@ -1017,6 +1036,7 @@ exports.getUsersOutfit3d = (0, __1.endpoint)({
  * @param size The thumbnail size, formatted widthxheight
  * @param format The thumbnail format
  * @param isCircular The circle thumbnail output parameter, true or false
+ * @param includeBackground Whether to include a background in the thumbnail (defaults to false)
  */
 exports.getUsersOutfits = (0, __1.endpoint)({
     method: 'GET',
@@ -1039,12 +1059,17 @@ exports.getUsersOutfits = (0, __1.endpoint)({
             style: 'form',
             explode: true,
         },
+        includeBackground: {
+            style: 'form',
+            explode: true,
+        },
     },
     parameters: {
         userOutfitIds: zod_1.z.array(zod_1.z.number()),
         size: zod_1.z.enum(['150x150', '420x420']).optional().default('150x150'),
         format: zod_1.z.enum(['Png', 'Webp']).optional().default('Png'),
         isCircular: zod_1.z.union([zod_1.z.literal(true), zod_1.z.literal(false)]).optional(),
+        includeBackground: zod_1.z.boolean().optional(),
     },
     response: Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Web_Responses_Thumbnails_ThumbnailResponse_,
     errors: [

package/lib/index.d.ts

@@ -24,15 +24,22 @@ export type EndpointSchema = EndpointBase & {
     parameters?: any;
     body?: any;
     response: any;
+    /**
+     * For long-running-operation endpoints (response is an `Operation`), the schema of the
+     * completed operation's `response` payload. Lets {@link pollOperation}/{@link fetchApiOperation}
+     * validate and type the result without an explicit schema. Populated by codegen.
+     */
+    resultResponse?: any;
 };
 /**
  * This is a hack to allow us to show the parameters and response types of an endpoint
  * as the inferred types of the parameters and response properties.
  */
-export type EndpointGeneric<T, U, E> = EndpointBase & {
+export type EndpointGeneric<T, U, E, RR = undefined> = EndpointBase & {
     parameters?: T;
     body?: E;
     response: U;
+    resultResponse?: RR;
 };
 type InferZodObjectOptional<T extends z.ZodRawShape> = {
     [K in keyof T]: T[K] extends z.ZodOptional<any> | z.ZodDefault<any> ? K : never;
@@ -48,7 +55,7 @@ type InferNonEmpty<T extends Record<string, z.Schema<any>>> = Merge<{
 }, {
     [K in InferZodObjectOptional<T>]?: z.infer<T[K]>;
 }>;
-declare const endpoint: <T extends Record<string, z.Schema<any>>, U extends z.ZodTypeAny, E extends z.ZodTypeAny | undefined = undefined>(endpoint: EndpointGeneric<T, U, E>) => EndpointGeneric<InferNonEmpty<T>, z.infer<U>, E extends z.ZodTypeAny ? z.infer<E> : undefined>;
+declare const endpoint: <T extends Record<string, z.Schema<any>>, U extends z.ZodTypeAny, E extends z.ZodTypeAny | undefined = undefined, RR extends z.ZodTypeAny | undefined = undefined>(endpoint: EndpointGeneric<T, U, E, RR>) => EndpointGeneric<InferNonEmpty<T>, z.infer<U>, E extends z.ZodTypeAny ? z.infer<E> : undefined, RR extends z.ZodTypeAny ? z.infer<RR> : undefined>;
 type IsExactlyUndefined<T> = [T] extends [undefined] ? ([undefined] extends [T] ? true : false) : false;
 type ExtractParams<S extends EndpointGeneric<any, any, any>> = S['parameters'] extends undefined ? IsExactlyUndefined<S['body']> extends true ? undefined : {
     body: S['body'];
@@ -56,6 +63,7 @@ type ExtractParams<S extends EndpointGeneric<any, any, any>> = S['parameters'] e
     body: S['body'];
 };
 type ExtractResponse<S extends EndpointGeneric<any, any, any>> = S['response'];
+type ExtractOperationResult<S extends EndpointSchema> = [S['resultResponse']] extends [undefined] ? unknown : NonNullable<S['resultResponse']>;
 type RetryOptions = {
     retries?: number;
     retryDelay?: number;
@@ -386,4 +394,89 @@ declare function fetchApiPages<S extends EndpointSchema>(endpoint: S, initialPar
  * ```
  */
 declare function fetchApiPagesGenerator<S extends EndpointSchema, R extends boolean>(endpoint: S, initialParams: ExtractParams<S>, requestOptions?: RequestOptions<R>, limit?: number): AsyncGenerator<ExtractResponse<S> | AnyError, void, unknown>;
-export { fetchApi, fetchApiSplit, fetchApiPages, fetchApiPagesGenerator, ExtractResponse, ExtractParams, endpoint };
+/**
+ * Roblox Open Cloud long-running operation envelope. Endpoints such as
+ * `generateThumbnail` / `generateAsset` return this instead of the final
+ * result: `done` is false until the work completes, at which point `response`
+ * holds the payload. Fields are optional because the API omits `response`
+ * (and sometimes `done`) while the operation is still in progress.
+ */
+export declare const OperationSchema: z.ZodObject<{
+    path: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    done: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        message: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        details: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodAny>>>;
+    }, z.core.$strip>>;
+    response: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+export type Operation = z.infer<typeof OperationSchema>;
+/** Minimal shape accepted by {@link pollOperation} — assignable from any generated Operation response. */
+type OperationLike = {
+    path: string;
+    done?: boolean;
+    response?: unknown;
+    error?: {
+        code?: number;
+        message?: string;
+    } | null;
+};
+type PollOperationOptions<R extends boolean = false> = {
+    /** Delay between polls in milliseconds. Default 1000. */
+    interval?: number;
+    /** Give up after this many milliseconds and throw. Default 30000. */
+    timeout?: number;
+    /** Abort the poll early; rejects with the signal's reason. */
+    signal?: AbortSignal;
+    /** Override the base URL the operation path is resolved against. Defaults to the originating endpoint's `baseUrl`. */
+    baseUrl?: string;
+    /**
+     * Override the API-version prefix inserted between the base URL and the
+     * operation path (e.g. `/assets/v1`). By default it is derived from the
+     * originating endpoint's path, which works for operations whose path is
+     * relative to the endpoint's own version (e.g. `users/123/operations/…`).
+     */
+    pathPrefix?: string;
+    /** Forwarded to each poll request (headers such as the API key, retries, credentials, …). */
+    requestOptions?: RequestOptions<R>;
+};
+/**
+ * Polls a Roblox Open Cloud long-running {@link Operation} until it completes,
+ * then returns its final `response` payload.
+ *
+ * Generate-style endpoints (e.g. `getCloudV2UsersUserIdGenerateThumbnail`)
+ * return an {@link Operation} rather than the result itself. When the result
+ * isn't cached, `done` is false and you must GET the operation's `path` until
+ * it flips true. This helper does that, resolving the path against the
+ * originating endpoint's base URL and version prefix.
+ *
+ * The result is validated against `resultSchema` if given; otherwise it falls
+ * back to the endpoint's codegen'd `resultResponse` schema (so generated
+ * operation endpoints need no explicit schema). With neither, the raw payload
+ * is returned as `unknown`.
+ *
+ * @example
+ * // Typed automatically from the endpoint's result schema:
+ * const { imageUri } = await pollOperation(getCloudV2UsersUserIdGenerateThumbnail, op);
+ * // Or with an explicit schema for custom/unknown payloads:
+ * const result = await pollOperation(customEndpoint, op, z.object({ imageUri: z.string() }));
+ */
+declare function pollOperation<S extends EndpointSchema, T extends z.ZodTypeAny>(endpoint: S, operation: OperationLike, resultSchema: T, options?: PollOperationOptions): Promise<z.infer<T>>;
+declare function pollOperation<S extends EndpointSchema>(endpoint: S, operation: OperationLike, options?: PollOperationOptions): Promise<ExtractOperationResult<S>>;
+/**
+ * Fires a long-running-operation endpoint and waits for its result in one call —
+ * `fetchApi` followed by {@link pollOperation}, using a single endpoint reference.
+ *
+ * The result is typed from the endpoint's codegen'd `resultResponse` schema when
+ * present; pass an explicit `resultSchema` for custom endpoints or to override it.
+ *
+ * @example
+ * const { imageUri } = await fetchApiOperation(getCloudV2UsersUserIdGenerateThumbnail, {
+ *   user_id: robloxId, shape: 'SQUARE', format: 'PNG',
+ * });
+ */
+declare function fetchApiOperation<S extends EndpointSchema, T extends z.ZodTypeAny>(endpoint: S, params: ExtractParams<S>, resultSchema: T, options?: PollOperationOptions): Promise<z.infer<T>>;
+declare function fetchApiOperation<S extends EndpointSchema>(endpoint: S, params: ExtractParams<S>, options?: PollOperationOptions): Promise<ExtractOperationResult<S>>;
+export { fetchApi, fetchApiSplit, fetchApiPages, fetchApiPagesGenerator, pollOperation, fetchApiOperation, ExtractResponse, ExtractParams, endpoint, };