amsi 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ba53ba480c086ec1e01d65348931bf4708372e953204b10185ac6026705a8883
+  data.tar.gz: '0875be24b6bc5bcf8b7d0931cf78b1746a0e042348dd8c71b112d603cff851ba'
+SHA512:
+  metadata.gz: 328e40dde433775dc50915974d5ad85de748ffe7e5814951acf8be84a24c68776f0d6c94d9f057e0f4a4b6d004a00fbf4f577e6a509d056944fd1221047230df
+  data.tar.gz: 6a3dde90f9b980bf9b3277c37f7cb4ae58a0b40bf1c1e01e074252f4b64e016ac5fe1d0f74925b8c85a1b2e062ec2b7036c2506484a548211db9273a13422b20

data/.ci

@@ -0,0 +1,125 @@
+#!/usr/bin/env groovy
+
+// https://github.com/apartmentlist/ci-shared-library
+@Library('ci-shared-library')_
+
+// Log Rotation
+properties([
+  buildDiscarder(
+    logRotator(
+      artifactDaysToKeepStr: '',
+      artifactNumToKeepStr: '',
+      daysToKeepStr: '30',
+      numToKeepStr: '100'
+    )
+  )
+]) //properties
+
+// Generate unique worker labels
+def k8s_label = "${UUID.randomUUID().toString()}"
+
+pipeline {
+
+  environment {
+    APP_NAME = 'amsi'
+    APT_KEY_DONT_WARN_ON_DANGEROUS_USAGE = "true"
+    CI = 'true'
+    CLOUDSDK_CORE_DISABLE_PROMPTS = '1'
+    GIT_COMMIT_SHORT = sh(script: "git rev-parse --short ${GIT_COMMIT}", returnStdout: true).trim()
+    GIT_MESSAGE = sh(script: "git log --format=%B -n 1 ${GIT_COMMIT}", returnStdout: true).trim()
+    GIT_USER = sh(script: "git log -1 --pretty=format:'%ae'", returnStdout: true).trim()
+    GITHUB_URL = "https://github.com"
+    LANG = "en_US.UTF-8"
+    LANGUAGE = "en_US:en"
+    LC_ALL = "en_US.UTF-8"
+    SLACK_SUCCESS_CHANNEL = "#staging-releases"
+    SLACK_FAILURE_CHANNEL = "#supply_log_info"
+    SLACK_FAILURE_MAIN = "#supply_log_error"
+  } // environment
+
+  agent {
+    kubernetes {
+      label k8s_label
+      defaultContainer 'jnlp'
+      yaml """
+apiVersion: v1
+kind: Pod
+spec:
+  containers:
+  - name: ruby
+    image: gcr.io/alist-development/ruby:2.6.3
+    imagePullPolicy: Always
+    resources:
+      requests:
+        memory: "2048Mi"
+        cpu: "2"
+      limits:
+        memory: "2048Mi"
+        cpu: "2"
+    command:
+    - "tail"
+    - "-f"
+    - "/dev/null"
+"""
+    } // kubernetes
+  } // agent
+
+  options {
+    timestamps()
+    timeout(time: 30, unit: 'MINUTES')
+    ansiColor('xterm')
+  } // options
+
+  stages {
+
+    stage('Preparation') {
+      parallel {
+        stage('Slack') {
+          steps {
+            slackPreparation()
+          } // steps
+        } // stage - Slack
+        stage('Build Description') {
+          steps {
+            buildDescription()
+          } // steps
+        } // stage
+        stage('Bundle') {
+          steps {
+            container('ruby') {
+              sh 'gem install bundler:2.2.29'
+              sh 'bundle install -j 12'
+            } //container
+          } //steps
+        } //stage - Bundle
+      } //parallel
+    } //stage - Preparation
+
+    stage('Tests') {
+      parallel {
+        stage('Rake & Audit') {
+          steps {
+            container('ruby') {
+              withEnv([
+                "RAILS_ENV=test",
+                "RACK_ENV=test"
+                ]) {
+                sh 'bundle exec rspec spec'
+              } //withEnv
+            } //container
+          } //steps
+        } //stage
+      } //parallel
+    } //stage
+  } // stages
+
+  post {
+    success {
+      slackSuccess()
+    } // success
+    failure {
+      slackFailure()
+    } // failure
+  } // post
+
+} // pipeline

data/.gitignore

@@ -0,0 +1,2 @@
+/Gemfile.lock
+amsi-*.gem

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require 'spec_helper'

data/CHANGELOG.txt

