[PB-5982]: add referral token creation and metadata support for customer payments

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@internxt/sdk",
   "author": "Internxt <hello@internxt.com>",
-  "version": "1.15.2",
+  "version": "1.15.3",
   "description": "An sdk for interacting with Internxt's services",
   "repository": {
     "type": "git",

src/drive/referrals/index.ts

@@ -1,6 +1,6 @@
 import { headersWithToken } from '../../shared/headers';
 import { ApiSecurity, ApiUrl, AppDetails } from '../../shared';
-import { UserReferral } from './types';
+import { ReferralTokenResponse, UserReferral } from './types';
 import { HttpClient } from '../../shared/http/client';
 
 export * as ReferralTypes from './types';
@@ -27,6 +27,13 @@ export class Referrals {
     return this.client.get('/users-referrals', this.headers());
   }
 
+  /**
+   * Generates a referral token for the authenticated user
+   */
+  public createReferralToken(): Promise<ReferralTokenResponse> {
+    return this.client.post('/referral/token', {}, this.headers());
+  }
+
   /**
    * Returns the needed headers for the module requests
    * @private

src/drive/referrals/types.ts

@@ -21,3 +21,7 @@ export interface UserReferral {
   credit: number;
   type: ReferralType;
 }
+
+export interface ReferralTokenResponse {
+  token: string;
+}

src/payments/checkout.ts

@@ -38,6 +38,7 @@ export class Checkout {
    * @param postalCode - The postal code of the customer
    * @param captchaToken - The captcha token to verify the call
    * @param companyVatId - The VAT ID of the company (optional)
+   * @param metadata - Additional metadata to attach to the customer (optional)
    * @returns The customer ID and the user token used to create a subscription or payment intent
    */
   public createCustomer({
@@ -49,6 +50,7 @@ export class Checkout {
     country,
     captchaToken,
     companyVatId,
+    metadata,
   }: CreateCustomerPayload): Promise<{
     customerId: string;
     token: string;
@@ -64,6 +66,7 @@ export class Checkout {
         postalCode,
         captchaToken,
         companyVatId,
+        metadata,
       },
       this.authHeaders(),
     );

src/payments/types/index.ts

@@ -9,6 +9,7 @@ export interface CreateCustomerPayload {
   postalCode: string;
   captchaToken: string;
   companyVatId?: string;
+  metadata?: Record<string, string>;
 }
 
 export interface CreateSubscriptionPayload {