@burdenoff/microfe-billing 2026.510.114

package/dist/billing/hooks/useBillingAccountSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingAccountSelection.d.ts","sourceRoot":"","sources":["../../../src/billing/hooks/useBillingAccountSelection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,OAAO,MAAM,KAAG,MAAM,GAAG,IAQlE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,OAAO,MAAM,EAAE,WAAW,MAAM,GAAG,IAAI,SAYhF,CAAC;AAEF,UAAU,iCAAiC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7D,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,gCAAgC;IACxC,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kEAAkE;IAClE,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzD,iCAAiC;IACjC,cAAc,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,wBAAgB,0BAA0B,CAAC,EACzC,KAAK,EACL,eAAe,EACf,WAAmB,EACnB,YAAiC,GAClC,EAAE,iCAAiC,GAAG,gCAAgC,CA8EtE"}

package/dist/billing/hooks/useBillingAccountSelection.js

@@ -0,0 +1,81 @@
+import { useCallback as e, useEffect as t, useState as n } from "react";
+import { useLocation as r } from "react-router-dom";
+import { getProfileScopedKey as i } from "@burdenoff/fe-libs/shared/utils";
+//#region src/billing/hooks/useBillingAccountSelection.ts
+var a = "billing_selected_account_";
+function o(e) {
+	if (!(typeof window > "u")) try {
+		let t = `${a}${e}`;
+		localStorage.getItem(t) && localStorage.removeItem(t);
+	} catch {}
+}
+var s = (e) => {
+	if (typeof window > "u") return null;
+	try {
+		let t = i(`billing-account-${e}`);
+		return localStorage.getItem(t);
+	} catch {
+		return null;
+	}
+}, c = (e, t) => {
+	if (!(typeof window > "u")) try {
+		let n = i(`billing-account-${e}`);
+		t ? localStorage.setItem(n, t) : localStorage.removeItem(n);
+	} catch {}
+};
+function l({ orgId: i, billingAccounts: a, syncFromUrl: l = !1, urlParamName: u = "billingAccountId" }) {
+	let d = r();
+	t(() => {
+		o(i);
+	}, [i]);
+	let [f, p] = n(() => {
+		if (typeof window > "u") return null;
+		if (l) {
+			let e = new URLSearchParams(window.location.search).get(u);
+			if (e) return e;
+		}
+		return s(i);
+	}), m = e((e) => {
+		p(e), c(i, e);
+	}, [i]), h = e(() => {
+		p(null), c(i, null);
+	}, [i]);
+	return t(() => {
+		if (l) {
+			let e = new URLSearchParams(d.search).get(u);
+			if (e) {
+				p(e), c(i, e);
+				return;
+			}
+		}
+		let e = s(i);
+		e !== f && p(e);
+	}, [
+		d.pathname,
+		d.search,
+		i,
+		l,
+		u,
+		f
+	]), t(() => {
+		f && a && a.length > 0 && (a.some((e) => e.id === f) || h());
+	}, [
+		f,
+		a,
+		h
+	]), t(() => {
+		!f && a && a.length > 0 && m((a.find((e) => e.isDefault) || a[0]).id);
+	}, [
+		f,
+		a,
+		m
+	]), {
+		selectedAccountId: f,
+		setSelectedAccountId: m,
+		clearSelection: h
+	};
+}
+//#endregion
+export { s as getStoredBillingAccountId, c as setStoredBillingAccountId, l as useBillingAccountSelection };
+
+//# sourceMappingURL=useBillingAccountSelection.js.map

