@unkey/api/src/models/errors/toomanyrequestserrorresponse.ts

Developer-friendly & type-safe Typescript SDK specifically catered to leverage *@unkey/api* API.

/*
 * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
 */

import * as z from "zod/v3";
import * as components from "../components/index.js";
import { UnkeyError } from "./unkeyerror.js";

/**
 * Error response when the client has sent too many requests in a given time period. This occurs when you've exceeded a rate limit or quota for the resource you're accessing.
 *
 * @remarks
 *
 * The rate limit resets automatically after the time window expires. To avoid this error:
 * - Implement exponential backoff when retrying requests
 * - Cache results where appropriate to reduce request frequency
 * - Check the error detail message for specific quota information
 * - Contact support if you need a higher quota for your use case
 */
export type TooManyRequestsErrorResponseData = {
  /**
   * Metadata object included in every API response. This provides context about the request and is essential for debugging, audit trails, and support inquiries. The `requestId` is particularly important when troubleshooting issues with the Unkey support team.
   */
  meta: components.Meta;
  /**
   * Base error structure following Problem Details for HTTP APIs (RFC 7807). This provides a standardized way to carry machine-readable details of errors in HTTP response content.
   */
  error: components.BaseError;
};

/**
 * Error response when the client has sent too many requests in a given time period. This occurs when you've exceeded a rate limit or quota for the resource you're accessing.
 *
 * @remarks
 *
 * The rate limit resets automatically after the time window expires. To avoid this error:
 * - Implement exponential backoff when retrying requests
 * - Cache results where appropriate to reduce request frequency
 * - Check the error detail message for specific quota information
 * - Contact support if you need a higher quota for your use case
 */
export class TooManyRequestsErrorResponse extends UnkeyError {
  /**
   * Metadata object included in every API response. This provides context about the request and is essential for debugging, audit trails, and support inquiries. The `requestId` is particularly important when troubleshooting issues with the Unkey support team.
   */
  meta: components.Meta;
  /**
   * Base error structure following Problem Details for HTTP APIs (RFC 7807). This provides a standardized way to carry machine-readable details of errors in HTTP response content.
   */
  error: components.BaseError;

  /** The original data that was passed to this error instance. */
  data$: TooManyRequestsErrorResponseData;

  constructor(
    err: TooManyRequestsErrorResponseData,
    httpMeta: { response: Response; request: Request; body: string },
  ) {
    const message = "message" in err && typeof err.message === "string"
      ? err.message
      : `API error occurred: ${JSON.stringify(err)}`;
    super(message, httpMeta);
    this.data$ = err;
    this.meta = err.meta;
    this.error = err.error;

    this.name = "TooManyRequestsErrorResponse";
  }
}

/** @internal */
export const TooManyRequestsErrorResponse$inboundSchema: z.ZodType<
  TooManyRequestsErrorResponse,
  z.ZodTypeDef,
  unknown
> = z.object({
  meta: components.Meta$inboundSchema,
  error: components.BaseError$inboundSchema,
  request$: z.instanceof(Request),
  response$: z.instanceof(Response),
  body$: z.string(),
})
  .transform((v) => {
    return new TooManyRequestsErrorResponse(v, {
      request: v.request$,
      response: v.response$,
      body: v.body$,
    });
  });