ruby-jss 5.0.2 → 5.1.0b1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f93b3360e24d93380ba960978723f4befe407f82af36cfb3d780c6a77467d105
-  data.tar.gz: e74fcfcba538665900f76f9f43253c5561bb0134e08422d961ca1eb3a8395884
+  metadata.gz: c4beb91ca79699491fc5868a5e4b2e22f57048df817bca7207d65574eb94227c
+  data.tar.gz: b31adf1c1cbcd419656aa4eeb58e70ed21147a79b3bd45730e5301b39e0acd7a
 SHA512:
-  metadata.gz: a8ea1ebdf16d0321bcef5ae6debfd776ee062d818a427cc9a37947da9eb08f912e367e50554441de57b869fa5917f85aaaac1c12e0501cfd482682fbe3643540
-  data.tar.gz: c5edc291971163572179187e598b69427bc37ba85906d211d5111a748c7b314310d186e0469fe2cd8e3c1b332b1d1dc87024ac52090f4a063dea7710250feace
+  metadata.gz: fcc17975fefc7e5f7d5f9830827dac4997af144817364ae866b796a4b634188f34a0dd553675e64a34aca9d53223e5e55a0dad2ed821eb135ffe91a206fdd566
+  data.tar.gz: 721e2d5981fbc3f8123e821a9f2a9cf8507dab9889ad2723cb4a77f68a6af313bad0e2e50ad6613314baa8e6111413b4b169fe739d199b5d223d350a2594393c

data/CHANGES.md

@@ -14,6 +14,21 @@ __Please update all installations of ruby-jss to at least v1.6.0.__
 
 Many many thanks to actae0n of Blacksun Hackers Club for reporting this issue and providing examples of how it could be exploited.
 
+--------
+## \[5.1.0] Unreleased
+
+### Added
+
+  - `Jamf::JCategory`, `Jamf::JScript`, `Jamf::JComputerExtensionAttribute`, `Jamf::JMobilDeviceExtensionAttribute` These classes are currently implemented only as presented in the Jamf Pro API. Some of the convenience features available in the Classic API implementations may or may not eventually be added. (e.g. for EAs: `#all_with_result`, `#latest_values`, `#from_ldap?` etc.)
+
+### Fixed
+
+  - Use `#pix_empty?` to better catch nils when expecting empty strings
+  - When using Zeitwerk's 'eager loading' to load the whole gem, no longer fails when it finds the unused/archived 'mdm_classic.rb' file. Thanks to @rorra for reporting this issue.
+  - When using Zeitwerk's 'eager loading' to load the whole gem, no longer fails looking for the JamfProtectPlan OAPISchema, referenced by other schemas
+  - Fixed occasional arg-parsing errors with `.all_names` API object class method.
+
+
 --------
 ## \[5.0.2] 2026-01-24
 

data/lib/jamf/api/classic/api_objects/scopable/scope.rb

@@ -1309,7 +1309,7 @@ module Jamf
         scope_list = part == :limitation ? @limitations[:jamf_ldap_users] : @exclusions[:jamf_ldap_users]
 
         # nil if the list is empty
-        return if scope_list.empty?
+        return if scope_list.pix_empty?
 
         scope_list.include? machine_data[:location][:username]
       end

data/lib/jamf/api/jamf_pro/api_objects/j_category.rb

