@flashbacktech/tsclient 0.4.35 → 0.4.37

package/dist/index.d.cts

@@ -668,6 +668,10 @@ interface ListChatSessionsResponse {
 interface ListChatSessionsQuery {
     cursor?: string;
     limit?: number;
+    /** Inclusive lower bound on `created_at`, RFC3339 timestamp. */
+    from?: string;
+    /** Exclusive upper bound on `created_at`, RFC3339 timestamp. */
+    to?: string;
 }
 interface GetChatSessionResponse {
     session: ChatSession;
@@ -1535,8 +1539,8 @@ interface SubscriptionPeriod {
     currency: string;
     interval: string;
     intervalCount?: number;
-    /** Per-period grant in USD-cents. 0 means no grant attached. */
-    creditsGrantedCents: number;
+    /** Per-period grant in USD micros. 0 means no grant attached. */
+    creditsGrantedMicros: number;
 }
 interface SubscriptionCapability {
     key: string;
@@ -1549,8 +1553,8 @@ interface Subscription {
     description?: string;
     periods: SubscriptionPeriod[];
     capabilities: SubscriptionCapability[];
-    /** Plan-level 24h rolling debit cap in USD-cents. null = no cap. */
-    dailyCreditCapCents?: number | null;
+    /** Plan-level 24h rolling debit cap in USD micros. null = no cap. */
+    dailyCreditCapMicros?: number | null;
 }
 interface OrgSubscription {
     id: string;
@@ -1596,28 +1600,24 @@ interface ListPaymentsResponse {
 /**
  * Org credit balance — two-bucket forfeit model (billing-v1).
  *
- *  - permanentCreditCents:        PAYG (credit-pack) bucket. Never expires.
- *  - subscriptionCreditCents:     Current subscription cycle. Forfeit on
- *                                  renewal; expires at subscriptionCreditExpiresAt.
- *  - subscriptionCreditExpiresAt: ISO-8601; null when no subscription is active.
- *  - totalActiveCents:            Pre-computed sum = permanent +
- *                                  (subscription if not expired). Use this
- *                                  to drive the daily-cap progress bar
- *                                  and "out of credits" check.
- *
- * Format `(value / 100).toFixed(2)` for display. Drain order is
- * subscription bucket first, then permanent — visualise as a single
- * pool with a small "expires soon" tag for the subscription slice.
+ *  - permanentCreditMicros:        PAYG (credit-pack) bucket. Never expires.
+ *  - subscriptionCreditMicros:     Current subscription cycle. Forfeit on
+ *                                   renewal; expires at subscriptionCreditExpiresAt.
+ *  - subscriptionCreditExpiresAt:  ISO-8601; null when no subscription is active.
+ *  - totalActiveMicros:            Pre-computed sum = permanent +
+ *                                   (subscription if not expired). Use this
+ *                                   to drive the daily-cap progress bar
+ *                                   and "out of credits" check.
  *
- * Legacy `realtimeBalance` / `pendingConsumption` / `breakdown` /
- * `dateBalance` fields were dropped: the chat-loop debits in real-time
- * so there is no notion of "pending".
+ * Format `(value / 1_000_000).toFixed(2)` for dollar layouts. Drain
+ * order is subscription bucket first, then permanent — visualise as a
+ * single pool with a small "expires soon" tag for the subscription slice.
  */
 interface CreditBalance {
-    permanentCreditCents: number;
-    subscriptionCreditCents: number;
+    permanentCreditMicros: number;
+    subscriptionCreditMicros: number;
     subscriptionCreditExpiresAt: string | null;
-    totalActiveCents: number;
+    totalActiveMicros: number;
 }
 /** Source of a credit ledger row. Matches the kind enum from migration 0017. */
 type CreditTransactionKind = 'grant_initial' | 'grant_renewal' | 'grant_pack' | 'debit_llm' | 'debit_sandbox' | 'admin_adjust';
@@ -1625,8 +1625,8 @@ type CreditTransactionKind = 'grant_initial' | 'grant_renewal' | 'grant_pack' |
 type CreditTransactionType = 'consumption' | 'purchase' | 'grant';
 interface CreditTransaction {
     id: string;
-    /** Signed amount in USD-cents. Negative = debit. */
-    creditAmountCents: number;
+    /** Signed amount in USD micros. Negative = debit. */
+    creditAmountMicros: number;
     kind: CreditTransactionKind;
     type: CreditTransactionType;
     description?: string;
@@ -1653,36 +1653,39 @@ interface ListCreditsTransactionsResponse {
         limit: number;
     };
 }
-/** One month's bucket of credit activity. All money values in USD-cents. */
+/** One month's bucket of credit activity. All money values in USD micros. */
 interface MonthlyCreditStats {
     month: string;
-    consumptionCents: number;
-    purchasesCents: number;
-    grantsCents: number;
-    balanceCents: number;
+    consumptionMicros: number;
+    purchasesMicros: number;
+    grantsMicros: number;
+    balanceMicros: number;
 }
 /**
  * "Other amount" PAYG purchase config, served by
  * GET /credits/packs/custom-config. Disabled =>
- * `{ enabled: false, minCents: 0, maxCents: 0, presetCents: [] }` so
+ * `{ enabled: false, minMicros: 0, maxMicros: 0, presetMicros: [] }` so
  * the frontend can hide the tile cleanly without nil checks.
  */
 interface CustomCreditPurchaseConfig {
     enabled: boolean;
-    minCents: number;
-    maxCents: number;
-    /** Suggested one-click amounts (in cents) for the "Other" tile. */
-    presetCents: number[];
+    minMicros: number;
+    maxMicros: number;
+    /** Suggested one-click amounts (in USD micros) for the "Other" tile. */
+    presetMicros: number[];
 }
 /**
- * Body for POST /credits/packs/buy-custom. `amountCents` is the
- * arbitrary dollar amount the user typed, converted to USD-cents
+ * Body for POST /credits/packs/buy-custom. `amountMicros` is the
+ * arbitrary dollar amount the user typed, converted to USD micros
  * before the API call. Server enforces `min <= amount <= max`.
  * Credit ratio is 1:1 (pay $X, get $X of credits in the permanent
- * bucket).
+ * bucket). Stripe charges in cents — the backend divides by 10000 at
+ * the API boundary, so amounts that aren't multiples of 10000 micros
+ * incur tiny rounding loss at the Stripe step (presetMicros + minMicros
+ * should be 10000-aligned).
  */
 interface BuyCustomCreditRequest {
-    amountCents: number;
+    amountMicros: number;
 }
 /** Response from POST /credits/packs/buy-custom. Mirrors the fixed-pack response. */
 interface BuyCustomCreditResponse {
@@ -1701,12 +1704,12 @@ type ChatBillingRefuseCode = 'out_of_credits' | 'daily_cap_reached' | 'no_subscr
 interface ChatBillingRefuseError {
     message: string;
     code: ChatBillingRefuseCode;
-    permanentCreditCents: number;
-    subscriptionCreditCents: number;
+    permanentCreditMicros: number;
+    subscriptionCreditMicros: number;
     subscriptionCreditExpiresAt: string | null;
-    totalActiveCents: number;
-    dailyCapCents: number;
-    debitedLast24hCents: number;
+    totalActiveMicros: number;
+    dailyCapMicros: number;
+    debitedLast24hMicros: number;
 }
 
 declare class SubscriptionsClient {

package/dist/index.d.ts

@@ -668,6 +668,10 @@ interface ListChatSessionsResponse {
 interface ListChatSessionsQuery {
     cursor?: string;
     limit?: number;
+    /** Inclusive lower bound on `created_at`, RFC3339 timestamp. */
+    from?: string;
+    /** Exclusive upper bound on `created_at`, RFC3339 timestamp. */
+    to?: string;
 }
 interface GetChatSessionResponse {
     session: ChatSession;
@@ -1535,8 +1539,8 @@ interface SubscriptionPeriod {
     currency: string;
     interval: string;
     intervalCount?: number;
-    /** Per-period grant in USD-cents. 0 means no grant attached. */
-    creditsGrantedCents: number;
+    /** Per-period grant in USD micros. 0 means no grant attached. */
+    creditsGrantedMicros: number;
 }
 interface SubscriptionCapability {
     key: string;
@@ -1549,8 +1553,8 @@ interface Subscription {
     description?: string;
     periods: SubscriptionPeriod[];
     capabilities: SubscriptionCapability[];
-    /** Plan-level 24h rolling debit cap in USD-cents. null = no cap. */
-    dailyCreditCapCents?: number | null;
+    /** Plan-level 24h rolling debit cap in USD micros. null = no cap. */
+    dailyCreditCapMicros?: number | null;
 }
 interface OrgSubscription {
     id: string;
@@ -1596,28 +1600,24 @@ interface ListPaymentsResponse {
 /**
  * Org credit balance — two-bucket forfeit model (billing-v1).
  *
- *  - permanentCreditCents:        PAYG (credit-pack) bucket. Never expires.
- *  - subscriptionCreditCents:     Current subscription cycle. Forfeit on
- *                                  renewal; expires at subscriptionCreditExpiresAt.
- *  - subscriptionCreditExpiresAt: ISO-8601; null when no subscription is active.
- *  - totalActiveCents:            Pre-computed sum = permanent +
- *                                  (subscription if not expired). Use this
- *                                  to drive the daily-cap progress bar
- *                                  and "out of credits" check.
- *
- * Format `(value / 100).toFixed(2)` for display. Drain order is
- * subscription bucket first, then permanent — visualise as a single
- * pool with a small "expires soon" tag for the subscription slice.
+ *  - permanentCreditMicros:        PAYG (credit-pack) bucket. Never expires.
+ *  - subscriptionCreditMicros:     Current subscription cycle. Forfeit on
+ *                                   renewal; expires at subscriptionCreditExpiresAt.
+ *  - subscriptionCreditExpiresAt:  ISO-8601; null when no subscription is active.
+ *  - totalActiveMicros:            Pre-computed sum = permanent +
+ *                                   (subscription if not expired). Use this
+ *                                   to drive the daily-cap progress bar
+ *                                   and "out of credits" check.
  *
- * Legacy `realtimeBalance` / `pendingConsumption` / `breakdown` /
- * `dateBalance` fields were dropped: the chat-loop debits in real-time
- * so there is no notion of "pending".
+ * Format `(value / 1_000_000).toFixed(2)` for dollar layouts. Drain
+ * order is subscription bucket first, then permanent — visualise as a
+ * single pool with a small "expires soon" tag for the subscription slice.
  */
 interface CreditBalance {
-    permanentCreditCents: number;
-    subscriptionCreditCents: number;
+    permanentCreditMicros: number;
+    subscriptionCreditMicros: number;
     subscriptionCreditExpiresAt: string | null;
-    totalActiveCents: number;
+    totalActiveMicros: number;
 }
 /** Source of a credit ledger row. Matches the kind enum from migration 0017. */
 type CreditTransactionKind = 'grant_initial' | 'grant_renewal' | 'grant_pack' | 'debit_llm' | 'debit_sandbox' | 'admin_adjust';
@@ -1625,8 +1625,8 @@ type CreditTransactionKind = 'grant_initial' | 'grant_renewal' | 'grant_pack' |
 type CreditTransactionType = 'consumption' | 'purchase' | 'grant';
 interface CreditTransaction {
     id: string;
-    /** Signed amount in USD-cents. Negative = debit. */
-    creditAmountCents: number;
+    /** Signed amount in USD micros. Negative = debit. */
+    creditAmountMicros: number;
     kind: CreditTransactionKind;
     type: CreditTransactionType;
     description?: string;
@@ -1653,36 +1653,39 @@ interface ListCreditsTransactionsResponse {
         limit: number;
     };
 }
-/** One month's bucket of credit activity. All money values in USD-cents. */
+/** One month's bucket of credit activity. All money values in USD micros. */
 interface MonthlyCreditStats {
     month: string;
-    consumptionCents: number;
-    purchasesCents: number;
-    grantsCents: number;
-    balanceCents: number;
+    consumptionMicros: number;
+    purchasesMicros: number;
+    grantsMicros: number;
+    balanceMicros: number;
 }
 /**
  * "Other amount" PAYG purchase config, served by
  * GET /credits/packs/custom-config. Disabled =>
- * `{ enabled: false, minCents: 0, maxCents: 0, presetCents: [] }` so
+ * `{ enabled: false, minMicros: 0, maxMicros: 0, presetMicros: [] }` so
  * the frontend can hide the tile cleanly without nil checks.
  */
 interface CustomCreditPurchaseConfig {
     enabled: boolean;
-    minCents: number;
-    maxCents: number;
-    /** Suggested one-click amounts (in cents) for the "Other" tile. */
-    presetCents: number[];
+    minMicros: number;
+    maxMicros: number;
+    /** Suggested one-click amounts (in USD micros) for the "Other" tile. */
+    presetMicros: number[];
 }
 /**
- * Body for POST /credits/packs/buy-custom. `amountCents` is the
- * arbitrary dollar amount the user typed, converted to USD-cents
+ * Body for POST /credits/packs/buy-custom. `amountMicros` is the
+ * arbitrary dollar amount the user typed, converted to USD micros
  * before the API call. Server enforces `min <= amount <= max`.
  * Credit ratio is 1:1 (pay $X, get $X of credits in the permanent
- * bucket).
+ * bucket). Stripe charges in cents — the backend divides by 10000 at
+ * the API boundary, so amounts that aren't multiples of 10000 micros
+ * incur tiny rounding loss at the Stripe step (presetMicros + minMicros
+ * should be 10000-aligned).
  */
 interface BuyCustomCreditRequest {
-    amountCents: number;
+    amountMicros: number;
 }
 /** Response from POST /credits/packs/buy-custom. Mirrors the fixed-pack response. */
 interface BuyCustomCreditResponse {
@@ -1701,12 +1704,12 @@ type ChatBillingRefuseCode = 'out_of_credits' | 'daily_cap_reached' | 'no_subscr
 interface ChatBillingRefuseError {
     message: string;
     code: ChatBillingRefuseCode;
-    permanentCreditCents: number;
-    subscriptionCreditCents: number;
+    permanentCreditMicros: number;
+    subscriptionCreditMicros: number;
     subscriptionCreditExpiresAt: string | null;
-    totalActiveCents: number;
-    dailyCapCents: number;
-    debitedLast24hCents: number;
+    totalActiveMicros: number;
+    dailyCapMicros: number;
+    debitedLast24hMicros: number;
 }
 
 declare class SubscriptionsClient {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flashbacktech/tsclient",
-  "version": "0.4.35",
+  "version": "0.4.37",
   "description": "TypeScript client for the cloud-agent platform API.",
   "type": "module",
   "sideEffects": false,