@clerk/shared 4.32.0-snapshot.v20260904162929 → 4.32.0

package/dist/react/hooks/useOAuthDeviceVerification.types.d.mts

@@ -2,16 +2,45 @@ import { ClerkAPIResponseError } from "../../errors/clerkApiResponseError.mjs";
 import { ClerkRuntimeError } from "../../errors/clerkRuntimeError.mjs";
 import { LookupOAuthDeviceVerificationParams, OAuthDeviceVerificationInfo, OAuthDeviceVerificationResult, SubmitOAuthDeviceVerificationParams } from "../../types/oauthApplication.mjs";
 //#region src/react/hooks/useOAuthDeviceVerification.types.d.ts
-type DecisionParams = Omit<SubmitOAuthDeviceVerificationParams, 'approved'>;
+/**
+ * @interface
+ */
 type UseOAuthDeviceVerificationReturn = {
+  /**
+   * Information about the device authorization returned by the latest successful lookup, or `undefined` if no lookup has succeeded.
+   */
   data: OAuthDeviceVerificationInfo | undefined;
+  /**
+   * The result of the latest approval or denial, or `undefined` if no decision has succeeded.
+   */
   result: OAuthDeviceVerificationResult | undefined;
+  /**
+   * The latest error recorded by a lookup or submission operation, or `null` if no error has been recorded since the state was last cleared. Preflight rejections (Clerk not loaded, or a conflicting request already in progress) reject the returned promise without setting this, so callers must also handle rejections from `lookup`, `approve`, and `deny`.
+   */
   error: ClerkAPIResponseError | ClerkRuntimeError | null;
+  /**
+   * Whether a device authorization lookup is in progress.
+   */
   isLoading: boolean;
+  /**
+   * Whether an approval or denial is in progress.
+   */
   isSubmitting: boolean;
+  /**
+   * Looks up a device authorization by its user code.
+   */
   lookup: (params: LookupOAuthDeviceVerificationParams) => Promise<OAuthDeviceVerificationInfo>;
-  approve: (params: DecisionParams) => Promise<OAuthDeviceVerificationResult>;
+  /**
+   * Approves a device authorization.
+   */
+  approve: (params: Omit<SubmitOAuthDeviceVerificationParams, 'approved'>) => Promise<OAuthDeviceVerificationResult>;
+  /**
+   * Denies a device authorization.
+   */
   deny: (params: LookupOAuthDeviceVerificationParams) => Promise<OAuthDeviceVerificationResult>;
+  /**
+   * Clears the current device authorization state.
+   */
   reset: () => void;
 };
 //#endregion

package/dist/react/hooks/useOAuthDeviceVerification.types.d.ts

@@ -2,16 +2,45 @@ import { ClerkAPIResponseError } from "../../errors/clerkApiResponseError.js";
 import { ClerkRuntimeError } from "../../errors/clerkRuntimeError.js";
 import { LookupOAuthDeviceVerificationParams, OAuthDeviceVerificationInfo, OAuthDeviceVerificationResult, SubmitOAuthDeviceVerificationParams } from "../../types/oauthApplication.js";
 //#region src/react/hooks/useOAuthDeviceVerification.types.d.ts
