@augustusbank/typescript-sdk 0.22.0 → 0.22.2

package/src/resources/quotes/index.ts

@@ -1,4 +1,4 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Indicative, type IndicativeRetrieveResponse, type IndicativeRetrieveParams } from './indicative';
-export { Quotes, type QuoteRetrieveResponse } from './quotes';
+export { Quotes } from './quotes';

package/src/resources/quotes/quotes.ts

@@ -3,98 +3,14 @@
 import { APIResource } from '../../core/resource';
 import * as IndicativeAPI from './indicative';
 import { Indicative, IndicativeRetrieveParams, IndicativeRetrieveResponse } from './indicative';
-import { APIPromise } from '../../core/api-promise';
-import { RequestOptions } from '../../internal/request-options';
-import { path } from '../../internal/utils/path';
 
 export class Quotes extends APIResource {
   indicative: IndicativeAPI.Indicative = new IndicativeAPI.Indicative(this._client);
-
-  /**
-   * Retrieves a persisted quote by ID.
-   */
-  retrieve(id: string, options?: RequestOptions): APIPromise<QuoteRetrieveResponse> {
-    return this._client.get(path`/v1/quotes/${id}`, options);
-  }
-}
-
-export interface QuoteRetrieveResponse {
-  /**
-   * Unique identifier of the quote.
-   */
-  id: string;
-
-  /**
-   * ISO 8601 UTC timestamp when the quote was created.
-   */
-  created_at: string;
-
-  /**
-   * Exchange rate applied.
-   */
-  exchange_rate: string;
-
-  /**
-   * ISO 8601 UTC timestamp when the quote expires.
-   */
-  expires_at: string;
-
-  /**
-   * Current funding status of the quote.
-   */
-  funding_status: 'pending' | 'sent' | 'completed' | 'failed' | 'on_hold';
-
-  /**
-   * Amount as a string decimal (e.g. "100.50").
-   */
-  source_amount: string;
-
-  /**
-   * Currency code (ISO 4217 or crypto).
-   */
-  source_currency: 'EUR' | 'GBP' | 'USD' | 'USDC' | 'BTC' | 'ETH' | 'SOL' | 'POL';
-
-  /**
-   * Current status of the quote.
-   */
-  status:
-    | 'pending'
-    | 'quote_accepted'
-    | 'order_pending'
-    | 'order_failed'
-    | 'order_completed'
-    | 'withdrawal_pending'
-    | 'withdrawal_failed'
-    | 'withdrawal_completed'
-    | 'completed'
-    | 'failed';
-
-  /**
-   * Amount as a string decimal (e.g. "100.50").
-   */
-  target_amount: string;
-
-  /**
-   * Currency code (ISO 4217 or crypto).
-   */
-  target_currency: 'EUR' | 'GBP' | 'USD' | 'USDC' | 'BTC' | 'ETH' | 'SOL' | 'POL';
-
-  /**
-   * Resource type discriminator.
-   */
-  type: 'quote';
-
-  /**
-   * ISO 8601 UTC timestamp when the quote was last updated.
-   */
-  updated_at: string;
 }
 
 Quotes.Indicative = Indicative;
 
 export declare namespace Quotes {
-  export { type QuoteRetrieveResponse as QuoteRetrieveResponse };
-
   export {
     Indicative as Indicative,
     type IndicativeRetrieveResponse as IndicativeRetrieveResponse,

package/src/resources/simulations/account-programs.ts

@@ -15,7 +15,7 @@ export class AccountPrograms extends APIResource {
    * const accountProgram =
    *   await client.simulations.accountPrograms.create({
    *     label: 'x',
-   *     type: 'fbo-program',
+   *     type: 'fbo_program',
    *   });
    * ```
    */
@@ -62,7 +62,6 @@ export class AccountPrograms extends APIResource {
    *     {
    *       destination: {
    *         account_holder_name: 'Acme Sandbox Ltd.',
-   *         bic: 'COBADEFFXXX',
    *         iban: 'DE89370400440532013000',
    *         type: 'iban',
    *       },
@@ -117,22 +116,6 @@ export interface AccountProgramCreateResponse {
    */
   account_program_id: string;
 
-  /**
-   * Account program lifecycle event submitted to the sandbox.
-   */
-  event: 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain';
-
-  /**
-   * Payouts created by a drain event. Feed each id to
-   * `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.
-   */
-  payout_ids: Array<string> | null;
-
-  /**
-   * Whether the simulation submission was successful.
-   */
-  success: boolean;
-
   /**
    * Resource type discriminator.
    */
@@ -145,22 +128,6 @@ export interface AccountProgramCloseResponse {
    */
   account_program_id: string;
 
-  /**
-   * Account program lifecycle event submitted to the sandbox.
-   */
-  event: 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain';
-
-  /**
-   * Payouts created by a drain event. Feed each id to
-   * `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.
-   */
-  payout_ids: Array<string> | null;
-
-  /**
-   * Whether the simulation submission was successful.
-   */
-  success: boolean;
-
   /**
    * Resource type discriminator.
    */
@@ -174,20 +141,10 @@ export interface AccountProgramDrainResponse {
   account_program_id: string;
 
   /**
-   * Account program lifecycle event submitted to the sandbox.
-   */
-  event: 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain';
-
-  /**
-   * Payouts created by a drain event. Feed each id to
-   * `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.
-   */
-  payout_ids: Array<string> | null;
-
-  /**
-   * Whether the simulation submission was successful.
+   * Payouts created by the drain. Feed each id to
+   * `POST /v1/simulations/payouts/{id}/send` to settle.
    */
-  success: boolean;
+  payout_ids: Array<string>;
 
   /**
    * Resource type discriminator.
@@ -201,22 +158,6 @@ export interface AccountProgramFreezeResponse {
    */
   account_program_id: string;
 
-  /**
-   * Account program lifecycle event submitted to the sandbox.
-   */
-  event: 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain';
-
-  /**
-   * Payouts created by a drain event. Feed each id to
-   * `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.
-   */
-  payout_ids: Array<string> | null;
-
-  /**
-   * Whether the simulation submission was successful.
-   */
-  success: boolean;
-
   /**
    * Resource type discriminator.
    */
@@ -229,22 +170,6 @@ export interface AccountProgramUnfreezeResponse {
    */
   account_program_id: string;
 
-  /**
-   * Account program lifecycle event submitted to the sandbox.
-   */
-  event: 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain';
-
-  /**
-   * Payouts created by a drain event. Feed each id to
-   * `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.
-   */
-  payout_ids: Array<string> | null;
-
-  /**
-   * Whether the simulation submission was successful.
-   */
-  success: boolean;
-
   /**
    * Resource type discriminator.
    */
@@ -260,7 +185,7 @@ export interface AccountProgramCreateParams {
   /**
    * Account program type.
    */
-  type: 'fbo-program' | 'fbo-sponsored';
+  type: 'fbo_program' | 'fbo_sponsored';
 }
 
 export interface AccountProgramCloseParams {
@@ -276,23 +201,18 @@ export interface AccountProgramDrainParams {
    * under the program is drained.
    */
   destination:
-    | AccountProgramDrainParams.IbanFinancialAddress
+    | AccountProgramDrainParams.IbanFinancialAddressRequest
     | AccountProgramDrainParams.SortCodeFinancialAddress
     | AccountProgramDrainParams.AbaFinancialAddress;
 }
 
 export namespace AccountProgramDrainParams {
-  export interface IbanFinancialAddress {
+  export interface IbanFinancialAddressRequest {
     /**
      * Name of the account holder.
      */
     account_holder_name: string;
 
-    /**
-     * Bank Identifier Code, or null if not provided.
-     */
-    bic: string | null;
-
     /**
      * International Bank Account Number.
      */
@@ -302,6 +222,11 @@ export namespace AccountProgramDrainParams {
      * Discriminator for IBAN financial address.
      */
     type: 'iban';
+
+    /**
+     * Bank Identifier Code. Optional; omit or send null if not provided.
+     */
+    bic?: string | null;
   }
 
   export interface SortCodeFinancialAddress {

package/src/resources/simulations/accounts.ts

@@ -7,13 +7,14 @@ import { path } from '../../internal/utils/path';
 
 export class Accounts extends APIResource {
   /**
-   * Creates a Mock-US USD operating (DDA) account owned by the caller merchant. This
-   * endpoint is unavailable in live production.
+   * Creates a Mock-US USD account owned by the caller merchant. This endpoint is
+   * unavailable in live production.
    *
    * @example
    * ```ts
    * const account = await client.simulations.accounts.create({
    *   label: 'x',
+   *   type: 'operating',
    * });
    * ```
    */
@@ -50,7 +51,6 @@ export class Accounts extends APIResource {
    *   {
    *     destination: {
    *       account_holder_name: 'Acme Sandbox Ltd.',
-   *       bic: 'COBADEFFXXX',
    *       iban: 'DE89370400440532013000',
    *       type: 'iban',
    *     },
@@ -99,22 +99,6 @@ export interface AccountCreateResponse {
    */
   account_id: string;
 
-  /**
-   * Account lifecycle event submitted to the sandbox.
-   */
-  event: 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain';
-
-  /**
-   * Payout created by a drain event. Feed to
-   * `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.
-   */
-  payout_id: string | null;
-
-  /**
-   * Whether the simulation submission was successful.
-   */
-  success: boolean;
-
   /**
    * Resource type discriminator.
    */
@@ -127,22 +111,6 @@ export interface AccountCloseResponse {
    */
   account_id: string;
 
-  /**
-   * Account lifecycle event submitted to the sandbox.
-   */
-  event: 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain';
-
-  /**
-   * Payout created by a drain event. Feed to
-   * `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.
-   */
-  payout_id: string | null;
-
-  /**
-   * Whether the simulation submission was successful.
-   */
-  success: boolean;
-
   /**
    * Resource type discriminator.
    */
@@ -156,20 +124,10 @@ export interface AccountDrainResponse {
   account_id: string;
 
   /**
-   * Account lifecycle event submitted to the sandbox.
+   * Payout created by the drain. Feed to `POST /v1/simulations/payouts/{id}/send` to
+   * settle.
    */
-  event: 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain';
-
-  /**
-   * Payout created by a drain event. Feed to
-   * `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.
-   */
-  payout_id: string | null;
-
-  /**
-   * Whether the simulation submission was successful.
-   */
-  success: boolean;
+  payout_id: string;
 
   /**
    * Resource type discriminator.
@@ -183,22 +141,6 @@ export interface AccountFreezeResponse {
    */
   account_id: string;
 
-  /**
-   * Account lifecycle event submitted to the sandbox.
-   */
-  event: 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain';
-
-  /**
-   * Payout created by a drain event. Feed to
-   * `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.
-   */
-  payout_id: string | null;
-
-  /**
-   * Whether the simulation submission was successful.
-   */
-  success: boolean;
-
   /**
    * Resource type discriminator.
    */
@@ -211,22 +153,6 @@ export interface AccountUnfreezeResponse {
    */
   account_id: string;
 
-  /**
-   * Account lifecycle event submitted to the sandbox.
-   */
-  event: 'create' | 'freeze' | 'unfreeze' | 'close' | 'drain';
-
-  /**
-   * Payout created by a drain event. Feed to
-   * `POST /v1/simulations/payouts/{id}/send` to settle. `null` for non-drain events.
-   */
-  payout_id: string | null;
-
-  /**
-   * Whether the simulation submission was successful.
-   */
-  success: boolean;
-
   /**
    * Resource type discriminator.
    */
@@ -238,6 +164,11 @@ export interface AccountCreateParams {
    * Human-readable label for the operating account.
    */
   label: string;
+
+  /**
+   * Account type.
+   */
+  type: 'operating';
 }
 
 export interface AccountCloseParams {
@@ -253,23 +184,18 @@ export interface AccountDrainParams {
    * drained.
    */
   destination:
-    | AccountDrainParams.IbanFinancialAddress
+    | AccountDrainParams.IbanFinancialAddressRequest
     | AccountDrainParams.SortCodeFinancialAddress
     | AccountDrainParams.AbaFinancialAddress;
 }
 
 export namespace AccountDrainParams {
-  export interface IbanFinancialAddress {
+  export interface IbanFinancialAddressRequest {
     /**
      * Name of the account holder.
      */
     account_holder_name: string;
 
-    /**
-     * Bank Identifier Code, or null if not provided.
-     */
-    bic: string | null;
-
     /**
      * International Bank Account Number.
      */
@@ -279,6 +205,11 @@ export namespace AccountDrainParams {
      * Discriminator for IBAN financial address.
      */
     type: 'iban';
+
+    /**
+     * Bank Identifier Code. Optional; omit or send null if not provided.
+     */
+    bic?: string | null;
   }
 
   export interface SortCodeFinancialAddress {

package/src/resources/simulations/conversions.ts

@@ -0,0 +1,70 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Conversions extends APIResource {
+  /**
+   * Releases a controlled (sandbox) conversion paused at its first step so it runs
+   * to completion normally. This endpoint is unavailable in live production.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.simulations.conversions.complete(
+   *     '550e8400-e29b-41d4-a716-446655440006',
+   *   );
+   * ```
+   */
+  complete(id: string, options?: RequestOptions): APIPromise<ConversionCompleteResponse> {
+    return this._client.post(path`/v1/simulations/conversions/${id}/complete`, options);
+  }
+
+  /**
+   * Fails a controlled (sandbox) conversion paused at its first step, before any
+   * funds move. This endpoint is unavailable in live production.
+   *
+   * @example
+   * ```ts
+   * const response = await client.simulations.conversions.fail(
+   *   '550e8400-e29b-41d4-a716-446655440006',
+   * );
+   * ```
+   */
+  fail(id: string, options?: RequestOptions): APIPromise<ConversionFailResponse> {
+    return this._client.post(path`/v1/simulations/conversions/${id}/fail`, options);
+  }
+}
+
+export interface ConversionCompleteResponse {
+  /**
+   * Conversion whose execution is being simulated.
+   */
+  conversion_id: string;
+
+  /**
+   * Resource type discriminator.
+   */
+  type: 'conversion_simulation';
+}
+
+export interface ConversionFailResponse {
+  /**
+   * Conversion whose execution is being simulated.
+   */
+  conversion_id: string;
+
+  /**
+   * Resource type discriminator.
+   */
+  type: 'conversion_simulation';
+}
+
+export declare namespace Conversions {
+  export {
+    type ConversionCompleteResponse as ConversionCompleteResponse,
+    type ConversionFailResponse as ConversionFailResponse,
+  };
+}

package/src/resources/simulations/deposits.ts

@@ -29,36 +29,10 @@ export interface DepositCreateResponse {
    */
   account_id: string;
 
-  /**
-   * Simulated amount as a decimal string.
-   */
-  amount: string;
-
-  /**
-   * Currency of the receiving account.
-   */
-  currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
-
-  /**
-   * Payment rail the simulated deposit arrived on, or null when not known.
-   */
-  rail: 'sepa' | 'sepa_instant' | 'faster_payments' | 'ach' | 'fedwire' | 'swift' | null;
-
-  /**
-   * Whether the simulation submission was successful.
-   */
-  success: boolean;
-
   /**
    * Resource type discriminator.
    */
   type: 'deposit_simulation';
-
-  /**
-   * ISO 20022 unstructured remittance information (<RmtInf>/<Ustrd>), or null when
-   * omitted.
-   */
-  unstructured_remittance_information: string | null;
 }
 
 export interface DepositCreateParams {
@@ -78,14 +52,32 @@ export interface DepositCreateParams {
   currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
   /**
-   * Sender of the simulated deposit.
+   * Sender of the simulated deposit. Mutually exclusive with `counterparty_id`.
    */
   counterparty?: DepositCreateParams.Counterparty;
 
+  /**
+   * ID of an existing counterparty to use as the sender of the simulated deposit.
+   * Mutually exclusive with `counterparty`.
+   */
+  counterparty_id?: string;
+
   /**
    * Payment rail the simulated deposit arrives on.
    */
-  rail?: 'sepa' | 'sepa_instant' | 'faster_payments' | 'ach' | 'fedwire' | 'swift';
+  rail?:
+    | 'sepa'
+    | 'sepa_instant'
+    | 'faster_payments'
+    | 'swift'
+    | 'ach'
+    | 'fedwire'
+    | 'ethereum'
+    | 'ethereum_sepolia'
+    | 'solana'
+    | 'solana_devnet'
+    | 'polygon'
+    | 'polygon_amoy';
 
   /**
    * Unstructured remittance information attached to the transfer. Not all rails
@@ -96,7 +88,7 @@ export interface DepositCreateParams {
 
 export namespace DepositCreateParams {
   /**
-   * Sender of the simulated deposit.
+   * Sender of the simulated deposit. Mutually exclusive with `counterparty_id`.
    */
   export interface Counterparty {
     /**
@@ -505,19 +497,19 @@ export namespace DepositCreateParams {
       line_1: string;
 
       /**
-       * Secondary street address, or null if not recorded.
+       * Postal or ZIP code.
        */
-      line_2: string | null;
+      postal_code: string;
 
       /**
-       * Postal or ZIP code.
+       * Secondary street address. Optional; omit or send null if not recorded.
        */
-      postal_code: string;
+      line_2?: string | null;
 
       /**
-       * State, province, or region, or null if not recorded.
+       * State, province, or region. Optional; omit or send null if not recorded.
        */
-      state: string | null;
+      state?: string | null;
     }
   }
 }

package/src/resources/simulations/index.ts

@@ -22,11 +22,22 @@ export {
   type AccountCloseParams,
   type AccountDrainParams,
 } from './accounts';
+export { Conversions, type ConversionCompleteResponse, type ConversionFailResponse } from './conversions';
 export { Deposits, type DepositCreateResponse, type DepositCreateParams } from './deposits';
 export {
   Payouts,
   type PayoutRejectResponse,
+  type PayoutReturnResponse,
   type PayoutSendResponse,
   type PayoutRejectParams,
+  type PayoutReturnParams,
 } from './payouts';
+export {
+  Returns,
+  type ReturnRejectResponse,
+  type ReturnReturnResponse,
+  type ReturnSendResponse,
+  type ReturnRejectParams,
+  type ReturnReturnParams,
+} from './returns';
 export { Simulations } from './simulations';