rozod 6.7.1 → 6.9.0

package/lib/endpoints/usersv1.d.ts

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import { endpoint } from "..";
+import { z } from 'zod';
+import { endpoint } from '..';
 
 const Roblox_Users_Api_BirthdateResponse = z.object({
   birthMonth: z.number().int(),
@@ -21,7 +21,7 @@ const Roblox_Users_Api_DescriptionRequest = z.object({
 });
 const Roblox_Users_Api_GenderResponse = z.object({ gender: z.number().int() });
 const Roblox_Users_Api_GenderRequest = z.object({
-  gender: z.enum(["Unknown", "Male", "Female"]),
+  gender: z.enum(['Unknown', 'Male', 'Female']),
 });
 const Roblox_Users_Api_GetUserResponse = z.object({
   description: z.string(),
@@ -34,12 +34,11 @@ const Roblox_Users_Api_GetUserResponse = z.object({
   displayName: z.string(),
 });
 const Roblox_Users_Api_UsernameHistoryResponse = z.object({ name: z.string() });
-const Roblox_Web_WebAPI_Models_ApiPageResponse_Roblox_Users_Api_UsernameHistoryResponse_ =
-  z.object({
-    previousPageCursor: z.string(),
-    nextPageCursor: z.string(),
-    data: z.array(Roblox_Users_Api_UsernameHistoryResponse),
-  });
+const Roblox_Web_WebAPI_Models_ApiPageResponse_Roblox_Users_Api_UsernameHistoryResponse_ = z.object({
+  previousPageCursor: z.string(),
+  nextPageCursor: z.string(),
+  data: z.array(Roblox_Users_Api_UsernameHistoryResponse),
+});
 const Roblox_Users_Api_AuthenticatedGetUserResponse = z.object({
   id: z.number().int(),
   name: z.string(),
@@ -61,12 +60,11 @@ const Roblox_Users_Api_SearchGetUserResponse = z.object({
   name: z.string(),
   displayName: z.string(),
 });
-const Roblox_Web_WebAPI_Models_ApiPageResponse_Roblox_Users_Api_SearchGetUserResponse_ =
-  z.object({
-    previousPageCursor: z.string(),
-    nextPageCursor: z.string(),
-    data: z.array(Roblox_Users_Api_SearchGetUserResponse),
-  });
+const Roblox_Web_WebAPI_Models_ApiPageResponse_Roblox_Users_Api_SearchGetUserResponse_ = z.object({
+  previousPageCursor: z.string(),
+  nextPageCursor: z.string(),
+  data: z.array(Roblox_Users_Api_SearchGetUserResponse),
+});
 const Roblox_Users_Api_MultiGetByUsernameRequest = z.object({
   usernames: z.array(z.string()),
   excludeBannedUsers: z.boolean(),
@@ -78,8 +76,9 @@ const Roblox_Users_Api_MultiGetUserByNameResponse = z.object({
   name: z.string(),
   displayName: z.string(),
 });
-const Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Users_Api_MultiGetUserByNameResponse_ =
-  z.object({ data: z.array(Roblox_Users_Api_MultiGetUserByNameResponse) });
+const Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Users_Api_MultiGetUserByNameResponse_ = z.object({
+  data: z.array(Roblox_Users_Api_MultiGetUserByNameResponse),
+});
 const Roblox_Users_Api_MultiGetByUserIdRequest = z.object({
   userIds: z.array(z.number()),
   excludeBannedUsers: z.boolean(),
@@ -90,8 +89,9 @@ const Roblox_Users_Api_MultiGetUserResponse = z.object({
   name: z.string(),
   displayName: z.string(),
 });
-const Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Users_Api_MultiGetUserResponse_ =
-  z.object({ data: z.array(Roblox_Users_Api_MultiGetUserResponse) });
+const Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Users_Api_MultiGetUserResponse_ = z.object({
+  data: z.array(Roblox_Users_Api_MultiGetUserResponse),
+});
 const Roblox_Users_Api_SetDisplayNameRequest = z.object({
   newDisplayName: z.string(),
 });
@@ -101,10 +101,10 @@ const Roblox_Users_Api_SetDisplayNameRequest = z.object({
  * @summary Get the user's birthdate
  */
 export const getBirthdate = endpoint({
-  method: "GET",
-  path: "/v1/birthdate",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/birthdate',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   response: Roblox_Users_Api_BirthdateResponse,
   errors: [
     {
@@ -123,10 +123,10 @@ export const getBirthdate = endpoint({
  * @param body The Roblox.Users.Api.BirthdateRequest
  */
 export const postBirthdate = endpoint({
-  method: "POST",
-  path: "/v1/birthdate",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'POST',
+  path: '/v1/birthdate',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     body: {},
   },
@@ -162,10 +162,10 @@ export const postBirthdate = endpoint({
  * @summary Get the user's description
  */
 export const getDescription = endpoint({
-  method: "GET",
-  path: "/v1/description",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/description',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   response: z.object({ description: z.string() }),
   errors: [
     {
@@ -184,10 +184,10 @@ export const getDescription = endpoint({
  * @param body The Roblox.Users.Api.DescriptionRequest
  */
 export const postDescription = endpoint({
-  method: "POST",
-  path: "/v1/description",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'POST',
+  path: '/v1/description',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     body: {},
   },
@@ -225,17 +225,17 @@ export const postDescription = endpoint({
  * @param birthdate The new user's birthdate
  */
 export const getDisplayNamesValidate = endpoint({
-  method: "GET",
-  path: "/v1/display-names/validate",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/display-names/validate',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     displayName: {
-      style: "form",
+      style: 'form',
       explode: true,
     },
     birthdate: {
-      style: "form",
+      style: 'form',
       explode: true,
     },
   },
@@ -265,10 +265,10 @@ export const getDisplayNamesValidate = endpoint({
  * @summary Get the user's gender
  */
 export const getGender = endpoint({
-  method: "GET",
-  path: "/v1/gender",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/gender',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   response: z.object({ gender: z.number().int() }),
   errors: [
     {
@@ -287,10 +287,10 @@ export const getGender = endpoint({
  * @param body The Roblox.Users.Api.GenderRequest
  */
 export const postGender = endpoint({
-  method: "POST",
-  path: "/v1/gender",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'POST',
+  path: '/v1/gender',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     body: {},
   },
@@ -326,17 +326,16 @@ export const postGender = endpoint({
 Does not require X-CSRF-Token protection because this is essentially a get request but as a POST to avoid URI limits.
  */
 export const postUsernamesUsers = endpoint({
-  method: "POST",
-  path: "/v1/usernames/users",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'POST',
+  path: '/v1/usernames/users',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     body: {},
   },
   parameters: {},
   body: Roblox_Users_Api_MultiGetByUsernameRequest,
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Users_Api_MultiGetUserByNameResponse_,
+  response: Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Users_Api_MultiGetUserByNameResponse_,
   errors: [
     {
       status: 400,
@@ -351,17 +350,16 @@ export const postUsernamesUsers = endpoint({
  * @description Does not require X-CSRF-Token protection because this is essentially a get request but as a POST to avoid URI limits.
  */
 export const postUsers = endpoint({
-  method: "POST",
-  path: "/v1/users",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'POST',
+  path: '/v1/users',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     body: {},
   },
   parameters: {},
   body: Roblox_Users_Api_MultiGetByUserIdRequest,
-  response:
-    Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Users_Api_MultiGetUserResponse_,
+  response: Roblox_Web_WebAPI_Models_ApiArrayResponse_Roblox_Users_Api_MultiGetUserResponse_,
   errors: [
     {
       status: 400,
@@ -375,13 +373,13 @@ export const postUsers = endpoint({
  * @param userId The user id.
  */
 export const getUsersUserid = endpoint({
-  method: "GET",
-  path: "/v1/users/:userId",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/users/:userId',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     userId: {
-      style: "simple",
+      style: 'simple',
     },
   },
   parameters: {
@@ -402,14 +400,14 @@ export const getUsersUserid = endpoint({
  * @param userId the user id
  */
 export const patchUsersUseridDisplayNames = endpoint({
-  method: "PATCH",
-  path: "/v1/users/:userId/display-names",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'PATCH',
+  path: '/v1/users/:userId/display-names',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     body: {},
     userId: {
-      style: "simple",
+      style: 'simple',
     },
   },
   parameters: {
@@ -448,16 +446,16 @@ export const patchUsersUseridDisplayNames = endpoint({
  * @param displayName The display name.
  */
 export const getUsersUseridDisplayNamesValidate = endpoint({
-  method: "GET",
-  path: "/v1/users/:userId/display-names/validate",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/users/:userId/display-names/validate',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     userId: {
-      style: "simple",
+      style: 'simple',
     },
     displayName: {
-      style: "form",
+      style: 'form',
       explode: true,
     },
   },
@@ -498,24 +496,24 @@ export const getUsersUseridDisplayNamesValidate = endpoint({
  * @param sortOrder The order the results are sorted in.
  */
 export const getUsersUseridUsernameHistory = endpoint({
-  method: "GET",
-  path: "/v1/users/:userId/username-history",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/users/:userId/username-history',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     userId: {
-      style: "simple",
+      style: 'simple',
     },
     limit: {
-      style: "form",
+      style: 'form',
       explode: true,
     },
     cursor: {
-      style: "form",
+      style: 'form',
       explode: true,
     },
     sortOrder: {
-      style: "form",
+      style: 'form',
       explode: true,
     },
   },
@@ -526,10 +524,9 @@ export const getUsersUseridUsernameHistory = endpoint({
       .optional()
       .default(10),
     cursor: z.string().optional(),
-    sortOrder: z.enum(["Asc", "Desc"]).optional().default("Asc"),
+    sortOrder: z.enum(['Asc', 'Desc']).optional().default('Asc'),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiPageResponse_Roblox_Users_Api_UsernameHistoryResponse_,
+  response: Roblox_Web_WebAPI_Models_ApiPageResponse_Roblox_Users_Api_UsernameHistoryResponse_,
   errors: [
     {
       status: 400,
@@ -542,10 +539,10 @@ export const getUsersUseridUsernameHistory = endpoint({
  * @summary Gets the minimal authenticated user.
  */
 export const getUsersAuthenticated = endpoint({
-  method: "GET",
-  path: "/v1/users/authenticated",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/users/authenticated',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   response: Roblox_Users_Api_AuthenticatedGetUserResponse,
   errors: [
     {
@@ -559,10 +556,10 @@ export const getUsersAuthenticated = endpoint({
  * @summary Gets the age bracket of the authenticated user.
  */
 export const getUsersAuthenticatedAgeBracket = endpoint({
-  method: "GET",
-  path: "/v1/users/authenticated/age-bracket",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/users/authenticated/age-bracket',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   response: z.object({ ageBracket: z.number().int() }),
   errors: [
     {
@@ -576,10 +573,10 @@ export const getUsersAuthenticatedAgeBracket = endpoint({
  * @summary Gets the country code of the authenticated user.
  */
 export const getUsersAuthenticatedCountryCode = endpoint({
-  method: "GET",
-  path: "/v1/users/authenticated/country-code",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/users/authenticated/country-code',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   response: z.object({ countryCode: z.string() }),
   errors: [
     {
@@ -593,10 +590,10 @@ export const getUsersAuthenticatedCountryCode = endpoint({
  * @summary Gets the (public) roles of the authenticated user, such as `"Soothsayer"` and `"BetaTester"`.
  */
 export const getUsersAuthenticatedRoles = endpoint({
-  method: "GET",
-  path: "/v1/users/authenticated/roles",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/users/authenticated/roles',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   response: Roblox_Users_Api_UserRolesResponse,
   errors: [
     {
@@ -614,25 +611,25 @@ export const getUsersAuthenticatedRoles = endpoint({
  * @param cursor The paging cursor for the previous or next page.
  */
 export const getUsersSearch = endpoint({
-  method: "GET",
-  path: "/v1/users/search",
-  baseUrl: "https://users.roblox.com",
-  requestFormat: "json",
+  method: 'GET',
+  path: '/v1/users/search',
+  baseUrl: 'https://users.roblox.com',
+  requestFormat: 'json',
   serializationMethod: {
     keyword: {
-      style: "form",
+      style: 'form',
       explode: true,
     },
     sessionId: {
-      style: "form",
+      style: 'form',
       explode: true,
     },
     limit: {
-      style: "form",
+      style: 'form',
       explode: true,
     },
     cursor: {
-      style: "form",
+      style: 'form',
       explode: true,
     },
   },
@@ -645,8 +642,7 @@ export const getUsersSearch = endpoint({
       .default(10),
     cursor: z.string().optional(),
   },
-  response:
-    Roblox_Web_WebAPI_Models_ApiPageResponse_Roblox_Users_Api_SearchGetUserResponse_,
+  response: Roblox_Web_WebAPI_Models_ApiPageResponse_Roblox_Users_Api_SearchGetUserResponse_,
   errors: [
     {
       status: 400,

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;
@@ -71,7 +79,38 @@ type CacheOptions = {
 type RequestOptions<R = boolean> = RequestInit & RetryOptions & ErrorOptions & CacheOptions & {
     returnRaw?: R;
 };
-export declare const hbaClient: HBAClient;
+type TokenMetadata = Awaited<ReturnType<HBAClient['getTokenMetadata']>>;
+/**
+ * HBAClient hardened for server (Node/Bun) usage:
+ *
+ * - `generateBaseHeaders` short-circuits when no crypto key source exists
+ *   (no supplied key pair and no IndexedDB): a BAT can never be signed, so
+ *   the token metadata page must not be fetched at all.
+ * - `getTokenMetadata` remembers failed lookups for a TTL. The base class
+ *   only caches successes, so an unparseable metadata page (e.g. a bot
+ *   challenge served to a datacenter IP) would otherwise be refetched on
+ *   every request — unbounded network and memory churn on hot paths.
+ * - The metadata page fetch is bounded by a timeout and sent with the
+ *   configured server user agent instead of the runtime default, which is
+ *   far more likely to receive a challenge page.
+ */
+declare class ServerSafeHBAClient extends HBAClient {
+    private metadataFailureAt;
+    private metadataInFlight?;
+    private readonly metadataSource?;
+    constructor(props?: ConstructorParameters<typeof HBAClient>[0] & {
+        metadataSource?: ServerSafeHBAClient;
+    });
+    /**
+     * Forget a remembered metadata failure so the next lookup retries
+     * immediately. Called when HBA keys are (re)configured — a lookup that
+     * failed under the old configuration says nothing about the new one.
+     */
+    resetMetadataFailure(): void;
+    generateBaseHeaders(requestUrl: string | URL, requestMethod?: string, includeCredentials?: boolean, body?: unknown): Promise<Record<string, string>>;
+    getTokenMetadata(uncached?: boolean): Promise<TokenMetadata>;
+}
+export declare const hbaClient: ServerSafeHBAClient;
 export type PoolRotation = 'none' | 'random' | 'round-robin';
 /**
  * Event data passed to the cookie refresh callback when Roblox rotates a cookie.
@@ -157,6 +196,26 @@ export type ServerConfig = {
      * ```
      */
     onCookieRefresh?: CookieRefreshCallback;
+    /**
+     * ECDSA P-256 key pair(s) used to sign hardware-backed auth (BAT) tokens.
+     * Keys are bound to a session: Roblox validates signatures against the
+     * public key registered when the cookie's session was authenticated, so a
+     * freshly generated pair produces invalid tokens. Without keys, BAT
+     * generation is skipped entirely on the server (there is no IndexedDB to
+     * load browser-registered keys from).
+     *
+     * Pass an array to bind keys per cookie: entries align index-for-index
+     * with the `cookies` array (lengths must match), and `null` entries mark
+     * cookies whose sessions have no registered key — those requests send no
+     * BAT. A single (non-array) pair applies to all requests and is only
+     * sensible with a single cookie.
+     *
+     * Per-cookie keys are bound to the `cookies` array passed in the same
+     * call: a later `configureServer` call that omits `hbaKeys` drops them
+     * (requests then send no BAT). Re-pass the array together with the
+     * cookies whenever you reconfigure.
+     */
+    hbaKeys?: CryptoKeyPair | Array<CryptoKeyPair | null>;
 };
 /**
  * Configures RoZod for server/Node.js environments.
@@ -288,6 +347,10 @@ export declare function setHandleGenericChallenge(fn: typeof handleGenericChalle
 /**
  * Allows you to change the Crypto Key pair used by the internal hardware-based authentication signatures. This should only be used in a NodeJS context.
  *
+ * The pair applies to every request: any per-cookie keys configured via
+ * `configureServer({ hbaKeys: [...] })` are discarded. To key individual
+ * cookies in a pool, use `configureServer` instead.
+ *
  * @param keys The crypto key pair.
  */
 export declare function changeHBAKeys(keys?: CryptoKeyPair): void;
@@ -386,4 +449,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, };