@flashbacktech/flashbackclient 0.2.54 → 0.2.56

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

@@ -79,18 +79,39 @@ class ApiClient {
         };
         this.makeRequest = async (path, method, data) => {
             const isFormData = data instanceof FormData;
+            const isGetOrHead = method === 'GET' || method === 'HEAD';
+            // GET/HEAD cannot have a body: serialize plain objects as query string
+            let requestPath = path.startsWith('/') ? path.substring(1) : path;
+            let body = null;
+            if (data != null) {
+                if (isGetOrHead && !isFormData && typeof data === 'object' && data.constructor === Object) {
+                    const params = new URLSearchParams();
+                    for (const [k, v] of Object.entries(data)) {
+                        if (v !== undefined && v !== null) {
+                            params.set(k, String(v));
+                        }
+                    }
+                    const qs = params.toString();
+                    if (qs) {
+                        requestPath += (requestPath.includes('?') ? '&' : '?') + qs;
+                    }
+                }
+                else if (!isGetOrHead) {
+                    body = isFormData ? data : JSON.stringify(data);
+                }
+            }
             const options = {
                 method,
                 headers: this.headers,
-                body: data ? (isFormData ? data : JSON.stringify(data)) : null,
+                body,
             };
-            if (data && !isFormData) {
+            if (body && !isFormData) {
                 options.headers = {
                     ...options.headers,
                     'Content-Type': 'application/json',
                 };
             }
-            const cleanPath = path.startsWith('/') ? path.substring(1) : path;
+            const cleanPath = requestPath;
             if (this.debug) {
                 console.log(`DEBUG: ${method} ${cleanPath} ${JSON.stringify(data)}`);
                 console.log(`DEBUG: ${JSON.stringify(this.headers)}`);
@@ -831,7 +852,10 @@ class ApiClient {
             return this.makeRequest('credits/balance', 'GET', null);
         };
         this.getCreditsTransactions = async (query) => {
-            return this.makeRequest('credits/transactions', 'GET', query);
+            console.log('[ApiClient] getCreditsTransactions called', query);
+            const result = await this.makeRequest('credits/transactions', 'GET', query);
+            console.log('[ApiClient] getCreditsTransactions result', result);
+            return result;
         };
         /** Consumption = transactions with direction 'out' (backend uses same endpoint) */
         this.getCreditsConsumption = async (query) => {
@@ -846,6 +870,13 @@ 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) => {
+            console.log('[ApiClient] getCreditsMonthlyStats called', query);
+            const result = await this.makeRequest('credits/stats/monthly', 'GET', query ?? null);
+            console.log('[ApiClient] getCreditsMonthlyStats result', result);
+            return result;
+        };
         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.56",
   "type": "commonjs",
   "publishConfig": {
     "access": "public"