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

aliases.go

@@ -5,6 +5,7 @@ package imagekit
 import (
 	"github.com/imagekit-developer/imagekit-go/internal/apierror"
 	"github.com/imagekit-developer/imagekit-go/packages/param"
+	"github.com/imagekit-developer/imagekit-go/shared"
 )
 
 // aliased to make [param.APIUnion] private when embedding
@@ -14,3 +15,24 @@ type paramUnion = param.APIUnion
 type paramObj = param.APIObject
 
 type Error = apierror.Error
+
+// Array of extensions to be applied to the asset. Each extension can be configured
+// with specific parameters based on the extension type.
+//
+// This is an alias to an internal type.
+type ExtensionsParam = shared.ExtensionsParam
+
+// This is an alias to an internal type.
+type ExtensionUnionParam = shared.ExtensionUnionParam
+
+// This is an alias to an internal type.
+type ExtensionRemoveBgParam = shared.ExtensionRemoveBgParam
+
+// This is an alias to an internal type.
+type ExtensionRemoveBgOptionsParam = shared.ExtensionRemoveBgOptionsParam
+
+// This is an alias to an internal type.
+type ExtensionAutoTaggingParam = shared.ExtensionAutoTaggingParam
+
+// This is an alias to an internal type.
+type ExtensionAIAutoDescriptionParam = shared.ExtensionAIAutoDescriptionParam

api.md

@@ -1,3 +1,7 @@
+# Shared Params Types
+
+- <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/shared#ExtensionsParam">ExtensionsParam</a>
+
 # CustomMetadataFields
 
 Response Types:

betav2file.go

@@ -15,6 +15,7 @@ import (
 	"github.com/imagekit-developer/imagekit-go/option"
 	"github.com/imagekit-developer/imagekit-go/packages/param"
 	"github.com/imagekit-developer/imagekit-go/packages/respjson"
+	"github.com/imagekit-developer/imagekit-go/shared"
 	"github.com/imagekit-developer/imagekit-go/shared/constant"
 )
 
