@stigg/typescript 0.1.0-beta.2 → 0.1.0-beta.21

package/src/resources/v1/customers/customers.ts

@@ -13,7 +13,7 @@ import {
   Integrations,
 } from './integrations';
 import * as PaymentMethodAPI from './payment-method';
-import { PaymentMethod, PaymentMethodAttachParams } from './payment-method';
+import { PaymentMethod, PaymentMethodAttachParams, PaymentMethodDetachParams } from './payment-method';
 import * as PromotionalEntitlementsAPI from './promotional-entitlements';
 import {
   PromotionalEntitlementCreateParams,
@@ -27,6 +27,7 @@ import {
 } from './promotional-entitlements';
 import { APIPromise } from '../../../core/api-promise';
 import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../../core/pagination';
+import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
@@ -39,38 +40,114 @@ export class Customers extends APIResource {
   /**
    * Retrieves a customer by their unique identifier, including billing information
    * and subscription status.
-   */
-  retrieve(id: string, options?: RequestOptions): APIPromise<CustomerResponse> {
-    return this._client.get(path`/api/v1/customers/${id}`, options);
+   *
+   * @example
+   * ```ts
+   * const customerResponse = await client.v1.customers.retrieve(
+   *   'x',
+   * );
+   * ```
+   */
+  retrieve(
+    id: string,
+    params: CustomerRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CustomerResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID } = params ?? {};
+    return this._client.get(path`/api/v1/customers/${id}`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
    * Updates an existing customer's properties such as name, email, and billing
    * information.
-   */
-  update(id: string, body: CustomerUpdateParams, options?: RequestOptions): APIPromise<CustomerResponse> {
-    return this._client.patch(path`/api/v1/customers/${id}`, { body, ...options });
+   *
+   * @example
+   * ```ts
+   * const customerResponse = await client.v1.customers.update(
+   *   'x',
+   * );
+   * ```
+   */
+  update(id: string, params: CustomerUpdateParams, options?: RequestOptions): APIPromise<CustomerResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+    return this._client.patch(path`/api/v1/customers/${id}`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
    * Retrieves a paginated list of customers in the environment.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const customerListResponse of client.v1.customers.list()) {
+   *   // ...
+   * }
+   * ```
    */
   list(
-    query: CustomerListParams | null | undefined = {},
+    params: CustomerListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<CustomerListResponsesMyCursorIDPage, CustomerListResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
     return this._client.getAPIList('/api/v1/customers', MyCursorIDPage<CustomerListResponse>, {
       query,
       ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 
   /**
    * Archives a customer, preventing new subscriptions. Optionally cancels existing
    * subscriptions.
-   */
-  archive(id: string, options?: RequestOptions): APIPromise<CustomerResponse> {
-    return this._client.post(path`/api/v1/customers/${id}/archive`, options);
+   *
+   * @example
+   * ```ts
+   * const customerResponse = await client.v1.customers.archive(
+   *   'x',
+   * );
+   * ```
+   */
+  archive(
+    id: string,
+    params: CustomerArchiveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CustomerResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID } = params ?? {};
+    return this._client.post(path`/api/v1/customers/${id}/archive`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
@@ -82,44 +159,124 @@ export class Customers extends APIResource {
    * mechanisms, and low-latency guarantees. It is not recommended for hot-path
    * entitlement checks. For production use, consider using the Stigg Node Server SDK
    * with caching or the Sidecar for low-latency cached responses.
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.customers.checkEntitlement(
+   *   'x',
+   * );
+   * ```
    */
   checkEntitlement(
     id: string,
-    query: CustomerCheckEntitlementParams | null | undefined = {},
+    params: CustomerCheckEntitlementParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<CustomerCheckEntitlementResponse> {
-    return this._client.get(path`/api/v1/customers/${id}/entitlements/check`, { query, ...options });
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
+    return this._client.get(path`/api/v1/customers/${id}/entitlements/check`, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
    * Imports multiple customers in bulk. Used for migrating customer data from
    * external systems.
-   */
-  import(body: CustomerImportParams, options?: RequestOptions): APIPromise<CustomerImportResponse> {
-    return this._client.post('/api/v1/customers/import', { body, ...options });
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.customers.import({
+   *   customers: [
+   *     {
+   *       id: 'id',
+   *       email: 'dev@stainless.com',
+   *       name: 'name',
+   *     },
+   *   ],
+   * });
+   * ```
+   */
+  import(params: CustomerImportParams, options?: RequestOptions): APIPromise<CustomerImportResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+    return this._client.post('/api/v1/customers/import', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
    * Retrieves a paginated list of resources within the same customer.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const customerListResourcesResponse of client.v1.customers.listResources(
+   *   'x',
+   * )) {
+   *   // ...
+   * }
+   * ```
    */
   listResources(
     id: string,
-    query: CustomerListResourcesParams | null | undefined = {},
+    params: CustomerListResourcesParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<CustomerListResourcesResponsesMyCursorIDPage, CustomerListResourcesResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
     return this._client.getAPIList(
       path`/api/v1/customers/${id}/resources`,
       MyCursorIDPage<CustomerListResourcesResponse>,
-      { query, ...options },
+      {
+        query,
+        ...options,
+        headers: buildHeaders([
+          {
+            ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+            ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+          },
+          options?.headers,
+        ]),
+      },
     );
   }
 
   /**
    * Creates a new customer and optionally provisions an initial subscription in a
    * single operation.
-   */
-  provision(body: CustomerProvisionParams, options?: RequestOptions): APIPromise<CustomerResponse> {
-    return this._client.post('/api/v1/customers', { body, ...options });
+   *
+   * @example
+   * ```ts
+   * const customerResponse =
+   *   await client.v1.customers.provision({ id: 'id' });
+   * ```
+   */
+  provision(params: CustomerProvisionParams, options?: RequestOptions): APIPromise<CustomerResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+    return this._client.post('/api/v1/customers', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
@@ -130,20 +287,57 @@ export class Customers extends APIResource {
    * mechanisms, and low-latency guarantees. It is not recommended for hot-path
    * entitlement checks. For production use, consider using the Stigg Node Server SDK
    * with caching or the Sidecar for low-latency cached responses.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.v1.customers.retrieveEntitlements('x');
+   * ```
    */
   retrieveEntitlements(
     id: string,
-    query: CustomerRetrieveEntitlementsParams | null | undefined = {},
+    params: CustomerRetrieveEntitlementsParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<CustomerRetrieveEntitlementsResponse> {
-    return this._client.get(path`/api/v1/customers/${id}/entitlements`, { query, ...options });
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
+    return this._client.get(path`/api/v1/customers/${id}/entitlements`, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
    * Restores an archived customer, allowing them to create new subscriptions again.
+   *
+   * @example
+   * ```ts
+   * const customerResponse =
+   *   await client.v1.customers.unarchive('x');
+   * ```
    */
-  unarchive(id: string, options?: RequestOptions): APIPromise<CustomerResponse> {
-    return this._client.post(path`/api/v1/customers/${id}/unarchive`, options);
+  unarchive(
+    id: string,
+    params: CustomerUnarchiveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CustomerResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID } = params ?? {};
+    return this._client.post(path`/api/v1/customers/${id}/unarchive`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 }
 
@@ -189,7 +383,9 @@ export namespace CustomerIntegrationResponse {
       | 'SALESFORCE'
       | 'BIG_QUERY'
       | 'OPEN_FGA'
-      | 'APP_STORE';
+      | 'APP_STORE'
+      | 'RECEIVED'
+      | 'PREQUEL';
 
     /**
      * Price billing sync revision data containing billing ID, link URL, and price
@@ -517,7 +713,9 @@ export namespace CustomerResponse {
         | 'SALESFORCE'
         | 'BIG_QUERY'
         | 'OPEN_FGA'
-        | 'APP_STORE';
+        | 'APP_STORE'
+        | 'RECEIVED'
+        | 'PREQUEL';
     }
 
     /**
@@ -1099,7 +1297,9 @@ export namespace CustomerListResponse {
       | 'SALESFORCE'
       | 'BIG_QUERY'
       | 'OPEN_FGA'
-      | 'APP_STORE';
+      | 'APP_STORE'
+      | 'RECEIVED'
+      | 'PREQUEL';
   }
 
   /**
@@ -1853,9 +2053,24 @@ export namespace CustomerRetrieveEntitlementsResponse {
   }
 }
 
+export interface CustomerRetrieveParams {
+  /**
+   * Account ID — optional when authenticating with a user JWT (Bearer token); falls
+   * back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Environment ID — required when authenticating with a user JWT (Bearer token) on
+   * environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the
+   * key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
+}
+
 export interface CustomerUpdateParams {
   /**
-   * The billing currency of the customer
+   * Body param: The billing currency of the customer
    */
   billingCurrency?:
     | 'usd'
@@ -1977,49 +2192,62 @@ export interface CustomerUpdateParams {
     | null;
 
   /**
-   * The unique identifier for the entity in the billing provider
+   * Body param: The unique identifier for the entity in the billing provider
    */
   billingId?: string | null;
 
   /**
-   * Customer level coupon
+   * Body param: Customer level coupon
    */
   couponId?: (string & {}) | '' | null;
 
   /**
-   * The email of the customer
+   * Body param: The email of the customer
    */
   email?: string | null;
 
   /**
-   * List of integrations
+   * Body param: List of integrations
    */
   integrations?: Array<CustomerUpdateParams.Integration>;
 
   /**
-   * Language to use for this customer
+   * Body param: Language to use for this customer
    */
   language?: string | null;
 
   /**
-   * Additional metadata
+   * Body param: Additional metadata
    */
   metadata?: { [key: string]: string };
 
   /**
-   * The name of the customer
+   * Body param: The name of the customer
    */
   name?: string | null;
 
   /**
-   * Vendor-specific billing passthrough fields.
+   * Body param: Vendor-specific billing passthrough fields.
    */
   passthrough?: CustomerUpdateParams.Passthrough;
 
   /**
-   * Timezone to use for this customer
+   * Body param: Timezone to use for this customer
    */
   timezone?: string | null;
+
+  /**
+   * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+   * token); falls back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Header param: Environment ID — required when authenticating with a user JWT
+   * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+   * intrinsic to the key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
 }
 
 export namespace CustomerUpdateParams {
@@ -2050,7 +2278,9 @@ export namespace CustomerUpdateParams {
       | 'SALESFORCE'
       | 'BIG_QUERY'
       | 'OPEN_FGA'
-      | 'APP_STORE';
+      | 'APP_STORE'
+      | 'RECEIVED'
+      | 'PREQUEL';
   }
 
   /**
@@ -2378,19 +2608,32 @@ export namespace CustomerUpdateParams {
 
 export interface CustomerListParams extends MyCursorIDPageParams {
   /**
-   * Filter by creation date using range operators: gt, gte, lt, lte
+   * Query param: Filter by creation date using range operators: gt, gte, lt, lte
    */
   createdAt?: CustomerListParams.CreatedAt;
 
   /**
-   * Filter by exact customer email address
+   * Query param: Filter by exact customer email address
    */
   email?: string;
 
   /**
-   * Filter by exact customer name
+   * Query param: Filter by exact customer name
    */
   name?: string;
+
+  /**
+   * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+   * token); falls back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Header param: Environment ID — required when authenticating with a user JWT
+   * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+   * intrinsic to the key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
 }
 
 export namespace CustomerListParams {
@@ -2420,45 +2663,87 @@ export namespace CustomerListParams {
   }
 }
 
+export interface CustomerArchiveParams {
+  /**
+   * Account ID — optional when authenticating with a user JWT (Bearer token); falls
+   * back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Environment ID — required when authenticating with a user JWT (Bearer token) on
+   * environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the
+   * key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
+}
+
 export interface CustomerCheckEntitlementParams {
   /**
-   * Currency ID (refId) to check for credit entitlements. Mutually exclusive with
-   * `featureId`.
+   * Query param: Currency ID (refId) to check for credit entitlements. Mutually
+   * exclusive with `featureId`.
    */
   currencyId?: string;
 
   /**
-   * Feature ID (refId) to check. Mutually exclusive with `currencyId`.
+   * Query param: Feature ID (refId) to check. Mutually exclusive with `currencyId`.
    */
   featureId?: string;
 
   /**
-   * Requested usage amount to evaluate against the entitlement limit (numeric
-   * features only)
+   * Query param: Requested usage amount to evaluate against the entitlement limit
+   * (numeric features only)
    */
   requestedUsage?: number;
 
   /**
-   * Requested values to evaluate against allowed values (enum features only)
+   * Query param: Requested values to evaluate against allowed values (enum features
+   * only)
    */
   requestedValues?: Array<string>;
 
   /**
-   * Resource ID to scope the entitlement check to a specific resource
+   * Query param: Resource ID to scope the entitlement check to a specific resource
    */
   resourceId?: string;
+
+  /**
+   * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+   * token); falls back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Header param: Environment ID — required when authenticating with a user JWT
+   * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+   * intrinsic to the key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
 }
 
 export interface CustomerImportParams {
   /**
-   * List of customer objects to import
+   * Body param: List of customer objects to import
    */
   customers: Array<CustomerImportParams.Customer>;
 
   /**
-   * Integration details
+   * Body param: Integration details
    */
   integrationId?: string;
+
+  /**
+   * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+   * token); falls back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Header param: Environment ID — required when authenticating with a user JWT
+   * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+   * intrinsic to the key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
 }
 
 export namespace CustomerImportParams {
@@ -2505,16 +2790,29 @@ export namespace CustomerImportParams {
   }
 }
 
-export interface CustomerListResourcesParams extends MyCursorIDPageParams {}
+export interface CustomerListResourcesParams extends MyCursorIDPageParams {
+  /**
+   * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+   * token); falls back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Header param: Environment ID — required when authenticating with a user JWT
+   * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+   * intrinsic to the key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
+}
 
 export interface CustomerProvisionParams {
   /**
-   * Customer slug
+   * Body param: Customer slug
    */
   id: string;
 
   /**
-   * The billing currency of the customer
+   * Body param: The billing currency of the customer
    */
   billingCurrency?:
     | 'usd'
@@ -2636,54 +2934,67 @@ export interface CustomerProvisionParams {
     | null;
 
   /**
-   * The unique identifier for the entity in the billing provider
+   * Body param: The unique identifier for the entity in the billing provider
    */
   billingId?: string | null;
 
   /**
-   * Customer level coupon
+   * Body param: Customer level coupon
    */
   couponId?: (string & {}) | '' | null;
 
   /**
-   * The default payment method details
+   * Body param: The default payment method details
    */
   defaultPaymentMethod?: CustomerProvisionParams.DefaultPaymentMethod | null;
 
   /**
-   * The email of the customer
+   * Body param: The email of the customer
    */
   email?: string | null;
 
   /**
-   * List of integrations
+   * Body param: List of integrations
    */
   integrations?: Array<CustomerProvisionParams.Integration>;
 
   /**
-   * Language to use for this customer
+   * Body param: Language to use for this customer
    */
   language?: string | null;
 
   /**
-   * Additional metadata
+   * Body param: Additional metadata
    */
   metadata?: { [key: string]: string };
 
   /**
-   * The name of the customer
+   * Body param: The name of the customer
    */
   name?: string | null;
 
   /**
-   * Vendor-specific billing passthrough fields.
+   * Body param: Vendor-specific billing passthrough fields.
    */
   passthrough?: CustomerProvisionParams.Passthrough;
 
   /**
-   * Timezone to use for this customer
+   * Body param: Timezone to use for this customer
    */
   timezone?: string | null;
+
+  /**
+   * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+   * token); falls back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Header param: Environment ID — required when authenticating with a user JWT
+   * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+   * intrinsic to the key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
 }
 
 export namespace CustomerProvisionParams {
@@ -2744,7 +3055,9 @@ export namespace CustomerProvisionParams {
       | 'SALESFORCE'
       | 'BIG_QUERY'
       | 'OPEN_FGA'
-      | 'APP_STORE';
+      | 'APP_STORE'
+      | 'RECEIVED'
+      | 'PREQUEL';
   }
 
   /**
@@ -3072,9 +3385,37 @@ export namespace CustomerProvisionParams {
 
 export interface CustomerRetrieveEntitlementsParams {
   /**
-   * Resource ID to scope entitlements to a specific resource
+   * Query param: Resource ID to scope entitlements to a specific resource
    */
   resourceId?: string;
+
+  /**
+   * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+   * token); falls back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Header param: Environment ID — required when authenticating with a user JWT
+   * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+   * intrinsic to the key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
+}
+
+export interface CustomerUnarchiveParams {
+  /**
+   * Account ID — optional when authenticating with a user JWT (Bearer token); falls
+   * back to the user's first membership. Ignored for API-key auth.
+   */
+  'X-ACCOUNT-ID'?: string;
+
+  /**
+   * Environment ID — required when authenticating with a user JWT (Bearer token) on
+   * environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the
+   * key).
+   */
+  'X-ENVIRONMENT-ID'?: string;
 }
 
 Customers.PaymentMethod = PaymentMethod;
@@ -3092,16 +3433,23 @@ export declare namespace Customers {
     type CustomerRetrieveEntitlementsResponse as CustomerRetrieveEntitlementsResponse,
     type CustomerListResponsesMyCursorIDPage as CustomerListResponsesMyCursorIDPage,
     type CustomerListResourcesResponsesMyCursorIDPage as CustomerListResourcesResponsesMyCursorIDPage,
+    type CustomerRetrieveParams as CustomerRetrieveParams,
     type CustomerUpdateParams as CustomerUpdateParams,
     type CustomerListParams as CustomerListParams,
+    type CustomerArchiveParams as CustomerArchiveParams,
     type CustomerCheckEntitlementParams as CustomerCheckEntitlementParams,
     type CustomerImportParams as CustomerImportParams,
     type CustomerListResourcesParams as CustomerListResourcesParams,
     type CustomerProvisionParams as CustomerProvisionParams,
     type CustomerRetrieveEntitlementsParams as CustomerRetrieveEntitlementsParams,
+    type CustomerUnarchiveParams as CustomerUnarchiveParams,
   };
 
-  export { PaymentMethod as PaymentMethod, type PaymentMethodAttachParams as PaymentMethodAttachParams };
+  export {
+    PaymentMethod as PaymentMethod,
+    type PaymentMethodAttachParams as PaymentMethodAttachParams,
+    type PaymentMethodDetachParams as PaymentMethodDetachParams,
+  };
 
   export {
     PromotionalEntitlements as PromotionalEntitlements,