@burdenoff/fe-libs 2026.1028.5 → 2026.1028.6

package/dist/shared/assistant/useAiCreditStatus.d.ts

@@ -0,0 +1,18 @@
+import { AiCreditStatus } from './productAiCredits';
+export interface UseAiCreditStatusOptions {
+    /** Workspace to read. Defaults to the shell's active workspace. */
+    workspaceId?: string;
+    /** False skips the read entirely, for a product that does not meter AI. */
+    enabled?: boolean;
+    /** Injected reader, for tests. Defaults to `fetchAiCreditStatus`. */
+    read?: (productKey: string, workspaceId?: string) => Promise<AiCreditStatus | null>;
+}
+export interface AiCreditStatusState {
+    /** The last successful read, or null when unknown. */
+    status: AiCreditStatus | null;
+    /** True until the first read settles. */
+    loading: boolean;
+    /** Read the balance again now. */
+    refresh: () => Promise<void>;
+}
+export declare function useAiCreditStatus(productKey: string, options?: UseAiCreditStatusOptions): AiCreditStatusState;

package/dist/shared/assistant/useAiCreditStatus.js

@@ -0,0 +1,40 @@
+import { quotaExhaustedEventName as e } from "./quota.js";
+import { fetchAiCreditStatus as t } from "./productAiCredits.js";
+import { aiCreditsUpdatedEventName as n } from "./aiCredits.js";
+import { useCallback as r, useEffect as i, useRef as a, useState as o } from "react";
+//#region src/shared/assistant/useAiCreditStatus.ts
+function s(s, c = {}) {
+	let { workspaceId: l, enabled: u = !0, read: d = t } = c, [f, p] = o(null), [m, h] = o(u), g = a(0), _ = r(async () => {
+		if (!u || !s) return;
+		let e = ++g.current, t = await d(s, l);
+		e === g.current && (p(t), h(!1));
+	}, [
+		u,
+		s,
+		l,
+		d
+	]);
+	return i(() => {
+		if (!u || !s) {
+			p(null), h(!1);
+			return;
+		}
+		if (h(!0), _(), typeof window > "u") return;
+		let t = () => {
+			_();
+		}, r = n(s), i = e(s);
+		return window.addEventListener(r, t), window.addEventListener(i, t), () => {
+			window.removeEventListener(r, t), window.removeEventListener(i, t), g.current += 1;
+		};
+	}, [
+		u,
+		s,
+		_
+	]), {
+		status: f,
+		loading: m,
+		refresh: _
+	};
+}
+//#endregion
+export { s as useAiCreditStatus };

package/dist/shared/providers/shell/useAssistantShellLabels.d.ts

@@ -50,3 +50,13 @@ export declare function useAssistantChromeLabels(): {
  * every product.
  */
 export declare function useAssistantDisclaimerLabel(): string;
+/**
+ * The AI-credit balance line shown before an AI action (BOFF-3732). Platform
+ * shell labels, so one seed in the `workspaces` dictionary translates them for
+ * every product.
+ */
+export declare function useAiCreditBalanceLabels(): {
+    remaining: (count: string) => string;
+    unlimited: string;
+    exhausted: string;
+};

package/dist/shared/providers/shell/useAssistantShellLabels.js

@@ -53,5 +53,13 @@ function n() {
 function r() {
 	return e()("assistantChrome.aiDisclaimer", "AI can make mistakes. Check important details.");
 }
+function i() {
+	let t = e();
+	return {
+		remaining: (e) => t("assistantChrome.aiCreditsRemaining", "{{count}} AI credits left", { count: e }),
+		unlimited: t("assistantChrome.aiCreditsUnlimited", "Unlimited AI credits on this plan"),
+		exhausted: t("assistantChrome.aiCreditsExhausted", "No AI credits left. AI actions resume next cycle or after an upgrade.")
+	};
+}
 //#endregion
-export { n as useAssistantChromeLabels, r as useAssistantDisclaimerLabel, t as useWorkflowAssistantLabels };
+export { i as useAiCreditBalanceLabels, n as useAssistantChromeLabels, r as useAssistantDisclaimerLabel, t as useWorkflowAssistantLabels };