@augno/sdk 0.1.9 → 0.7.0

package/resources/operations/carriers/carriers.d.mts

@@ -11,18 +11,14 @@ import { RequestOptions } from "../../../internal/request-options.mjs";
 export declare class Carriers extends APIResource {
     serviceLevels: ServiceLevelsAPI.ServiceLevels;
     /**
-     * Creates a carrier. If a Shippo-supported carrier code is provided, the carrier
-     * will be registered with Shippo and service levels will be auto-synced as
-     * options.
+     * Returns a paginated list of carriers for the current account.
      *
      * @example
      * ```ts
-     * const carrier = await client.operations.carriers.create({
-     *   name: 'FedEx',
-     * });
+     * const listCarrier = await client.operations.carriers.list();
      * ```
      */
-    create(params: CarrierCreateParams, options?: RequestOptions): APIPromise<CustomersAPI.Carrier>;
+    list(query?: CarrierListParams | null | undefined, options?: RequestOptions): APIPromise<ListCarrier>;
     /**
      * Returns a carrier by ID.
      *
@@ -35,28 +31,40 @@ export declare class Carriers extends APIResource {
      */
     retrieve(id: string, query?: CarrierRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.Carrier>;
     /**
-     * Partially updates a carrier's name and portal visibility.
+     * Creates a carrier.
+     *
+     * If a Shippo-supported code (`fedex`, `ups`, `usps`) is provided, the carrier is
+     * connected through Shippo and its service levels are auto-synced, initially
+     * hidden from the customer portal. Sandbox accounts skip the Shippo connection.
      *
      * @example
      * ```ts
-     * const carrier = await client.operations.carriers.update(
-     *   'cr_01784fd54c9ba197bb4e42f0e6',
-     * );
+     * const carrier = await client.operations.carriers.create({
+     *   name: 'FedEx',
+     *   account_number: '1234567890',
+     *   code: 'fedex',
+     *   customer_portal_visibility: 'visible',
+     * });
      * ```
      */
-    update(id: string, params?: CarrierUpdateParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.Carrier>;
+    create(params: CarrierCreateParams, options?: RequestOptions): APIPromise<CustomersAPI.Carrier>;
     /**
-     * Returns a paginated list of carriers for the current account.
+     * Partially updates a carrier's name and portal visibility.
      *
      * @example
      * ```ts
-     * const listCarrier = await client.operations.carriers.list();
+     * const carrier = await client.operations.carriers.update(
+     *   'cr_01784fd54c9ba197bb4e42f0e6',
+     *   { name: 'FedEx Express' },
+     * );
      * ```
      */
-    list(query?: CarrierListParams | null | undefined, options?: RequestOptions): APIPromise<ListCarrier>;
+    update(id: string, params?: CarrierUpdateParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.Carrier>;
     /**
-     * Deletes a carrier and cascades to remove all options. If the carrier is managed
-     * by Shippo, the Shippo account is deactivated.
+     * Deletes a carrier and all of its service levels.
+     *
+     * If the carrier is connected through Shippo, its Shippo carrier account is
+     * deactivated. System-owned carriers cannot be deleted.
      *
      * @example
      * ```ts
@@ -72,23 +80,30 @@ export declare class Carriers extends APIResource {
  */
 export interface CreateCarrierRequest {
     /**
-     * Display name.
+     * Human-readable name for the carrier.
+     *
+     * Must be unique among your account's carriers.
      */
     name: string;
     /**
-     * Carrier account number. Required for UPS and USPS carriers.
+     * Your account number with this carrier.
+     *
+     * Required when `code` is `ups` or `usps`, which connect to Shippo using this
+     * number; FedEx connects via OAuth instead.
      */
     account_number?: string;
     /**
-     * Carrier code.
+     * Well-known carrier code.
+     *
+     * Omit for a custom carrier. Providing a Shippo-supported code (`fedex`, `ups`,
+     * `usps`) connects the carrier through Shippo and auto-syncs its service levels.
      */
     code?: 'fedex' | 'ups' | 'usps' | 'will_call' | 'delivery' | 'ltl' | 'ltl1' | 'freight_collect';
     /**
      * Carrier visibility in the customer portal.
      *
-     * If `visible`, this carrier will be available for your customers to utilize when
-     * they go to checkout. If `hidden`, this carrier will not be an option on
-     * checkout.
+     * A `visible` carrier can be selected by your customers at checkout; a `hidden`
+     * carrier is not offered there. New carriers are visible unless set to `hidden`.
      */
     customer_portal_visibility?: 'visible' | 'hidden';
 }
@@ -122,15 +137,49 @@ export interface UpdateCarrierRequest {
      */
     customer_portal_visibility?: 'visible' | 'hidden';
     /**
-     * Display name.
+     * Human-readable name for the carrier, unique among your account's carriers.
      */
     name?: string;
 }
 export interface CarrierDeleteResponse {
 }
+export interface CarrierListParams {
+    /**
+     * 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' | 'service_levels'>;
+    /**
+     * 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;
+}
+export interface CarrierRetrieveParams {
+    /**
+     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+     * `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'service_levels'>;
+}
 export interface CarrierCreateParams {
     /**
-     * Body param: Display name.
+     * Body param: Human-readable name for the carrier.
+     *
+     * Must be unique among your account's carriers.
      */
     name: string;
     /**
@@ -139,29 +188,27 @@ export interface CarrierCreateParams {
      */
     include?: Array<'owner' | 'owner.account' | 'service_levels'>;
     /**
-     * Body param: Carrier account number. Required for UPS and USPS carriers.
+     * Body param: Your account number with this carrier.
+     *
+     * Required when `code` is `ups` or `usps`, which connect to Shippo using this
+     * number; FedEx connects via OAuth instead.
      */
     account_number?: string;
     /**
-     * Body param: Carrier code.
+     * Body param: Well-known carrier code.
+     *
+     * Omit for a custom carrier. Providing a Shippo-supported code (`fedex`, `ups`,
+     * `usps`) connects the carrier through Shippo and auto-syncs its service levels.
      */
     code?: 'fedex' | 'ups' | 'usps' | 'will_call' | 'delivery' | 'ltl' | 'ltl1' | 'freight_collect';
     /**
      * Body param: Carrier visibility in the customer portal.
      *
-     * If `visible`, this carrier will be available for your customers to utilize when
-     * they go to checkout. If `hidden`, this carrier will not be an option on
-     * checkout.
+     * A `visible` carrier can be selected by your customers at checkout; a `hidden`
+     * carrier is not offered there. New carriers are visible unless set to `hidden`.
      */
     customer_portal_visibility?: 'visible' | 'hidden';
 }
-export interface CarrierRetrieveParams {
-    /**
-     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
-     * `null`.
-     */
-    include?: Array<'owner' | 'owner.account' | 'service_levels'>;
-}
 export interface CarrierUpdateParams {
     /**
      * Query param: Sub-objects to expand in the response. When omitted, sub-objects
@@ -177,31 +224,13 @@ export interface CarrierUpdateParams {
      */
     customer_portal_visibility?: 'visible' | 'hidden';
     /**
-     * Body param: Display name.
+     * Body param: Human-readable name for the carrier, unique among your account's
+     * carriers.
      */
     name?: string;
 }
-export interface CarrierListParams {
-    /**
-     * 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' | 'service_levels'>;
-    /**
-     * Maximum number of results per page (default: 100, max: 1000).
-     */
-    limit?: number;
-    /**
-     * Search query used to filter results.
-     */
-    q?: string;
-}
 export declare namespace Carriers {
-    export { type CreateCarrierRequest as CreateCarrierRequest, type ListCarrier as ListCarrier, type UpdateCarrierRequest as UpdateCarrierRequest, type CarrierDeleteResponse as CarrierDeleteResponse, type CarrierCreateParams as CarrierCreateParams, type CarrierRetrieveParams as CarrierRetrieveParams, type CarrierUpdateParams as CarrierUpdateParams, type CarrierListParams as CarrierListParams, };
-    export { ServiceLevels as ServiceLevels, type CreateServiceLevelRequest as CreateServiceLevelRequest, type UpdateServiceLevelRequest as UpdateServiceLevelRequest, type ServiceLevelDeleteResponse as ServiceLevelDeleteResponse, type ServiceLevelCreateParams as ServiceLevelCreateParams, type ServiceLevelRetrieveParams as ServiceLevelRetrieveParams, type ServiceLevelUpdateParams as ServiceLevelUpdateParams, type ServiceLevelListParams as ServiceLevelListParams, type ServiceLevelDeleteParams as ServiceLevelDeleteParams, };
+    export { type CreateCarrierRequest as CreateCarrierRequest, type ListCarrier as ListCarrier, type UpdateCarrierRequest as UpdateCarrierRequest, type CarrierDeleteResponse as CarrierDeleteResponse, type CarrierListParams as CarrierListParams, type CarrierRetrieveParams as CarrierRetrieveParams, type CarrierCreateParams as CarrierCreateParams, type CarrierUpdateParams as CarrierUpdateParams, };
+    export { ServiceLevels as ServiceLevels, type CreateServiceLevelRequest as CreateServiceLevelRequest, type UpdateServiceLevelRequest as UpdateServiceLevelRequest, type ServiceLevelDeleteResponse as ServiceLevelDeleteResponse, type ServiceLevelListParams as ServiceLevelListParams, type ServiceLevelRetrieveParams as ServiceLevelRetrieveParams, type ServiceLevelCreateParams as ServiceLevelCreateParams, type ServiceLevelUpdateParams as ServiceLevelUpdateParams, type ServiceLevelDeleteParams as ServiceLevelDeleteParams, };
 }
 //# sourceMappingURL=carriers.d.mts.map

package/resources/operations/carriers/carriers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"carriers.d.mts","sourceRoot":"","sources":["../../../src/resources/operations/carriers/carriers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"carriers.d.mts","sourceRoot":"","sources":["../../../src/resources/operations/carriers/carriers.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,UAAU;OACf,KAAK,gBAAgB;OACrB,EACL,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,aAAa,EACb,yBAAyB,EAC1B;OACM,KAAK,YAAY;OACjB,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;IAEjG;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,GAAE,iBAAiB,GAAG,IAAI,GAAG,SAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC;IAIzG;;;;;;;;;OASG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC;IAInC;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC;IAK/F;;;;;;;;;;OAUG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EACnD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC;IAKnC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAGhF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,iBAAiB,CAAC;IAEhG;;;;;OAKG;IACH,0BAA0B,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAElC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAElD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;CAAG;AAEzC,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,eAAe,GAAG,gBAAgB,CAAC,CAAC;IAE9D;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,eAAe,GAAG,gBAAgB,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,eAAe,GAAG,gBAAgB,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,iBAAiB,CAAC;IAEhG;;;;;OAKG;IACH,0BAA0B,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CACnD;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,eAAe,GAAG,gBAAgB,CAAC,CAAC;IAE9D;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAElD;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;IAEF,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/operations/carriers/carriers.d.ts

@@ -11,18 +11,14 @@ import { RequestOptions } from "../../../internal/request-options.js";
 export declare class Carriers extends APIResource {
     serviceLevels: ServiceLevelsAPI.ServiceLevels;
     /**
-     * Creates a carrier. If a Shippo-supported carrier code is provided, the carrier
-     * will be registered with Shippo and service levels will be auto-synced as
-     * options.
+     * Returns a paginated list of carriers for the current account.
      *
      * @example
      * ```ts
-     * const carrier = await client.operations.carriers.create({
-     *   name: 'FedEx',
-     * });
+     * const listCarrier = await client.operations.carriers.list();
      * ```
      */
-    create(params: CarrierCreateParams, options?: RequestOptions): APIPromise<CustomersAPI.Carrier>;
+    list(query?: CarrierListParams | null | undefined, options?: RequestOptions): APIPromise<ListCarrier>;
     /**
      * Returns a carrier by ID.
      *
@@ -35,28 +31,40 @@ export declare class Carriers extends APIResource {
      */
     retrieve(id: string, query?: CarrierRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.Carrier>;
     /**
-     * Partially updates a carrier's name and portal visibility.
+     * Creates a carrier.
+     *
+     * If a Shippo-supported code (`fedex`, `ups`, `usps`) is provided, the carrier is
+     * connected through Shippo and its service levels are auto-synced, initially
+     * hidden from the customer portal. Sandbox accounts skip the Shippo connection.
      *
      * @example
      * ```ts
-     * const carrier = await client.operations.carriers.update(
-     *   'cr_01784fd54c9ba197bb4e42f0e6',
-     * );
+     * const carrier = await client.operations.carriers.create({
+     *   name: 'FedEx',
+     *   account_number: '1234567890',
+     *   code: 'fedex',
+     *   customer_portal_visibility: 'visible',
+     * });
      * ```
      */
-    update(id: string, params?: CarrierUpdateParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.Carrier>;
+    create(params: CarrierCreateParams, options?: RequestOptions): APIPromise<CustomersAPI.Carrier>;
     /**
-     * Returns a paginated list of carriers for the current account.
+     * Partially updates a carrier's name and portal visibility.
      *
      * @example
      * ```ts
-     * const listCarrier = await client.operations.carriers.list();
+     * const carrier = await client.operations.carriers.update(
+     *   'cr_01784fd54c9ba197bb4e42f0e6',
+     *   { name: 'FedEx Express' },
+     * );
      * ```
      */
-    list(query?: CarrierListParams | null | undefined, options?: RequestOptions): APIPromise<ListCarrier>;
+    update(id: string, params?: CarrierUpdateParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.Carrier>;
     /**
-     * Deletes a carrier and cascades to remove all options. If the carrier is managed
-     * by Shippo, the Shippo account is deactivated.
+     * Deletes a carrier and all of its service levels.
+     *
+     * If the carrier is connected through Shippo, its Shippo carrier account is
+     * deactivated. System-owned carriers cannot be deleted.
      *
      * @example
      * ```ts
@@ -72,23 +80,30 @@ export declare class Carriers extends APIResource {
  */
 export interface CreateCarrierRequest {
     /**
-     * Display name.
+     * Human-readable name for the carrier.
+     *
+     * Must be unique among your account's carriers.
      */
     name: string;
     /**
-     * Carrier account number. Required for UPS and USPS carriers.
+     * Your account number with this carrier.
+     *
+     * Required when `code` is `ups` or `usps`, which connect to Shippo using this
+     * number; FedEx connects via OAuth instead.
      */
     account_number?: string;
     /**
-     * Carrier code.
+     * Well-known carrier code.
+     *
+     * Omit for a custom carrier. Providing a Shippo-supported code (`fedex`, `ups`,
+     * `usps`) connects the carrier through Shippo and auto-syncs its service levels.
      */
     code?: 'fedex' | 'ups' | 'usps' | 'will_call' | 'delivery' | 'ltl' | 'ltl1' | 'freight_collect';
     /**
      * Carrier visibility in the customer portal.
      *
-     * If `visible`, this carrier will be available for your customers to utilize when
-     * they go to checkout. If `hidden`, this carrier will not be an option on
-     * checkout.
+     * A `visible` carrier can be selected by your customers at checkout; a `hidden`
+     * carrier is not offered there. New carriers are visible unless set to `hidden`.
      */
     customer_portal_visibility?: 'visible' | 'hidden';
 }
@@ -122,15 +137,49 @@ export interface UpdateCarrierRequest {
      */
     customer_portal_visibility?: 'visible' | 'hidden';
     /**
-     * Display name.
+     * Human-readable name for the carrier, unique among your account's carriers.
      */
     name?: string;
 }
 export interface CarrierDeleteResponse {
 }
+export interface CarrierListParams {
+    /**
+     * 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' | 'service_levels'>;
+    /**
+     * 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;
+}
+export interface CarrierRetrieveParams {
+    /**
+     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+     * `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'service_levels'>;
+}
 export interface CarrierCreateParams {
     /**
-     * Body param: Display name.
+     * Body param: Human-readable name for the carrier.
+     *
+     * Must be unique among your account's carriers.
      */
     name: string;
     /**
@@ -139,29 +188,27 @@ export interface CarrierCreateParams {
      */
     include?: Array<'owner' | 'owner.account' | 'service_levels'>;
     /**
-     * Body param: Carrier account number. Required for UPS and USPS carriers.
+     * Body param: Your account number with this carrier.
+     *
+     * Required when `code` is `ups` or `usps`, which connect to Shippo using this
+     * number; FedEx connects via OAuth instead.
      */
     account_number?: string;
     /**
-     * Body param: Carrier code.
+     * Body param: Well-known carrier code.
+     *
+     * Omit for a custom carrier. Providing a Shippo-supported code (`fedex`, `ups`,
+     * `usps`) connects the carrier through Shippo and auto-syncs its service levels.
      */
     code?: 'fedex' | 'ups' | 'usps' | 'will_call' | 'delivery' | 'ltl' | 'ltl1' | 'freight_collect';
     /**
      * Body param: Carrier visibility in the customer portal.
      *
-     * If `visible`, this carrier will be available for your customers to utilize when
-     * they go to checkout. If `hidden`, this carrier will not be an option on
-     * checkout.
+     * A `visible` carrier can be selected by your customers at checkout; a `hidden`
+     * carrier is not offered there. New carriers are visible unless set to `hidden`.
      */
     customer_portal_visibility?: 'visible' | 'hidden';
 }
-export interface CarrierRetrieveParams {
-    /**
-     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
-     * `null`.
-     */
-    include?: Array<'owner' | 'owner.account' | 'service_levels'>;
-}
 export interface CarrierUpdateParams {
     /**
      * Query param: Sub-objects to expand in the response. When omitted, sub-objects
@@ -177,31 +224,13 @@ export interface CarrierUpdateParams {
      */
     customer_portal_visibility?: 'visible' | 'hidden';
     /**
-     * Body param: Display name.
+     * Body param: Human-readable name for the carrier, unique among your account's
+     * carriers.
      */
     name?: string;
 }
-export interface CarrierListParams {
-    /**
-     * 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' | 'service_levels'>;
-    /**
-     * Maximum number of results per page (default: 100, max: 1000).
-     */
-    limit?: number;
-    /**
-     * Search query used to filter results.
-     */
-    q?: string;
-}
 export declare namespace Carriers {
-    export { type CreateCarrierRequest as CreateCarrierRequest, type ListCarrier as ListCarrier, type UpdateCarrierRequest as UpdateCarrierRequest, type CarrierDeleteResponse as CarrierDeleteResponse, type CarrierCreateParams as CarrierCreateParams, type CarrierRetrieveParams as CarrierRetrieveParams, type CarrierUpdateParams as CarrierUpdateParams, type CarrierListParams as CarrierListParams, };
-    export { ServiceLevels as ServiceLevels, type CreateServiceLevelRequest as CreateServiceLevelRequest, type UpdateServiceLevelRequest as UpdateServiceLevelRequest, type ServiceLevelDeleteResponse as ServiceLevelDeleteResponse, type ServiceLevelCreateParams as ServiceLevelCreateParams, type ServiceLevelRetrieveParams as ServiceLevelRetrieveParams, type ServiceLevelUpdateParams as ServiceLevelUpdateParams, type ServiceLevelListParams as ServiceLevelListParams, type ServiceLevelDeleteParams as ServiceLevelDeleteParams, };
+    export { type CreateCarrierRequest as CreateCarrierRequest, type ListCarrier as ListCarrier, type UpdateCarrierRequest as UpdateCarrierRequest, type CarrierDeleteResponse as CarrierDeleteResponse, type CarrierListParams as CarrierListParams, type CarrierRetrieveParams as CarrierRetrieveParams, type CarrierCreateParams as CarrierCreateParams, type CarrierUpdateParams as CarrierUpdateParams, };
+    export { ServiceLevels as ServiceLevels, type CreateServiceLevelRequest as CreateServiceLevelRequest, type UpdateServiceLevelRequest as UpdateServiceLevelRequest, type ServiceLevelDeleteResponse as ServiceLevelDeleteResponse, type ServiceLevelListParams as ServiceLevelListParams, type ServiceLevelRetrieveParams as ServiceLevelRetrieveParams, type ServiceLevelCreateParams as ServiceLevelCreateParams, type ServiceLevelUpdateParams as ServiceLevelUpdateParams, type ServiceLevelDeleteParams as ServiceLevelDeleteParams, };
 }
 //# sourceMappingURL=carriers.d.ts.map

package/resources/operations/carriers/carriers.d.ts.map

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

package/resources/operations/carriers/carriers.js

@@ -16,20 +16,15 @@ class Carriers extends resource_1.APIResource {
         this.serviceLevels = new ServiceLevelsAPI.ServiceLevels(this._client);
     }
     /**
-     * Creates a carrier. If a Shippo-supported carrier code is provided, the carrier
-     * will be registered with Shippo and service levels will be auto-synced as
-     * options.
+     * Returns a paginated list of carriers for the current account.
      *
      * @example
      * ```ts
-     * const carrier = await client.operations.carriers.create({
-     *   name: 'FedEx',
-     * });
+     * const listCarrier = await client.operations.carriers.list();
      * ```
      */
-    create(params, options) {
-        const { include, ...body } = params;
-        return this._client.post('/v1/operations/carriers', { query: { include }, body, ...options });
+    list(query = {}, options) {
+        return this._client.get('/v1/operations/carriers', { query, ...options });
     }
     /**
      * Returns a carrier by ID.
@@ -44,6 +39,27 @@ class Carriers extends resource_1.APIResource {
     retrieve(id, query = {}, options) {
         return this._client.get((0, path_1.path) `/v1/operations/carriers/${id}`, { query, ...options });
     }
+    /**
+     * Creates a carrier.
+     *
+     * If a Shippo-supported code (`fedex`, `ups`, `usps`) is provided, the carrier is
+     * connected through Shippo and its service levels are auto-synced, initially
+     * hidden from the customer portal. Sandbox accounts skip the Shippo connection.
+     *
+     * @example
+     * ```ts
+     * const carrier = await client.operations.carriers.create({
+     *   name: 'FedEx',
+     *   account_number: '1234567890',
+     *   code: 'fedex',
+     *   customer_portal_visibility: 'visible',
+     * });
+     * ```
+     */
+    create(params, options) {
+        const { include, ...body } = params;
+        return this._client.post('/v1/operations/carriers', { query: { include }, body, ...options });
+    }
     /**
      * Partially updates a carrier's name and portal visibility.
      *
@@ -51,6 +67,7 @@ class Carriers extends resource_1.APIResource {
      * ```ts
      * const carrier = await client.operations.carriers.update(
      *   'cr_01784fd54c9ba197bb4e42f0e6',
+     *   { name: 'FedEx Express' },
      * );
      * ```
      */
@@ -59,19 +76,10 @@ class Carriers extends resource_1.APIResource {
         return this._client.patch((0, path_1.path) `/v1/operations/carriers/${id}`, { query: { include }, body, ...options });
     }
     /**
-     * Returns a paginated list of carriers for the current account.
+     * Deletes a carrier and all of its service levels.
      *
-     * @example
-     * ```ts
-     * const listCarrier = await client.operations.carriers.list();
-     * ```
-     */
-    list(query = {}, options) {
-        return this._client.get('/v1/operations/carriers', { query, ...options });
-    }
-    /**
-     * Deletes a carrier and cascades to remove all options. If the carrier is managed
-     * by Shippo, the Shippo account is deactivated.
+     * If the carrier is connected through Shippo, its Shippo carrier account is
+     * deactivated. System-owned carriers cannot be deleted.
      *
      * @example
      * ```ts

package/resources/operations/carriers/carriers.js.map

@@ -1 +1 @@
-{"version":3,"file":"carriers.js","sourceRoot":"","sources":["../../../src/resources/operations/carriers/carriers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AAErD,8EAAqD;AACrD,wDAU0B;AAI1B,0DAAoD;AAEpD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAkFnG,CAAC;IAhFC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAA2B,EAAE,OAAwB;QAC1D,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,QAAkD,EAAE,EACpD,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,SAAiD,EAAE,EACnD,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;;;;;;;OAOG;IACH,IAAI,CAAC,QAA8C,EAAE,EAAE,OAAwB;QAC7E,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;AAnFD,4BAmFC;AA6JD,QAAQ,CAAC,aAAa,GAAG,8BAAa,CAAC"}
+{"version":3,"file":"carriers.js","sourceRoot":"","sources":["../../../src/resources/operations/carriers/carriers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AAErD,8EAAqD;AACrD,wDAU0B;AAI1B,0DAAoD;AAEpD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA0FnG,CAAC;IAxFC;;;;;;;OAOG;IACH,IAAI,CAAC,QAA8C,EAAE,EAAE,OAAwB;QAC7E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CACN,EAAU,EACV,QAAkD,EAAE,EACpD,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;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,MAA2B,EAAE,OAAwB;QAC1D,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;;;;;;;;;;OAUG;IACH,MAAM,CACJ,EAAU,EACV,SAAiD,EAAE,EACnD,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;AA3FD,4BA2FC;AAkLD,QAAQ,CAAC,aAAa,GAAG,8BAAa,CAAC"}