feat(console): Billing and Invoicing - Invoice and payments integration

[Cosmin-Parvulescu]

Description

• Added Invoices to billing screen
• Added reconciliation function for automagically downgrading apps if entitlements get removed through Stripe subscription
• Added two new e-mail templates for reconciliation (billing + dev)
• Added Portal endpoint for redirecting users to their Stripe Customer Portal
• Parametrized getEntitlements to be able to be used from public webhook

Related Issues

• Closes feat(console): Billing and Invoicing - Invoice and payments integration #2404
• Pause / unpause to be handled at a later date

Testing

• Did some small local testing, would need to do additional testing in dev

Checklist

• I have read the CONTRIBUTING guidelines
• I have tested my code (manually and/or automated if applicable)
• I have updated the documentation (if necessary)

[szkl]

Is it possible to have a default value?

[Cosmin-Parvulescu]

Hmm, it's currently string | null to cast nicely from Stripe client's types:

      /**
       * The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://stripe.com/docs/billing/invoices/workflow#workflow-overview)
       */
      status: Invoice.Status | null;

I guess there could be some default value, but we'd need to handle the casting from the stripe res, not sure if better:

      invoices = stripeInvoices.invoices.data.map((i) => ({
        amount: i.total / 100,
        timestamp: i.created * 1000,
        status: i.status, // Here
        url: i.hosted_invoice_url ?? undefined,
      }))

[szkl]

It might be a good idea to make this an environment variable.

[Cosmin-Parvulescu]

    export type LatestApiVersion = '2022-11-15';
    export type HttpAgent = Agent;
    export type HttpProtocol = 'http' | 'https';

    export interface StripeConfig {
      /**
       * This library's types only reflect the latest API version.
       *
       * We recommend upgrading your account's API Version to the latest version
       * if you wish to use TypeScript with this library.
       *
       * If you wish to remain on your account's default API version,
       * you may pass `null` or another version instead of the latest version,
       * and add a `@ts-ignore` comment here and anywhere the types differ between API versions.
       *
       * @docs https://stripe.com/docs/api/versioning
       */
      apiVersion: LatestApiVersion;

If we put an env variable, we'd still need to cast it to the actual string value, not sure that's worth it or cleaner.

[szkl]

I meant it for updating the value actually.

[szkl]

@proofzero/platform.client?

[Cosmin-Parvulescu]

Good catch! I extracted the enum into the types package as it spans both e-mail and address workers.

[szkl]

Is it possible to avoid !? undefined might not work well with subtraction.

[Cosmin-Parvulescu]

Due to undefined being a possibility, there's a condition (L53) when adding items to the apps list:

    if (appDetails.createdTimestamp != null) {

so we'd expect only items with a timestamp to be present in the planApps. I think it's a case of Typescript not picking it up, so the ! is mostly to stop it from crying. 😁