@naturali/sdk 0.170.4 → 0.171.0

package/dist/index.cjs

@@ -5428,11 +5428,13 @@ var Users = class {
 		});
 	}
 	/**
-	* Start a credit top-up
+	* Top up credit
 	*
-	* A hosted card checkout that buys model credit for the caller's account. Send the caller to `checkout_url`; once the card is charged the full amount is added to `credit_balance_usd` as purchased credit, which never expires. The card fee is not deducted.
+	* Buys model credit for the caller's account. Once the card is charged the full amount is added to `credit_balance_usd` as purchased credit, which never expires. The card fee is not deducted. Charged in US dollars.
 	*
-	* Charged in US dollars. Creating a top-up charges nothing, and one left unpaid lapses at `expires_at`. After paying, the browser returns to the console's billing page.
+	* With `saved_card: true` the saved card is charged at once and the answer is `status: paid`. When the card needs authentication or is declined, nothing is charged and the answer falls back to a checkout.
+	*
+	* A checkout (`status: checkout`) is a hosted page: send the caller to `checkout_url`. Creating it charges nothing, and one left unpaid lapses at `expires_at`. After paying, the browser returns to the console's billing page.
 	*
 	*/
 	static createCurrentUserTopUp(options) {

package/dist/index.d.cts

@@ -8415,24 +8415,32 @@ type TopUpCreate = {
    * US dollars to buy, in whole cents.
    */
   amount_usd: number;
+  /**
+   * Charge the saved card now instead of opening a checkout.
+   */
+  saved_card?: boolean;
 };
 type TopUp = {
   /**
-   * The checkout's ID at the payment provider.
+   * The payment's or the checkout's ID at the payment provider.
    */
   id: string;
   /**
-   * What the checkout charges, and what it credits once paid.
+   * What is charged, and what is credited once paid.
    */
   amount_usd: number;
   /**
-   * The hosted page that takes the card.
+   * `paid`: the saved card was charged and the credit added. `checkout`: nothing is charged until the caller pays at `checkout_url`.
    */
-  checkout_url: string;
+  status: 'paid' | 'checkout';
   /**
-   * When an unpaid checkout lapses.
+   * The hosted page that takes the card; `null` when paid.
    */
-  expires_at: Date;
+  checkout_url: string | null;
+  /**
+   * When an unpaid checkout lapses; `null` when paid.
+   */
+  expires_at: Date | null;
 };
 type PaymentMethod = {
   brand: string;
@@ -24151,6 +24159,10 @@ type CreateCurrentUserTopUpErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * `saved_card` with no saved card (`payment_method_required`).
+   */
+  409: ErrorResponse;
   /**
    * The payment provider could not be reached (`payment_provider_error`). Nothing was charged.
    */
@@ -24163,7 +24175,7 @@ type CreateCurrentUserTopUpErrors = {
 type CreateCurrentUserTopUpError = CreateCurrentUserTopUpErrors[keyof CreateCurrentUserTopUpErrors];
 type CreateCurrentUserTopUpResponses = {
   /**
-   * The checkout to send the caller to.
+   * The paid top-up, or the checkout to send the caller to.
    */
   201: TopUp;
 };
@@ -27579,11 +27591,13 @@ export declare class Users {
    */
   static getCurrentUserStatement<ThrowOnError extends boolean = false>(options: Options<GetCurrentUserStatementData, ThrowOnError>): RequestResult<GetCurrentUserStatementResponses, GetCurrentUserStatementErrors, ThrowOnError>;
   /**
-   * Start a credit top-up
+   * Top up credit
+   *
+   * Buys model credit for the caller's account. Once the card is charged the full amount is added to `credit_balance_usd` as purchased credit, which never expires. The card fee is not deducted. Charged in US dollars.
    *
-   * A hosted card checkout that buys model credit for the caller's account. Send the caller to `checkout_url`; once the card is charged the full amount is added to `credit_balance_usd` as purchased credit, which never expires. The card fee is not deducted.
+   * With `saved_card: true` the saved card is charged at once and the answer is `status: paid`. When the card needs authentication or is declined, nothing is charged and the answer falls back to a checkout.
    *
-   * Charged in US dollars. Creating a top-up charges nothing, and one left unpaid lapses at `expires_at`. After paying, the browser returns to the console's billing page.
+   * A checkout (`status: checkout`) is a hosted page: send the caller to `checkout_url`. Creating it charges nothing, and one left unpaid lapses at `expires_at`. After paying, the browser returns to the console's billing page.
    *
    */
   static createCurrentUserTopUp<ThrowOnError extends boolean = false>(options: Options<CreateCurrentUserTopUpData, ThrowOnError>): RequestResult<CreateCurrentUserTopUpResponses, CreateCurrentUserTopUpErrors, ThrowOnError>;

package/dist/index.d.mts

@@ -8415,24 +8415,32 @@ type TopUpCreate = {
    * US dollars to buy, in whole cents.
    */
   amount_usd: number;
+  /**
+   * Charge the saved card now instead of opening a checkout.
+   */
+  saved_card?: boolean;
 };
 type TopUp = {
   /**
-   * The checkout's ID at the payment provider.
+   * The payment's or the checkout's ID at the payment provider.
    */
   id: string;
   /**
-   * What the checkout charges, and what it credits once paid.
+   * What is charged, and what is credited once paid.
    */
   amount_usd: number;
   /**
-   * The hosted page that takes the card.
+   * `paid`: the saved card was charged and the credit added. `checkout`: nothing is charged until the caller pays at `checkout_url`.
    */
-  checkout_url: string;
+  status: 'paid' | 'checkout';
   /**
-   * When an unpaid checkout lapses.
+   * The hosted page that takes the card; `null` when paid.
    */
-  expires_at: Date;
+  checkout_url: string | null;
+  /**
+   * When an unpaid checkout lapses; `null` when paid.
+   */
+  expires_at: Date | null;
 };
 type PaymentMethod = {
   brand: string;
@@ -24151,6 +24159,10 @@ type CreateCurrentUserTopUpErrors = {
    * Missing or invalid credentials.
    */
   401: ErrorResponse;
+  /**
+   * `saved_card` with no saved card (`payment_method_required`).
+   */
+  409: ErrorResponse;
   /**
    * The payment provider could not be reached (`payment_provider_error`). Nothing was charged.
    */
@@ -24163,7 +24175,7 @@ type CreateCurrentUserTopUpErrors = {
 type CreateCurrentUserTopUpError = CreateCurrentUserTopUpErrors[keyof CreateCurrentUserTopUpErrors];
 type CreateCurrentUserTopUpResponses = {
   /**
-   * The checkout to send the caller to.
+   * The paid top-up, or the checkout to send the caller to.
    */
   201: TopUp;
 };
@@ -27579,11 +27591,13 @@ export declare class Users {
    */
   static getCurrentUserStatement<ThrowOnError extends boolean = false>(options: Options<GetCurrentUserStatementData, ThrowOnError>): RequestResult<GetCurrentUserStatementResponses, GetCurrentUserStatementErrors, ThrowOnError>;
   /**
-   * Start a credit top-up
+   * Top up credit
+   *
+   * Buys model credit for the caller's account. Once the card is charged the full amount is added to `credit_balance_usd` as purchased credit, which never expires. The card fee is not deducted. Charged in US dollars.
    *
-   * A hosted card checkout that buys model credit for the caller's account. Send the caller to `checkout_url`; once the card is charged the full amount is added to `credit_balance_usd` as purchased credit, which never expires. The card fee is not deducted.
+   * With `saved_card: true` the saved card is charged at once and the answer is `status: paid`. When the card needs authentication or is declined, nothing is charged and the answer falls back to a checkout.
    *
-   * Charged in US dollars. Creating a top-up charges nothing, and one left unpaid lapses at `expires_at`. After paying, the browser returns to the console's billing page.
+   * A checkout (`status: checkout`) is a hosted page: send the caller to `checkout_url`. Creating it charges nothing, and one left unpaid lapses at `expires_at`. After paying, the browser returns to the console's billing page.
    *
    */
   static createCurrentUserTopUp<ThrowOnError extends boolean = false>(options: Options<CreateCurrentUserTopUpData, ThrowOnError>): RequestResult<CreateCurrentUserTopUpResponses, CreateCurrentUserTopUpErrors, ThrowOnError>;

package/dist/index.mjs

@@ -5427,11 +5427,13 @@ var Users = class {
 		});
 	}
 	/**
-	* Start a credit top-up
+	* Top up credit
 	*
-	* A hosted card checkout that buys model credit for the caller's account. Send the caller to `checkout_url`; once the card is charged the full amount is added to `credit_balance_usd` as purchased credit, which never expires. The card fee is not deducted.
+	* Buys model credit for the caller's account. Once the card is charged the full amount is added to `credit_balance_usd` as purchased credit, which never expires. The card fee is not deducted. Charged in US dollars.
 	*
-	* Charged in US dollars. Creating a top-up charges nothing, and one left unpaid lapses at `expires_at`. After paying, the browser returns to the console's billing page.
+	* With `saved_card: true` the saved card is charged at once and the answer is `status: paid`. When the card needs authentication or is declined, nothing is charged and the answer falls back to a checkout.
+	*
+	* A checkout (`status: checkout`) is a hosted page: send the caller to `checkout_url`. Creating it charges nothing, and one left unpaid lapses at `expires_at`. After paying, the browser returns to the console's billing page.
 	*
 	*/
 	static createCurrentUserTopUp(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.170.4",
+  "version": "0.171.0",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.99.0",
-    "@naturali/api": "0.170.4",
+    "@naturali/api": "0.171.0",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",