package/dist/billing/hooks/useBillingAccountSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingAccountSelection.js","names":[],"sources":["../../../src/billing/hooks/useBillingAccountSelection.ts"],"sourcesContent":["/**\n * Hook for managing billing account selection per org\n * Persists the selected account to localStorage and syncs across pages.\n * Keys are scoped by profile and org to support multi-user/multi-org usage.\n */\n\nimport { useState, useCallback, useEffect } from 'react';\nimport { useLocation } from 'react-router-dom';\nimport { getProfileScopedKey } from '@burdenoff/fe-libs/shared/utils';\n\nconst LEGACY_KEY_PREFIX = 'billing_selected_account_';\n\n/**\n * Clean up legacy non-profile-scoped keys\n */\nfunction cleanupLegacyKeys(tenantId: string): void {\n  if (typeof window === 'undefined') return;\n  try {\n    const key = `${LEGACY_KEY_PREFIX}${tenantId}`;\n    if (localStorage.getItem(key)) {\n      localStorage.removeItem(key);\n    }\n  } catch {\n    // Ignore errors\n  }\n}\n\n/**\n * Get stored account ID (handles finding active profile)\n */\nexport const getStoredBillingAccountId = (orgId: string): string | null => {\n  if (typeof window === 'undefined') return null;\n  try {\n    const key = getProfileScopedKey(`billing-account-${orgId}`);\n    return localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Set stored account ID\n */\nexport const setStoredBillingAccountId = (orgId: string, accountId: string | null) => {\n  if (typeof window === 'undefined') return;\n  try {\n    const key = getProfileScopedKey(`billing-account-${orgId}`);\n    if (accountId) {\n      localStorage.setItem(key, accountId);\n    } else {\n      localStorage.removeItem(key);\n    }\n  } catch {\n    // Ignore localStorage errors\n  }\n};\n\ninterface UseBillingAccountSelectionOptions {\n  orgId: string;\n  /** Available billing accounts to validate against */\n  billingAccounts?: Array<{ id: string; isDefault?: boolean }>;\n  /** Whether to sync from URL query param on navigation */\n  syncFromUrl?: boolean;\n  /** URL query param name (default: 'billingAccountId') */\n  urlParamName?: string;\n}\n\ninterface UseBillingAccountSelectionResult {\n  /** Currently selected billing account ID */\n  selectedAccountId: string | null;\n  /** Set the selected billing account (persists to localStorage) */\n  setSelectedAccountId: (accountId: string | null) => void;\n  /** Clear the stored selection */\n  clearSelection: () => void;\n}\n\nexport function useBillingAccountSelection({\n  orgId,\n  billingAccounts,\n  syncFromUrl = false,\n  urlParamName = 'billingAccountId',\n}: UseBillingAccountSelectionOptions): UseBillingAccountSelectionResult {\n  const location = useLocation();\n\n  // Cleanup legacy keys on mount (still cleans old tenantId-based keys)\n  useEffect(() => {\n    cleanupLegacyKeys(orgId);\n  }, [orgId]);\n\n  // Initialize from URL (if syncFromUrl) or localStorage\n  const [selectedAccountId, setSelectedAccountIdState] = useState<string | null>(() => {\n    if (typeof window === 'undefined') return null;\n\n    if (syncFromUrl) {\n      const urlParams = new URLSearchParams(window.location.search);\n      const urlAccountId = urlParams.get(urlParamName);\n      if (urlAccountId) return urlAccountId;\n    }\n\n    return getStoredBillingAccountId(orgId);\n  });\n\n  // Set selected account and persist to localStorage\n  const setSelectedAccountId = useCallback(\n    (accountId: string | null) => {\n      setSelectedAccountIdState(accountId);\n      setStoredBillingAccountId(orgId, accountId);\n    },\n    [orgId]\n  );\n\n  // Clear stored selection\n  const clearSelection = useCallback(() => {\n    setSelectedAccountIdState(null);\n    setStoredBillingAccountId(orgId, null);\n  }, [orgId]);\n\n  // Sync from URL/localStorage on navigation changes\n  useEffect(() => {\n    if (syncFromUrl) {\n      const urlParams = new URLSearchParams(location.search);\n      const urlAccountId = urlParams.get(urlParamName);\n      if (urlAccountId) {\n        setSelectedAccountIdState(urlAccountId);\n        setStoredBillingAccountId(orgId, urlAccountId);\n        return;\n      }\n    }\n\n    const storedId = getStoredBillingAccountId(orgId);\n    if (storedId !== selectedAccountId) {\n      setSelectedAccountIdState(storedId);\n    }\n  }, [location.pathname, location.search, orgId, syncFromUrl, urlParamName, selectedAccountId]);\n\n  // Validate stored account exists - if not, clear it\n  useEffect(() => {\n    if (selectedAccountId && billingAccounts && billingAccounts.length > 0) {\n      const accountExists = billingAccounts.some((a) => a.id === selectedAccountId);\n      if (!accountExists) {\n        clearSelection();\n      }\n    }\n  }, [selectedAccountId, billingAccounts, clearSelection]);\n\n  // Auto-select default account if none selected\n  useEffect(() => {\n    if (!selectedAccountId && billingAccounts && billingAccounts.length > 0) {\n      const defaultAccount = billingAccounts.find((a) => a.isDefault);\n      const accountToSelect = defaultAccount || billingAccounts[0];\n      setSelectedAccountId(accountToSelect.id);\n    }\n  }, [selectedAccountId, billingAccounts, setSelectedAccountId]);\n\n  return {\n    selectedAccountId,\n    setSelectedAccountId,\n    clearSelection,\n  };\n}\n"],"mappings":";;;;AAUA,IAAM,IAAoB;AAK1B,SAAS,EAAkB,GAAwB;AAC7C,cAAO,SAAW,KACtB,KAAI;EACF,IAAM,IAAM,GAAG,IAAoB;AACnC,EAAI,aAAa,QAAQ,EAAI,IAC3B,aAAa,WAAW,EAAI;SAExB;;AAQV,IAAa,KAA6B,MAAiC;AACzE,KAAI,OAAO,SAAW,IAAa,QAAO;AAC1C,KAAI;EACF,IAAM,IAAM,EAAoB,mBAAmB,IAAQ;AAC3D,SAAO,aAAa,QAAQ,EAAI;SAC1B;AACN,SAAO;;GAOE,KAA6B,GAAe,MAA6B;AAChF,cAAO,SAAW,KACtB,KAAI;EACF,IAAM,IAAM,EAAoB,mBAAmB,IAAQ;AAC3D,EAAI,IACF,aAAa,QAAQ,GAAK,EAAU,GAEpC,aAAa,WAAW,EAAI;SAExB;;AAwBV,SAAgB,EAA2B,EACzC,UACA,oBACA,iBAAc,IACd,kBAAe,sBACuD;CACtE,IAAM,IAAW,GAAa;AAG9B,SAAgB;AACd,IAAkB,EAAM;IACvB,CAAC,EAAM,CAAC;CAGX,IAAM,CAAC,GAAmB,KAA6B,QAA8B;AACnF,MAAI,OAAO,SAAW,IAAa,QAAO;AAE1C,MAAI,GAAa;GAEf,IAAM,IADY,IAAI,gBAAgB,OAAO,SAAS,OAAO,CAC9B,IAAI,EAAa;AAChD,OAAI,EAAc,QAAO;;AAG3B,SAAO,EAA0B,EAAM;GACvC,EAGI,IAAuB,GAC1B,MAA6B;AAE5B,EADA,EAA0B,EAAU,EACpC,EAA0B,GAAO,EAAU;IAE7C,CAAC,EAAM,CACR,EAGK,IAAiB,QAAkB;AAEvC,EADA,EAA0B,KAAK,EAC/B,EAA0B,GAAO,KAAK;IACrC,CAAC,EAAM,CAAC;AAuCX,QApCA,QAAgB;AACd,MAAI,GAAa;GAEf,IAAM,IADY,IAAI,gBAAgB,EAAS,OAAO,CACvB,IAAI,EAAa;AAChD,OAAI,GAAc;AAEhB,IADA,EAA0B,EAAa,EACvC,EAA0B,GAAO,EAAa;AAC9C;;;EAIJ,IAAM,IAAW,EAA0B,EAAM;AACjD,EAAI,MAAa,KACf,EAA0B,EAAS;IAEpC;EAAC,EAAS;EAAU,EAAS;EAAQ;EAAO;EAAa;EAAc;EAAkB,CAAC,EAG7F,QAAgB;AACd,EAAI,KAAqB,KAAmB,EAAgB,SAAS,MAC7C,EAAgB,MAAM,MAAM,EAAE,OAAO,EAAkB,IAE3E,GAAgB;IAGnB;EAAC;EAAmB;EAAiB;EAAe,CAAC,EAGxD,QAAgB;AACd,EAAI,CAAC,KAAqB,KAAmB,EAAgB,SAAS,KAGpE,GAFuB,EAAgB,MAAM,MAAM,EAAE,UAAU,IACrB,EAAgB,IACrB,GAAG;IAEzC;EAAC;EAAmB;EAAiB;EAAqB,CAAC,EAEvD;EACL;EACA;EACA;EACD"}

package/dist/billing/hooks/useBillingEventEmitter.d.ts

@@ -0,0 +1,8 @@
+import { BillingLifecyclePayload } from '@burdenoff/fe-libs/shared/events';
+
+export type BillingDomainEvent = 'billing.billing_account.viewed' | 'billing.billing_account.created' | 'billing.billing_account.updated' | 'billing.billing_account.archived' | 'billing.subscription.viewed' | 'billing.subscription.cancelled' | 'billing.plan.viewed' | 'billing.addon.viewed' | 'billing.checkout.viewed' | 'billing.checkout.initiated' | 'billing.checkout.failed' | 'billing.payment.succeeded' | 'billing.payment.failed' | 'billing.invoice.viewed' | 'billing.payment_method.viewed' | 'billing.payment_method.added' | 'billing.payment_method.default_set' | 'billing.payment_method.deleted' | 'billing.credit.viewed' | 'billing.credits.spent' | 'billing.credits.granted' | 'billing.credits.withdrawal_requested' | 'billing.quota.viewed' | 'billing.usage.viewed' | 'billing.transaction.viewed' | 'billing.affiliate.viewed' | 'billing.affiliate_code.created' | 'billing.affiliate_code.updated' | 'billing.affiliate_code.deactivated' | 'billing.affiliate_code.note_added' | 'billing.earning.viewed' | 'billing.payout.viewed' | 'billing.payout_account.added' | 'billing.payout_account.updated' | 'billing.payout_account.archived' | 'billing.payout.requested' | 'billing.payout.approved' | 'billing.payout.rejected' | 'billing.payout.processed';
+export type BillingEventPayload = BillingLifecyclePayload;
+export declare function useBillingEventEmitter(): {
+    emit: (event: BillingDomainEvent, payload?: BillingEventPayload) => void;
+};
+//# sourceMappingURL=useBillingEventEmitter.d.ts.map

package/dist/billing/hooks/useBillingEventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingEventEmitter.d.ts","sourceRoot":"","sources":["../../../src/billing/hooks/useBillingEventEmitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,MAAM,MAAM,kBAAkB,GAC1B,gCAAgC,GAChC,iCAAiC,GACjC,iCAAiC,GACjC,kCAAkC,GAClC,6BAA6B,GAC7B,gCAAgC,GAChC,qBAAqB,GACrB,sBAAsB,GACtB,yBAAyB,GACzB,4BAA4B,GAC5B,yBAAyB,GACzB,2BAA2B,GAC3B,wBAAwB,GACxB,wBAAwB,GACxB,+BAA+B,GAC/B,8BAA8B,GAC9B,oCAAoC,GACpC,gCAAgC,GAChC,uBAAuB,GACvB,uBAAuB,GACvB,yBAAyB,GACzB,sCAAsC,GACtC,sBAAsB,GACtB,sBAAsB,GACtB,4BAA4B,GAC5B,0BAA0B,GAC1B,gCAAgC,GAChC,gCAAgC,GAChC,oCAAoC,GACpC,mCAAmC,GACnC,wBAAwB,GACxB,uBAAuB,GACvB,8BAA8B,GAC9B,gCAAgC,GAChC,iCAAiC,GACjC,0BAA0B,GAC1B,yBAAyB,GACzB,yBAAyB,GACzB,0BAA0B,CAAC;AAE/B,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAE1D,wBAAgB,sBAAsB,IAAI;IACxC,IAAI,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC1E,CAeA"}

package/dist/billing/hooks/useBillingEventEmitter.js

@@ -0,0 +1,15 @@
+import { useCallback as e } from "react";
+import { useEventBus as t } from "@burdenoff/fe-libs/shared/events";
+//#region src/billing/hooks/useBillingEventEmitter.ts
+function n() {
+	let n = t();
+	return { emit: e((e, t = {}) => {
+		try {
+			n.emit(e, t);
+		} catch {}
+	}, [n]) };
+}
+//#endregion
+export { n as useBillingEventEmitter };
+
+//# sourceMappingURL=useBillingEventEmitter.js.map

package/dist/billing/hooks/useBillingEventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingEventEmitter.js","names":[],"sources":["../../../src/billing/hooks/useBillingEventEmitter.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport { useEventBus, type BillingLifecyclePayload } from '@burdenoff/fe-libs/shared/events';\n\nexport type BillingDomainEvent =\n  | 'billing.billing_account.viewed'\n  | 'billing.billing_account.created'\n  | 'billing.billing_account.updated'\n  | 'billing.billing_account.archived'\n  | 'billing.subscription.viewed'\n  | 'billing.subscription.cancelled'\n  | 'billing.plan.viewed'\n  | 'billing.addon.viewed'\n  | 'billing.checkout.viewed'\n  | 'billing.checkout.initiated'\n  | 'billing.checkout.failed'\n  | 'billing.payment.succeeded'\n  | 'billing.payment.failed'\n  | 'billing.invoice.viewed'\n  | 'billing.payment_method.viewed'\n  | 'billing.payment_method.added'\n  | 'billing.payment_method.default_set'\n  | 'billing.payment_method.deleted'\n  | 'billing.credit.viewed'\n  | 'billing.credits.spent'\n  | 'billing.credits.granted'\n  | 'billing.credits.withdrawal_requested'\n  | 'billing.quota.viewed'\n  | 'billing.usage.viewed'\n  | 'billing.transaction.viewed'\n  | 'billing.affiliate.viewed'\n  | 'billing.affiliate_code.created'\n  | 'billing.affiliate_code.updated'\n  | 'billing.affiliate_code.deactivated'\n  | 'billing.affiliate_code.note_added'\n  | 'billing.earning.viewed'\n  | 'billing.payout.viewed'\n  | 'billing.payout_account.added'\n  | 'billing.payout_account.updated'\n  | 'billing.payout_account.archived'\n  | 'billing.payout.requested'\n  | 'billing.payout.approved'\n  | 'billing.payout.rejected'\n  | 'billing.payout.processed';\n\nexport type BillingEventPayload = BillingLifecyclePayload;\n\nexport function useBillingEventEmitter(): {\n  emit: (event: BillingDomainEvent, payload?: BillingEventPayload) => void;\n} {\n  const bus = useEventBus();\n\n  const emit = useCallback(\n    (event: BillingDomainEvent, payload: BillingEventPayload = {}) => {\n      try {\n        bus.emit(event, payload);\n      } catch {\n        // Event bus failures must never break billing user journeys.\n      }\n    },\n    [bus]\n  );\n\n  return { emit };\n}\n"],"mappings":";;;AA8CA,SAAgB,IAEd;CACA,IAAM,IAAM,GAAa;AAazB,QAAO,EAAE,MAXI,GACV,GAA2B,IAA+B,EAAE,KAAK;AAChE,MAAI;AACF,KAAI,KAAK,GAAO,EAAQ;UAClB;IAIV,CAAC,EAAI,CACN,EAEc"}

package/dist/billing/hooks/useBillingNavigate.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Custom navigation hook for the Billing microfrontend.
+ * Properly handles basePath when navigating within billing routes.
+ */
+export interface NavigateOptions {
+    replace?: boolean;
+    state?: unknown;
+}
+/**
+ * Hook that returns a navigation function that properly prepends the basePath.
+ * This ensures all navigation within the billing microfrontend works correctly
+ * when integrated into a shell application with a basePath (e.g., '/billing').
+ *
+ * @example
+ * ```tsx
+ * const navigateTo = useBillingNavigate();
+ *
+ * // Navigate to checkout
+ * navigateTo('/checkout/credits');
+ * // When basePath is '/billing', this navigates to '/billing/checkout/credits'
+ *
+ * // Navigate with state
+ * navigateTo('/checkout/plan-123', { state: { fromUpgrade: true } });
+ *
+ * // Navigate back in history
+ * navigateTo(-1);
+ * ```
+ */
+export declare function useBillingNavigate(): (pathOrDelta: string | number, options?: NavigateOptions) => void;
+//# sourceMappingURL=useBillingNavigate.d.ts.map

package/dist/billing/hooks/useBillingNavigate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingNavigate.d.ts","sourceRoot":"","sources":["../../../src/billing/hooks/useBillingNavigate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,kBAKhB,MAAM,GAAG,MAAM,YAAY,eAAe,UAoC3D"}

package/dist/billing/hooks/useBillingNavigate.js

@@ -0,0 +1,23 @@
+import { useBilling as e } from "../providers/BillingProvider.js";
+import { useCallback as t } from "react";
+import { useNavigate as n } from "react-router-dom";
+//#region src/billing/hooks/useBillingNavigate.ts
+function r() {
+	let { navigate: r, basePath: i } = e(), a = n();
+	return t((e, t) => {
+		if (typeof e == "number") {
+			a(e);
+			return;
+		}
+		let n = e, o = n;
+		i && i !== "/" && (o = `${i.endsWith("/") ? i.slice(0, -1) : i}${n.startsWith("/") ? n : `/${n}`}`), t && (t.replace || t.state) ? a(o, t) : r ? r(o) : a(o);
+	}, [
+		r,
+		i,
+		a
+	]);
+}
+//#endregion
+export { r as useBillingNavigate };
+
+//# sourceMappingURL=useBillingNavigate.js.map

package/dist/billing/hooks/useBillingNavigate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingNavigate.js","names":[],"sources":["../../../src/billing/hooks/useBillingNavigate.ts"],"sourcesContent":["/**\n * Custom navigation hook for the Billing microfrontend.\n * Properly handles basePath when navigating within billing routes.\n */\n\nimport { useCallback } from 'react';\nimport { useNavigate } from 'react-router-dom';\nimport { useBilling } from '../providers/BillingProvider';\n\nexport interface NavigateOptions {\n  replace?: boolean;\n  state?: unknown;\n}\n\n/**\n * Hook that returns a navigation function that properly prepends the basePath.\n * This ensures all navigation within the billing microfrontend works correctly\n * when integrated into a shell application with a basePath (e.g., '/billing').\n *\n * @example\n * ```tsx\n * const navigateTo = useBillingNavigate();\n *\n * // Navigate to checkout\n * navigateTo('/checkout/credits');\n * // When basePath is '/billing', this navigates to '/billing/checkout/credits'\n *\n * // Navigate with state\n * navigateTo('/checkout/plan-123', { state: { fromUpgrade: true } });\n *\n * // Navigate back in history\n * navigateTo(-1);\n * ```\n */\nexport function useBillingNavigate() {\n  const { navigate, basePath } = useBilling();\n  const routerNavigate = useNavigate();\n\n  const navigateTo = useCallback(\n    (pathOrDelta: string | number, options?: NavigateOptions) => {\n      // Handle numeric delta (for back/forward navigation like navigate(-1))\n      if (typeof pathOrDelta === 'number') {\n        routerNavigate(pathOrDelta);\n        return;\n      }\n\n      const path = pathOrDelta;\n\n      // Handle path joining to avoid double slashes (e.g., / + /plans = //plans)\n      let fullPath = path;\n\n      if (basePath && basePath !== '/') {\n        // Remove trailing slash from basePath and ensure path has leading slash\n        const base = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath;\n        const suffix = path.startsWith('/') ? path : `/${path}`;\n        fullPath = `${base}${suffix}`;\n      }\n\n      // The shell navigate function only accepts a path (no options)\n      // For navigation with options (replace, state), use the router navigate directly\n      if (options && (options.replace || options.state)) {\n        // Use router navigate for options support\n        routerNavigate(fullPath, options);\n      } else if (navigate) {\n        // Use shell navigate for simple navigation\n        navigate(fullPath);\n      } else {\n        // Fallback to router navigate\n        routerNavigate(fullPath);\n      }\n    },\n    [navigate, basePath, routerNavigate]\n  );\n\n  return navigateTo;\n}\n"],"mappings":";;;;AAkCA,SAAgB,IAAqB;CACnC,IAAM,EAAE,aAAU,gBAAa,GAAY,EACrC,IAAiB,GAAa;AAsCpC,QApCmB,GAChB,GAA8B,MAA8B;AAE3D,MAAI,OAAO,KAAgB,UAAU;AACnC,KAAe,EAAY;AAC3B;;EAGF,IAAM,IAAO,GAGT,IAAW;AAWf,EATI,KAAY,MAAa,QAI3B,IAAW,GAFE,EAAS,SAAS,IAAI,GAAG,EAAS,MAAM,GAAG,GAAG,GAAG,IAC/C,EAAK,WAAW,IAAI,GAAG,IAAO,IAAI,QAM/C,MAAY,EAAQ,WAAW,EAAQ,SAEzC,EAAe,GAAU,EAAQ,GACxB,IAET,EAAS,EAAS,GAGlB,EAAe,EAAS;IAG5B;EAAC;EAAU;EAAU;EAAe,CACrC"}

package/dist/billing/hooks/useBillingPermissions.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Hook for billing-specific RBAC permissions.
+ *
+ * Permission model aligns with the `@rbac` directives on global-billing-svc:
+ *   resource: "billing"
+ *   actions:  "read"   – view billing data
+ *             "create" – create billing accounts, initiate payments
+ *             "update" – modify billing accounts, payment methods, usage
+ *             "delete" – remove payment methods, cancel subscriptions
+ *             "manage" – admin-only (plans, addons, quotas, discounts, refunds, tax rates)
+ *
+ * The RBAC service resolves these via `billingAccount.*` permission strings:
+ *   billingAccount.read   → action: "read"
+ *   billingAccount.create → action: "create"
+ *   billingAccount.update → action: "update"
+ *   billingAccount.delete → action: "delete"
+ *   billingAccount.all    → action: "manage" (admin bypass)
+ *
+ */
+export declare function useBillingPermissions(): {
+    /** @rbac(action: "read", resource: "billing") */
+    canViewBillingAccount: boolean;
+    /** @rbac(action: "create", resource: "billing") */
+    canCreateBillingAccount: boolean;
+    /** @rbac(action: "update", resource: "billing") */
+    canManageBillingAccount: boolean;
+    /** @rbac(action: "delete", resource: "billing") — archiveBillingAccount */
+    canArchiveBillingAccount: boolean;
+    /** @rbac(action: "read", resource: "billing") */
+    canViewSubscriptions: boolean;
+    /** @rbac(action: "create", resource: "billing") — initiatePayment for plans */
+    canCreateSubscription: boolean;
+    /** @rbac(action: "update", resource: "billing") */
+    canUpdateSubscription: boolean;
+    /** @rbac(action: "delete", resource: "billing") — cancelSubscription */
+    canCancelSubscription: boolean;
+    /** @rbac(action: "read", resource: "billing") */
+    canViewPlans: boolean;
+    /** @rbac(action: "manage", resource: "billing") — createPlan, updatePlan, togglePlan */
+    canManagePlans: boolean;
+    /** @rbac(action: "read", resource: "billing") */
+    canViewAddons: boolean;
+    /** @rbac(action: "manage", resource: "billing") — createAddOns, updateAddOnDetails, toggleAddOn */
+    canManageAddons: boolean;
+    /** @rbac(action: "read", resource: "billing") */
+    canViewQuotas: boolean;
+    /** @rbac(action: "manage", resource: "billing") — createQuota, updateQuota */
+    canManageQuotas: boolean;
+    /** @rbac(action: "read", resource: "billing") */
+    canViewInvoices: boolean;
+    /** @rbac(action: "update", resource: "billing") — payInvoice */
+    canPayInvoice: boolean;
+    /** @rbac(action: "manage", resource: "billing") — voidInvoice, generateInvoice */
+    canVoidInvoice: boolean;
+    /** @rbac(action: "read", resource: "billing") */
+    canViewPayments: boolean;
+    /** @rbac(action: "create", resource: "billing") — initiatePayment */
+    canProcessPayment: boolean;
+    /** @rbac(action: "read", resource: "billing") */
+    canViewPaymentMethods: boolean;
+    /** @rbac(action: "update", resource: "billing") — addPaymentMethod, updatePaymentMethod */
+    canManagePaymentMethods: boolean;
+    /** @rbac(action: "read", resource: "billing") */
+    canViewUsage: boolean;
+    /** @rbac(action: "update", resource: "billing") — addUsage, freeUpUsage */
+    canRecordUsage: boolean;
+    /** @rbac(action: "read", resource: "billing") */
+    canViewCredits: boolean;
+    /** @rbac(action: "update", resource: "billing") — spendCredits */
+    canIssueCredit: boolean;
+    /** @rbac(action: "update", resource: "billing") — requestCreditWithdrawal */
+    canWithdrawCredits: boolean;
+    /** @rbac(action: "manage", resource: "billing") — grantCredits */
+    canGrantCredits: boolean;
+    /** @rbac(action: "update", resource: "billing") — applyBillingDiscount */
+    canApplyDiscount: boolean;
+    /** @rbac(action: "manage", resource: "billing") — createDiscount, updateDiscount, deleteDiscount */
+    canManageDiscounts: boolean;
+    /** @rbac(action: "read", resource: "billing") */
+    canViewAnalytics: boolean;
+    /** @rbac(action: "manage", resource: "billing") — processRefund, skipRefund, retryRefund */
+    canProcessRefund: boolean;
+    /** @rbac(action: "manage", resource: "billing") */
+    canManageRecurringBilling: boolean;
+    /** @rbac(action: "manage", resource: "billing") — createEntitlement, updateEntitlement, deleteEntitlement */
+    canManageEntitlements: boolean;
+    /** @rbac(action: "manage", resource: "billing") — createTaxRate, updateTaxRate, deleteTaxRate */
+    canManageTaxRates: boolean;
+    /** Full billing admin (billing:manage) */
+    isBillingAdmin: boolean;
+    /** Whether permissions are still being loaded from RBAC service */
+    isLoading: boolean;
+};
+//# sourceMappingURL=useBillingPermissions.d.ts.map

package/dist/billing/hooks/useBillingPermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingPermissions.d.ts","sourceRoot":"","sources":["../../../src/billing/hooks/useBillingPermissions.ts"],"names":[],"mappings":"AA6CA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB;IAuEjC,iDAAiD;;IAEjD,mDAAmD;;IAEnD,mDAAmD;;IAEnD,2EAA2E;;IAI3E,iDAAiD;;IAEjD,+EAA+E;;IAE/E,mDAAmD;;IAEnD,wEAAwE;;IAIxE,iDAAiD;;IAEjD,wFAAwF;;IAIxF,iDAAiD;;IAEjD,mGAAmG;;IAInG,iDAAiD;;IAEjD,8EAA8E;;IAI9E,iDAAiD;;IAEjD,gEAAgE;;IAEhE,kFAAkF;;IAIlF,iDAAiD;;IAEjD,qEAAqE;;IAIrE,iDAAiD;;IAEjD,2FAA2F;;IAI3F,iDAAiD;;IAEjD,2EAA2E;;IAI3E,iDAAiD;;IAEjD,kEAAkE;;IAElE,6EAA6E;;IAE7E,kEAAkE;;IAIlE,0EAA0E;;IAE1E,oGAAoG;;IAIpG,iDAAiD;;IAIjD,4FAA4F;;IAI5F,mDAAmD;;IAInD,6GAA6G;;IAI7G,iGAAiG;;IAIjG,0CAA0C;;IAI1C,mEAAmE;;EAGtE"}

package/dist/billing/hooks/useBillingPermissions.js

@@ -0,0 +1,78 @@
+import { useBilling as e } from "../providers/BillingProvider.js";
+import { useBillingAccountSelection as t } from "./useBillingAccountSelection.js";
+import { directBillingGraphqlRequest as n } from "../shared/utils/directBillingGraphql.js";
+import "../shared/utils/index.js";
+import { useMemo as r } from "react";
+import { useAuth as i, usePermissions as a } from "@burdenoff/fe-libs/shared/providers/shell";
+import { useQuery as o } from "@tanstack/react-query";
+//#region src/billing/hooks/useBillingPermissions.ts
+var s = ["billing:read", "billing.read"], c = ["billing:create", "billing.create"], l = ["billing:update", "billing.update"], u = ["billing:delete", "billing.delete"], d = ["billing:manage", "billing.manage"], f = "\n  query BillingScopeMyPermissions($scopeId: String!) {\n    myPermissions(scopeId: $scopeId) {\n      actorId\n      scopeId\n      permissions {\n        resourceType\n        level\n        allowedActions\n      }\n    }\n  }\n";
+function p(e) {
+	return e.flatMap((e) => {
+		let t = [];
+		return e.level === "ADMIN" && t.push(`${e.resourceType}:*`), t.push(...e.allowedActions.map((t) => `${e.resourceType}:${t}`)), t;
+	});
+}
+function m() {
+	let { isAuthenticated: m } = i(), { hasPermission: h, isLoading: g } = a(), { apiGatewayUrl: _, authToken: v, orgId: y } = e(), { selectedAccountId: b } = t({
+		orgId: y,
+		syncFromUrl: !0,
+		urlParamName: "billingAccountId"
+	}), x = b ?? void 0, S = o({
+		queryKey: ["billing-scope-permissions", x],
+		enabled: m && !!x,
+		staleTime: 300 * 1e3,
+		queryFn: async () => p((await n({
+			apiGatewayUrl: _,
+			authToken: v,
+			orgId: y,
+			query: f,
+			variables: { scopeId: x }
+		}))?.myPermissions?.permissions ?? [])
+	}), C = r(() => S.data ?? [], [S.data]), w = (e) => {
+		let [t] = e.split(/[:.]/);
+		return C.includes(e) || C.includes(`${t}:*`);
+	}, T = (e) => e.some((e) => h(e) || w(e)), E = m && T(s), D = m && T(c), O = m && T(l), k = m && T(u), A = m && T(d);
+	return {
+		canViewBillingAccount: E,
+		canCreateBillingAccount: D,
+		canManageBillingAccount: O,
+		canArchiveBillingAccount: k,
+		canViewSubscriptions: E,
+		canCreateSubscription: D,
+		canUpdateSubscription: O,
+		canCancelSubscription: k,
+		canViewPlans: E,
+		canManagePlans: A,
+		canViewAddons: E,
+		canManageAddons: A,
+		canViewQuotas: E,
+		canManageQuotas: A,
+		canViewInvoices: E,
+		canPayInvoice: O,
+		canVoidInvoice: A,
+		canViewPayments: E,
+		canProcessPayment: D,
+		canViewPaymentMethods: E,
+		canManagePaymentMethods: O,
+		canViewUsage: E,
+		canRecordUsage: O,
+		canViewCredits: E,
+		canIssueCredit: O,
+		canWithdrawCredits: O,
+		canGrantCredits: A,
+		canApplyDiscount: O,
+		canManageDiscounts: A,
+		canViewAnalytics: E,
+		canProcessRefund: A,
+		canManageRecurringBilling: A,
+		canManageEntitlements: A,
+		canManageTaxRates: A,
+		isBillingAdmin: A,
+		isLoading: g || !!x && S.isLoading
+	};
+}
+//#endregion
+export { m as useBillingPermissions };
+
+//# sourceMappingURL=useBillingPermissions.js.map

package/dist/billing/hooks/useBillingPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingPermissions.js","names":[],"sources":["../../../src/billing/hooks/useBillingPermissions.ts"],"sourcesContent":["import { useQuery } from '@tanstack/react-query';\nimport { useMemo } from 'react';\nimport { useAuth, usePermissions } from '@burdenoff/fe-libs/shared/providers/shell';\nimport { useBilling } from '../providers/BillingProvider';\nimport { useBillingAccountSelection } from './useBillingAccountSelection';\nimport { directBillingGraphqlRequest } from '../shared/utils';\n\n// Permission strings emitted by global-billing-svc @rbac directives.\n// We accept both `:` and `.` separators because the RBAC service has\n// historically returned both shapes in `myPermissions.permissions[]`.\nconst BILLING_READ = ['billing:read', 'billing.read'];\nconst BILLING_CREATE = ['billing:create', 'billing.create'];\nconst BILLING_UPDATE = ['billing:update', 'billing.update'];\nconst BILLING_DELETE = ['billing:delete', 'billing.delete'];\nconst BILLING_MANAGE = ['billing:manage', 'billing.manage'];\n\nconst BILLING_SCOPE_PERMISSIONS_QUERY = `\n  query BillingScopeMyPermissions($scopeId: String!) {\n    myPermissions(scopeId: $scopeId) {\n      actorId\n      scopeId\n      permissions {\n        resourceType\n        level\n        allowedActions\n      }\n    }\n  }\n`;\n\ninterface RawPerm {\n  resourceType: string;\n  level: string;\n  allowedActions: string[];\n}\n\nfunction permsToStrings(perms: RawPerm[]): string[] {\n  return perms.flatMap((p) => {\n    const out: string[] = [];\n    if (p.level === 'ADMIN') out.push(`${p.resourceType}:*`);\n    out.push(...p.allowedActions.map((a) => `${p.resourceType}:${a}`));\n    return out;\n  });\n}\n\n/**\n * Hook for billing-specific RBAC permissions.\n *\n * Permission model aligns with the `@rbac` directives on global-billing-svc:\n *   resource: \"billing\"\n *   actions:  \"read\"   – view billing data\n *             \"create\" – create billing accounts, initiate payments\n *             \"update\" – modify billing accounts, payment methods, usage\n *             \"delete\" – remove payment methods, cancel subscriptions\n *             \"manage\" – admin-only (plans, addons, quotas, discounts, refunds, tax rates)\n *\n * The RBAC service resolves these via `billingAccount.*` permission strings:\n *   billingAccount.read   → action: \"read\"\n *   billingAccount.create → action: \"create\"\n *   billingAccount.update → action: \"update\"\n *   billingAccount.delete → action: \"delete\"\n *   billingAccount.all    → action: \"manage\" (admin bypass)\n *\n */\nexport function useBillingPermissions() {\n  const { isAuthenticated } = useAuth();\n  // Org-scope permissions from the top-level PermissionProvider. Covers\n  // Org Owner / Org Admin permissions on the `billing` resource.\n  const { hasPermission: hasOrgPermission, isLoading: orgIsLoading } = usePermissions();\n  const { apiGatewayUrl, authToken, orgId } = useBilling();\n\n  // Billing-account-scope permissions. Covers Billing Admin / Billing Viewer\n  // role assignments on the currently-active billing account. Required\n  // because PermissionProvider only fetches a single scope (org), so a\n  // user who is *only* a Billing Admin (not Org Owner) would otherwise see\n  // empty perms on the billing pages.\n  // Resolve account scope from the current URL when present, otherwise fall\n  // back to the last selected billing account stored for this org. That keeps\n  // route guards aligned with SPA navigation *and* with list/detail flows that\n  // rely on persisted account selection.\n  const { selectedAccountId } = useBillingAccountSelection({\n    orgId,\n    syncFromUrl: true,\n    urlParamName: 'billingAccountId',\n  });\n  const billingAccountId = selectedAccountId ?? undefined;\n  const billingScopeQuery = useQuery({\n    queryKey: ['billing-scope-permissions', billingAccountId],\n    enabled: isAuthenticated && Boolean(billingAccountId),\n    staleTime: 5 * 60 * 1000,\n    queryFn: async () => {\n      const data = await directBillingGraphqlRequest<{\n        myPermissions: { permissions: RawPerm[] };\n      }>({\n        apiGatewayUrl,\n        authToken,\n        orgId,\n        query: BILLING_SCOPE_PERMISSIONS_QUERY,\n        variables: { scopeId: billingAccountId },\n      });\n      return permsToStrings(data?.myPermissions?.permissions ?? []);\n    },\n  });\n\n  const billingScopeStrings = useMemo<string[]>(\n    () => billingScopeQuery.data ?? [],\n    [billingScopeQuery.data]\n  );\n\n  const matchesBillingScope = (permission: string): boolean => {\n    // Wildcard match: e.g. `billing:read` matches stored `billing:*`.\n    const [resource] = permission.split(/[:.]/);\n    return (\n      billingScopeStrings.includes(permission) || billingScopeStrings.includes(`${resource}:*`)\n    );\n  };\n\n  // Pure RBAC: every check goes through the gateway-evaluated permission\n  // set returned by `myPermissions`. No email-domain or role-name fallback —\n  // those legacy escape hatches caused divergence between UI and gateway\n  // enforcement and have been removed now that billing-scope roles\n  // (Billing Admin / Billing Viewer) are auto-assigned on account creation.\n  const hasAnyPermission = (permissions: string[]): boolean =>\n    permissions.some((p) => hasOrgPermission(p) || matchesBillingScope(p));\n\n  const canRead = isAuthenticated && hasAnyPermission(BILLING_READ);\n  const canCreate = isAuthenticated && hasAnyPermission(BILLING_CREATE);\n  const canUpdate = isAuthenticated && hasAnyPermission(BILLING_UPDATE);\n  const canDelete = isAuthenticated && hasAnyPermission(BILLING_DELETE);\n  const canManage = isAuthenticated && hasAnyPermission(BILLING_MANAGE);\n\n  const isLoading = orgIsLoading || (Boolean(billingAccountId) && billingScopeQuery.isLoading);\n\n  return {\n    // ── Billing account ───────────────────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewBillingAccount: canRead,\n    /** @rbac(action: \"create\", resource: \"billing\") */\n    canCreateBillingAccount: canCreate,\n    /** @rbac(action: \"update\", resource: \"billing\") */\n    canManageBillingAccount: canUpdate,\n    /** @rbac(action: \"delete\", resource: \"billing\") — archiveBillingAccount */\n    canArchiveBillingAccount: canDelete,\n\n    // ── Subscriptions ─────────────────────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewSubscriptions: canRead,\n    /** @rbac(action: \"create\", resource: \"billing\") — initiatePayment for plans */\n    canCreateSubscription: canCreate,\n    /** @rbac(action: \"update\", resource: \"billing\") */\n    canUpdateSubscription: canUpdate,\n    /** @rbac(action: \"delete\", resource: \"billing\") — cancelSubscription */\n    canCancelSubscription: canDelete,\n\n    // ── Plans (admin-only management) ─────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewPlans: canRead,\n    /** @rbac(action: \"manage\", resource: \"billing\") — createPlan, updatePlan, togglePlan */\n    canManagePlans: canManage,\n\n    // ── Addons (admin-only management) ────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewAddons: canRead,\n    /** @rbac(action: \"manage\", resource: \"billing\") — createAddOns, updateAddOnDetails, toggleAddOn */\n    canManageAddons: canManage,\n\n    // ── Quotas (admin-only management) ────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewQuotas: canRead,\n    /** @rbac(action: \"manage\", resource: \"billing\") — createQuota, updateQuota */\n    canManageQuotas: canManage,\n\n    // ── Invoices ──────────────────────────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewInvoices: canRead,\n    /** @rbac(action: \"update\", resource: \"billing\") — payInvoice */\n    canPayInvoice: canUpdate,\n    /** @rbac(action: \"manage\", resource: \"billing\") — voidInvoice, generateInvoice */\n    canVoidInvoice: canManage,\n\n    // ── Payments ──────────────────────────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewPayments: canRead,\n    /** @rbac(action: \"create\", resource: \"billing\") — initiatePayment */\n    canProcessPayment: canCreate,\n\n    // ── Payment Methods ───────────────────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewPaymentMethods: canRead,\n    /** @rbac(action: \"update\", resource: \"billing\") — addPaymentMethod, updatePaymentMethod */\n    canManagePaymentMethods: canUpdate,\n\n    // ── Usage ─────────────────────────────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewUsage: canRead,\n    /** @rbac(action: \"update\", resource: \"billing\") — addUsage, freeUpUsage */\n    canRecordUsage: canUpdate,\n\n    // ── Credits ───────────────────────────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewCredits: canRead,\n    /** @rbac(action: \"update\", resource: \"billing\") — spendCredits */\n    canIssueCredit: canUpdate,\n    /** @rbac(action: \"update\", resource: \"billing\") — requestCreditWithdrawal */\n    canWithdrawCredits: canUpdate,\n    /** @rbac(action: \"manage\", resource: \"billing\") — grantCredits */\n    canGrantCredits: canManage,\n\n    // ── Discounts ─────────────────────────────────────────────────────\n    /** @rbac(action: \"update\", resource: \"billing\") — applyBillingDiscount */\n    canApplyDiscount: canUpdate,\n    /** @rbac(action: \"manage\", resource: \"billing\") — createDiscount, updateDiscount, deleteDiscount */\n    canManageDiscounts: canManage,\n\n    // ── Analytics ─────────────────────────────────────────────────────\n    /** @rbac(action: \"read\", resource: \"billing\") */\n    canViewAnalytics: canRead,\n\n    // ── Refunds (admin-only) ──────────────────────────────────────────\n    /** @rbac(action: \"manage\", resource: \"billing\") — processRefund, skipRefund, retryRefund */\n    canProcessRefund: canManage,\n\n    // ── Recurring Billing (admin/service-only) ────────────────────────\n    /** @rbac(action: \"manage\", resource: \"billing\") */\n    canManageRecurringBilling: canManage,\n\n    // ── Entitlements (admin-only) ─────────────────────────────────────\n    /** @rbac(action: \"manage\", resource: \"billing\") — createEntitlement, updateEntitlement, deleteEntitlement */\n    canManageEntitlements: canManage,\n\n    // ── Tax Rates (admin-only) ────────────────────────────────────────\n    /** @rbac(action: \"manage\", resource: \"billing\") — createTaxRate, updateTaxRate, deleteTaxRate */\n    canManageTaxRates: canManage,\n\n    // ── Admin check ───────────────────────────────────────────────────\n    /** Full billing admin (billing:manage) */\n    isBillingAdmin: canManage,\n\n    // ── Loading state ─────────────────────────────────────────────────\n    /** Whether permissions are still being loaded from RBAC service */\n    isLoading,\n  };\n}\n"],"mappings":";;;;;;;;AAUA,IAAM,IAAe,CAAC,gBAAgB,eAAe,EAC/C,IAAiB,CAAC,kBAAkB,iBAAiB,EACrD,IAAiB,CAAC,kBAAkB,iBAAiB,EACrD,IAAiB,CAAC,kBAAkB,iBAAiB,EACrD,IAAiB,CAAC,kBAAkB,iBAAiB,EAErD,IAAkC;AAoBxC,SAAS,EAAe,GAA4B;AAClD,QAAO,EAAM,SAAS,MAAM;EAC1B,IAAM,IAAgB,EAAE;AAGxB,SAFI,EAAE,UAAU,WAAS,EAAI,KAAK,GAAG,EAAE,aAAa,IAAI,EACxD,EAAI,KAAK,GAAG,EAAE,eAAe,KAAK,MAAM,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC,EAC3D;GACP;;AAsBJ,SAAgB,IAAwB;CACtC,IAAM,EAAE,uBAAoB,GAAS,EAG/B,EAAE,eAAe,GAAkB,WAAW,MAAiB,GAAgB,EAC/E,EAAE,kBAAe,cAAW,aAAU,GAAY,EAWlD,EAAE,yBAAsB,EAA2B;EACvD;EACA,aAAa;EACb,cAAc;EACf,CAAC,EACI,IAAmB,KAAqB,KAAA,GACxC,IAAoB,EAAS;EACjC,UAAU,CAAC,6BAA6B,EAAiB;EACzD,SAAS,KAAmB,EAAQ;EACpC,WAAW,MAAS;EACpB,SAAS,YAUA,GATM,MAAM,EAEhB;GACD;GACA;GACA;GACA,OAAO;GACP,WAAW,EAAE,SAAS,GAAkB;GACzC,CAAC,GAC0B,eAAe,eAAe,EAAE,CAAC;EAEhE,CAAC,EAEI,IAAsB,QACpB,EAAkB,QAAQ,EAAE,EAClC,CAAC,EAAkB,KAAK,CACzB,EAEK,KAAuB,MAAgC;EAE3D,IAAM,CAAC,KAAY,EAAW,MAAM,OAAO;AAC3C,SACE,EAAoB,SAAS,EAAW,IAAI,EAAoB,SAAS,GAAG,EAAS,IAAI;IASvF,KAAoB,MACxB,EAAY,MAAM,MAAM,EAAiB,EAAE,IAAI,EAAoB,EAAE,CAAC,EAElE,IAAU,KAAmB,EAAiB,EAAa,EAC3D,IAAY,KAAmB,EAAiB,EAAe,EAC/D,IAAY,KAAmB,EAAiB,EAAe,EAC/D,IAAY,KAAmB,EAAiB,EAAe,EAC/D,IAAY,KAAmB,EAAiB,EAAe;AAIrE,QAAO;EAGL,uBAAuB;EAEvB,yBAAyB;EAEzB,yBAAyB;EAEzB,0BAA0B;EAI1B,sBAAsB;EAEtB,uBAAuB;EAEvB,uBAAuB;EAEvB,uBAAuB;EAIvB,cAAc;EAEd,gBAAgB;EAIhB,eAAe;EAEf,iBAAiB;EAIjB,eAAe;EAEf,iBAAiB;EAIjB,iBAAiB;EAEjB,eAAe;EAEf,gBAAgB;EAIhB,iBAAiB;EAEjB,mBAAmB;EAInB,uBAAuB;EAEvB,yBAAyB;EAIzB,cAAc;EAEd,gBAAgB;EAIhB,gBAAgB;EAEhB,gBAAgB;EAEhB,oBAAoB;EAEpB,iBAAiB;EAIjB,kBAAkB;EAElB,oBAAoB;EAIpB,kBAAkB;EAIlB,kBAAkB;EAIlB,2BAA2B;EAI3B,uBAAuB;EAIvB,mBAAmB;EAInB,gBAAgB;EAIhB,WA7GgB,KAAiB,EAAQ,KAAqB,EAAkB;EA8GjF"}

package/dist/billing/hooks/useDefaultBillingCurrency.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns the currency of the user's default billing account (e.g. "INR", "USD").
+ * Falls back to "USD" while loading or if no billing account exists.
+ */
+export declare function useDefaultBillingCurrency(): string;
+/**
+ * Given a plan/addon's base price + currency and an optional currencyPrices map,
+ * returns the best price/currency to display for the given target currency.
+ */
+export declare function getDisplayPrice(basePrice: number, baseCurrency: string, currencyPrices: Record<string, number> | null | undefined, targetCurrency: string): {
+    price: number;
+    currency: string;
+};
+//# sourceMappingURL=useDefaultBillingCurrency.d.ts.map

package/dist/billing/hooks/useDefaultBillingCurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDefaultBillingCurrency.d.ts","sourceRoot":"","sources":["../../../src/billing/hooks/useDefaultBillingCurrency.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACzD,cAAc,EAAE,MAAM,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAQrC"}

package/dist/billing/hooks/useDefaultBillingCurrency.js

@@ -0,0 +1,23 @@
+import { useGetDefaultBillingAccountCheckoutQuery as e } from "../../generated/global-operations.js";
+//#region src/billing/hooks/useDefaultBillingCurrency.ts
+function t() {
+	let { data: t } = e();
+	return t?.getDefaultBillingAccount?.currency ?? "USD";
+}
+function n(e, t, n, r) {
+	if (r && r !== t && n) {
+		let e = n[r];
+		if (e != null && e > 0) return {
+			price: e,
+			currency: r
+		};
+	}
+	return {
+		price: e,
+		currency: t || "USD"
+	};
+}
+//#endregion
+export { n as getDisplayPrice, t as useDefaultBillingCurrency };
+
+//# sourceMappingURL=useDefaultBillingCurrency.js.map

package/dist/billing/hooks/useDefaultBillingCurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDefaultBillingCurrency.js","names":[],"sources":["../../../src/billing/hooks/useDefaultBillingCurrency.ts"],"sourcesContent":["import { useGetDefaultBillingAccountCheckoutQuery } from '../../generated/global-operations';\n\n/**\n * Returns the currency of the user's default billing account (e.g. \"INR\", \"USD\").\n * Falls back to \"USD\" while loading or if no billing account exists.\n */\nexport function useDefaultBillingCurrency(): string {\n  const { data } = useGetDefaultBillingAccountCheckoutQuery();\n  return data?.getDefaultBillingAccount?.currency ?? 'USD';\n}\n\n/**\n * Given a plan/addon's base price + currency and an optional currencyPrices map,\n * returns the best price/currency to display for the given target currency.\n */\nexport function getDisplayPrice(\n  basePrice: number,\n  baseCurrency: string,\n  currencyPrices: Record<string, number> | null | undefined,\n  targetCurrency: string\n): { price: number; currency: string } {\n  if (targetCurrency && targetCurrency !== baseCurrency && currencyPrices) {\n    const override = (currencyPrices as Record<string, number>)[targetCurrency];\n    if (override != null && override > 0) {\n      return { price: override, currency: targetCurrency };\n    }\n  }\n  return { price: basePrice, currency: baseCurrency || 'USD' };\n}\n"],"mappings":";;AAMA,SAAgB,IAAoC;CAClD,IAAM,EAAE,YAAS,GAA0C;AAC3D,QAAO,GAAM,0BAA0B,YAAY;;AAOrD,SAAgB,EACd,GACA,GACA,GACA,GACqC;AACrC,KAAI,KAAkB,MAAmB,KAAgB,GAAgB;EACvE,IAAM,IAAY,EAA0C;AAC5D,MAAI,KAAY,QAAQ,IAAW,EACjC,QAAO;GAAE,OAAO;GAAU,UAAU;GAAgB;;AAGxD,QAAO;EAAE,OAAO;EAAW,UAAU,KAAgB;EAAO"}

package/dist/billing/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Billing Microfrontend
+ *
+ * Provides a complete billing and subscription management interface
+ * for managing subscriptions, payments, invoices, usage tracking, and revenue analytics.
+ *
+ * @example
+ * ```tsx
+ * import { BillingRoot, type BillingRootProps } from '@burdenoff/microfe-billing';
+ *
+ * function App() {
+ *   const props: BillingRootProps = {
+ *     basePath: '/billing',
+ *     navigate: (path) => router.push(path),
+ *     currentUser: { id: '1', email: 'user@example.com' },
+ *     workspaceId: 'ws-123',
+ *     orgId: 'org-123',
+ *     apiGatewayUrl: 'https://api.example.com/tenant/graphql',
+ *     authToken: 'token',
+ *     stripePublishableKey: 'pk_test_...',
+ *     razorpayKey: 'rzp_test_...',
+ *   };
+ *
+ *   return <BillingRoot {...props} />;
+ * }
+ * ```
+ */
+export { BillingRoot } from './BillingRoot';
+export type { BillingRootProps, SubscriptionSummary, PaymentSummary, SubscriptionStatus, InvoiceStatus, PaymentStatus, PaymentMethodType, PaymentGateway, PlanInterval, PricingModel, TransactionType, UsageDimension, UsagePeriod, ViewMode, BillingAccount, Plan, PlanFeature, Subscription, Invoice, InvoiceLineItem, Payment, PaymentMethod, UsageRecord, Transaction, RevenueMetrics, } from './types';
+export { useBilling } from './providers/BillingProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/billing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,WAAW,EACX,QAAQ,EACR,cAAc,EACd,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,OAAO,EACP,eAAe,EACf,OAAO,EACP,aAAa,EACb,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/billing/lib/native-purchases.d.ts

@@ -0,0 +1,51 @@
+import { PURCHASE_TYPE, Product, Transaction } from '@capgo/native-purchases';
+
+export type { Product as NativeProduct, Transaction as NativeTransaction };
+export type { PURCHASE_TYPE as NativePurchaseType };
+/** True when running inside a Capacitor iOS or Android app. */
+export declare function isNativeIAPAvailable(): boolean;
+/**
+ * Fetch product info from the App Store / Play Store for the given identifiers.
+ * Returns an empty array on web or if the store lookup fails.
+ */
+export declare function getNativeProducts(productIdentifiers: string[], productType?: PURCHASE_TYPE): Promise<Product[]>;
+/**
+ * Initiate a native purchase for the given product identifier.
+ *
+ * The returned Transaction contains the receipt (iOS legacy), jwsRepresentation
+ * (iOS StoreKit 2), or purchaseToken (Android) — send these to the backend for
+ * server-side validation before granting entitlements.
+ *
+ * Throws if the user cancels or the purchase fails.
+ */
+export declare function purchaseNativeProduct(productIdentifier: string, options?: {
+    planIdentifier?: string;
+    productType?: PURCHASE_TYPE;
+    quantity?: number;
+    appAccountToken?: string;
+    isConsumable?: boolean;
+    /** Set false to defer acknowledgment until backend validation completes. */
+    autoAcknowledgePurchases?: boolean;
+}): Promise<Transaction>;
+/**
+ * Manually acknowledge/finish a transaction after server-side validation.
+ * Only needed when purchaseNativeProduct was called with autoAcknowledgePurchases: false.
+ *
+ * @param purchaseToken - purchaseToken (Android) or transactionId (iOS)
+ */
+export declare function acknowledgeNativePurchase(purchaseToken: string): Promise<void>;
+/**
+ * Restore previously completed purchases.
+ * Required by App Store guidelines to be accessible in the UI.
+ */
+export declare function restoreNativePurchases(): Promise<void>;
+/**
+ * Return all purchases recorded for the current user on this device.
+ * Useful for checking active entitlements without a backend call.
+ */
+export declare function getNativePurchases(options?: {
+    productType?: PURCHASE_TYPE;
+    appAccountToken?: string;
+    onlyCurrentEntitlements?: boolean;
+}): Promise<Transaction[]>;
+//# sourceMappingURL=native-purchases.d.ts.map

package/dist/billing/lib/native-purchases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-purchases.d.ts","sourceRoot":"","sources":["../../../src/billing/lib/native-purchases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGnF,YAAY,EAAE,OAAO,IAAI,aAAa,EAAE,WAAW,IAAI,iBAAiB,EAAE,CAAC;AAC3E,YAAY,EAAE,aAAa,IAAI,kBAAkB,EAAE,CAAC;AAIpD,+DAA+D;AAC/D,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAkBD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,kBAAkB,EAAE,MAAM,EAAE,EAC5B,WAAW,CAAC,EAAE,aAAa,GAC1B,OAAO,CAAC,OAAO,EAAE,CAAC,CAKpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,iBAAiB,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4EAA4E;IAC5E,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GACA,OAAO,CAAC,WAAW,CAAC,CAItB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAI5D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IACjD,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAKzB"}

package/dist/billing/lib/native-purchases.js

@@ -0,0 +1,44 @@
+import { Capacitor as e } from "../../node_modules/@capacitor/core/dist/index.js";
+//#region src/billing/lib/native-purchases.ts
+function t() {
+	return e.isNativePlatform();
+}
+async function n() {
+	if (!e.isNativePlatform()) return null;
+	try {
+		let e = await import(
+			/* @vite-ignore */
+			"@capgo/native-purchases"
+);
+		return e.NativePurchases ?? e.default ?? null;
+	} catch {
+		return null;
+	}
+}
+async function r(e, t) {
+	let r = await n();
+	return !r || e.length === 0 ? [] : (await r.getProducts({
+		productIdentifiers: e,
+		productType: t
+	})).products ?? [];
+}
+async function i(e, t) {
+	let r = await n();
+	if (!r) throw Error("Native purchases not available on this platform");
+	return r.purchaseProduct({
+		productIdentifier: e,
+		...t
+	});
+}
+async function a(e) {
+	let t = await n();
+	t && await t.acknowledgePurchase({ purchaseToken: e });
+}
+async function o() {
+	let e = await n();
+	e && await e.restorePurchases();
+}
+//#endregion
+export { a as acknowledgeNativePurchase, r as getNativeProducts, t as isNativeIAPAvailable, i as purchaseNativeProduct, o as restoreNativePurchases };
+
+//# sourceMappingURL=native-purchases.js.map

package/dist/billing/lib/native-purchases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-purchases.js","names":[],"sources":["../../../src/billing/lib/native-purchases.ts"],"sourcesContent":["/**\n * Native in-app purchase bridge for Apple StoreKit and Google Play Billing.\n *\n * Uses @capgo/native-purchases (direct StoreKit 2 / Play Billing Library integration)\n * when running inside a Capacitor native app. Falls back to null on web so callers\n * can route to the normal Stripe/Razorpay checkout instead.\n *\n * After a successful purchase the frontend sends the receipt / JWS / purchase token\n * to the backend via POST /rest/billing/iap/validate, which validates with Apple/Google\n * servers and activates the subscription or credits — no RevenueCat account required.\n */\n\nimport { Capacitor } from '@capacitor/core';\nimport type { PURCHASE_TYPE, Product, Transaction } from '@capgo/native-purchases';\n\n// Re-export plugin types with billing-domain-friendly aliases\nexport type { Product as NativeProduct, Transaction as NativeTransaction };\nexport type { PURCHASE_TYPE as NativePurchaseType };\n\n// ─── Platform check ───────────────────────────────────────────────────────────\n\n/** True when running inside a Capacitor iOS or Android app. */\nexport function isNativeIAPAvailable(): boolean {\n  return Capacitor.isNativePlatform();\n}\n\n// ─── Plugin loader ────────────────────────────────────────────────────────────\n\n// Dynamically imported so the web bundle doesn't fail when the native plugin\n// is absent.\nasync function getPlugin() {\n  if (!Capacitor.isNativePlatform()) return null;\n  try {\n    const mod = await import(/* @vite-ignore */ '@capgo/native-purchases');\n    return mod.NativePurchases ?? mod.default ?? null;\n  } catch {\n    return null;\n  }\n}\n\n// ─── Public API ───────────────────────────────────────────────────────────────\n\n/**\n * Fetch product info from the App Store / Play Store for the given identifiers.\n * Returns an empty array on web or if the store lookup fails.\n */\nexport async function getNativeProducts(\n  productIdentifiers: string[],\n  productType?: PURCHASE_TYPE\n): Promise<Product[]> {\n  const plugin = await getPlugin();\n  if (!plugin || productIdentifiers.length === 0) return [];\n  const result = await plugin.getProducts({ productIdentifiers, productType });\n  return result.products ?? [];\n}\n\n/**\n * Initiate a native purchase for the given product identifier.\n *\n * The returned Transaction contains the receipt (iOS legacy), jwsRepresentation\n * (iOS StoreKit 2), or purchaseToken (Android) — send these to the backend for\n * server-side validation before granting entitlements.\n *\n * Throws if the user cancels or the purchase fails.\n */\nexport async function purchaseNativeProduct(\n  productIdentifier: string,\n  options?: {\n    planIdentifier?: string;\n    productType?: PURCHASE_TYPE;\n    quantity?: number;\n    appAccountToken?: string;\n    isConsumable?: boolean;\n    /** Set false to defer acknowledgment until backend validation completes. */\n    autoAcknowledgePurchases?: boolean;\n  }\n): Promise<Transaction> {\n  const plugin = await getPlugin();\n  if (!plugin) throw new Error('Native purchases not available on this platform');\n  return plugin.purchaseProduct({ productIdentifier, ...options });\n}\n\n/**\n * Manually acknowledge/finish a transaction after server-side validation.\n * Only needed when purchaseNativeProduct was called with autoAcknowledgePurchases: false.\n *\n * @param purchaseToken - purchaseToken (Android) or transactionId (iOS)\n */\nexport async function acknowledgeNativePurchase(purchaseToken: string): Promise<void> {\n  const plugin = await getPlugin();\n  if (!plugin) return;\n  await plugin.acknowledgePurchase({ purchaseToken });\n}\n\n/**\n * Restore previously completed purchases.\n * Required by App Store guidelines to be accessible in the UI.\n */\nexport async function restoreNativePurchases(): Promise<void> {\n  const plugin = await getPlugin();\n  if (!plugin) return;\n  await plugin.restorePurchases();\n}\n\n/**\n * Return all purchases recorded for the current user on this device.\n * Useful for checking active entitlements without a backend call.\n */\nexport async function getNativePurchases(options?: {\n  productType?: PURCHASE_TYPE;\n  appAccountToken?: string;\n  onlyCurrentEntitlements?: boolean;\n}): Promise<Transaction[]> {\n  const plugin = await getPlugin();\n  if (!plugin) return [];\n  const result = await plugin.getPurchases(options);\n  return result.purchases ?? [];\n}\n"],"mappings":";;AAsBA,SAAgB,IAAgC;AAC9C,QAAO,EAAU,kBAAkB;;AAOrC,eAAe,IAAY;AACzB,KAAI,CAAC,EAAU,kBAAkB,CAAE,QAAO;AAC1C,KAAI;EACF,IAAM,IAAM,MAAM;;GAA0B;;AAC5C,SAAO,EAAI,mBAAmB,EAAI,WAAW;SACvC;AACN,SAAO;;;AAUX,eAAsB,EACpB,GACA,GACoB;CACpB,IAAM,IAAS,MAAM,GAAW;AAGhC,QAFI,CAAC,KAAU,EAAmB,WAAW,IAAU,EAAE,IAC1C,MAAM,EAAO,YAAY;EAAE;EAAoB;EAAa,CAAC,EAC9D,YAAY,EAAE;;AAY9B,eAAsB,EACpB,GACA,GASsB;CACtB,IAAM,IAAS,MAAM,GAAW;AAChC,KAAI,CAAC,EAAQ,OAAU,MAAM,kDAAkD;AAC/E,QAAO,EAAO,gBAAgB;EAAE;EAAmB,GAAG;EAAS,CAAC;;AASlE,eAAsB,EAA0B,GAAsC;CACpF,IAAM,IAAS,MAAM,GAAW;AAC3B,MACL,MAAM,EAAO,oBAAoB,EAAE,kBAAe,CAAC;;AAOrD,eAAsB,IAAwC;CAC5D,IAAM,IAAS,MAAM,GAAW;AAC3B,MACL,MAAM,EAAO,kBAAkB"}