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

package/src/resources/v1/events/data-export/destinations.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../../../core/resource';
 import { APIPromise } from '../../../../core/api-promise';
+import { buildHeaders } from '../../../../internal/headers';
 import { RequestOptions } from '../../../../internal/request-options';
 import { path } from '../../../../internal/utils/path';
 
@@ -10,33 +11,41 @@ export class Destinations extends APIResource {
    * Register a destination on the environment's DATA_EXPORT integration.
    * Lazy-creates the integration row + provider recipient on first call. Idempotent
    * on destinationId.
-   *
-   * @example
-   * ```ts
-   * const destination =
-   *   await client.v1.events.dataExport.destinations.create({
-   *     destinationId: 'x',
-   *     destinationType: 'x',
-   *   });
-   * ```
    */
-  create(body: DestinationCreateParams, options?: RequestOptions): APIPromise<DestinationCreateResponse> {
-    return this._client.post('/api/v1/data-export/destinations', { body, ...options });
+  create(params: DestinationCreateParams, options?: RequestOptions): APIPromise<DestinationCreateResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+    return this._client.post('/api/v1/data-export/destinations', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
    * Remove a destination from the DATA_EXPORT integration metadata. Idempotent.
-   *
-   * @example
-   * ```ts
-   * const destination =
-   *   await client.v1.events.dataExport.destinations.delete(
-   *     'x',
-   *   );
-   * ```
    */
-  delete(destinationID: string, options?: RequestOptions): APIPromise<DestinationDeleteResponse> {
-    return this._client.delete(path`/api/v1/data-export/destinations/${destinationID}`, options);
+  delete(
+    destinationID: string,
+    params: DestinationDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DestinationDeleteResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID } = params ?? {};
+    return this._client.delete(path`/api/v1/data-export/destinations/${destinationID}`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 }
 
@@ -224,14 +233,42 @@ export namespace DestinationDeleteResponse {
 
 export interface DestinationCreateParams {
   /**
-   * The provider destination ID returned by the embedded SDK on connect
+   * Body param: The provider destination ID returned by the embedded SDK on connect
    */
   destinationId: string;
 
   /**
-   * The destination type (e.g. snowflake, bigquery)
+   * Body param: The destination type (e.g. snowflake, bigquery)
    */
   destinationType: 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 DestinationDeleteParams {
+  /**
+   * 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 Destinations {
@@ -239,5 +276,6 @@ export declare namespace Destinations {
     type DestinationCreateResponse as DestinationCreateResponse,
     type DestinationDeleteResponse as DestinationDeleteResponse,
     type DestinationCreateParams as DestinationCreateParams,
+    type DestinationDeleteParams as DestinationDeleteParams,
   };
 }

package/src/resources/v1/events/data-export/index.ts

@@ -12,4 +12,5 @@ export {
   type DestinationCreateResponse,
   type DestinationDeleteResponse,
   type DestinationCreateParams,
+  type DestinationDeleteParams,
 } from './destinations';

package/src/resources/v1/events/events.ts

@@ -1,8 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
-import * as BetaAPI from './beta/beta';
-import { Beta } from './beta/beta';
 import * as DataExportAPI from './data-export/data-export';
 import {
   DataExport,
@@ -19,25 +17,11 @@ import { RequestOptions } from '../../../internal/request-options';
  * Operations related to usage & metering
  */
 export class Events extends APIResource {
-  beta: BetaAPI.Beta = new BetaAPI.Beta(this._client);
   dataExport: DataExportAPI.DataExport = new DataExportAPI.DataExport(this._client);
 
   /**
    * Reports raw usage events for event-based metering. Events are ingested
    * asynchronously and aggregated into usage totals.
-   *
-   * @example
-   * ```ts
-   * const response = await client.v1.events.report({
-   *   events: [
-   *     {
-   *       customerId: 'customerId',
-   *       eventName: 'x',
-   *       idempotencyKey: 'x',
-   *     },
-   *   ],
-   * });
-   * ```
    */
   report(params: EventReportParams, options?: RequestOptions): APIPromise<EventReportResponse> {
     const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
@@ -123,14 +107,11 @@ export namespace EventReportParams {
   }
 }
 
-Events.Beta = Beta;
 Events.DataExport = DataExport;
 
 export declare namespace Events {
   export { type EventReportResponse as EventReportResponse, type EventReportParams as EventReportParams };
 
-  export { Beta as Beta };
-
   export {
     DataExport as DataExport,
     type DataExportMintScopedTokenResponse as DataExportMintScopedTokenResponse,

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

@@ -1,6 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Beta } from './beta/index';
 export {
   DataExport,
   type DataExportMintScopedTokenResponse,

package/src/resources/v1/features.ts

@@ -13,13 +13,6 @@ import { path } from '../../internal/utils/path';
 export class Features extends APIResource {
   /**
    * Archives a feature, preventing it from being used in new entitlements.
-   *
-   * @example
-   * ```ts
-   * const feature = await client.v1.features.archiveFeature(
-   *   'x',
-   * );
-   * ```
    */
   archiveFeature(
     id: string,
@@ -41,15 +34,6 @@ export class Features extends APIResource {
 
   /**
    * Creates a new feature with the specified type, metering, and configuration.
-   *
-   * @example
-   * ```ts
-   * const feature = await client.v1.features.createFeature({
-   *   id: 'id',
-   *   displayName: 'displayName',
-   *   featureType: 'BOOLEAN',
-   * });
-   * ```
    */
   createFeature(params: FeatureCreateFeatureParams, options?: RequestOptions): APIPromise<Feature> {
     const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
@@ -68,14 +52,6 @@ export class Features extends APIResource {
 
   /**
    * Retrieves a paginated list of features in the environment.
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const featureListFeaturesResponse of client.v1.features.listFeatures()) {
-   *   // ...
-   * }
-   * ```
    */
   listFeatures(
     params: FeatureListFeaturesParams | null | undefined = {},
@@ -97,13 +73,6 @@ export class Features extends APIResource {
 
   /**
    * Retrieves a feature by its unique identifier.
-   *
-   * @example
-   * ```ts
-   * const feature = await client.v1.features.retrieveFeature(
-   *   'x',
-   * );
-   * ```
    */
   retrieveFeature(
     id: string,
@@ -125,13 +94,6 @@ export class Features extends APIResource {
 
   /**
    * Restores an archived feature, allowing it to be used in entitlements again.
-   *
-   * @example
-   * ```ts
-   * const feature = await client.v1.features.unarchiveFeature(
-   *   'x',
-   * );
-   * ```
    */
   unarchiveFeature(
     id: string,
@@ -154,11 +116,6 @@ export class Features extends APIResource {
   /**
    * Updates an existing feature's properties such as display name, description, and
    * configuration.
-   *
-   * @example
-   * ```ts
-   * const feature = await client.v1.features.updateFeature('x');
-   * ```
    */
   updateFeature(
     id: string,

package/src/resources/v1/plans/entitlements.ts

@@ -9,14 +9,6 @@ import { path } from '../../../internal/utils/path';
 export class Entitlements extends APIResource {
   /**
    * Creates one or more entitlements (feature or credit) on a draft plan.
-   *
-   * @example
-   * ```ts
-   * const entitlement =
-   *   await client.v1.plans.entitlements.create('planId', {
-   *     entitlements: [{ id: 'id', type: 'FEATURE' }],
-   *   });
-   * ```
    */
   create(
     planID: string,
@@ -39,15 +31,6 @@ export class Entitlements extends APIResource {
 
   /**
    * Updates an existing entitlement on a draft plan.
-   *
-   * @example
-   * ```ts
-   * const planEntitlement =
-   *   await client.v1.plans.entitlements.update('id', {
-   *     planId: 'planId',
-   *     type: 'FEATURE',
-   *   });
-   * ```
    */
   update(id: string, params: EntitlementUpdateParams, options?: RequestOptions): APIPromise<PlanEntitlement> {
     const { planId, 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
@@ -66,12 +49,6 @@ export class Entitlements extends APIResource {
 
   /**
    * Retrieves a list of entitlements for a plan.
-   *
-   * @example
-   * ```ts
-   * const entitlements =
-   *   await client.v1.plans.entitlements.list('planId');
-   * ```
    */
   list(
     planID: string,
@@ -93,14 +70,6 @@ export class Entitlements extends APIResource {
 
   /**
    * Deletes an entitlement from a draft plan.
-   *
-   * @example
-   * ```ts
-   * const planEntitlement =
-   *   await client.v1.plans.entitlements.delete('id', {
-   *     planId: 'planId',
-   *   });
-   * ```
    */
   delete(id: string, params: EntitlementDeleteParams, options?: RequestOptions): APIPromise<PlanEntitlement> {
     const { planId, 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID } = params;

package/src/resources/v1/plans/plans.ts

@@ -26,15 +26,6 @@ export class Plans extends APIResource {
 
   /**
    * Creates a new plan in draft status.
-   *
-   * @example
-   * ```ts
-   * const plan = await client.v1.plans.create({
-   *   id: 'id',
-   *   displayName: 'displayName',
-   *   productId: 'productId',
-   * });
-   * ```
    */
   create(params: PlanCreateParams, options?: RequestOptions): APIPromise<Plan> {
     const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
@@ -54,11 +45,6 @@ export class Plans extends APIResource {
   /**
    * Retrieves a plan by its unique identifier, including entitlements and pricing
    * details.
-   *
-   * @example
-   * ```ts
-   * const plan = await client.v1.plans.retrieve('x');
-   * ```
    */
   retrieve(
     id: string,
@@ -81,11 +67,6 @@ export class Plans extends APIResource {
   /**
    * Updates an existing plan's properties such as display name, description, and
    * metadata.
-   *
-   * @example
-   * ```ts
-   * const plan = await client.v1.plans.update('x');
-   * ```
    */
   update(id: string, params: PlanUpdateParams, options?: RequestOptions): APIPromise<Plan> {
     const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
@@ -104,14 +85,6 @@ export class Plans extends APIResource {
 
   /**
    * Retrieves a paginated list of plans in the environment.
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const planListResponse of client.v1.plans.list()) {
-   *   // ...
-   * }
-   * ```
    */
   list(
     params: PlanListParams | null | undefined = {},
@@ -133,11 +106,6 @@ export class Plans extends APIResource {
 
   /**
    * Archives a plan, preventing it from being used in new subscriptions.
-   *
-   * @example
-   * ```ts
-   * const plan = await client.v1.plans.archive('x');
-   * ```
    */
   archive(
     id: string,
@@ -159,11 +127,6 @@ export class Plans extends APIResource {
 
   /**
    * Creates a draft version of an existing plan for modification before publishing.
-   *
-   * @example
-   * ```ts
-   * const plan = await client.v1.plans.createDraft('x');
-   * ```
    */
   createDraft(
     id: string,
@@ -185,16 +148,6 @@ export class Plans extends APIResource {
 
   /**
    * Retrieves the list of charges configured on a plan.
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const planListChargesResponse of client.v1.plans.listCharges(
-   *   'x',
-   * )) {
-   *   // ...
-   * }
-   * ```
    */
   listCharges(
     id: string,
@@ -221,16 +174,6 @@ export class Plans extends APIResource {
 
   /**
    * Retrieves the list of overage charges configured on a plan.
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const planListOverageChargesResponse of client.v1.plans.listOverageCharges(
-   *   'x',
-   * )) {
-   *   // ...
-   * }
-   * ```
    */
   listOverageCharges(
     id: string,
@@ -257,13 +200,6 @@ export class Plans extends APIResource {
 
   /**
    * Publishes a draft plan, making it available for use in subscriptions.
-   *
-   * @example
-   * ```ts
-   * const response = await client.v1.plans.publish('x', {
-   *   migrationType: 'NEW_CUSTOMERS',
-   * });
-   * ```
    */
   publish(id: string, params: PlanPublishParams, options?: RequestOptions): APIPromise<PlanPublishResponse> {
     const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
@@ -282,11 +218,6 @@ export class Plans extends APIResource {
 
   /**
    * Removes a draft version of a plan.
-   *
-   * @example
-   * ```ts
-   * const response = await client.v1.plans.removeDraft('x');
-   * ```
    */
   removeDraft(
     id: string,

package/src/resources/v1/products.ts

@@ -14,13 +14,6 @@ export class Products extends APIResource {
   /**
    * Archives a product, preventing new subscriptions. All plans and addons are
    * archived.
-   *
-   * @example
-   * ```ts
-   * const product = await client.v1.products.archiveProduct(
-   *   'x',
-   * );
-   * ```
    */
   archiveProduct(
     id: string,
@@ -42,14 +35,6 @@ export class Products extends APIResource {
 
   /**
    * Creates a new product.
-   *
-   * @example
-   * ```ts
-   * const product = await client.v1.products.createProduct({
-   *   id: 'id',
-   *   displayName: 'displayName',
-   * });
-   * ```
    */
   createProduct(params: ProductCreateProductParams, options?: RequestOptions): APIPromise<Product> {
     const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
@@ -68,14 +53,6 @@ export class Products extends APIResource {
 
   /**
    * Duplicates an existing product, including its plans, addons, and configuration.
-   *
-   * @example
-   * ```ts
-   * const product = await client.v1.products.duplicateProduct(
-   *   'x',
-   *   { targetId: 'targetId' },
-   * );
-   * ```
    */
   duplicateProduct(
     id: string,
@@ -98,14 +75,6 @@ export class Products extends APIResource {
 
   /**
    * Retrieves a paginated list of products in the environment.
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const productListProductsResponse of client.v1.products.listProducts()) {
-   *   // ...
-   * }
-   * ```
    */
   listProducts(
     params: ProductListProductsParams | null | undefined = {},
@@ -127,13 +96,6 @@ export class Products extends APIResource {
 
   /**
    * Restores an archived product, allowing new subscriptions to be created.
-   *
-   * @example
-   * ```ts
-   * const product = await client.v1.products.unarchiveProduct(
-   *   'x',
-   * );
-   * ```
    */
   unarchiveProduct(
     id: string,
@@ -156,11 +118,6 @@ export class Products extends APIResource {
   /**
    * Updates an existing product's properties such as display name, description, and
    * metadata.
-   *
-   * @example
-   * ```ts
-   * const product = await client.v1.products.updateProduct('x');
-   * ```
    */
   updateProduct(
     id: string,

package/src/resources/v1/subscriptions/future-update.ts

@@ -12,14 +12,6 @@ import { path } from '../../../internal/utils/path';
 export class FutureUpdate extends APIResource {
   /**
    * Cancels a subscription update that is pending payment completion.
-   *
-   * @example
-   * ```ts
-   * const cancelSubscription =
-   *   await client.v1.subscriptions.futureUpdate.cancelPendingPayment(
-   *     'x',
-   *   );
-   * ```
    */
   cancelPendingPayment(
     id: string,
@@ -42,14 +34,6 @@ export class FutureUpdate extends APIResource {
   /**
    * Cancels a scheduled subscription update, such as a future downgrade or plan
    * change.
-   *
-   * @example
-   * ```ts
-   * const cancelSubscription =
-   *   await client.v1.subscriptions.futureUpdate.cancelSchedule(
-   *     'x',
-   *   );
-   * ```
    */
   cancelSchedule(
     id: string,

package/src/resources/v1/subscriptions/invoice.ts

@@ -13,12 +13,6 @@ export class Invoice extends APIResource {
   /**
    * Marks the latest invoice of a subscription as paid in the billing provider. The
    * invoice must exist and have an OPEN status.
-   *
-   * @example
-   * ```ts
-   * const response =
-   *   await client.v1.subscriptions.invoice.markAsPaid('x');
-   * ```
    */
   markAsPaid(
     id: string,