@burdenoff/microfe-bigconsole 2026.1029.4 → 2026.1030.2

package/dist/bigconsole/providers/BigConsoleQuotaProvider.d.ts

@@ -1,8 +1,21 @@
 import { ReactNode } from 'react';
+import { BigConsoleQuotaKind } from '../utils/quota';
 interface BigConsoleQuotaProviderProps {
     children: ReactNode;
     /** Navigate to a billing route (e.g. `/billing` or `/billing/overview`). */
     onViewBilling: (path: string) => void;
 }
+/**
+ * Opens the billing page that resolves a quota of the given kind, carrying the
+ * active org/workspace/project. `null` outside a {@link BigConsoleQuotaProvider}
+ * (e.g. a component rendered in isolation), in which case callers omit the link.
+ */
+type ViewBillingForKind = (kind: BigConsoleQuotaKind) => void;
+/**
+ * For components that show a quota refusal in place instead of raising the
+ * shared dialog (the Create Dashboard dialog, BOFF-10258) and still need the
+ * same upgrade path.
+ */
+export declare function useBigConsoleViewBilling(): ViewBillingForKind | null;
 export declare function BigConsoleQuotaProvider({ children, onViewBilling }: BigConsoleQuotaProviderProps): import('react').JSX.Element;
 export {};

package/dist/bigconsole/providers/BigConsoleQuotaProvider.js

@@ -1,69 +1,75 @@
-import { BIGCONSOLE_BILLING_PATHS as e, BIGCONSOLE_QUOTA_EXHAUSTED_EVENT as t, getBigConsoleQuotaDialogContent as n } from "../utils/quota.js";
-import { useCallback as r, useEffect as i, useState as a } from "react";
-import { AlertTriangle as o } from "lucide-react";
-import { Button as s, ResponsiveDialog as c, ResponsiveDialogContent as l, ResponsiveDialogDescription as u, ResponsiveDialogFooter as d, ResponsiveDialogHeader as f, ResponsiveDialogTitle as p } from "@burdenoff/fe-libs/ui";
-import { useI18n as m } from "@burdenoff/fe-libs/shared/providers/shell/I18nProvider";
-import { Fragment as h, jsx as g, jsxs as _ } from "react/jsx-runtime";
+import { BIGCONSOLE_QUOTA_EXHAUSTED_EVENT as e, bigConsoleBillingPathFor as t, getBigConsoleQuotaDialogContent as n } from "../utils/quota.js";
+import { createContext as r, useCallback as i, useContext as a, useEffect as o, useState as s } from "react";
+import { AlertTriangle as c } from "lucide-react";
+import { Button as l, ResponsiveDialog as u, ResponsiveDialogContent as d, ResponsiveDialogDescription as f, ResponsiveDialogFooter as p, ResponsiveDialogHeader as m, ResponsiveDialogTitle as h } from "@burdenoff/fe-libs/ui";
+import { useI18n as g } from "@burdenoff/fe-libs/shared/providers/shell/I18nProvider";
+import { jsx as _, jsxs as v } from "react/jsx-runtime";
 //#region src/bigconsole/providers/BigConsoleQuotaProvider.tsx