@@ -0,0 +1,20 @@
+* 1.0.0 Add eventing gem and track import_pms_resident and import_pms_prospect events for each occupant on GetPropertyResidents
+* 0.12.0 Add lead_source_code, lead_date and lead_id to Model::Lease
+* 0.11.5 Raise Amsi::Error::UnparsableResponse error when xml response can't be parsed
+* 0.11.4 Fix ambiguous time zone bug
+* 0.11.3 Add `<requirements>` node to guest card insertion request
+* 0.11.2 Correctly handle gateway time outs
+* 0.11.1 Parse faultstring more reliably during error
+* 0.11.0 Add property_id to Model::GuestCard
+* 0.10.0 Add initial_source_id to Model::GuestCard, rename guest_card_id to id
+* 0.9.0 Made date interval params in GetMoveinsByFirstMarketingSource Dates
+* 0.8.0 Added Model::GuestCard to response from GetMoveinsByFirstMarketingSource
+* 0.7.0 Added GetMoveinsByFirstMarketingSource request
+* 0.6.0 Removed SOCKS5 proxy request building; that is now up to clients
+* 0.5.0 Added support for SOCKS5 proxy requests
+* 0.4.0 Added GetPropertyList request
+* 0.3.0 Added AddGuestCard request
+* 0.2.5 Added bad request validator
+* 0.2.4 Fixed Model::Occupant#occupant_status_code and added model specs
+* 0.2.3 Tested by Tom locally against production data with 74 AMSI properties
+* 0.1.0 Initial release with mocked GetPropertyResidents request

data/CODEOWNERS

