zendesk_apps_support 4.43.1 → 4.44.0.alpha.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b4d10e06262450698663c4782882ae7c4b7a2e297c8f3431d1e68d0df999b6c
-  data.tar.gz: 49a637e750ab21897e41c4483b5490798b4ff68998853a80adea36b02578e370
+  metadata.gz: b611098add00d4e6f1c03e6604521db85f49bd6beea30a43695a286c0d474122
+  data.tar.gz: 40e1ade02e50ac1980eeda60def6501368499e48f46c6180f5e5e7f0053564e2
 SHA512:
-  metadata.gz: 3d905105996213d9fb5dd23a2619baf14174493cb8df8ba9582ff732d4efff303962128a7c6475ae1a0b5c0d50540c2538ecb76a33414139c36be63f46514c51
-  data.tar.gz: 58aaa09be2e81d0ab1db0c1f9ccde7516fa2254be0bd02396a2796ebb85a562ebe070920236478c81a8ae4f001c05fbb2a28c7cf8fdbe02ac2236e8e7211e3eb
+  metadata.gz: 7052e5b47f7b72d52073f25e39291ef32b0373d850b4912d1f82b05a7463188e328452823471bde20ffa537d1bb47ffb53a5ad50713343114423352d3a0861d8
+  data.tar.gz: 8010184c5735b90149c78a3f75ba4d29a08e90f5d4ed0eebda6f94f16763ceeb08328671ef273355492f53a9b931802a253b0be0879fa4969f00c6beddc36ec6

data/config/locales/translations/zendesk_apps_support.yml

@@ -105,6 +105,133 @@ parts:
       title: "App builder job: requirements file contains too many custom objects requirements. Leave requirements.json as is (do not localize)"
       value: "The requirements.json file contains too many custom objects requirements. The current limit is %{max} requirements. This app has %{count} requirements."
       screenshot: "https://drive.google.com/open?id=18yac8rV7kMe5qm49ERVFVCA7WOZl8vcP"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_custom_objects_v2_requirements"
