Add type definition for Stripe.StripeResource

types/2020-08-27/index.d.ts

@@ -105,6 +105,8 @@ declare module 'stripe' {
 
     setAppInfo(info: Stripe.AppInfo): void;
 
+    StripeResource: Stripe.StripeResource;
+
     /**
      * Top Level Resources
      */

types/lib.d.ts

@@ -5,6 +5,42 @@ import {Agent} from 'http';
 
 declare module 'stripe' {
   namespace Stripe {
+    export class StripeResource {
+      static extend<
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        T extends {[prop: string]: any} & {
+          includeBasic?: Array<
+            'create' | 'retrieve' | 'update' | 'list' | 'del'
+          >;
+        }
+      >(spec: T): StripeResource & T;
+      static method(spec: {
+        method: string;
+        path: string;
+        methodType?: 'list';
+      }): (...args: any[]) => object; //eslint-disable-line @typescript-eslint/no-explicit-any
+      static BASIC_METHODS: {
+        create<T>(
+          params: CouponCreateParams,
+          options?: RequestOptions
+        ): Promise<T>;
+        retrieve<T>(
+          id: string,
+          params?: CouponRetrieveParams,
+          options?: RequestOptions
+        ): Promise<T>;
+        update<T>(
+          id: string,
+          params?: CouponUpdateParams,
+          options?: RequestOptions
+        ): Promise<T>;
+        list<T>(
+          params?: CouponListParams,
+          options?: RequestOptions
+        ): ApiListPromise<T>;
+        del<T>(id: string, options?: RequestOptions): Promise<T>;
+      };
+    }
     export type LatestApiVersion = '2020-08-27';
     export type HttpAgent = Agent;
 

types/test/typescriptTest.ts

@@ -168,3 +168,11 @@ const stripeCardError: Stripe.StripeCardError = Stripe.errors.generate({
   code: 'card_declined',
   charge: 'ch_123',
 });
+
+Stripe.StripeResource.extend({
+  includeBasic: ['retrieve'],
+  foo: Stripe.StripeResource.method({
+    method: 'create',
+    path: 'foo',
+  }),
+});