usps-imis-api 0.11.39 → 0.11.40

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 490015ad8f86bea9afbc0eb9065a6b5e92432bc7c3bca8ec7faa2a6e61c2bd24
-  data.tar.gz: 5376fcdd8ea7e4a3e31832ecc8b399b51949d39449f0be5a1d74ca24b8452b26
+  metadata.gz: '09b163c4f02496fa2205d3ed3056f2e0e7bf7306b63f2176390a498503ca32d3'
+  data.tar.gz: c5e9dd8def7221e9f63f71e277ebbdbd3d6b8f080d93af5a5494b50149b649cd
 SHA512:
-  metadata.gz: 7cfc0becb2b9969998b472970bd07ca0ebdd8427d64bf74e17adf8aa7be59e11c1db21d77d853b567a8397f61f7fa816a7977f0c0873b7269d9ac755e4cf179c
-  data.tar.gz: a26a68da79680d9b2f095d42caafee5b2a62bfd5ac9c01b278f367a7a996248dff7ff173f5498da46231e2e66cf7a8c8b26b45dc5471149e0e0e14a406bd1b54
+  metadata.gz: 2cf04565727807685ef016b823bdd798ac453ed9510d32b430c4b6e286b9f71d01ee6d2d08d15bcdfc3c55dc8168e42f224c9c2fddec2e9933c4e03ee34e03ed
+  data.tar.gz: b0a7eeb21ce375a205b1783f839eba1c02aa2040091319845729d33680e49cb43a373a256e3ac002037222516ef111bf8d08903181458c0e8a5fcc1180b30772

data/lib/usps/imis/api.rb

@@ -181,7 +181,7 @@ module Usps
       #
       # If no block is given, this returns the specified +BusinessObject+.
       #
-      # @param business_object_name [String] Name of the business object
+      # @param business_object_name [String, Symbol] Name of the business object
       # @param ordinal [Integer] Ordinal to build override ID param of the URL (e.g. used for Panels)
       #
       # @return [Usps::Imis::BusinessObject]

data/lib/usps/imis/blank_object.rb

@@ -20,13 +20,15 @@ module Usps
 
       # Build a blank object for the current iMIS ID
       #
-      def build(&) = payload_header.merge(Properties.build(parent.api.record_id.to_s, @ordinal&.to_s, &))
+      # @param hash [Hash] Hash version of props to set (block takes priority)
+      #
+      def build(hash = {}, &) = header.merge(Properties.build(parent.api.record_id.to_s, @ordinal&.to_s, hash, &))
 
     private
 
       def identity_type = 'System.Collections.ObjectModel.Collection`1[[System.String, mscorlib]], mscorlib'
 
-      def payload_header
+      def header
         {
           '$type' => 'Asi.Soa.Core.DataContracts.GenericEntityData, Asi.Contracts',
           'EntityTypeName' => parent.business_object_name,

data/lib/usps/imis/business_object.rb

@@ -35,7 +35,7 @@ module Usps
       #
       def initialize(api, business_object_name, ordinal: nil)
         @api = api
-        @business_object_name = business_object_name
+        @business_object_name = business_object_name.to_s
         @ordinal = ordinal
         @logger ||= Imis.logger('BusinessObject')
       end
@@ -62,7 +62,7 @@ module Usps
       #
       # If +fields+ is provided, will return only those field values
       #
-      # @param fields [String] Field names to return
+      # @param fields [Array<String, Symbol>] Field names to return
       #
       # @return [Usps::Imis::Data, Array<Usps::Imis::Data>] Response data from the API
       #
@@ -71,23 +71,23 @@ module Usps
 
       # Get a single named field from a business object for the current member
       #
-      # @param field [String] Field name to return
+      # @param field [String, Symbol] Field name to return
       #
       # @return Response data field value from the API
       #
-      def get_field(field) = raw_object[field]
+      def get_field(field) = raw_object[field.to_s]
       alias fetch get_field
       alias [] get_field
 
       # Get named fields from a business object for the current member
       #
-      # @param names [Array<String>] Field names to return
+      # @param names [Array<String, Symbol>] Field names to return
       #
       # @return [Array] Response data from the API
       #
       def get_fields(*fields)
         values = raw_object
-        fields.map { values[it] }
+        fields.map { values[it.to_s] }
       end
       alias fetch_all get_fields
 
@@ -139,11 +139,13 @@ module Usps
 
       # Build a blank object for the current iMIS ID
       #
-      def blank_object(&) = BlankObject.new(self).build(&)
+      def blank_object(hash = {}, &) = BlankObject.new(self).build(hash, &)
 
       # Create a business object for the current member, starting with a blank object and building properties
       #
-      def post_from_blank(&) = post(blank_object(&))
+      # @param hash [Hash] Hash version of props to set (block takes priority)
+      #
+      def post_from_blank(hash = {}, &) = post(blank_object(hash, &))
       alias create_from_blank post_from_blank
 
       # Ruby 3.5 instance variable filter
@@ -173,6 +175,8 @@ module Usps
       def filter_fields(fields)
         block_not_supported!
 
+        fields = fields.transform_keys(&:to_s)
+
         existing = get
 
         JSON.parse(JSON.dump(existing)).tap do |updated|

data/lib/usps/imis/properties.rb

@@ -9,14 +9,16 @@ module Usps
       #
       # @param id [String] iMIS ID to include in the properties before running the block
       # @param ordinal [String] Ordinal to include in the properties before running the block
+      # @param hash [Hash] Hash version of props to set (block takes priority)
       #
-      def self.build(id = nil, ordinal = nil, &) = new.build(id, ordinal, &)
+      def self.build(id = nil, ordinal = nil, hash = {}, &) = new.build(id, ordinal, hash, &)
 
       # Wrap value in the API-internal type structure
       #
       def self.wrap(value)
         case value
         when String then value
+        when Symbol then value.to_s
         when Time, DateTime then value.strftime('%Y-%m-%dT%H:%I:%S')
         when Integer then { '$type' => 'System.Int32', '$value' => value }
         when true, false then { '$type' => 'System.Boolean', '$value' => value }
@@ -29,14 +31,18 @@ module Usps
       #
       # @param id [String] iMIS ID to include in the properties before running the block
       # @param ordinal [String] Ordinal to include in the properties before running the block
+      # @param hash [Hash] Hash version of props to set (block takes priority)
+      # @yield Block context to define additional properties with +add+
       #
-      def build(id = nil, ordinal = nil)
+      def build(id = nil, ordinal = nil, hash = {})
         @properties ||= []
 
         add('ID', id) if id
         add('Ordinal', ordinal) if ordinal
 
-        yield(self)
+        hash.each { |key, value| add(key, value) }
+
+        yield(self) if block_given?
 
         {
           'Properties' => {
@@ -48,10 +54,15 @@ module Usps
 
       # Add an individual property to the field
       #
+      # The last definition for a given property name will be used
+      #
       def add(name, value)
+        existing = @properties.find { it['Name'] == name.to_s }
+        @properties.delete(existing) if existing
+
         @properties << {
           '$type' => 'Asi.Soa.Core.DataContracts.GenericPropertyData, Asi.Contracts',
-          'Name' => name,
+          'Name' => name.to_s,
           'Value' => self.class.wrap(value)
         }
       end

data/lib/usps/imis/version.rb

@@ -2,6 +2,6 @@
 
 module Usps
   module Imis
-    VERSION = '0.11.39'
+    VERSION = '0.11.40'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: usps-imis-api
 version: !ruby/object:Gem::Version
-  version: 0.11.39
+  version: 0.11.40
 platform: ruby
 authors:
 - Julian Fiander