-type DecisionParams = Omit<SubmitOAuthDeviceVerificationParams, 'approved'>;
+/**
+ * @interface
+ */
 type UseOAuthDeviceVerificationReturn = {
+  /**
+   * Information about the device authorization returned by the latest successful lookup, or `undefined` if no lookup has succeeded.
+   */
   data: OAuthDeviceVerificationInfo | undefined;
+  /**
+   * The result of the latest approval or denial, or `undefined` if no decision has succeeded.
+   */
   result: OAuthDeviceVerificationResult | undefined;
+  /**
+   * The latest error recorded by a lookup or submission operation, or `null` if no error has been recorded since the state was last cleared. Preflight rejections (Clerk not loaded, or a conflicting request already in progress) reject the returned promise without setting this, so callers must also handle rejections from `lookup`, `approve`, and `deny`.
+   */
   error: ClerkAPIResponseError | ClerkRuntimeError | null;
+  /**
+   * Whether a device authorization lookup is in progress.
+   */
   isLoading: boolean;
+  /**
+   * Whether an approval or denial is in progress.
+   */
   isSubmitting: boolean;
+  /**
+   * Looks up a device authorization by its user code.
+   */
   lookup: (params: LookupOAuthDeviceVerificationParams) => Promise<OAuthDeviceVerificationInfo>;
-  approve: (params: DecisionParams) => Promise<OAuthDeviceVerificationResult>;
+  /**
+   * Approves a device authorization.
+   */
+  approve: (params: Omit<SubmitOAuthDeviceVerificationParams, 'approved'>) => Promise<OAuthDeviceVerificationResult>;
+  /**
+   * Denies a device authorization.
+   */
   deny: (params: LookupOAuthDeviceVerificationParams) => Promise<OAuthDeviceVerificationResult>;
+  /**
+   * Clears the current device authorization state.
+   */
   reset: () => void;
 };
 //#endregion

package/dist/react/hooks/useOrganization.d.mts

