@stigg/typescript 0.1.0-beta.14 → 0.1.0-beta.15

package/resources/v1/plans/plans.js

@@ -18,6 +18,15 @@ class Plans extends resource_1.APIResource {
     }
     /**
      * Creates a new plan in draft status.
+     *
+     * @example
+     * ```ts
+     * const plan = await client.v1.plans.create({
+     *   id: 'id',
+     *   displayName: 'displayName',
+     *   productId: 'productId',
+     * });
+     * ```
      */
     create(body, options) {
         return this._client.post('/api/v1/plans', { body, ...options });
@@ -25,6 +34,11 @@ class Plans extends resource_1.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, options) {
         return this._client.get((0, path_1.path) `/api/v1/plans/${id}`, options);
@@ -32,48 +46,103 @@ class Plans extends resource_1.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, body, options) {
         return this._client.patch((0, path_1.path) `/api/v1/plans/${id}`, { body, ...options });
     }
     /**
      * 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(query = {}, options) {
         return this._client.getAPIList('/api/v1/plans', (pagination_1.MyCursorIDPage), { query, ...options });
     }
     /**
      * Archives a plan, preventing it from being used in new subscriptions.
+     *
+     * @example
+     * ```ts
+     * const plan = await client.v1.plans.archive('x');
+     * ```
      */
     archive(id, options) {
         return this._client.post((0, path_1.path) `/api/v1/plans/${id}/archive`, options);
     }
     /**
      * Creates a draft version of an existing plan for modification before publishing.
+     *
+     * @example
+     * ```ts
+     * const plan = await client.v1.plans.createDraft('x');
+     * ```
      */
     createDraft(id, options) {
         return this._client.post((0, path_1.path) `/api/v1/plans/${id}/draft`, options);
     }
     /**
      * 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, query = {}, options) {
         return this._client.getAPIList((0, path_1.path) `/api/v1/plans/${id}/charges`, (pagination_1.MyCursorIDPage), { query, ...options });
     }
     /**
      * 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, query = {}, options) {
         return this._client.getAPIList((0, path_1.path) `/api/v1/plans/${id}/overage-charges`, (pagination_1.MyCursorIDPage), { query, ...options });
     }
     /**
      * 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, body, options) {
         return this._client.post((0, path_1.path) `/api/v1/plans/${id}/publish`, { body, ...options });
     }
     /**
      * Removes a draft version of a plan.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.plans.removeDraft('x');
+     * ```
      */
     removeDraft(id, options) {
         return this._client.delete((0, path_1.path) `/api/v1/plans/${id}/draft`, options);

package/resources/v1/plans/plans.js.map

@@ -1 +1 @@
-{"version":3,"file":"plans.js","sourceRoot":"","sources":["../../../src/resources/v1/plans/plans.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,2EAAkD;AAClD,oDAQwB;AAExB,4DAAkG;AAElG,0DAAoD;AAEpD;;GAEG;AACH,MAAa,KAAM,SAAQ,sBAAW;IAAtC;;QACE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA4F9F,CAAC;IA1FC;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,IAAsB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAA,2BAAgC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAU,EAAE,OAAwB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,EAAU,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,WAAW,CACT,EAAU,EACV,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,iBAAiB,EAAE,UAAU,EACjC,CAAA,2BAAuC,CAAA,EACvC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB,CAChB,EAAU,EACV,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,iBAAiB,EAAE,kBAAkB,EACzC,CAAA,2BAA8C,CAAA,EAC9C,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAU,EAAE,IAAuB,EAAE,OAAwB;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,EAAU,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACF;AA7FD,sBA6FC;AAw8FD,KAAK,CAAC,YAAY,GAAG,2BAAY,CAAC"}
+{"version":3,"file":"plans.js","sourceRoot":"","sources":["../../../src/resources/v1/plans/plans.ts"],"names":[],"mappings":"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"}

package/resources/v1/plans/plans.mjs

@@ -14,6 +14,15 @@ 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(body, options) {
         return this._client.post('/api/v1/plans', { body, ...options });
@@ -21,6 +30,11 @@ 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, options) {
         return this._client.get(path `/api/v1/plans/${id}`, options);
@@ -28,48 +42,103 @@ 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, body, options) {
         return this._client.patch(path `/api/v1/plans/${id}`, { body, ...options });
     }
     /**
      * 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(query = {}, options) {
         return this._client.getAPIList('/api/v1/plans', (MyCursorIDPage), { query, ...options });
     }
     /**
      * Archives a plan, preventing it from being used in new subscriptions.
+     *
+     * @example
+     * ```ts
+     * const plan = await client.v1.plans.archive('x');
+     * ```
      */
     archive(id, options) {
         return this._client.post(path `/api/v1/plans/${id}/archive`, options);
     }
     /**
      * Creates a draft version of an existing plan for modification before publishing.
+     *
+     * @example
+     * ```ts
+     * const plan = await client.v1.plans.createDraft('x');
+     * ```
      */
     createDraft(id, options) {
         return this._client.post(path `/api/v1/plans/${id}/draft`, options);
     }
     /**
      * 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, query = {}, options) {
         return this._client.getAPIList(path `/api/v1/plans/${id}/charges`, (MyCursorIDPage), { query, ...options });
     }
     /**
      * 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, query = {}, options) {
         return this._client.getAPIList(path `/api/v1/plans/${id}/overage-charges`, (MyCursorIDPage), { query, ...options });
     }
     /**
      * 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, body, options) {
         return this._client.post(path `/api/v1/plans/${id}/publish`, { body, ...options });
     }
     /**
      * Removes a draft version of a plan.
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.plans.removeDraft('x');
+     * ```
      */
     removeDraft(id, options) {
         return this._client.delete(path `/api/v1/plans/${id}/draft`, options);

package/resources/v1/plans/plans.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plans.mjs","sourceRoot":"","sources":["../../../src/resources/v1/plans/plans.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,KAAK,eAAe,2BAAuB;AAClD,OAAO,EAML,YAAY,GAEb,2BAAuB;AAExB,OAAO,EAAE,cAAc,EAA0C,qCAAiC;AAElG,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,WAAW;IAAtC;;QACE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA4F9F,CAAC;IA1FC;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,iBAAiB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,IAAsB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,iBAAiB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAA,cAAgC,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAU,EAAE,OAAwB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,iBAAiB,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,EAAU,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,WAAW,CACT,EAAU,EACV,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,iBAAiB,EAAE,UAAU,EACjC,CAAA,cAAuC,CAAA,EACvC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB,CAChB,EAAU,EACV,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,iBAAiB,EAAE,kBAAkB,EACzC,CAAA,cAA8C,CAAA,EAC9C,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAU,EAAE,IAAuB,EAAE,OAAwB;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,iBAAiB,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,EAAU,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACF;AAw8FD,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC"}
+{"version":3,"file":"plans.mjs","sourceRoot":"","sources":["../../../src/resources/v1/plans/plans.ts"],"names":[],"mappings":"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"}

package/resources/v1/products.d.mts

@@ -9,27 +9,70 @@ export declare 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, options?: RequestOptions): APIPromise<Product>;
     /**
      * Creates a new product.
+     *
+     * @example
+     * ```ts
+     * const product = await client.v1.products.createProduct({
+     *   id: 'id',
+     *   displayName: 'displayName',
+     * });
+     * ```
      */
     createProduct(body: ProductCreateProductParams, options?: RequestOptions): APIPromise<Product>;
     /**
      * 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, body: ProductDuplicateProductParams, options?: RequestOptions): APIPromise<Product>;
     /**
      * 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(query?: ProductListProductsParams | null | undefined, options?: RequestOptions): PagePromise<ProductListProductsResponsesMyCursorIDPage, ProductListProductsResponse>;
     /**
      * Restores an archived product, allowing new subscriptions to be created.
+     *
+     * @example
+     * ```ts
+     * const product = await client.v1.products.unarchiveProduct(
+     *   'x',
+     * );
+     * ```
      */
     unarchiveProduct(id: string, options?: RequestOptions): APIPromise<Product>;
     /**
      * 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, body: ProductUpdateProductParams, options?: RequestOptions): APIPromise<Product>;
 }

package/resources/v1/products.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"products.d.mts","sourceRoot":"","sources":["../../src/resources/v1/products.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"products.d.mts","sourceRoot":"","sources":["../../src/resources/v1/products.ts"],"names":[],"mappings":"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"}

package/resources/v1/products.d.ts

@@ -9,27 +9,70 @@ export declare 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, options?: RequestOptions): APIPromise<Product>;
     /**
      * Creates a new product.
+     *
+     * @example
+     * ```ts
+     * const product = await client.v1.products.createProduct({
+     *   id: 'id',
+     *   displayName: 'displayName',
+     * });
+     * ```
      */
     createProduct(body: ProductCreateProductParams, options?: RequestOptions): APIPromise<Product>;
     /**
      * 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, body: ProductDuplicateProductParams, options?: RequestOptions): APIPromise<Product>;
     /**
      * 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(query?: ProductListProductsParams | null | undefined, options?: RequestOptions): PagePromise<ProductListProductsResponsesMyCursorIDPage, ProductListProductsResponse>;
     /**
      * Restores an archived product, allowing new subscriptions to be created.
+     *
+     * @example
+     * ```ts
+     * const product = await client.v1.products.unarchiveProduct(
+     *   'x',
+     * );
+     * ```
      */
     unarchiveProduct(id: string, options?: RequestOptions): APIPromise<Product>;
     /**
      * 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, body: ProductUpdateProductParams, options?: RequestOptions): APIPromise<Product>;
 }

package/resources/v1/products.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/resources/v1/products.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/resources/v1/products.ts"],"names":[],"mappings":"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"}

package/resources/v1/products.js

@@ -12,24 +12,55 @@ class Products extends resource_1.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, options) {
         return this._client.post((0, path_1.path) `/api/v1/products/${id}/archive`, options);
     }
     /**
      * Creates a new product.
+     *
+     * @example
+     * ```ts
+     * const product = await client.v1.products.createProduct({
+     *   id: 'id',
+     *   displayName: 'displayName',
+     * });
+     * ```
      */
     createProduct(body, options) {
         return this._client.post('/api/v1/products', { body, ...options });
     }
     /**
      * Duplicates an existing product, including its plans, addons, and configuration.
+     *
+     * @example
+     * ```ts
+     * const product = await client.v1.products.duplicateProduct(
+     *   'x',
+     *   { targetId: 'targetId' },
+     * );
+     * ```
      */
     duplicateProduct(id, body, options) {
         return this._client.post((0, path_1.path) `/api/v1/products/${id}/duplicate`, { body, ...options });
     }
     /**
      * 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(query = {}, options) {
         return this._client.getAPIList('/api/v1/products', (pagination_1.MyCursorIDPage), {
@@ -39,6 +70,13 @@ class Products extends resource_1.APIResource {
     }
     /**
      * Restores an archived product, allowing new subscriptions to be created.
+     *
+     * @example
+     * ```ts
+     * const product = await client.v1.products.unarchiveProduct(
+     *   'x',
+     * );
+     * ```
      */
     unarchiveProduct(id, options) {
         return this._client.post((0, path_1.path) `/api/v1/products/${id}/unarchive`, options);
@@ -46,6 +84,11 @@ class Products extends resource_1.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, body, options) {
         return this._client.patch((0, path_1.path) `/api/v1/products/${id}`, { body, ...options });

package/resources/v1/products.js.map

@@ -1 +1 @@
-{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/resources/v1/products.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,yDAA+F;AAE/F,uDAAiD;AAEjD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;OAGG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAAgC,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,EAAU,EACV,IAAmC,EACnC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,YAAY,CACV,QAAsD,EAAE,EACxD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,2BAA2C,CAAA,EAAE;YAC9F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,EAAU,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,EAAU,EAAE,IAAgC,EAAE,OAAwB;QAClF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AAtDD,4BAsDC"}
+{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/resources/v1/products.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,yDAA+F;AAE/F,uDAAiD;AAEjD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;;;OAUG;IACH,aAAa,CAAC,IAAgC,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,EAAU,EACV,IAAmC,EACnC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;OAUG;IACH,YAAY,CACV,QAAsD,EAAE,EACxD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,2BAA2C,CAAA,EAAE;YAC9F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAU,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAU,EAAE,IAAgC,EAAE,OAAwB;QAClF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,oBAAoB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;CACF;AAjGD,4BAiGC"}

package/resources/v1/products.mjs

@@ -9,24 +9,55 @@ 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, options) {
         return this._client.post(path `/api/v1/products/${id}/archive`, options);
     }
     /**
      * Creates a new product.
+     *
+     * @example
+     * ```ts
+     * const product = await client.v1.products.createProduct({
+     *   id: 'id',
+     *   displayName: 'displayName',
+     * });
+     * ```
      */
     createProduct(body, options) {
         return this._client.post('/api/v1/products', { body, ...options });
     }
     /**
      * Duplicates an existing product, including its plans, addons, and configuration.
+     *
+     * @example
+     * ```ts
+     * const product = await client.v1.products.duplicateProduct(
+     *   'x',
+     *   { targetId: 'targetId' },
+     * );
+     * ```
      */
     duplicateProduct(id, body, options) {
         return this._client.post(path `/api/v1/products/${id}/duplicate`, { body, ...options });
     }
     /**
      * 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(query = {}, options) {
         return this._client.getAPIList('/api/v1/products', (MyCursorIDPage), {
@@ -36,6 +67,13 @@ 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, options) {
         return this._client.post(path `/api/v1/products/${id}/unarchive`, options);
@@ -43,6 +81,11 @@ 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, body, options) {
         return this._client.patch(path `/api/v1/products/${id}`, { body, ...options });

package/resources/v1/products.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"products.mjs","sourceRoot":"","sources":["../../src/resources/v1/products.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,EAAE,cAAc,EAA0C,kCAA8B;AAE/F,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;OAGG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAAgC,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,EAAU,EACV,IAAmC,EACnC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,YAAY,CACV,QAAsD,EAAE,EACxD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,cAA2C,CAAA,EAAE;YAC9F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,EAAU,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,EAAU,EAAE,IAAgC,EAAE,OAAwB;QAClF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;CACF"}
+{"version":3,"file":"products.mjs","sourceRoot":"","sources":["../../src/resources/v1/products.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,EAAE,cAAc,EAA0C,kCAA8B;AAE/F,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;;;OAUG;IACH,aAAa,CAAC,IAAgC,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,EAAU,EACV,IAAmC,EACnC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;OAUG;IACH,YAAY,CACV,QAAsD,EAAE,EACxD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,cAA2C,CAAA,EAAE;YAC9F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAU,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAU,EAAE,IAAgC,EAAE,OAAwB;QAClF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,oBAAoB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;CACF"}