feat(api): add path policy related non-breaking changes

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-d1a3e6dfc45ae832b6b14a0aef25878985c679fa9f48c1470df188b1578ba648.yml
-openapi_spec_hash: 1d382866fce3284f26d341f112988d9d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-1499148ce5fc81b4d8c8b3eaadf7adfaf54df5fa0b3a0452c3f5ef0dfe884a95.yml
+openapi_spec_hash: e91526b143d3e696bef2b4d0ea3aa2b4
 config_hash: e42d7fc3a8c92c35099cc283f9a4467a

lib/imagekit/models/beta/v2/file_upload_params.rb

@@ -262,6 +262,7 @@ module ResponseField
             IS_PUBLISHED = :isPublished
             CUSTOM_METADATA = :customMetadata
             METADATA = :metadata
+            SELECTED_FIELDS_SCHEMA = :selectedFieldsSchema
 
             # @!method self.values
             #   @return [Array<Symbol>]

lib/imagekit/models/custom_metadata_field_list_params.rb

@@ -7,16 +7,27 @@ class CustomMetadataFieldListParams < Imagekit::Internal::Type::BaseModel
       extend Imagekit::Internal::Type::RequestParameters::Converter
       include Imagekit::Internal::Type::RequestParameters
 
+      # @!attribute folder_path
+      #   The folder path (e.g., `/path/to/folder`) for which to retrieve applicable
+      #   custom metadata fields.
+      #   Useful for determining path-specific field selections when the
+      #   [Path policy](https://imagekit.io/docs/dam/path-policy) feature is in use.
+      #
+      #   @return [String, nil]
+      optional :folder_path, String
+
       # @!attribute include_deleted
       #   Set it to `true` to include deleted field objects in the API response.
       #
       #   @return [Boolean, nil]
       optional :include_deleted, Imagekit::Internal::Type::Boolean
 
-      # @!method initialize(include_deleted: nil, request_options: {})
+      # @!method initialize(folder_path: nil, include_deleted: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Imagekit::Models::CustomMetadataFieldListParams} for more details.
       #
+      #   @param folder_path [String] The folder path (e.g., `/path/to/folder`) for which to retrieve applicable custo
+      #
       #   @param include_deleted [Boolean] Set it to `true` to include deleted field objects in the API response.
       #
       #   @param request_options [Imagekit::RequestOptions, Hash{Symbol=>Object}]

lib/imagekit/models/file_upload_params.rb

@@ -297,6 +297,7 @@ module ResponseField
         IS_PUBLISHED = :isPublished
         CUSTOM_METADATA = :customMetadata
         METADATA = :metadata
+        SELECTED_FIELDS_SCHEMA = :selectedFieldsSchema
 
         # @!method self.values
         #   @return [Array<Symbol>]

lib/imagekit/resources/custom_metadata_fields.rb

@@ -71,7 +71,14 @@ def update(id, params = {})
       # the API returns only non deleted field objects, but you can include deleted
       # fields in the API response.
       #
-      # @overload list(include_deleted: nil, request_options: {})
+      # You can also filter results by a specific folder path to retrieve custom
+      # metadata fields applicable at that location. This path-specific filtering is
+      # useful when using the **Path policy** feature to determine which custom metadata
+      # fields are selected for a given path.
+      #
+      # @overload list(folder_path: nil, include_deleted: nil, request_options: {})
+      #
+      # @param folder_path [String] The folder path (e.g., `/path/to/folder`) for which to retrieve applicable custo
       #
       # @param include_deleted [Boolean] Set it to `true` to include deleted field objects in the API response.
       #
@@ -85,7 +92,7 @@ def list(params = {})
         @client.request(
           method: :get,
           path: "v1/customMetadataFields",
-          query: parsed.transform_keys(include_deleted: "includeDeleted"),
+          query: parsed.transform_keys(folder_path: "folderPath", include_deleted: "includeDeleted"),
           model: Imagekit::Internal::Type::ArrayOf[Imagekit::CustomMetadataField],
           options: options
         )

rbi/imagekit/models/beta/v2/file_upload_params.rbi

