ruby-jss 4.1.1 → 4.2.0

data/lib/jamf/api/classic/api_objects/management_history/mdm_command.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/management_history/mobile_device_app.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/management_history/policy_log.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/management_history/screen_sharing_log.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/management_history/user_location_change.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/management_history.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -204,6 +204,7 @@ module Jamf
 
         if subset
           raise "Subset must be one of :#{@hist_subsets.join ', :'}" unless @hist_subsets.include? subset
+
           subset_rsrc = @hist_rsrc + "/id/#{id}/subset/#{subset}"
           cnx.c_get(subset_rsrc)[@hist_key][subset]
         else
@@ -263,6 +264,7 @@ module Jamf
         hist = management_history(ident, subset, cnx: cnx)
         if status
           raise Jamf::InvalidDataError, 'status must be one of :completed, :pending, or :failed' unless HIST_MDM_STATUSES.include? status
+
           statuses_to_do = [status]
         else
           statuses_to_do = HIST_MDM_STATUSES
@@ -279,7 +281,7 @@ module Jamf
             # but we always set the :status
             cmd[:status] = a_status
 
-            Jamf::ManagementHistory::MdmCommand.new cmd
+            Jamf::ManagementHistory::MdmCommand.new(**cmd)
           end # map do |cmd|
         end # statuses_to_do.each do |a_status|
         result
@@ -358,7 +360,6 @@ module Jamf
         epoch ? JSS.epoch_to_time(epoch) : nil
       end
 
-
       # The history of app store apps  for a computer
       #
       # @param ident [Type] The identifier for the object - id, name, sn, udid, etc.
@@ -378,6 +379,7 @@ module Jamf
         hist = management_history(ident, :mac_app_store_applications, cnx: cnx)
         if status
           raise Jamf::InvalidDataError, 'status must be one of :installed, :pending, or :failed' unless HIST_APP_STATUSES.include? status
+
           statuses_to_do = [status]
         else
           statuses_to_do = HIST_APP_STATUSES
@@ -415,6 +417,7 @@ module Jamf
         hist = management_history(ident, :applications, cnx: cnx)
         if status
           raise Jamf::InvalidDataError, 'status must be one of :installed, :pending, or :failed' unless HIST_APP_STATUSES.include? status
+
           statuses_to_do = [status]
         else
           statuses_to_do = HIST_APP_STATUSES
@@ -480,7 +483,7 @@ module Jamf
       #
       # @see #app_store_app_history
       #
-      def installed_app_store_apps(ident,api: nil, cnx: Jamf.cnx)
+      def installed_app_store_apps(ident, api: nil, cnx: Jamf.cnx)
         cnx = api if api
 
         app_store_app_history(ident, :installed, cnx: cnx)
@@ -522,6 +525,7 @@ module Jamf
         cnx = api if api
 
         raise Jamf::UnsupportedError, 'Only computers have casper imaging logs' unless self == Jamf::Computer
+
         hist = management_history(ident, :casper_imaging_logs, cnx: cnx)
         hist.map! { |evt| Jamf::ManagementHistory::CasperImagingLog.new evt }
       end
@@ -539,6 +543,7 @@ module Jamf
         cnx = api if api
 
         raise Jamf::UnsupportedError, 'Only computers have casper remote logs' unless self == Jamf::Computer
+
         hist = management_history(ident, :casper_remote_logs, cnx: cnx)
         hist.map! { |evt| Jamf::ManagementHistory::CasperRemoteLog.new evt }
       end
@@ -556,6 +561,7 @@ module Jamf
         cnx = api if api
 
         raise Jamf::UnsupportedError, 'Only computers have usage logs' unless self == Jamf::Computer
+
         hist = management_history(ident, :computer_usage_logs, cnx: cnx)
         hist.map! { |evt| Jamf::ManagementHistory::ComputerUsageLog.new evt }
       end
@@ -574,6 +580,7 @@ module Jamf
         cnx = api if api
 
         raise Jamf::UnsupportedError, 'Only computers have screen sharing logs' unless self == Jamf::Computer
+
         hist = management_history(ident, :screen_sharing_logs, cnx: cnx)
         hist.map! { |evt| Jamf::ManagementHistory::ScreenSharingLog.new evt }
       end
@@ -591,8 +598,9 @@ module Jamf
         cnx = api if api
 
         raise Jamf::UnsupportedError, 'Only computers have policy logs' unless self == Jamf::Computer
+
         hist = management_history(ident, :policy_logs, cnx: cnx)
-        hist.map! { |evt| Jamf::ManagementHistory::PolicyLog.new evt }
+        hist.map! { |evt| Jamf::ManagementHistory::PolicyLog.new(**evt) }
       end
 
       # The array from .policy_logs, limited to status = :completed
@@ -632,6 +640,7 @@ module Jamf
         hist = management_history(ident, :ebooks, cnx: cnx)
         if status
           raise Jamf::InvalidDataError, 'status must be one of :installed, :pending, or :failed' unless HIST_APP_STATUSES.include? status
+
           statuses_to_do = [status]
         else
           statuses_to_do = HIST_APP_STATUSES

