@clerk/shared 4.32.0-snapshot.v20260904162929 → 4.32.0

package/dist/react/index.mjs

@@ -2,7 +2,7 @@ import { isReverificationHint, reverificationError } from "../authorization-erro
 import { validateReverificationConfig } from "../authorization.mjs";
 import { deriveFromSsrInitialState } from "../deriveState.mjs";
 import { t as ClerkRuntimeError } from "../_chunks/clerkRuntimeError-DlesLWqO.mjs";
-import { C as isClerkAPIResponseError } from "../_chunks/error-CYyD2kei.mjs";
+import { C as isClerkAPIResponseError } from "../_chunks/error-wrUdW78M.mjs";
 import { logger } from "../logger.mjs";
 import { getCurrentOrganizationMembership } from "../organization.mjs";
 import { a as eventMethodCalled } from "../_chunks/telemetry-9C6N5ppw.mjs";
@@ -157,6 +157,8 @@ 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 ORGANIZATION_DIRECTORY_SYNC_KEY = "organizationDirectorySync";
+const ORGANIZATION_DIRECTORY_SYNC_USERS_KEY = "organizationDirectorySyncUsers";
 const CREDIT_HISTORY_KEY = "billing-credit-history";
 const INTERNAL_STABLE_KEYS = {
 	PAYMENT_ATTEMPT_KEY,
@@ -167,7 +169,9 @@ const INTERNAL_STABLE_KEYS = {
 	ENTERPRISE_CONNECTION_TEST_RUNS_KEY,
 	ORGANIZATION_ENTERPRISE_CONNECTIONS_KEY,
 	ORGANIZATION_ENTERPRISE_CONNECTION_TEST_RUNS_KEY,
-	ORGANIZATION_DOMAINS_KEY
+	ORGANIZATION_DOMAINS_KEY,
+	ORGANIZATION_DIRECTORY_SYNC_KEY,
+	ORGANIZATION_DIRECTORY_SYNC_USERS_KEY
 };
 
 //#endregion
@@ -1077,7 +1081,7 @@ function useSessionBase() {
 *
 * @example
 *
-* The following example uses the `useClerk()` hook to access the `clerk` object. The `clerk` object is used to call the [`openSignIn()`](https://clerk.com/docs/reference/objects/clerk#sign-in) method to open the sign-in modal.
+* The following example uses the `useClerk()` hook to access the `clerk` object. The `clerk` object is used to call the [`openSignIn()`](https://clerk.com/docs/reference/objects/clerk#opensignin) method to open the sign-in modal.
 *
 * <Tabs items='React,Next.js'>
 * <Tab>
@@ -3177,6 +3181,189 @@ function useOrganizationDomains(params = {}) {
 	};
 }
 
+//#endregion
+//#region src/react/hooks/useOrganizationDirectorySync.shared.ts
+/**
+* @internal
+*/
+function useOrganizationDirectorySyncCacheKeys(params) {
+	const { organizationId, enterpriseConnectionId } = params;
+	return useMemo(() => {
+		return createCacheKeys({
+			stablePrefix: INTERNAL_STABLE_KEYS.ORGANIZATION_DIRECTORY_SYNC_KEY,
+			authenticated: Boolean(organizationId),
+			tracked: {
+				organizationId: organizationId ?? null,
+				enterpriseConnectionId: enterpriseConnectionId ?? null
+			},
+			untracked: { args: {} }
+		});
+	}, [organizationId, enterpriseConnectionId]);
+}
+/**
+* @internal
+*/
+function useOrganizationDirectorySyncUsersCacheKeys(params) {
+	const { organizationId, enterpriseConnectionId, directoryId, args } = params;
+	return useMemo(() => {
+		return createCacheKeys({
+			stablePrefix: INTERNAL_STABLE_KEYS.ORGANIZATION_DIRECTORY_SYNC_USERS_KEY,
+			authenticated: Boolean(organizationId),
+			tracked: {
+				organizationId: organizationId ?? null,
+				enterpriseConnectionId: enterpriseConnectionId ?? null,
+				directoryId: directoryId ?? null
+			},
+			untracked: { args }
+		});
+	}, [
+		organizationId,
+		enterpriseConnectionId,
+		directoryId,
+		JSON.stringify(args)
+	]);
+}
+
+//#endregion
+//#region src/react/hooks/useOrganizationDirectorySync.tsx
+/**
+* The Directory Sync directory bound to an enterprise connection of the active organization.
+*
+* @internal
+*/
+function useOrganizationDirectorySync(params) {
+	const { enterpriseConnectionId, enabled = true } = params;
+	const clerk = useClerkInstanceContext();
+	const organization = useOrganizationBase();
+	const [queryClient] = useClerkQueryClient();
+	const { queryKey, invalidationKey, stableKey, authenticated } = useOrganizationDirectorySyncCacheKeys({
+		organizationId: organization?.id ?? null,
+		enterpriseConnectionId
+	});
+	const queryEnabled = enabled && clerk.loaded && Boolean(organization) && Boolean(enterpriseConnectionId);
+	useClearQueriesOnSignOut({
+		isSignedOut: organization === null,
+		authenticated,
+		stableKeys: stableKey
+	});
+	const query = useClerkQuery({
+		queryKey,
+		queryFn: async () => {
+			if (!enterpriseConnectionId) throw new Error("enterpriseConnectionId is required to fetch the directory");
+			try {
+				return await organization?.getDirectorySync(enterpriseConnectionId) ?? null;
+			} catch (err) {
+				if (isClerkAPIResponseError(err) && err.status === 404) return null;
+				throw err;
+			}
+		},
+		enabled: queryEnabled
+	});
+	const revalidate = useCallback(() => queryClient.invalidateQueries({ queryKey: invalidationKey }), [queryClient, invalidationKey]);
+	const createDirectorySync = useCallback(async (createParams) => {
+		if (!enterpriseConnectionId) return;
+		const created = await organization?.createDirectorySync(enterpriseConnectionId, createParams);
+		await revalidate();
+		return created;
+	}, [
+		organization,
+		enterpriseConnectionId,
+		revalidate
+	]);
+	const directory = query.data;
+	const updateDirectorySync = useCallback(async (updateParams) => {
+		if (!directory) return;
+		const updated = await directory.update(updateParams);
+		await revalidate();
+		return updated;
+	}, [directory, revalidate]);
+	const rotateDirectorySyncToken = useCallback(async () => {
+		if (!directory) return;
+		const rotated = await directory.rotateToken();
+		await revalidate();
+		return rotated;
+	}, [directory, revalidate]);
+	const deleteDirectorySync = useCallback(async () => {
+		if (!directory) return;
+		const deleted = await directory.delete();
+		await revalidate();
+		return deleted;
+	}, [directory, revalidate]);
+	return {
+		data: query.data,
+		error: query.error ?? null,
+		isLoading: query.isLoading,
+		isFetching: query.isFetching,
+		createDirectorySync,
+		updateDirectorySync,
+		rotateDirectorySyncToken,
+		deleteDirectorySync,
+		revalidate
+	};
+}
+
+//#endregion
+//#region src/react/hooks/useOrganizationDirectorySyncUsers.tsx
+const DEFAULT_POLL_INTERVAL_MS$1 = 2e3;
+/**
+* The users provisioned into an enterprise connection's Directory Sync
+* directory, most recently touched first. Polling is opt-in via `poll`, which
+* lets the setup flow use the list as a live activity feed.
+*
+* @internal
+*/
+function useOrganizationDirectorySyncUsers(params) {
+	const { directory, params: fetchParams = {
+		initialPage: 1,
+		pageSize: 10
+	}, poll = false, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS$1, enabled = true, keepPreviousData = true } = params;
+	const clerk = useClerkInstanceContext();
+	const organization = useOrganizationBase();
+	const [queryClient] = useClerkQueryClient();
+	const enterpriseConnectionId = directory?.enterpriseConnectionId ?? null;
+	const directoryId = directory?.id ?? null;
+	const { queryKey, invalidationKey, stableKey, authenticated } = useOrganizationDirectorySyncUsersCacheKeys({
+		organizationId: organization?.id ?? null,
+		enterpriseConnectionId,
+		directoryId,
+		args: fetchParams
+	});
+	useClearQueriesOnSignOut({
+		isSignedOut: organization === null,
+		authenticated,
+		stableKeys: stableKey
+	});
+	const queryEnabled = enabled && clerk.loaded && Boolean(organization) && Boolean(directory);
+	const currentTracked = queryKey[2];
+	const query = useClerkQuery({
+		queryKey,
+		queryFn: () => {
+			if (!directory) throw new Error("directory is required to fetch directory users");
+			return directory.getUsers(fetchParams);
+		},
+		refetchInterval: () => poll ? pollIntervalMs : false,
+		enabled: queryEnabled,
+		refetchIntervalInBackground: false,
+		placeholderData: keepPreviousData ? (previousData, previousQuery) => {
+			const previousTracked = previousQuery?.queryKey[2];
+			return Boolean(currentTracked.organizationId) && Boolean(currentTracked.directoryId) && previousTracked?.organizationId === currentTracked.organizationId && previousTracked?.directoryId === currentTracked.directoryId ? previousData : void 0;
+		} : void 0
+	});
+	const revalidate = useCallback(async () => {
+		await queryClient.invalidateQueries({ queryKey: invalidationKey });
+	}, [queryClient, invalidationKey]);
+	const isPolling = queryEnabled && poll;
+	return {
+		data: queryEnabled ? query.data?.data : void 0,
+		totalCount: queryEnabled ? query.data?.total_count : void 0,
+		error: query.error ?? null,
+		isLoading: query.isLoading,
+		isFetching: query.isFetching,
+		isPolling,
+		revalidate
+	};
+}
+
 //#endregion
 //#region src/react/hooks/useOrganizationEnterpriseConnectionTestRuns.shared.ts
 /**
@@ -3228,9 +3415,10 @@ function useOrganizationEnterpriseConnectionTestRuns(params) {
 		stableKeys: stableKey
 	});
 	const queryEnabled = enabled && clerk.loaded && Boolean(organization) && Boolean(enterpriseConnectionId);
-	const [shouldPoll, setShouldPoll] = useState(false);
+	const [pollingConnectionId, setPollingConnectionId] = useState(null);
+	const shouldPoll = pollingConnectionId !== null && pollingConnectionId === enterpriseConnectionId;
 	useEffect(() => {
-		setShouldPoll(false);
+		setPollingConnectionId((current) => current !== null && current !== enterpriseConnectionId ? null : current);
 	}, [enterpriseConnectionId]);
 	const query = useClerkQuery({
 		queryKey,
@@ -3248,10 +3436,10 @@ function useOrganizationEnterpriseConnectionTestRuns(params) {
 	});
 	const hasRows = (query.data?.data?.length ?? 0) > 0;
 	useEffect(() => {
-		if (shouldPoll && hasRows) setShouldPoll(false);
+		if (shouldPoll && hasRows) setPollingConnectionId(null);
 	}, [shouldPoll, hasRows]);
 	const revalidate = useCallback(async (options) => {
-		if ((options?.armPolling ?? true) && !hasRows) setShouldPoll(true);
+		if ((options?.armPolling ?? true) && !hasRows) setPollingConnectionId(enterpriseConnectionId);
 		if (options?.exact) await queryClient.invalidateQueries({
 			queryKey,
 			exact: true
@@ -3266,7 +3454,8 @@ function useOrganizationEnterpriseConnectionTestRuns(params) {
 		queryClient,
 		invalidationKey,
 		queryKey,
-		hasRows
+		hasRows,
+		enterpriseConnectionId
 	]);
 	const isPolling = queryEnabled && shouldPoll && !hasRows;
 	return {
@@ -3858,5 +4047,5 @@ const usePortalRoot = () => {
 };
 
 //#endregion
-export { ClerkContextProvider, ClerkInstanceContext, InitialStateProvider, OptionsContext, UNSAFE_PortalProvider, __createClerkTestQueryClient, __experimental_CheckoutProvider, PaymentElement as __experimental_PaymentElement, PaymentElementProvider as __experimental_PaymentElementProvider, useCheckout as __experimental_useCheckout, usePaymentAttempts as __experimental_usePaymentAttempts, usePaymentElement as __experimental_usePaymentElement, usePaymentMethods as __experimental_usePaymentMethods, usePlans as __experimental_usePlans, useStatements as __experimental_useStatements, useSubscription as __experimental_useSubscription, useClientBase as __internal_useClientBase, __internal_useCreditBalanceQuery, __internal_useCreditHistoryQuery, useOrganizationBase as __internal_useOrganizationBase, useOrganizationDomains as __internal_useOrganizationDomains, useOrganizationEnterpriseConnectionTestRuns as __internal_useOrganizationEnterpriseConnectionTestRuns, useOrganizationEnterpriseConnections as __internal_useOrganizationEnterpriseConnections, usePaymentAttemptQuery as __internal_usePaymentAttemptQuery, __internal_usePlanDetailsQuery, useSessionBase as __internal_useSessionBase, useStatementQuery as __internal_useStatementQuery, useUserBase as __internal_useUserBase, useUserEnterpriseConnections as __internal_useUserEnterpriseConnections, __resetClerkQueryClientForTest, __setClerkQueryClientForTest, assertContextExists, createContextAndHook, getClerkQueryClient, isDeeplyEqual, useAPIKeys, useAssertWrappedByClerkProvider, useAttemptToEnableOrganizations, useClerk, useClerkInstanceContext, useDeepEqualMemo, useInitialStateContext, useOAuthConsent, useOAuthDeviceVerification, useOptionsContext, useOrganization, useOrganizationCreationDefaults, useOrganizationList, usePortalRoot, useReverification, useSafeLayoutEffect, useSession, useSessionList, useUser };
+export { ClerkContextProvider, ClerkInstanceContext, InitialStateProvider, OptionsContext, UNSAFE_PortalProvider, __createClerkTestQueryClient, __experimental_CheckoutProvider, PaymentElement as __experimental_PaymentElement, PaymentElementProvider as __experimental_PaymentElementProvider, useCheckout as __experimental_useCheckout, usePaymentAttempts as __experimental_usePaymentAttempts, usePaymentElement as __experimental_usePaymentElement, usePaymentMethods as __experimental_usePaymentMethods, usePlans as __experimental_usePlans, useStatements as __experimental_useStatements, useSubscription as __experimental_useSubscription, useClientBase as __internal_useClientBase, __internal_useCreditBalanceQuery, __internal_useCreditHistoryQuery, useOrganizationBase as __internal_useOrganizationBase, useOrganizationDirectorySync as __internal_useOrganizationDirectorySync, useOrganizationDirectorySyncUsers as __internal_useOrganizationDirectorySyncUsers, useOrganizationDomains as __internal_useOrganizationDomains, useOrganizationEnterpriseConnectionTestRuns as __internal_useOrganizationEnterpriseConnectionTestRuns, useOrganizationEnterpriseConnections as __internal_useOrganizationEnterpriseConnections, usePaymentAttemptQuery as __internal_usePaymentAttemptQuery, __internal_usePlanDetailsQuery, useSessionBase as __internal_useSessionBase, useStatementQuery as __internal_useStatementQuery, useUserBase as __internal_useUserBase, useUserEnterpriseConnections as __internal_useUserEnterpriseConnections, __resetClerkQueryClientForTest, __setClerkQueryClientForTest, assertContextExists, createContextAndHook, getClerkQueryClient, isDeeplyEqual, useAPIKeys, useAssertWrappedByClerkProvider, useAttemptToEnableOrganizations, useClerk, useClerkInstanceContext, useDeepEqualMemo, useInitialStateContext, useOAuthConsent, useOAuthDeviceVerification, useOptionsContext, useOrganization, useOrganizationCreationDefaults, useOrganizationList, usePortalRoot, useReverification, useSafeLayoutEffect, useSession, useSessionList, useUser };
 //# sourceMappingURL=index.mjs.map