usps-imis-api 0.11.22 → 1.0.0.pre.rc.1

data/lib/usps/imis/errors/command_line_error.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Errors
-      # Exception raised by the command line interface
-      #
-      class CommandLineError < Error; end
-    end
-  end
-end

data/lib/usps/imis/errors/config_error.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Errors
-      # Exception raised for invalid configuration
-      #
-      class ConfigError < Error; end
-    end
-  end
-end

data/lib/usps/imis/errors/locked_id_error.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Errors
-      # Exception raised when attempting to change the iMIS ID while it is locked
-      #
-      class LockedIdError < Error
-        def initialize = super(message)
-
-        def message = 'Cannot change iMIS ID while locked'
-      end
-    end
-  end
-end

data/lib/usps/imis/errors/mapper_error.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Errors
-      # Exception raised by a +Mapper+
-      #
-      class MapperError < Error
-        # Create a new instance of +MapperError+
-        #
-        # @param metadata [Hash] Additional call-specific metadata to pass through to Bugsnag
-        #
-        def initialize(metadata = {})
-          @metadata = metadata
-          super(message, metadata)
-        end
-
-        # Exception message including the unrecognized field
-        #
-        def message
-          <<~MESSAGE.chomp
-            Mapper does not recognize field: "#{metadata[:field_key]}".
-            Please report what data you are attempting to work with to ITCom leadership.
-          MESSAGE
-        end
-      end
-    end
-  end
-end

data/lib/usps/imis/errors/missing_id_error.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Errors
-      # Exception raised when attempting to access a +BusinessObject+ without an iMIS ID
-      #
-      class MissingIdError < Error
-        def initialize = super(message)
-
-        def message = 'Cannot access an individual Business Object without an iMIS ID'
-      end
-    end
-  end
-end

data/lib/usps/imis/errors/not_found_error.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Errors
-      # Exception raised when the requested object cannot be found
-      #
-      class NotFoundError < Error; end
-    end
-  end
-end

data/lib/usps/imis/errors/panel_unimplemented_error.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Errors
-      # Exception raised when a panel is missing required method definitions
-      #
-      class PanelUnimplementedError < Error
-        # Create a new instance of +PanelUnimplementedError+ from the class name and missing method
-        #
-        # @param class_name [String] Name of the Panel class that is missing a method definition
-        # @param method [String] Method definition that is not defined on the Panel
-        #
-        def self.from(class_name, method) = new(class_name, method)
-
-        # Create a new instance of +PanelUnimplementedError+
-        #
-        # @param class_name [String] Name of the Panel class that is missing a method definition
-        # @param method [String] Method definition that is not defined on the Panel
-        # @param metadata [Hash] Additional call-specific metadata to pass through to Bugsnag
-        #
-        def initialize(class_name, method, metadata = {})
-          @class_name = class_name
-          @method = method
-          super(message, metadata)
-        end
-
-        # Exception message including the undefined method
-        #
-        def message = "#{@class_name} must implement ##{@method}"
-      end
-    end
-  end
-end

data/lib/usps/imis/errors/unexpected_property_type_error.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Errors
-      # Exception raised when attempting to wrap an unexpected property type
-      #
-      class UnexpectedPropertyTypeError < Error
-        # Create a new instance of +UnexpectedPropertyTypeError+ from an unexpected value
-        #
-        # @param value Unexpected value
-        #
-        def self.from(value) = new(value)
-
-        # Create a new instance of +UnexpectedPropertyTypeError+
-        #
-        # @param value Unexpected value
-        # @param metadata [Hash] Additional call-specific metadata to pass through to Bugsnag
-        #
-        def initialize(value, metadata = {})
-          @value = value
-          super(message, metadata)
-        end
-
-        # Exception message including the undefined method
-        #
-        def message = "Unexpected property type: #{@value.inspect}"
-      end
-    end
-  end
-end