@@ -0,0 +1,98 @@
+# Copyright 2025 Pixar
+#
+#    Licensed under the terms set forth in the LICENSE.txt file available at
+#    at the root of this project.
+#
+#
+
+# The Module
+module Jamf
+
+  # Classes
+  #####################################
+
+  # A building in the Jamf Pro API
+  #
+  # Alas we can't migrate Jamf::Building to use the JPAPI - it must stay in the
+  # classic API because of how it interacts Scopes in scopable objects over there.
+  #
+  # The parent class is the OAPI object representing a single member of the
+  # collection, i.e. the 'GET_OBJECT' similar to the POST_OBJECT defined in the
+  # class below.
+  #
+  class JCategory < Jamf::OAPISchemas::Category
+
+    include Jamf::CollectionResource
+    extend Jamf::Filterable
+    include Jamf::ChangeLog
+
+    ########### RELATED OAPI OBJECTS
+    # These objects should be OAPIObjects, NOT subclasses of them and
+    # not Collection or Singleton resources.
+    #
+    # TODO: See if these constants can be auto-generated from the
+    # OAPI schema and baked into the parent class
+
+    # The OAPI object class we get back from a 'list' query to get the
+    # whole collection, or a subset of it. It contains a :results key
+    # which is an array of data for objects of the parent class.
+    SEARCH_RESULT_OBJECT = Jamf::OAPISchemas::CategoriesSearchResults
+
+    # The OAPI object class we send with a POST request to make a new member of
+    # the collection in Jamf. This is usually the same as the parent class.
+    POST_OBJECT = Jamf::OAPISchemas::Category
+
+    # The OAPI object class we send with a PUT request to change an object in
+    # Jamf by specifying all its values. Most updates happen this way,
+    # and this is usually the same as the parent class
+    PUT_OBJECT = Jamf::OAPISchemas::Category
+
+    # The OAPI object we send with a PATCH request to change an object in
+    # Jamf by replacing only some of its values. This is never the same as the
+    # parent class, and is usually used when many or most of the data about an
+    # object cannot be changed via the API.
+    # PATCH_OBJECT = Jamf::OAPISchemas::Building
+
+    ############# API PATHS
+    # TODO: See if these paths can be auto-generated from the
+    # OAPI schema and baked into the parent class
+
+    # The path for GETting the list of all objects in the collection, possibly
+    # filtered, sorted, and/or paged
+    # REQUIRED for all collection resources
+    #
+    # GET_PATH, POST_PATH, PUT_PATH, PATCH_PATH, and DELETE_PATH are automatically
+    # assumed from the LIST_PATH if they follow the standards:
+    # - GET_PATH = "#{LIST_PATH}/id"
+    #   - fetch an object from the collection
+    # - POST_PATH = LIST_PATH
+    #   - create a new object in the collection
+    # - PUT_PATH = "#{LIST_PATH}/id"
+    #   - update an object passing all its values back.
+    #     Most objects use this or PATCH but not both
+    # - PATCH_PATH = "#{LIST_PATH}/id"
+    #   - update an object passing some of its values back
+    #     Most objects use this or PUT but not both
+    # - DELETE_PATH = "#{LIST_PATH}/id"
+    #   - delete an object from the collection
+    #
+    # If those paths differ from the standards, the constants must be defined
+    # here
+    #
+    LIST_PATH = 'v1/categories'.freeze
+
+    # See Jamf::CollectionResource::ClassMethods#get_path
+    GET_PATH = LIST_PATH
+
+    # Identifiers not marked in the superclass's OAPI_PROPERTIES constant
+    # which usually only identifies ':id'
+    ALT_IDENTIFIERS = %i[name].freeze
+
+    # Must define this when extending Filterable
+    FILTER_KEYS = %i[
+      name priority
+    ].freeze
+
+  end # class
+
+end # module

data/lib/jamf/api/jamf_pro/api_objects/j_computer_extension_attribute.rb