@@ -0,0 +1 @@
+* @tcollier @heidi

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in amsi.gemspec
+gemspec
+
+gem 'event_tracker', git: 'https://github.com/apartmentlist/eventing.git', glob: 'clients/ruby/event_tracker.gemspec', tag: 'rb1.35.0'

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Apartment List, Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,319 @@
+# Amsi
+
+Ruby client of AMSI Evolution Suite API
+
+## Versions
+
+See the [changelog](CHANGELOG.txt)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'amsi'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install amsi
+
+## Usage
+
+### SOAP Actions
+
+To request an action, instantiate the appropriate request class (see below) and invoke #perform
+on it. The API response will be parsed and returned as a ruby object.
+
+#### Amsi::Request::AddGuestCard
+Add a new guest card for the prospect
+
+##### Initialization parameters
+
+Required initializer parameters:
+* `contact_type` [String] See [Amsi::Parameter::ContactType](#amsiparametercontacttype)
+* `password` [String] Amsi account password
+* `portfolio_name` [String] the unique identifier for the property in AMSI
+* `property_id` [String] AMSI property id
+* `prospect` [Amsi::Parameter::Prospect](#amsiparameterprospect)
+* `user_id` [String] Amsi account username
+* `web_service_url` [String] Amsi Url to the leasing.asmx resource
+
+Optional initializer parameters:
+* `appointment_date` [Date] date the prospect is going to visit the property
+* `comments` [String]
+* `contact_datetime` [DateTime]
+* `date_needed` [Date]
+* `initial_source_id` [String]
+* `lease_term_desired` [Integer]
+* `leasing_agent_id` [String]
+* `qualified` [Boolean]
+* `unit_subtype` [String]
+* `unit_type` [String]
+
+##### Response
+
+[Amsi::Model::GuestCardResult](#amsimodelguestcardresult)
+
+#### Amsi::Request::GetMoveinsByFirstMarketingSource
+Get all leases matching the specified marketing source and within the specified
+time window.
+
+##### Initialization parameters
+
+Required initializer parameters:
+* `from_date` [Date] Beginning of date interval within which to search
+* `marketing_source_code` [String] Code corresponding to the marketing source
+    for which to fetch move ins. Max of 3 characters according to their docs.
+* `password` [String] Amsi account password
+* `portfolio_name` [String] the unique identifier for the property in AMSI
+* `property_id` [String] AMSI property id
+* `through_date` [Date] End of date interval within which to search
+* `user_id` [String] Amsi account username
+* `web_service_url` [String] Amsi Url to the leasing.asmx resource
+
+##### Response
+
+Array<[Amsi::Model::Lease](#amsimodellease)>
+
+#### Amsi::Request::GetPropertyList
+Retrieve a list of properties and detailed information about each.
+
+##### Initialization parameters
+
+Required initializer parameters:
+* `user_id` [String] Amsi account username
+* `password` [String] Amsi account password
+* `portfolio_name` [String] the unique identifier for the property in AMSI
+* `web_service_url` [String] Amsi Url to the leasing.asmx resource
+
+Optional initializer parameters and default values:
+* `property_id` [String] Amsi property id (if this field is left blank, the response will
+  include all properties in the portfolio)
+* `include_leasing_agents` [Boolean] if true, response will include leasing agents for each property returned.
+* `include_marketing_sources` [Boolean] if true, response will include marketing sources for each property returned.
+* `include_unit_types` [Boolean] if true, response will include unit types for each property returned.
+
+
+##### Response
+
+Array<[Amsi::Model::Property](#amsimodelproperty)>
+
+
+#### Amsi::Request::GetPropertyResidents
+Retrieve resident leases for a given property. Returns current leases only by default.
+
+##### Initialization parameters
+
+Required initializer parameters:
+* `user_id` [String] Amsi account username
+* `password` [String] Amsi account password
+* `portfolio_name` [String] the unique identifier for the property in Amsi
+* `property_id` [String] Amsi property id
+* `web_service_url` [String] Amsi Url to the leasing.asmx resource
+* `params` [Hash] extra configuration fields: `:start_date` [String], `:end_date` [String], `:remote_id` [String], `:billing_config` [BillingConfiguration], `:import_id` [String] and `:pmc_id` [String]
+
+Optional initializer parameters and default values:
+* `lease_status` [String] Lease status filter; defaults to current leases ("C"). Valid values: (A)pplicant, (C)urrent, (I)ntent to Transfer, (L)eased, (N)otice, (P)revious, (T)ransfer, (V)approved, (X)cancelled
+* `include_marketing_source` [Boolean] if true, response will include marketing sources on each lease returned.
+
+##### Response
+
+Array<[Amsi::Model::Lease](#amsimodelfloorplan)>
+
+
+### Parameters
+
+#### Amsi::Parameter::ContactType
+
+Constants for the different channels prospects can use for contacting. Available constants are:
+
+* `INTERNET`
+* `PHONE`
+* `RETURN_VISIT`
+* `VISIT`
+
+#### Amsi::Parameter::Prospect
+
+A container for prospect details.
+
+Required initializer parameters:
+* `last_name` [String]
+
+Optional initializer parameters:
+* `daytime_phone` [String]
+* `email` [String]
+* `first_name` [String]
+
+
+### Models
+
+#### Amsi::Model::Address
+
+A [Amsi::Model::Property](#amsimodelproperty) has an address and a remit_to_address
+
+* `line_1` [String] 1st line in the street address
+* `line_2` [String] 2nd line in the street address
+* `line_3` [String] 3rd line in the street address
+* `line_4` [String] 4th line in the street address
+* `city` [String] the city
+* `state` [String] the state
+* `zip_code` [String] the zip code
+* `country` [String] the country
+
+#### Amsi::Model::GuestCardResult
+
+The response from [AddGuestCard](#amsirequestaddguestcard), will have the following attributes:
+
+* `contact_sequence_number` [Integer] (alias `contact_seq_no`)
+* `guest_card_id` [String] the unique identifier for the newly created guest card
+* `property_id` [String]
+* `status` [String] either "SUCCESS" or "FAILURE" (also has convenience method `success?`)
+
+#### Amsi::Model::GuestCard
+
+The response from [GetMoveinsByFirstMarketingSource](#amsirequestsgetmoveinsbyfirstmarketingsource)
+is an array of `Amsi::Model::Lease` instances. Leases have `guest_card` and
+`matched_guest_cards`. `guest_card` is either an Amsi::Model::GuestCard or nil
+ and `matched_guest_cards` is an array of Amsi::Model::GuestCards
+ (can be empty). Amsi::Model::GuestCards have the following attributes:
+
+* `email` [String]
+* `create_date` [DateTime] The time the guest card was created according to AMSI
+* `first_name` [String] The renter's first name
+* `id` [String] The ID of the guest card in AMSI
+* `initial_source_id` [String] the short code for the marketing source attributed to the lease
+* `last_name` [String] The renter's last name
+* `property_id` [String] The unique identifier of the property that the guest card belongs to
+
+#### Amsi::Model::Lease
+
+The response from [GetPropertyResidents](#amsirequestgetpropertyresidents) is an array of `Amsi::Model::Lease`
+instances. Each instance will have the following attributes:
+
+* `property_id` [String]
+* `building_id` [String] Building ID
+* `unit_id` [String] Unit name
+* `resident_id` [String] Resident ID
+* `external_reference_id` [String]
+* `guest_card` [[Amsi::Model::GuestCard](#amsimodelguestcard)] or nil
+* `matched_guest_cards` [Array<[Amsi::Model::GuestCard](#amsimodelguestcard)>], can be []
+* `occupant_status_code` [String in Amsi::Model::Lease::Status]
+* `occupant_status_code_description` [String]
+* `begin_date` [Date]
+* `end_date` [Date]
+* `application_date` [Date]
+* `sign_date` [Date]
+* `move_in_date` [Date]
+* `rent_amount` [Integer]
+* `occupants` [Array<[Amsi::Model::Occupant](#amsimodeloccupant)>]
+* `lead_id` [String] Guest Card No.
+* `lead_date` [DateTime] Guest first contact date
+* `lead_source_code` [String] Marketing source code
+
+#### Amsi::Model::LeasingAgent
+
+A [Amsi::Model::Property](#amsimodelproperty) has 0 or more leasing agents
+
+* `agent_active_flag` [String] "Y" if the agent is active, otherwise "N" (also has convenience method `active?`)
+* `code` [String] the unique identifier for the agent within the property (alias of `agent_code`)
+* `agent_name` [String] the leasing agent's full name (alias of `agent_name`)
+* `property_id` [String] the unique ID of the property the leasing agent works at
+
+#### Amsi::Model::Manager
+
+A [Amsi::Model::Property](#amsimodelproperty) has a manager
+
+* `fax` [String] the property manager's fax number
+* `first_name` [String] the property manager's first name
+* `last_name` [String] the property manager's last name
+* `middle_name` [String] the property manager's middle name
+* `phone` [String] the property manager's phone number
+* `salutation` [String] the property manager's salutation, e.g. "Mrs"
+
+#### Amsi::Model::MarketingSource
+
+A [Amsi::Model::Property](#amsimodelproperty) has 0 or more marketing sources
+
+* `code` [String] unique identifier within the property (alias of `source_code`)
+* `description` [String] a description of the marketing source (alias of `source_desc`)
+* `source_active_flag` [String] "Y" if the marketing source is active, otherwise "N" (also has convenience method `active?`)
+* `property_id` [String] the unique ID of the property the marketing source belongs to
+
+#### Amsi::Model::Occupant
+
+One occupant of a lease.  Each instance will have the following attributes:
+
+* `property_id` [String]
+* `building_id` [String] Building ID
+* `unit_id` [String] Unit name
+* `resident_id` [String] Resident ID
+* `sequence_number` [String] Sequence number
+* `first_name` [String]
+* `last_name` [String]
+* `phone_1` [String]
+* `phone_2` [String]
+* `responsible_flag` [String in ["Responsible" | "Non-Responsible"]]
+* `email` [String]
+
+#### Amsi::Model::Property
+
+The response from [GetPropertyList](#amsirequestgetpropertylist) is an array of `Amsi::Model::Property`
+instances. Each instance will have the following attributes:
+
+* `address` [[Amsi::Model::Address](#amsimodeladdress)] the property's physical address
+* `email` [String] the email address of the property (alias of `property_addr_email`)
+* `id` [String] the property's unique identifier
+* `leasing_agents` [Array<[Amsi::Model::LeasingAgent](#amsimodelleasingagent)>] the list of leasing agents for the property
+* `live_date` [Date] the date the property went live
+* `live_flag` [String] "Y" if the property is live, otherwise "N" (also has convenience method `live?`)
+* `manager` [[Amsi::Model::Manager](#amsimodelmanager)] the property manager's contact info
+* `marketing_sources` [Array<[Amsi::Model::MarketingSource](#amsimodelmarketingsource)>] the list of marketing sources for the property
+* `name` [String] the name of the property (alias of `property_name_1`)
+* `name_2` [String] an optional alternate name of the property (alias of `property_name_2`)
+* `remit_to_address` [[Amsi::Model::Address](#amsimodeladdress)] the property's mailing address
+* `unit_types` [Array<[Amsi::Model::UnitType](#amsimodelunittype)>] the list of unit types for the property
+
+#### Amsi::Model::UnitType
+
+A [Amsi::Model::Property](#amsimodelproperty) has 0 or more unit types
+
+* `baths` [Decimal] the number of bathrooms in the unit
+* `bedrooms` [Integer] the number of bedrooms in the unit
+* `count` [Integer] Number of units in the property that are of this type
+* `description` [String] a description of the unit type (alias of `unit_type_desc`)
+* `market_rent` [Decimal] the rental price of the unit
+* `minimum_security_deposit` [Decimal] the minimum security deposit needed for the unit (alias of `sec_min`)
+* `month_to_month_renew` [Decimal] the month-to-month renewal amount (alias of `mtm_renew`)
+* `other_renew` [Decimal] other renewal amount
+* `property_id` [String] the unique ID of the property the unit is in
+* `rooms` [Integer] the total number of rooms in the unit
+* `sqft` [Integer] the total area of the unit (alias of `sqftg`)
+* `standard_renew` [Decimal] the standard renewal amount
+* `type` [String] the unique identifier within the property for this unit type (alias of `unit_type`)
+
+
+## Compatibility
+
+This gem sets global configurations on other dependent libraries, which makes it inherently *not*
+thread-safe. Notably, it sets the following
+
+* `MultiXml.parser = :ox`
+
+If your client depends on any of these global settings, it is recommended that you do not run in
+a multi-threaded environment.
+
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/apartmentlist/amsi.

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/amsi.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'amsi/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'amsi'
+  spec.version       = Amsi::VERSION
+  spec.authors       = ['Justin Richard']
+  spec.email         = ['justin@apartmentlist.com']
+
+  spec.summary       = 'Ruby client of AMSI Evolution Suite API'
+  spec.homepage      = 'https://github.com/apartmentlist/amsi'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'faraday', '~> 0.9'
+  spec.add_runtime_dependency 'multi_xml', '~> 0.5'
+  spec.add_runtime_dependency 'nokogiri', '~> 1.6'
+  spec.add_runtime_dependency 'ox', '~> 2.3'
+  spec.add_runtime_dependency 'tzinfo', '~> 1.2'
+
+  spec.add_development_dependency 'bundler', '>= 2'
+  spec.add_development_dependency 'pry-byebug', '~> 3.3'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.4'
+  spec.add_development_dependency 'timecop', '~> 0.8'
+  spec.add_development_dependency 'webmock', '~> 1.21'
+end

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'pry'
+require 'amsi'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require 'pry'
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/config/multi_xml.rb

@@ -0,0 +1,4 @@
+require 'multi_xml'
+require 'ox'
+
+MultiXml.parser = :ox

data/lib/amsi/attribute_parser/base.rb

@@ -0,0 +1,23 @@
+require 'amsi/error/invalid_response'
+
+module Amsi
+  class AttributeParser
+    # Base class for attribute parsers.
+    class Base
+      # @param value [String] the response value from AMSI
+      def initialize(value)
+        @value = value
+      end
+
+      # @return [Object] the parsed attribute value
+      def parse
+        raise NotImplementedError,
+              "#{self.class.name} must implement #{__method__}"
+      end
+
+      private
+
+      attr_reader :value
+    end
+  end
+end

data/lib/amsi/attribute_parser/boolean.rb

@@ -0,0 +1,25 @@
+require_relative 'base'
+
+module Amsi
+  class AttributeParser
+    # Parse the response value of a boolean attribute
+    class Boolean < Base
+      # Values that AMSI responds with for true
+      TRUE_VALUES = %w[1 true].freeze
+      private_constant :TRUE_VALUES
+
+      # Values that AMSI responds with for true
+      FALSE_VALUES = %w[0 false].freeze
+      private_constant :FALSE_VALUES
+
+      # @return [true|false] the parsed attribute value
+      # @raise [Amsi::Error::InvalidResponse] if the value doesn't parse
+      #   into true or false
+      def parse
+        return true if TRUE_VALUES.include?(value)
+        return false if FALSE_VALUES.include?(value)
+        raise Error::InvalidResponse, "Invalid boolean response value: #{value}"
+      end
+    end
+  end
+end

data/lib/amsi/attribute_parser/date.rb

@@ -0,0 +1,28 @@
+require_relative 'base'
+
+module Amsi
+  class AttributeParser
+    # Parse the response value of a date attribute
+    class Date < Base
+      # AMSI responds with multiple date formats. This is one format that
+      # Date.parse will not parse correctly, so we need special handling
+      FORMAT = '%m/%d/%Y'.freeze
+      private_constant :FORMAT
+
+      # @return [Date] the parsed attribute value
+      def parse
+        return if value == ''
+        if value =~ %r[/]
+          ::Date.strptime(value, FORMAT)
+        else
+          # AMSI sometimes returns 0001-01-01 for dates, which appears to be
+          # their representation of a NULL value.
+          date = ::Date.parse(value)
+          date.year == 1 ? nil : date
+        end
+      rescue ArgumentError
+        raise Error::InvalidResponse, "Invalid date response value: #{value}"
+      end
+    end
+  end
+end