@leaflow/sdk 0.31.0 → 0.32.0

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

@@ -38,10 +38,10 @@ export type CancelSubscriptionResult = operations["cancel-subscription"]["respon
 export type CancelSubscriptionQuery = operations["cancel-subscription"]["parameters"]["query"];
 /** `GET /account/v1/billing-accounts/{accountKey}/top-ups/{paymentId}` 成功时的响应体。 */
 export type ReadTopUpResult = operations["read-top-up"]["responses"][200]["content"]["application/json"];
-/** `GET /account/v1/billing-accounts/{accountKey}/card` 成功时的响应体。 */
+/** `GET /account/v1/billing-accounts/{accountKey}/payment-method` 成功时的响应体。 */
 export type ReadPaymentMethodResult = operations["read-payment-method"]["responses"][200]["content"]["application/json"];
-/** `POST /account/v1/billing-accounts/{accountKey}/card` 成功时的响应体。 */
-export type StartCardSetupResult = operations["start-card-setup"]["responses"][200]["content"]["application/json"];
+/** `POST /account/v1/billing-accounts/{accountKey}/payment-method` 成功时的响应体。 */
+export type StartPaymentMethodSetupResult = operations["start-payment-method-setup"]["responses"][200]["content"]["application/json"];
 /** `POST /account/v1/billing-accounts/{accountKey}/billing-portal` 成功时的响应体。 */
 export type StartBillingPortalResult = operations["start-billing-portal"]["responses"][200]["content"]["application/json"];
 /** `GET /account/v1/billing-accounts/{accountKey}/offers` 成功时的响应体。 */

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

@@ -363,7 +363,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/account/v1/billing-accounts/{accountKey}/card": {
+    "/account/v1/billing-accounts/{accountKey}/payment-method": {
         parameters: {
             query?: never;
             header?: never;
@@ -372,46 +372,58 @@ export interface paths {
         };
         /**
          * Whether this account can be charged
-         * @description Answers whether a card is on file, and nothing else.
+         * @description Answers whether a payment method is on file, and nothing else.
+         *
+         *     ## It is a payment method, not a card
+         *
+         *     A card is one kind. Direct debit and the recurring-payment mandates offered by regional
+         *     wallets are others, and they occupy the same slot: something the provider can charge later
+         *     without the account holder present. Naming the slot after cards would put an assumption
+         *     into the contract that stops being true the day a second kind is accepted.
          *
          *     ## Why there is no brand, no last four digits, no expiry
          *
          *     Those would have to be read from the payment provider, and the two answers can disagree: a
-         *     card present at the provider that the billing engine has not recorded as the default is
+         *     method present at the provider that the billing engine has not recorded as the default is
          *     exactly the state in which money cannot be collected — while a page built on the provider's
-         *     answer would be showing a card. What matters here is whether the party that will run the
+         *     answer would be showing one. What matters here is whether the party that will run the
          *     charge believes it can, so the answer comes from that party alone.
          *
-         *     To see the card, replace it, or remove it, open the billing portal.
+         *     To see it, replace it, or remove it, open the billing portal.
          *
          *     ## Read this before offering a paid plan, not after
          *
          *     `ready` being false is why the engine refuses to start a paid subscription. Discovering it
-         *     at purchase time turns a missing card into a rejection whose wording is about something
-         *     else entirely.
+         *     at purchase time turns a missing payment method into a rejection whose wording is about
+         *     something else entirely.
          *
-         *     An account that has never had a card returns `ready: false`. That is the normal state of a
+         *     An account that has never had one returns `ready: false`. That is the normal state of a
          *     new account, not an error.
          */
         get: operations["read-payment-method"];
         put?: never;
         /**
-         * Add or replace the card on file
-         * @description Begins adding a card. Returns a URL to send the browser to; the card is entered there, on the
-         *     payment provider's own page, and **no card data ever reaches this platform**.
+         * Add or replace the payment method on file
+         * @description Begins adding a payment method. Returns a URL to send the browser to; the details are
+         *     entered there, on the payment provider's own page, and **no card data ever reaches this
+         *     platform**.
+         *
+         *     Which kinds are offered is the provider's decision, not this API's — a card today, a
+         *     wallet mandate or a direct debit wherever the provider supports charging one later without
+         *     the account holder present.
          *
          *     ## This is a prerequisite for buying a plan, not a convenience
          *
-         *     A plan is charged by invoice, and the invoice is collected from the card on file. The billing
-         *     a subscription cannot start for an account that has none — so "add a card, then
+         *     A plan is charged by invoice, and the invoice is collected from the method on file. A
+         *     subscription cannot start for an account that has none — so "add a payment method, then
          *     buy" is the order the system requires, not a flow that was chosen.
          *
          *     It is *not* a prerequisite for topping up: a top-up collects the money there and then.
          *
-         *     Replacing the card uses the same operation. The new card becomes the default and the old one
-         *     stops being used; nothing else about the account changes.
+         *     Replacing uses the same operation. The new method becomes the default and the old one stops
+         *     being used; nothing else about the account changes.
          */
-        post: operations["start-card-setup"];
+        post: operations["start-payment-method-setup"];
         delete?: never;
         options?: never;
         head?: never;
@@ -790,7 +802,7 @@ export interface components {
              */
             offer_key?: string;
         };
-        CardSetupSession: {
+        PaymentMethodSetupSession: {
             /**
              * Format: uri
              * @description Send the browser here. It expires, so do not store it
@@ -804,7 +816,12 @@ export interface components {
              */
             url: string;
         };
-        /** @description Whether money can be collected from this account */
+        /**
+         * @description Whether money can be collected from this account later, without the account holder present.
+         *
+         *     Deliberately not called a card: a card is one kind of payment method, and direct debit and
+         *     the recurring mandates offered by regional wallets occupy the same slot.
+         */
         PaymentMethod: {
             /**
              * @description True when the billing engine holds a default payment method for this account and can
@@ -814,6 +831,9 @@ export interface components {
              *     subscription is refused, and the refusal is about billing setup rather than about the
              *     plan — so check this first and say what is actually missing.
              *
+             *     It says nothing about which kind is on file. To show or change that, send the account
+             *     holder to the billing portal.
+             *
              *     A free plan does not require it, which is what allows a new account to be placed on the
              *     default tier before anyone has entered a card.
              */
@@ -1556,7 +1576,7 @@ export interface operations {
             };
         };
     };
-    "start-card-setup": {
+    "start-payment-method-setup": {
         parameters: {
             query?: never;
             header?: never;
@@ -1577,7 +1597,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CardSetupSession"];
+                    "application/json": components["schemas"]["PaymentMethodSetupSession"];
                 };
             };
             /** @description Error */

package/package.json

@@ -1,74 +1,74 @@
 {
-    "name": "@leaflow/sdk",
-    "version": "0.31.0",
-    "description": "Leaflow 平台 API 的 TypeScript SDK",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/leaflowapis/leaflow-ts.git"
+  "name": "@leaflow/sdk",
+  "version": "0.32.0",
+  "description": "Leaflow 平台 API 的 TypeScript SDK",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leaflowapis/leaflow-ts.git"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     },
-    "type": "module",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "default": "./dist/index.js"
-        },
-        "./account/v1": {
-            "types": "./dist/account/v1/index.d.ts",
-            "default": "./dist/account/v1/index.js"
-        },
-        "./assistant/v1": {
-            "types": "./dist/assistant/v1/index.d.ts",
-            "default": "./dist/assistant/v1/index.js"
-        },
-        "./canopy/v1": {
-            "types": "./dist/canopy/v1/index.d.ts",
-            "default": "./dist/canopy/v1/index.js"
-        },
-        "./compute/v1": {
-            "types": "./dist/compute/v1/index.d.ts",
-            "default": "./dist/compute/v1/index.js"
-        },
-        "./iam/v1": {
-            "types": "./dist/iam/v1/index.d.ts",
-            "default": "./dist/iam/v1/index.js"
-        },
-        "./monitoring/v1": {
-            "types": "./dist/monitoring/v1/index.d.ts",
-            "default": "./dist/monitoring/v1/index.js"
-        },
-        "./tunnel/v1": {
-            "types": "./dist/tunnel/v1/index.d.ts",
-            "default": "./dist/tunnel/v1/index.js"
-        }
+    "./account/v1": {
+      "types": "./dist/account/v1/index.d.ts",
+      "default": "./dist/account/v1/index.js"
     },
-    "files": [
-        "dist"
-    ],
-    "sideEffects": false,
-    "scripts": {
-        "generate": "node scripts/generate.mjs",
-        "build": "tsc -p tsconfig.build.json",
-        "typecheck": "tsc -p tsconfig.json --noEmit",
-        "prepublishOnly": "npm run build"
+    "./assistant/v1": {
+      "types": "./dist/assistant/v1/index.d.ts",
+      "default": "./dist/assistant/v1/index.js"
     },
-    "devDependencies": {
-        "openapi-typescript": "7.13.0",
-        "typescript": "^5.9.3",
-        "openapi-fetch": "^0.17.0",
-        "yaml": "^2.8.1"
+    "./canopy/v1": {
+      "types": "./dist/canopy/v1/index.d.ts",
+      "default": "./dist/canopy/v1/index.js"
     },
-    "publishConfig": {
-        "access": "public"
+    "./compute/v1": {
+      "types": "./dist/compute/v1/index.d.ts",
+      "default": "./dist/compute/v1/index.js"
     },
-    "peerDependencies": {
-        "openapi-fetch": ">=0.14"
+    "./iam/v1": {
+      "types": "./dist/iam/v1/index.d.ts",
+      "default": "./dist/iam/v1/index.js"
     },
-    "peerDependenciesMeta": {
-        "openapi-fetch": {
-            "optional": true
-        }
+    "./monitoring/v1": {
+      "types": "./dist/monitoring/v1/index.d.ts",
+      "default": "./dist/monitoring/v1/index.js"
+    },
+    "./tunnel/v1": {
+      "types": "./dist/tunnel/v1/index.d.ts",
+      "default": "./dist/tunnel/v1/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "generate": "node scripts/generate.mjs",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "openapi-typescript": "7.13.0",
+    "typescript": "^5.9.3",
+    "openapi-fetch": "^0.17.0",
+    "yaml": "^2.8.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "openapi-fetch": ">=0.14"
+  },
+  "peerDependenciesMeta": {
+    "openapi-fetch": {
+      "optional": true
     }
+  }
 }