@naturali/sdk 0.96.0 → 0.98.0

package/dist/index.d.cts

@@ -545,9 +545,9 @@ type CreditEntry = {
    */
   id: string;
   /**
-   * Where the credit came from, which is also its accounting line. `included` is a plan's monthly allowance and does not carry past the cycle; `purchased` is a top-up and never expires; `granted` is credit naturali gave away. Only `granted` is written today.
+   * Where the credit came from, which is also its accounting line. `included` is a plan's monthly allowance and does not carry past the cycle; `purchased` is a top-up and never expires; `granted` is credit naturali gave away. `usage` is managed model spend, debited from the meter — always negative, and the only kind no person writes.
    */
-  kind: 'included' | 'purchased' | 'granted';
+  kind: 'included' | 'purchased' | 'granted' | 'usage';
   /**
    * US dollars, signed: positive added credit, negative corrected an earlier line.
    */
@@ -556,6 +556,10 @@ type CreditEntry = {
    * Why it was granted, as the operator wrote it.
    */
   reason: string | null;
+  /**
+   * The project whose metered usage produced this line, for a `usage` debit. Null for every other kind: a grant, a top-up and an allowance are to the account rather than to one of its projects.
+   */
+  project_id: string | null;
   /**
    * The operator who authorized it. Null for credit no person granted — a plan's included allowance, or a payer's own top-up.
    */
@@ -565,9 +569,13 @@ type CreditEntry = {
 type CreditEntryPage = {
   data: Array<CreditEntry>;
   /**
-   * The sum of the whole ledger, not only of this page.
+   * The sum of the whole ledger, not only of this page. Spend is included as it is reconciled, so read it with `spend_reconciled_at`.
    */
   credit_balance_usd: number;
+  /**
+   * When this account's managed spend was last compared against the meter — the oldest such moment across the projects it pays for, so it describes the whole balance. Null when at least one project has never been reconciled, which is also true of an account with none.
+   */
+  spend_reconciled_at: Date | null;
   /**
    * Pass as `cursor` for the next page; null on the last one.
    */

package/dist/index.d.mts

@@ -545,9 +545,9 @@ type CreditEntry = {
    */
   id: string;
   /**
-   * Where the credit came from, which is also its accounting line. `included` is a plan's monthly allowance and does not carry past the cycle; `purchased` is a top-up and never expires; `granted` is credit naturali gave away. Only `granted` is written today.
+   * Where the credit came from, which is also its accounting line. `included` is a plan's monthly allowance and does not carry past the cycle; `purchased` is a top-up and never expires; `granted` is credit naturali gave away. `usage` is managed model spend, debited from the meter — always negative, and the only kind no person writes.
    */
-  kind: 'included' | 'purchased' | 'granted';
+  kind: 'included' | 'purchased' | 'granted' | 'usage';
   /**
    * US dollars, signed: positive added credit, negative corrected an earlier line.
    */
@@ -556,6 +556,10 @@ type CreditEntry = {
    * Why it was granted, as the operator wrote it.
    */
   reason: string | null;
+  /**
+   * The project whose metered usage produced this line, for a `usage` debit. Null for every other kind: a grant, a top-up and an allowance are to the account rather than to one of its projects.
+   */
+  project_id: string | null;
   /**
    * The operator who authorized it. Null for credit no person granted — a plan's included allowance, or a payer's own top-up.
    */
@@ -565,9 +569,13 @@ type CreditEntry = {
 type CreditEntryPage = {
   data: Array<CreditEntry>;
   /**
-   * The sum of the whole ledger, not only of this page.
+   * The sum of the whole ledger, not only of this page. Spend is included as it is reconciled, so read it with `spend_reconciled_at`.
    */
   credit_balance_usd: number;
+  /**
+   * When this account's managed spend was last compared against the meter — the oldest such moment across the projects it pays for, so it describes the whole balance. Null when at least one project has never been reconciled, which is also true of an account with none.
+   */
+  spend_reconciled_at: Date | null;
   /**
    * Pass as `cursor` for the next page; null on the last one.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.96.0",
+  "version": "0.98.0",
   "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.96.0"
+    "@naturali/api": "0.98.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",