@naturali/cli 0.173.3 → 0.174.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.173.3";
+var version = "0.174.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -935,7 +935,7 @@ var Channels = class {
 	* Connect a channel
 	*
 	* Connect a channel. The required fields depend on `channel`; no credential is ever returned.
-	* **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured.
+	* **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application. Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured.
 	* **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret:
 	* * **BYOT** (`credential_source: byot`, default) — supply
 	* `phone_number_id` and `access_token` from your own Meta app.
@@ -5454,7 +5454,7 @@ var Users = class {
 	*
 	* 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.
+	* 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`. The card paid with there becomes the account's saved card, replacing any other. After paying, the browser returns to the console's billing page.
 	*
 	*/
 	static createCurrentUserTopUp(options) {
@@ -5545,9 +5545,11 @@ var Users = class {
 	/**
 	* Change the plan
 	*
-	* Choose `free`, `pro` or `business`. A paid plan needs a saved card.
+	* Choose `free`, `pro` or `business`.
 	*
-	* An upgrade is charged at once on the saved card, in its currency, for the price difference over the rest of the month, then takes effect; the month's statement nets that payment out. A declined card leaves the plan unchanged. A downgrade takes effect when the month ends, and `next_plan` names it until then. A contract plan is changed by asking us.
+	* An upgrade is charged for the price difference over the rest of the month, then takes effect; the month's statement nets that payment out. The saved card is charged at once, in its currency. With no saved card, or when the card needs authentication or is declined, nothing is charged and the answer carries a `checkout_url`: a hosted page that charges the upgrade and saves the card. The plan changes once it is paid; one left unpaid lapses at `expires_at`.
+	*
+	* A downgrade takes effect when the month ends, and `next_plan` names it until then. A contract plan is changed by asking us.
 	*
 	*/
 	static setCurrentUserPlan(options) {
@@ -5560,6 +5562,18 @@ var Users = class {
 			}
 		});
 	}
+	/**
+	* Preview a plan change
+	*
+	* What choosing `plan` would charge now: an upgrade's share of the rest of the month, else 0. Changes nothing.
+	*
+	*/
+	static getCurrentUserPlanQuote(options) {
+		return (options.client ?? client).get({
+			url: "/v1/users/me/plan/quote",
+			...options
+		});
+	}
 };
 var Webhooks = class {
 	/**
@@ -10162,7 +10176,7 @@ const routes = {
 	"create-channel": {
 		serviceClass: "Channels",
 		operationId: "createChannel",
-		description: "Connect a channel. The required fields depend on `channel`; no credential is ever returned. **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured. **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret: * **BYOT** (`credential_source: byot`, default) — supply `phone_number_id` and `access_token` from your own Meta app. * **Embedded signup** (`credential_source: embedded_signup`) — supply `code` and `waba_id` (and optionally `pin`) from the Meta popup; naturali exchanges the `code` for the token and subscribes its app to the WABA, so the customer never hands over a token. Returns `501` on deployments where Meta App credentials are not configured. The project's plan limits how many channels it may hold. At the limit this responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit`, before any credential is acquired. Only `active` channels count, so disabling one frees allowance without deleting it.",
+		description: "Connect a channel. The required fields depend on `channel`; no credential is ever returned. **Discord** (`channel: discord`) — supply `application_id` and `bot_token`, plus the `modes` selecting which Gateway flows to serve (direct messages, and/or @mention-opens-a-thread). The token is checked with Discord first: `400 invalid_bot_token` when Discord rejects it, `400 application_mismatch` when it belongs to another application. Returns `501` when the deployment has no `CHANNEL_TOKEN_KEY` configured. **WhatsApp** (default) — one of two credential paths, both filling the same write-only secret: * **BYOT** (`credential_source: byot`, default) — supply `phone_number_id` and `access_token` from your own Meta app. * **Embedded signup** (`credential_source: embedded_signup`) — supply `code` and `waba_id` (and optionally `pin`) from the Meta popup; naturali exchanges the `code` for the token and subscribes its app to the WABA, so the customer never hands over a token. Returns `501` on deployments where Meta App credentials are not configured. The project's plan limits how many channels it may hold. At the limit this responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit`, before any credential is acquired. Only `active` channels count, so disabling one frees allowance without deleting it.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -21114,7 +21128,7 @@ const routes = {
 	"create-current-user-top-up": {
 		serviceClass: "Users",
 		operationId: "createCurrentUserTopUp",
-		description: "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. `amount_usd` is what is credited; a card issued in Brazil is charged its equivalent in Brazilian reais at the Banco Central's latest closing PTAX selling rate, and a checkout shows reais to a payer in Brazil. 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.",
+		description: "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. `amount_usd` is what is credited; a card issued in Brazil is charged its equivalent in Brazilian reais at the Banco Central's latest closing PTAX selling rate, and a checkout shows reais to a payer in Brazil. 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`. The card paid with there becomes the account's saved card, replacing any other. After paying, the browser returns to the console's billing page.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/users",
 		httpMethod: "post",
 		pathParams: [],
@@ -21222,7 +21236,7 @@ const routes = {
 	"set-current-user-plan": {
 		serviceClass: "Users",
 		operationId: "setCurrentUserPlan",
-		description: "Choose `free`, `pro` or `business`. A paid plan needs a saved card. An upgrade is charged at once on the saved card, in its currency, for the price difference over the rest of the month, then takes effect; the month's statement nets that payment out. A declined card leaves the plan unchanged. A downgrade takes effect when the month ends, and `next_plan` names it until then. A contract plan is changed by asking us.",
+		description: "Choose `free`, `pro` or `business`. An upgrade is charged for the price difference over the rest of the month, then takes effect; the month's statement nets that payment out. The saved card is charged at once, in its currency. With no saved card, or when the card needs authentication or is declined, nothing is charged and the answer carries a `checkout_url`: a hosted page that charges the upgrade and saves the card. The plan changes once it is paid; one left unpaid lapses at `expires_at`. A downgrade takes effect when the month ends, and `next_plan` names it until then. A contract plan is changed by asking us.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/users",
 		httpMethod: "put",
 		pathParams: [],
@@ -21237,6 +21251,24 @@ const routes = {
 			"in": "body"
 		}]
 	},
+	"get-current-user-plan-quote": {
+		serviceClass: "Users",
+		operationId: "getCurrentUserPlanQuote",
+		description: "What choosing `plan` would charge now: an upgrade's share of the rest of the month, else 0. Changes nothing.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/users",
+		httpMethod: "get",
+		pathParams: [],
+		queryParams: ["plan"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "plan",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "query"
+		}]
+	},
 	"list-webhooks": {
 		serviceClass: "Webhooks",
 		operationId: "listWebhooks",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.173.3",
+  "version": "0.174.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@naturali/sdk": "0.173.3",
+    "@naturali/sdk": "0.174.0",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",