@@ -0,0 +1,102 @@
+# Copyright 2025 Pixar
+#
+#    Licensed under the terms set forth in the LICENSE.txt file available at
+#    at the root of this project.
+#
+#
+
+# The Module
+module Jamf
+
+  # Classes
+  #####################################
+
+  # A Mobile Device Extension Attribute Definition in the Jamf Pro API
+  #
+  # Alas we can't migrate Jamf::Building to use the JPAPI - it must stay in the
+  # classic API because of how it interacts Scopes in scopable objects over there.
+  #
+  # The parent class is the OAPI object representing a single member of the
+  # collection, i.e. the 'GET_OBJECT' similar to the POST_OBJECT defined in the
+  # class below.
+  #
+  class JComputerExtensionAttribute < Jamf::OAPISchemas::ComputerExtensionAttributes
+
+    include Jamf::CollectionResource
+    include Jamf::ChangeLog
+    include Jamf::DataDependency
+
+    extend Jamf::Filterable
+    extend Jamf::BulkDeletable
+
+    ########### RELATED OAPI OBJECTS
+    # These objects should be OAPIObjects, NOT subclasses of them and
+    # not Collection or Singleton resources.
+    #
+    # TODO: See if these constants can be auto-generated from the
+    # OAPI schema and baked into the parent class
+
+    # The OAPI object class we get back from a 'list' query to get the
+    # whole collection, or a subset of it. It contains a :results key
+    # which is an array of data for objects of the parent class.
+    SEARCH_RESULT_OBJECT = Jamf::OAPISchemas::ComputerExtensionAttributeSearchResults
+
+    # The OAPI object class we send with a POST request to make a new member of
+    # the collection in Jamf. This is usually the same as the parent class.
+    POST_OBJECT = Jamf::OAPISchemas::ComputerExtensionAttribute
+
+    # The OAPI object class we send with a PUT request to change an object in
+    # Jamf by specifying all its values. Most updates happen this way,
+    # and this is usually the same as the parent class
+    PUT_OBJECT = Jamf::OAPISchemas::ComputerExtensionAttribute
+
+    # The OAPI object we send with a PATCH request to change an object in
+    # Jamf by replacing only some of its values. This is never the same as the
+    # parent class, and is usually used when many or most of the data about an
+    # object cannot be changed via the API.
+    # PATCH_OBJECT = Jamf::OAPISchemas::Building
+
+    ############# API PATHS
+    # TODO: See if these paths can be auto-generated from the
+    # OAPI schema and baked into the parent class
+
+    # LIST_PATH
+    # The path for GETting the list of all objects in the collection, possibly
+    # filtered, sorted, and/or paged
+    # REQUIRED for all collection resources
+    #
+    # GET_PATH, POST_PATH, PUT_PATH, PATCH_PATH, and DELETE_PATH are automatically
+    # assumed from the LIST_PATH if they follow the standards:
+    # - GET_PATH = "#{LIST_PATH}/id"
+    #   - fetch an object from the collection
+    # - POST_PATH = LIST_PATH
+    #   - create a new object in the collection
+    # - PUT_PATH = "#{LIST_PATH}/id"
+    #   - update an object passing all its values back.
+    #     Most objects use this or PATCH but not both
+    # - PATCH_PATH = "#{LIST_PATH}/id"
+    #   - update an object passing some of its values back
+    #     Most objects use this or PUT but not both
+    # - DELETE_PATH = "#{LIST_PATH}/id"
+    #   - delete an object from the collection
+    #
+    # If those paths differ from the standards, the constants must be defined
+    # here
+    #
+    LIST_PATH = 'v1/computer-extension-attributes'.freeze
+
+    # See Jamf::CollectionResource::ClassMethods#get_path
+    GET_PATH = LIST_PATH
+
+    # Identifiers not marked in the superclass's OAPI_PROPERTIES constant
+    # which usually only identifies ':id'
+    ALT_IDENTIFIERS = %i[name].freeze
+
+    # Must define this when extending Filterable
+    FILTER_KEYS = %i[
+      id name
+    ].freeze
+
+  end # class
+
+end # module

data/lib/jamf/api/jamf_pro/api_objects/j_mobile_device_extension_attribute.rb

