@clerk/shared 4.22.2-snapshot.v20260630200444 → 4.23.0

package/dist/react/index.js

@@ -128,6 +128,7 @@ const SUBSCRIPTION_KEY = "billing-subscription";
 const PAYMENT_METHODS_KEY = "billing-payment-methods";
 const PAYMENT_ATTEMPTS_KEY = "billing-payment-attempts";
 const STATEMENTS_KEY = "billing-statements";
+const CREDIT_BALANCE_KEY = "billing-credit-balance";
 const STABLE_KEYS = {
 	USER_MEMBERSHIPS_KEY,
 	USER_INVITATIONS_KEY,
@@ -143,7 +144,8 @@ const STABLE_KEYS = {
 	STATEMENTS_KEY,
 	API_KEYS_KEY,
 	ORGANIZATION_CREATION_DEFAULTS_KEY,
-	OAUTH_CONSENT_INFO_KEY
+	OAUTH_CONSENT_INFO_KEY,
+	CREDIT_BALANCE_KEY
 };
 /**
 * Internal stable keys for queries only used by our UI components.
@@ -157,10 +159,12 @@ const ENTERPRISE_CONNECTION_TEST_RUNS_KEY = "enterpriseConnectionTestRuns";
 const ORGANIZATION_ENTERPRISE_CONNECTIONS_KEY = "organizationEnterpriseConnections";
 const ORGANIZATION_ENTERPRISE_CONNECTION_TEST_RUNS_KEY = "organizationEnterpriseConnectionTestRuns";
 const ORGANIZATION_DOMAINS_KEY = "organizationDomains";
+const CREDIT_HISTORY_KEY = "billing-credit-history";
 const INTERNAL_STABLE_KEYS = {
 	PAYMENT_ATTEMPT_KEY,
 	BILLING_PLANS_KEY,
 	BILLING_STATEMENTS_KEY,
+	CREDIT_HISTORY_KEY,
 	USER_ENTERPRISE_CONNECTIONS_KEY,
 	ENTERPRISE_CONNECTION_TEST_RUNS_KEY,
 	ORGANIZATION_ENTERPRISE_CONNECTIONS_KEY,
@@ -848,7 +852,7 @@ function useOAuthConsentCacheKeys(params) {
 
 //#endregion
 //#region src/react/hooks/useOAuthConsent.tsx
-const HOOK_NAME$2 = "useOAuthConsent";
+const HOOK_NAME$4 = "useOAuthConsent";
 /**
 * The `useOAuthConsent()` hook loads OAuth application consent metadata for the **signed-in** user
 * (`GET /me/oauth/consent/{oauthClientId}`). Ensure the user is authenticated before relying on this hook
@@ -865,12 +869,12 @@ const HOOK_NAME$2 = "useOAuthConsent";
 * ```
 */
 function useOAuthConsent(params) {
-	useAssertWrappedByClerkProvider(HOOK_NAME$2);
+	useAssertWrappedByClerkProvider(HOOK_NAME$4);
 	const { oauthClientId: oauthClientIdParam, scope, redirectUri, keepPreviousData = true, enabled = true } = params;
 	const clerk = useClerkInstanceContext();
 	const user = useUserBase();
 	const oauthClientId = (oauthClientIdParam ?? "").trim();
-	clerk.telemetry?.record(require_telemetry.eventMethodCalled(HOOK_NAME$2));
+	clerk.telemetry?.record(require_telemetry.eventMethodCalled(HOOK_NAME$4));
 	const { queryKey } = useOAuthConsentCacheKeys({
 		userId: user?.id ?? null,
 		oauthClientId,
@@ -1321,7 +1325,7 @@ function useOrganizationCreationDefaultsCacheKeys(params) {
 
 //#endregion
 //#region src/react/hooks/useOrganizationCreationDefaults.tsx
-const HOOK_NAME$1 = "useOrganizationCreationDefaults";
+const HOOK_NAME$3 = "useOrganizationCreationDefaults";
 /**
 * The `useOrganizationCreationDefaults()` hook retrieves the organization creation defaults for the current user.
 *
@@ -1347,12 +1351,12 @@ const HOOK_NAME$1 = "useOrganizationCreationDefaults";
 * ```
 */
 function useOrganizationCreationDefaults(params = {}) {
-	useAssertWrappedByClerkProvider(HOOK_NAME$1);
+	useAssertWrappedByClerkProvider(HOOK_NAME$3);
 	const { keepPreviousData = true, enabled = true } = params;
 	const clerk = useClerkInstanceContext();
 	const user = useUserBase();
 	const featureEnabled = clerk.__internal_environment?.organizationSettings?.organizationCreationDefaults?.enabled ?? false;
-	clerk.telemetry?.record(require_telemetry.eventMethodCalled(HOOK_NAME$1));
+	clerk.telemetry?.record(require_telemetry.eventMethodCalled(HOOK_NAME$3));
 	const { queryKey } = useOrganizationCreationDefaultsCacheKeys({ userId: user?.id ?? null });
 	const queryEnabled = Boolean(user) && enabled && featureEnabled && clerk.loaded;
 	const query = useClerkQuery({
@@ -2377,12 +2381,12 @@ function useSubscriptionCacheKeys(params) {
 
 //#endregion
 //#region src/react/hooks/useSubscription.tsx
-const HOOK_NAME = "useSubscription";
+const HOOK_NAME$2 = "useSubscription";
 /**
 * @internal
 */
 function useSubscription(params) {
-	useAssertWrappedByClerkProvider(HOOK_NAME);
+	useAssertWrappedByClerkProvider(HOOK_NAME$2);
 	const clerk = useClerkInstanceContext();
 	const user = useUserBase();
 	const organization = useOrganizationBase();
@@ -2390,7 +2394,7 @@ function useSubscription(params) {
 	const recordedRef = (0, react.useRef)(false);
 	(0, react.useEffect)(() => {
 		if (!recordedRef.current && clerk?.telemetry) {
-			clerk.telemetry.record(require_telemetry.eventMethodCalled(HOOK_NAME));
+			clerk.telemetry.record(require_telemetry.eventMethodCalled(HOOK_NAME$2));
 			recordedRef.current = true;
 		}
 	}, [clerk]);
@@ -2478,6 +2482,130 @@ const useCheckout = (options) => {
 	return (0, react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
 };
 
+//#endregion
+//#region src/react/hooks/useCreditBalance.tsx
+const HOOK_NAME$1 = "useCreditBalance";
+/**
+* @internal
+*/
+function __internal_useCreditBalanceQuery(params) {
+	useAssertWrappedByClerkProvider(HOOK_NAME$1);
+	const clerk = useClerkInstanceContext();
+	const user = useUserBase();
+	const organization = useOrganizationBase();
+	const billingEnabled = useBillingIsEnabled(params);
+	const recordedRef = (0, react.useRef)(false);
+	(0, react.useEffect)(() => {
+		if (!recordedRef.current && clerk?.telemetry) {
+			clerk.telemetry.record(require_telemetry.eventMethodCalled(HOOK_NAME$1));
+			recordedRef.current = true;
+		}
+	}, [clerk]);
+	const keepPreviousData = params?.keepPreviousData ?? false;
+	const [queryClient] = useClerkQueryClient();
+	const { queryKey, invalidationKey, stableKey, authenticated } = (0, react.useMemo)(() => {
+		const safeOrgId = params?.for === "organization" ? organization?.id : void 0;
+		return createCacheKeys({
+			stablePrefix: STABLE_KEYS.CREDIT_BALANCE_KEY,
+			authenticated: true,
+			tracked: {
+				userId: user?.id,
+				orgId: safeOrgId
+			},
+			untracked: { args: { orgId: safeOrgId } }
+		});
+	}, [
+		user?.id,
+		organization?.id,
+		params?.for
+	]);
+	const queriesEnabled = Boolean(user?.id && billingEnabled && (params?.enabled ?? true));
+	useClearQueriesOnSignOut({
+		isSignedOut: user === null,
+		authenticated,
+		stableKeys: stableKey
+	});
+	const query = useClerkQuery({
+		queryKey,
+		queryFn: ({ queryKey }) => {
+			const obj = queryKey[3];
+			return clerk.billing.getCreditBalance(obj.args);
+		},
+		staleTime: 1e3 * 60,
+		enabled: queriesEnabled,
+		placeholderData: defineKeepPreviousDataFn(keepPreviousData && queriesEnabled)
+	});
+	const revalidate = (0, react.useCallback)(() => queryClient.invalidateQueries({ queryKey: invalidationKey }), [queryClient, invalidationKey]);
+	return {
+		data: query.data,
+		error: query.error ?? void 0,
+		isLoading: query.isLoading,
+		isFetching: query.isFetching,
+		revalidate
+	};
+}
+
+//#endregion
+//#region src/react/hooks/useCreditHistory.tsx
+const HOOK_NAME = "useCreditHistory";
+/**
+* @internal
+*/
+function __internal_useCreditHistoryQuery(params) {
+	useAssertWrappedByClerkProvider(HOOK_NAME);
+	const clerk = useClerkInstanceContext();
+	const user = useUserBase();
+	const organization = useOrganizationBase();
+	const billingEnabled = useBillingIsEnabled(params);
+	const recordedRef = (0, react.useRef)(false);
+	(0, react.useEffect)(() => {
+		if (!recordedRef.current && clerk?.telemetry) {
+			clerk.telemetry.record(require_telemetry.eventMethodCalled(HOOK_NAME));
+			recordedRef.current = true;
+		}
+	}, [clerk]);
+	const [queryClient] = useClerkQueryClient();
+	const { queryKey, invalidationKey, stableKey, authenticated } = (0, react.useMemo)(() => {
+		const safeOrgId = params?.for === "organization" ? organization?.id : void 0;
+		return createCacheKeys({
+			stablePrefix: INTERNAL_STABLE_KEYS.CREDIT_HISTORY_KEY,
+			authenticated: true,
+			tracked: {
+				userId: user?.id,
+				orgId: safeOrgId
+			},
+			untracked: { args: { orgId: safeOrgId } }
+		});
+	}, [
+		user?.id,
+		organization?.id,
+		params?.for
+	]);
+	const queriesEnabled = Boolean(user?.id && billingEnabled && (params?.enabled ?? true));
+	useClearQueriesOnSignOut({
+		isSignedOut: user === null,
+		authenticated,
+		stableKeys: stableKey
+	});
+	const query = useClerkQuery({
+		queryKey,
+		queryFn: ({ queryKey }) => {
+			const obj = queryKey[3];
+			return clerk.billing.getCreditHistory(obj.args);
+		},
+		staleTime: 1e3 * 60,
+		enabled: queriesEnabled
+	});
+	const revalidate = (0, react.useCallback)(() => queryClient.invalidateQueries({ queryKey: invalidationKey }), [queryClient, invalidationKey]);
+	return {
+		data: query.data,
+		error: query.error ?? void 0,
+		isLoading: query.isLoading,
+		isFetching: query.isFetching,
+		revalidate
+	};
+}
+
 //#endregion
 //#region src/react/hooks/useStatementQuery.shared.ts
 function useStatementQueryCacheKeys(params) {
@@ -3600,6 +3728,8 @@ exports.__experimental_usePlans = usePlans;
 exports.__experimental_useStatements = useStatements;
 exports.__experimental_useSubscription = useSubscription;
 exports.__internal_useClientBase = useClientBase;
+exports.__internal_useCreditBalanceQuery = __internal_useCreditBalanceQuery;
+exports.__internal_useCreditHistoryQuery = __internal_useCreditHistoryQuery;
 exports.__internal_useOrganizationBase = useOrganizationBase;
 exports.__internal_useOrganizationDomains = useOrganizationDomains;
 exports.__internal_useOrganizationEnterpriseConnectionTestRuns = useOrganizationEnterpriseConnectionTestRuns;