-var v = {
+var y = {
 	open: !1,
 	kind: "generic"
-};
-function y({ children: y, onViewBilling: b }) {
-	let { t: x } = m(), [S, C] = a(v);
-	i(() => {
-		let e = (e) => {
+}, b = r(null);
+function x() {
+	return a(b);
+}
+function S({ children: r, onViewBilling: a }) {
+	let { t: x } = g(), [S, C] = s(y);
+	o(() => {
+		let t = (e) => {
 			let t = e.detail;
 			C({
 				open: !0,
 				kind: t?.kind ?? "generic"
 			});
 		};
-		return window.addEventListener(t, e), () => {
-			window.removeEventListener(t, e);
+		return window.addEventListener(e, t), () => {
+			window.removeEventListener(e, t);
 		};
 	}, []);
-	let w = r(() => {
+	let w = i(() => {
 		C((e) => ({
 			...e,
 			open: !1
 		}));
-	}, []), T = S.kind === "billing-setup", E = r(() => {
+	}, []), T = S.kind === "billing-setup", E = i((e) => a(t(e)), [a]), D = i(() => {
 		C((e) => ({
 			...e,
 			open: !1
-		})), b(T ? e.billingSetup : e.billing);
-	}, [b, T]), D = n(S.kind), O = x(`bigconsole.quota.${S.kind}.title`, D.title), k = x(`bigconsole.quota.${S.kind}.message`, D.message);
-	return /* @__PURE__ */ _(h, { children: [y, /* @__PURE__ */ g(c, {
-		open: S.open,
-		onOpenChange: (e) => !e && w(),
-		children: /* @__PURE__ */ _(l, {
-			className: "sm:max-w-md",
-			showCloseButton: !1,
-			children: [/* @__PURE__ */ _("div", {
-				className: "flex items-start gap-3",
-				children: [/* @__PURE__ */ g("div", {
-					className: "flex size-10 shrink-0 items-center justify-center rounded-full bg-status-warning-bg-subtle text-status-warning-text",
-					children: /* @__PURE__ */ g(o, {
-						className: "size-5",
-						"aria-hidden": "true"
-					})
-				}), /* @__PURE__ */ _(f, {
-					className: "text-left",
-					children: [/* @__PURE__ */ g(p, { children: O }), /* @__PURE__ */ g(u, { children: k })]
-				})]
-			}), /* @__PURE__ */ _(d, { children: [/* @__PURE__ */ g(s, {
-				type: "button",
-				variant: "outline",
-				onClick: w,
-				children: x("bigconsole.quota.dismiss", "Dismiss")
-			}), /* @__PURE__ */ g(s, {
-				type: "button",
-				onClick: E,
-				children: T ? x("bigconsole.quota.setUpBilling", "Set up billing") : x("bigconsole.quota.viewBilling", "View Billing")
-			})] })]
-		})
-	})] });
+		})), E(S.kind);
+	}, [E, S.kind]), O = n(S.kind), k = x(`bigconsole.quota.${S.kind}.title`, O.title), A = x(`bigconsole.quota.${S.kind}.message`, O.message);
+	return /* @__PURE__ */ v(b.Provider, {
+		value: E,
+		children: [r, /* @__PURE__ */ _(u, {
+			open: S.open,
+			onOpenChange: (e) => !e && w(),
+			children: /* @__PURE__ */ v(d, {
+				className: "sm:max-w-md",
+				showCloseButton: !1,
+				children: [/* @__PURE__ */ v("div", {
+					className: "flex items-start gap-3",
+					children: [/* @__PURE__ */ _("div", {
+						className: "flex size-10 shrink-0 items-center justify-center rounded-full bg-status-warning-bg-subtle text-status-warning-text",
+						children: /* @__PURE__ */ _(c, {
+							className: "size-5",
+							"aria-hidden": "true"
+						})
+					}), /* @__PURE__ */ v(m, {
+						className: "text-left",
+						children: [/* @__PURE__ */ _(h, { children: k }), /* @__PURE__ */ _(f, { children: A })]
+					})]
+				}), /* @__PURE__ */ v(p, { children: [/* @__PURE__ */ _(l, {
+					type: "button",
+					variant: "outline",
+					onClick: w,
+					children: x("bigconsole.quota.dismiss", "Dismiss")
+				}), /* @__PURE__ */ _(l, {
+					type: "button",
+					onClick: D,
+					children: T ? x("bigconsole.quota.setUpBilling", "Set up billing") : x("bigconsole.quota.viewBilling", "View Billing")
+				})] })]
+			})
+		})]
+	});
 }
 //#endregion
-export { y as BigConsoleQuotaProvider };
+export { S as BigConsoleQuotaProvider, x as useBigConsoleViewBilling };

package/dist/bigconsole/utils/quota.d.ts

@@ -30,7 +30,28 @@ export declare function createBigConsoleQuotaError(value: unknown): Error;
 /** An exhausted quota, or a quota that was never provisioned because billing is not set up. */
 export declare function isBigConsoleQuotaError(value: unknown): boolean;
 export declare function inferBigConsoleQuotaKind(extensions: QuotaExhaustedExtensions, fallback?: BigConsoleQuotaKind): BigConsoleQuotaKind;
+/**
+ * Classify a failure as a BigConsole quota refusal without announcing it.
+ *
+ * Returns `null` when `value` is not a quota error. A not-provisioned refusal is
+ * checked first: an organisation without billing has no plan at all, so an
+ * "upgrade" message would send them to buy something that would not help.
+ *
+ * Callers that can show the refusal in place (e.g. the Create Dashboard dialog,
+ * BOFF-10258) use this directly; everything else goes through
+ * {@link reportBigConsoleQuotaError}, which raises the shared quota dialog.
+ */
+export declare function classifyBigConsoleQuotaError(value: unknown, fallbackKind?: BigConsoleQuotaKind): BigConsoleQuotaExhaustedEventDetail | null;
 export declare function reportBigConsoleQuotaError(value: unknown, fallbackKind?: BigConsoleQuotaKind): boolean;
+/**
+ * The plan limit a quota refusal carries, when it carries one.
+ *
+ * The gateway's `QUOTA_EXHAUSTED` body reports `limitLeft` but not always the
+ * total, so this returns `null` rather than guessing; the UI then omits the line.
+ */
+export declare function bigConsoleQuotaLimit(detail: BigConsoleQuotaExhaustedEventDetail | null): number | null;
+/** Billing route for a quota kind: billing setup for a not-provisioned org, else the plan page. */
+export declare function bigConsoleBillingPathFor(kind: BigConsoleQuotaKind): string;
 export declare function getBigConsoleQuotaDialogContent(kind: BigConsoleQuotaKind): {
     title: string;
     message: string;

package/dist/bigconsole/utils/quota.js

@@ -75,16 +75,27 @@ function h(e, t = "generic") {
 	let n = e.quotaName?.toLowerCase(), r = e.field?.toLowerCase();
 	return r && i.has(r) || n && s.has(n) ? "project" : r && a.has(r) || n && c.has(n) ? "session" : r && o.has(r) || n && l.has(n) ? "command" : t;
 }
-function g(e, n = "generic") {
+function g(e, t = "generic") {
+	if (f(e)) return { kind: "billing-setup" };
+	let n = d(e);
+	return n ? {
+		kind: h(n, t),
+		extensions: n
+	} : null;
+}
+function _(e, n = "generic") {
 	if (typeof window > "u") return !1;
-	if (f(e)) return window.dispatchEvent(new CustomEvent(t, { detail: { kind: "billing-setup" } })), !0;
-	let r = d(e);
-	return r ? (window.dispatchEvent(new CustomEvent(t, { detail: {
-		kind: h(r, n),
-		extensions: r
-	} })), !0) : !1;
+	let r = g(e, n);
+	return r ? (window.dispatchEvent(new CustomEvent(t, { detail: r })), !0) : !1;
+}
+function v(e) {
+	let t = e?.extensions?.limit;
+	return typeof t == "number" && Number.isFinite(t) && t >= 0 ? t : null;
+}
+function y(e) {
+	return e === "billing-setup" ? r.billingSetup : r.billing;
 }
-function _(e) {
+function b(e) {
 	switch (e) {
 		case "billing-setup": return {
 			title: "Set up billing to continue",
@@ -109,4 +120,4 @@ function _(e) {
 	}
 }
 //#endregion
-export { r as BIGCONSOLE_BILLING_PATHS, t as BIGCONSOLE_QUOTA_EXHAUSTED_EVENT, p as createBigConsoleQuotaError, _ as getBigConsoleQuotaDialogContent, m as isBigConsoleQuotaError, g as reportBigConsoleQuotaError };
+export { t as BIGCONSOLE_QUOTA_EXHAUSTED_EVENT, y as bigConsoleBillingPathFor, v as bigConsoleQuotaLimit, g as classifyBigConsoleQuotaError, p as createBigConsoleQuotaError, b as getBigConsoleQuotaDialogContent, m as isBigConsoleQuotaError, _ as reportBigConsoleQuotaError };