@@ -0,0 +1,101 @@
+# Copyright 2025 Pixar
+#
+#    Licensed under the terms set forth in the LICENSE.txt file available at
+#    at the root of this project.
+#
+#
+
+# The Module
+module Jamf
+
+  # Classes
+  #####################################
+
+  # A Mobile Device Extension Attribute Definition in the Jamf Pro API
+  #
+  # Alas we can't migrate Jamf::Building to use the JPAPI - it must stay in the
+  # classic API because of how it interacts Scopes in scopable objects over there.
+  #
+  # The parent class is the OAPI object representing a single member of the
+  # collection, i.e. the 'GET_OBJECT' similar to the POST_OBJECT defined in the
+  # class below.
+  #
+  class JMobileDeviceExtensionAttribute < Jamf::OAPISchemas::MobileDeviceExtensionAttribute
+
+    include Jamf::CollectionResource
+    include Jamf::ChangeLog
+    include Jamf::DataDependency
+
+    extend Jamf::Filterable
+
+    ########### RELATED OAPI OBJECTS
+    # These objects should be OAPIObjects, NOT subclasses of them and
+    # not Collection or Singleton resources.
+    #
+    # TODO: See if these constants can be auto-generated from the
+    # OAPI schema and baked into the parent class
+
+    # The OAPI object class we get back from a 'list' query to get the
+    # whole collection, or a subset of it. It contains a :results key
+    # which is an array of data for objects of the parent class.
+    SEARCH_RESULT_OBJECT = Jamf::OAPISchemas::MobileDeviceExtensionAttributeResults
+
+    # The OAPI object class we send with a POST request to make a new member of
+    # the collection in Jamf. This is usually the same as the parent class.
+    POST_OBJECT = Jamf::OAPISchemas::MobileDeviceExtensionAttribute
+
+    # The OAPI object class we send with a PUT request to change an object in
+    # Jamf by specifying all its values. Most updates happen this way,
+    # and this is usually the same as the parent class
+    PUT_OBJECT = Jamf::OAPISchemas::MobileDeviceExtensionAttribute
+
+    # The OAPI object we send with a PATCH request to change an object in
+    # Jamf by replacing only some of its values. This is never the same as the
+    # parent class, and is usually used when many or most of the data about an
+    # object cannot be changed via the API.
+    # PATCH_OBJECT = Jamf::OAPISchemas::Building
+
+    ############# API PATHS
+    # TODO: See if these paths can be auto-generated from the
+    # OAPI schema and baked into the parent class
+
+    # LIST_PATH
+    # The path for GETting the list of all objects in the collection, possibly
+    # filtered, sorted, and/or paged
+    # REQUIRED for all collection resources
+    #
+    # GET_PATH, POST_PATH, PUT_PATH, PATCH_PATH, and DELETE_PATH are automatically
+    # assumed from the LIST_PATH if they follow the standards:
+    # - GET_PATH = "#{LIST_PATH}/id"
+    #   - fetch an object from the collection
+    # - POST_PATH = LIST_PATH
+    #   - create a new object in the collection
+    # - PUT_PATH = "#{LIST_PATH}/id"
+    #   - update an object passing all its values back.
+    #     Most objects use this or PATCH but not both
+    # - PATCH_PATH = "#{LIST_PATH}/id"
+    #   - update an object passing some of its values back
+    #     Most objects use this or PUT but not both
+    # - DELETE_PATH = "#{LIST_PATH}/id"
+    #   - delete an object from the collection
+    #
+    # If those paths differ from the standards, the constants must be defined
+    # here
+    #
+    LIST_PATH = 'v1/mobile-device-extension-attributes'.freeze
+
+    # See Jamf::CollectionResource::ClassMethods#get_path
+    GET_PATH = LIST_PATH
+
+    # Identifiers not marked in the superclass's OAPI_PROPERTIES constant
+    # which usually only identifies ':id'
+    ALT_IDENTIFIERS = %i[name].freeze
+
+    # Must define this when extending Filterable
+    FILTER_KEYS = %i[
+      id name
+    ].freeze
+
+  end # class
+
+end # module

data/lib/jamf/api/jamf_pro/api_objects/j_script.rb

