@naturali/sdk 0.86.3 → 0.88.0

package/dist/index.cjs

@@ -1002,6 +1002,87 @@ var Channels = class {
 		});
 	}
 };
+var Admin = class {
+	/**
+	* List accounts
+	*
+	* A cursor page of every account, newest first, each with the plan it is on and the balance of its credit ledger. Needs the `admin` role.
+	* `email` narrows the page to one account. It matches the whole address case-insensitively and takes no wildcards: an operator looking for `Ana@Acme.com` finds a row stored as `ana@acme.com`, and there is no substring search across customers' addresses.
+	* An account with no subscription reads as `free` with a balance of `0`: the absence of a row is the free plan, and the least-privileged rung is also what any unresolvable lookup should answer.
+	*
+	*/
+	static listUsers(options) {
+		return (options?.client ?? client).get({
+			url: "/v1/admin/users",
+			...options
+		});
+	}
+	/**
+	* Replace a user's roles
+	*
+	* Replaces the platform roles of any user. Needs the `admin` role, and each role that changes needs the caller to hold the role that grants it (today `admin` grants `admin`). Values outside the catalog are rejected with a 400, and a caller cannot remove their own `admin` role.
+	*
+	*/
+	static updateUserRoles(options) {
+		return (options.client ?? client).put({
+			url: "/v1/admin/users/{user_id}/roles",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* 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.
+	*
+	*/
+	static grantUserPlan(options) {
+		return (options.client ?? client).put({
+			url: "/v1/admin/users/{user_id}/plan",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Read a user's credit ledger
+	*
+	* A cursor page of the account's credit lines, newest first, with the balance they sum to. Needs the `admin` role — including for the account's own owner, since the customer-facing view of a balance belongs with a billing surface this API does not serve yet.
+	* What an operator reads it for is writing a correction: the line that was wrong stays on the record, so it has to be legible before it can be compensated for.
+	*
+	*/
+	static listUserCredits(options) {
+		return (options.client ?? client).get({
+			url: "/v1/admin/users/{user_id}/credits",
+			...options
+		});
+	}
+	/**
+	* Grant a user credit
+	*
+	* Writes one `granted` line to the account's credit ledger and answers with the balance it produced. Needs the `admin` role.
+	* The ledger is append-only and the balance is its sum — there is no balance to set and no line to edit or delete. A mistake is corrected by granting a **negative** `amount_usd`, which leaves the wrong line on the record beside the one that compensates for it. Granted credit is customer-acquisition cost rather than revenue, which is why each line records its kind and the operator who authorized it.
+	* The balance this moves is not yet a ceiling anything enforces; turning it into one is a separate mechanism.
+	*
+	*/
+	static grantUserCredit(options) {
+		return (options.client ?? client).post({
+			url: "/v1/admin/users/{user_id}/credits",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Agents = class {
 	/**
 	* List agents
@@ -4097,22 +4178,6 @@ var Users = class {
 			}
 		});
 	}
-	/**
-	* Replace a user's roles
-	*
-	* Replaces the platform roles of any user. Needs the `admin` role, and each role that changes needs the caller to hold the role that grants it (today `admin` grants `admin`). Values outside the catalog are rejected with a 400, and a caller cannot remove their own `admin` role.
-	*
-	*/
-	static updateUserRoles(options) {
-		return (options.client ?? client).put({
-			url: "/v1/users/{user_id}/roles",
-			...options,
-			headers: {
-				"Content-Type": "application/json",
-				...options.headers
-			}
-		});
-	}
 };
 var Webhooks = class {
 	/**
@@ -4389,6 +4454,7 @@ const API_BASE_URL = "https://api.naturali.ai";
 */
 var NaturaliClient = class {
 	activity;
+	admin;
 	actors;
 	agents;
 	agentVersions;
@@ -4437,6 +4503,7 @@ var NaturaliClient = class {
 			}
 		}));
 		this.activity = bindResource(Activity, this.http);
+		this.admin = bindResource(Admin, this.http);
 		this.actors = bindResource(Actors, this.http);
 		this.agents = bindResource(Agents, this.http);
 		this.agentVersions = bindResource(AgentVersions, this.http);
@@ -4479,6 +4546,7 @@ var NaturaliClient = class {
 //#endregion
 exports.Activity = Activity;
 exports.Actors = Actors;
+exports.Admin = Admin;
 exports.AgentVersions = AgentVersions;
 exports.Agents = Agents;
 exports.AiProviders = AiProviders;