@flashbacktech/flashbackclient 0.2.54 → 0.2.55

package/dist/api/client.d.ts

@@ -21,7 +21,7 @@ import { AiLlmStatsResponse, CreateAiLlmRequest, CreateAiLlmResponse, DeleteAiLl
 import { CreatePolicyRequest, GetPoliciesQuery, GetPolicyViolationsQuery, GetPolicyViolationsResponse, GetPolicyAlertsQuery, GetPolicyAlertsResponse, PolicyDTO, UpdatePolicyRequest, PolicyValidationRequest, PolicyValidationResponse, PolicyRecommendationRequest, PolicyRecommendationResponse } from './types/ai/policy';
 import { CreateConversationRequest, CreateConversationResponse, SendPromptRequest, SendPromptResponse, GetConversationsRequest, GetConversationsResponse, GetConversationMessagesResponse, GetConversationMessagesRequest, DeleteConversationRequest, DeleteConversationResponse } from './types/ai/conversation';
 import { GetLinksRequest, GetLinksResponse, CreateLinkRequest, CreateLinkResponse, UpdateLinkRequest, UpdateLinkResponse, DeleteLinkResponse, GetLinkByTokenResponse } from './types/platform/links';
-import { GetCreditsBalanceResponse, GetCreditsTransactionsRequest, GetCreditsTransactionsResponse, GetCreditsConsumptionRequest, GetCreditsConsumptionResponse, BuyCreditsPackRequest, BuyCreditsPackResponse, GetCreditsPacksResponse, GetCreditsRatesResponse } from './types/platform/credits';
+import { GetCreditsBalanceResponse, GetCreditsTransactionsRequest, GetCreditsTransactionsResponse, GetCreditsConsumptionRequest, GetCreditsConsumptionResponse, BuyCreditsPackRequest, BuyCreditsPackResponse, GetCreditsPacksResponse, GetCreditsRatesResponse, GetCreditsMonthlyStatsRequest, GetCreditsMonthlyStatsResponse } from './types/platform/credits';
 interface ErrorResponse {
     message?: string;
     [key: string]: any;
@@ -282,5 +282,7 @@ export declare class ApiClient implements IApiClient {
     buyCreditsPack: (body: BuyCreditsPackRequest) => Promise<BuyCreditsPackResponse>;
     getCreditsPacks: () => Promise<GetCreditsPacksResponse>;
     getCreditsRates: () => Promise<GetCreditsRatesResponse>;
+    /** Get aggregated monthly credit stats for histogram (consumption, purchases, grants, balance) */
+    getCreditsMonthlyStats: (query?: GetCreditsMonthlyStatsRequest) => Promise<GetCreditsMonthlyStatsResponse>;
 }
 export {};

package/dist/api/client.js

@@ -846,6 +846,10 @@ class ApiClient {
         this.getCreditsRates = async () => {
             return this.makeRequest('credits/rates', 'GET', null);
         };
+        /** Get aggregated monthly credit stats for histogram (consumption, purchases, grants, balance) */
+        this.getCreditsMonthlyStats = async (query) => {
+            return this.makeRequest('credits/stats/monthly', 'GET', query ?? null);
+        };
         this.baseURL = baseURL;
         this.headers = {};
         this.debug = false;

package/dist/api/types/platform/credits.d.ts

@@ -96,3 +96,31 @@ export interface GetCreditsRatesResponse {
     error_code?: string;
     message?: string;
 }
+export interface MonthlyCreditsStatsItem {
+    /** ISO date string for first day of month, e.g. "2025-01-01T00:00:00.000Z" */
+    month: string;
+    /** Credits consumed (as positive number for display, from negative transactions) */
+    consumption: number;
+    /** Credits from pack purchases */
+    purchases: number;
+    /** Credits from subscription grants */
+    grants: number;
+    /** Net change: grants + purchases - consumption */
+    balance: number;
+}
+export interface GetCreditsMonthlyStatsRequest {
+    /** Number of months to return (default 12, max 24) */
+    months?: number;
+}
+export interface GetCreditsMonthlyStatsResponse {
+    success: boolean;
+    data?: MonthlyCreditsStatsItem[];
+    totals?: {
+        consumption: number;
+        purchases: number;
+        grants: number;
+        balance: number;
+    };
+    error_code?: string;
+    message?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flashbacktech/flashbackclient",
-  "version": "0.2.54",
+  "version": "0.2.55",
   "type": "commonjs",
   "publishConfig": {
     "access": "public"