data/lib/usps/imis/logger.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'logger_formatter'
-require_relative 'logger_helpers'
-
-module Usps
-  module Imis
-    # Formatted logger with additional helpers
-    #
-    class Logger < ::Logger
-      include LoggerHelpers
-
-      def initialize(...)
-        super
-        self.formatter = LoggerFormatter.new
-      end
-    end
-  end
-end

data/lib/usps/imis/logger_formatter.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    # Formats log statements
-    #
-    class LoggerFormatter < ::Logger::Formatter
-      include ::ActiveSupport::TaggedLogging::Formatter
-
-      def call(severity, time, _progname, message)
-        log_chunks = [
-          format('%-5s', severity.to_s),
-          "[#{$PROCESS_ID}]",
-          "[#{time.strftime('%Y-%m-%d %H:%M:%S %Z')}]",
-          'iMIS Ruby API',
-          '|',
-          formatted_tags,
-          '|',
-          message.to_s.sub(/^#{Regexp.escape(tags_text)}/, '')
-        ]
-        "#{log_chunks.join(' ')}\n"
-      end
-
-    private
-
-      def formatted_tags
-        tags = current_tags || []
-        tags&.any? ? tags.join(' | ') : ''
-      end
-    end
-  end
-end

data/lib/usps/imis/logger_helpers.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    # Formatted logger helpers
-    #
-    module LoggerHelpers
-      def multiline(string)
-        string.split("\n").each { |line| debug(line) }
-      end
-
-      def json(data)
-        tagged('JSON') { multiline(JSON.pretty_generate(data)) }
-      end
-    end
-  end
-end

data/lib/usps/imis/mocks/business_object.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Mocks
-      # Mock data response for testing
-      #
-      class BusinessObject
-        attr_reader :fields
-
-        def initialize(**fields)
-          @fields = fields.transform_keys(&:to_s)
-        end
-
-        def get
-          Usps::Imis::Properties.build do |props|
-            fields.each { |name, value| props.add(name, value) }
-          end
-        end
-        alias read get
-
-        def get_field(name) = fields[name]
-        alias fetch get_field
-        alias [] get_field
-
-        def get_fields(*field_names) = field_names.map { fields[it] }
-        alias fetch_all get_fields
-
-        def put_fields(data)
-          Usps::Imis::Properties.build do |props|
-            fields.merge(data.transform_keys(&:to_s)).each { |name, value| props.add(name, value) }
-          end
-        end
-        alias patch put_fields
-
-        def put(data) = data
-        alias update put
-
-        def post(data) = data
-        alias create post
-
-        def delete = ''
-        alias destroy delete
-      end
-    end
-  end
-end

data/lib/usps/imis/mocks.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'mocks/business_object'
-
-module Usps
-  module Imis
-    # Namespace for all Mocks
-    #
-    module Mocks; end
-  end
-end

data/lib/usps/imis/panels/base_panel.rb

@@ -1,158 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Panels
-      # Base class for configuring Panels
-      #
-      class BasePanel
-        # The parent +Api+ object
-        #
-        attr_reader :api
-
-        # Tagged logger
-        #
-        attr_reader :logger
-
-        def initialize(api = nil, imis_id: nil)
-          @api = api || Api.new
-          @api.imis_id = imis_id if imis_id
-          @logger ||= Imis.logger('Panel')
-        end
-
-        # Get a specific object from the Panel
-        #
-        # If +fields+ is provided, will return only those field values
-        #
-        # @param fields [String] Field names to return
-        #
-        # @param ordinal [Integer] The ordinal identifier for the desired object
-        #
-        # @return [Usps::Imis::Data, Array<Usps::Imis::Data>] Response data from the API
-        #
-        def get(ordinal, *fields) = api.on(business_object, ordinal:).get(*fields)
-        alias read get
-
-        # Get a single named field from a Panel for the current member
-        #
-        # @param ordinal [Integer] The ordinal identifier for the desired object
-        # @param field [String] Field name to return
-        #
-        # @return Response data field value from the API
-        #
-        def get_field(ordinal, field) = api.on(business_object, ordinal:).get_field(field)
-        alias fetch get_field
-        alias [] get_field
-
-        # Get named fields from a Panel for the current member
-        #
-        # @param ordinal [Integer] The ordinal identifier for the desired object
-        # @param fields [Array<String>] Field names to return
-        #
-        # @return [Array] Response data from the API
-        #
-        def get_fields(ordinal, *fields) = api.on(business_object, ordinal:).get_fields(*fields)
-        alias fetch_all get_fields
-
-        # Update a single named field on a business object for the current member
-        #
-        # @param ordinal [Integer] The ordinal identifier for the desired object
-        # @param field [String] Name of the field
-        # @param value Value of the field
-        #
-        # @return [Usps::Imis::Data] Response data from the API
-        #
-        def put_field(ordinal, field, value) = api.on(business_object, ordinal:).put_field(field, value)
-        alias []= put_field
-
-        # Update only specific fields on a Panel for the current member
-        #
-        # @param ordinal [Integer] The ordinal identifier for the desired object
-        # @param fields [Hash] Conforms to pattern +{ field_key => value }+
-        #
-        # @return [Usps::Imis::Data] Response data from the API
-        #
-        def put_fields(ordinal, fields) = api.on(business_object, ordinal:).put_fields(fields)
-        alias patch put_fields
-
-        # Update an existing object in the Panel
-        #
-        # @param data [Hash] The record data for the desired object -- including the required
-        #                    +ordinal+ identifier
-        #
-        # @return [Usps::Imis::Data] Response data from the API
-        #
-        def put(data) = api.on(business_object, ordinal: data[:ordinal]).put(payload(data))
-        alias update put
-
-        # Create a new object in the Panel
-        #
-        # @param data [Hash] The record data for the desired object
-        #
-        # @return [Usps::Imis::Data] Response data from the API
-        #
-        def post(data) = api.on(business_object).post(payload(data))
-        alias create post
-
-        # Remove a specific object from the Panel
-        #
-        # @param ordinal [Integer] The ordinal identifier for the desired object
-        #
-        # @return [true] Only on success response (i.e. blank string from the API)
-        #
-        def delete(ordinal) = api.on(business_object, ordinal:).delete
-        alias destroy delete
-
-        # Ruby 3.5 instance variable filter
-        #
-        def instance_variables_to_inspect = instance_variables - %i[@api @logger]
-
-      private
-
-        def business_object
-          raise Errors::PanelUnimplementedError.from(self.class.name, 'business_object')
-        end
-
-        def payload(_data)
-          raise Errors::PanelUnimplementedError.from(self.class.name, 'payload(data)')
-        end
-
-        def payload_header(data)
-          {
-            '$type' => 'Asi.Soa.Core.DataContracts.GenericEntityData, Asi.Contracts',
-            'EntityTypeName' => business_object,
-            'PrimaryParentEntityTypeName' => 'Party',
-            'Identity' => identity(data[:ordinal]),
-            'PrimaryParentIdentity' => primary_parent_identity
-          }
-        end
-
-        def identity(ordinal = nil)
-          {
-            '$type' => 'Asi.Soa.Core.DataContracts.IdentityData, Asi.Contracts',
-            'EntityTypeName' => business_object,
-            'IdentityElements' => {
-              '$type' => identity_type,
-              '$values' => [api.imis_id.to_s, ordinal&.to_s].compact
-            }
-          }
-        end
-
-        def primary_parent_identity
-          {
-            '$type' => 'Asi.Soa.Core.DataContracts.IdentityData, Asi.Contracts',
-            'EntityTypeName' => 'Party',
-            'IdentityElements' => {
-              '$type' => identity_type,
-              '$values' => [api.imis_id.to_s]
-            }
-          }
-        end
-
-        def identity_type = 'System.Collections.ObjectModel.Collection`1[[System.String, mscorlib]], mscorlib'
-
-        def build_payload(data, &) = payload_header(data).merge(Properties.build(&))
-      end
-    end
-  end
-end

data/lib/usps/imis/panels/education.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Panels
-      # Panel for accessing the Educational completions business object
-      #
-      class Education < BasePanel
-      private
-
-        def business_object
-          'ABC_ASC_Educ'
-        end
-
-        def payload(data)
-          build_payload(data) do |props|
-            props.add 'ID', api.imis_id.to_s
-            props.add 'Ordinal', data[:ordinal] if data[:ordinal]
-            props.add 'ABC_EDUC_THRU_DATE', data[:thru_date] || '0001-01-01T00:00:00'
-            props.add 'ABC_ECertificate', data[:certificate]
-            props.add 'ABC_Educ_Description', data[:description]
-            props.add 'ABC_Educ_Effective_Date', data[:effective_date]
-            props.add 'ABC_Educ_Source_System', data[:source]
-            props.add 'ABC_Educ_Transaction_Date', Time.now
-            props.add 'ABC_Other_Code', data[:code]
-            props.add 'ABC_Product_Code', data[:type_code]
-            props.add 'ABC_TYPE', data[:abc_type_code] || 'EDUC'
-          end
-        end
-      end
-    end
-  end
-end

data/lib/usps/imis/panels/vsc.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    module Panels
-      # Panel for accessing the annual VSC completed counts business object
-      #
-      class Vsc < BasePanel
-      private
-
-        def business_object
-          'ABC_ASC_Vessel_Safety_Checks'
-        end
-
-        def payload(data)
-          build_payload(data) do |props|
-            props.add 'ID', api.imis_id.to_s
-            props.add 'Ordinal', data[:ordinal] if data[:ordinal]
-            props.add 'Source_System', 'Manual ITCom Entry'
-            props.add 'ABC_ECertificate', data[:certificate]
-            props.add 'Activity_Type', 'VSC'
-            props.add 'Description', 'Vessel Safety Checks'
-            props.add 'Effective_Date', "#{data[:year]}-12-01T00:00:00"
-            props.add 'Quantity', data[:count]
-            props.add 'Thru_Date', "#{data[:year]}-12-31T00:00:00"
-            props.add 'Transaction_Date', Time.now
-          end
-        end
-      end
-    end
-  end
-end

data/lib/usps/imis/panels.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'panels/base_panel'
-require_relative 'panels/vsc'
-require_relative 'panels/education'
-
-module Usps
-  module Imis
-    # Namespace for all Panels
-    #
-    module Panels
-      # Convenience accessor for available Panel objects
-      #
-      # @param api [Api] Parent to use for making requests
-      #
-      def self.all(api = Api.new)
-        panels = constants.reject { it == :BasePanel }
-
-        Struct
-          .new(*panels.map { it.to_s.underscore.to_sym })
-          .new(*panels.map { const_get(it).new(api) })
-      end
-    end
-  end
-end

data/lib/usps/imis/properties.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-module Usps
-  module Imis
-    # Constructor for the Properties field
-    #
-    class Properties
-      # Build the data for a new Properties field
-      #
-      def self.build(&) = new.build(&)
-
-      # Wrap value in the API-internal type structure
-      #
-      def self.wrap(value)
-        case value
-        when String then value
-        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 }
-        else
-          raise Errors::UnexpectedPropertyTypeError.from(value)
-        end
-      end
-
-      # Build the data for the Properties field
-      #
-      def build
-        yield(self)
-
-        {
-          'Properties' => {
-            '$type' => 'Asi.Soa.Core.DataContracts.GenericPropertyDataCollection, Asi.Contracts',
-            '$values' => @properties
-          }
-        }
-      end
-
-      # Add an individual property to the field
-      #
-      def add(name, value)
-        @properties ||= []
-        @properties << {
-          '$type' => 'Asi.Soa.Core.DataContracts.GenericPropertyData, Asi.Contracts',
-          'Name' => name,
-          'Value' => self.class.wrap(value)
-        }
-      end
-    end
-  end
-end