From c82a7a0bf9f8e9be3e56cb95e57e723abc4381d1 Mon Sep 17 00:00:00 2001
From: Reynaldi Chernando <12949382+reynaldichernando@users.noreply.github.com>
Date: Mon, 3 Nov 2025 08:51:25 +0700
Subject: [PATCH] Add monthly and detailed app usage types (#1843)

---
 src/puter-js/index.d.ts | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/src/puter-js/index.d.ts b/src/puter-js/index.d.ts
index 08f7f198d..e9ddd5404 100644
--- a/src/puter-js/index.d.ts
+++ b/src/puter-js/index.d.ts
@@ -236,6 +236,8 @@ interface Auth {
     signOut(): void;
     isSignedIn(): boolean;
     getUser(): Promise<User>;
+    getMonthlyUsage(): Promise<MonthlyUsage>;
+    getDetailedAppUsage(appId: string): Promise<DetailedAppUsage>;
 }
 
 interface User {
@@ -244,6 +246,33 @@ interface User {
     email_confirmed: boolean;
 }
 
+interface AllowanceInfo {
+    monthUsageAllowance: number;
+    remaining: number;
+}
+
+interface AppUsage {
+    count: number;
+    total: number;
+}
+
+interface APIUsage {
+    cost: number;
+    count: number;
+    units: number;
+}
+
+interface MonthlyUsage {
+    allowanceInfo: AllowanceInfo;
+    appTotals: Record<string, AppUsage>;
+    usage: Record<string, APIUsage>;
+}
+
+interface DetailedAppUsage {
+    total: number;
+    [key: string]: APIUsage;
+}
+
 // Drivers Module
 interface Drivers {
     call(interface: string, driver: string, method: string, args?: object): Promise<any>;