@epam/ai-dial-chat-hooks 1.1.0-dev.479 → 1.1.0-dev.487

package/index.d.ts

@@ -5620,20 +5620,28 @@ export declare interface UseTranscribeAudioResult {
 }
 
 /**
- * Fetches usage stats via the provided `getUserUsage` function on mount.
+ * Fetches usage stats via the provided `getUserUsage` function on mount, and
+ * again whenever `refreshToken` changes.
  *
  * `enabled` (default `true`) lets callers behind a feature flag skip the fetch
  * entirely. The hook accepts the fetch function as a parameter so the caller
  * supplies an already-configured API client — the hook never constructs or
  * imports one itself.
+ *
+ * `refreshToken` (default `0`) is a caller-driven re-fetch trigger, subject to
+ * the same `enabled` gate. The hook owns no timer and reads no clock: the
+ * caller decides when to change the token. A previously resolved `usage` value
+ * is retained while a token-triggered re-fetch is in flight, so the consumer
+ * can keep rendering the last known figures and suppress a full-page loading
+ * state for a refresh.
  */
-export declare const useUsageData: (getUserUsage: () => Promise<UserLimitStatsResponseDto>, enabled?: boolean) => UseUsageDataResult;
+export declare const useUsageData: (getUserUsage: () => Promise<UserLimitStatsResponseDto>, enabled?: boolean, refreshToken?: number) => UseUsageDataResult;
 
 /** Return shape of {@link useUsageData}. */
 export declare interface UseUsageDataResult {
-    /** Rolling usage and rate-limit stats for every deployment the caller has used in the trailing 30 days, plus the caller's global cost budget. */
+    /** Calendar-period usage and rate-limit stats for every deployment the caller has used in the current UTC day, week, and month, plus the caller's global cost budget. Retained across a `refreshToken`-triggered re-fetch until the new response resolves. */
     usage: UserLimitStatsResponseDto | undefined;
-    /** `true` while the fetch is in flight. */
+    /** `true` while a fetch is in flight, including a `refreshToken`-triggered re-fetch. */
     isLoading: boolean;
     /** Set when the `getUserUsage` call rejects. */
     usageError: Error | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-hooks",
   "description": "Framework-level React hooks extracted from AI DIAL Chat for building custom chat interfaces",
-  "version": "1.1.0-dev.479",
+  "version": "1.1.0-dev.487",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -96,7 +96,7 @@
     }
   },
   "dependencies": {
-    "@epam/ai-dial-chat-api-client": "1.1.0-dev.479",
+    "@epam/ai-dial-chat-api-client": "1.1.0-dev.487",
     "dompurify": "3.4.15",
     "fflate": "^0.8.3",
     "lru-cache": "^10.4.3",
@@ -105,20 +105,20 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.479",
-    "@epam/ai-dial-attachment-input": "1.1.0-dev.479",
-    "@epam/ai-dial-builder-form": "1.1.0-dev.479",
-    "@epam/ai-dial-catalog": "1.1.0-dev.479",
-    "@epam/ai-dial-chat-overlay": "1.1.0-dev.479",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.479",
-    "@epam/ai-dial-mcp-apps": "1.1.0-dev.479",
-    "@epam/ai-dial-publish-panel": "1.1.0-dev.479",
-    "@epam/ai-dial-quotations": "1.1.0-dev.479",
+    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.487",
+    "@epam/ai-dial-attachment-input": "1.1.0-dev.487",
+    "@epam/ai-dial-builder-form": "1.1.0-dev.487",
+    "@epam/ai-dial-catalog": "1.1.0-dev.487",
+    "@epam/ai-dial-chat-overlay": "1.1.0-dev.487",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.487",
+    "@epam/ai-dial-mcp-apps": "1.1.0-dev.487",
+    "@epam/ai-dial-publish-panel": "1.1.0-dev.487",
+    "@epam/ai-dial-quotations": "1.1.0-dev.487",
     "@epam/ai-dial-react-file-manager": "^0.2.0",
-    "@epam/ai-dial-scheduled-tasks": "1.1.0-dev.479",
-    "@epam/ai-dial-share": "1.1.0-dev.479",
-    "@epam/ai-dial-skill-editor": "1.1.0-dev.479",
-    "@epam/ai-dial-source-panel": "1.1.0-dev.479",
+    "@epam/ai-dial-scheduled-tasks": "1.1.0-dev.487",
+    "@epam/ai-dial-share": "1.1.0-dev.487",
+    "@epam/ai-dial-skill-editor": "1.1.0-dev.487",
+    "@epam/ai-dial-source-panel": "1.1.0-dev.487",
     "@epam/ai-dial-ui-kit": "^0.14.2",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@epam/pdf-highlighter-kit": "^0.0.19",

package/usage/useUsageData/useUsageData.js

@@ -1,31 +1,35 @@
 import { useEffect as e, useState as t } from "react";
 //#region src/usage/useUsageData/useUsageData.ts
-var n = (e) => e instanceof Error ? e : Error(String(e)), r = (r, i = !0) => {
-	let [a, o] = t(), [s, c] = t(i), [l, u] = t();
+var n = (e) => e instanceof Error ? e : Error(String(e)), r = (r, i = !0, a = 0) => {
+	let [o, s] = t(), [c, l] = t(i), [u, d] = t();
 	return e(() => {
 		if (!i) {
-			c(!1);
+			l(!1);
 			return;
 		}
 		let e = !1;
-		return c(!0), (async () => {
+		return l(!0), (async () => {
 			try {
 				let t = await r();
 				if (e) return;
-				o(t);
+				s(t);
 			} catch (t) {
 				if (e) return;
-				u(n(t));
+				d(n(t));
 			} finally {
-				e || c(!1);
+				e || l(!1);
 			}
 		})(), () => {
 			e = !0;
 		};
-	}, [i, r]), {
-		usage: a,
-		isLoading: s,
-		usageError: l
+	}, [
+		i,
+		r,
+		a
+	]), {
+		usage: o,
+		isLoading: c,
+		usageError: u
 	};
 };
 //#endregion

package/utils.d.ts

@@ -345,20 +345,28 @@ export declare interface UsePromptsStateResult {
 }
 
 /**
- * Fetches usage stats via the provided `getUserUsage` function on mount.
+ * Fetches usage stats via the provided `getUserUsage` function on mount, and
+ * again whenever `refreshToken` changes.
  *
  * `enabled` (default `true`) lets callers behind a feature flag skip the fetch
  * entirely. The hook accepts the fetch function as a parameter so the caller
  * supplies an already-configured API client — the hook never constructs or
  * imports one itself.
+ *
+ * `refreshToken` (default `0`) is a caller-driven re-fetch trigger, subject to
+ * the same `enabled` gate. The hook owns no timer and reads no clock: the
+ * caller decides when to change the token. A previously resolved `usage` value
+ * is retained while a token-triggered re-fetch is in flight, so the consumer
+ * can keep rendering the last known figures and suppress a full-page loading
+ * state for a refresh.
  */
-export declare const useUsageData: (getUserUsage: () => Promise<UserLimitStatsResponseDto>, enabled?: boolean) => UseUsageDataResult;
+export declare const useUsageData: (getUserUsage: () => Promise<UserLimitStatsResponseDto>, enabled?: boolean, refreshToken?: number) => UseUsageDataResult;
 
 /** Return shape of {@link useUsageData}. */
 export declare interface UseUsageDataResult {
-    /** Rolling usage and rate-limit stats for every deployment the caller has used in the trailing 30 days, plus the caller's global cost budget. */
+    /** Calendar-period usage and rate-limit stats for every deployment the caller has used in the current UTC day, week, and month, plus the caller's global cost budget. Retained across a `refreshToken`-triggered re-fetch until the new response resolves. */
     usage: UserLimitStatsResponseDto | undefined;
-    /** `true` while the fetch is in flight. */
+    /** `true` while a fetch is in flight, including a `refreshToken`-triggered re-fetch. */
     isLoading: boolean;
     /** Set when the `getUserUsage` call rejects. */
     usageError: Error | undefined;