data/lib/jamf/api/classic/api_objects/matchable.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -26,10 +26,9 @@
 ###
 module Jamf
 
-### A mix-in module providing access to the "match" resources for some
-### JSS API objects, like computers and mobile devices.
-###
-
+  ### A mix-in module providing access to the "match" resources for some
+  ### JSS API objects, like computers and mobile devices.
+  ###
 
   #####################################
   ### Module Variables
@@ -63,7 +62,7 @@ module Jamf
 
     MATCHABLE = true
 
-    MATCH_RSRC = "match"
+    MATCH_RSRC = 'match'
 
     #####################################
     ###  Variables
@@ -89,7 +88,7 @@ module Jamf
     def match(term, api: nil, cnx: Jamf.cnx)
       cnx = api if api
 
-      raise Jamf::InvalidDataError, "Match term may not be empty" if term.to_s.empty?
+      raise Jamf::InvalidDataError, 'Match term may not be empty' if term.to_s.empty?
 
       rsrc = "#{self::RSRC_BASE}/#{Jamf::Matchable::MATCH_RSRC}/#{CGI.escape term.to_s}"
       cnx.c_get(rsrc)[self::RSRC_LIST_KEY]

data/lib/jamf/api/classic/api_objects/mdm.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/mobile_device.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/mobile_device_application.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -177,6 +177,9 @@ module Jamf
     #   take over managing it?
     attr_reader :take_over_management
 
+    # @return [Boolean] Can a user delete this app once it's installed?
+    attr_reader :allow_user_to_delete
+
     # @return [Boolean] Does the app itself come from outside the JSS?
     attr_reader :host_externally
 
@@ -216,6 +219,7 @@ module Jamf
       @keep_description_and_icon_up_to_date = general[:keep_description_and_icon_up_to_date]
       @free = general[:free]
       @take_over_management = general[:take_over_management]
+      @allow_user_to_delete = general[:allow_user_to_delete]
       @host_externally = general[:host_externally]
       @external_url = general[:external_url]
       @configuration_prefs = @init_data[:app_configuration][:preferences]
@@ -400,6 +404,20 @@ module Jamf
       @need_to_update = true
     end
 
+    # Set whether or not the user should be able to delete this app
+    #
+    # @param new_val[Boolean] The new value
+    #
+    # @return [void]
+    #
+    def allow_user_to_delete=(new_val)
+      return nil if new_val == @allow_user_to_delete
+      raise Jamf::InvalidDataError, 'New value must be true or false' unless new_val.jss_boolean?
+
+      @allow_user_to_delete = new_val
+      @need_to_update = true
+    end
+
     # Sets the version (only usable if you are hosting the .ipa externally)
     #
     # @param new_val[String] the version
@@ -557,12 +575,15 @@ module Jamf
       gen.add_element('keep_description_and_icon_up_to_date').text = @keep_description_and_icon_up_to_date
       gen.add_element('free').text = @free
       gen.add_element('take_over_management').text = @take_over_management
+      gen.add_element('allow_user_to_delete').text = @allow_user_to_delete
       gen.add_element('host_externally').text = @host_externally
       gen.add_element('bundle_id').text = @bundle_id if @host_externally
       gen.add_element('version').text = @version if @host_externally
       gen.add_element('external_url').text = @external_url
-      config = gen.add_element('configuration')
+
+      config = obj.add_element('app_configuration')
       config.add_element('preferences').text = @configuration_prefs
+
       obj << @scope.scope_xml
       add_category_to_xml doc
       add_self_service_xml doc

data/lib/jamf/api/classic/api_objects/mobile_device_configuration_profile.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")

data/lib/jamf/api/classic/api_objects/mobile_device_extension_attribute.rb

@@ -1,4 +1,4 @@
-# Copyright 2023 Pixar
+# 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
@@ -25,7 +25,6 @@ module Jamf
   # Classes
   #####################################
 
-
   # An extension attribute as defined in the JSS
   #
   # @see Jamf::ExtensionAttribute
@@ -51,7 +50,8 @@ module Jamf
     TARGET_CLASS = Jamf::MobileDevice
 
     # A criterion that will return all members of the TARGET_CLASS
-    ALL_TARGETS_CRITERION = Jamf::Criteriable::Criterion.new(and_or: 'and', name: 'Last Inventory Update', search_type: 'after (yyyy-mm-dd)', value: '2003-01-01')
+    ALL_TARGETS_CRITERION = Jamf::Criteriable::Criterion.new(and_or: 'and', name: 'Last Inventory Update', search_type: 'after (yyyy-mm-dd)', 
+                                                             value: '2003-01-01')
 
     # the object type for this object in
     # the object history table.

data/lib/jamf/api/classic/api_objects/mobile_device_group.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -63,7 +63,7 @@ module Jamf
     #####################################
 
     ### The base for REST resources of this class
-    RSRC_BASE = "mobiledevicegroups"
+    RSRC_BASE = 'mobiledevicegroups'
 
     ### the hash key used for the JSON list output of all objects in the JSS
     RSRC_LIST_KEY = :mobile_device_groups