+      title: "App builder job: requirements file contains too many custom objects v2 requirements. The maximum number of custom objects per account is 50. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains too many custom objects v2 requirements. The current limit is %{max} custom objects per account. This app has %{count} custom objects per account."
+      screenshot: "https://drive.google.com/file/d/1eFZWrESblrmgJxp8ls0rk1RPkDxJ0w-4/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_custom_objects_v2_fields"
+      title: "App builder job: requirements file contains too many custom object fields. The maximum number of custom object fields per object is 10. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains too many custom object fields. The current limit is %{max} fields per custom object. This app has %{count} fields for object %{object_key}."
+      screenshot: "https://drive.google.com/file/d/1mEiQLJxTb-lFFnVt96n051w4BnxJOZID/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_custom_objects_v2_triggers"
+      title: "App builder job: requirements file contains too many custom object triggers. The maximum number of custom object triggers per object is 20. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains too many custom object triggers. The current limit is %{max} triggers per custom object. This app has %{count} triggers for object %{object_key}."
+      screenshot: "https://drive.google.com/file/d/1JTEmjrUTq7Bsxoy36Syj-vhbkG8W_68D/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_custom_objects_v2_trigger_conditions"
+      title: "App builder job: requirements file contains too many custom object trigger conditions. The maximum number of conditions allowed per trigger is 50. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains too many custom object trigger conditions. The current limit is %{max} conditions per trigger. This app has %{count} conditions for trigger %{trigger_title}."
+      screenshot: "https://drive.google.com/file/d/1szSaYRTeIcHux5nMJg3Yxyct1Obxa-wv/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_custom_objects_v2_trigger_actions"
+      title: "App builder job: requirements file contains too many custom object trigger actions. The maximum number of actions allowed per trigger is 25. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains too many custom object trigger actions. The current limit is %{max} actions per trigger. This app has %{count} actions for trigger %{trigger_title}."
+      screenshot: "https://drive.google.com/file/d/18jXaM7_OnPqHAg6jAxJrTrgX1v_H156_/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_cov2_dropdown_fields_per_object"
+      title: "App builder job: requirements file contains too many custom object fields of type dropdown. The maximum number of fields of type dropdown per object is 5. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains too many custom object fields of type dropdown. The current limit is %{max} fields per object. This app has %{count} fields of type dropdown for object %{object_key}."
+      screenshot: "https://drive.google.com/file/d/1hILvdZQXZCtkQVupYXedPbnD_rNN4nwH/view?usp=sharing"
+      obsolete: "2025-11-01"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_cov2_multiselect_fields_per_object"
+      title: "App builder job: requirements file contains too many custom object fields of type multiselect. The maximum number of fields of type multiselect per object is 5. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains too many custom object fields of type multiselect. The current limit is %{max} fields per object. This app has %{count} fields of type multiselect for object %{object_key}."
+      screenshot: "https://drive.google.com/file/d/1RJgWEKXv7Zkt7V2Vh3QZyl55W9QOC6Z9/view?usp=sharing"
+      obsolete: "2025-11-01"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_cov2_field_options"
+      title: "App builder job: requirements file contains too many options for custom object field of type dropdown or multiselect. The maximum number of options of type dropdown or multiselect per field is 10. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains too many options for custom object field %{field_key}. The current limit is %{max} options per field. This app has %{count} options for field %{field_key} in object %{object_key}."
+      screenshot: "https://drive.google.com/file/d/1ipP9khKzDdaDxWgKT1WyBG2D2c8HPc0P/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_cov2_relationship_filter_conditions"
+      title: "App builder job: requirements file contains too many conditions in relationship filter for lookup fields. The maximum number of conditions allowed in the relationship filter per field is 20. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains too many conditions in relationship filter for custom object field %{field_key}. The current limit is %{max} conditions per field. This app has %{count} conditions for field %{field_key} in object %{object_key}."
+      "screenshot": "https://drive.google.com/file/d/13J6GIkq3CXGqRwV5KRHouXulRVuwQnNi/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.missing_cov2_object_schema_key"
+      title: 'App builder job: requirements file is missing a custom object schema key. These are the required keys: (key, title, title_pluralized, include_in_list_view). The term \"schema key\" typically refers to an identifier or attribute that defines a specific item within a schema and it should be translated. Leave requirements.json as is (do not translate)'
+      value: "The requirements.json file is missing custom object schema key for object %{object_key}. The following key is required: %{missing_key}."
+      "screenshot": "https://drive.google.com/file/d/15iZemfkt14z96W4zmDHw1kodU70UxMYs/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.missing_cov2_field_schema_key"
+      title: 'App builder job: requirements file is missing a custom object field schema key. These are the required keys: (key, title, type, object_key). The term \"schema key\" typically refers to an identifier or attribute that defines a specific item within a schema and it should be translated. Leave requirements.json as is (do not translate)'
+      value: "The requirements.json file is missing custom object field schema key for field %{field_key} in object %{object_key}. The following key is required: %{missing_key}."
+      "screenshot": "https://drive.google.com/file/d/1hYqJ_df8jhjqQjUQHMAC-yrAK7uGaKEH/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.missing_cov2_trigger_schema_key"
+      title: 'App builder job: requirements file is missing a custom object trigger schema key. These are the required keys: (title, actions, conditions, object_key). The term \"schema key\" typically refers to an identifier or attribute that defines a specific item within a schema and it should be translated. Leave requirements.json as is (do not translate)'
+      value: "The requirements.json file is missing custom object trigger schema key for trigger %{trigger_title} in object %{object_key}. The following key is required: %{missing_key}."
+      "screenshot": "https://drive.google.com/file/d/1Q_qFDZMoUzfAdL27QehW0q1rrHG3BPcP/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.empty_cov2_trigger_conditions"
+      title: "App builder job: requirements file contains an empty conditions array for custom object trigger. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains an empty conditions array for custom object trigger %{trigger_title} in object %{object_key}."
+      "screenshot": "https://drive.google.com/file/d/1dU534_37__yrqX9lQujjgTJeCV5Y5FIp/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.invalid_cov2_requirements_structure"
+      title: 'App builder job: requirements file contains invalid custom objects v2 structure. An "object" here refers to a programming object (a set of key-value pairs), not a custom object in Zendesk. Leave requirements.json, custom_objects_v2 as is (do not translate)'
+      value: 'The requirements.json file contains an invalid custom_objects_v2 structure. \"custom_objects_v2\" requirements must be an object.'
+      screenshot: "https://drive.google.com/file/d/1_P5Vl_QikPs-WgxqgDKJdgQW3jr1pTk2/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_cov2_payload_size"
+      title: "App builder job: requirements file contains custom objects v2 payload that exceeds maximum size limit. The maximum payload size is 1 MB. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains a custom objects v2 payload that is too large. The maximum allowed size is 1 MB."
+      screenshot: "https://drive.google.com/file/d/1buZhVxCslyX3fYiqJPWgJrWZyW3oHbGg/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.invalid_cov2_trigger_conditions_structure"
+      title: 'App builder job: requirements file contains invalid custom object trigger conditions structure. Conditions must be an object (a set of key-value pairs, like { "all": [], "any": [] } in JSON) with "all" and "any" arrays as keys. Leave requirements.json, "all" and "any" as is (do not translate)'
+      value: 'The requirements.json file contains an invalid custom object trigger conditions structure. Conditions must be a hash with "all" and "any" arrays for trigger %{trigger_title}.'
+      screenshot: "https://drive.google.com/file/d/1c4Hgk8OXscco_cwOfCX5r8Ub3k_-umrr/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.invalid_cov2_trigger_actions_structure"
+      title: "App builder job: requirements file contains an invalid custom object trigger actions structure. Actions must be an array. 'actions' is part of requirements file. Leave requirements.json and 'actions' as is (do not translate)"
+      value: 'The requirements.json file contains an invalid custom object trigger actions structure. \"actions\" must be an array for trigger %{trigger_title}.'
+      screenshot: "https://drive.google.com/file/d/12p8LzIcK4-ItJfHqHQiTaKxDxWnIiDni/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.empty_cov2_trigger_actions"
+      title: "App builder job: requirements file contains empty custom object trigger actions. At least one action must be specified. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains empty custom object trigger actions. At least one action must be specified for trigger %{trigger_title}."
+      screenshot: "https://drive.google.com/file/d/12XxGTNfRwh0aQM0gJkc_gFxiYSB0Op_r/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.excessive_cov2_selection_fields_per_object"
+      title: "App builder job: requirements file contains too many custom object fields of type dropdown or multiselect. The maximum number of fields of type dropdown or multiselect per object is 5. Leave requirements.json as is (do not translate). If your language has concatenation issues, please translate as: The requirements.json file contains too many custom object fields of type %{field_type}. The current limit per object is %{max}. This app has object %{object_key}, which has %{count} fields of type %{field_type}."
+      value: "The requirements.json file contains too many custom object fields of type %{field_type}. The current limit is %{max} fields per object. This app has %{count} fields of type %{field_type} for object %{object_key}."
+      screenshot: "https://drive.google.com/file/d/1hILvdZQXZCtkQVupYXedPbnD_rNN4nwH/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.invalid_objects_structure_in_cov2_requirements"
+      title: "App builder job: requirements file contains invalid objects structure for custom objects v2. Objects must be an array. Leave requirements.json and 'objects' as is (do not translate)"
+      value: 'The requirements.json file contains an invalid objects structure. \"objects\" must be an array.'
+      screenshot: "https://drive.google.com/file/d/1_0TOE9hOP2XeGZNyw9ueiYspvWGLileu/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.invalid_object_fields_structure_in_cov2_requirements"
+      title: "App builder job: requirements file contains invalid object_fields structure for custom objects v2. Object_fields must be an array. Leave requirements.json and 'object_fields' as is (do not translate)"
+      value: 'The requirements.json file contains an invalid object_fields structure. \"object_fields\" must be an array.'
+      screenshot: "https://drive.google.com/file/d/1yIHf-no1xXobSxnhmBuZSqzFMbZROzDO/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.invalid_object_triggers_structure_in_cov2_requirements"
+      title: "App builder job: requirements file contains invalid object_triggers structure for custom objects v2. Object_triggers must be an array. Leave requirements.json and 'object_triggers' as is (do not translate)"
+      value: 'The requirements.json file contains an invalid object_triggers structure. \"object_triggers\" must be an array.'
+      screenshot: "https://drive.google.com/file/d/14NNUm9R0u45LPbugUNmpA9psEwED1zkB/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.empty_cov2_requirements"
+      title: "App builder job: requirements file contains an empty hash for custom objects v2. Leave requirements.json as is (do not translate)"
+      value: "The requirements.json file contains empty custom objects v2 requirements. You must define valid requirements."
+      screenshot: "https://drive.google.com/file/d/1AfbKu_JOMSG9274IUrIUvwirSuwbxy3Y/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.invalid_cov2_object_reference_in_fields"
+      title: 'App builder job: requirements file contains an invalid object reference in object_fields for Custom Objects V2. Do not translate "requirements.json", "object_fields", \"%{item_identifier}\",  \"%{object_key}\".'
+      value: 'The requirements.json file contains an invalid object reference in object_fields. Field \"%{item_identifier}\" references object \"%{object_key}\" which does not exist in the objects array.'
+      screenshot: "https://drive.google.com/file/d/124uX-MBnEoqt7lDZBqQb4OVT2YN8-qz2/view?usp=sharing"
+  - translation:
+      key: "txt.apps.admin.error.app_build.invalid_cov2_object_reference_in_triggers"
+      title: 'App builder job: requirements file contains an invalid object reference in object_triggers for Custom Objects V2. Do not translate "requirements.json", "object_fields", \"%{item_identifier}\", \"%{object_key}\".'
+      value: 'The requirements.json file contains an invalid object reference in object_triggers. Trigger \"%{item_identifier}\" references object \"%{object_key}\" which does not exist in the objects array.'
+      screenshot: "https://drive.google.com/file/d/11e3x1sEfXQydkE-mRQ_rHqqLCRurHoCN/view?usp=sharing"
   - translation:
       key: "txt.apps.admin.error.app_build.missing_required_fields"
       title: "App builder job: required key missing in requirements, e.g. \"title\" is required in \"my_custom_email_target\""

