Merge pull request #18 from imagekit-developer/release-please--branches--master--changes--next

release: 2.5.0

Author: imagekitio

.github/workflows/ci.yml

@@ -26,14 +26,14 @@ jobs:
       github.repository == 'stainless-sdks/imagekit-go' &&
       (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Get GitHub OIDC Token
         if: |-
           github.repository == 'stainless-sdks/imagekit-go' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v8
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -53,10 +53,10 @@ jobs:
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@40f1582b2485089dde7abd97c1529aa768e1baff # v5.6.0
         with:
           go-version-file: ./go.mod
 
@@ -68,10 +68,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/imagekit-go' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@40f1582b2485089dde7abd97c1529aa768e1baff # v5.6.0
         with:
           go-version-file: ./go.mod
 

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "2.4.0"
+  ".": "2.5.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 48
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-70c42eda2bee929830b2537f758400a58dded1f1ef5686a286e2469c35a041a0.yml
-openapi_spec_hash: cdaeed824e91657b45092765cf55eb42
-config_hash: e3c2679d25f6235381dfb11962fbf3d9
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc/imagekit-ad6dd3b4acf289708568a12574b997503059a47c4a4ca5ffefe64f40f3d3dbf3.yml
+openapi_spec_hash: 7c103e2dff0edcbeea82057e62f58d4d
+config_hash: 94f48fd13b7d41b8b6a203a3a8cee9ed

CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 2.5.0 (2026-05-13)
+
+Full Changelog: [v2.4.0...v2.5.0](https://github.com/imagekit-developer/imagekit-go/compare/v2.4.0...v2.5.0)
+
+### Features
+
+* **api:** add no-enlarge crop modes and colorize transformation ([ad25990](https://github.com/imagekit-developer/imagekit-go/commit/ad259909e99498bfda6beada5eaff2e87ffb2e54))
+* **api:** manual updates ([791dd8c](https://github.com/imagekit-developer/imagekit-go/commit/791dd8c9fa7b8e9ee247918f6aceffc77ad7f8cf))
+* **client:** add compatibility aliases for old type names ([b238a42](https://github.com/imagekit-developer/imagekit-go/commit/b238a423928c3f00584a4894bc1759e21bafb33d))
+* **go:** add default http client with timeout ([f4d5e6b](https://github.com/imagekit-developer/imagekit-go/commit/f4d5e6bc9096d5e51368b2aa8810c22352900643))
+* **helper:** add colorize transformation support and update tests ([53b441a](https://github.com/imagekit-developer/imagekit-go/commit/53b441a512d73384714df827ad202fb678d73a5e))
+* support setting headers via env ([3872a5e](https://github.com/imagekit-developer/imagekit-go/commit/3872a5eb58f1c091b8be08183dd4c972e8a68f75))
+* **tests:** comment update ([4bef04e](https://github.com/imagekit-developer/imagekit-go/commit/4bef04e89c89449faff1e6bf642ccc7158070790))
+
+
+### Bug Fixes
+
+* **go:** avoid panic when http.DefaultTransport is wrapped ([c762867](https://github.com/imagekit-developer/imagekit-go/commit/c7628672829b9037cdae1851a93bb8f1304a9c86))
+
+
+### Chores
+
+* avoid embedding reflect.Type for dead code elimination ([a8ce4c3](https://github.com/imagekit-developer/imagekit-go/commit/a8ce4c343ff55b3f698e96438167f340cddfc4c2))
+* configure new SDK language ([0951290](https://github.com/imagekit-developer/imagekit-go/commit/0951290e27f1568894dd90e717fc49612e24bedd))
+* **internal:** codegen related update ([1622f80](https://github.com/imagekit-developer/imagekit-go/commit/1622f80e1bae58177eae2b260e269e5b1b32de9a))
+* **internal:** codegen related update ([56516d9](https://github.com/imagekit-developer/imagekit-go/commit/56516d9f70279d35c597800d8c580ed18650e6d7))
+* **internal:** codegen related update ([14d3582](https://github.com/imagekit-developer/imagekit-go/commit/14d3582a90625f39b54ffb31000db0e35a849027))
+* **internal:** codegen related update ([904d9f3](https://github.com/imagekit-developer/imagekit-go/commit/904d9f3ebf4291f4142dcd99db48b832761fba7f))
+* **internal:** more robust bootstrap script ([5888120](https://github.com/imagekit-developer/imagekit-go/commit/5888120dc9032b1826cc0b7018f53f34db89666e))
+* **internal:** simplify release-please config ([48c9497](https://github.com/imagekit-developer/imagekit-go/commit/48c949735a94871559549cd63d9dd9bad83f4241))
+* redact api-key headers in debug logs ([add677a](https://github.com/imagekit-developer/imagekit-go/commit/add677afd39e072a7f0ef313f2a0f7d6ceff1f19))
+
+
+### Documentation
+
+* remove example code for verifying webhook signatures ([799e47c](https://github.com/imagekit-developer/imagekit-go/commit/799e47c306c5f681891804c6e3ca738b0b2c053c))
+
 ## 2.4.0 (2026-04-13)
 
 Full Changelog: [v2.3.0...v2.4.0](https://github.com/imagekit-developer/imagekit-go/compare/v2.3.0...v2.4.0)

README.md

@@ -59,7 +59,7 @@ Or to pin the version:
 <!-- x-release-please-start-version -->
 
 ```sh
-go get -u 'github.com/imagekit-developer/imagekit-go/v2@v2.4.0'
+go get -u 'github.com/imagekit-developer/imagekit-go/v2@v2.5.0'
 ```
 
 <!-- x-release-please-end -->
@@ -759,100 +759,10 @@ These authentication parameters can be used in client-side upload forms to secur
 
 The ImageKit SDK provides utilities to verify webhook signatures for secure event handling. This ensures that webhook requests are actually coming from ImageKit and haven't been tampered with.
 
-### Verifying webhook signatures
-
-```go
-package main
-
-import (
-	"fmt"
-	"io"
-	"log"
-	"net/http"
-	"os"
-
-	"github.com/imagekit-developer/imagekit-go/v2"
-	"github.com/imagekit-developer/imagekit-go/v2/option"
-)
-
-func main() {
-	client := imagekit.NewClient(
-		option.WithPrivateKey("your_private_key"),
-		option.WithWebhookSecret("whsec_..."), // Copy from ImageKit dashboard
-	)
-
-	// Webhook handler with proper request body handling
-	http.HandleFunc("/webhook", func(w http.ResponseWriter, req *http.Request) {
-		// Limit request body size to prevent abuse (64KB should be sufficient for most webhooks)
-		const MaxBodyBytes = int64(65536)
-		req.Body = http.MaxBytesReader(w, req.Body, MaxBodyBytes)
-		
-		// Read the raw webhook payload
-		payload, err := io.ReadAll(req.Body)
-		if err != nil {
-			fmt.Fprintf(os.Stderr, "Error reading request body: %v\n", err)
-			w.WriteHeader(http.StatusServiceUnavailable)
-			return
-		}
-
-		// Verify and unwrap webhook payload
-		event, err := client.Webhooks.Unwrap(payload, req.Header)
-		if err != nil {
-			fmt.Fprintf(os.Stderr, "Invalid webhook signature or malformed payload: %v\n", err)
-			w.WriteHeader(http.StatusUnauthorized)
-			return
-		}
-
-		fmt.Printf("Verified webhook event: %s\n", event.Type)
-		
-		// Handle different event types with full type safety
-		switch event.Type {
-		case "video.transformation.accepted":
-			videoEvent := event.AsVideoTransformationAcceptedEvent()
-			fmt.Printf("Video transformation accepted: %s\n", videoEvent.Data.Asset.URL)
-			// Debugging: Track transformation requests
-			// handleVideoTransformationAccepted(videoEvent)
-			
-		case "video.transformation.ready":
-			videoEvent := event.AsVideoTransformationReadyEvent()
-			fmt.Printf("Video transformation ready: %s\n", videoEvent.Data.Transformation.Output.URL)
-			// Update your database/CMS to show the transformed video
-			// handleVideoTransformationReady(videoEvent)
-			
-		case "video.transformation.error":
-			videoEvent := event.AsVideoTransformationErrorEvent()
-			fmt.Printf("Video transformation error: %s\n", videoEvent.Data.Transformation.Error.Reason)
-			// Log error and check your origin/URL endpoint settings
-			// handleVideoTransformationError(videoEvent)
-			
-		case "upload.pre-transform.success":
-			uploadEvent := event.AsUploadPreTransformSuccessEvent()
-			fmt.Printf("Pre-transform success: %s\n", uploadEvent.Data.FileID)
-			// File uploaded and pre-transformation completed
-			// handleUploadPreTransformSuccess(uploadEvent)
-			
-		case "upload.post-transform.success":
-			postEvent := event.AsUploadPostTransformSuccessEvent()
-			fmt.Printf("Post-transform success: %s\n", postEvent.Data.Name)
-			// Additional transformation completed
-			// handleUploadPostTransformSuccess(postEvent)
-			
-		// Handle other event types as needed
-		default:
-			fmt.Printf("Unhandled event type: %s\n", event.Type)
-		}
-
-		w.WriteHeader(http.StatusOK)
-	})
-
-	// Start the server
-	fmt.Println("Webhook server listening on :8080")
-	log.Fatal(http.ListenAndServe(":8080", nil))
-}
-```
-
 For detailed information about webhook setup, signature verification, and handling different webhook events, refer to the [ImageKit webhook documentation](https://imagekit.io/docs/webhooks#verify-webhook-signature).
 
+## Advanced Usage
+
 ### Errors
 
 When the API returns a non-success status code, we return an error with type

aliases.go

@@ -831,6 +831,9 @@ const TransformationCropAtLeast = shared.TransformationCropAtLeast
 // Equals "maintain_ratio"
 const TransformationCropMaintainRatio = shared.TransformationCropMaintainRatio
 
+// Equals "maintain_ratio_no_enlarge"
+const TransformationCropMaintainRatioNoEnlarge = shared.TransformationCropMaintainRatioNoEnlarge
+
 // Additional crop modes for image resizing. See
 // [Crop modes & focus](https://imagekit.io/docs/image-resize-and-crop#crop-crop-modes--focus).
 //
@@ -846,6 +849,12 @@ const TransformationCropModeExtract = shared.TransformationCropModeExtract
 // Equals "pad_extract"
 const TransformationCropModePadExtract = shared.TransformationCropModePadExtract
 
+// Equals "pad_resize_no_enlarge"
+const TransformationCropModePadResizeNoEnlarge = shared.TransformationCropModePadResizeNoEnlarge
+
+// Equals "pad_extract_no_shrink"
+const TransformationCropModePadExtractNoShrink = shared.TransformationCropModePadExtractNoShrink
+
 // Specifies the duration (in seconds) for trimming videos, e.g., `5` or `10.5`.
 // Typically used with startOffset to indicate the length from the start offset.
 // Arithmetic expressions are supported. See

client.go

@@ -7,6 +7,7 @@ import (
 	"net/http"
 	"os"
 	"slices"
+	"strings"
 
 	"github.com/imagekit-developer/imagekit-go/v2/internal/requestconfig"
   "github.com/imagekit-developer/imagekit-go/v2/lib"
@@ -35,7 +36,7 @@ type Client struct {
 // OPTIONAL_IMAGEKIT_IGNORES_THIS, IMAGEKIT_WEBHOOK_SECRET, IMAGE_KIT_BASE_URL).
 // This should be used to initialize new clients.
 func DefaultClientOptions() []option.RequestOption {
-	defaults := []option.RequestOption{option.WithEnvironmentProduction()}
+	defaults := []option.RequestOption{option.WithHTTPClient(defaultHTTPClient()), option.WithEnvironmentProduction()}
 	if o, ok := os.LookupEnv("IMAGE_KIT_BASE_URL"); ok {
 		defaults = append(defaults, option.WithBaseURL(o))
 	}
@@ -49,6 +50,14 @@ func DefaultClientOptions() []option.RequestOption {
 	if o, ok := os.LookupEnv("IMAGEKIT_WEBHOOK_SECRET"); ok {
 		defaults = append(defaults, option.WithWebhookSecret(o))
 	}
+	if o, ok := os.LookupEnv("IMAGE_KIT_CUSTOM_HEADERS"); ok {
+		for _, line := range strings.Split(o, "\n") {
+			colon := strings.Index(line, ":")
+			if colon >= 0 {
+				defaults = append(defaults, option.WithHeader(strings.TrimSpace(line[:colon]), strings.TrimSpace(line[colon+1:])))
+			}
+		}
+	}
 	return defaults
 }
 

default_http_client.go

@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+package imagekit
+
+import (
+	"net/http"
+	"time"
+)
+
+// defaultResponseHeaderTimeout bounds the time between a fully written request
+// and the server's response headers. It does not apply to the response body,
+// so long-running streams are unaffected. Without this, a server that accepts
+// the connection but never responds would hang the request indefinitely.
+const defaultResponseHeaderTimeout = 10 * time.Minute
+
+// defaultHTTPClient returns an [*http.Client] used when the caller does not
+// supply one via [option.WithHTTPClient]. When [http.DefaultTransport] is the
+// stdlib [*http.Transport], it is cloned and a [http.Transport.ResponseHeaderTimeout]
+// is set so stuck connections fail fast instead of compounding across retries.
+// If [http.DefaultTransport] has been wrapped (for example by otelhttp for
+// distributed tracing), the wrapping is preserved and the header timeout is
+// skipped.
+func defaultHTTPClient() *http.Client {
+	if t, ok := http.DefaultTransport.(*http.Transport); ok {
+		t = t.Clone()
+		t.ResponseHeaderTimeout = defaultResponseHeaderTimeout
+		return &http.Client{Transport: t}
+	}
+	return &http.Client{Transport: http.DefaultTransport}
+}

dummy_test.go

@@ -174,6 +174,7 @@ func TestDummyNewWithOptionalParams(t *testing.T) {
 					Background:      imagekit.String("red"),
 					Blur:            imagekit.Float(10),
 					Border:          imagekit.String("5_FF0000"),
+					Colorize:        imagekit.String("colorize"),
 					ColorProfile:    imagekit.Bool(true),
 					ColorReplace:    imagekit.String("colorReplace"),
 					ContrastStretch: true,
@@ -370,6 +371,7 @@ func TestDummyNewWithOptionalParams(t *testing.T) {
 				Background:      imagekit.String("red"),
 				Blur:            imagekit.Float(10),
 				Border:          imagekit.String("5_FF0000"),
+				Colorize:        imagekit.String("colorize"),
 				ColorProfile:    imagekit.Bool(true),
 				ColorReplace:    imagekit.String("colorReplace"),
 				ContrastStretch: true,
@@ -713,6 +715,7 @@ func TestDummyNewWithOptionalParams(t *testing.T) {
 				Background:      imagekit.String("red"),
 				Blur:            imagekit.Float(10),
 				Border:          imagekit.String("5_FF0000"),
+				Colorize:        imagekit.String("colorize"),
 				ColorProfile:    imagekit.Bool(true),
 				ColorReplace:    imagekit.String("colorReplace"),
 				ContrastStretch: true,
@@ -1012,6 +1015,7 @@ func TestDummyNewWithOptionalParams(t *testing.T) {
 			Background:      imagekit.String("red"),
 			Blur:            imagekit.Float(10),
 			Border:          imagekit.String("5_FF0000"),
+			Colorize:        imagekit.String("colorize"),
 			ColorProfile:    imagekit.Bool(true),
 			ColorReplace:    imagekit.String("colorReplace"),
 			ContrastStretch: true,
@@ -1202,6 +1206,7 @@ func TestDummyNewWithOptionalParams(t *testing.T) {
 				Background:      imagekit.String("red"),
 				Blur:            imagekit.Float(10),
 				Border:          imagekit.String("5_FF0000"),
+				Colorize:        imagekit.String("colorize"),
 				ColorProfile:    imagekit.Bool(true),
 				ColorReplace:    imagekit.String("colorReplace"),
 				ContrastStretch: true,

go.mod

@@ -3,7 +3,7 @@ module github.com/imagekit-developer/imagekit-go/v2
 go 1.22
 
 require (
-	github.com/standard-webhooks/standard-webhooks/libraries v0.0.0-20260309172517-425968d811b9
+	github.com/standard-webhooks/standard-webhooks/libraries v0.0.1
 	github.com/tidwall/gjson v1.18.0
 	github.com/tidwall/sjson v1.2.5
 )