@@ -111,7 +111,7 @@ module Jamf
     ### @return [Array<String>] the member udids
     ###
     def member_udids
-      @members.map{|m| m[:udid]}
+      @members.map { |m| m[:udid] }
     end
 
     ###
@@ -120,7 +120,7 @@ module Jamf
     ### @return [Array<String>] the member serial numbers
     ###
     def member_serial_numbers
-      @members.map{|m| m[:serial_number]}
+      @members.map { |m| m[:serial_number] }
     end
 
     ###
@@ -129,7 +129,7 @@ module Jamf
     ### @return [Array<String>] the member mac addresses
     ###
     def member_mac_addresses
-      @members.map{|m| m[:mac_address]}
+      @members.map { |m| m[:mac_address] }
     end
 
     ###
@@ -138,14 +138,13 @@ module Jamf
     ### @return [Array<String>] the member wifi mac addresses
     ###
     def member_wifi_mac_addresses
-      @members.map{|m| m[:wifi_mac_address]}
+      @members.map { |m| m[:wifi_mac_address] }
     end
 
     #####################################
     ### Private Instance Methods
     #####################################
 
-
   end # class ComputerGroup
 
 end # module

data/lib/jamf/api/classic/api_objects/netboot_server.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -61,7 +61,7 @@ module Jamf
     #####################################
 
     ### The base for REST resources of this class
-    RSRC_BASE = "netbootservers"
+    RSRC_BASE = 'netbootservers'
 
     ### the hash key used for the JSON list output of all objects in the JSS
     RSRC_LIST_KEY = :netboot_servers
@@ -115,7 +115,6 @@ module Jamf
     ### @return [String]  e.g."Intel/x86"
     attr_reader :target_platform
 
-
     #####################################
     ### Constructor
     #####################################
@@ -138,14 +137,12 @@ module Jamf
       @share_point = @init_data[:share_point]
       @specific_image = @init_data[:specific_image]
       @target_platform = @init_data[:target_platform]
-
     end
 
     #####################################
     ### Public Instance Methods
     #####################################
 
-
   end # class NetbootServer
 
 end # module

data/lib/jamf/api/classic/api_objects/network_segment.rb

@@ -1,4 +1,4 @@
-### Copyright 2023 Pixar
+### Copyright 2025 Pixar
 
 ###
 ###    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -197,6 +197,7 @@ module Jamf
         validate_ip_range(startip, endip)
       else
         raise ArgumentError, 'Must provide ending_address:, mask:, cidr: or a masked starting_address:' unless starting_address.include? '/'
+
         subnet = IPAddr.new starting_address
         startip = subnet.to_range.first.mask 32
         endip = subnet.to_range.last.mask 32
@@ -433,6 +434,7 @@ module Jamf
     def overlap?(other_segment)
       raise TypeError, 'Argument must be a Jamf::NetworkSegment' unless \
         other_segment.is_a? Jamf::NetworkSegment
+
       other_range = other_segment.range
       range.include?(other_range.begin) || range.include?(other_range.end)
     end
@@ -464,6 +466,7 @@ module Jamf
     def ==(other)
       raise TypeError, 'Argument must be a Jamf::NetworkSegment' unless \
         other.is_a? Jamf::NetworkSegment
+
       range == other.range
     end
 
@@ -496,6 +499,7 @@ module Jamf
     ###
     def override_buildings=(newval)
       raise Jamf::InvalidDataError, 'New value must be boolean true or false' unless Jamf::TRUE_FALSE.include? newval
+
       @override_buildings = newval
       @need_to_update = true
     end
@@ -512,7 +516,7 @@ module Jamf
           Jamf::BLANK
         else
           id = Jamf::Department.valid_id newval
-          raise Jamf::MissingDataError , "No department matching '#{newval}' in the JSS" unless id
+          raise Jamf::MissingDataError, "No department matching '#{newval}' in the JSS" unless id
 
           Jamf::Department.map_all_ids_to(:name)[id]
         end
@@ -529,6 +533,7 @@ module Jamf
     ###
     def override_departments=(newval)
       raise Jamf::InvalidDataError, 'New value must be boolean true or false' unless Jamf::TRUE_FALSE.include? newval
+
       @override_departments = newval
       @need_to_update = true
     end

data/lib/jamf/api/classic/api_objects/osx_configuration_profile.rb

@@ -1,4 +1,4 @@
-# Copyright 2023 Pixar
+# Copyright 2025 Pixar
 
 #
 #    Licensed under the Apache License, Version 2.0 (the "Apache License")
@@ -23,7 +23,6 @@
 #
 #
 
-#
 module Jamf
 
   # Classes
@@ -94,9 +93,10 @@ module Jamf
     def level=(new_val)
       return nil if @level == new_val
       raise Jamf::InvalidDataError, "New value must be one of '#{LEVELS.join("' '")}'" unless LEVELS.include? new_val
+
       @level = new_val
       @need_to_update = true
-    end #
+    end
 
     # Private Instance Methods
     ###################################