data/lib/zendesk_apps_support/app_requirement.rb

@@ -6,7 +6,8 @@ module ZendeskAppsSupport
     CUSTOM_OBJECTS_KEY = 'custom_objects'
     CUSTOM_OBJECTS_TYPE_KEY = 'custom_object_types'
     CUSTOM_OBJECTS_RELATIONSHIP_TYPE_KEY = 'custom_object_relationship_types'
+    CUSTOM_OBJECTS_V2_KEY = 'custom_objects_v2'
     TYPES = %w[automations channel_integrations custom_objects macros targets views ticket_fields
-               triggers user_fields organization_fields webhooks].freeze
+               triggers user_fields organization_fields webhooks custom_objects_v2].freeze
   end
 end

data/lib/zendesk_apps_support/validations/custom_objects_v2/constants.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module ZendeskAppsSupport
+  module Validations
+    module CustomObjectsV2
+      module Constants
+        MAX_OBJECTS = 50
+        MAX_FIELDS_PER_OBJECT = 10
+        MAX_TRIGGERS_PER_OBJECT = 20
+        MAX_CONDITIONS_PER_TRIGGER = 50
+        MAX_ACTIONS_PER_TRIGGER = 25
+        MAX_CONDITIONS_IN_RELATIONSHIP_FILTER_PER_OBJECT = 20
+        MAX_DROPDOWN_FIELDS_PER_OBJECT = 5
+        MAX_MULTISELECT_FIELDS_PER_OBJECT = 5
+        MAX_DROPDOWN_OPTIONS_PER_FIELD = 10
+        MAX_MULTISELECT_OPTIONS_PER_FIELD = 10
+
+        SCHEMA_KEYS = {
+          objects: 'objects',
+          object_fields: 'object_fields',
+          object_triggers: 'object_triggers'
+        }.freeze
+
+        OBJECT_KEY = 'object_key'
+        TYPE = 'type'
+        KEY = 'key'
+        TITLE = 'title'
+        CF_OPTIONS = 'custom_field_options'
+        RELATIONSHIP_FILTER = 'relationship_filter'
+        DROPDOWN = 'dropdown'
+        MULTISELECT = 'multiselect'
+        CONDITIONS = 'conditions'
+        ACTIONS = 'actions'
+        ALL = 'all'
+        ANY = 'any'
+
+        SELECTION_FIELD_LIMITS = {
+          DROPDOWN => MAX_DROPDOWN_FIELDS_PER_OBJECT,
+          MULTISELECT => MAX_MULTISELECT_FIELDS_PER_OBJECT
+        }.freeze
+
+        SELECTION_FIELD_OPTIONS_LIMITS = {
+          DROPDOWN => MAX_DROPDOWN_OPTIONS_PER_FIELD,
+          MULTISELECT => MAX_MULTISELECT_OPTIONS_PER_FIELD
+        }.freeze
+
+        UNDEFINED_VALUE = '(undefined)'
+        CONDITION_KEYS = [ALL, ANY].freeze
+        MAX_PAYLOAD_SIZE_BYTES = 1_048_576 # 1 MB in bytes
+      end
+    end
+  end
+end