@@ -0,0 +1,101 @@
+# Copyright 2025 Pixar
+#
+#    Licensed under the terms set forth in the LICENSE.txt file available at
+#    at the root of this project.
+#
+#
+
+# frozen_string_literal: true
+
+# The Module
+module Jamf
+
+  # Classes
+  #####################################
+
+  # A building in the Jamf Pro API
+  #
+  # Alas we can't migrate Jamf::Building to use the JPAPI - it must stay in the
+  # classic API because of how it interacts Scopes in scopable objects over there.
+  #
+  # The parent class is the OAPI object representing a single member of the
+  # collection, i.e. the 'GET_OBJECT' similar to the POST_OBJECT defined in the
+  # class below.
+  #
+  class JScript < Jamf::OAPISchemas::Script
+
+    include Jamf::CollectionResource
+    include Jamf::ChangeLog
+
+    extend Jamf::Filterable
+
+    ########### RELATED OAPI OBJECTS
+    # These objects should be OAPIObjects, NOT subclasses of them and
+    # not Collection or Singleton resources.
+    #
+    # TODO: See if these constants can be auto-generated from the
+    # OAPI schema and baked into the parent class
+
+    # The OAPI object class we get back from a 'list' query to get the
+    # whole collection, or a subset of it. It contains a :results key
+    # which is an array of data for objects of the parent class.
+    SEARCH_RESULT_OBJECT = Jamf::OAPISchemas::ScriptsSearchResults
+
+    # The OAPI object class we send with a POST request to make a new member of
+    # the collection in Jamf. This is usually the same as the parent class.
+    POST_OBJECT = Jamf::OAPISchemas::Script
+
+    # The OAPI object class we send with a PUT request to change an object in
+    # Jamf by specifying all its values. Most updates happen this way,
+    # and this is usually the same as the parent class
+    PUT_OBJECT = Jamf::OAPISchemas::Script
+
+    # The OAPI object we send with a PATCH request to change an object in
+    # Jamf by replacing only some of its values. This is never the same as the
+    # parent class, and is usually used when many or most of the data about an
+    # object cannot be changed via the API.
+    # PATCH_OBJECT = Jamf::OAPISchemas::Building
+
+    ############# API PATHS
+    # TODO: See if these paths can be auto-generated from the
+    # OAPI schema and baked into the parent class
+
+    # The path for GETting the list of all objects in the collection, possibly
+    # filtered, sorted, and/or paged
+    # REQUIRED for all collection resources
+    #
+    # GET_PATH, POST_PATH, PUT_PATH, PATCH_PATH, and DELETE_PATH are automatically
+    # assumed from the LIST_PATH if they follow the standards:
+    # - GET_PATH = "#{LIST_PATH}/id"
+    #   - fetch an object from the collection
+    # - POST_PATH = LIST_PATH
+    #   - create a new object in the collection
+    # - PUT_PATH = "#{LIST_PATH}/id"
+    #   - update an object passing all its values back.
+    #     Most objects use this or PATCH but not both
+    # - PATCH_PATH = "#{LIST_PATH}/id"
+    #   - update an object passing some of its values back
+    #     Most objects use this or PUT but not both
+    # - DELETE_PATH = "#{LIST_PATH}/id"
+    #   - delete an object from the collection
+    #
+    # If those paths differ from the standards, the constants must be defined
+    # here
+    #
+    LIST_PATH = 'v1/scripts'
+
+    # See Jamf::CollectionResource::ClassMethods#get_path
+    GET_PATH = LIST_PATH
+
+    # Identifiers not marked in the superclass's OAPI_PROPERTIES constant
+    # which usually only identifies ':id'
+    ALT_IDENTIFIERS = %i[name].freeze
+
+    # Must define this when extending Filterable
+    FILTER_KEYS = %i[
+      id name info notes priority categoryId categoryName scriptContents parameter4 parameter5 parameter6 parameter7 parameter8 parameter9 parameter10 parameter11 osRequirements
+    ].freeze
+
+  end # class
+
+end # module

