Issue with Stripe.Subscription Documentation Example

Hi There,

When utilizing the Node.JS Typescript bindings, when I copy/paste the Subscription object example from “https://stripe.com/docs/api/subscriptions/object” it seems that Typescript is returning an error.

    TypeScript diagnostics (customize using `[jest-config].globals.ts-jest.diagnostics` option):
    src/stripe/stripe.mocks.ts:89:11 - error TS2741: Property 'trial_period_days' is missing in type '{ aggregate_usage: null; interval: "month"; interval_count: number; usage_type: "licensed"; }' but required in type 'Recurring'.

    89           "recurring": {
                 ~~~~~~~~~~~

      node_modules/stripe/types/2020-03-02/Prices.d.ts:123:9
        123         trial_period_days: number | null;
                    ~~~~~~~~~~~~~~~~~
        'trial_period_days' is declared here.
      node_modules/stripe/types/2020-03-02/Prices.d.ts:68:7
        68       recurring: Price.Recurring | null;
                 ~~~~~~~~~
        The expected type comes from property 'recurring' which is declared here on type 'Price'

Now when I add this one (even though it shows as optional, I keep getting further errors. Main issues:

1. “trial_period_days” seems to be required, even though the binding allows null. Now adding null gives a further error (see 2.)
2. “plan” seems to be missing (defined in SubscriptionItems.d.ts - line 45)

Am I doing something wrong here?

[XavierGeerinck]

Awesome! And what about Plan? 😃

[Minishlink]

@remi-stripe Ok, thanks!