data/lib/zendesk_apps_support/validations/custom_objects_v2/custom_objects_v2.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require_relative 'constants'
+require_relative 'limits_validator'
+require_relative 'schema_validator'
+require_relative 'validation_helpers'
+
+module ZendeskAppsSupport
+  module Validations
+    module CustomObjectsV2
+      class << self
+        include Constants
+
+        def call(requirements)
+          errors = validate_overall_requirements_structure(requirements)
+          return errors if errors.any?
+
+          payload_size_errors = validate_payload_size(requirements)
+          return payload_size_errors if payload_size_errors.any?
+
+          [
+            validate_limits(requirements),
+            validate_schema(requirements)
+          ].flatten
+        end
+
+        private
+
+        def validate_payload_size(requirements)
+          payload_size = requirements.to_json.bytesize
+          return [] if payload_size <= MAX_PAYLOAD_SIZE_BYTES
+
+          [ValidationError.new(:excessive_cov2_payload_size)]
+        end
+
+        def validate_overall_requirements_structure(requirements)
+          errors = validate_structural_requirements(requirements)
+          return errors unless errors.empty?
+
+          objects = requirements[SCHEMA_KEYS[:objects]]
+          object_fields = requirements[SCHEMA_KEYS[:object_fields]]
+          object_triggers = requirements[SCHEMA_KEYS[:object_triggers]]
+
+          if all_collections_empty?(objects, object_fields, object_triggers)
+            return [ValidationError.new(:empty_cov2_requirements)]
+          end
+
+          [
+            validate_collection_is_array(objects, :invalid_objects_structure_in_cov2_requirements),
+            validate_collection_is_array(object_fields, :invalid_object_fields_structure_in_cov2_requirements),
+            validate_collection_is_array(object_triggers, :invalid_object_triggers_structure_in_cov2_requirements)
+          ].flatten
+        end
+
+        def validate_structural_requirements(requirements)
+          return [ValidationError.new(:invalid_cov2_requirements_structure)] unless requirements.is_a?(Hash)
+          return [ValidationError.new(:empty_cov2_requirements)] if requirements.empty?
+
+          []
+        end
+
+        def validate_limits(requirements)
+          LimitsValidator.validate(requirements)
+        end
+
+        def validate_schema(requirements)
+          SchemaValidator.validate(requirements)
+        end
+
+        def validate_collection_is_array(collection, error_type)
+          return [] if collection.nil? || collection.is_a?(Array)
+
+          [ValidationError.new(error_type)]
+        end
+
+        def all_collections_empty?(objects, object_fields, object_triggers)
+          [objects, object_fields, object_triggers].all? do |collection|
+            collection.is_a?(Array) && collection.empty?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zendesk_apps_support/validations/custom_objects_v2/limits_validator.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+require_relative 'validation_helpers'
+require_relative 'constants'
+
+module ZendeskAppsSupport
+  module Validations
+    module CustomObjectsV2
+      class LimitsValidator
+        class << self
+          include ValidationHelpers
+          include Constants
+          def validate(requirements)
+            [
+              validate_objects_excessive_limit(requirements[SCHEMA_KEYS[:objects]]),
+              validate_fields_excessive_limit(requirements[SCHEMA_KEYS[:object_fields]]),
+              validate_triggers_excessive_limit(requirements[SCHEMA_KEYS[:object_triggers]])
+            ].flatten
+          end
+
+          private
+
+          def validate_objects_excessive_limit(objects)
+            return [] if objects.nil? || objects.size <= MAX_OBJECTS
+
+            [ValidationError.new(:excessive_custom_objects_v2_requirements,
+                                 max: MAX_OBJECTS,
+                                 count: objects.size)]
+          end
+
+          def validate_fields_excessive_limit(object_fields)
+            valid_fields = extract_hash_entries(object_fields).reject do |field|
+              field[OBJECT_KEY].to_s.empty?
+            end
+
+            [
+              validate_fields_limit(valid_fields),
+              validate_selection_field_limits(valid_fields),
+              validate_field_options_limits(valid_fields),
+              validate_relationship_filter_limits(valid_fields)
+            ].flatten
+          end
+
+          def validate_fields_limit(object_fields)
+            validation_context = { max_limit: MAX_FIELDS_PER_OBJECT,
+                                   error: :excessive_custom_objects_v2_fields }
+            validate_collection_limits(object_fields, **validation_context)
+          end
+
+          def validate_selection_field_limits(object_fields)
+            SELECTION_FIELD_LIMITS.flat_map do |field_type, max_limit|
+              filtered_fields = object_fields.select { |field| field[TYPE] == field_type }
+              validate_field_type_limit(filtered_fields, field_type, max_limit)
+            end
+          end
+
+          def validate_field_type_limit(object_fields, field_type, max_limit)
+            validation_context = { max_limit: max_limit,
+                                   error: :excessive_cov2_selection_fields_per_object,
+                                   field_type: field_type }
+
+            validate_collection_limits(object_fields, **validation_context)
+          end
+
+          def validate_field_options_limits(object_fields)
+            SELECTION_FIELD_OPTIONS_LIMITS.flat_map do |field_type, max_limit|
+              validate_options_limit(object_fields, field_type, max_limit)
+            end
+          end
+
+          def validate_options_limit(object_fields, field_type, max_limit)
+            fields_with_options = object_fields.select do |field|
+              field[TYPE] == field_type && field[CF_OPTIONS]&.any?
+            end
+
+            fields_with_options.filter_map do |field|
+              options = field[CF_OPTIONS]
+
+              next if options.size <= max_limit
+
+              ValidationError.new(:excessive_cov2_field_options,
+                                  max: max_limit,
+                                  count: options.size,
+                                  field_key: field[KEY],
+                                  object_key: field[OBJECT_KEY])
+            end
+          end
+
+          def validate_relationship_filter_limits(object_fields)
+            object_fields
+              .select { |field| field[RELATIONSHIP_FILTER] }
+              .flat_map { |field| validate_relationship_filter_conditions(field) }
+          end
+
+          def validate_relationship_filter_conditions(field)
+            relationship_filter = field[RELATIONSHIP_FILTER]
+            return [] unless relationship_filter
+
+            total_conditions = count_conditions(relationship_filter)
+
+            return [] unless total_conditions > MAX_CONDITIONS_IN_RELATIONSHIP_FILTER_PER_OBJECT
+
+            [ValidationError.new(:excessive_cov2_relationship_filter_conditions,
+                                 max: MAX_CONDITIONS_IN_RELATIONSHIP_FILTER_PER_OBJECT,
+                                 count: total_conditions,
+                                 field_key: field[KEY],
+                                 object_key: field[OBJECT_KEY])]
+          end
+
+          def validate_triggers_excessive_limit(object_triggers = [])
+            valid_triggers = extract_hash_entries(object_triggers).reject do |trigger|
+              trigger[OBJECT_KEY].to_s.empty?
+            end
+            return [] unless valid_triggers&.any?
+
+            [
+              validate_triggers_limit(valid_triggers),
+              validate_triggers_conditions_limit(valid_triggers),
+              validate_triggers_actions_limit(valid_triggers)
+            ].flatten
+          end
+
+          def validate_triggers_limit(object_triggers)
+            validation_context = { max_limit: MAX_TRIGGERS_PER_OBJECT,
+                                   error: :excessive_custom_objects_v2_triggers }
+
+            validate_collection_limits(object_triggers, **validation_context)
+          end
+
+          def validate_triggers_conditions_limit(object_triggers)
+            object_triggers.flat_map do |trigger|
+              validate_trigger_conditions(trigger)
+            end
+          end
+
+          def validate_trigger_conditions(trigger)
+            return [] unless trigger[CONDITIONS].is_a?(Hash)
+
+            total_conditions = count_conditions(trigger[CONDITIONS])
+
+            return [] unless total_conditions > MAX_CONDITIONS_PER_TRIGGER
+
+            [ValidationError.new(:excessive_custom_objects_v2_trigger_conditions,
+                                 max: MAX_CONDITIONS_PER_TRIGGER,
+                                 count: total_conditions,
+                                 trigger_title: trigger[TITLE])]
+          end
+
+          def validate_triggers_actions_limit(object_triggers)
+            object_triggers.filter_map do |trigger|
+              next unless trigger[ACTIONS]
+
+              actions = trigger[ACTIONS]
+              next if actions.size <= MAX_ACTIONS_PER_TRIGGER
+
+              ValidationError.new(:excessive_custom_objects_v2_trigger_actions,
+                                  max: MAX_ACTIONS_PER_TRIGGER,
+                                  count: actions.size,
+                                  trigger_title: trigger[TITLE])
+            end
+          end
+
+          def validate_collection_limits(collection, **context)
+            grouped_items = collection.group_by { |item| item[OBJECT_KEY] }
+
+            grouped_items.filter_map do |object_key, items|
+              next if items.size <= context[:max_limit]
+
+              extra_context = context.except(:max_limit, :error)
+              validation_context = {
+                max: context[:max_limit],
+                count: items.size,
+                object_key: object_key,
+                **extra_context
+              }
+              ValidationError.new(context[:error], validation_context)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zendesk_apps_support/validations/custom_objects_v2/schema_validator.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require_relative 'validation_helpers'
+require_relative 'constants'
+
+module ZendeskAppsSupport
+  module Validations
+    module CustomObjectsV2
+      class SchemaValidator
+        class << self
+          include ValidationHelpers
+          include Constants
+
+          def validate(requirements)
+            [
+              validate_objects_schema(requirements[SCHEMA_KEYS[:objects]]),
+              validate_fields_schema(requirements[SCHEMA_KEYS[:object_fields]]),
+              validate_triggers_schema(requirements[SCHEMA_KEYS[:object_triggers]])
+            ].flatten
+          end
+
+          private
+
+          def validate_objects_schema(objects = [])
+            valid_objects = extract_hash_entries(objects)
+            valid_objects.flat_map { |object| validate_object_schema(object) }
+          end
+
+          def validate_object_schema(object)
+            required_keys = %w[key title title_pluralized include_in_list_view]
+            missing_keys = required_keys - object.keys
+
+            missing_keys.map do |missing_key|
+              ValidationError.new(:missing_cov2_object_schema_key,
+                                  missing_key: missing_key,
+                                  object_key: safe_value(object[KEY]))
+            end
+          end
+
+          def validate_fields_schema(object_fields = [])
+            valid_fields = extract_hash_entries(object_fields)
+            valid_fields.flat_map { |field| validate_field_schema(field) }
+          end
+
+          def validate_field_schema(field)
+            required_keys = %w[key title type object_key]
+            missing_keys = required_keys - field.keys
+
+            missing_keys.map do |missing_key|
+              ValidationError.new(:missing_cov2_field_schema_key,
+                                  missing_key: missing_key,
+                                  field_key: safe_value(field[KEY]),
+                                  object_key: safe_value(field[OBJECT_KEY]))
+            end
+          end
+
+          def validate_triggers_schema(object_triggers = [])
+            valid_triggers = extract_hash_entries(object_triggers)
+            valid_triggers.flat_map { |trigger| validate_trigger_schema(trigger) }
+          end
+
+          def validate_trigger_schema(trigger)
+            required_keys = %w[object_key title actions conditions]
+            missing_keys = required_keys - trigger.keys
+            trigger_title = safe_value(trigger[TITLE])
+            object_key = safe_value(trigger[OBJECT_KEY])
+
+            errors = missing_keys.map do |missing_key|
+              ValidationError.new(:missing_cov2_trigger_schema_key,
+                                  missing_key: missing_key,
+                                  trigger_title: trigger_title,
+                                  object_key: object_key)
+            end
+
+            errors.concat(validate_conditions_schema(trigger[CONDITIONS], object_key, trigger_title))
+            errors.concat(validate_actions_schema(trigger[ACTIONS], object_key, trigger_title))
+            errors
+          end
+
+          def validate_conditions_schema(conditions, object_key, title)
+            error_data = { trigger_title: title, object_key: object_key }
+
+            unless valid_conditions_structure?(conditions)
+              return [ValidationError.new(:invalid_cov2_trigger_conditions_structure, **error_data)]
+            end
+
+            if count_conditions(conditions).zero?
+              return [ValidationError.new(:empty_cov2_trigger_conditions, **error_data)]
+            end
+
+            []
+          end
+
+          def validate_actions_schema(actions, object_key, title)
+            error_data = { trigger_title: title, object_key: object_key }
+
+            unless actions.is_a?(Array)
+              return [ValidationError.new(:invalid_cov2_trigger_actions_structure, **error_data)]
+            end
+
+            return [] unless actions.empty?
+
+            [ValidationError.new(:empty_cov2_trigger_actions, **error_data)]
+          end
+
+          def safe_value(value)
+            value || UNDEFINED_VALUE
+          end
+
+          def valid_conditions_structure?(conditions)
+            return false unless conditions.is_a?(Hash) && conditions.any?
+            return false if (conditions.keys - CONDITION_KEYS).any?
+
+            conditions.values.any? { |v| v.is_a?(Array) }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zendesk_apps_support/validations/custom_objects_v2/validation_helpers.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module ZendeskAppsSupport
+  module Validations
+    module CustomObjectsV2
+      module ValidationHelpers
+        private
+
+        def extract_hash_entries(collection)
+          return [] unless collection&.any?
+
+          collection.select { |item| item.is_a?(Hash) }
+        end
+
+        def count_conditions(conditions)
+          return 0 unless conditions.is_a?(Hash)
+
+          Constants::CONDITION_KEYS.sum { |key| conditions[key]&.size || 0 }
+        end
+      end
+    end
+  end
+end

