feat(api): add signed URL options with expiration settings to enhance security features

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-a49f0e337789b1a4368194ed004ac4c1b0c0cd2ce4344e14546422632242d897.yml
-openapi_spec_hash: a7f3999c6227aac108cd80253ffc7730
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-d857341f30517b11df568dd6c5a0e9dea3a854930f7f6583718114d311f2d5ee.yml
+openapi_spec_hash: db94bfd556220d6244a1b2bbae9d7d00
 config_hash: 249ee22f294858ab0971b8379f7cb519

src/resources/shared.ts

@@ -185,13 +185,36 @@ export interface SrcOptions {
    */
   urlEndpoint: string;
 
+  /**
+   * When you want the signed URL to expire, specified in seconds. If `expiresIn` is
+   * anything above 0, the URL will always be signed even if `signed` is set to
+   * false. If not specified and `signed` is `true`, the signed URL will not expire
+   * (valid indefinitely).
+   *
+   * Example: Setting `expiresIn: 3600` will make the URL expire 1 hour from
+   * generation time. After the expiry time, the signed URL will no longer be valid
+   * and ImageKit will return a 401 Unauthorized status code.
+   *
+   * [Learn more](https://imagekit.io/docs/media-delivery-basic-security#how-to-generate-signed-urls).
+   */
+  expiresIn?: number;
+
   /**
    * These are additional query parameters that you want to add to the final URL.
    * They can be any query parameters and not necessarily related to ImageKit. This
    * is especially useful if you want to add a versioning parameter to your URLs.
    */
   queryParameters?: { [key: string]: string };
 
+  /**
+   * Whether to sign the URL or not. Set this to `true` if you want to generate a
+   * signed URL. If `signed` is `true` and `expiresIn` is not specified, the signed
+   * URL will not expire (valid indefinitely). Note: If `expiresIn` is set to any
+   * value above 0, the URL will always be signed regardless of this setting.
+   * [Learn more](https://imagekit.io/docs/media-delivery-basic-security#how-to-generate-signed-urls).
+   */
+  signed?: boolean;
+
   /**
    * An array of objects specifying the transformations to be applied in the URL. If
    * more than one transformation is specified, they are applied in the order they