@naturali/sdk 0.157.1 → 0.158.0

package/dist/index.cjs

@@ -1095,7 +1095,7 @@ var Admin = class {
 	*
 	* 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.
+	* An upgrade takes effect at once. A downgrade is the same call with a lower rung and takes effect when the month turns: until then `plan` stays the rung held and `next_plan` names the new one. At the turn, active channels past the new rung's allowance are disabled, oldest first; an upgrade re-enables them.
 	* A rung whose content-retention window a contract sets — `enterprise` — **requires `retention_days`**, since nothing else can answer what that window is and an unanswered one bounds nothing. Every other rung sets its own and refuses the field.
 	*
 	*/

package/dist/index.d.cts

@@ -541,9 +541,13 @@ type User = {
 };
 type AdminUser = User & {
   /**
-   * The rung of the infra ladder the account is on. `free` for an account with no subscription. It gates the feature lines and the resource counts of the pricing table.
+   * The rung in effect: the highest the account held this month. `free` for an account with no subscription. It gates the feature lines and the resource counts of the pricing table.
    */
   plan: 'free' | 'pro' | 'business' | 'enterprise';
+  /**
+   * The rung the account moves to when the month turns; differs from `plan` only while a downgrade is pending.
+   */
+  next_plan: 'free' | 'pro' | 'business' | 'enterprise';
   /**
    * The longest content-retention window this account's projects may keep content for, in days. On a plan whose window a contract sets, this is the figure recorded with the grant; `null` means nothing bounds it. Resolved the same way the refusal is — the widest window held during the current billing cycle.
    */
@@ -616,9 +620,13 @@ type PlanEvent = {
 type PlanEventPage = {
   data: Array<PlanEvent>;
   /**
-   * The rung the account is on now — its newest line, or `free` when it has no history.
+   * The rung in effect: the highest held this month, or `free` when the account has no history.
    */
   plan: 'free' | 'pro' | 'business' | 'enterprise';
+  /**
+   * The newest line: the rung the account moves to when the month turns.
+   */
+  next_plan: 'free' | 'pro' | 'business' | 'enterprise';
   /**
    * Pass as `cursor` for the next page; null on the last page.
    */
@@ -7771,9 +7779,13 @@ type UserUpdate = {
 };
 type UserBilling = {
   /**
-   * The rung of the infra subscription this account is on. `free` for an account with no subscription, which is also the least-privileged rung. It gates the feature lines and the resource counts of the pricing table.
+   * The rung of the infra subscription in effect for this account: the highest it held this month. `free` for an account with no subscription, which is also the least-privileged rung. It gates the feature lines and the resource counts of the pricing table.
    */
   plan: 'free' | 'pro' | 'business' | 'enterprise';
+  /**
+   * The rung the account moves to when the month turns. It differs from `plan` only while a downgrade is pending: a downgrade takes effect at the end of the month, an upgrade at once.
+   */
+  next_plan: 'free' | 'pro' | 'business' | 'enterprise';
   /**
    * The longest window a project of this account may keep trace and generation content for, in days. A `PATCH` asking for a wider one — `null` included, which keeps content indefinitely — is refused with `403 plan_limit_reached`; anything shorter is always allowed. On a plan whose window a contract sets, this is that contract's figure, and `null` means nothing bounds it. A plan change that shortens the window applies at the end of the billing cycle, so this reads as the widest window held during the current one.
    */
@@ -23645,7 +23657,7 @@ export declare class Admin {
    *
    * 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.
+   * An upgrade takes effect at once. A downgrade is the same call with a lower rung and takes effect when the month turns: until then `plan` stays the rung held and `next_plan` names the new one. At the turn, active channels past the new rung's allowance are disabled, oldest first; an upgrade re-enables them.
    * A rung whose content-retention window a contract sets — `enterprise` — **requires `retention_days`**, since nothing else can answer what that window is and an unanswered one bounds nothing. Every other rung sets its own and refuses the field.
    *
    */

package/dist/index.d.mts

@@ -541,9 +541,13 @@ type User = {
 };
 type AdminUser = User & {
   /**
-   * The rung of the infra ladder the account is on. `free` for an account with no subscription. It gates the feature lines and the resource counts of the pricing table.
+   * The rung in effect: the highest the account held this month. `free` for an account with no subscription. It gates the feature lines and the resource counts of the pricing table.
    */
   plan: 'free' | 'pro' | 'business' | 'enterprise';
+  /**
+   * The rung the account moves to when the month turns; differs from `plan` only while a downgrade is pending.
+   */
+  next_plan: 'free' | 'pro' | 'business' | 'enterprise';
   /**
    * The longest content-retention window this account's projects may keep content for, in days. On a plan whose window a contract sets, this is the figure recorded with the grant; `null` means nothing bounds it. Resolved the same way the refusal is — the widest window held during the current billing cycle.
    */
@@ -616,9 +620,13 @@ type PlanEvent = {
 type PlanEventPage = {
   data: Array<PlanEvent>;
   /**
-   * The rung the account is on now — its newest line, or `free` when it has no history.
+   * The rung in effect: the highest held this month, or `free` when the account has no history.
    */
   plan: 'free' | 'pro' | 'business' | 'enterprise';
+  /**
+   * The newest line: the rung the account moves to when the month turns.
+   */
+  next_plan: 'free' | 'pro' | 'business' | 'enterprise';
   /**
    * Pass as `cursor` for the next page; null on the last page.
    */
@@ -7771,9 +7779,13 @@ type UserUpdate = {
 };
 type UserBilling = {
   /**
-   * The rung of the infra subscription this account is on. `free` for an account with no subscription, which is also the least-privileged rung. It gates the feature lines and the resource counts of the pricing table.
+   * The rung of the infra subscription in effect for this account: the highest it held this month. `free` for an account with no subscription, which is also the least-privileged rung. It gates the feature lines and the resource counts of the pricing table.
    */
   plan: 'free' | 'pro' | 'business' | 'enterprise';
+  /**
+   * The rung the account moves to when the month turns. It differs from `plan` only while a downgrade is pending: a downgrade takes effect at the end of the month, an upgrade at once.
+   */
+  next_plan: 'free' | 'pro' | 'business' | 'enterprise';
   /**
    * The longest window a project of this account may keep trace and generation content for, in days. A `PATCH` asking for a wider one — `null` included, which keeps content indefinitely — is refused with `403 plan_limit_reached`; anything shorter is always allowed. On a plan whose window a contract sets, this is that contract's figure, and `null` means nothing bounds it. A plan change that shortens the window applies at the end of the billing cycle, so this reads as the widest window held during the current one.
    */
@@ -23645,7 +23657,7 @@ export declare class Admin {
    *
    * 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.
+   * An upgrade takes effect at once. A downgrade is the same call with a lower rung and takes effect when the month turns: until then `plan` stays the rung held and `next_plan` names the new one. At the turn, active channels past the new rung's allowance are disabled, oldest first; an upgrade re-enables them.
    * A rung whose content-retention window a contract sets — `enterprise` — **requires `retention_days`**, since nothing else can answer what that window is and an unanswered one bounds nothing. Every other rung sets its own and refuses the field.
    *
    */

package/dist/index.mjs

@@ -1094,7 +1094,7 @@ var Admin = class {
 	*
 	* 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.
+	* An upgrade takes effect at once. A downgrade is the same call with a lower rung and takes effect when the month turns: until then `plan` stays the rung held and `next_plan` names the new one. At the turn, active channels past the new rung's allowance are disabled, oldest first; an upgrade re-enables them.
 	* A rung whose content-retention window a contract sets — `enterprise` — **requires `retention_days`**, since nothing else can answer what that window is and an unanswered one bounds nothing. Every other rung sets its own and refuses the field.
 	*
 	*/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.157.1",
+  "version": "0.158.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.157.1",
+    "@naturali/api": "0.158.0",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",