Build SDK

Stainless-Generated-From: f4e3055

Author: stlc-bot

image-kit-java-core/src/main/kotlin/io/imagekit/models/namedtransformations/NamedTransformationCreateParams.kt

@@ -49,7 +49,9 @@ private constructor(
     /**
      * The transformation string this name refers to, for example `w-150,h-150,fo-center,cm-resize`.
      * The `tr:` prefix is optional — it's added automatically if missing, and validated if present.
-     * Learn more about the [transformation syntax](https://imagekit.io/docs/transformations).
+     * The string must be a valid ImageKit transformation and cannot itself reference another named
+     * transformation (no nesting). Learn more about the
+     * [transformation syntax](https://imagekit.io/docs/transformations).
      *
      * @throws ImageKitInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -156,8 +158,9 @@ private constructor(
         /**
          * The transformation string this name refers to, for example
          * `w-150,h-150,fo-center,cm-resize`. The `tr:` prefix is optional — it's added
-         * automatically if missing, and validated if present. Learn more about the
-         * [transformation syntax](https://imagekit.io/docs/transformations).
+         * automatically if missing, and validated if present. The string must be a valid ImageKit
+         * transformation and cannot itself reference another named transformation (no nesting).
+         * Learn more about the [transformation syntax](https://imagekit.io/docs/transformations).
          */
         fun transformation(transformation: String) = apply { body.transformation(transformation) }
 
@@ -361,8 +364,9 @@ private constructor(
         /**
          * The transformation string this name refers to, for example
          * `w-150,h-150,fo-center,cm-resize`. The `tr:` prefix is optional — it's added
-         * automatically if missing, and validated if present. Learn more about the
-         * [transformation syntax](https://imagekit.io/docs/transformations).
+         * automatically if missing, and validated if present. The string must be a valid ImageKit
+         * transformation and cannot itself reference another named transformation (no nesting).
+         * Learn more about the [transformation syntax](https://imagekit.io/docs/transformations).
          *
          * @throws ImageKitInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -463,7 +467,9 @@ private constructor(
             /**
              * The transformation string this name refers to, for example
              * `w-150,h-150,fo-center,cm-resize`. The `tr:` prefix is optional — it's added
-             * automatically if missing, and validated if present. Learn more about the
+             * automatically if missing, and validated if present. The string must be a valid
+             * ImageKit transformation and cannot itself reference another named transformation (no
+             * nesting). Learn more about the
              * [transformation syntax](https://imagekit.io/docs/transformations).
              */
             fun transformation(transformation: String) =

image-kit-java-core/src/main/kotlin/io/imagekit/models/namedtransformations/NamedTransformationDeleteParams.kt

@@ -15,10 +15,9 @@ import kotlin.jvm.optionals.getOrNull
  * Permanently deletes the named transformation identified by `id` and returns the deleted object.
  *
  * Deletion fails with a `409` error if the named transformation is still referenced (via the
- * `n-<name>` token) by another enabled named transformation, or by an upload
- * pre-transformation/post-transformation setting. References from disabled named transformations
- * don't count. This check is best-effort and can't detect references in your own application code
- * or in previously generated URLs.
+ * `n-<name>` token) by an upload pre-transformation or post-transformation setting. This check is
+ * best-effort and can't detect references in your own application code or in previously generated
+ * URLs.
  */
 class NamedTransformationDeleteParams
 private constructor(

image-kit-java-core/src/main/kotlin/io/imagekit/models/namedtransformations/NamedTransformationUpdateParams.kt

@@ -24,10 +24,9 @@ import kotlin.jvm.optionals.getOrNull
  * fields present in the request body are updated; other fields stay unchanged.
  *
  * Renaming or disabling a named transformation fails with a `409` error if it is still referenced
- * (via the `n-<name>` token) by another enabled named transformation, or by an upload
- * pre-transformation/post-transformation setting. References from disabled named transformations
- * don't count. This check is best-effort and can't detect references in your own application code
- * or in previously generated URLs.
+ * (via the `n-<name>` token) by an upload pre-transformation or post-transformation setting. This
+ * check is best-effort and can't detect references in your own application code or in previously
+ * generated URLs.
  */
 class NamedTransformationUpdateParams
 private constructor(
@@ -60,7 +59,9 @@ private constructor(
     /**
      * The transformation string this name refers to, for example `w-150,h-150,fo-center,cm-resize`.
      * The `tr:` prefix is optional — it's added automatically if missing, and validated if present.
-     * Learn more about the [transformation syntax](https://imagekit.io/docs/transformations).
+     * The string must be a valid ImageKit transformation and cannot itself reference another named
+     * transformation (no nesting). Learn more about the
+     * [transformation syntax](https://imagekit.io/docs/transformations).
      *
      * @throws ImageKitInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -174,8 +175,9 @@ private constructor(
         /**
          * The transformation string this name refers to, for example
          * `w-150,h-150,fo-center,cm-resize`. The `tr:` prefix is optional — it's added
-         * automatically if missing, and validated if present. Learn more about the
-         * [transformation syntax](https://imagekit.io/docs/transformations).
+         * automatically if missing, and validated if present. The string must be a valid ImageKit
+         * transformation and cannot itself reference another named transformation (no nesting).
+         * Learn more about the [transformation syntax](https://imagekit.io/docs/transformations).
          */
         fun transformation(transformation: String) = apply { body.transformation(transformation) }
 
@@ -372,8 +374,9 @@ private constructor(
         /**
          * The transformation string this name refers to, for example
          * `w-150,h-150,fo-center,cm-resize`. The `tr:` prefix is optional — it's added
-         * automatically if missing, and validated if present. Learn more about the
-         * [transformation syntax](https://imagekit.io/docs/transformations).
+         * automatically if missing, and validated if present. The string must be a valid ImageKit
+         * transformation and cannot itself reference another named transformation (no nesting).
+         * Learn more about the [transformation syntax](https://imagekit.io/docs/transformations).
          *
          * @throws ImageKitInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
@@ -472,7 +475,9 @@ private constructor(
             /**
              * The transformation string this name refers to, for example
              * `w-150,h-150,fo-center,cm-resize`. The `tr:` prefix is optional — it's added
-             * automatically if missing, and validated if present. Learn more about the
+             * automatically if missing, and validated if present. The string must be a valid
+             * ImageKit transformation and cannot itself reference another named transformation (no
+             * nesting). Learn more about the
              * [transformation syntax](https://imagekit.io/docs/transformations).
              */
             fun transformation(transformation: String) =

image-kit-java-core/src/main/kotlin/io/imagekit/services/async/NamedTransformationServiceAsync.kt

@@ -52,10 +52,9 @@ interface NamedTransformationServiceAsync {
      * fields present in the request body are updated; other fields stay unchanged.
      *
      * Renaming or disabling a named transformation fails with a `409` error if it is still
-     * referenced (via the `n-<name>` token) by another enabled named transformation, or by an
-     * upload pre-transformation/post-transformation setting. References from disabled named
-     * transformations don't count. This check is best-effort and can't detect references in your
-     * own application code or in previously generated URLs.
+     * referenced (via the `n-<name>` token) by an upload pre-transformation or post-transformation
+     * setting. This check is best-effort and can't detect references in your own application code
+     * or in previously generated URLs.
      */
     fun update(id: String): CompletableFuture<NamedTransformation> =
         update(id, NamedTransformationUpdateParams.none())
@@ -112,10 +111,9 @@ interface NamedTransformationServiceAsync {
      * object.
      *
      * Deletion fails with a `409` error if the named transformation is still referenced (via the
-     * `n-<name>` token) by another enabled named transformation, or by an upload
-     * pre-transformation/post-transformation setting. References from disabled named
-     * transformations don't count. This check is best-effort and can't detect references in your
-     * own application code or in previously generated URLs.
+     * `n-<name>` token) by an upload pre-transformation or post-transformation setting. This check
+     * is best-effort and can't detect references in your own application code or in previously
+     * generated URLs.
      */
     fun delete(id: String): CompletableFuture<NamedTransformation> =
         delete(id, NamedTransformationDeleteParams.none())

image-kit-java-core/src/main/kotlin/io/imagekit/services/blocking/NamedTransformationService.kt

@@ -52,10 +52,9 @@ interface NamedTransformationService {
      * fields present in the request body are updated; other fields stay unchanged.
      *
      * Renaming or disabling a named transformation fails with a `409` error if it is still
-     * referenced (via the `n-<name>` token) by another enabled named transformation, or by an
-     * upload pre-transformation/post-transformation setting. References from disabled named
-     * transformations don't count. This check is best-effort and can't detect references in your
-     * own application code or in previously generated URLs.
+     * referenced (via the `n-<name>` token) by an upload pre-transformation or post-transformation
+     * setting. This check is best-effort and can't detect references in your own application code
+     * or in previously generated URLs.
      */
     fun update(id: String): NamedTransformation = update(id, NamedTransformationUpdateParams.none())
 
@@ -109,10 +108,9 @@ interface NamedTransformationService {
      * object.
      *
      * Deletion fails with a `409` error if the named transformation is still referenced (via the
-     * `n-<name>` token) by another enabled named transformation, or by an upload
-     * pre-transformation/post-transformation setting. References from disabled named
-     * transformations don't count. This check is best-effort and can't detect references in your
-     * own application code or in previously generated URLs.
+     * `n-<name>` token) by an upload pre-transformation or post-transformation setting. This check
+     * is best-effort and can't detect references in your own application code or in previously
+     * generated URLs.
      */
     fun delete(id: String): NamedTransformation = delete(id, NamedTransformationDeleteParams.none())