@naturali/cli 0.93.0 → 0.95.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.93.0";
+var version = "0.95.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -920,6 +920,9 @@ var Channels = class {
 	* 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.
+	*
 	*/
 	static createChannel(options) {
 		return (options.client ?? client).post({
@@ -1051,11 +1054,24 @@ var Admin = class {
 		});
 	}
 	/**
+	* Read a user's plan history
+	*
+	* A cursor page of the account's plan history, newest first, and the rung it is on now. Needs the `admin` role.
+	* The history is append-only, so this is the record of who put the account where and why — nothing edits or removes a line. `plan` at the top level is the same value every entitlement check resolves, so one response answers both "what plan is this?" and "how did it get there?".
+	*
+	*/
+	static listUserPlanHistory(options) {
+		return (options.client ?? client).get({
+			url: "/v1/admin/users/{user_id}/plan",
+			...options
+		});
+	}
+	/**
 	* Grant a user a plan
 	*
 	* Puts the account on a rung of the infra ladder. Needs the `admin` role.
-	* `PUT` because a user has exactly one plan: setting it twice leaves one subscription, never two (two rows for one payer is a state where "which plan is this?" has no answer).
-	* The rung is recorded and read back, and **nothing enforces it yet** — no route refuses a feature for the plan an account is on. Downgrading is the same call with a lower rung, and what becomes of resources a lower plan would not hold is a separate mechanism that is not built.
+	* `PUT` because an account is on exactly one rung at a time, but the change is **recorded rather than overwritten**: the plan history is append-only and the newest line is the account's plan. Setting the rung it already holds still writes a line — a re-confirmation is an act worth a record, and the `reason` given with it would otherwise have nowhere to go. Read the history back with `GET` on this path.
+	* The rung is what the feature gate and the resource caps resolve against. Downgrading is the same call with a lower rung; what becomes of resources a lower plan would not hold is a separate mechanism that is not built.
 	*
 	*/
 	static grantUserPlan(options) {
@@ -3442,6 +3458,9 @@ var Projects = class {
 	* Create a project
 	*
 	* Creates a project (one per client or per environment).
+	*
+	* Your plan limits how many projects you may own. At the limit this responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit`. An archived project still counts — archiving keeps every resource, so it frees nothing; deleting a project does.
+	*
 	*/
 	static createProject(options) {
 		return (options.client ?? client).post({
@@ -5635,27 +5654,69 @@ const routes = {
 			"in": "body"
 		}]
 	},
+	"list-user-plan-history": {
+		serviceClass: "Admin",
+		operationId: "listUserPlanHistory",
+		description: "A cursor page of the account's plan history, newest first, and the rung it is on now. Needs the `admin` role. The history is append-only, so this is the record of who put the account where and why — nothing edits or removes a line. `plan` at the top level is the same value every entitlement check resolves, so one response answers both \"what plan is this?\" and \"how did it get there?\".",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/admin",
+		httpMethod: "get",
+		pathParams: ["user_id"],
+		queryParams: ["limit", "cursor"],
+		flags: [
+			{
+				"name": "user_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "The `next_cursor` of the previous page.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
 	"grant-user-plan": {
 		serviceClass: "Admin",
 		operationId: "grantUserPlan",
-		description: "Puts the account on a rung of the infra ladder. Needs the `admin` role. `PUT` because a user has exactly one plan: setting it twice leaves one subscription, never two (two rows for one payer is a state where \"which plan is this?\" has no answer). The rung is recorded and read back, and **nothing enforces it yet** — no route refuses a feature for the plan an account is on. Downgrading is the same call with a lower rung, and what becomes of resources a lower plan would not hold is a separate mechanism that is not built.",
+		description: "Puts the account on a rung of the infra ladder. Needs the `admin` role. `PUT` because an account is on exactly one rung at a time, but the change is **recorded rather than overwritten**: the plan history is append-only and the newest line is the account's plan. Setting the rung it already holds still writes a line — a re-confirmation is an act worth a record, and the `reason` given with it would otherwise have nowhere to go. Read the history back with `GET` on this path. The rung is what the feature gate and the resource caps resolve against. Downgrading is the same call with a lower rung; what becomes of resources a lower plan would not hold is a separate mechanism that is not built.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/admin",
 		httpMethod: "put",
 		pathParams: ["user_id"],
 		queryParams: [],
-		flags: [{
-			"name": "user_id",
-			"description": "",
-			"required": true,
-			"type": "string",
-			"in": "path"
-		}, {
-			"name": "plan",
-			"description": "The rung to put the account on.",
-			"required": true,
-			"type": "string",
-			"in": "body"
-		}]
+		flags: [
+			{
+				"name": "user_id",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "plan",
+				"description": "The rung to put the account on.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "reason",
+				"description": "Why the account was moved. Recorded on the line and never edited, so it is the only account of intent the history carries.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
 	},
 	"list-user-credits": {
 		serviceClass: "Admin",
@@ -8073,7 +8134,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.",
+		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.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/channels",
 		httpMethod: "post",
 		pathParams: ["project_id"],
@@ -13051,7 +13112,7 @@ const routes = {
 	"create-project": {
 		serviceClass: "Projects",
 		operationId: "createProject",
-		description: "Creates a project (one per client or per environment).",
+		description: "Creates a project (one per client or per environment). Your plan limits how many projects you may own. At the limit this responds `403` with `plan_limit_reached`, whose `details` carry the `plan` and the `limit`. An archived project still counts — archiving keeps every resource, so it frees nothing; deleting a project does.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/projects",
 		httpMethod: "post",
 		pathParams: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.93.0",
+  "version": "0.95.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/sdk": "0.93.0"
+    "@naturali/sdk": "0.95.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",