Bring next major branch up to date with master

.github/workflows/main.yml

@@ -101,7 +101,7 @@ jobs:
 
  - name: Coveralls
  run: yarn report && yarn coveralls
- if: matrix.node == '18'
+ if: env.COVERALLS_REPO_TOKEN && matrix.node == '18'
  env:
  GITHUB_TOKEN: ${{ secrets.github_token }}
  COVERALLS_REPO_TOKEN: ${{ secrets.COVERALLS_REPO_TOKEN }}

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 10.15.0 - 2022-10-20
+* [#1588](https://github.com/stripe/stripe-node/pull/1588) API Updates
+ * Add support for new values `jp_trn` and `ke_pin` on enums `Checkout.Session.customer_details.tax_ids[].type`, `Invoice.customer_tax_ids[].type`, `Order.tax_details.tax_ids[].type`, and `TaxId.type`
+ * Add support for new values `jp_trn` and `ke_pin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `OrderCreateParams.tax_details.tax_ids[].type`, `OrderUpdateParams.tax_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+ * Add support for `tipping` on `Terminal.Reader.action.process_payment_intent.process_config` and `TerminalReaderProcessPaymentIntentParams.process_config`
+* [#1585](https://github.com/stripe/stripe-node/pull/1585) use native UUID method if available
+
+## 10.14.0 - 2022-10-13
+* [#1582](https://github.com/stripe/stripe-node/pull/1582) API Updates
+ * Add support for new values `invalid_representative_country` and `verification_failed_residential_address` on enums `Account.future_requirements.errors[].code`, `Account.requirements.errors[].code`, `Capability.future_requirements.errors[].code`, `Capability.requirements.errors[].code`, `Person.future_requirements.errors[].code`, and `Person.requirements.errors[].code`
+ * Add support for `request_log_url` on `StripeError` objects
+ * Add support for `network_data` on `Issuing.Authorization`
+ * ⚠️ Remove `currency`, `description`, `images`, and `name` from `Checkout.SessionCreateParams`. These properties do not work on the latest API version. (fixes #1575)
+
 ## 10.13.0 - 2022-10-06
 * [#1571](https://github.com/stripe/stripe-node/pull/1571) API Updates
  * Add support for new value `invalid_dob_age_under_18` on enums `Account.future_requirements.errors[].code`, `Account.requirements.errors[].code`, `Capability.future_requirements.errors[].code`, `Capability.requirements.errors[].code`, `Person.future_requirements.errors[].code`, and `Person.requirements.errors[].code`

OPENAPI_VERSION

@@ -1 +1 @@
-v201
+v203

VERSION

@@ -1 +1 @@
-10.13.0
+10.15.0

package.json

@@ -1,6 +1,6 @@
 {
  "name": "stripe",
- "version": "10.13.0",
+ "version": "10.15.0",
  "description": "Stripe API wrapper",
  "keywords": [
  "stripe",

src/utils.ts

@@ -428,6 +428,12 @@ const utils = {
  * https://stackoverflow.com/a/2117523
  */
  uuid4: () => {
+ // available in: v14.17.x+
+ if (crypto.randomUUID) {
+ return crypto.randomUUID();
+ }
+
+ // legacy behavior if native UUIDs aren't available
  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
  const r = (Math.random() * 16) | 0;
  const v = c === 'x' ? r : (r & 0x3) | 0x8;

test/utils.spec.js

@@ -609,6 +609,45 @@ describe('utils', () => {
  }).to.throw();
  });
  });
+
+ describe('uuid', () => {
+ describe('crypto.randomUUID', () => {
+ const crypto = require('crypto');
+ let randomUUID$;
+ let called;
+ beforeEach(() => {
+ // if it's available, mock it and ensure it's called
+ // otherwise, skip this whole operation
+ if (crypto.randomUUID) {
+ called = false;
+ randomUUID$ = crypto.randomUUID;
+ crypto.randomUUID = () => {
+ called = true;
+ return 'no, YOU you id';
+ };
+ }
+ });
+ afterEach(() => {
+ if (randomUUID$) {
+ crypto.randomUUID = randomUUID$;
+ }
+ });
+ it('is called if available', () => {
+ if (randomUUID$) {
+ expect(utils.uuid4()).to.equal('no, YOU you id');
+ expect(called).to.equal(true);
+ }
+ });
+ });
+ it('should return a well-formatted v4 UUID', () => {
+ expect(utils.uuid4()).to.match(
+ // regex from https://createuuid.com/validator/, specifically for v4
+ /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[089ab][0-9a-f]{3}-[0-9a-f]{12}$/i
+ );
+ // further test: could spy on crypto.randomUUID to ensure it's being used, if available
+ // whether that's useful is a race between using jest/sinon for these tests and dropping support for node < 14
+ });
+ });
 });
 
 function handleWarnings(doWithShimmedConsoleWarn, onWarn) {

types/2022-08-01/Accounts.d.ts

@@ -709,6 +709,7 @@ declare module 'stripe' {
  type Code =
  | 'invalid_address_city_state_postal_code'
  | 'invalid_dob_age_under_18'
+ | 'invalid_representative_country'
  | 'invalid_street_address'
  | 'invalid_tos_acceptance'
  | 'invalid_value_other'
@@ -749,6 +750,7 @@ declare module 'stripe' {
  | 'verification_failed_keyed_match'
  | 'verification_failed_name_match'
  | 'verification_failed_other'
+ | 'verification_failed_residential_address'
  | 'verification_failed_tax_id_match'
  | 'verification_failed_tax_id_not_issued'
  | 'verification_missing_executives'
@@ -833,6 +835,7 @@ declare module 'stripe' {
  type Code =
  | 'invalid_address_city_state_postal_code'
  | 'invalid_dob_age_under_18'
+ | 'invalid_representative_country'
  | 'invalid_street_address'
  | 'invalid_tos_acceptance'
  | 'invalid_value_other'
@@ -873,6 +876,7 @@ declare module 'stripe' {
  | 'verification_failed_keyed_match'
  | 'verification_failed_name_match'
  | 'verification_failed_other'
+ | 'verification_failed_residential_address'
  | 'verification_failed_tax_id_match'
  | 'verification_failed_tax_id_not_issued'
  | 'verification_missing_executives'

types/2022-08-01/Capabilities.d.ts

@@ -120,6 +120,7 @@ declare module 'stripe' {
  type Code =
  | 'invalid_address_city_state_postal_code'
  | 'invalid_dob_age_under_18'
+ | 'invalid_representative_country'
  | 'invalid_street_address'
  | 'invalid_tos_acceptance'
  | 'invalid_value_other'
@@ -160,6 +161,7 @@ declare module 'stripe' {
  | 'verification_failed_keyed_match'
  | 'verification_failed_name_match'
  | 'verification_failed_other'
+ | 'verification_failed_residential_address'
  | 'verification_failed_tax_id_match'
  | 'verification_failed_tax_id_not_issued'
  | 'verification_missing_executives'
@@ -250,6 +252,7 @@ declare module 'stripe' {
  type Code =
  | 'invalid_address_city_state_postal_code'
  | 'invalid_dob_age_under_18'
+ | 'invalid_representative_country'
  | 'invalid_street_address'
  | 'invalid_tos_acceptance'
  | 'invalid_value_other'
@@ -290,6 +293,7 @@ declare module 'stripe' {
  | 'verification_failed_keyed_match'
  | 'verification_failed_name_match'
  | 'verification_failed_other'
+ | 'verification_failed_residential_address'
  | 'verification_failed_tax_id_match'
  | 'verification_failed_tax_id_not_issued'
  | 'verification_missing_executives'

types/2022-08-01/Checkout/Sessions.d.ts

@@ -379,7 +379,7 @@ declare module 'stripe' {
 
  interface TaxId {
  /**
- * The type of the tax ID, one of `eu_vat`, `br_cnpj`, `br_cpf`, `eu_oss_vat`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, or `unknown`
+ * The type of the tax ID, one of `eu_vat`, `br_cnpj`, `br_cpf`, `eu_oss_vat`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, or `unknown`
  */
  type: TaxId.Type;
 
@@ -418,6 +418,8 @@ declare module 'stripe' {
  | 'is_vat'
  | 'jp_cn'
  | 'jp_rn'
+ | 'jp_trn'
+ | 'ke_pin'
  | 'kr_brn'
  | 'li_uid'
  | 'mx_rfc'
@@ -1536,7 +1538,7 @@ declare module 'stripe' {
  metadata?: Stripe.MetadataParam;
 
  /**
- * The mode of the Checkout Session. Required when using prices or `setup` mode. Pass `subscription` if the Checkout Session includes at least one recurring item.
+ * The mode of the Checkout Session. Pass `subscription` if the Checkout Session includes at least one recurring item.
  */
  mode?: SessionCreateParams.Mode;
 
@@ -1728,31 +1730,11 @@ declare module 'stripe' {
  */
  amount?: number;
 
- /**
- * [Deprecated] Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). Required if `amount` is passed.
- */
- currency?: string;
-
- /**
- * [Deprecated] The description for the line item, to be displayed on the Checkout page.
- */
- description?: string;
-
  /**
  * The [tax rates](https://stripe.com/docs/api/tax_rates) that will be applied to this line item depending on the customer's billing/shipping address. We currently support the following countries: US, GB, AU, and all countries in the EU.
  */
  dynamic_tax_rates?: Array<string>;
 
- /**
- * [Deprecated] A list of image URLs representing this line item. Each image can be up to 5 MB in size. If passing `price` or `price_data`, specify images on the associated product instead.
- */
- images?: Array<string>;
-
- /**
- * [Deprecated] The name for the item to be displayed on the Checkout page. Required if `amount` is passed.
- */
- name?: string;
-
  /**
  * The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object. One of `price` or `price_data` is required.
  */

types/2022-08-01/Coupons.d.ts

@@ -157,7 +157,7 @@ declare module 'stripe' {
  };
 
  /**
- * Specifies how long the discount will be in effect if used on a subscription. Can be `forever`, `once`, or `repeating`. Defaults to `once`.
+ * Specifies how long the discount will be in effect if used on a subscription. Defaults to `once`.
  */
  duration?: CouponCreateParams.Duration;
 

types/2022-08-01/CustomerBalanceTransactions.d.ts

@@ -97,7 +97,7 @@ declare module 'stripe' {
  amount: number;
 
  /**
- * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). If the customer's [`currency`](https://stripe.com/docs/api/customers/object#customer_object-currency) is set, this value must match it. If the customer's `currency` is not set, it will be updated to this value.
+ * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). Specifies the [`invoice_credit_balance`](https://stripe.com/docs/api/customers/object#customer_object-invoice_credit_balance) that this transaction will apply to. If the customer's `currency` is not set, it will be updated to this value.
  */
  currency: string;
 

types/2022-08-01/Customers.d.ts

@@ -496,7 +496,7 @@ declare module 'stripe' {
 
  interface TaxIdDatum {
  /**
- * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `bg_uic`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
+ * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `bg_uic`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
  */
  type: TaxIdDatum.Type;
 
@@ -535,6 +535,8 @@ declare module 'stripe' {
  | 'is_vat'
  | 'jp_cn'
  | 'jp_rn'
+ | 'jp_trn'
+ | 'ke_pin'
  | 'kr_brn'
  | 'li_uid'
  | 'mx_rfc'

types/2022-08-01/Invoices.d.ts

@@ -38,7 +38,7 @@ declare module 'stripe' {
  */
  interface Invoice {
  /**
- * Unique identifier for the object.
+ * Unique identifier for the object. This property is always present unless the invoice is an upcoming invoice. See [Retrieve an upcoming invoice](https://stripe.com/docs/api/invoices/upcoming) for more details.
  */
  id?: string;
 
@@ -474,7 +474,7 @@ declare module 'stripe' {
 
  interface CustomerTaxId {
  /**
- * The type of the tax ID, one of `eu_vat`, `br_cnpj`, `br_cpf`, `eu_oss_vat`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, or `unknown`
+ * The type of the tax ID, one of `eu_vat`, `br_cnpj`, `br_cpf`, `eu_oss_vat`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, or `unknown`
  */
  type: CustomerTaxId.Type;
 
@@ -513,6 +513,8 @@ declare module 'stripe' {
  | 'is_vat'
  | 'jp_cn'
  | 'jp_rn'
+ | 'jp_trn'
+ | 'ke_pin'
  | 'kr_brn'
  | 'li_uid'
  | 'mx_rfc'
@@ -2077,7 +2079,7 @@ declare module 'stripe' {
 
  interface TaxId {
  /**
- * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `bg_uic`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
+ * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `bg_uic`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
  */
  type: TaxId.Type;
 
@@ -2116,6 +2118,8 @@ declare module 'stripe' {
  | 'is_vat'
  | 'jp_cn'
  | 'jp_rn'
+ | 'jp_trn'
+ | 'ke_pin'
  | 'kr_brn'
  | 'li_uid'
  | 'mx_rfc'
@@ -2625,7 +2629,7 @@ declare module 'stripe' {
 
  interface TaxId {
  /**
- * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `bg_uic`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
+ * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `bg_uic`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
  */
  type: TaxId.Type;
 
@@ -2664,6 +2668,8 @@ declare module 'stripe' {
  | 'is_vat'
  | 'jp_cn'
  | 'jp_rn'
+ | 'jp_trn'
+ | 'ke_pin'
  | 'kr_brn'
  | 'li_uid'
  | 'mx_rfc'

types/2022-08-01/Issuing/Transactions.d.ts

@@ -307,12 +307,12 @@ declare module 'stripe' {
 
  interface Treasury {
  /**
- * The Treasury [ReceivedCredit](https://stripe.com/docs/api/treasury/received_debits) representing this Issuing transaction if it is a refund
+ * The Treasury [ReceivedCredit](https://stripe.com/docs/api/treasury/received_credits) representing this Issuing transaction if it is a refund
  */
  received_credit: string | null;
 
  /**
- * The Treasury [ReceivedDebit](https://stripe.com/docs/api/treasury/received_credits) representing this Issuing transaction if it is a capture
+ * The Treasury [ReceivedDebit](https://stripe.com/docs/api/treasury/received_debits) representing this Issuing transaction if it is a capture
  */
  received_debit: string | null;
  }