@augno/sdk 0.1.9 → 0.7.1

package/src/resources/core/sandboxes.ts

@@ -11,23 +11,24 @@ import { path } from '../../internal/utils/path';
  */
 export class Sandboxes extends APIResource {
   /**
-   * Creates a sandbox account.
+   * Returns a paginated list of sandboxes.
+   *
+   * This endpoint requires the permission: `sandboxes:read`.
    *
    * @example
    * ```ts
-   * const sandbox = await client.core.sandboxes.create({
-   *   name: 'Integration Testing',
-   * });
+   * const listSandbox = await client.core.sandboxes.list();
    * ```
    */
-  create(params: SandboxCreateParams, options?: RequestOptions): APIPromise<Sandbox> {
-    const { include, ...body } = params;
-    return this._client.post('/v1/core/sandboxes', { query: { include }, body, ...options });
+  list(query: SandboxListParams | null | undefined = {}, options?: RequestOptions): APIPromise<ListSandbox> {
+    return this._client.get('/v1/core/sandboxes', { query, ...options });
   }
 
   /**
    * Returns a sandbox by ID.
    *
+   * This endpoint requires the permission: `sandboxes:read`.
+   *
    * @example
    * ```ts
    * const sandbox = await client.core.sandboxes.retrieve(
@@ -44,20 +45,34 @@ export class Sandboxes extends APIResource {
   }
 
   /**
-   * Returns a paginated list of sandboxes.
+   * Creates a sandbox account owned by your production account.
+   *
+   * When `mode` is `seeded`, sample data is populated asynchronously and may not be
+   * available immediately after the sandbox is created. Sandboxes cannot be created
+   * while acting in a sandbox.
+   *
+   * This endpoint requires the permission: `sandboxes:create`.
    *
    * @example
    * ```ts
-   * const listSandbox = await client.core.sandboxes.list();
+   * const sandbox = await client.core.sandboxes.create({
+   *   name: 'Integration Testing',
+   *   mode: 'blank',
+   * });
    * ```
    */
-  list(query: SandboxListParams | null | undefined = {}, options?: RequestOptions): APIPromise<ListSandbox> {
-    return this._client.get('/v1/core/sandboxes', { query, ...options });
+  create(params: SandboxCreateParams, options?: RequestOptions): APIPromise<Sandbox> {
+    const { include, ...body } = params;
+    return this._client.post('/v1/core/sandboxes', { query: { include }, body, ...options });
   }
 
   /**
-   * Deletes a sandbox account. At least one sandbox must remain per production
-   * account.
+   * Deletes a sandbox account.
+   *
+   * The sandbox's data is purged asynchronously, so it may persist briefly after
+   * this call returns.
+   *
+   * This endpoint requires the permission: `sandboxes:delete`.
    *
    * @example
    * ```ts
@@ -76,12 +91,16 @@ export class Sandboxes extends APIResource {
  */
 export interface CreateSandboxRequest {
   /**
-   * Display name.
+   * Display name of the sandbox.
    */
   name: string;
 
   /**
-   * Controls whether the sandbox is blank or seeded with sample data.
+   * Controls how the sandbox is initialized.
+   *
+   * - `blank`: starts empty, with no pre-populated data.
+   * - `seeded`: starts with sample data, populated asynchronously after the sandbox
+   *   is created.
    */
   mode?: 'blank' | 'seeded';
 }
@@ -121,7 +140,7 @@ export interface Sandbox {
   created_at: string;
 
   /**
-   * Display name.
+   * Display name of the sandbox.
    */
   name: string;
 
@@ -131,7 +150,7 @@ export interface Sandbox {
   object: 'sandbox';
 
   /**
-   * Account with optional branding and portal sub-resources.
+   * A customer account, including its branding and customer portal sub-resources.
    */
   owner_account: APIKeysAPI.Account | null;
 
@@ -143,22 +162,33 @@ export interface Sandbox {
 
 export interface SandboxDeleteResponse {}
 
-export interface SandboxCreateParams {
+export interface SandboxListParams {
   /**
-   * Body param: Display name.
+   * 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.
    */
-  name: 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_account'>;
 
   /**
-   * Body param: Controls whether the sandbox is blank or seeded with sample data.
+   * Maximum number of results to return in a single page.
    */
-  mode?: 'blank' | 'seeded';
+  limit?: number;
+
+  /**
+   * Free-text search term used to filter results.
+   *
+   * Which fields are matched against the term varies by endpoint.
+   */
+  q?: string;
 }
 
 export interface SandboxRetrieveParams {
@@ -169,27 +199,26 @@ export interface SandboxRetrieveParams {
   include?: Array<'owner_account'>;
 }
 
-export interface SandboxListParams {
+export interface SandboxCreateParams {
   /**
-   * Cursor token used to retrieve the next or previous page of results.
+   * Body param: Display name of the sandbox.
    */
-  cursor?: string;
+  name: string;
 
   /**
-   * 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_account'>;
 
   /**
-   * Maximum number of results per page (default: 100, max: 1000).
-   */
-  limit?: number;
-
-  /**
-   * Search query used to filter results.
+   * Body param: Controls how the sandbox is initialized.
+   *
+   * - `blank`: starts empty, with no pre-populated data.
+   * - `seeded`: starts with sample data, populated asynchronously after the sandbox
+   *   is created.
    */
-  q?: string;
+  mode?: 'blank' | 'seeded';
 }
 
 export declare namespace Sandboxes {
@@ -198,8 +227,8 @@ export declare namespace Sandboxes {
     type ListSandbox as ListSandbox,
     type Sandbox as Sandbox,
     type SandboxDeleteResponse as SandboxDeleteResponse,
-    type SandboxCreateParams as SandboxCreateParams,
-    type SandboxRetrieveParams as SandboxRetrieveParams,
     type SandboxListParams as SandboxListParams,
+    type SandboxRetrieveParams as SandboxRetrieveParams,
+    type SandboxCreateParams as SandboxCreateParams,
   };
 }

package/src/resources/finance/finance.ts

@@ -24,19 +24,19 @@ export class Finance extends APIResource {
   paymentTerms: PaymentTermsAPI.PaymentTerms = new PaymentTermsAPI.PaymentTerms(this._client);
 
   /**
-   * Returns a paginated list of adjustment types.
+   * Returns a paginated list of transaction types.
    *
    * @example
    * ```ts
-   * const listAdjustmentType =
-   *   await client.finance.retrieveAdjustmentTypes();
+   * const listTransactionType =
+   *   await client.finance.retrieveTransactionTypes();
    * ```
    */
-  retrieveAdjustmentTypes(
-    query: FinanceRetrieveAdjustmentTypesParams | null | undefined = {},
+  retrieveTransactionTypes(
+    query: FinanceRetrieveTransactionTypesParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ListAdjustmentType> {
-    return this._client.get('/v1/finance/adjustment-types', { query, ...options });
+  ): APIPromise<ListTransactionType> {
+    return this._client.get('/v1/finance/transaction-types', { query, ...options });
   }
 
   /**
@@ -56,33 +56,44 @@ export class Finance extends APIResource {
   }
 
   /**
-   * Returns a paginated list of transaction types.
+   * Returns a paginated list of adjustment types.
    *
    * @example
    * ```ts
-   * const listTransactionType =
-   *   await client.finance.retrieveTransactionTypes();
+   * const listAdjustmentType =
+   *   await client.finance.retrieveAdjustmentTypes();
    * ```
    */
-  retrieveTransactionTypes(
-    query: FinanceRetrieveTransactionTypesParams | null | undefined = {},
+  retrieveAdjustmentTypes(
+    query: FinanceRetrieveAdjustmentTypesParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ListTransactionType> {
-    return this._client.get('/v1/finance/transaction-types', { query, ...options });
+  ): APIPromise<ListAdjustmentType> {
+    return this._client.get('/v1/finance/adjustment-types', { query, ...options });
   }
 }
 
 /**
- * Adjustment type resource.
+ * A category of financial adjustment, such as a discount, fee, or write-off.
+ *
+ * Adjustment types classify adjustment transactions recorded against customer
+ * invoices.
  */
 export interface AdjustmentType {
   /**
-   * Adjustment ID.
+   * Adjustment type ID.
    */
   id: string;
 
   /**
-   * Machine-readable code.
+   * Machine-readable code identifying what kind of adjustment this is.
+   *
+   * - `discount`: a price reduction.
+   * - `shipping_discrepancy`: corrects a difference between quoted and actual
+   *   freight.
+   * - `short_payment`: reconciles an invoice paid for less than the amount due.
+   * - `write_off`: cancels an uncollectible balance.
+   * - `fee`: an additional charge.
+   * - `refund`: returns money to the customer.
    */
   code: 'discount' | 'shipping_discrepancy' | 'short_payment' | 'write_off' | 'fee' | 'refund';
 
@@ -92,7 +103,7 @@ export interface AdjustmentType {
   created_at: string;
 
   /**
-   * Display name.
+   * Human-readable name of the adjustment type (e.g. "Discount").
    */
   name: string;
 
@@ -173,7 +184,7 @@ export interface ListTransactionType {
 }
 
 /**
- * Transaction method resource.
+ * The payment method used to make a transaction, such as cash or check.
  */
 export interface TransactionMethod {
   /**
@@ -182,7 +193,7 @@ export interface TransactionMethod {
   id: string;
 
   /**
-   * Machine-readable code.
+   * Machine-readable code identifying how the transaction was made.
    */
   code: 'cash' | 'check' | 'credit_card' | 'gift_card' | 'ach';
 
@@ -198,16 +209,21 @@ export interface TransactionMethod {
 }
 
 /**
- * Transaction type resource.
+ * The category of a financial transaction, such as a payment or credit memo.
  */
 export interface TransactionType {
   /**
-   * Transaction ID.
+   * Transaction type ID.
    */
   id: string;
 
   /**
-   * Machine-readable code.
+   * Machine-readable code identifying the kind of transaction.
+   *
+   * - `payment`: money received from the customer.
+   * - `credit_memo`: a credit issued to the customer.
+   * - `adjustment`: a manual correction (see the transaction's `adjustment_type`).
+   * - `rebate`: a rebate granted to the customer.
    */
   code: 'payment' | 'credit_memo' | 'adjustment' | 'rebate';
 
@@ -222,59 +238,77 @@ export interface TransactionType {
   object: 'transaction_type';
 }
 
-export interface FinanceRetrieveAdjustmentTypesParams {
+export interface FinanceRetrieveTransactionTypesParams {
   /**
-   * 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;
 
   /**
-   * Sub-objects to expand in the response. When omitted, sub-objects are returned as
-   * `null`.
-   */
-  include?: Array<'owner'>;
-
-  /**
-   * 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;
 }
 
 export interface FinanceRetrieveTransactionMethodsParams {
   /**
-   * 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;
 }
 
-export interface FinanceRetrieveTransactionTypesParams {
+export interface FinanceRetrieveAdjustmentTypesParams {
   /**
-   * 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).
+   * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+   * `null`.
+   */
+  include?: Array<'owner'>;
+
+  /**
+   * 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;
 }
@@ -289,9 +323,9 @@ export declare namespace Finance {
     type ListTransactionType as ListTransactionType,
     type TransactionMethod as TransactionMethod,
     type TransactionType as TransactionType,
-    type FinanceRetrieveAdjustmentTypesParams as FinanceRetrieveAdjustmentTypesParams,
-    type FinanceRetrieveTransactionMethodsParams as FinanceRetrieveTransactionMethodsParams,
     type FinanceRetrieveTransactionTypesParams as FinanceRetrieveTransactionTypesParams,
+    type FinanceRetrieveTransactionMethodsParams as FinanceRetrieveTransactionMethodsParams,
+    type FinanceRetrieveAdjustmentTypesParams as FinanceRetrieveAdjustmentTypesParams,
   };
 
   export {
@@ -300,9 +334,9 @@ export declare namespace Finance {
     type ListPaymentTerm as ListPaymentTerm,
     type UpdatePaymentTermRequest as UpdatePaymentTermRequest,
     type PaymentTermDeleteResponse as PaymentTermDeleteResponse,
-    type PaymentTermCreateParams as PaymentTermCreateParams,
+    type PaymentTermListParams as PaymentTermListParams,
     type PaymentTermRetrieveParams as PaymentTermRetrieveParams,
+    type PaymentTermCreateParams as PaymentTermCreateParams,
     type PaymentTermUpdateParams as PaymentTermUpdateParams,
-    type PaymentTermListParams as PaymentTermListParams,
   };
 }

package/src/resources/finance/index.ts

@@ -8,9 +8,9 @@ export {
   type ListTransactionType,
   type TransactionMethod,
   type TransactionType,
-  type FinanceRetrieveAdjustmentTypesParams,
-  type FinanceRetrieveTransactionMethodsParams,
   type FinanceRetrieveTransactionTypesParams,
+  type FinanceRetrieveTransactionMethodsParams,
+  type FinanceRetrieveAdjustmentTypesParams,
 } from './finance';
 export {
   PaymentTerms,
@@ -18,8 +18,8 @@ export {
   type ListPaymentTerm,
   type UpdatePaymentTermRequest,
   type PaymentTermDeleteResponse,
-  type PaymentTermCreateParams,
+  type PaymentTermListParams,
   type PaymentTermRetrieveParams,
+  type PaymentTermCreateParams,
   type PaymentTermUpdateParams,
-  type PaymentTermListParams,
 } from './payment-terms';