plaid 16.0.0 → 43.1.0

data/CONTRIBUTING.md

@@ -1,7 +1,10 @@
 # Contributing
 
-Instructions for contributing to [plaid-ruby][1]. A ruby client library for the [Plaid API][2]. This library is fully generated from the [Plaid OpenAPI spec][3].
+Instructions for contributing to [plaid-ruby][1]. A ruby client library for the [Plaid API][2]. This library is fully generated from the [Plaid OpenAPI spec](3).
 
+This library cannot directly accept PRs from the public as it is generated from internal Plaid sources on the internal Plaid GitHub instance and any changes made directly to this repo will be overwritten. If you submit a PR and it is accepted, a member of Plaid engineering will copy and paste your change into the upstream, internal version of this repo rather than merging your PR. 
+
+Plaid employees should make any changes on the internal Plaid GitHub and not on the public repo. 
 ## Setup
 
 If you find an issue, please investigate whether it is a type problem with [OpenAPI](3) or a problem with the [ruby faraday](https://github.com/OpenAPITools/openapi-generator/blob/master/docs/generators/ruby.md) generator. Then open an issue and Plaid will investigate further.

data/Dockerfile

@@ -1,4 +1,6 @@
-FROM ruby:2.4.0
+# Note: This image is also built in CircleCI, so limit references to internal repositories.
+# Keep this in sync with the image in plaid-ruby-release Jenkinsfile
+FROM ruby:3.2.0
 
 # Create app directory
 WORKDIR /usr/src/app

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    plaid (16.0.0)
-      faraday (~> 1.0, >= 1.0.1)
+    plaid (43.1.0)
+      faraday (>= 1.0.1, < 3.0)
+      faraday-multipart (>= 1.0.1, < 2.0)
 
 GEM
   remote: https://rubygems.org/
@@ -10,40 +11,29 @@ GEM
     ast (2.4.1)
     diff-lcs (1.4.4)
     dotenv (2.7.6)
-    faraday (1.10.2)
-      faraday-em_http (~> 1.0)
-      faraday-em_synchrony (~> 1.0)
-      faraday-excon (~> 1.1)
-      faraday-httpclient (~> 1.0)
-      faraday-multipart (~> 1.0)
-      faraday-net_http (~> 1.0)
-      faraday-net_http_persistent (~> 1.0)
-      faraday-patron (~> 1.0)
-      faraday-rack (~> 1.0)
-      faraday-retry (~> 1.0)
-      ruby2_keywords (>= 0.0.4)
-    faraday-em_http (1.0.0)
-    faraday-em_synchrony (1.0.0)
-    faraday-excon (1.1.0)
-    faraday-httpclient (1.0.1)
-    faraday-multipart (1.0.4)
-      multipart-post (~> 2)
-    faraday-net_http (1.0.1)
-    faraday-net_http_persistent (1.2.0)
-    faraday-patron (1.0.0)
-    faraday-rack (1.0.0)
-    faraday-retry (1.0.3)
-    minitest (5.14.2)
+    faraday (2.13.4)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-multipart (1.1.1)
+      multipart-post (~> 2.0)
+    faraday-net_http (3.4.1)
+      net-http (>= 0.5.0)
+    json (2.13.2)
+    logger (1.7.0)
+    minitest (5.25.4)
     minitest-around (0.5.0)
       minitest (~> 5.0)
-    multipart-post (2.2.3)
+    multipart-post (2.4.1)
+    net-http (0.6.0)
+      uri
     parallel (1.20.1)
     parser (2.7.2.0)
       ast (~> 2.4.1)
     rainbow (3.0.0)
     rake (13.0.1)
     regexp_parser (1.8.0)
-    rexml (3.2.4)
+    rexml (3.2.5)
     rspec (3.10.0)
       rspec-core (~> 3.10.0)
       rspec-expectations (~> 3.10.0)
@@ -69,8 +59,8 @@ GEM
     rubocop-ast (0.4.2)
       parser (>= 2.7.1.4)
     ruby-progressbar (1.10.1)
-    ruby2_keywords (0.0.5)
     unicode-display_width (1.7.0)
+    uri (1.0.3)
 
 PLATFORMS
   ruby
@@ -86,4 +76,4 @@ DEPENDENCIES
   rubocop (~> 0.91.0)
 
 BUNDLED WITH
-   2.2.33
+   2.2.9

data/Makefile

@@ -1,5 +1,5 @@
 # Ruby embeds the version in the generator where as others don't so it's not possible to cat for it.
-RUBY_PACKAGE_VERSION=16.0.0
+RUBY_PACKAGE_VERSION=43.1.0
 
 .PHONY: release
 release:

data/README.md

@@ -1,7 +1,22 @@
-# plaid-ruby [![Circle CI](https://circleci.com/gh/plaid/plaid-ruby.svg?style=svg&circle-token=30ee002ac2021da5b5b5a701d45fe2888af124a5)](https://circleci.com/gh/plaid/plaid-ruby) [![Gem Version](https://badge.fury.io/rb/plaid.svg)](http://badge.fury.io/rb/plaid)
+# plaid-ruby [![Gem Version](https://badge.fury.io/rb/plaid.svg)](http://badge.fury.io/rb/plaid)
 
 The official Ruby bindings for the [Plaid API](https://plaid.com/docs). It's generated from our [OpenAPI schema](https://github.com/plaid/plaid-openapi).
 
+## Table of Contents
+
+- [Installation](#installation)
+- [Versioning](#versioning)
+- [Getting Started](#getting-started)
+  - [Create a client](#create-a-client)
+  - [Tuning Faraday](#tuning-faraday)
+  - [Dates](#dates)
+- [Examples](#examples)
+- [Errors](#errors)
+- [Response objects](#response-objects)
+- [Migration Guide](#migration-guide)
+- [Contributing](#contributing)
+- [License](#license)
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -18,30 +33,30 @@ Or install it yourself as:
 
     $ gem install plaid
 
-The gem supports Ruby 2.4.0+ only.
+The gem supports Ruby 3.2.0+ only.
 
 ### Versioning
 
-Versions > 14 are generated from our OpenAPI schema. For previous non-generated versions, check out [13.2.0](https://github.com/plaid/plaid-ruby/releases/tag/v13.2.0).
+Versions > 14 are generated from our OpenAPI schema.
 
 Each major version of `plaid-ruby` targets a specific version of the Plaid API:
 
-| API version | plaid-ruby release |
-| ----------- | ------------------ |
-| [`2020-09-14`][api-version-2020-09-14] (**latest**) | `12.x.x`, `13.x.x`, `14.x.x` |
-| [`2019-05-29`][api-version-2019-05-29] | `11.x.x`, `10.x.x`, `9.x.x`, `8.x.x`, `7.x.x` |
-| [`2018-05-22`][api-version-2018-05-22] | `6.x.x` |
-| `2017-03-08` | `5.x.x` |
+| API version                                         | plaid-ruby release                            |
+| --------------------------------------------------- | --------------------------------------------- |
+| [`2020-09-14`][api-version-2020-09-14] (**latest**) | `12.x.x` and higher                           |
+| [`2019-05-29`][api-version-2019-05-29]              | `11.x.x`, `10.x.x`, `9.x.x`, `8.x.x`, `7.x.x` |
+| [`2018-05-22`][api-version-2018-05-22]              | `6.x.x`                                       |
+| `2017-03-08`                                        | `5.x.x`                                       |
 
 For information about what has changed between versions and how to update your integration, head to the [version changelog][version-changelog].
 
-The plaid-ruby client library is typically updated on a monthly basis. The canonical source for the latest version number is the [client library changelog](https://github.com/plaid/plaid-ruby/blob/master/CHANGELOG.md).
+The plaid-ruby client library is typically updated on a monthly basis. The canonical source for the latest version number is the [client library changelog](https://github.com/plaid/plaid-ruby/blob/master/CHANGELOG.md). New versions are published as [GitHub tags](https://github.com/plaid/plaid-ruby/tags), not as Releases. New versions are also published on [RubyGems.org](https://rubygems.org/gems/plaid/).
 
-## Usage
+All users are strongly recommended to use a recent version of the library, as older versions do not contain support for new endpoints and fields. For more details, see the [Migration Guide](#migration-guide).
 
-This gem wraps the Plaid API, which is fully described in the [documentation](https://plaid.com/docs/api) and in the [plaid-openapi](https://github.com/plaid/plaid-openapi) spec.
+## Getting started
 
-### Creating a Plaid client
+### Create a client
 
 Create an instance of the client using the `client_id` and `secret` from your Plaid dashboard along with your environment of choice:
 
@@ -60,11 +75,10 @@ api_client = Plaid::ApiClient.new(
 client = Plaid::PlaidApi.new(api_client)
 ```
 
-The `server_index` field is the environment which the client will be running in. Your choices for the `server_index` field include:
+The `server_index` field is the environment which the client will be running in. Your choices for the `server_index` field are:
 
-- `Plaid::Configuration::Environment["sandbox"]` allows you to do your initial integrations tests against preloaded data without being billed or making expensive API calls. More information about using the API sandbox can be found on the [API Sandbox documentation](https://plaid.com/docs/api#sandbox).
-- `Plaid::Configuration::Environment["development"]` allows you to test against both real and test accounts without being billed. More information about Plaid test accounts can be found in our [API documentation](https://plaid.com/docs/api/#sandbox).
-- `Plaid::Configuration::Environment["production"]` is the production environment where you can launch your production ready application and be charged for your Plaid usage.
+- `Plaid::Configuration::Environment["sandbox"]` allows you to do your initial integrations tests against preloaded data without being billed. More information about using the API sandbox can be found on the [API Sandbox documentation](https://plaid.com/docs/api#sandbox).
+- `Plaid::Configuration::Environment["production"]` is the production environment where you can test with real data and launch.
 
 ### Tuning Faraday
 
@@ -79,6 +93,7 @@ api_client.connection.options[:timeout] = 60*20 # 20 minutes
 ```
 
 To use custom middleware, reinitialize the Faraday::Connection object:
+
 ```
 configuration = Plaid::Configuration.new
 api_client = Plaid::ApiClient.new(configuration)
@@ -86,11 +101,10 @@ api_client.create_connection do |builder|
   builder.use Faraday::Response::Logger
 end
 ```
-## Data type differences from API and from previous versions
 
 ### Dates
 
-Dates and datetimes in requests, which are represented as strings in the API and in previous client library versions, are represented in this version of the Ruby client library as Ruby `Date` or `DateTime` objects. 
+Dates and datetimes in requests, which are represented as strings in the API and previous versions of the client library, are represented in this version of the Ruby client library as Ruby `Date` or `DateTime` objects.
 
 Time zone information is required for request fields that accept datetimes. Failing to include time zone information (or passing in a string, instead of a `Date` or `DateTime` object) will result in an error. See the following examples for guidance on `Date` and `DateTime` usage.
 
@@ -119,6 +133,8 @@ b = Date.parse("2022-05-06T22:35:49Z").to_datetime
 
 ## Examples
 
+For more examples, see the [test suites](https://github.com/plaid/plaid-ruby/tree/master/test), [Quickstart](https://github.com/plaid/quickstart/tree/master/ruby), or [API Reference documentation](https://plaid.com/docs/api/).
+
 ### Create a new link_token
 
 ```ruby
@@ -146,7 +162,7 @@ link_token = link_token_response.link_token
 
 ### Exchanging a Link public_token for a Plaid access_token
 
-If you have a [Link](https://github.com/plaid/link) `public token`, use this function to get an `access_token`: `client.item_public_token_exchange(request)`
+If you have a [Link](https://plaid.com/docs/link/) `public token`, use this function to get an `access_token`: `client.item_public_token_exchange(request)`
 
 An example of the function's usage if you have a `public_token` in hand:
 
@@ -175,6 +191,7 @@ client.item_remove(item_remove_request)
 ```
 
 ### Get paginated transactions (preferred method)
+
 ```ruby
 request = Plaid::ItemPublicTokenExchangeRequest.new
 request.public_token = public_token
@@ -186,7 +203,7 @@ transactions_sync_request = Plaid::TransactionsSyncRequest.new
 transactions_sync_request.access_token = access_token
 
 transaction_response = client.transactions_sync(transactions_sync_request)
-transactions = transaction_response.transactions
+transactions = transaction_response.added
 
 # the transactions in the response are paginated, so make multiple calls while
 # updating the cursor to retrieve all transactions
@@ -196,11 +213,12 @@ while transaction_response.has_more
   transactions_sync_request.cursor = transaction_response.next_cursor
 
   transaction_response = client.transactions_sync(transactions_sync_request)
-  transactions += transaction_response.transactions
+  transactions += transaction_response.added
 end
 ```
 
 ### Get paginated transactions (older method)
+
 ```ruby
 request = Plaid::ItemPublicTokenExchangeRequest.new
 request.public_token = public_token
@@ -231,12 +249,10 @@ while transactions.length < transaction_response.total_transactions
   transaction_response = client.transactions_get(transactions_get_request)
   transactions += transaction_response.transactions
 end
-
 ```
 
-### Obtaining Item-related data
+### Get Auth data
 
-If you have an `access_token`, you can use following code to retreive data:
 ```ruby
 request = Plaid::ItemPublicTokenExchangeRequest.new
 request.public_token = public_token
@@ -251,45 +267,6 @@ auth_response = client.auth_get(auth_get_request)
 auth = auth_response.auth
 ```
 
-There are also a number of other methods you can use to retrieve data:
-
-* `client.accounts_get(Plaid::AccountsGetRequest.new({:access_token => access_token, ...}))`: accounts
-* `client.accounts_balance_get(Plaid::AccountsBalanceGetRequest.new({:access_token => access_token, ...}))`: real-time balances
-* `client.auth_get(Plaid::AuthGetRequest.new({:access_token => access_token, ...}))`: auth
-* `client.identity_get(Plaid::IdentityGetRequest.new({:access_token => access_token, ...}))`: identity
-* `client.transactions_get(Plaid::TransactionsGetRequest.new({:access_token => access_token, ...}))`: transactions
-* `client.investments_transactions_get(Plaid::InvestmentsTransactionsGetRequest.new({:access_token => access_token, ...}))`: investment-account transactions
-* `client.investments_holdings_get(Plaid::InvestmentsHoldingsGetRequest.new({:access_token => access_token, ...}))`: investment-account holdings
-
-
-All of these methods return appropriate data. More information can be found on the [API documentation](https://plaid.com/docs/api).
-
-### Create a Stripe bank_account_token
-
-Exchange a Plaid Link `public_token` for an API `access_token` and a Stripe `bank_account_token`:
-```ruby
-request = Plaid::ItemPublicTokenExchangeRequest.new
-request.public_token = public_token
-
-response = client.item_public_token_exchange(request)
-access_token = response.access_token
-
-processor_token_create_request = Plaid::ProcessorStripeBankAccountTokenCreateRequest.new
-processor_token_create_request.access_token = access_token
-processor_token_create_request.account_id = '[Account ID]'
-
-stripe_response = client.processor_stripe_bank_account_token_create(processor_token_create_request)
-bank_account_token = stripe_response.stripe_bank_account_token
-```
-
-### Categories
-
-You can request category information:
-
-```ruby
-categories = client.categories_get             # Array of all known categories
-```
-
 ### Institutions
 
 Financial institution information is available as shown below where the function arguments represent count and offset:
@@ -320,19 +297,101 @@ All API calls return a response object that is accessible only with dot notation
 (i.e., `response.foo.bar`) and not with bracket notation. Expected keys for all types of responses are defined,
 and any attempt to access an unknown key will cause `NoMethodError` exception.
 
-## Contributing
+## Migration guide
 
-Bug reports are welcome on GitHub at https://github.com/plaid/plaid-ruby. See also [contributing guidelines](CONTRIBUTING.md). As the library is auto-generated, pull requests are automatically closed.
+### 14.0.0 or later to latest
 
-## License
+Migrating from a version released on or after August 2021 to a recent version should involve very minor integration changes. Many customers will not need to make changes to their integrations at all. To see a list of all potentially-breaking changes since your current version, see the [client library changelog](https://github.com/plaid/plaid-ruby/blob/master/CHANGELOG.md) and search for "Breaking changes in this version". Breaking changes are annotated at the top of each major version header.
+
+### Pre-14.0.0 to latest
+
+Version 14.0.0 of the client library was released in August 2021 and contains multiple interface changes, as described below.
+
+#### Client initialization
+
+From:
+
+```ruby
+client = Plaid::Client.new(env: :sandbox,
+                            client_id: client_id,
+                            secret: secret)
+```
+
+To:
+
+```ruby
+configuration = Plaid::Configuration.new
+configuration.server_index = Plaid::Configuration::Environment["sandbox"]
+configuration.api_key["PLAID-CLIENT-ID"] = ENV["PLAID_RUBY_CLIENT_ID"]
+configuration.api_key["PLAID-SECRET"] = ENV["PLAID_RUBY_SECRET"]
+configuration.api_key["Plaid-Version"] = "2020-09-14"
+
+api_client = Plaid::ApiClient.new(
+  configuration
+)
+
+client = Plaid::PlaidApi.new(api_client)
+```
+
+#### Endpoints
+
+All endpoint requests now take a request model and the functions have been renamed to include `_`.
+
+From:
+
+```ruby
+response = client.auth.get(access_token)
+```
+
+To:
+
+```ruby
+auth_get_request = Plaid::AuthGetRequest.new
+auth_get_request.access_token = access_token
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+or
 
-### Legacy API
+auth_get_request = Plaid::AuthGetRequest.new({:access_token => access_token})
+
+response = client.auth_get(auth_get_request)
+```
+
+#### Errors
+
+From:
+
+```ruby
+begin
+  client.auth.get(auth_get_request)
+rescue Plaid::PlaidAPIError => e
+  raise e if e.error_code != 'PRODUCT_NOT_READY'
+  sleep 1
+end
+```
+
+To:
+
+```ruby
+begin
+  client.auth_get(auth_get_request)
+rescue Plaid::ApiError => e
+  json_response = JSON.parse(e.response_body)
+  if json_response["error_code"] != "PRODUCT_NOT_READY"
+end
+```
+
+#### Date type differences
+
+See [Dates](#dates) for information on updates to date formats.
+
+## Contributing
+
+Bug reports are welcome on GitHub. See also [contributing guidelines](CONTRIBUTING.md).
+
+## License
 
-If you're looking for a Ruby client that works with the legacy Plaid API, use the [`plaid-legacy` gem][2].
+The gem is available as open source under the terms of the [MIT License](LICENSE.txt).
 
-[2]: https://github.com/plaid/plaid-ruby-legacy
 [version-changelog]: https://plaid.com/docs/api/versioning/
 [api-version-2018-05-22]: https://plaid.com/docs/api/versioning/#2018-05-22
 [api-version-2019-05-29]: https://plaid.com/docs/api/versioning/#2019-05-29