feat(api): manual updates

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-0470196862abd722b09f1af798d6f2bcbdeba0f82d1162f57c287b1a43233531.yml
 openapi_spec_hash: 043dd7c67d741d0034b86f2fc0bce072
-config_hash: 70f9408b8d1dfbcf262a20d6eed50e1c
+config_hash: da949a1217f48ac01676eab81ca9d1b1

api.md

@@ -3,6 +3,7 @@
 ```python
 from imagekit.types import (
     BaseOverlay,
+    Extensions,
     ImageOverlay,
     Overlay,
     OverlayPosition,

src/imagekit/resources/beta/v2/files.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Mapping, Iterable, cast
+from typing import Dict, List, Mapping, cast
 from typing_extensions import Literal
 
 import httpx
@@ -19,6 +19,7 @@
 )
 from ...._base_client import make_request_options
 from ....types.beta.v2 import file_upload_params
+from ....types.shared_params.extensions import Extensions
 from ....types.beta.v2.file_upload_response import FileUploadResponse
 
 __all__ = ["FilesResource", "AsyncFilesResource"]
@@ -54,7 +55,7 @@ def upload(
         custom_coordinates: str | NotGiven = NOT_GIVEN,
         custom_metadata: Dict[str, object] | NotGiven = NOT_GIVEN,
         description: str | NotGiven = NOT_GIVEN,
-        extensions: Iterable[file_upload_params.Extension] | NotGiven = NOT_GIVEN,
+        extensions: Extensions | NotGiven = NOT_GIVEN,
         folder: str | NotGiven = NOT_GIVEN,
         is_private_file: bool | NotGiven = NOT_GIVEN,
         is_published: bool | NotGiven = NOT_GIVEN,
@@ -306,7 +307,7 @@ async def upload(
         custom_coordinates: str | NotGiven = NOT_GIVEN,
         custom_metadata: Dict[str, object] | NotGiven = NOT_GIVEN,
         description: str | NotGiven = NOT_GIVEN,
-        extensions: Iterable[file_upload_params.Extension] | NotGiven = NOT_GIVEN,
+        extensions: Extensions | NotGiven = NOT_GIVEN,
         folder: str | NotGiven = NOT_GIVEN,
         is_private_file: bool | NotGiven = NOT_GIVEN,
         is_published: bool | NotGiven = NOT_GIVEN,

src/imagekit/resources/files/files.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Mapping, Iterable, cast
+from typing import Dict, List, Mapping, cast
 from typing_extensions import Literal
 
 import httpx
@@ -15,7 +15,13 @@
     BulkResourceWithStreamingResponse,
     AsyncBulkResourceWithStreamingResponse,
 )
-from ...types import file_copy_params, file_move_params, file_rename_params, file_update_params, file_upload_params
+from ...types import (
+    file_copy_params,
+    file_move_params,
+    file_rename_params,
+    file_update_params,
+    file_upload_params,
+)
 from ..._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven, FileTypes, SequenceNotStr
 from ..._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
 from .metadata import (
@@ -49,6 +55,7 @@
 from ...types.file_rename_response import FileRenameResponse
 from ...types.file_update_response import FileUpdateResponse
 from ...types.file_upload_response import FileUploadResponse
+from ...types.shared_params.extensions import Extensions
 
 __all__ = ["FilesResource", "AsyncFilesResource"]
 
@@ -376,7 +383,7 @@ def upload(
         custom_metadata: Dict[str, object] | NotGiven = NOT_GIVEN,
         description: str | NotGiven = NOT_GIVEN,
         expire: int | NotGiven = NOT_GIVEN,
-        extensions: Iterable[file_upload_params.Extension] | NotGiven = NOT_GIVEN,
+        extensions: Extensions | NotGiven = NOT_GIVEN,
         folder: str | NotGiven = NOT_GIVEN,
         is_private_file: bool | NotGiven = NOT_GIVEN,
         is_published: bool | NotGiven = NOT_GIVEN,
@@ -947,7 +954,7 @@ async def upload(
         custom_metadata: Dict[str, object] | NotGiven = NOT_GIVEN,
         description: str | NotGiven = NOT_GIVEN,
         expire: int | NotGiven = NOT_GIVEN,
-        extensions: Iterable[file_upload_params.Extension] | NotGiven = NOT_GIVEN,
+        extensions: Extensions | NotGiven = NOT_GIVEN,
         folder: str | NotGiven = NOT_GIVEN,
         is_private_file: bool | NotGiven = NOT_GIVEN,
         is_published: bool | NotGiven = NOT_GIVEN,

src/imagekit/types/__init__.py

@@ -8,6 +8,7 @@
 from .folder import Folder as Folder
 from .shared import (
     Overlay as Overlay,
+    Extensions as Extensions,
     SrcOptions as SrcOptions,
     BaseOverlay as BaseOverlay,
     TextOverlay as TextOverlay,

src/imagekit/types/beta/v2/file_upload_params.py

@@ -7,14 +7,10 @@
 
 from ...._types import FileTypes, SequenceNotStr
 from ...._utils import PropertyInfo
+from ...shared_params.extensions import Extensions
 
 __all__ = [
     "FileUploadParams",
-    "Extension",
-    "ExtensionRemoveBg",
-    "ExtensionRemoveBgOptions",
-    "ExtensionAutoTaggingExtension",
-    "ExtensionAIAutoDescription",
     "Transformation",
     "TransformationPost",
     "TransformationPostTransformation",
@@ -85,7 +81,7 @@ class FileUploadParams(TypedDict, total=False):
     description: str
     """Optional text to describe the contents of the file."""
 
-    extensions: Iterable[Extension]
+    extensions: Extensions
     """Array of extensions to be applied to the asset.
 
     Each extension can be configured with specific parameters based on the extension
@@ -198,61 +194,6 @@ class FileUploadParams(TypedDict, total=False):
     """
 
 
-class ExtensionRemoveBgOptions(TypedDict, total=False):
-    add_shadow: bool
-    """Whether to add an artificial shadow to the result.
-
-    Default is false. Note: Adding shadows is currently only supported for car
-    photos.
-    """
-
-    bg_color: str
-    """
-    Specifies a solid color background using hex code (e.g., "81d4fa", "fff") or
-    color name (e.g., "green"). If this parameter is set, `bg_image_url` must be
-    empty.
-    """
-
-    bg_image_url: str
-    """Sets a background image from a URL.
-
-    If this parameter is set, `bg_color` must be empty.
-    """
-
-    semitransparency: bool
-    """Allows semi-transparent regions in the result.
-
-    Default is true. Note: Semitransparency is currently only supported for car
-    windows.
-    """
-
-
-class ExtensionRemoveBg(TypedDict, total=False):
-    name: Required[Literal["remove-bg"]]
-    """Specifies the background removal extension."""
-
-    options: ExtensionRemoveBgOptions
-
-
-class ExtensionAutoTaggingExtension(TypedDict, total=False):
-    max_tags: Required[Annotated[int, PropertyInfo(alias="maxTags")]]
-    """Maximum number of tags to attach to the asset."""
-
-    min_confidence: Required[Annotated[int, PropertyInfo(alias="minConfidence")]]
-    """Minimum confidence level for tags to be considered valid."""
-
-    name: Required[Literal["google-auto-tagging", "aws-auto-tagging"]]
-    """Specifies the auto-tagging extension used."""
-
-
-class ExtensionAIAutoDescription(TypedDict, total=False):
-    name: Required[Literal["ai-auto-description"]]
-    """Specifies the auto description extension."""
-
-
-Extension: TypeAlias = Union[ExtensionRemoveBg, ExtensionAutoTaggingExtension, ExtensionAIAutoDescription]
-
-
 class TransformationPostTransformation(TypedDict, total=False):
     type: Required[Literal["transformation"]]
     """Transformation type."""

src/imagekit/types/file_update_params.py

@@ -2,21 +2,17 @@
 
 from __future__ import annotations
 
-from typing import Dict, Union, Iterable, Optional
+from typing import Dict, Union, Optional
 from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
 from .._types import SequenceNotStr
 from .._utils import PropertyInfo
+from .shared_params.extensions import Extensions
 
 __all__ = [
     "FileUpdateParams",
     "Update",
     "UpdateUpdateFileDetails",
-    "UpdateUpdateFileDetailsExtension",
-    "UpdateUpdateFileDetailsExtensionRemoveBg",
-    "UpdateUpdateFileDetailsExtensionRemoveBgOptions",
-    "UpdateUpdateFileDetailsExtensionAutoTaggingExtension",
-    "UpdateUpdateFileDetailsExtensionAIAutoDescription",
     "UpdateChangePublicationStatus",
     "UpdateChangePublicationStatusPublish",
 ]
@@ -26,65 +22,6 @@ class FileUpdateParams(TypedDict, total=False):
     update: Update
 
 
-class UpdateUpdateFileDetailsExtensionRemoveBgOptions(TypedDict, total=False):
-    add_shadow: bool
-    """Whether to add an artificial shadow to the result.
-
-    Default is false. Note: Adding shadows is currently only supported for car
-    photos.
-    """
-
-    bg_color: str
-    """
-    Specifies a solid color background using hex code (e.g., "81d4fa", "fff") or
-    color name (e.g., "green"). If this parameter is set, `bg_image_url` must be
-    empty.
-    """
-
-    bg_image_url: str
-    """Sets a background image from a URL.
-
-    If this parameter is set, `bg_color` must be empty.
-    """
-
-    semitransparency: bool
-    """Allows semi-transparent regions in the result.
-
-    Default is true. Note: Semitransparency is currently only supported for car
-    windows.
-    """
-
-
-class UpdateUpdateFileDetailsExtensionRemoveBg(TypedDict, total=False):
-    name: Required[Literal["remove-bg"]]
-    """Specifies the background removal extension."""
-
-    options: UpdateUpdateFileDetailsExtensionRemoveBgOptions
-
-
-class UpdateUpdateFileDetailsExtensionAutoTaggingExtension(TypedDict, total=False):
-    max_tags: Required[Annotated[int, PropertyInfo(alias="maxTags")]]
-    """Maximum number of tags to attach to the asset."""
-
-    min_confidence: Required[Annotated[int, PropertyInfo(alias="minConfidence")]]
-    """Minimum confidence level for tags to be considered valid."""
-
-    name: Required[Literal["google-auto-tagging", "aws-auto-tagging"]]
-    """Specifies the auto-tagging extension used."""
-
-
-class UpdateUpdateFileDetailsExtensionAIAutoDescription(TypedDict, total=False):
-    name: Required[Literal["ai-auto-description"]]
-    """Specifies the auto description extension."""
-
-
-UpdateUpdateFileDetailsExtension: TypeAlias = Union[
-    UpdateUpdateFileDetailsExtensionRemoveBg,
-    UpdateUpdateFileDetailsExtensionAutoTaggingExtension,
-    UpdateUpdateFileDetailsExtensionAIAutoDescription,
-]
-
-
 class UpdateUpdateFileDetails(TypedDict, total=False):
     custom_coordinates: Annotated[Optional[str], PropertyInfo(alias="customCoordinates")]
     """Define an important area in the image in the format `x,y,width,height` e.g.
@@ -103,7 +40,7 @@ class UpdateUpdateFileDetails(TypedDict, total=False):
     description: str
     """Optional text to describe the contents of the file."""
 
-    extensions: Iterable[UpdateUpdateFileDetailsExtension]
+    extensions: Extensions
     """Array of extensions to be applied to the asset.
 
     Each extension can be configured with specific parameters based on the extension

src/imagekit/types/file_upload_params.py

@@ -7,14 +7,10 @@
 
 from .._types import FileTypes, SequenceNotStr
 from .._utils import PropertyInfo
+from .shared_params.extensions import Extensions
 
 __all__ = [
     "FileUploadParams",
-    "Extension",
-    "ExtensionRemoveBg",
-    "ExtensionRemoveBgOptions",
-    "ExtensionAutoTaggingExtension",
-    "ExtensionAIAutoDescription",
     "Transformation",
     "TransformationPost",
     "TransformationPostTransformation",
@@ -94,7 +90,7 @@ class FileUploadParams(TypedDict, total=False):
     authentication when uploading a file from the client side.
     """
 
-    extensions: Iterable[Extension]
+    extensions: Extensions
     """Array of extensions to be applied to the asset.
 
     Each extension can be configured with specific parameters based on the extension
@@ -230,61 +226,6 @@ class FileUploadParams(TypedDict, total=False):
     """
 
 
-class ExtensionRemoveBgOptions(TypedDict, total=False):
-    add_shadow: bool
-    """Whether to add an artificial shadow to the result.
-
-    Default is false. Note: Adding shadows is currently only supported for car
-    photos.
-    """
-
-    bg_color: str
-    """
-    Specifies a solid color background using hex code (e.g., "81d4fa", "fff") or
-    color name (e.g., "green"). If this parameter is set, `bg_image_url` must be
-    empty.
-    """
-
-    bg_image_url: str
-    """Sets a background image from a URL.
-
-    If this parameter is set, `bg_color` must be empty.
-    """
-
-    semitransparency: bool
-    """Allows semi-transparent regions in the result.
-
-    Default is true. Note: Semitransparency is currently only supported for car
-    windows.
-    """
-
-
-class ExtensionRemoveBg(TypedDict, total=False):
-    name: Required[Literal["remove-bg"]]
-    """Specifies the background removal extension."""
-
-    options: ExtensionRemoveBgOptions
-
-
-class ExtensionAutoTaggingExtension(TypedDict, total=False):
-    max_tags: Required[Annotated[int, PropertyInfo(alias="maxTags")]]
-    """Maximum number of tags to attach to the asset."""
-
-    min_confidence: Required[Annotated[int, PropertyInfo(alias="minConfidence")]]
-    """Minimum confidence level for tags to be considered valid."""
-
-    name: Required[Literal["google-auto-tagging", "aws-auto-tagging"]]
-    """Specifies the auto-tagging extension used."""
-
-
-class ExtensionAIAutoDescription(TypedDict, total=False):
-    name: Required[Literal["ai-auto-description"]]
-    """Specifies the auto description extension."""
-
-
-Extension: TypeAlias = Union[ExtensionRemoveBg, ExtensionAutoTaggingExtension, ExtensionAIAutoDescription]
-
-
 class TransformationPostTransformation(TypedDict, total=False):
     type: Required[Literal["transformation"]]
     """Transformation type."""

src/imagekit/types/shared/__init__.py

@@ -1,6 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from .overlay import Overlay as Overlay
+from .extensions import Extensions as Extensions
 from .src_options import SrcOptions as SrcOptions
 from .base_overlay import BaseOverlay as BaseOverlay
 from .text_overlay import TextOverlay as TextOverlay