@augno/sdk 0.1.9 → 0.7.1

package/src/resources/operations/carriers/service-levels.ts

@@ -11,37 +11,33 @@ import { path } from '../../../internal/utils/path';
  */
 export class ServiceLevels extends APIResource {
   /**
-   * Creates a service level for a carrier.
+   * Returns a paginated list of service levels for a carrier.
+   *
+   * This endpoint requires the permissions: `carriers:read`, `customers:read`,
+   * `suppliers:read`.
    *
    * @example
    * ```ts
-   * const serviceLevel =
-   *   await client.operations.carriers.serviceLevels.create(
+   * const listServiceLevel =
+   *   await client.operations.carriers.serviceLevels.list(
    *     'cr_01784fd54c9ba197bb4e42f0e6',
-   *     {
-   *       code: 'ground',
-   *       is_default: false,
-   *       name: 'Ground Shipping',
-   *     },
    *   );
    * ```
    */
-  create(
+  list(
     carrierID: string,
-    params: ServiceLevelCreateParams,
+    query: ServiceLevelListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<CustomersAPI.ServiceLevel> {
-    const { include, ...body } = params;
-    return this._client.post(path`/v1/operations/carriers/${carrierID}/service-levels`, {
-      query: { include },
-      body,
-      ...options,
-    });
+  ): APIPromise<CustomersAPI.ListServiceLevel> {
+    return this._client.get(path`/v1/operations/carriers/${carrierID}/service-levels`, { query, ...options });
   }
 
   /**
    * Returns a service level by ID.
    *
+   * This endpoint requires the permissions: `carriers:read`, `customers:read`,
+   * `suppliers:read`.
+   *
    * @example
    * ```ts
    * const serviceLevel =
@@ -64,24 +60,30 @@ export class ServiceLevels extends APIResource {
   }
 
   /**
-   * Partially updates a service level.
+   * Creates a service level for a carrier.
+   *
+   * This endpoint requires the permission: `carriers:create`.
    *
    * @example
    * ```ts
    * const serviceLevel =
-   *   await client.operations.carriers.serviceLevels.update(
-   *     'crop_01cfaf03f104e90ef9680e2a30',
-   *     { carrier_id: 'cr_01784fd54c9ba197bb4e42f0e6' },
+   *   await client.operations.carriers.serviceLevels.create(
+   *     'cr_01784fd54c9ba197bb4e42f0e6',
+   *     {
+   *       code: 'ground',
+   *       is_default: false,
+   *       name: 'Ground Shipping',
+   *     },
    *   );
    * ```
    */
-  update(
-    id: string,
-    params: ServiceLevelUpdateParams,
+  create(
+    carrierID: string,
+    params: ServiceLevelCreateParams,
     options?: RequestOptions,
   ): APIPromise<CustomersAPI.ServiceLevel> {
-    const { carrier_id, include, ...body } = params;
-    return this._client.patch(path`/v1/operations/carriers/${carrier_id}/service-levels/${id}`, {
+    const { include, ...body } = params;
+    return this._client.post(path`/v1/operations/carriers/${carrierID}/service-levels`, {
       query: { include },
       body,
       ...options,
@@ -89,27 +91,44 @@ export class ServiceLevels extends APIResource {
   }
 
   /**
-   * Returns a paginated list of service levels for a carrier.
+   * Partially updates a service level.
+   *
+   * System-owned service levels cannot be updated.
+   *
+   * This endpoint requires the permission: `carriers:update`.
    *
    * @example
    * ```ts
-   * const listServiceLevel =
-   *   await client.operations.carriers.serviceLevels.list(
-   *     'cr_01784fd54c9ba197bb4e42f0e6',
+   * const serviceLevel =
+   *   await client.operations.carriers.serviceLevels.update(
+   *     'crop_01cfaf03f104e90ef9680e2a30',
+   *     {
+   *       carrier_id: 'cr_01784fd54c9ba197bb4e42f0e6',
+   *       name: 'Express Shipping',
+   *     },
    *   );
    * ```
    */
-  list(
-    carrierID: string,
-    query: ServiceLevelListParams | null | undefined = {},
+  update(
+    id: string,
+    params: ServiceLevelUpdateParams,
     options?: RequestOptions,
-  ): APIPromise<CustomersAPI.ListServiceLevel> {
-    return this._client.get(path`/v1/operations/carriers/${carrierID}/service-levels`, { query, ...options });
+  ): APIPromise<CustomersAPI.ServiceLevel> {
+    const { carrier_id, include, ...body } = params;
+    return this._client.patch(path`/v1/operations/carriers/${carrier_id}/service-levels/${id}`, {
+      query: { include },
+      body,
+      ...options,
+    });
   }
 
   /**
-   * Permanently deletes a service level. Fails if the service level is a default
-   * (system-synced) level.
+   * Permanently deletes a service level.
+   *
+   * System-owned service levels and the carrier's default service level cannot be
+   * deleted; unset `is_default` first to delete a default.
+   *
+   * This endpoint requires the permission: `carriers:delete`.
    *
    * @example
    * ```ts
@@ -135,23 +154,33 @@ export class ServiceLevels extends APIResource {
  */
 export interface CreateServiceLevelRequest {
   /**
-   * Service level code.
+   * Carrier-specific code identifying this service level (e.g. `fedex_ground`).
+   *
+   * Must be unique among the carrier's service levels.
    */
   code: string;
 
   /**
-   * Default service levels are the default-selected service level for that carrier.
+   * Whether this becomes the carrier's default service level, pre-selected when the
+   * carrier is chosen.
+   *
+   * Each carrier has at most one default; setting this to `true` clears the
+   * carrier's existing default.
    */
   is_default: boolean;
 
   /**
-   * Display name.
+   * Human-readable name for the service level, shown to customers at checkout when
+   * the service level is visible.
    */
   name: string;
 
   /**
-   * Whether this service level will be available for customers to select in the
-   * customer portal.
+   * Service level visibility in the customer portal.
+   *
+   * A `visible` service level can be selected by your customers at checkout; a
+   * `hidden` one is not offered there. New service levels are visible unless set to
+   * `hidden`.
    */
   customer_portal_visibility?: 'visible' | 'hidden';
 }
@@ -161,7 +190,9 @@ export interface CreateServiceLevelRequest {
  */
 export interface UpdateServiceLevelRequest {
   /**
-   * Service level code.
+   * Carrier-specific code identifying this service level (e.g. `fedex_ground`).
+   *
+   * Must be unique among the carrier's service levels.
    */
   code?: string;
 
@@ -172,59 +203,103 @@ export interface UpdateServiceLevelRequest {
   customer_portal_visibility?: 'visible' | 'hidden';
 
   /**
-   * Default service levels are the default-selected service level for that carrier.
+   * Whether this is the carrier's default service level, pre-selected when the
+   * carrier is chosen.
+   *
+   * Each carrier has at most one default; setting this to `true` clears the
+   * carrier's existing default.
    */
   is_default?: boolean;
 
   /**
-   * Display name.
+   * Human-readable name for the service level, shown to customers at checkout when
+   * the service level is visible.
    */
   name?: string;
 }
 
 export interface ServiceLevelDeleteResponse {}
 
-export interface ServiceLevelCreateParams {
+export interface ServiceLevelListParams {
   /**
-   * Body param: Service level code.
+   * 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.
    */
-  code: string;
+  cursor?: string;
 
   /**
-   * Body param: Default service levels are the default-selected service level for
-   * that carrier.
+   * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+   * `null`.
    */
-  is_default: boolean;
+  include?: Array<'owner' | 'owner.account'>;
 
   /**
-   * Body param: Display name.
+   * Maximum number of results to return in a single page.
    */
-  name: string;
+  limit?: number;
+
+  /**
+   * Free-text search term used to filter results.
+   *
+   * Which fields are matched against the term varies by endpoint.
+   */
+  q?: string;
+}
+
+export interface ServiceLevelRetrieveParams {
+  /**
+   * Path param: Carrier ID.
+   */
+  carrier_id: string;
 
   /**
    * Query param: Sub-objects to expand in the response. When omitted, sub-objects
    * are returned as `null`.
    */
   include?: Array<'owner' | 'owner.account'>;
+}
 
+export interface ServiceLevelCreateParams {
   /**
-   * Body param: Whether this service level will be available for customers to select
-   * in the customer portal.
+   * Body param: Carrier-specific code identifying this service level (e.g.
+   * `fedex_ground`).
+   *
+   * Must be unique among the carrier's service levels.
    */
-  customer_portal_visibility?: 'visible' | 'hidden';
-}
+  code: string;
 
-export interface ServiceLevelRetrieveParams {
   /**
-   * Path param: Carrier ID.
+   * Body param: Whether this becomes the carrier's default service level,
+   * pre-selected when the carrier is chosen.
+   *
+   * Each carrier has at most one default; setting this to `true` clears the
+   * carrier's existing default.
    */
-  carrier_id: string;
+  is_default: boolean;
+
+  /**
+   * Body param: Human-readable name for the service level, shown to customers at
+   * checkout when the service level is visible.
+   */
+  name: string;
 
   /**
    * Query param: Sub-objects to expand in the response. When omitted, sub-objects
    * are returned as `null`.
    */
   include?: Array<'owner' | 'owner.account'>;
+
+  /**
+   * Body param: Service level visibility in the customer portal.
+   *
+   * A `visible` service level can be selected by your customers at checkout; a
+   * `hidden` one is not offered there. New service levels are visible unless set to
+   * `hidden`.
+   */
+  customer_portal_visibility?: 'visible' | 'hidden';
 }
 
 export interface ServiceLevelUpdateParams {
@@ -240,7 +315,10 @@ export interface ServiceLevelUpdateParams {
   include?: Array<'owner' | 'owner.account'>;
 
   /**
-   * Body param: Service level code.
+   * Body param: Carrier-specific code identifying this service level (e.g.
+   * `fedex_ground`).
+   *
+   * Must be unique among the carrier's service levels.
    */
   code?: string;
 
@@ -251,40 +329,21 @@ export interface ServiceLevelUpdateParams {
   customer_portal_visibility?: 'visible' | 'hidden';
 
   /**
-   * Body param: Default service levels are the default-selected service level for
-   * that carrier.
+   * Body param: Whether this is the carrier's default service level, pre-selected
+   * when the carrier is chosen.
+   *
+   * Each carrier has at most one default; setting this to `true` clears the
+   * carrier's existing default.
    */
   is_default?: boolean;
 
   /**
-   * Body param: Display name.
+   * Body param: Human-readable name for the service level, shown to customers at
+   * checkout when the service level is visible.
    */
   name?: string;
 }
 
-export interface ServiceLevelListParams {
-  /**
-   * 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'>;
-
-  /**
-   * Maximum number of results per page (default: 100, max: 1000).
-   */
-  limit?: number;
-
-  /**
-   * Search query used to filter results.
-   */
-  q?: string;
-}
-
 export interface ServiceLevelDeleteParams {
   /**
    * Carrier ID.
@@ -297,10 +356,10 @@ export declare namespace ServiceLevels {
     type CreateServiceLevelRequest as CreateServiceLevelRequest,
     type UpdateServiceLevelRequest as UpdateServiceLevelRequest,
     type ServiceLevelDeleteResponse as ServiceLevelDeleteResponse,
-    type ServiceLevelCreateParams as ServiceLevelCreateParams,
+    type ServiceLevelListParams as ServiceLevelListParams,
     type ServiceLevelRetrieveParams as ServiceLevelRetrieveParams,
+    type ServiceLevelCreateParams as ServiceLevelCreateParams,
     type ServiceLevelUpdateParams as ServiceLevelUpdateParams,
-    type ServiceLevelListParams as ServiceLevelListParams,
     type ServiceLevelDeleteParams as ServiceLevelDeleteParams,
   };
 }

package/src/resources/operations/index.ts

@@ -6,10 +6,10 @@ export {
   type ListCarrier,
   type UpdateCarrierRequest,
   type CarrierDeleteResponse,
-  type CarrierCreateParams,
+  type CarrierListParams,
   type CarrierRetrieveParams,
+  type CarrierCreateParams,
   type CarrierUpdateParams,
-  type CarrierListParams,
 } from './carriers/index';
 export {
   LocationTypes,
@@ -22,10 +22,10 @@ export {
   type CreateLocationRequest,
   type UpdateLocationRequest,
   type LocationDeleteResponse,
-  type LocationCreateParams,
+  type LocationListParams,
   type LocationRetrieveParams,
+  type LocationCreateParams,
   type LocationUpdateParams,
-  type LocationListParams,
 } from './locations';
 export { Operations } from './operations';
 export {
@@ -33,10 +33,10 @@ export {
   type CreateScanningStationRequest,
   type UpdateScanningStationRequest,
   type ScanningStationDeleteResponse,
-  type ScanningStationCreateParams,
+  type ScanningStationListParams,
   type ScanningStationRetrieveParams,
+  type ScanningStationCreateParams,
   type ScanningStationUpdateParams,
-  type ScanningStationListParams,
 } from './scanning-stations';
 export {
   ShippingTerms,
@@ -44,8 +44,8 @@ export {
   type ListShippingTerm,
   type UpdateShippingTermRequest,
   type ShippingTermDeleteResponse,
-  type ShippingTermCreateParams,
+  type ShippingTermListParams,
   type ShippingTermRetrieveParams,
+  type ShippingTermCreateParams,
   type ShippingTermUpdateParams,
-  type ShippingTermListParams,
 } from './shipping-terms';

package/src/resources/operations/location-types.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as BlocksAPI from '../messaging/blocks';
 import * as APIKeysAPI from '../auth/api-keys/api-keys';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
@@ -10,24 +11,11 @@ import { path } from '../../internal/utils/path';
  * List and manage locations.
  */
 export class LocationTypes extends APIResource {
-  /**
-   * Returns a location type by ID or code.
-   *
-   * @example
-   * ```ts
-   * const locationType =
-   *   await client.operations.locationTypes.retrieve(
-   *     'lc_01e69cd3745a1bc0dd485986c0',
-   *   );
-   * ```
-   */
-  retrieve(id: string, options?: RequestOptions): APIPromise<LocationType> {
-    return this._client.get(path`/v1/operations/location-types/${id}`, options);
-  }
-
   /**
    * Returns a paginated list of location types.
    *
+   * This endpoint requires the permission: `locations:read`.
+   *
    * @example
    * ```ts
    * const listLocationType =
@@ -40,6 +28,23 @@ export class LocationTypes extends APIResource {
   ): APIPromise<ListLocationType> {
     return this._client.get('/v1/operations/location-types', { query, ...options });
   }
+
+  /**
+   * Returns a location type by ID or code.
+   *
+   * This endpoint requires the permission: `locations:read`.
+   *
+   * @example
+   * ```ts
+   * const locationType =
+   *   await client.operations.locationTypes.retrieve(
+   *     'lc_01e69cd3745a1bc0dd485986c0',
+   *   );
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<LocationType> {
+    return this._client.get(path`/v1/operations/location-types/${id}`, options);
+  }
 }
 
 /**
@@ -63,18 +68,26 @@ export interface ListLocationType {
 }
 
 /**
- * LocationType resource.
+ * A level in the storage location hierarchy, such as a building or a bin.
  */
 export interface LocationType {
   /**
-   * Location ID.
+   * Location type ID.
    */
   id: string;
 
   /**
-   * Location type code.
+   * Location type code, identifying the level of the storage hierarchy this type
+   * represents.
+   *
+   * - `building`: a building-level location.
+   * - `section`: a section within a building.
+   * - `aisle`: an aisle within a section.
+   * - `rack`: a rack within an aisle.
+   * - `shelf`: a shelf within a rack.
+   * - `bin`: a bin within a shelf.
    */
-  code: 'building' | 'section' | 'aisle' | 'rack' | 'shelf' | 'bin';
+  code: BlocksAPI.LocationTypeCode;
 
   /**
    * Creation timestamp.
@@ -82,7 +95,7 @@ export interface LocationType {
   created_at: string;
 
   /**
-   * Display name.
+   * Display name of the location type.
    */
   name: string;
 
@@ -99,17 +112,23 @@ export interface LocationType {
 
 export interface LocationTypeListParams {
   /**
-   * Cursor token used to retrieve the next or previous page of results.
+   * 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;
 
   /**
-   * Maximum number of results per page (default: 100, max: 1000).
+   * Maximum number of results to return in a single page.
    */
   limit?: number;
 
   /**
-   * Search query used to filter results.
+   * Free-text search term used to filter results.
+   *
+   * Which fields are matched against the term varies by endpoint.
    */
   q?: string;
 }