feat(api): add GetImageAttributesOptions and ResponsiveImageAttributes schemas; update resource references in main.yaml; remove dummy endpoint

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 42
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-c7ad6f552b38f2145781847f8b390fa1ec43068d64e45a33012a97a9299edc10.yml
-openapi_spec_hash: 50f281e91210ad5018ac7e4eee216f56
-config_hash: 74a8263b80c732a2b016177e7d56bb9c
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-0e4fa3c1f9d8cafecb9671fa76c0ff9156c643e05837804679e5e336bad8f4c1.yml
+openapi_spec_hash: 4544b950730b721c252eb519358b8609
+config_hash: 3d7a0bc2844e9fb4797149b233e85770

api.md

@@ -4,10 +4,12 @@ Types:
 
 - <code><a href="./src/resources/shared.ts">BaseOverlay</a></code>
 - <code><a href="./src/resources/shared.ts">Extensions</a></code>
+- <code><a href="./src/resources/shared.ts">GetImageAttributesOptions</a></code>
 - <code><a href="./src/resources/shared.ts">ImageOverlay</a></code>
 - <code><a href="./src/resources/shared.ts">Overlay</a></code>
 - <code><a href="./src/resources/shared.ts">OverlayPosition</a></code>
 - <code><a href="./src/resources/shared.ts">OverlayTiming</a></code>
+- <code><a href="./src/resources/shared.ts">ResponsiveImageAttributes</a></code>
 - <code><a href="./src/resources/shared.ts">SolidColorOverlay</a></code>
 - <code><a href="./src/resources/shared.ts">SolidColorOverlayTransformation</a></code>
 - <code><a href="./src/resources/shared.ts">SrcOptions</a></code>

src/client.ts

@@ -911,10 +911,12 @@ export declare namespace ImageKit {
 
   export type BaseOverlay = API.BaseOverlay;
   export type Extensions = API.Extensions;
+  export type GetImageAttributesOptions = API.GetImageAttributesOptions;
   export type ImageOverlay = API.ImageOverlay;
   export type Overlay = API.Overlay;
   export type OverlayPosition = API.OverlayPosition;
   export type OverlayTiming = API.OverlayTiming;
+  export type ResponsiveImageAttributes = API.ResponsiveImageAttributes;
   export type SolidColorOverlay = API.SolidColorOverlay;
   export type SolidColorOverlayTransformation = API.SolidColorOverlayTransformation;
   export type SrcOptions = API.SrcOptions;

src/resources/shared.ts

@@ -78,6 +78,54 @@ export namespace Extensions {
   }
 }
 
+/**
+ * Options for generating responsive image attributes including `src`, `srcSet`,
+ * and `sizes` for HTML `<img>` elements. This schema extends `SrcOptions` to add
+ * support for responsive image generation with breakpoints.
+ */
+export interface GetImageAttributesOptions extends SrcOptions {
+  /**
+   * Custom list of **device-width breakpoints** in pixels. These define common
+   * screen widths for responsive image generation.
+   *
+   * Defaults to `[640, 750, 828, 1080, 1200, 1920, 2048, 3840]`. Sorted
+   * automatically.
+   */
+  deviceBreakpoints?: Array<number>;
+
+  /**
+   * Custom list of **image-specific breakpoints** in pixels. Useful for generating
+   * small variants (e.g., placeholders or thumbnails).
+   *
+   * Merged with `deviceBreakpoints` before calculating `srcSet`. Defaults to
+   * `[16, 32, 48, 64, 96, 128, 256, 384]`. Sorted automatically.
+   */
+  imageBreakpoints?: Array<number>;
+
+  /**
+   * The value for the HTML `sizes` attribute (e.g., `"100vw"` or
+   * `"(min-width:768px) 50vw, 100vw"`).
+   *
+   * - If it includes one or more `vw` units, breakpoints smaller than the
+   *   corresponding percentage of the smallest device width are excluded.
+   * - If it contains no `vw` units, the full breakpoint list is used.
+   *
+   * Enables a width-based strategy and generates `w` descriptors in `srcSet`.
+   */
+  sizes?: string;
+
+  /**
+   * The intended display width of the image in pixels, used **only when the `sizes`
+   * attribute is not provided**.
+   *
+   * Triggers a DPR-based strategy (1x and 2x variants) and generates `x` descriptors
+   * in `srcSet`.
+   *
+   * Ignored if `sizes` is present.
+   */
+  width?: number;
+}
+
 export interface ImageOverlay extends BaseOverlay {
   /**
    * Specifies the relative path to the image used as an overlay.
@@ -175,6 +223,34 @@ export interface OverlayTiming {
   start?: number | string;
 }
 
+/**
+ * Resulting set of attributes suitable for an HTML `<img>` element. Useful for
+ * enabling responsive image loading with `srcSet` and `sizes`.
+ */
+export interface ResponsiveImageAttributes {
+  /**
+   * URL for the _largest_ candidate (assigned to plain `src`).
+   */
+  src: string;
+
+  /**
+   * `sizes` returned (or synthesised as `100vw`). The value for the HTML `sizes`
+   * attribute.
+   */
+  sizes?: string;
+
+  /**
+   * Candidate set with `w` or `x` descriptors. Multiple image URLs separated by
+   * commas, each with a descriptor.
+   */
+  srcSet?: string;
+
+  /**
+   * Width as a number (if `width` was provided in the input options).
+   */
+  width?: number;
+}
+
 export interface SolidColorOverlay extends BaseOverlay {
   /**
    * Specifies the color of the block using an RGB hex code (e.g., `FF0000`), an RGBA