@augno/sdk 0.1.9 → 0.7.1

package/resources/catalog/unit-groups/unit-groups.d.ts

@@ -11,24 +11,22 @@ import { RequestOptions } from "../../../internal/request-options.js";
 export declare class UnitGroups extends APIResource {
     units: UnitGroupsUnitsAPI.Units;
     /**
-     * Creates a unit group with optional associated units.
+     * Returns a paginated list of unit groups, including system unit groups.
+     *
+     * This endpoint requires the permission: `unit_groups:read`.
      *
      * @example
      * ```ts
-     * const unitGroup = await client.catalog.unitGroups.create({
-     *   base_unit_id: 'un_01966263f74a5a0cae356000a1',
-     *   name: 'Weight Units',
-     *   type: 'mass',
-     *   associated_units: [
-     *     { unit_id: 'un_01966263f74a5a0cae356000a1' },
-     *   ],
-     * });
+     * const listUnitGroup =
+     *   await client.catalog.unitGroups.list();
      * ```
      */
-    create(params: UnitGroupCreateParams, options?: RequestOptions): APIPromise<UnitGroup>;
+    list(query?: UnitGroupListParams | null | undefined, options?: RequestOptions): APIPromise<ListUnitGroup>;
     /**
      * Returns a unit group by ID.
      *
+     * This endpoint requires the permission: `unit_groups:read`.
+     *
      * @example
      * ```ts
      * const unitGroup = await client.catalog.unitGroups.retrieve(
@@ -38,29 +36,50 @@ export declare class UnitGroups extends APIResource {
      */
     retrieve(id: string, query?: UnitGroupRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<UnitGroup>;
     /**
-     * Partially updates a unit group. System unit groups cannot be updated.
+     * Creates a unit group with optional associated units.
+     *
+     * This endpoint requires the permission: `unit_groups:create`.
      *
      * @example
      * ```ts
-     * const unitGroup = await client.catalog.unitGroups.update(
-     *   'ug_01aad07abb8e41fd392d2d7013',
-     * );
+     * const unitGroup = await client.catalog.unitGroups.create({
+     *   base_unit_id: 'un_01966263f74a5a0cae356000a1',
+     *   name: 'Weight Units',
+     *   type: 'mass',
+     *   associated_units: [
+     *     {
+     *       unit_id: 'un_01966263f74a5a0cae356000a1',
+     *       discount_percentage: 1,
+     *       discount_fixed: 0,
+     *       customer_portal_visibility: 'visible',
+     *     },
+     *   ],
+     * });
      * ```
      */
-    update(id: string, params?: UnitGroupUpdateParams | null | undefined, options?: RequestOptions): APIPromise<UnitGroup>;
+    create(params: UnitGroupCreateParams, options?: RequestOptions): APIPromise<UnitGroup>;
     /**
-     * Returns a paginated list of unit groups, including system unit groups.
+     * Partially updates a unit group. System unit groups cannot be updated.
+     *
+     * This endpoint requires the permission: `unit_groups:update`.
      *
      * @example
      * ```ts
-     * const listUnitGroup =
-     *   await client.catalog.unitGroups.list();
+     * const unitGroup = await client.catalog.unitGroups.update(
+     *   'ug_01aad07abb8e41fd392d2d7013',
+     *   {
+     *     base_unit_id: 'un_01966263f74a5a0cae356000a1',
+     *     name: 'Weight Units (Updated)',
+     *   },
+     * );
      * ```
      */
-    list(query?: UnitGroupListParams | null | undefined, options?: RequestOptions): APIPromise<ListUnitGroup>;
+    update(id: string, params?: UnitGroupUpdateParams | null | undefined, options?: RequestOptions): APIPromise<UnitGroup>;
     /**
-     * Deletes a unit group and all associated unit conversions. System unit groups
-     * cannot be deleted.
+     * Deletes a unit group and all of its associated units. System unit groups cannot
+     * be deleted.
+     *
+     * This endpoint requires the permission: `unit_groups:delete`.
      *
      * @example
      * ```ts
@@ -72,19 +91,23 @@ export declare class UnitGroups extends APIResource {
     delete(id: string, options?: RequestOptions): APIPromise<UnitGroupDeleteResponse>;
 }
 /**
- * CreateUnitGroupRequest is a request to create a unit group.
+ * Request to create a unit group.
  */
 export interface CreateUnitGroupRequest {
     /**
-     * Base unit ID.
+     * ID of the unit to designate as the group's reference unit.
      */
     base_unit_id: string;
     /**
-     * Display name.
+     * Display name of the unit group.
+     *
+     * Must be unique within the account.
      */
     name: string;
     /**
-     * Unit type.
+     * Dimension shared by every unit in this group.
+     *
+     * All associated units must be of this dimension.
      */
     type: 'currency' | 'quantity' | 'time' | 'mass' | 'volume' | 'length' | 'temperature' | 'area';
     /**
@@ -92,28 +115,32 @@ export interface CreateUnitGroupRequest {
      */
     associated_units?: Array<CreateUnitGroupUnitParam>;
     /**
-     * Notes.
+     * Free-form notes about the unit group.
      */
     notes?: string;
 }
 /**
- * CreateUnitGroupUnitParam contains parameters for an associated unit.
+ * Parameters for associating a unit with a unit group.
  */
 export interface CreateUnitGroupUnitParam {
     /**
-     * Unit ID.
+     * ID of the unit to associate with the group.
+     *
+     * The unit's dimension must match the group's `type`.
      */
     unit_id: string;
     /**
-     * Customer portal visibility.
+     * Whether the unit is shown to customers in the customer portal.
      */
     customer_portal_visibility?: 'visible' | 'hidden';
     /**
-     * Fixed discount amount.
+     * Flat amount subtracted from the unit's price when an order is placed in this
+     * unit.
      */
     discount_fixed?: number;
     /**
-     * Discount percentage.
+     * Percentage discount applied to the unit's price when an order is placed in this
+     * unit (e.g. `10` is a 10% discount).
      */
     discount_percentage?: number;
 }
@@ -152,7 +179,8 @@ export interface ListUnitGroupUnit {
     page_info: APIKeysAPI.PageInfo;
 }
 /**
- * UnitGroup is a unit group resource.
+ * Named collection of units sharing one dimension, defining which units products
+ * can be ordered in along with per-unit discounts and customer portal visibility.
  */
 export interface UnitGroup {
     /**
@@ -172,11 +200,13 @@ export interface UnitGroup {
      */
     created_at: string;
     /**
-     * Display name.
+     * Display name of the unit group.
+     *
+     * Unique within the account.
      */
     name: string;
     /**
-     * Notes.
+     * Free-form notes about the unit group.
      */
     notes: string | null;
     /**
@@ -188,7 +218,10 @@ export interface UnitGroup {
      */
     owner: APIKeysAPI.Owner | null;
     /**
-     * Unit type.
+     * Physical dimension shared by every unit in this group, such as mass, volume, or
+     * currency.
+     *
+     * Only units of this dimension can belong to the group.
      */
     type: 'currency' | 'quantity' | 'time' | 'mass' | 'volume' | 'length' | 'temperature' | 'area';
     /**
@@ -197,7 +230,8 @@ export interface UnitGroup {
     updated_at: string;
 }
 /**
- * UnitGroupUnit is an associated unit within a unit group.
+ * Membership of a unit in a unit group, carrying the discount and customer portal
+ * visibility settings applied when ordering in that unit.
  */
 export interface UnitGroupUnit {
     /**
@@ -209,15 +243,17 @@ export interface UnitGroupUnit {
      */
     created_at: string;
     /**
-     * Customer portal visibility.
+     * Whether this unit is shown to customers in the customer portal.
      */
     customer_portal_visibility: 'visible' | 'hidden';
     /**
-     * Fixed discount amount.
+     * Flat amount subtracted from the unit's price when an order is placed in this
+     * unit.
      */
     discount_fixed: number;
     /**
-     * Discount percentage.
+     * Percentage discount applied to the unit's price when an order is placed in this
+     * unit (e.g. `10` is a 10% discount).
      */
     discount_percentage: number;
     /**
@@ -234,40 +270,86 @@ export interface UnitGroupUnit {
     updated_at: string;
 }
 /**
- * UpdateUnitGroupRequest is a request to partially update a unit group.
+ * Request to partially update a unit group.
  */
 export interface UpdateUnitGroupRequest {
     /**
-     * Upserts associated units when provided. Existing units not in the list are
-     * preserved.
+     * Associated units to add or update in the group.
+     *
+     * Upserted by unit: a listed unit already in the group has its association
+     * updated, otherwise it is added. Existing units not in the list are preserved.
      */
     associated_units?: Array<CreateUnitGroupUnitParam>;
     /**
-     * Base unit ID.
+     * ID of the group's base unit.
      */
     base_unit_id?: string;
     /**
-     * Display name.
+     * Display name of the unit group.
+     *
+     * Must be unique within the account.
      */
     name?: string;
     /**
-     * Notes. Set to null to clear.
+     * Free-form notes about the unit group.
+     *
+     * Set to `null` to clear.
      */
     notes?: string | null;
 }
 export interface UnitGroupDeleteResponse {
 }
+export interface UnitGroupListParams {
+    /**
+     * Opaque cursor token identifying where the page of results starts.
+     *
+     * Use the `cursor` value embedded in a previous response's `next_page_url` or
+     * `previous_page_url` to fetch the adjacent page. Omit to start from the first
+     * page.
+     */
+    cursor?: string;
+    /**
+     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+     * `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'base_unit' | 'associated_units'>;
+    /**
+     * Maximum number of results to return in a single page.
+     */
+    limit?: number;
+    /**
+     * Free-text search term used to filter results.
+     *
+     * Which fields are matched against the term varies by endpoint.
+     */
+    q?: string;
+    /**
+     * Filter by unit dimension.
+     */
+    type?: 'currency' | 'quantity' | 'time' | 'mass' | 'volume' | 'length' | 'temperature' | 'area';
+}
+export interface UnitGroupRetrieveParams {
+    /**
+     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+     * `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'base_unit' | 'associated_units'>;
+}
 export interface UnitGroupCreateParams {
     /**
-     * Body param: Base unit ID.
+     * Body param: ID of the unit to designate as the group's reference unit.
      */
     base_unit_id: string;
     /**
-     * Body param: Display name.
+     * Body param: Display name of the unit group.
+     *
+     * Must be unique within the account.
      */
     name: string;
     /**
-     * Body param: Unit type.
+     * Body param: Dimension shared by every unit in this group.
+     *
+     * All associated units must be of this dimension.
      */
     type: 'currency' | 'quantity' | 'time' | 'mass' | 'volume' | 'length' | 'temperature' | 'area';
     /**
@@ -280,17 +362,10 @@ export interface UnitGroupCreateParams {
      */
     associated_units?: Array<CreateUnitGroupUnitParam>;
     /**
-     * Body param: Notes.
+     * Body param: Free-form notes about the unit group.
      */
     notes?: string;
 }
-export interface UnitGroupRetrieveParams {
-    /**
-     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
-     * `null`.
-     */
-    include?: Array<'owner' | 'owner.account' | 'base_unit' | 'associated_units'>;
-}
 export interface UnitGroupUpdateParams {
     /**
      * Query param: Sub-objects to expand in the response. When omitted, sub-objects
@@ -298,48 +373,31 @@ export interface UnitGroupUpdateParams {
      */
     include?: Array<'owner' | 'owner.account' | 'base_unit' | 'associated_units'>;
     /**
-     * Body param: Upserts associated units when provided. Existing units not in the
-     * list are preserved.
+     * Body param: Associated units to add or update in the group.
+     *
+     * Upserted by unit: a listed unit already in the group has its association
+     * updated, otherwise it is added. Existing units not in the list are preserved.
      */
     associated_units?: Array<CreateUnitGroupUnitParam>;
     /**
-     * Body param: Base unit ID.
+     * Body param: ID of the group's base unit.
      */
     base_unit_id?: string;
     /**
-     * Body param: Display name.
+     * Body param: Display name of the unit group.
+     *
+     * Must be unique within the account.
      */
     name?: string;
     /**
-     * Body param: Notes. Set to null to clear.
+     * Body param: Free-form notes about the unit group.
+     *
+     * Set to `null` to clear.
      */
     notes?: string | null;
 }
-export interface UnitGroupListParams {
-    /**
-     * Cursor token used to retrieve the next or previous page of results.
-     */
-    cursor?: string;
-    /**
-     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
-     * `null`.
-     */
-    include?: Array<'owner' | 'owner.account' | 'base_unit' | 'associated_units'>;
-    /**
-     * Maximum number of results per page (default: 100, max: 1000).
-     */
-    limit?: number;
-    /**
-     * Search query used to filter results.
-     */
-    q?: string;
-    /**
-     * Filter by the unit type.
-     */
-    type?: 'currency' | 'quantity' | 'time' | 'mass' | 'volume' | 'length' | 'temperature' | 'area';
-}
 export declare namespace UnitGroups {
-    export { type CreateUnitGroupRequest as CreateUnitGroupRequest, type CreateUnitGroupUnitParam as CreateUnitGroupUnitParam, type ListUnitGroup as ListUnitGroup, type ListUnitGroupUnit as ListUnitGroupUnit, type UnitGroup as UnitGroup, type UnitGroupUnit as UnitGroupUnit, type UpdateUnitGroupRequest as UpdateUnitGroupRequest, type UnitGroupDeleteResponse as UnitGroupDeleteResponse, type UnitGroupCreateParams as UnitGroupCreateParams, type UnitGroupRetrieveParams as UnitGroupRetrieveParams, type UnitGroupUpdateParams as UnitGroupUpdateParams, type UnitGroupListParams as UnitGroupListParams, };
-    export { Units as Units, type CreateUnitGroupUnitRequest as CreateUnitGroupUnitRequest, type UpdateUnitGroupUnitRequest as UpdateUnitGroupUnitRequest, type UnitDeleteResponse as UnitDeleteResponse, type UnitCreateParams as UnitCreateParams, type UnitRetrieveParams as UnitRetrieveParams, type UnitUpdateParams as UnitUpdateParams, type UnitListParams as UnitListParams, type UnitDeleteParams as UnitDeleteParams, };
+    export { type CreateUnitGroupRequest as CreateUnitGroupRequest, type CreateUnitGroupUnitParam as CreateUnitGroupUnitParam, type ListUnitGroup as ListUnitGroup, type ListUnitGroupUnit as ListUnitGroupUnit, type UnitGroup as UnitGroup, type UnitGroupUnit as UnitGroupUnit, type UpdateUnitGroupRequest as UpdateUnitGroupRequest, type UnitGroupDeleteResponse as UnitGroupDeleteResponse, type UnitGroupListParams as UnitGroupListParams, type UnitGroupRetrieveParams as UnitGroupRetrieveParams, type UnitGroupCreateParams as UnitGroupCreateParams, type UnitGroupUpdateParams as UnitGroupUpdateParams, };
+    export { Units as Units, type CreateUnitGroupUnitRequest as CreateUnitGroupUnitRequest, type UpdateUnitGroupUnitRequest as UpdateUnitGroupUnitRequest, type UnitDeleteResponse as UnitDeleteResponse, type UnitListParams as UnitListParams, type UnitRetrieveParams as UnitRetrieveParams, type UnitCreateParams as UnitCreateParams, type UnitUpdateParams as UnitUpdateParams, type UnitDeleteParams as UnitDeleteParams, };
 }
 //# sourceMappingURL=unit-groups.d.ts.map

package/resources/catalog/unit-groups/unit-groups.d.ts.map

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

package/resources/catalog/unit-groups/unit-groups.js

@@ -16,27 +16,24 @@ class UnitGroups extends resource_1.APIResource {
         this.units = new UnitGroupsUnitsAPI.Units(this._client);
     }
     /**
-     * Creates a unit group with optional associated units.
+     * Returns a paginated list of unit groups, including system unit groups.
+     *
+     * This endpoint requires the permission: `unit_groups:read`.
      *
      * @example
      * ```ts
-     * const unitGroup = await client.catalog.unitGroups.create({
-     *   base_unit_id: 'un_01966263f74a5a0cae356000a1',
-     *   name: 'Weight Units',
-     *   type: 'mass',
-     *   associated_units: [
-     *     { unit_id: 'un_01966263f74a5a0cae356000a1' },
-     *   ],
-     * });
+     * const listUnitGroup =
+     *   await client.catalog.unitGroups.list();
      * ```
      */
-    create(params, options) {
-        const { include, ...body } = params;
-        return this._client.post('/v1/catalog/unit-groups', { query: { include }, body, ...options });
+    list(query = {}, options) {
+        return this._client.get('/v1/catalog/unit-groups', { query, ...options });
     }
     /**
      * Returns a unit group by ID.
      *
+     * This endpoint requires the permission: `unit_groups:read`.
+     *
      * @example
      * ```ts
      * const unitGroup = await client.catalog.unitGroups.retrieve(
@@ -47,13 +44,45 @@ class UnitGroups extends resource_1.APIResource {
     retrieve(id, query = {}, options) {
         return this._client.get((0, path_1.path) `/v1/catalog/unit-groups/${id}`, { query, ...options });
     }
+    /**
+     * Creates a unit group with optional associated units.
+     *
+     * This endpoint requires the permission: `unit_groups:create`.
+     *
+     * @example
+     * ```ts
+     * const unitGroup = await client.catalog.unitGroups.create({
+     *   base_unit_id: 'un_01966263f74a5a0cae356000a1',
+     *   name: 'Weight Units',
+     *   type: 'mass',
+     *   associated_units: [
+     *     {
+     *       unit_id: 'un_01966263f74a5a0cae356000a1',
+     *       discount_percentage: 1,
+     *       discount_fixed: 0,
+     *       customer_portal_visibility: 'visible',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    create(params, options) {
+        const { include, ...body } = params;
+        return this._client.post('/v1/catalog/unit-groups', { query: { include }, body, ...options });
+    }
     /**
      * Partially updates a unit group. System unit groups cannot be updated.
      *
+     * This endpoint requires the permission: `unit_groups:update`.
+     *
      * @example
      * ```ts
      * const unitGroup = await client.catalog.unitGroups.update(
      *   'ug_01aad07abb8e41fd392d2d7013',
+     *   {
+     *     base_unit_id: 'un_01966263f74a5a0cae356000a1',
+     *     name: 'Weight Units (Updated)',
+     *   },
      * );
      * ```
      */
@@ -62,20 +91,10 @@ class UnitGroups extends resource_1.APIResource {
         return this._client.patch((0, path_1.path) `/v1/catalog/unit-groups/${id}`, { query: { include }, body, ...options });
     }
     /**
-     * Returns a paginated list of unit groups, including system unit groups.
+     * Deletes a unit group and all of its associated units. System unit groups cannot
+     * be deleted.
      *
-     * @example
-     * ```ts
-     * const listUnitGroup =
-     *   await client.catalog.unitGroups.list();
-     * ```
-     */
-    list(query = {}, options) {
-        return this._client.get('/v1/catalog/unit-groups', { query, ...options });
-    }
-    /**
-     * Deletes a unit group and all associated unit conversions. System unit groups
-     * cannot be deleted.
+     * This endpoint requires the permission: `unit_groups:delete`.
      *
      * @example
      * ```ts

package/resources/catalog/unit-groups/unit-groups.js.map

@@ -1 +1 @@
-{"version":3,"file":"unit-groups.js","sourceRoot":"","sources":["../../../src/resources/catalog/unit-groups/unit-groups.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AAGrD,uEAA8C;AAC9C,sCAUiB;AAGjB,0DAAoD;AAEpD;;GAEG;AACH,MAAa,UAAW,SAAQ,sBAAW;IAA3C;;QACE,UAAK,GAA6B,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAyF/E,CAAC;IAvFC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,MAA6B,EAAE,OAAwB;QAC5D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CACN,EAAU,EACV,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,2BAA2B,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,SAAmD,EAAE,EACrD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,2BAA2B,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CACF,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,2BAA2B,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;CACF;AA1FD,gCA0FC;AAmUD,UAAU,CAAC,KAAK,GAAG,aAAK,CAAC"}
+{"version":3,"file":"unit-groups.js","sourceRoot":"","sources":["../../../src/resources/catalog/unit-groups/unit-groups.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AAGrD,uEAA8C;AAC9C,sCAUiB;AAGjB,0DAAoD;AAEpD;;GAEG;AACH,MAAa,UAAW,SAAQ,sBAAW;IAA3C;;QACE,UAAK,GAA6B,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA4G/E,CAAC;IA1GC;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAU,EACV,QAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,2BAA2B,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,MAA6B,EAAE,OAAwB;QAC5D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,EAAU,EACV,SAAmD,EAAE,EACrD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,2BAA2B,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,2BAA2B,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;CACF;AA7GD,gCA6GC;AA0WD,UAAU,CAAC,KAAK,GAAG,aAAK,CAAC"}

package/resources/catalog/unit-groups/unit-groups.mjs

@@ -12,27 +12,24 @@ export class UnitGroups extends APIResource {
         this.units = new UnitGroupsUnitsAPI.Units(this._client);
     }
     /**
-     * Creates a unit group with optional associated units.
+     * Returns a paginated list of unit groups, including system unit groups.
+     *
+     * This endpoint requires the permission: `unit_groups:read`.
      *
      * @example
      * ```ts
-     * const unitGroup = await client.catalog.unitGroups.create({
-     *   base_unit_id: 'un_01966263f74a5a0cae356000a1',
-     *   name: 'Weight Units',
-     *   type: 'mass',
-     *   associated_units: [
-     *     { unit_id: 'un_01966263f74a5a0cae356000a1' },
-     *   ],
-     * });
+     * const listUnitGroup =
+     *   await client.catalog.unitGroups.list();
      * ```
      */
-    create(params, options) {
-        const { include, ...body } = params;
-        return this._client.post('/v1/catalog/unit-groups', { query: { include }, body, ...options });
+    list(query = {}, options) {
+        return this._client.get('/v1/catalog/unit-groups', { query, ...options });
     }
     /**
      * Returns a unit group by ID.
      *
+     * This endpoint requires the permission: `unit_groups:read`.
+     *
      * @example
      * ```ts
      * const unitGroup = await client.catalog.unitGroups.retrieve(
@@ -43,13 +40,45 @@ export class UnitGroups extends APIResource {
     retrieve(id, query = {}, options) {
         return this._client.get(path `/v1/catalog/unit-groups/${id}`, { query, ...options });
     }
+    /**
+     * Creates a unit group with optional associated units.
+     *
+     * This endpoint requires the permission: `unit_groups:create`.
+     *
+     * @example
+     * ```ts
+     * const unitGroup = await client.catalog.unitGroups.create({
+     *   base_unit_id: 'un_01966263f74a5a0cae356000a1',
+     *   name: 'Weight Units',
+     *   type: 'mass',
+     *   associated_units: [
+     *     {
+     *       unit_id: 'un_01966263f74a5a0cae356000a1',
+     *       discount_percentage: 1,
+     *       discount_fixed: 0,
+     *       customer_portal_visibility: 'visible',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    create(params, options) {
+        const { include, ...body } = params;
+        return this._client.post('/v1/catalog/unit-groups', { query: { include }, body, ...options });
+    }
     /**
      * Partially updates a unit group. System unit groups cannot be updated.
      *
+     * This endpoint requires the permission: `unit_groups:update`.
+     *
      * @example
      * ```ts
      * const unitGroup = await client.catalog.unitGroups.update(
      *   'ug_01aad07abb8e41fd392d2d7013',
+     *   {
+     *     base_unit_id: 'un_01966263f74a5a0cae356000a1',
+     *     name: 'Weight Units (Updated)',
+     *   },
      * );
      * ```
      */
@@ -58,20 +87,10 @@ export class UnitGroups extends APIResource {
         return this._client.patch(path `/v1/catalog/unit-groups/${id}`, { query: { include }, body, ...options });
     }
     /**
-     * Returns a paginated list of unit groups, including system unit groups.
+     * Deletes a unit group and all of its associated units. System unit groups cannot
+     * be deleted.
      *
-     * @example
-     * ```ts
-     * const listUnitGroup =
-     *   await client.catalog.unitGroups.list();
-     * ```
-     */
-    list(query = {}, options) {
-        return this._client.get('/v1/catalog/unit-groups', { query, ...options });
-    }
-    /**
-     * Deletes a unit group and all associated unit conversions. System unit groups
-     * cannot be deleted.
+     * This endpoint requires the permission: `unit_groups:delete`.
      *
      * @example
      * ```ts