@augno/sdk 0.1.9 → 0.7.1

package/src/resources/catalog/index.ts

@@ -8,10 +8,10 @@ export {
   type UpdateItemCategoryRequest,
   type ItemCategoryDeleteResponse,
   type ItemCategoryChangeUnitGroupResponse,
-  type ItemCategoryCreateParams,
+  type ItemCategoryListParams,
   type ItemCategoryRetrieveParams,
+  type ItemCategoryCreateParams,
   type ItemCategoryUpdateParams,
-  type ItemCategoryListParams,
   type ItemCategoryChangeUnitGroupParams,
 } from './item-categories/index';
 export {
@@ -22,10 +22,10 @@ export {
   type ListItem,
   type Quantity,
   type Rate,
-  type ItemRetrieveParams,
   type ItemListParams,
-  type ItemChangeCategoryParams,
+  type ItemRetrieveParams,
   type ItemRetrieveInventoryParams,
+  type ItemChangeCategoryParams,
 } from './items/index';
 export {
   Materials,
@@ -35,10 +35,10 @@ export {
   type QuantityInputRequest,
   type RateInput,
   type UpdateMaterialRequest,
-  type MaterialCreateParams,
+  type MaterialListParams,
   type MaterialRetrieveParams,
+  type MaterialCreateParams,
   type MaterialUpdateParams,
-  type MaterialListParams,
 } from './materials';
 export {
   Parts,
@@ -46,10 +46,10 @@ export {
   type ListPart,
   type Part,
   type UpdatePartRequest,
-  type PartCreateParams,
+  type PartListParams,
   type PartRetrieveParams,
+  type PartCreateParams,
   type PartUpdateParams,
-  type PartListParams,
 } from './parts';
 export {
   ProductLines,
@@ -58,10 +58,10 @@ export {
   type ProductLine,
   type UpdateProductLineRequest,
   type ProductLineDeleteResponse,
-  type ProductLineCreateParams,
+  type ProductLineListParams,
   type ProductLineRetrieveParams,
+  type ProductLineCreateParams,
   type ProductLineUpdateParams,
-  type ProductLineListParams,
 } from './product-lines';
 export {
   Products,
@@ -69,10 +69,10 @@ export {
   type ListProduct,
   type Product,
   type UpdateProductRequest,
-  type ProductCreateParams,
+  type ProductListParams,
   type ProductRetrieveParams,
+  type ProductCreateParams,
   type ProductUpdateParams,
-  type ProductListParams,
   type ProductDeleteParams,
   type ProductChangeProductLineParams,
 } from './products';
@@ -85,10 +85,10 @@ export {
   type Property,
   type UpdatePropertyRequest,
   type PropertyDeleteResponse,
-  type PropertyCreateParams,
+  type PropertyListParams,
   type PropertyRetrieveParams,
+  type PropertyCreateParams,
   type PropertyUpdateParams,
-  type PropertyListParams,
 } from './properties/index';
 export {
   UnitGroups,
@@ -100,10 +100,10 @@ export {
   type UnitGroupUnit,
   type UpdateUnitGroupRequest,
   type UnitGroupDeleteResponse,
-  type UnitGroupCreateParams,
+  type UnitGroupListParams,
   type UnitGroupRetrieveParams,
+  type UnitGroupCreateParams,
   type UnitGroupUpdateParams,
-  type UnitGroupListParams,
 } from './unit-groups/index';
 export {
   Units,
@@ -112,8 +112,8 @@ export {
   type Unit,
   type UpdateUnitRequest,
   type UnitDeleteResponse,
-  type UnitCreateParams,
+  type UnitListParams,
   type UnitRetrieveParams,
+  type UnitCreateParams,
   type UnitUpdateParams,
-  type UnitListParams,
 } from './units';

package/src/resources/catalog/item-categories/index.ts

@@ -7,10 +7,10 @@ export {
   type UpdateItemCategoryRequest,
   type ItemCategoryDeleteResponse,
   type ItemCategoryChangeUnitGroupResponse,
-  type ItemCategoryCreateParams,
+  type ItemCategoryListParams,
   type ItemCategoryRetrieveParams,
+  type ItemCategoryCreateParams,
   type ItemCategoryUpdateParams,
-  type ItemCategoryListParams,
   type ItemCategoryChangeUnitGroupParams,
 } from './item-categories';
 export {

package/src/resources/catalog/item-categories/item-categories.ts

@@ -22,26 +22,30 @@ export class ItemCategories extends APIResource {
   properties: PropertiesAPI.Properties = new PropertiesAPI.Properties(this._client);
 
   /**
-   * Creates an account-owned item category.
+   * Returns a paginated list of item categories for the current account, including
+   * account-specific and global system categories.
+   *
+   * This endpoint requires the permission: `item_categories:read`.
    *
    * @example
    * ```ts
-   * const itemCategory =
-   *   await client.catalog.itemCategories.create({
-   *     name: 'Electronics',
-   *     type: 'material_category',
-   *     unit_group_id: 'ug_01aad07abb8e41fd392d2d7013',
-   *   });
+   * const listItemCategory =
+   *   await client.catalog.itemCategories.list();
    * ```
    */
-  create(params: ItemCategoryCreateParams, options?: RequestOptions): APIPromise<ItemsAPI.ItemCategory> {
-    const { include, ...body } = params;
-    return this._client.post('/v1/catalog/item-categories', { query: { include }, body, ...options });
+  list(
+    query: ItemCategoryListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ListItemCategory> {
+    return this._client.get('/v1/catalog/item-categories', { query, ...options });
   }
 
   /**
-   * Returns an item category by ID. Includes account-specific and global system
-   * categories.
+   * Returns an item category by ID.
+   *
+   * Both account-owned categories and global system categories can be retrieved.
+   *
+   * This endpoint requires the permission: `item_categories:read`.
    *
    * @example
    * ```ts
@@ -60,14 +64,39 @@ export class ItemCategories extends APIResource {
   }
 
   /**
-   * Partially updates an account-owned item category. Default system categories
-   * cannot be updated.
+   * Creates an account-owned item category.
+   *
+   * This endpoint requires the permission: `item_categories:create`.
+   *
+   * @example
+   * ```ts
+   * const itemCategory =
+   *   await client.catalog.itemCategories.create({
+   *     name: 'Electronics',
+   *     type: 'material_category',
+   *     unit_group_id: 'ug_01aad07abb8e41fd392d2d7013',
+   *   });
+   * ```
+   */
+  create(params: ItemCategoryCreateParams, options?: RequestOptions): APIPromise<ItemsAPI.ItemCategory> {
+    const { include, ...body } = params;
+    return this._client.post('/v1/catalog/item-categories', { query: { include }, body, ...options });
+  }
+
+  /**
+   * Partially updates an account-owned item category.
+   *
+   * Only the fields provided in the request body are changed. Default system
+   * categories cannot be updated.
+   *
+   * This endpoint requires the permission: `item_categories:update`.
    *
    * @example
    * ```ts
    * const itemCategory =
    *   await client.catalog.itemCategories.update(
    *     'ic_01ae7bd7bfd21ca0ab81e1357e',
+   *     { name: 'Electronic Components' },
    *   );
    * ```
    */
@@ -85,25 +114,11 @@ export class ItemCategories extends APIResource {
   }
 
   /**
-   * Returns a paginated list of item categories for the current account, including
-   * account-specific and global system categories.
+   * Deletes an account-owned item category.
    *
-   * @example
-   * ```ts
-   * const listItemCategory =
-   *   await client.catalog.itemCategories.list();
-   * ```
-   */
-  list(
-    query: ItemCategoryListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ListItemCategory> {
-    return this._client.get('/v1/catalog/item-categories', { query, ...options });
-  }
-
-  /**
-   * Deletes an account-owned item category. Default system categories cannot be
-   * deleted.
+   * Default system categories cannot be deleted.
+   *
+   * This endpoint requires the permission: `item_categories:delete`.
    *
    * @example
    * ```ts
@@ -118,8 +133,13 @@ export class ItemCategories extends APIResource {
   }
 
   /**
-   * Changes the unit group associated with an item category. All items in the
-   * category are updated to use the new base unit asynchronously.
+   * Changes the unit group associated with an item category.
+   *
+   * The new unit group must have the same unit type as the current one — for
+   * example, a category measured in `mass` units can only switch to another `mass`
+   * unit group. Default system categories cannot be modified.
+   *
+   * This endpoint requires the permission: `item_categories:update`.
    *
    * @example
    * ```ts
@@ -145,18 +165,26 @@ export class ItemCategories extends APIResource {
  */
 export interface CreateItemCategoryRequest {
   /**
-   * Display name.
+   * Display name of the item category.
    */
   name: string;
 
   /**
-   * Item category type. Material categories are used to group materials, while
-   * product categories are used to group products and parts.
+   * What kind of items this category groups.
+   *
+   * - `material_category`: groups raw materials and components (items of type
+   *   `material`).
+   * - `product_category`: groups finished products and parts (items of type
+   *   `product` or `part`).
    */
   type: 'material_category' | 'product_category';
 
   /**
-   * Unit group ID.
+   * ID of the unit group that determines the units of measure available to items in
+   * this category.
+   *
+   * After creation, the unit group can only be replaced by another unit group of the
+   * same unit type via the Change Item Category Unit Group endpoint.
    */
   unit_group_id: string;
 }
@@ -186,12 +214,12 @@ export interface ListItemCategory {
  */
 export interface UpdateItemCategoryRequest {
   /**
-   * Display name.
+   * Display name of the item category.
    */
   name?: string;
 
   /**
-   * Notes.
+   * Free-form notes about the item category.
    */
   notes?: string;
 }
@@ -200,26 +228,19 @@ export interface ItemCategoryDeleteResponse {}
 
 export interface ItemCategoryChangeUnitGroupResponse {}
 
-export interface ItemCategoryCreateParams {
-  /**
-   * Body param: Display name.
-   */
-  name: string;
-
-  /**
-   * Body param: Item category type. Material categories are used to group materials,
-   * while product categories are used to group products and parts.
-   */
-  type: 'material_category' | 'product_category';
-
+export interface ItemCategoryListParams {
   /**
-   * Body param: Unit group ID.
+   * 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.
    */
-  unit_group_id: string;
+  cursor?: string;
 
   /**
-   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
-   * are returned as `null`.
+   * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+   * `null`.
    */
   include?: Array<
     | 'owner'
@@ -230,6 +251,23 @@ export interface ItemCategoryCreateParams {
     | 'unit_group.associated_units'
     | 'unit_group.associated_units.unit'
   >;
+
+  /**
+   * 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 item category type.
+   */
+  type?: 'material_category' | 'product_category';
 }
 
 export interface ItemCategoryRetrieveParams {
@@ -248,7 +286,31 @@ export interface ItemCategoryRetrieveParams {
   >;
 }
 
-export interface ItemCategoryUpdateParams {
+export interface ItemCategoryCreateParams {
+  /**
+   * Body param: Display name of the item category.
+   */
+  name: string;
+
+  /**
+   * Body param: What kind of items this category groups.
+   *
+   * - `material_category`: groups raw materials and components (items of type
+   *   `material`).
+   * - `product_category`: groups finished products and parts (items of type
+   *   `product` or `part`).
+   */
+  type: 'material_category' | 'product_category';
+
+  /**
+   * Body param: ID of the unit group that determines the units of measure available
+   * to items in this category.
+   *
+   * After creation, the unit group can only be replaced by another unit group of the
+   * same unit type via the Change Item Category Unit Group endpoint.
+   */
+  unit_group_id: string;
+
   /**
    * Query param: Sub-objects to expand in the response. When omitted, sub-objects
    * are returned as `null`.
@@ -262,27 +324,12 @@ export interface ItemCategoryUpdateParams {
     | 'unit_group.associated_units'
     | 'unit_group.associated_units.unit'
   >;
-
-  /**
-   * Body param: Display name.
-   */
-  name?: string;
-
-  /**
-   * Body param: Notes.
-   */
-  notes?: string;
 }
 
-export interface ItemCategoryListParams {
-  /**
-   * Cursor token used to retrieve the next or previous page of results.
-   */
-  cursor?: string;
-
+export interface ItemCategoryUpdateParams {
   /**
-   * Sub-objects to expand in the response. When omitted, sub-objects are returned as
-   * `null`.
+   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+   * are returned as `null`.
    */
   include?: Array<
     | 'owner'
@@ -295,19 +342,14 @@ export interface ItemCategoryListParams {
   >;
 
   /**
-   * Maximum number of results per page (default: 100, max: 1000).
+   * Body param: Display name of the item category.
    */
-  limit?: number;
-
-  /**
-   * Search query used to filter results.
-   */
-  q?: string;
+  name?: string;
 
   /**
-   * Filter by item category type.
+   * Body param: Free-form notes about the item category.
    */
-  type?: 'material_category' | 'product_category';
+  notes?: string;
 }
 
 export interface ItemCategoryChangeUnitGroupParams {
@@ -326,10 +368,10 @@ export declare namespace ItemCategories {
     type UpdateItemCategoryRequest as UpdateItemCategoryRequest,
     type ItemCategoryDeleteResponse as ItemCategoryDeleteResponse,
     type ItemCategoryChangeUnitGroupResponse as ItemCategoryChangeUnitGroupResponse,
-    type ItemCategoryCreateParams as ItemCategoryCreateParams,
+    type ItemCategoryListParams as ItemCategoryListParams,
     type ItemCategoryRetrieveParams as ItemCategoryRetrieveParams,
+    type ItemCategoryCreateParams as ItemCategoryCreateParams,
     type ItemCategoryUpdateParams as ItemCategoryUpdateParams,
-    type ItemCategoryListParams as ItemCategoryListParams,
     type ItemCategoryChangeUnitGroupParams as ItemCategoryChangeUnitGroupParams,
   };
 

package/src/resources/catalog/item-categories/properties.ts

@@ -10,8 +10,14 @@ import { path } from '../../../internal/utils/path';
  */
 export class Properties extends APIResource {
   /**
-   * Adds a property to an item category. Default system categories cannot be
-   * modified.
+   * Adds a property to an item category, making the property available to items in
+   * that category.
+   *
+   * Each property name can appear only once per category; adding a property whose
+   * name duplicates one already in the category returns a conflict error. Default
+   * system categories cannot be modified.
+   *
+   * This endpoint requires the permission: `item_categories:update`.
    *
    * @example
    * ```ts
@@ -32,8 +38,11 @@ export class Properties extends APIResource {
   }
 
   /**
-   * Removes a property from an item category. Default system categories cannot be
-   * modified.
+   * Removes a property from an item category.
+   *
+   * Default system categories cannot be modified.
+   *
+   * This endpoint requires the permission: `item_categories:update`.
    *
    * @example
    * ```ts

package/src/resources/catalog/items/attributes.ts

@@ -11,8 +11,11 @@ import { path } from '../../../internal/utils/path';
  */
 export class Attributes extends APIResource {
   /**
-   * Adds an attribute to an item. If the attribute is already associated with the
-   * item, this is a no-op.
+   * Adds an attribute to an item and returns the updated item.
+   *
+   * If the attribute is already associated with the item, this is a no-op.
+   *
+   * This endpoint requires the permission: `items:update`.
    *
    * @example
    * ```ts
@@ -37,6 +40,8 @@ export class Attributes extends APIResource {
   /**
    * Removes an attribute from an item.
    *
+   * This endpoint requires the permission: `items:update`.
+   *
    * @example
    * ```ts
    * const item = await client.catalog.items.attributes.delete(

package/src/resources/catalog/items/index.ts

@@ -9,8 +9,8 @@ export {
   type ListItem,
   type Quantity,
   type Rate,
-  type ItemRetrieveParams,
   type ItemListParams,
-  type ItemChangeCategoryParams,
+  type ItemRetrieveParams,
   type ItemRetrieveInventoryParams,
+  type ItemChangeCategoryParams,
 } from './items';