@@ -59,7 +59,7 @@ type UseOrganizationParams = {
  */
 type UseOrganizationReturn<T extends UseOrganizationParams> = {
   /**
-   * Indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads, and can revert to `false` while auth state is updating (e.g., when switching organizations via [`setActive()`](https://clerk.com/docs/reference/objects/clerk#set-active)).
+   * Indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads, and can revert to `false` while auth state is updating (e.g., when switching organizations via [`setActive()`](https://clerk.com/docs/reference/objects/clerk#setactive)).
    */
   isLoaded: false;
   /**

package/dist/react/hooks/useOrganization.d.ts

@@ -59,7 +59,7 @@ type UseOrganizationParams = {
  */
 type UseOrganizationReturn<T extends UseOrganizationParams> = {
   /**
-   * Indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads, and can revert to `false` while auth state is updating (e.g., when switching organizations via [`setActive()`](https://clerk.com/docs/reference/objects/clerk#set-active)).
+   * Indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads, and can revert to `false` while auth state is updating (e.g., when switching organizations via [`setActive()`](https://clerk.com/docs/reference/objects/clerk#setactive)).
    */
   isLoaded: false;
   /**

package/dist/react/hooks/useOrganizationDirectorySync.d.mts

@@ -0,0 +1,27 @@
+import { DeletedObjectResource } from "../../types/deletedObject.mjs";
+import { CreateDirectorySyncParams, DirectorySyncResource, UpdateDirectorySyncParams } from "../../types/directorySync.mjs";
+
+//#region src/react/hooks/useOrganizationDirectorySync.d.ts
+type UseOrganizationDirectorySyncParams = {
+  enterpriseConnectionId: string | null;
+  enabled?: boolean;
+};
+type UseOrganizationDirectorySyncReturn = {
+  /** The connection's directory, `null` when none has been created yet, `undefined` while loading. */data: DirectorySyncResource | null | undefined;
+  error: Error | null;
+  isLoading: boolean;
+  isFetching: boolean;
+  createDirectorySync: (params?: CreateDirectorySyncParams) => Promise<DirectorySyncResource | undefined>; /** Resolves `undefined` until `data` has loaded, since the mutations act on the loaded directory. */
+  updateDirectorySync: (params: UpdateDirectorySyncParams) => Promise<DirectorySyncResource | undefined>;
+  rotateDirectorySyncToken: () => Promise<DirectorySyncResource | undefined>;
+  deleteDirectorySync: () => Promise<DeletedObjectResource | undefined>;
+  revalidate: () => Promise<void>;
+};
+/**
+ * The Directory Sync directory bound to an enterprise connection of the active organization.
+ *
+ * @internal
+ */
+declare function useOrganizationDirectorySync(params: UseOrganizationDirectorySyncParams): UseOrganizationDirectorySyncReturn;
+//#endregion
+export { UseOrganizationDirectorySyncParams, UseOrganizationDirectorySyncReturn, useOrganizationDirectorySync };

package/dist/react/hooks/useOrganizationDirectorySync.d.ts

@@ -0,0 +1,27 @@
+import { DeletedObjectResource } from "../../types/deletedObject.js";
+import { CreateDirectorySyncParams, DirectorySyncResource, UpdateDirectorySyncParams } from "../../types/directorySync.js";
+
+//#region src/react/hooks/useOrganizationDirectorySync.d.ts
+type UseOrganizationDirectorySyncParams = {
+  enterpriseConnectionId: string | null;
+  enabled?: boolean;
+};
+type UseOrganizationDirectorySyncReturn = {
+  /** The connection's directory, `null` when none has been created yet, `undefined` while loading. */data: DirectorySyncResource | null | undefined;
+  error: Error | null;
+  isLoading: boolean;
+  isFetching: boolean;
+  createDirectorySync: (params?: CreateDirectorySyncParams) => Promise<DirectorySyncResource | undefined>; /** Resolves `undefined` until `data` has loaded, since the mutations act on the loaded directory. */
+  updateDirectorySync: (params: UpdateDirectorySyncParams) => Promise<DirectorySyncResource | undefined>;
+  rotateDirectorySyncToken: () => Promise<DirectorySyncResource | undefined>;
+  deleteDirectorySync: () => Promise<DeletedObjectResource | undefined>;
+  revalidate: () => Promise<void>;
+};
+/**
+ * The Directory Sync directory bound to an enterprise connection of the active organization.
+ *
+ * @internal
+ */
+declare function useOrganizationDirectorySync(params: UseOrganizationDirectorySyncParams): UseOrganizationDirectorySyncReturn;
+//#endregion
+export { UseOrganizationDirectorySyncParams, UseOrganizationDirectorySyncReturn, useOrganizationDirectorySync };

package/dist/react/hooks/useOrganizationDirectorySync.js

@@ -0,0 +1,89 @@
+const require_clerkApiResponseError = require('../../errors/clerkApiResponseError.js');
+require('../../error.js');
+const require_contexts = require('../contexts.js');
+const require_use_clerk_query_client = require('../query/use-clerk-query-client.js');
+const require_useQuery = require('../query/useQuery.js');
+const require_useClearQueriesOnSignOut = require('./useClearQueriesOnSignOut.js');
+const require_useOrganizationBase = require('./base/useOrganizationBase.js');
+const require_useOrganizationDirectorySync_shared = require('./useOrganizationDirectorySync.shared.js');
+let react = require("react");
+
+//#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 = require_contexts.useClerkInstanceContext();
+	const organization = require_useOrganizationBase.useOrganizationBase();
+	const [queryClient] = require_use_clerk_query_client.useClerkQueryClient();
+	const { queryKey, invalidationKey, stableKey, authenticated } = require_useOrganizationDirectorySync_shared.useOrganizationDirectorySyncCacheKeys({
+		organizationId: organization?.id ?? null,
+		enterpriseConnectionId
+	});
+	const queryEnabled = enabled && clerk.loaded && Boolean(organization) && Boolean(enterpriseConnectionId);
+	require_useClearQueriesOnSignOut.useClearQueriesOnSignOut({
+		isSignedOut: organization === null,
+		authenticated,
+		stableKeys: stableKey
+	});
+	const query = require_useQuery.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 (require_clerkApiResponseError.isClerkAPIResponseError(err) && err.status === 404) return null;
+				throw err;
+			}
+		},
+		enabled: queryEnabled
+	});
+	const revalidate = (0, react.useCallback)(() => queryClient.invalidateQueries({ queryKey: invalidationKey }), [queryClient, invalidationKey]);
+	const createDirectorySync = (0, react.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 = (0, react.useCallback)(async (updateParams) => {
+		if (!directory) return;
+		const updated = await directory.update(updateParams);
+		await revalidate();
+		return updated;
+	}, [directory, revalidate]);
+	const rotateDirectorySyncToken = (0, react.useCallback)(async () => {
+		if (!directory) return;
+		const rotated = await directory.rotateToken();
+		await revalidate();
+		return rotated;
+	}, [directory, revalidate]);
+	const deleteDirectorySync = (0, react.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
+exports.useOrganizationDirectorySync = useOrganizationDirectorySync;

package/dist/react/hooks/useOrganizationDirectorySync.shared.js

@@ -0,0 +1,49 @@
+const require_stable_keys = require('../stable-keys.js');
+const require_createCacheKeys = require('./createCacheKeys.js');
+let react = require("react");
+
+//#region src/react/hooks/useOrganizationDirectorySync.shared.ts
+/**
+* @internal
+*/
+function useOrganizationDirectorySyncCacheKeys(params) {
+	const { organizationId, enterpriseConnectionId } = params;
+	return (0, react.useMemo)(() => {
+		return require_createCacheKeys.createCacheKeys({
+			stablePrefix: require_stable_keys.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 (0, react.useMemo)(() => {
+		return require_createCacheKeys.createCacheKeys({
+			stablePrefix: require_stable_keys.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
+exports.useOrganizationDirectorySyncCacheKeys = useOrganizationDirectorySyncCacheKeys;
+exports.useOrganizationDirectorySyncUsersCacheKeys = useOrganizationDirectorySyncUsersCacheKeys;

package/dist/react/hooks/useOrganizationDirectorySyncUsers.d.mts

@@ -0,0 +1,53 @@
+import { DirectorySyncResource, DirectorySyncUserResource, GetDirectorySyncUsersParams } from "../../types/directorySync.mjs";
+
+//#region src/react/hooks/useOrganizationDirectorySyncUsers.d.ts
+type UseOrganizationDirectorySyncUsersParams = {
+  /** The directory to list users for, e.g. `data` from `useOrganizationDirectorySync`. Nothing is fetched while `null` or `undefined`. */directory: DirectorySyncResource | null | undefined;
+  /**
+   * Pass-through fetch parameters (pagination).
+   * Defaults to `{ initialPage: 1, pageSize: 10 }`.
+   */
+  params?: GetDirectorySyncUsersParams;
+  /**
+   * Poll the list for changes while `true`. Tie this to the view that needs the
+   * live feed so polling stops when that view goes away.
+   *
+   * @default false
+   */
+  poll?: boolean;
+  /**
+   * Polling interval (ms) used while `poll` is `true`.
+   *
+   * @default 2000
+   */
+  pollIntervalMs?: number;
+  /**
+   * If `false`, nothing is fetched and polling is paused.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  keepPreviousData?: boolean;
+};
+type UseOrganizationDirectorySyncUsersReturn = {
+  /** `undefined` while loading and while the hook is disabled. */data: DirectorySyncUserResource[] | undefined;
+  totalCount: number | undefined;
+  error: Error | null;
+  isLoading: boolean;
+  isFetching: boolean; /** `true` while the hook is polling. */
+  isPolling: boolean;
+  /**
+   * Force a refetch.
+   */
+  revalidate: () => Promise<void>;
+};
+/**
+ * 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
+ */
+declare function useOrganizationDirectorySyncUsers(params: UseOrganizationDirectorySyncUsersParams): UseOrganizationDirectorySyncUsersReturn;
+//#endregion
+export { UseOrganizationDirectorySyncUsersParams, UseOrganizationDirectorySyncUsersReturn, useOrganizationDirectorySyncUsers };

package/dist/react/hooks/useOrganizationDirectorySyncUsers.d.ts

@@ -0,0 +1,53 @@
+import { DirectorySyncResource, DirectorySyncUserResource, GetDirectorySyncUsersParams } from "../../types/directorySync.js";
+
+//#region src/react/hooks/useOrganizationDirectorySyncUsers.d.ts
+type UseOrganizationDirectorySyncUsersParams = {
+  /** The directory to list users for, e.g. `data` from `useOrganizationDirectorySync`. Nothing is fetched while `null` or `undefined`. */directory: DirectorySyncResource | null | undefined;
+  /**
+   * Pass-through fetch parameters (pagination).
+   * Defaults to `{ initialPage: 1, pageSize: 10 }`.
+   */
+  params?: GetDirectorySyncUsersParams;
+  /**
+   * Poll the list for changes while `true`. Tie this to the view that needs the
+   * live feed so polling stops when that view goes away.
+   *
+   * @default false
+   */
+  poll?: boolean;
+  /**
+   * Polling interval (ms) used while `poll` is `true`.
+   *
+   * @default 2000
+   */
+  pollIntervalMs?: number;
+  /**
+   * If `false`, nothing is fetched and polling is paused.
+   *
+   * @default true
+   */
+  enabled?: boolean;
+  keepPreviousData?: boolean;
+};
+type UseOrganizationDirectorySyncUsersReturn = {
+  /** `undefined` while loading and while the hook is disabled. */data: DirectorySyncUserResource[] | undefined;
+  totalCount: number | undefined;
+  error: Error | null;
+  isLoading: boolean;
+  isFetching: boolean; /** `true` while the hook is polling. */
+  isPolling: boolean;
+  /**
+   * Force a refetch.
+   */
+  revalidate: () => Promise<void>;
+};
+/**
+ * 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
+ */
+declare function useOrganizationDirectorySyncUsers(params: UseOrganizationDirectorySyncUsersParams): UseOrganizationDirectorySyncUsersReturn;
+//#endregion
+export { UseOrganizationDirectorySyncUsersParams, UseOrganizationDirectorySyncUsersReturn, useOrganizationDirectorySyncUsers };

package/dist/react/hooks/useOrganizationDirectorySyncUsers.js

@@ -0,0 +1,71 @@
+const require_contexts = require('../contexts.js');
+const require_use_clerk_query_client = require('../query/use-clerk-query-client.js');
+const require_useQuery = require('../query/useQuery.js');
+const require_useClearQueriesOnSignOut = require('./useClearQueriesOnSignOut.js');
+const require_useOrganizationBase = require('./base/useOrganizationBase.js');
+const require_useOrganizationDirectorySync_shared = require('./useOrganizationDirectorySync.shared.js');
+let react = require("react");
+
+//#region src/react/hooks/useOrganizationDirectorySyncUsers.tsx
+const DEFAULT_POLL_INTERVAL_MS = 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, enabled = true, keepPreviousData = true } = params;
+	const clerk = require_contexts.useClerkInstanceContext();
+	const organization = require_useOrganizationBase.useOrganizationBase();
+	const [queryClient] = require_use_clerk_query_client.useClerkQueryClient();
+	const enterpriseConnectionId = directory?.enterpriseConnectionId ?? null;
+	const directoryId = directory?.id ?? null;
+	const { queryKey, invalidationKey, stableKey, authenticated } = require_useOrganizationDirectorySync_shared.useOrganizationDirectorySyncUsersCacheKeys({
+		organizationId: organization?.id ?? null,
+		enterpriseConnectionId,
+		directoryId,
+		args: fetchParams
+	});
+	require_useClearQueriesOnSignOut.useClearQueriesOnSignOut({
+		isSignedOut: organization === null,
+		authenticated,
+		stableKeys: stableKey
+	});
+	const queryEnabled = enabled && clerk.loaded && Boolean(organization) && Boolean(directory);
+	const currentTracked = queryKey[2];
+	const query = require_useQuery.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 = (0, react.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
+exports.useOrganizationDirectorySyncUsers = useOrganizationDirectorySyncUsers;

package/dist/react/hooks/useOrganizationEnterpriseConnectionTestRuns.js

@@ -33,9 +33,10 @@ function useOrganizationEnterpriseConnectionTestRuns(params) {
 		stableKeys: stableKey
 	});
 	const queryEnabled = enabled && clerk.loaded && Boolean(organization) && Boolean(enterpriseConnectionId);
-	const [shouldPoll, setShouldPoll] = (0, react.useState)(false);
+	const [pollingConnectionId, setPollingConnectionId] = (0, react.useState)(null);
+	const shouldPoll = pollingConnectionId !== null && pollingConnectionId === enterpriseConnectionId;
 	(0, react.useEffect)(() => {
-		setShouldPoll(false);
+		setPollingConnectionId((current) => current !== null && current !== enterpriseConnectionId ? null : current);
 	}, [enterpriseConnectionId]);
 	const query = require_useQuery.useClerkQuery({
 		queryKey,
@@ -53,10 +54,10 @@ function useOrganizationEnterpriseConnectionTestRuns(params) {
 	});
 	const hasRows = (query.data?.data?.length ?? 0) > 0;
 	(0, react.useEffect)(() => {
-		if (shouldPoll && hasRows) setShouldPoll(false);
+		if (shouldPoll && hasRows) setPollingConnectionId(null);
 	}, [shouldPoll, hasRows]);
 	const revalidate = (0, react.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
@@ -71,7 +72,8 @@ function useOrganizationEnterpriseConnectionTestRuns(params) {
 		queryClient,
 		invalidationKey,
 		queryKey,
-		hasRows
+		hasRows,
+		enterpriseConnectionId
 	]);
 	const isPolling = queryEnabled && shouldPoll && !hasRows;
 	return {

package/dist/react/hooks/useOrganizationList.d.mts

@@ -46,7 +46,7 @@ type UseOrganizationListParams = {
  */
 type UseOrganizationListReturn<T extends UseOrganizationListParams> = {
   /**
-   * Indicates whether Clerk has loaded the current authentication state and there is an authenticated user. Initially `false`, becomes `true` once Clerk loads with a user, and can revert to `false` while auth state is updating (e.g., when switching organizations via [`setActive()`](https://clerk.com/docs/reference/objects/clerk#set-active)).
+   * Indicates whether Clerk has loaded the current authentication state and there is an authenticated user. Initially `false`, becomes `true` once Clerk loads with a user, and can revert to `false` while auth state is updating (e.g., when switching organizations via [`setActive()`](https://clerk.com/docs/reference/objects/clerk#setactive)).
    */
   isLoaded: false;
   /**

package/dist/react/hooks/useOrganizationList.d.ts

@@ -46,7 +46,7 @@ type UseOrganizationListParams = {
  */
 type UseOrganizationListReturn<T extends UseOrganizationListParams> = {
   /**
-   * Indicates whether Clerk has loaded the current authentication state and there is an authenticated user. Initially `false`, becomes `true` once Clerk loads with a user, and can revert to `false` while auth state is updating (e.g., when switching organizations via [`setActive()`](https://clerk.com/docs/reference/objects/clerk#set-active)).
+   * Indicates whether Clerk has loaded the current authentication state and there is an authenticated user. Initially `false`, becomes `true` once Clerk loads with a user, and can revert to `false` while auth state is updating (e.g., when switching organizations via [`setActive()`](https://clerk.com/docs/reference/objects/clerk#setactive)).
    */
   isLoaded: false;
   /**

package/dist/react/hooks/useReverification.d.mts

@@ -50,7 +50,7 @@ type UseReverification = <Fetcher extends (...args: any[]) => Promise<any> | und
 
 fetcher: Fetcher,
 /**
- * Optional configuration object extending [`UseReverificationOptions`](https://clerk.com/docs/reference/hooks/use-reverification#use-reverification-options).
+ * Optional configuration object extending [`UseReverificationOptions`](https://clerk.com/docs/reference/hooks/use-reverification#usereverificationoptions).
  */
 
 options?: Options) => UseReverificationResult<Fetcher>;

package/dist/react/hooks/useReverification.d.ts

@@ -50,7 +50,7 @@ type UseReverification = <Fetcher extends (...args: any[]) => Promise<any> | und
 
 fetcher: Fetcher,
 /**
- * Optional configuration object extending [`UseReverificationOptions`](https://clerk.com/docs/reference/hooks/use-reverification#use-reverification-options).
+ * Optional configuration object extending [`UseReverificationOptions`](https://clerk.com/docs/reference/hooks/use-reverification#usereverificationoptions).
  */
 
 options?: Options) => UseReverificationResult<Fetcher>;

package/dist/react/index.d.mts

@@ -32,6 +32,8 @@ import { usePaymentAttemptQuery } from "./hooks/usePaymentAttemptQuery.mjs";
 import { UseUserEnterpriseConnectionsParams, UseUserEnterpriseConnectionsReturn, useUserEnterpriseConnections } from "./hooks/useUserEnterpriseConnections.mjs";
 import { UseOrganizationEnterpriseConnectionsParams, UseOrganizationEnterpriseConnectionsReturn, useOrganizationEnterpriseConnections } from "./hooks/useOrganizationEnterpriseConnections.mjs";
 import { UseOrganizationDomainsParams, UseOrganizationDomainsReturn, useOrganizationDomains } from "./hooks/useOrganizationDomains.mjs";
+import { UseOrganizationDirectorySyncParams, UseOrganizationDirectorySyncReturn, useOrganizationDirectorySync } from "./hooks/useOrganizationDirectorySync.mjs";
+import { UseOrganizationDirectorySyncUsersParams, UseOrganizationDirectorySyncUsersReturn, useOrganizationDirectorySyncUsers } from "./hooks/useOrganizationDirectorySyncUsers.mjs";
 import { UseOrganizationEnterpriseConnectionTestRunsParams, UseOrganizationEnterpriseConnectionTestRunsReturn, UseOrganizationEnterpriseConnectionTestRunsRevalidateResult, useOrganizationEnterpriseConnectionTestRuns } from "./hooks/useOrganizationEnterpriseConnectionTestRuns.mjs";
 import { useUserBase } from "./hooks/base/useUserBase.mjs";
 import { useClientBase } from "./hooks/base/useClientBase.mjs";
@@ -41,4 +43,4 @@ import { ClerkContextProvider } from "./ClerkContextProvider.mjs";
 import { PaymentElement, PaymentElementProps, PaymentElementProvider, PaymentElementProviderProps, UsePaymentElementReturn, usePaymentElement } from "./billing/payment-element.mjs";
 import { UNSAFE_PortalProvider, usePortalRoot } from "./PortalProvider.mjs";
 import { __createClerkTestQueryClient, __resetClerkQueryClientForTest, __setClerkQueryClientForTest, getClerkQueryClient } from "./query/clerk-query-client.mjs";
-export { ClerkContextProvider, ClerkInstanceContext, InitialStateProvider, OptionsContext, PaymentElementProps, PaymentElementProviderProps, UNSAFE_PortalProvider, type UseOAuthConsentParams, type UseOAuthConsentReturn, type UseOAuthDeviceVerificationReturn, type UseOrganizationCreationDefaultsParams, type UseOrganizationCreationDefaultsReturn, type UseOrganizationDomainsParams, type UseOrganizationDomainsReturn, type UseOrganizationEnterpriseConnectionTestRunsParams, type UseOrganizationEnterpriseConnectionTestRunsReturn, type UseOrganizationEnterpriseConnectionTestRunsRevalidateResult, type UseOrganizationEnterpriseConnectionsParams, type UseOrganizationEnterpriseConnectionsReturn, UsePaymentElementReturn, type UseSubscriptionParams, type UseUserEnterpriseConnectionsParams, type UseUserEnterpriseConnectionsReturn, __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, PaymentElementProps, PaymentElementProviderProps, UNSAFE_PortalProvider, type UseOAuthConsentParams, type UseOAuthConsentReturn, type UseOAuthDeviceVerificationReturn, type UseOrganizationCreationDefaultsParams, type UseOrganizationCreationDefaultsReturn, type UseOrganizationDirectorySyncParams, type UseOrganizationDirectorySyncReturn, type UseOrganizationDirectorySyncUsersParams, type UseOrganizationDirectorySyncUsersReturn, type UseOrganizationDomainsParams, type UseOrganizationDomainsReturn, type UseOrganizationEnterpriseConnectionTestRunsParams, type UseOrganizationEnterpriseConnectionTestRunsReturn, type UseOrganizationEnterpriseConnectionTestRunsRevalidateResult, type UseOrganizationEnterpriseConnectionsParams, type UseOrganizationEnterpriseConnectionsReturn, UsePaymentElementReturn, type UseSubscriptionParams, type UseUserEnterpriseConnectionsParams, type UseUserEnterpriseConnectionsReturn, __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 };

package/dist/react/index.d.ts

@@ -32,6 +32,8 @@ import { usePaymentAttemptQuery } from "./hooks/usePaymentAttemptQuery.js";
 import { UseUserEnterpriseConnectionsParams, UseUserEnterpriseConnectionsReturn, useUserEnterpriseConnections } from "./hooks/useUserEnterpriseConnections.js";
 import { UseOrganizationEnterpriseConnectionsParams, UseOrganizationEnterpriseConnectionsReturn, useOrganizationEnterpriseConnections } from "./hooks/useOrganizationEnterpriseConnections.js";
 import { UseOrganizationDomainsParams, UseOrganizationDomainsReturn, useOrganizationDomains } from "./hooks/useOrganizationDomains.js";
+import { UseOrganizationDirectorySyncParams, UseOrganizationDirectorySyncReturn, useOrganizationDirectorySync } from "./hooks/useOrganizationDirectorySync.js";
+import { UseOrganizationDirectorySyncUsersParams, UseOrganizationDirectorySyncUsersReturn, useOrganizationDirectorySyncUsers } from "./hooks/useOrganizationDirectorySyncUsers.js";
 import { UseOrganizationEnterpriseConnectionTestRunsParams, UseOrganizationEnterpriseConnectionTestRunsReturn, UseOrganizationEnterpriseConnectionTestRunsRevalidateResult, useOrganizationEnterpriseConnectionTestRuns } from "./hooks/useOrganizationEnterpriseConnectionTestRuns.js";
 import { useUserBase } from "./hooks/base/useUserBase.js";
 import { useClientBase } from "./hooks/base/useClientBase.js";
@@ -41,4 +43,4 @@ import { ClerkContextProvider } from "./ClerkContextProvider.js";
 import { PaymentElement, PaymentElementProps, PaymentElementProvider, PaymentElementProviderProps, UsePaymentElementReturn, usePaymentElement } from "./billing/payment-element.js";
 import { UNSAFE_PortalProvider, usePortalRoot } from "./PortalProvider.js";
 import { __createClerkTestQueryClient, __resetClerkQueryClientForTest, __setClerkQueryClientForTest, getClerkQueryClient } from "./query/clerk-query-client.js";
-export { ClerkContextProvider, ClerkInstanceContext, InitialStateProvider, OptionsContext, PaymentElementProps, PaymentElementProviderProps, UNSAFE_PortalProvider, type UseOAuthConsentParams, type UseOAuthConsentReturn, type UseOAuthDeviceVerificationReturn, type UseOrganizationCreationDefaultsParams, type UseOrganizationCreationDefaultsReturn, type UseOrganizationDomainsParams, type UseOrganizationDomainsReturn, type UseOrganizationEnterpriseConnectionTestRunsParams, type UseOrganizationEnterpriseConnectionTestRunsReturn, type UseOrganizationEnterpriseConnectionTestRunsRevalidateResult, type UseOrganizationEnterpriseConnectionsParams, type UseOrganizationEnterpriseConnectionsReturn, UsePaymentElementReturn, type UseSubscriptionParams, type UseUserEnterpriseConnectionsParams, type UseUserEnterpriseConnectionsReturn, __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, PaymentElementProps, PaymentElementProviderProps, UNSAFE_PortalProvider, type UseOAuthConsentParams, type UseOAuthConsentReturn, type UseOAuthDeviceVerificationReturn, type UseOrganizationCreationDefaultsParams, type UseOrganizationCreationDefaultsReturn, type UseOrganizationDirectorySyncParams, type UseOrganizationDirectorySyncReturn, type UseOrganizationDirectorySyncUsersParams, type UseOrganizationDirectorySyncUsersReturn, type UseOrganizationDomainsParams, type UseOrganizationDomainsReturn, type UseOrganizationEnterpriseConnectionTestRunsParams, type UseOrganizationEnterpriseConnectionTestRunsReturn, type UseOrganizationEnterpriseConnectionTestRunsRevalidateResult, type UseOrganizationEnterpriseConnectionsParams, type UseOrganizationEnterpriseConnectionsReturn, UsePaymentElementReturn, type UseSubscriptionParams, type UseUserEnterpriseConnectionsParams, type UseUserEnterpriseConnectionsReturn, __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 };