@leaflow/sdk 0.0.0-dev.224.g2e0d1be → 0.0.0-dev.228.g03b4230

package/dist/billing/account/v1/index.d.ts

@@ -83,6 +83,8 @@ export type ListCreditGrantsResult = operations["list-credit-grants"]["responses
 export type ListCreditGrantsQuery = operations["list-credit-grants"]["parameters"]["query"];
 /** The success response body of `GET /account/v1/refunds`. */
 export type ListRefundsResult = operations["list-refunds"]["responses"][200]["content"]["application/json"];
+/** The query parameters of `GET /account/v1/refunds`. */
+export type ListRefundsQuery = operations["list-refunds"]["parameters"]["query"];
 /** The success response body of `GET /account/v1/usage-charges`. */
 export type ListUsageChargesResult = operations["list-usage-charges"]["responses"][200]["content"]["application/json"];
 /** The query parameters of `GET /account/v1/usage-charges`. */

package/dist/billing/account/v1/schema.d.ts

@@ -607,7 +607,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List refunds */
+        /**
+         * List refunds
+         * @description Newest first.
+         */
         get: operations["list-refunds"];
         put?: never;
         post?: never;
@@ -1771,11 +1774,23 @@ export interface components {
             invoice_id?: string;
             /** Format: uuid */
             transaction_id?: string;
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description The credit grant that paid, or for a refund, the credit grant restored.
+             */
             credit_grant_id?: string;
             credit_grant?: components["schemas"]["ObjectIdentity"];
             /** Format: uuid */
             refund_id?: string;
+            /**
+             * @description Present on refunds. Where this part of the refund goes.
+             *
+             *     - `balance`: back to the account balance.
+             *     - `credit`: back to the credit grant that paid, which keeps its original expiry.
+             *     - `gateway`: back to the payment method it was paid with.
+             * @enum {string}
+             */
+            refund_destination?: "balance" | "credit" | "gateway";
             /**
              * @description `failed` means the operation did not succeed; for a gateway payment, that the gateway declined
              *     it. `canceled` means a gateway payment was withdrawn without collecting money. After either,
@@ -1803,9 +1818,17 @@ export interface components {
             /** Format: int64 */
             billing_account_id?: number;
             type: components["schemas"]["TransactionType"];
-            /** @description Signed. Positive adds to the balance, negative takes from it. */
+            /**
+             * @description Signed by type: positive for `topup` and `payment`, negative for `refund` and `payout`.
+             *     An `adjustment` is positive when it adds to the balance and negative when it takes from
+             *     it. For the other types the sign does not tell the effect on the balance: a payment from
+             *     the balance lowers it, while a payment by gateway or by credit leaves it unchanged.
+             */
             amount: components["schemas"]["Money"];
-            /** @description How much of this batch has not been spent yet. Zero on negative batches. */
+            /**
+             * @description How much of this transaction is still available in the balance. Only top-ups, positive
+             *     adjustments and gateway payments later returned to the balance can be non-zero.
+             */
             remaining_amount: components["schemas"]["Money"];
             currency: string;
             reason?: string;
@@ -1854,28 +1877,71 @@ export interface components {
             billing_account_id?: number;
             /** Format: uuid */
             invoice_id?: string | null;
-            /** Format: uuid */
+            /**
+             * Format: uuid
+             * @description The order the refund belongs to: the order that caused it, such as a downgrade, otherwise
+             *     the order of the refunded invoice. Null for refunds of top-ups and of usage invoices.
+             */
             order_id?: string | null;
+            /** @description The whole refund. Equals balance_amount plus credit_amount plus gateway_amount. */
             amount: components["schemas"]["Money"];
+            /** @description The part returned to the account balance. */
+            balance_amount: components["schemas"]["Money"];
+            /** @description The part restored to the credit grants that paid for it. */
+            credit_amount: components["schemas"]["Money"];
+            /** @description The part returned to the payment method it was paid with. */
+            gateway_amount: components["schemas"]["Money"];
             /** @description What has actually been returned. */
             settled_amount?: components["schemas"]["Money"];
             currency: string;
             /**
-             * @description Where the refunded money went — back to the account balance, or back to the payment method it came from.
+             * @deprecated
+             * @description Use balance_amount, credit_amount and gateway_amount, which also show a refund split between several destinations.
              * @enum {string}
              */
             destination?: "balance" | "gateway";
             /**
-             * @description Summary of the related refund transactions. Succeeded only when every part succeeds.
-             *     Pending and processing do not mean funds have been returned. Partial success remains
-             *     visible in settled_amount and transactions, including when another part has failed.
+             * @description Summary of the parts in `transactions`.
+             *
+             *     - `pending`: nothing has been returned yet, and at least one part is in progress.
+             *     - `processing`: some parts have been returned, and at least one is still in progress.
+             *     - `succeeded`: every part has been returned.
+             *     - `failed`: no part is in progress and at least one has failed. What was returned is in
+             *       settled_amount.
+             *
+             *     Returns to the balance and to credit grants complete shortly after the refund is made; a
+             *     return to a payment method completes when the gateway confirms it.
              * @enum {string}
              */
             status: "pending" | "processing" | "succeeded" | "failed";
-            reason?: string;
+            /**
+             * Format: date-time
+             * @description When the last part was returned. Present with `succeeded`.
+             */
+            settled_at?: string;
+            reason: components["schemas"]["RefundReason"];
             /** Format: date-time */
             created_at: string;
         };
+        /**
+         * @description Why the refund was made. Clients map the code to their own wording. More codes may be added;
+         *     treat an unknown code as a refund without a stated reason.
+         *
+         *     - `provisioning_failed`: the purchase could not be delivered.
+         *     - `order_expired`: the order expired after part of it had been paid.
+         *     - `order_canceled`: the account holder canceled the order after part of it had been paid.
+         *     - `change_canceled`: a scheduled change was withdrawn after it had been paid.
+         *     - `change_expired`: a scheduled change could not take effect before its time passed.
+         *     - `subscription_canceled`: the subscription was canceled and its unused value returned under
+         *       its refund terms.
+         *     - `future_period_canceled`: a renewal that had not started yet was withdrawn.
+         *     - `downgrade_difference`: the unused value above the new price after a downgrade.
+         *     - `usage_true_up`: usage priced again over the whole month cost less than was charged.
+         *     - `payment_not_applied`: a payment arrived after its invoice could no longer be paid.
+         *     - `operator`: made by the platform operator.
+         * @enum {string}
+         */
+        RefundReason: "provisioning_failed" | "order_expired" | "order_canceled" | "change_canceled" | "change_expired" | "subscription_canceled" | "future_period_canceled" | "downgrade_difference" | "usage_true_up" | "payment_not_applied" | "operator";
         RefundList: {
             items: components["schemas"]["Refund"][];
             /** Format: int64 */
@@ -3380,6 +3446,14 @@ export interface operations {
                 page_size?: components["parameters"]["PageSize"];
                 /** @description Restrict to one of your accounts. All of them when omitted. */
                 billing_account_id?: components["parameters"]["AccountIdQuery"];
+                /** @description Only the refunds of this invoice. */
+                invoice_id?: string;
+                /**
+                 * @description Only the refunds that belong to this order: those of its invoice, such as the refund of a
+                 *     purchase that could not be delivered, and those it caused on an earlier invoice, such as
+                 *     the difference returned after a downgrade.
+                 */
+                order_id?: string;
             };
             header?: never;
             path?: never;

package/dist/compute/v1/index.d.ts

@@ -133,10 +133,6 @@ export type RebuildInstanceBody = NonNullable<operations["rebuild-instance"]["re
 export type ResizeInstanceResult = operations["resize-instance"]["responses"][202]["content"]["application/json"];
 /** The request body of `POST /api/v1/instances/{instanceId}/resize`. */
 export type ResizeInstanceBody = NonNullable<operations["resize-instance"]["requestBody"]>["content"]["application/json"];
-/** The success response body of `POST /api/v1/instances/{instanceId}/resize/confirm`. */
-export type ConfirmInstanceResizeResult = operations["confirm-instance-resize"]["responses"][202]["content"]["application/json"];
-/** The success response body of `POST /api/v1/instances/{instanceId}/resize/revert`. */
-export type RevertInstanceResizeResult = operations["revert-instance-resize"]["responses"][202]["content"]["application/json"];
 /** The success response body of `POST /api/v1/instances/{instanceId}/start`. */
 export type StartInstanceResult = operations["start-instance"]["responses"][202]["content"]["application/json"];
 /** The request body of `POST /api/v1/instances/{instanceId}/start`. */

package/dist/compute/v1/schema.d.ts

@@ -696,53 +696,11 @@ export interface paths {
          * Resize an instance
          * @description Creates a Billing change order, including for metered pricing. The price must belong to the Billing Plan of the target instance type; applicable contract pricing is resolved by Billing. The resize is applied after the order's invoice is paid, or without waiting when the order has no immediate invoice. Do not submit a new purchase after paying, and reuse the original idempotency key after an uncertain response.
          *
-         *     Replays return HTTP 202 for the original operation. See the idempotency conventions for conflicts and terminal outcomes.
-         */
-        post: operations["resize-instance"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/instances/{instanceId}/resize/confirm": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Confirm a resize
-         * @description Releases the resources held by the previous size. `pending_instance_type_id` becomes the type in effect and is billed from then on.
+         *     The new instance type takes effect, and is billed from then on, when the returned task succeeds. A completed resize is final and cannot be reverted; to return to the previous type, submit another resize.
          *
          *     Replays return HTTP 202 for the original operation. See the idempotency conventions for conflicts and terminal outcomes.
          */
-        post: operations["confirm-instance-resize"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/v1/instances/{instanceId}/resize/revert": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Revert a resize
-         * @description The instance returns to its previous size, `pending_instance_type_id` is discarded, and billing is unaffected by the resize.
-         *
-         *     Replays return HTTP 202 for the original operation. See the idempotency conventions for conflicts and terminal outcomes.
-         */
-        post: operations["revert-instance-resize"];
+        post: operations["resize-instance"];
         delete?: never;
         options?: never;
         head?: never;
@@ -1959,7 +1917,7 @@ export interface components {
             /** Format: uuid */
             region_id: string;
             /** @enum {string} */
-            status: "pending" | "building" | "active" | "stopped" | "paused" | "suspended" | "shelved" | "shelved_offloaded" | "rescued" | "resized" | "deleting" | "deleted" | "error" | "unknown";
+            status: "pending" | "building" | "active" | "stopped" | "paused" | "suspended" | "shelved" | "shelved_offloaded" | "rescued" | "deleting" | "deleted" | "error" | "unknown";
             /** Format: uuid */
             subnet_id: string | null;
             /** Format: date-time */
@@ -4205,92 +4163,6 @@ export interface operations {
             };
         };
     };
-    "confirm-instance-resize": {
-        parameters: {
-            query?: never;
-            header: {
-                /** @description Reuse the same key for retries of the same action. A different request with the same key is rejected. */
-                "Idempotency-Key": string;
-            };
-            path: {
-                instanceId: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description The action was accepted. Wait for the returned task to finish. */
-            202: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Task"];
-                };
-            };
-            /** @description The idempotency key was already used with different parameters in this scope. */
-            409: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Error */
-            default: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    "revert-instance-resize": {
-        parameters: {
-            query?: never;
-            header: {
-                /** @description Reuse the same key for retries of the same action. A different request with the same key is rejected. */
-                "Idempotency-Key": string;
-            };
-            path: {
-                instanceId: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description The action was accepted. Wait for the returned task to finish. */
-            202: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Task"];
-                };
-            };
-            /** @description The idempotency key was already used with different parameters in this scope. */
-            409: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-            /** @description Error */
-            default: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
     "start-instance": {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leaflow/sdk",
-  "version": "0.0.0-dev.224.g2e0d1be",
+  "version": "0.0.0-dev.228.g03b4230",
   "description": "Leaflow 平台 API 的 TypeScript SDK",
   "license": "MIT",
   "repository": {