@stigg/typescript 0.1.0-beta.4 → 0.1.0-beta.40

package/src/resources/v1/credits/custom-currencies.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../../core/resource';
 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';
 
@@ -13,8 +14,19 @@ export class CustomCurrencies extends APIResource {
   /**
    * Creates a new custom currency in the environment.
    */
-  create(body: CustomCurrencyCreateParams, options?: RequestOptions): APIPromise<CustomCurrencyResponse> {
-    return this._client.post('/api/v1/credits/custom-currencies', { body, ...options });
+  create(params: CustomCurrencyCreateParams, options?: RequestOptions): APIPromise<CustomCurrencyResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+    return this._client.post('/api/v1/credits/custom-currencies', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
@@ -22,10 +34,21 @@ export class CustomCurrencies extends APIResource {
    */
   update(
     currencyID: string,
-    body: CustomCurrencyUpdateParams,
+    params: CustomCurrencyUpdateParams,
     options?: RequestOptions,
   ): APIPromise<CustomCurrencyResponse> {
-    return this._client.patch(path`/api/v1/credits/custom-currencies/${currencyID}`, { body, ...options });
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+    return this._client.patch(path`/api/v1/credits/custom-currencies/${currencyID}`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
@@ -34,13 +57,24 @@ export class CustomCurrencies extends APIResource {
    * `status=ACTIVE,ARCHIVED`) to include them.
    */
   list(
-    query: CustomCurrencyListParams | null | undefined = {},
+    params: CustomCurrencyListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<CustomCurrencyListResponsesMyCursorIDPage, CustomCurrencyListResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
     return this._client.getAPIList(
       '/api/v1/credits/custom-currencies',
       MyCursorIDPage<CustomCurrencyListResponse>,
-      { query, ...options },
+      {
+        query,
+        ...options,
+        headers: buildHeaders([
+          {
+            ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+            ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+          },
+          options?.headers,
+        ]),
+      },
     );
   }
 
@@ -49,8 +83,22 @@ export class CustomCurrencies extends APIResource {
    * active plan or addon — use the associated-entities endpoint first to inspect
    * dependencies.
    */
-  archive(currencyID: string, options?: RequestOptions): APIPromise<CustomCurrencyResponse> {
-    return this._client.post(path`/api/v1/credits/custom-currencies/${currencyID}/archive`, options);
+  archive(
+    currencyID: string,
+    params: CustomCurrencyArchiveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CustomCurrencyResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID } = params ?? {};
+    return this._client.post(path`/api/v1/credits/custom-currencies/${currencyID}/archive`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
@@ -59,20 +107,42 @@ export class CustomCurrencies extends APIResource {
    */
   listAssociatedEntities(
     currencyID: string,
+    params: CustomCurrencyListAssociatedEntitiesParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<CustomCurrencyListAssociatedEntitiesResponse> {
-    return this._client.get(
-      path`/api/v1/credits/custom-currencies/${currencyID}/associated-entities`,
-      options,
-    );
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID } = params ?? {};
+    return this._client.get(path`/api/v1/credits/custom-currencies/${currencyID}/associated-entities`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
    * Restores a previously archived custom currency. Fails if another active currency
    * with the same ID already exists.
    */
-  unarchive(currencyID: string, options?: RequestOptions): APIPromise<CustomCurrencyResponse> {
-    return this._client.post(path`/api/v1/credits/custom-currencies/${currencyID}/unarchive`, options);
+  unarchive(
+    currencyID: string,
+    params: CustomCurrencyUnarchiveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CustomCurrencyResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID } = params ?? {};
+    return this._client.post(path`/api/v1/credits/custom-currencies/${currencyID}/unarchive`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 }
 
@@ -255,35 +325,48 @@ export namespace CustomCurrencyListAssociatedEntitiesResponse {
 
 export interface CustomCurrencyCreateParams {
   /**
-   * The unique identifier for the new custom currency
+   * Body param: The unique identifier for the new custom currency
    */
   id: string;
 
   /**
-   * The display name of the custom currency
+   * Body param: The display name of the custom currency
    */
   displayName: string;
 
   /**
-   * Description of the currency
+   * Body param: Description of the currency
    */
   description?: string;
 
   /**
-   * Additional metadata to attach to the custom currency
+   * Body param: Additional metadata to attach to the custom currency
    */
   metadata?: { [key: string]: string };
 
   /**
-   * The symbol used to represent the custom currency
+   * Body param: The symbol used to represent the custom currency
    */
   symbol?: string;
 
   /**
-   * Singular and plural unit labels for a custom currency. Both fields are required
-   * when supplied.
+   * Body param: Singular and plural unit labels for a custom currency. Both fields
+   * are required when supplied.
    */
   units?: CustomCurrencyCreateParams.Units;
+
+  /**
+   * 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 CustomCurrencyCreateParams {
@@ -306,31 +389,45 @@ export namespace CustomCurrencyCreateParams {
 
 export interface CustomCurrencyUpdateParams {
   /**
-   * A human-readable description of the custom currency. Send an empty string to
-   * clear.
+   * Body param: A human-readable description of the custom currency. Send an empty
+   * string to clear.
    */
   description?: string | null;
 
   /**
-   * The display name of the custom currency
+   * Body param: The display name of the custom currency
    */
   displayName?: string;
 
   /**
-   * Additional metadata to attach to the custom currency
+   * Body param: Additional metadata to attach to the custom currency
    */
   metadata?: { [key: string]: string } | null;
 
   /**
-   * The symbol used to represent the custom currency. Send an empty string to clear.
+   * Body param: The symbol used to represent the custom currency. Send an empty
+   * string to clear.
    */
   symbol?: string | null;
 
   /**
-   * Singular and plural unit labels for a custom currency. Both fields are required
-   * when supplied.
+   * Body param: Singular and plural unit labels for a custom currency. Both fields
+   * are required when supplied.
    */
   units?: CustomCurrencyUpdateParams.Units;
+
+  /**
+   * 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 CustomCurrencyUpdateParams {
@@ -353,10 +450,68 @@ export namespace CustomCurrencyUpdateParams {
 
 export interface CustomCurrencyListParams extends MyCursorIDPageParams {
   /**
-   * Filter by custom currency status. Supports comma-separated values (e.g.,
-   * `ACTIVE,ARCHIVED`). Defaults to `ACTIVE`.
+   * Query param: Filter by custom currency status. Supports comma-separated values
+   * (e.g., `ACTIVE,ARCHIVED`). Defaults to `ACTIVE`.
    */
   status?: Array<'ACTIVE' | 'ARCHIVED'>;
+
+  /**
+   * 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 CustomCurrencyArchiveParams {
+  /**
+   * 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 CustomCurrencyListAssociatedEntitiesParams {
+  /**
+   * 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 CustomCurrencyUnarchiveParams {
+  /**
+   * 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 declare namespace CustomCurrencies {
@@ -368,5 +523,8 @@ export declare namespace CustomCurrencies {
     type CustomCurrencyCreateParams as CustomCurrencyCreateParams,
     type CustomCurrencyUpdateParams as CustomCurrencyUpdateParams,
     type CustomCurrencyListParams as CustomCurrencyListParams,
+    type CustomCurrencyArchiveParams as CustomCurrencyArchiveParams,
+    type CustomCurrencyListAssociatedEntitiesParams as CustomCurrencyListAssociatedEntitiesParams,
+    type CustomCurrencyUnarchiveParams as CustomCurrencyUnarchiveParams,
   };
 }

package/src/resources/v1/credits/grants.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../../core/resource';
 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';
 
@@ -14,20 +15,39 @@ export class Grants extends APIResource {
    * Creates a new credit grant for a customer with specified amount, type, and
    * optional billing configuration.
    */
-  create(body: GrantCreateParams, options?: RequestOptions): APIPromise<CreditGrantResponse> {
-    return this._client.post('/api/v1/credits/grants', { body, ...options });
+  create(params: GrantCreateParams, options?: RequestOptions): APIPromise<CreditGrantResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+    return this._client.post('/api/v1/credits/grants', {
+      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 credit grants for a customer.
    */
   list(
-    query: GrantListParams,
+    params: GrantListParams,
     options?: RequestOptions,
   ): PagePromise<GrantListResponsesMyCursorIDPage, GrantListResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params;
     return this._client.getAPIList('/api/v1/credits/grants', MyCursorIDPage<GrantListResponse>, {
       query,
       ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 
@@ -35,8 +55,22 @@ export class Grants extends APIResource {
    * Voids an existing credit grant, preventing further consumption of the remaining
    * credits.
    */
-  void(id: string, options?: RequestOptions): APIPromise<CreditGrantResponse> {
-    return this._client.post(path`/api/v1/credits/grants/${id}/void`, options);
+  void(
+    id: string,
+    params: GrantVoidParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CreditGrantResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID } = params ?? {};
+    return this._client.post(path`/api/v1/credits/grants/${id}/void`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 }
 
@@ -470,79 +504,93 @@ export namespace GrantListResponse {
 
 export interface GrantCreateParams {
   /**
-   * The credit amount to grant
+   * Body param: The credit amount to grant
    */
   amount: number;
 
   /**
-   * The credit currency ID (required)
+   * Body param: The credit currency ID (required)
    */
   currencyId: string;
 
   /**
-   * The customer ID to grant credits to (required)
+   * Body param: The customer ID to grant credits to (required)
    */
   customerId: string;
 
   /**
-   * The display name for the credit grant
+   * Body param: The display name for the credit grant
    */
   displayName: string;
 
   /**
-   * The type of credit grant (PAID, PROMOTIONAL)
+   * Body param: The type of credit grant (PAID, PROMOTIONAL)
    */
   grantType: 'PAID' | 'PROMOTIONAL';
 
   /**
-   * Whether to wait for payment confirmation before returning (default: true)
+   * Body param: Whether to wait for payment confirmation before returning (default:
+   * true)
    */
   awaitPaymentConfirmation?: boolean;
 
   /**
-   * Billing information for the credit grant
+   * Body param: Billing information for the credit grant
    */
   billingInformation?: GrantCreateParams.BillingInformation;
 
   /**
-   * An optional comment on the credit grant
+   * Body param: An optional comment on the credit grant
    */
   comment?: string;
 
   /**
-   * The monetary cost of the credit grant
+   * Body param: The monetary cost of the credit grant
    */
   cost?: GrantCreateParams.Cost;
 
   /**
-   * The date when the credit grant becomes effective
+   * Body param: The date when the credit grant becomes effective
    */
   effectiveAt?: string;
 
   /**
-   * The date when the credit grant expires
+   * Body param: The date when the credit grant expires
    */
   expireAt?: string;
 
   /**
-   * Additional metadata for the credit grant
+   * Body param: Additional metadata for the credit grant
    */
   metadata?: { [key: string]: string };
 
   /**
-   * The payment collection method (CHARGE, INVOICE, NONE)
+   * Body param: The payment collection method (CHARGE, INVOICE, NONE)
    */
   paymentCollectionMethod?: 'CHARGE' | 'INVOICE' | 'NONE';
 
   /**
-   * The priority of the credit grant (lower number = higher priority)
+   * Body param: The priority of the credit grant (lower number = higher priority)
    */
   priority?: number;
 
   /**
-   * The resource ID to scope the grant to
+   * Body param: The resource ID to scope the grant to
    */
   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 namespace GrantCreateParams {
@@ -737,24 +785,38 @@ export namespace GrantCreateParams {
 
 export interface GrantListParams extends MyCursorIDPageParams {
   /**
-   * Filter by customer ID (required)
+   * Query param: Filter by customer ID (required)
    */
   customerId: string;
 
   /**
-   * 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?: GrantListParams.CreatedAt;
 
   /**
-   * Filter by currency ID
+   * Query param: Filter by currency ID
    */
   currencyId?: string;
 
   /**
-   * Filter by resource ID. When omitted, only grants without a resource are returned
+   * Query param: Filter by resource ID. When omitted, only grants without a resource
+   * are returned
    */
   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 namespace GrantListParams {
@@ -784,6 +846,21 @@ export namespace GrantListParams {
   }
 }
 
+export interface GrantVoidParams {
+  /**
+   * 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 declare namespace Grants {
   export {
     type CreditGrantResponse as CreditGrantResponse,
@@ -791,5 +868,6 @@ export declare namespace Grants {
     type GrantListResponsesMyCursorIDPage as GrantListResponsesMyCursorIDPage,
     type GrantCreateParams as GrantCreateParams,
     type GrantListParams as GrantListParams,
+    type GrantVoidParams as GrantVoidParams,
   };
 }

package/src/resources/v1/credits/index.ts

@@ -1,5 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  Consumption,
+  type ConsumptionConsumeResponse,
+  type ConsumptionConsumeAsyncResponse,
+  type ConsumptionConsumeParams,
+  type ConsumptionConsumeAsyncParams,
+} from './consumption';
 export {
   Credits,
   type CreditGetAutoRechargeResponse,
@@ -18,6 +25,9 @@ export {
   type CustomCurrencyCreateParams,
   type CustomCurrencyUpdateParams,
   type CustomCurrencyListParams,
+  type CustomCurrencyArchiveParams,
+  type CustomCurrencyListAssociatedEntitiesParams,
+  type CustomCurrencyUnarchiveParams,
   type CustomCurrencyListResponsesMyCursorIDPage,
 } from './custom-currencies';
 export {
@@ -26,5 +36,6 @@ export {
   type GrantListResponse,
   type GrantCreateParams,
   type GrantListParams,
+  type GrantVoidParams,
   type GrantListResponsesMyCursorIDPage,
 } from './grants';