@@ -357,7 +358,7 @@ type BetaV2FileUploadParams struct {
 	CustomMetadata map[string]any `json:"customMetadata,omitzero"`
 	// Array of extensions to be applied to the asset. Each extension can be configured
 	// with specific parameters based on the extension type.
-	Extensions []BetaV2FileUploadParamsExtensionUnion `json:"extensions,omitzero"`
+	Extensions shared.ExtensionsParam `json:"extensions,omitzero"`
 	// Array of response field keys to include in the API response body.
 	//
 	// Any of "tags", "customCoordinates", "isPrivateFile", "embeddedMetadata",
@@ -401,172 +402,6 @@ func (r BetaV2FileUploadParams) MarshalMultipart() (data []byte, contentType str
 	return buf.Bytes(), writer.FormDataContentType(), nil
 }
 
-// Only one field can be non-zero.
-//
-// Use [param.IsOmitted] to confirm if a field is set.
-type BetaV2FileUploadParamsExtensionUnion struct {
-	OfRemoveBg          *BetaV2FileUploadParamsExtensionRemoveBg          `json:",omitzero,inline"`
-	OfAutoTagging       *BetaV2FileUploadParamsExtensionAutoTagging       `json:",omitzero,inline"`
-	OfAIAutoDescription *BetaV2FileUploadParamsExtensionAIAutoDescription `json:",omitzero,inline"`
-	paramUnion
-}
-
-func (u BetaV2FileUploadParamsExtensionUnion) MarshalJSON() ([]byte, error) {
-	return param.MarshalUnion(u, u.OfRemoveBg, u.OfAutoTagging, u.OfAIAutoDescription)
-}
-func (u *BetaV2FileUploadParamsExtensionUnion) UnmarshalJSON(data []byte) error {
-	return apijson.UnmarshalRoot(data, u)
-}
-
-func (u *BetaV2FileUploadParamsExtensionUnion) asAny() any {
-	if !param.IsOmitted(u.OfRemoveBg) {
-		return u.OfRemoveBg
-	} else if !param.IsOmitted(u.OfAutoTagging) {
-		return u.OfAutoTagging
-	} else if !param.IsOmitted(u.OfAIAutoDescription) {
-		return u.OfAIAutoDescription
-	}
-	return nil
-}
-
-// Returns a pointer to the underlying variant's property, if present.
-func (u BetaV2FileUploadParamsExtensionUnion) GetOptions() *BetaV2FileUploadParamsExtensionRemoveBgOptions {
-	if vt := u.OfRemoveBg; vt != nil {
-		return &vt.Options
-	}
-	return nil
-}
-
-// Returns a pointer to the underlying variant's property, if present.
-func (u BetaV2FileUploadParamsExtensionUnion) GetMaxTags() *int64 {
-	if vt := u.OfAutoTagging; vt != nil {
-		return &vt.MaxTags
-	}
-	return nil
-}
-
-// Returns a pointer to the underlying variant's property, if present.
-func (u BetaV2FileUploadParamsExtensionUnion) GetMinConfidence() *int64 {
-	if vt := u.OfAutoTagging; vt != nil {
-		return &vt.MinConfidence
-	}
-	return nil
-}
-
-// Returns a pointer to the underlying variant's property, if present.
-func (u BetaV2FileUploadParamsExtensionUnion) GetName() *string {
-	if vt := u.OfRemoveBg; vt != nil {
-		return (*string)(&vt.Name)
-	} else if vt := u.OfAutoTagging; vt != nil {
-		return (*string)(&vt.Name)
-	} else if vt := u.OfAIAutoDescription; vt != nil {
-		return (*string)(&vt.Name)
-	}
-	return nil
-}
-
-func init() {
-	apijson.RegisterUnion[BetaV2FileUploadParamsExtensionUnion](
-		"name",
-		apijson.Discriminator[BetaV2FileUploadParamsExtensionRemoveBg]("remove-bg"),
-		apijson.Discriminator[BetaV2FileUploadParamsExtensionAutoTagging]("google-auto-tagging"),
-		apijson.Discriminator[BetaV2FileUploadParamsExtensionAutoTagging]("aws-auto-tagging"),
-		apijson.Discriminator[BetaV2FileUploadParamsExtensionAIAutoDescription]("ai-auto-description"),
-	)
-}
-
-// The property Name is required.
-type BetaV2FileUploadParamsExtensionRemoveBg struct {
-	Options BetaV2FileUploadParamsExtensionRemoveBgOptions `json:"options,omitzero"`
-	// Specifies the background removal extension.
-	//
-	// This field can be elided, and will marshal its zero value as "remove-bg".
-	Name constant.RemoveBg `json:"name,required"`
-	paramObj
-}
-
-func (r BetaV2FileUploadParamsExtensionRemoveBg) MarshalJSON() (data []byte, err error) {
-	type shadow BetaV2FileUploadParamsExtensionRemoveBg
-	return param.MarshalObject(r, (*shadow)(&r))
-}
-func (r *BetaV2FileUploadParamsExtensionRemoveBg) UnmarshalJSON(data []byte) error {
-	return apijson.UnmarshalRoot(data, r)
-}
-
-type BetaV2FileUploadParamsExtensionRemoveBgOptions struct {
-	// Whether to add an artificial shadow to the result. Default is false. Note:
-	// Adding shadows is currently only supported for car photos.
-	AddShadow param.Opt[bool] `json:"add_shadow,omitzero"`
-	// 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.
-	BgColor param.Opt[string] `json:"bg_color,omitzero"`
-	// Sets a background image from a URL. If this parameter is set, `bg_color` must be
-	// empty.
-	BgImageURL param.Opt[string] `json:"bg_image_url,omitzero"`
-	// Allows semi-transparent regions in the result. Default is true. Note:
-	// Semitransparency is currently only supported for car windows.
-	Semitransparency param.Opt[bool] `json:"semitransparency,omitzero"`
-	paramObj
-}
-
-func (r BetaV2FileUploadParamsExtensionRemoveBgOptions) MarshalJSON() (data []byte, err error) {
-	type shadow BetaV2FileUploadParamsExtensionRemoveBgOptions
-	return param.MarshalObject(r, (*shadow)(&r))
-}
-func (r *BetaV2FileUploadParamsExtensionRemoveBgOptions) UnmarshalJSON(data []byte) error {
-	return apijson.UnmarshalRoot(data, r)
-}
-
-// The properties MaxTags, MinConfidence, Name are required.
-type BetaV2FileUploadParamsExtensionAutoTagging struct {
-	// Maximum number of tags to attach to the asset.
-	MaxTags int64 `json:"maxTags,required"`
-	// Minimum confidence level for tags to be considered valid.
-	MinConfidence int64 `json:"minConfidence,required"`
-	// Specifies the auto-tagging extension used.
-	//
-	// Any of "google-auto-tagging", "aws-auto-tagging".
-	Name string `json:"name,omitzero,required"`
-	paramObj
-}
-
-func (r BetaV2FileUploadParamsExtensionAutoTagging) MarshalJSON() (data []byte, err error) {
-	type shadow BetaV2FileUploadParamsExtensionAutoTagging
-	return param.MarshalObject(r, (*shadow)(&r))
-}
-func (r *BetaV2FileUploadParamsExtensionAutoTagging) UnmarshalJSON(data []byte) error {
-	return apijson.UnmarshalRoot(data, r)
-}
-
-func init() {
-	apijson.RegisterFieldValidator[BetaV2FileUploadParamsExtensionAutoTagging](
-		"name", "google-auto-tagging", "aws-auto-tagging",
-	)
-}
-
-func NewBetaV2FileUploadParamsExtensionAIAutoDescription() BetaV2FileUploadParamsExtensionAIAutoDescription {
-	return BetaV2FileUploadParamsExtensionAIAutoDescription{
-		Name: "ai-auto-description",
-	}
-}
-
-// This struct has a constant value, construct it with
-// [NewBetaV2FileUploadParamsExtensionAIAutoDescription].
-type BetaV2FileUploadParamsExtensionAIAutoDescription struct {
-	// Specifies the auto description extension.
-	Name constant.AIAutoDescription `json:"name,required"`
-	paramObj
-}
-
-func (r BetaV2FileUploadParamsExtensionAIAutoDescription) MarshalJSON() (data []byte, err error) {
-	type shadow BetaV2FileUploadParamsExtensionAIAutoDescription
-	return param.MarshalObject(r, (*shadow)(&r))
-}
-func (r *BetaV2FileUploadParamsExtensionAIAutoDescription) UnmarshalJSON(data []byte) error {
-	return apijson.UnmarshalRoot(data, r)
-}
-
 // Configure pre-processing (`pre`) and post-processing (`post`) transformations.
 //
 //   - `pre` — applied before the file is uploaded to the Media Library.

betav2file_test.go

@@ -13,6 +13,7 @@ import (
 	"github.com/imagekit-developer/imagekit-go"
 	"github.com/imagekit-developer/imagekit-go/internal/testutil"
 	"github.com/imagekit-developer/imagekit-go/option"
+	"github.com/imagekit-developer/imagekit-go/shared"
 )
 
 func TestBetaV2FileUploadWithOptionalParams(t *testing.T) {
@@ -40,23 +41,23 @@ func TestBetaV2FileUploadWithOptionalParams(t *testing.T) {
 			"color": "bar",
 		},
 		Description: imagekit.String("Running shoes"),
-		Extensions: []imagekit.BetaV2FileUploadParamsExtensionUnion{{
-			OfRemoveBg: &imagekit.BetaV2FileUploadParamsExtensionRemoveBg{
-				Options: imagekit.BetaV2FileUploadParamsExtensionRemoveBgOptions{
+		Extensions: shared.ExtensionsParam{shared.ExtensionUnionParam{
+			OfRemoveBg: &shared.ExtensionRemoveBgParam{
+				Options: shared.ExtensionRemoveBgOptionsParam{
 					AddShadow:        imagekit.Bool(true),
 					BgColor:          imagekit.String("bg_color"),
 					BgImageURL:       imagekit.String("bg_image_url"),
 					Semitransparency: imagekit.Bool(true),
 				},
 			},
-		}, {
-			OfAutoTagging: &imagekit.BetaV2FileUploadParamsExtensionAutoTagging{
+		}, shared.ExtensionUnionParam{
+			OfAutoTagging: &shared.ExtensionAutoTaggingParam{
 				MaxTags:       5,
 				MinConfidence: 95,
 				Name:          "google-auto-tagging",
 			},
-		}, {
-			OfAIAutoDescription: &imagekit.BetaV2FileUploadParamsExtensionAIAutoDescription{},
+		}, shared.ExtensionUnionParam{
+			OfAIAutoDescription: &shared.ExtensionAIAutoDescriptionParam{},
 		}},
 		Folder:                  imagekit.String("folder"),
 		IsPrivateFile:           imagekit.Bool(true),