data/lib/jamf/api/jamf_pro/mixins/bulk_deletable.rb

@@ -15,7 +15,7 @@ module Jamf
 
     DELETE_MULTIPLE_ENDPOINT = 'delete-multiple'.freeze
 
-    # Delete multiple objects by providing an array of their
+    # Delete multiple objects by providing an array of their ids
     #
     # @param ids [Array<String,Integer>] The ids to delete
     #
@@ -25,7 +25,7 @@ module Jamf
     # @return [Array<Jamf::Connection::JamfProAPIError::ErrorInfo] Info about any ids
     #   that failed to be deleted.
     #
-    def bulk_delete(ids, cnx: Jamf.cnx)
+    def delete_multiple(ids, cnx: Jamf.cnx)
       ids = [ids] unless ids.is_a? Array
       request_body = { ids: ids.map(&:to_s) }
 
@@ -39,6 +39,8 @@ module Jamf
       end
     end
 
-  end # Lockable
+    alias bulk_delete delete_multiple
+
+  end # BulkDeletable
 
 end # Jamf

data/lib/jamf/api/jamf_pro/mixins/collection_resource.rb

@@ -587,8 +587,10 @@ module Jamf
           create_identifier_list_method attr_name.to_sym, method
           send method, *args
         elsif method.to_s == 'all_names' && defined?(self::OBJECT_NAME_ATTR)
-          define_singleton_method(:all_names) do |_refresh = nil, cnx: Jamf.cnx, cached_list: nil|
-            send "all_#{self::OBJECT_NAME_ATTR}s", *args
+          # define_singleton_method(:all_names) do |_refresh = nil, cnx: Jamf.cnx, cached_list: nil|
+          # send "all_#{self::OBJECT_NAME_ATTR}s", *args
+          define_singleton_method(:all_names) do |refresh = nil, cnx: Jamf.cnx, cached_list: nil|
+            send "all_#{self::OBJECT_NAME_ATTR}s", refresh, cnx: cnx, cached_list: cached_list
           end
           send method, *args
         else
@@ -634,6 +636,7 @@ module Jamf
             end
           end # define_singleton_method
           Jamf.load_msg "Defined method #{self}##{list_method_name}"
+
         else
 
           define_singleton_method(list_method_name) do |*|

data/lib/jamf/api/jamf_pro/mixins/data_dependency.rb

@@ -0,0 +1,63 @@
+# Copyright 2025 Pixar
+#
+#    Licensed under the terms set forth in the LICENSE.txt file available at
+#    at the root of this project.
+#
+#
+
+module Jamf
+
+  # This mixin implements the .../data-dependency endpoints that
+  # some collection resources have (and eventually all will??)
+  # It should be included into classes representing those resources
+  #
+  # data-dependencies list other Jamf Pro objects that use the current object,
+  # e.g. Advanced Searches or Smart Groups that use an Extension Attribute in their
+  # criteria.
+  #
+  module DataDependency
+
+    DATA_DEPENDENCY_ENDPOINT = 'data-dependency'.freeze
+
+    # when this module is included, also extend our Class Methods
+    def self.included(includer)
+      Jamf.load_msg "--> #{includer} is including Jamf::DataDependency"
+      includer.extend(ClassMethods)
+    end
+
+    # Get the dependencies for the current object. This is a list of objects that use this object
+    # and would prevent if from being deleted
+    #
+    # @return [Array<Hash>] Info about any objects that would prevent deletion of the specified object(s).
+    #
+    def data_dependency
+      self.class.data_dependency(id, cnx: @cnx)
+    end
+
+    # Class Methods
+    #####################################
+    module ClassMethods
+
+      def self.extended(extender)
+        Jamf.load_msg "--> #{extender} is extending Jamf::DataDependency::ClassMethods"
+      end
+
+      # Get the dependencies for the specified id. This is a list of objects that use this object
+      # and would prevent if from being deleted
+      #
+      # @param ident [String,Integer] The name, id or other identifier to get dependencies for.
+      #
+      # @param cnx [Jamf::Connection] The connection to use, default: Jamf.cnx
+      #
+      # @return [Array<Hash>] Info about any objects that would prevent deletion of the specified object(s).
+      #
+      def data_dependency(ident, cnx: Jamf.cnx)
+        id = valid_id(ident)
+        cnx.jp_get("#{self::LIST_PATH}/#{id}/#{DATA_DEPENDENCY_ENDPOINT}")[:results]
+      end
+
+    end # ClassMethods
+
+  end # DataDependency
+
+end # Jamf