data/lib/zendesk_apps_support/validations/requirements.rb

@@ -31,6 +31,7 @@ module ZendeskAppsSupport
             errors << invalid_custom_objects(requirements)
             errors << invalid_webhooks(requirements)
             errors << invalid_target_types(requirements)
+            errors << validate_custom_objects_v2_requirements(requirements)
             errors << missing_required_fields(requirements)
             errors.flatten!
             errors.compact!
@@ -48,9 +49,11 @@ module ZendeskAppsSupport
         def missing_required_fields(requirements)
           [].tap do |errors|
             requirements.each do |requirement_type, requirement|
-              next if %w[channel_integrations custom_objects webhooks].include? requirement_type
+              next if %w[channel_integrations custom_objects webhooks custom_objects_v2].include? requirement_type
+
               requirement.each do |identifier, fields|
                 next if fields.nil? || fields.include?('title')
+
                 errors << ValidationError.new(:missing_required_fields,
                                               field: 'title',
                                               identifier: identifier)
@@ -77,6 +80,13 @@ module ZendeskAppsSupport
           end
         end
 
+        def validate_custom_objects_v2_requirements(requirements)
+          return unless requirements.key?(AppRequirement::CUSTOM_OBJECTS_V2_KEY)
+
+          cov2_requirements = requirements[AppRequirement::CUSTOM_OBJECTS_V2_KEY]
+          CustomObjectsV2.call(cov2_requirements)
+        end
+
         def invalid_custom_fields(requirements)
           user_fields = requirements['user_fields']
           organization_fields = requirements['organization_fields']