@@ -504,6 +504,11 @@ module Imagekit
                 :metadata,
                 Imagekit::Beta::V2::FileUploadParams::ResponseField::TaggedSymbol
               )
+            SELECTED_FIELDS_SCHEMA =
+              T.let(
+                :selectedFieldsSchema,
+                Imagekit::Beta::V2::FileUploadParams::ResponseField::TaggedSymbol
+              )
 
             sig do
               override.returns(

rbi/imagekit/models/custom_metadata_field_list_params.rbi

@@ -14,6 +14,16 @@ module Imagekit
           )
         end
 
+      # The folder path (e.g., `/path/to/folder`) for which to retrieve applicable
+      # custom metadata fields.
+      # Useful for determining path-specific field selections when the
+      # [Path policy](https://imagekit.io/docs/dam/path-policy) feature is in use.
+      sig { returns(T.nilable(String)) }
+      attr_reader :folder_path
+
+      sig { params(folder_path: String).void }
+      attr_writer :folder_path
+
       # Set it to `true` to include deleted field objects in the API response.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :include_deleted
@@ -23,11 +33,17 @@ module Imagekit
 
       sig do
         params(
+          folder_path: String,
           include_deleted: T::Boolean,
           request_options: Imagekit::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # The folder path (e.g., `/path/to/folder`) for which to retrieve applicable
+        # custom metadata fields.
+        # Useful for determining path-specific field selections when the
+        # [Path policy](https://imagekit.io/docs/dam/path-policy) feature is in use.
+        folder_path: nil,
         # Set it to `true` to include deleted field objects in the API response.
         include_deleted: nil,
         request_options: {}
@@ -37,6 +53,7 @@ module Imagekit
       sig do
         override.returns(
           {
+            folder_path: String,
             include_deleted: T::Boolean,
             request_options: Imagekit::RequestOptions
           }

rbi/imagekit/models/file_upload_params.rbi

@@ -541,6 +541,11 @@ module Imagekit
             :metadata,
             Imagekit::FileUploadParams::ResponseField::TaggedSymbol
           )
+        SELECTED_FIELDS_SCHEMA =
+          T.let(
+            :selectedFieldsSchema,
+            Imagekit::FileUploadParams::ResponseField::TaggedSymbol
+          )
 
         sig do
           override.returns(

rbi/imagekit/resources/custom_metadata_fields.rbi

@@ -58,13 +58,24 @@ module Imagekit
       # This API returns the array of created custom metadata field objects. By default
       # the API returns only non deleted field objects, but you can include deleted
       # fields in the API response.
+      #
+      # You can also filter results by a specific folder path to retrieve custom
+      # metadata fields applicable at that location. This path-specific filtering is
+      # useful when using the **Path policy** feature to determine which custom metadata
+      # fields are selected for a given path.
       sig do
         params(
+          folder_path: String,
           include_deleted: T::Boolean,
           request_options: Imagekit::RequestOptions::OrHash
         ).returns(T::Array[Imagekit::CustomMetadataField])
       end
       def list(
+        # The folder path (e.g., `/path/to/folder`) for which to retrieve applicable
+        # custom metadata fields.
+        # Useful for determining path-specific field selections when the
+        # [Path policy](https://imagekit.io/docs/dam/path-policy) feature is in use.
+        folder_path: nil,
         # Set it to `true` to include deleted field objects in the API response.
         include_deleted: nil,
         request_options: {}

sig/imagekit/models/beta/v2/file_upload_params.rbs

@@ -169,6 +169,7 @@ module Imagekit
             | :isPublished
             | :customMetadata
             | :metadata
+            | :selectedFieldsSchema
 
           module ResponseField
             extend Imagekit::Internal::Type::Enum
@@ -180,6 +181,7 @@ module Imagekit
             IS_PUBLISHED: :isPublished
             CUSTOM_METADATA: :customMetadata
             METADATA: :metadata
+            SELECTED_FIELDS_SCHEMA: :selectedFieldsSchema
 
             def self?.values: -> ::Array[Imagekit::Models::Beta::V2::FileUploadParams::response_field]
           end