data/lib/jamf/api/jamf_pro/mixins/sortable.rb

@@ -19,9 +19,9 @@ module Jamf
 
       case sort
       when String
-        "&sort=#{CGI.escape sort}"
+        "#{SORT_PARAM_PREFIX}#{CGI.escape sort}"
       when Array
-        "&sort=#{CGI.escape sort.join(',')}"
+        "#{SORT_PARAM_PREFIX}#{CGI.escape sort.join(',')}"
       else
         raise ArgumentError, 'sort criteria must be a String or Array of Strings'
       end

data/lib/jamf/api/jamf_pro/oapi_schemas/categories_search_results.rb

@@ -0,0 +1,91 @@
+# Copyright 2025 Pixar
+#
+#    Licensed under the Apache License, Version 2.0 (the "Apache License")
+#    with the following modification; you may not use this file except in
+#    compliance with the Apache License and the following modification to it:
+#    Section 6. Trademarks. is deleted and replaced with:
+#
+#    6. Trademarks. This License does not grant permission to use the trade
+#       names, trademarks, service marks, or product names of the Licensor
+#       and its affiliates, except as required to comply with Section 4(c) of
+#       the License and to reproduce the content of the NOTICE file.
+#
+#    You may obtain a copy of the Apache License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the Apache License with the above modification is
+#    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#    KIND, either express or implied. See the Apache License for the specific
+#    language governing permissions and limitations under the Apache License.
+#
+
+
+module Jamf
+
+  # This module is the namespace for all objects defined
+  # in the OAPI JSON schema under the components => schemas key
+  #
+  module OAPISchemas
+
+
+    # OAPI Object Model and Enums for: CategoriesSearchResults
+    #
+    #
+    #
+    # This class was automatically generated from the api/schema
+    # URL path on a Jamf Pro server version 11.9.2-t1726753918
+    #
+    # This class may be used directly, e.g instances of other classes may
+    # use instances of this class as one of their own properties/attributes.
+    #
+    # It may also be used as a superclass when implementing Jamf Pro API
+    # Resources in ruby-jss. The subclasses include appropriate mixins, and
+    # should expand on the basic functionality provided here.
+    #
+    #
+    # Container Objects:
+    # Other object models that use this model as the value in one
+    # of their attributes.
+    #  
+    #
+    # Sub Objects:
+    # Other object models used by this model's attributes.
+    #  - Jamf::OAPISchemas::Category
+    #
+    # Endpoints and Privileges:
+    # API endpoints and HTTP operations that use this object
+    # model, and the Jamf Pro privileges needed to access them.
+    #  - '/v1/categories:GET' needs permissions:
+    #    - Read Categories
+    #
+    #
+    class CategoriesSearchResults < Jamf::OAPIObject
+
+      
+
+      OAPI_PROPERTIES = {
+
+        # @!attribute totalCount
+        #   @return [Integer]
+        totalCount: {
+          class: :integer,
+          minimum: 0
+        },
+
+        # @!attribute results
+        #   @return [Array<Jamf::OAPISchemas::Category>]
+        results: {
+          class: Jamf::OAPISchemas::Category,
+          multi: true,
+          min_items: 0
+        }
+
+      } # end OAPI_PROPERTIES
+
+    end # class CategoriesSearchResults
+
+  end # module OAPISchemas
+
+end # module Jamf