data/lib/zendesk_apps_support/version.rb

@@ -1,3 +1,3 @@
 module ZendeskAppsSupport
-  VERSION = "4.43.1"
+  VERSION = "4.44.0.alpha.1"
 end

data/lib/zendesk_apps_support.rb

@@ -32,6 +32,7 @@ module ZendeskAppsSupport
     autoload :Requests,              'zendesk_apps_support/validations/requests'
     autoload :Banner,                'zendesk_apps_support/validations/banner'
     autoload :Svg,                   'zendesk_apps_support/validations/svg'
+    autoload :CustomObjectsV2,       'zendesk_apps_support/validations/custom_objects_v2/custom_objects_v2'
   end
 
   class Manifest

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zendesk_apps_support
 version: !ruby/object:Gem::Version
-  version: 4.43.1
+  version: 4.44.0.alpha.1
 platform: ruby
 authors:
 - James A. Rosen
@@ -11,7 +11,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-16 00:00:00.000000000 Z
+date: 2025-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n
@@ -321,6 +321,11 @@ files:
 - lib/zendesk_apps_support/sass_functions.rb
 - lib/zendesk_apps_support/stylesheet_compiler.rb
 - lib/zendesk_apps_support/validations/banner.rb
+- lib/zendesk_apps_support/validations/custom_objects_v2/constants.rb
+- lib/zendesk_apps_support/validations/custom_objects_v2/custom_objects_v2.rb
+- lib/zendesk_apps_support/validations/custom_objects_v2/limits_validator.rb
+- lib/zendesk_apps_support/validations/custom_objects_v2/schema_validator.rb
+- lib/zendesk_apps_support/validations/custom_objects_v2/validation_helpers.rb
 - lib/zendesk_apps_support/validations/manifest.rb
 - lib/zendesk_apps_support/validations/marketplace.rb
 - lib/zendesk_apps_support/validations/mime.rb