@naturali/sdk 0.103.0 → 0.103.2

package/dist/index.cjs

@@ -1070,7 +1070,7 @@ var Admin = class {
 	/**
 	* 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.
+	* 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, who reads their own balance at `GET /v1/users/me/billing` rather than here. That answers what is left; this is the line-by-line record behind it.
 	* 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.
 	*
 	*/
@@ -2087,6 +2087,11 @@ var Embeddings = class {
 	* Provide `input` for a single text or `inputs` for a batch. At least one is required.
 	* Returns `embedding` when `input` is used, and `embeddings` when `inputs` is used.
 	*
+	* `project_id` names the project the call's token usage is metered against, so
+	* embedding spend reaches the usage rollup and the project's `cost_usd` / `tokens`
+	* quotas. A project-scoped credential supplies its own project; a call that names
+	* none and is bound to none is served but not metered.
+	*
 	*/
 	static createEmbeddings(options) {
 		return (options.client ?? client).post({

package/dist/index.d.cts

@@ -11391,6 +11391,10 @@ type CreateEmbeddingsErrors = {
    * Unauthorized
    */
   401: ErrorResponse;
+  /**
+   * The caller cannot write to the named `project_id`
+   */
+  403: ErrorResponse;
   /**
    * Embedding service not configured
    */
@@ -19055,7 +19059,7 @@ declare class Admin {
   /**
    * 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.
+   * 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, who reads their own balance at `GET /v1/users/me/billing` rather than here. That answers what is left; this is the line-by-line record behind it.
    * 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.
    *
    */
@@ -19589,6 +19593,11 @@ declare class Embeddings {
    * Provide `input` for a single text or `inputs` for a batch. At least one is required.
    * Returns `embedding` when `input` is used, and `embeddings` when `inputs` is used.
    *
+   * `project_id` names the project the call's token usage is metered against, so
+   * embedding spend reaches the usage rollup and the project's `cost_usd` / `tokens`
+   * quotas. A project-scoped credential supplies its own project; a call that names
+   * none and is bound to none is served but not metered.
+   *
    */
   static createEmbeddings<ThrowOnError extends boolean = false>(options: Options<CreateEmbeddingsData, ThrowOnError>): RequestResult<CreateEmbeddingsResponses, CreateEmbeddingsErrors, ThrowOnError>;
 }

package/dist/index.d.mts

@@ -11391,6 +11391,10 @@ type CreateEmbeddingsErrors = {
    * Unauthorized
    */
   401: ErrorResponse;
+  /**
+   * The caller cannot write to the named `project_id`
+   */
+  403: ErrorResponse;
   /**
    * Embedding service not configured
    */
@@ -19055,7 +19059,7 @@ declare class Admin {
   /**
    * 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.
+   * 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, who reads their own balance at `GET /v1/users/me/billing` rather than here. That answers what is left; this is the line-by-line record behind it.
    * 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.
    *
    */
@@ -19589,6 +19593,11 @@ declare class Embeddings {
    * Provide `input` for a single text or `inputs` for a batch. At least one is required.
    * Returns `embedding` when `input` is used, and `embeddings` when `inputs` is used.
    *
+   * `project_id` names the project the call's token usage is metered against, so
+   * embedding spend reaches the usage rollup and the project's `cost_usd` / `tokens`
+   * quotas. A project-scoped credential supplies its own project; a call that names
+   * none and is bound to none is served but not metered.
+   *
    */
   static createEmbeddings<ThrowOnError extends boolean = false>(options: Options<CreateEmbeddingsData, ThrowOnError>): RequestResult<CreateEmbeddingsResponses, CreateEmbeddingsErrors, ThrowOnError>;
 }

package/dist/index.mjs

@@ -1069,7 +1069,7 @@ var Admin = class {
 	/**
 	* 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.
+	* 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, who reads their own balance at `GET /v1/users/me/billing` rather than here. That answers what is left; this is the line-by-line record behind it.
 	* 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.
 	*
 	*/
@@ -2086,6 +2086,11 @@ var Embeddings = class {
 	* Provide `input` for a single text or `inputs` for a batch. At least one is required.
 	* Returns `embedding` when `input` is used, and `embeddings` when `inputs` is used.
 	*
+	* `project_id` names the project the call's token usage is metered against, so
+	* embedding spend reaches the usage rollup and the project's `cost_usd` / `tokens`
+	* quotas. A project-scoped credential supplies its own project; a call that names
+	* none and is bound to none is served but not metered.
+	*
 	*/
 	static createEmbeddings(options) {
 		return (options.client ?? client).post({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.103.0",
+  "version": "0.103.2",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -37,7 +37,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/api": "0.103.0"
+    "@naturali/api": "0.103.2"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",