@thunderid/react 1.5.0 → 1.6.0

package/dist/hooks/management/useInfiniteOptions.js

@@ -0,0 +1,126 @@
+import { createPackageComponentLogger, loadUntilOptionsGrow, mergeOptionsBatch, normalizeSelectOptions, toError } from "@thunderid/browser";
+import { useCallback, useEffect, useRef, useState } from "react";
+
+//#region src/hooks/management/useInfiniteOptions.ts
+const logger$1 = createPackageComponentLogger("@thunderid/react", "useInfiniteOptions");
+/**
+* Keeps the option list of a `Select` that loads more options when the user asks for them. It owns the cursor,
+* appends each batch without duplicates, and stops at the end of the data. Nothing is rendered, so it works with
+* any list component.
+*/
+const useInfiniteOptions = ({ initialOptions, load, onError }) => {
+	const [options, setOptions] = useState(() => normalizeSelectOptions(initialOptions));
+	const [loading, setLoading] = useState(false);
+	const [error, setError] = useState(null);
+	const [hasMore, setHasMore] = useState(true);
+	const latest = useRef({
+		initialOptions,
+		load,
+		onError
+	});
+	const optionsRef = useRef(options);
+	const cursorRef = useRef(void 0);
+	const finishedRef = useRef(false);
+	const loadingRef = useRef(false);
+	const requestedRef = useRef(false);
+	const generationRef = useRef(0);
+	const controllerRef = useRef(null);
+	const nonListLoggedRef = useRef(false);
+	useEffect(() => {
+		latest.current = {
+			initialOptions,
+			load,
+			onError
+		};
+	});
+	const applyBatch = useCallback((batch) => {
+		const merged = mergeOptionsBatch({
+			cursor: cursorRef.current,
+			options: optionsRef.current
+		}, batch);
+		if (merged.issue === "cursor-stuck") logger$1.warn("A load returned no new options and the same cursor; the list was treated as finished.");
+		else if (merged.issue === "not-a-list" && !nonListLoggedRef.current) {
+			nonListLoggedRef.current = true;
+			logger$1.warn("A load returned something other than a list of options; it was treated as an empty batch.");
+		}
+		const addedNothing = merged.options.length === optionsRef.current.length;
+		cursorRef.current = merged.cursor;
+		optionsRef.current = merged.options;
+		finishedRef.current = merged.finished;
+		setOptions(merged.options);
+		setHasMore(!merged.finished);
+		setError(null);
+		return addedNothing && !merged.finished;
+	}, []);
+	const startLoad = useCallback(async () => {
+		const generation = generationRef.current;
+		const controller = new AbortController();
+		controllerRef.current = controller;
+		loadingRef.current = true;
+		setLoading(true);
+		try {
+			await loadUntilOptionsGrow(() => latest.current.load({
+				cursor: cursorRef.current,
+				options: optionsRef.current,
+				signal: controller.signal
+			}), applyBatch, () => generation === generationRef.current);
+		} catch (failure) {
+			if (generation === generationRef.current && !controller.signal.aborted) {
+				const failureError = toError(failure);
+				setError(failureError);
+				try {
+					latest.current.onError?.(failureError);
+				} catch (callbackFailure) {
+					logger$1.error("The onError callback threw.", callbackFailure);
+				}
+			}
+		} finally {
+			if (generation === generationRef.current) {
+				controllerRef.current = null;
+				loadingRef.current = false;
+				setLoading(false);
+			}
+		}
+	}, [applyBatch]);
+	const onLoadMore = useCallback(() => {
+		if (loadingRef.current || finishedRef.current) return;
+		requestedRef.current = true;
+		startLoad();
+	}, [startLoad]);
+	const reset = useCallback(() => {
+		const shouldReload = requestedRef.current;
+		const initial = normalizeSelectOptions(latest.current.initialOptions);
+		generationRef.current += 1;
+		controllerRef.current?.abort();
+		controllerRef.current = null;
+		cursorRef.current = void 0;
+		finishedRef.current = false;
+		loadingRef.current = false;
+		optionsRef.current = initial;
+		setOptions(initial);
+		setHasMore(true);
+		setError(null);
+		setLoading(false);
+		if (shouldReload) startLoad();
+	}, [startLoad]);
+	useEffect(() => () => {
+		generationRef.current += 1;
+		controllerRef.current?.abort();
+		controllerRef.current = null;
+		loadingRef.current = false;
+		setLoading(false);
+	}, []);
+	return {
+		error,
+		hasMore,
+		loading,
+		onLoadMore,
+		options,
+		reset
+	};
+};
+var useInfiniteOptions_default = useInfiniteOptions;
+
+//#endregion
+export { useInfiniteOptions_default as default };
+//# sourceMappingURL=useInfiniteOptions.js.map

package/dist/hooks/management/useInfiniteOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteOptions.js","names":["logger: ReturnType<typeof createPackageComponentLogger>","merged: OptionsMergeResult<TCursor>","addedNothing: boolean","generation: number","controller: AbortController","failureError: Error","shouldReload: boolean","initial: SelectOption[]"],"sources":["../../../src/hooks/management/useInfiniteOptions.ts"],"sourcesContent":["// Copyright 2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {\n  createPackageComponentLogger,\n  loadUntilOptionsGrow,\n  mergeOptionsBatch,\n  normalizeSelectOptions,\n  toError,\n} from '@thunderid/browser';\nimport type {\n  OptionsMergeResult,\n  SelectOption,\n  SelectOptionInput,\n  SelectOptionsBatch,\n  SelectOptionsLoadContext,\n} from '@thunderid/browser';\nimport {useCallback, useEffect, useRef, useState} from 'react';\n\nconst logger: ReturnType<typeof createPackageComponentLogger> = createPackageComponentLogger(\n  '@thunderid/react',\n  'useInfiniteOptions',\n);\n\nexport type InfiniteOptionsLoadContext<TCursor = unknown> = SelectOptionsLoadContext<TCursor>;\n\nexport type InfiniteOptionsBatch<TCursor = unknown> = SelectOptionsBatch<TCursor>;\n\nexport interface UseInfiniteOptionsArgs<TCursor = unknown> {\n  /** Options shown before anything is loaded, and again after {@link UseInfiniteOptionsResult.reset}. */\n  initialOptions?: SelectOptionInput[];\n  /** Loads the next batch. Returning nothing counts as an empty batch. */\n  load: (context: InfiniteOptionsLoadContext<TCursor>) => Promise<InfiniteOptionsBatch<TCursor> | null | undefined>;\n  /** Called with the error of every failed load. A failed load never changes the options. */\n  onError?: (error: Error) => void;\n}\n\nexport interface UseInfiniteOptionsResult {\n  /** The error of the last load, cleared by the next successful one. */\n  error: Error | null;\n  /** Whether more batches may be available. */\n  hasMore: boolean;\n  loading: boolean;\n  /** Pass to `Select` while `hasMore` is true, so its load more option is listed only while there is more to load. Its identity is stable across renders. */\n  onLoadMore: () => void;\n  options: SelectOption[];\n  /** Back to `initialOptions`; reloads right away if loading had already started. */\n  reset: () => void;\n}\n\n/**\n * Keeps the option list of a `Select` that loads more options when the user asks for them. It owns the cursor,\n * appends each batch without duplicates, and stops at the end of the data. Nothing is rendered, so it works with\n * any list component.\n */\nconst useInfiniteOptions = <TCursor = unknown>({\n  initialOptions,\n  load,\n  onError,\n}: UseInfiniteOptionsArgs<TCursor>): UseInfiniteOptionsResult => {\n  const [options, setOptions] = useState<SelectOption[]>(() => normalizeSelectOptions(initialOptions));\n  const [loading, setLoading] = useState<boolean>(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [hasMore, setHasMore] = useState<boolean>(true);\n\n  const latest = useRef({initialOptions, load, onError});\n  const optionsRef = useRef<SelectOption[]>(options);\n  const cursorRef = useRef<TCursor | undefined>(undefined);\n  const finishedRef = useRef<boolean>(false);\n  const loadingRef = useRef<boolean>(false);\n  const requestedRef = useRef<boolean>(false);\n  const generationRef = useRef<number>(0);\n  const controllerRef = useRef<AbortController | null>(null);\n  const nonListLoggedRef = useRef<boolean>(false);\n\n  useEffect(() => {\n    latest.current = {initialOptions, load, onError};\n  });\n\n  const applyBatch = useCallback((batch: SelectOptionsBatch<TCursor> | null | undefined): boolean => {\n    const merged: OptionsMergeResult<TCursor> = mergeOptionsBatch(\n      {cursor: cursorRef.current, options: optionsRef.current},\n      batch,\n    );\n\n    if (merged.issue === 'cursor-stuck') {\n      logger.warn('A load returned no new options and the same cursor; the list was treated as finished.');\n    } else if (merged.issue === 'not-a-list' && !nonListLoggedRef.current) {\n      nonListLoggedRef.current = true;\n      logger.warn('A load returned something other than a list of options; it was treated as an empty batch.');\n    }\n\n    const addedNothing: boolean = merged.options.length === optionsRef.current.length;\n\n    cursorRef.current = merged.cursor;\n    optionsRef.current = merged.options;\n    finishedRef.current = merged.finished;\n    setOptions(merged.options);\n    setHasMore(!merged.finished);\n    setError(null);\n\n    return addedNothing && !merged.finished;\n  }, []);\n\n  const startLoad = useCallback(async (): Promise<void> => {\n    const generation: number = generationRef.current;\n    const controller: AbortController = new AbortController();\n\n    controllerRef.current = controller;\n    loadingRef.current = true;\n    setLoading(true);\n\n    try {\n      await loadUntilOptionsGrow<SelectOptionsBatch<TCursor> | null | undefined>(\n        () =>\n          latest.current.load({\n            cursor: cursorRef.current,\n            options: optionsRef.current,\n            signal: controller.signal,\n          }),\n        applyBatch,\n        () => generation === generationRef.current,\n      );\n    } catch (failure) {\n      if (generation === generationRef.current && !controller.signal.aborted) {\n        const failureError: Error = toError(failure);\n\n        setError(failureError);\n        try {\n          latest.current.onError?.(failureError);\n        } catch (callbackFailure) {\n          logger.error('The onError callback threw.', callbackFailure);\n        }\n      }\n    } finally {\n      if (generation === generationRef.current) {\n        controllerRef.current = null;\n        loadingRef.current = false;\n        setLoading(false);\n      }\n    }\n  }, [applyBatch]);\n\n  const onLoadMore = useCallback((): void => {\n    if (loadingRef.current || finishedRef.current) {\n      return;\n    }\n\n    requestedRef.current = true;\n    void startLoad();\n  }, [startLoad]);\n\n  const reset = useCallback((): void => {\n    const shouldReload: boolean = requestedRef.current;\n    const initial: SelectOption[] = normalizeSelectOptions(latest.current.initialOptions);\n\n    generationRef.current += 1;\n    controllerRef.current?.abort();\n    controllerRef.current = null;\n    cursorRef.current = undefined;\n    finishedRef.current = false;\n    loadingRef.current = false;\n    optionsRef.current = initial;\n    setOptions(initial);\n    setHasMore(true);\n    setError(null);\n    setLoading(false);\n\n    if (shouldReload) {\n      void startLoad();\n    }\n  }, [startLoad]);\n\n  // Cleaning up abandons the running load, so the helper must not go on treating it as in progress. React\n  // runs a component's effects again after cleaning them up, and that second run needs to be able to load.\n  useEffect(\n    () => () => {\n      generationRef.current += 1;\n      controllerRef.current?.abort();\n      controllerRef.current = null;\n      loadingRef.current = false;\n      setLoading(false);\n    },\n    [],\n  );\n\n  return {error, hasMore, loading, onLoadMore, options, reset};\n};\n\nexport default useInfiniteOptions;\n"],"mappings":"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"}

package/dist/hooks/management/useManagementEndpoint.d.ts

@@ -0,0 +1,22 @@
+import { ResourceEndpointKey } from '@thunderid/browser';
+/**
+ * The URL inputs a management API function needs.
+ */
+export interface ManagementEndpoint {
+    baseUrl: string | undefined;
+    /**
+     * The collection URL from `endpoints` when overridden, otherwise `undefined` so the API function
+     * falls back to `{baseUrl}/{collection}`.
+     */
+    url: string | undefined;
+}
+/**
+ * Resolves where a management resource collection lives, honoring the provider's `endpoints`
+ * override so the management API can run on a different host from the authorization server.
+ *
+ * @param key - The resource collection.
+ * @returns The base URL and optional collection URL override.
+ */
+declare const useManagementEndpoint: (key: Extract<ResourceEndpointKey, "agents" | "agentTypes" | "applications" | "flows" | "groups" | "roles" | "users" | "userTypes">) => ManagementEndpoint;
+export default useManagementEndpoint;
+//# sourceMappingURL=useManagementEndpoint.d.ts.map

package/dist/hooks/management/useManagementEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useManagementEndpoint.d.ts","sourceRoot":"","sources":["../../../src/hooks/management/useManagementEndpoint.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,mBAAmB,EAA0B,MAAM,oBAAoB,CAAC;AAGhF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB;AAED;;;;;;GAMG;AACH,QAAA,MAAM,qBAAqB,GACzB,KAAK,OAAO,CACV,mBAAmB,EACnB,QAAQ,GAAG,YAAY,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAChG,KACA,kBAIF,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/hooks/management/useManagementEndpoint.js

@@ -0,0 +1,23 @@
+import useThunderID_default from "../../contexts/ThunderID/useThunderID.js";
+import { resolveResourceEndpoint } from "@thunderid/browser";
+
+//#region src/hooks/management/useManagementEndpoint.ts
+/**
+* Resolves where a management resource collection lives, honoring the provider's `endpoints`
+* override so the management API can run on a different host from the authorization server.
+*
+* @param key - The resource collection.
+* @returns The base URL and optional collection URL override.
+*/
+const useManagementEndpoint = (key) => {
+	const { baseUrl, endpoints } = useThunderID_default();
+	return {
+		baseUrl,
+		url: resolveResourceEndpoint(key, { endpoints })
+	};
+};
+var useManagementEndpoint_default = useManagementEndpoint;
+
+//#endregion
+export { useManagementEndpoint_default as default };
+//# sourceMappingURL=useManagementEndpoint.js.map

package/dist/hooks/management/useManagementEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useManagementEndpoint.js","names":["useThunderID"],"sources":["../../../src/hooks/management/useManagementEndpoint.ts"],"sourcesContent":["// Copyright 2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {ResourceEndpointKey, resolveResourceEndpoint} from '@thunderid/browser';\nimport useThunderID from '../../contexts/ThunderID/useThunderID';\n\n/**\n * The URL inputs a management API function needs.\n */\nexport interface ManagementEndpoint {\n  baseUrl: string | undefined;\n  /**\n   * The collection URL from `endpoints` when overridden, otherwise `undefined` so the API function\n   * falls back to `{baseUrl}/{collection}`.\n   */\n  url: string | undefined;\n}\n\n/**\n * Resolves where a management resource collection lives, honoring the provider's `endpoints`\n * override so the management API can run on a different host from the authorization server.\n *\n * @param key - The resource collection.\n * @returns The base URL and optional collection URL override.\n */\nconst useManagementEndpoint = (\n  key: Extract<\n    ResourceEndpointKey,\n    'agents' | 'agentTypes' | 'applications' | 'flows' | 'groups' | 'roles' | 'users' | 'userTypes'\n  >,\n): ManagementEndpoint => {\n  const {baseUrl, endpoints} = useThunderID();\n\n  return {baseUrl, url: resolveResourceEndpoint(key, {endpoints})};\n};\n\nexport default useManagementEndpoint;\n"],"mappings":";;;;;;;;;;;AAyBA,MAAM,yBACJ,QAIuB;CACvB,MAAM,EAAC,SAAS,cAAaA,sBAAc;AAE3C,QAAO;EAAC;EAAS,KAAK,wBAAwB,KAAK,EAAC,WAAU,CAAC;EAAC;;AAGlE,oCAAe"}

package/dist/hooks/management/useResourceMutation.d.ts

@@ -0,0 +1,50 @@
+import { ResourceQueryKey, ApiFetcher } from '@thunderid/browser';
+/**
+ * Options accepted by every management mutation hook.
+ */
+export interface ResourceMutationOptions<TData, TVariables> {
+    /**
+     * Transport for this hook only. Takes precedence over `ThunderIDProvider`'s `http.fetcher`.
+     */
+    fetcher?: ApiFetcher;
+    /**
+     * Called when the mutation fails.
+     */
+    onError?: (error: Error, variables: TVariables) => void;
+    /**
+     * Called when the mutation succeeds, after the affected queries have been invalidated.
+     */
+    onSuccess?: (data: TData, variables: TVariables) => void;
+}
+/**
+ * State returned by a management mutation hook.
+ */
+export interface ResourceMutationResult<TData, TVariables> {
+    data: TData | undefined;
+    error: Error | null;
+    isLoading: boolean;
+    /**
+     * Runs the mutation. Never rejects: read `error`, or use `onError`, to handle a failure.
+     */
+    mutate: (variables: TVariables) => Promise<TData | undefined>;
+    /**
+     * Runs the mutation and rejects if it fails.
+     */
+    mutateAsync: (variables: TVariables) => Promise<TData>;
+    /**
+     * Clears `data` and `error`.
+     */
+    reset: () => void;
+}
+/**
+ * Runs a management mutation and invalidates the queries whose data it changed. Depends on no data
+ * fetching library.
+ *
+ * @param mutationFn - Performs the request with the resolved fetcher.
+ * @param getInvalidatedKeys - Returns the query key prefixes to invalidate after a success.
+ * @param options - Mutation options.
+ * @returns The mutation state.
+ */
+declare const useResourceMutation: <TData, TVariables>(mutationFn: (variables: TVariables, fetcher: ApiFetcher) => Promise<TData>, getInvalidatedKeys: (variables: TVariables) => ResourceQueryKey[], { fetcher, onError, onSuccess }?: ResourceMutationOptions<TData, TVariables>) => ResourceMutationResult<TData, TVariables>;
+export default useResourceMutation;
+//# sourceMappingURL=useResourceMutation.d.ts.map

package/dist/hooks/management/useResourceMutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceMutation.d.ts","sourceRoot":"","sources":["../../../src/hooks/management/useResourceMutation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,gBAAgB,EAA+B,UAAU,EAAC,MAAM,oBAAoB,CAAC;AAK7F;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,KAAK,EAAE,UAAU;IACxD;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,KAAK,IAAI,CAAC;IACxD;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,KAAK,IAAI,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,KAAK,EAAE,UAAU;IACvD,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAC9D;;OAEG;IACH,WAAW,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACvD;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,QAAA,MAAM,mBAAmB,GAAI,KAAK,EAAE,UAAU,EAC5C,YAAY,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,KAAK,CAAC,EAC1E,oBAAoB,CAAC,SAAS,EAAE,UAAU,KAAK,gBAAgB,EAAE,EACjE,kCAA+B,uBAAuB,CAAC,KAAK,EAAE,UAAU,CAAM,KAC7E,sBAAsB,CAAC,KAAK,EAAE,UAAU,CAyD1C,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/hooks/management/useResourceMutation.js

@@ -0,0 +1,70 @@
+import useThunderID_default from "../../contexts/ThunderID/useThunderID.js";
+import { useResolvedFetcher } from "./useResourceQuery.js";
+import { fallbackResourceInvalidator } from "@thunderid/browser";
+import { useCallback, useRef, useState } from "react";
+
+//#region src/hooks/management/useResourceMutation.ts
+/**
+* Runs a management mutation and invalidates the queries whose data it changed. Depends on no data
+* fetching library.
+*
+* @param mutationFn - Performs the request with the resolved fetcher.
+* @param getInvalidatedKeys - Returns the query key prefixes to invalidate after a success.
+* @param options - Mutation options.
+* @returns The mutation state.
+*/
+const useResourceMutation = (mutationFn, getInvalidatedKeys, { fetcher, onError, onSuccess } = {}) => {
+	const { invalidator = fallbackResourceInvalidator } = useThunderID_default();
+	const resolvedFetcher = useResolvedFetcher(fetcher);
+	const [data, setData] = useState(void 0);
+	const [error, setError] = useState(null);
+	const [isLoading, setIsLoading] = useState(false);
+	const callbacksRef = useRef({
+		getInvalidatedKeys,
+		mutationFn,
+		onError,
+		onSuccess
+	});
+	callbacksRef.current = {
+		getInvalidatedKeys,
+		mutationFn,
+		onError,
+		onSuccess
+	};
+	const mutateAsync = useCallback(async (variables) => {
+		setIsLoading(true);
+		setError(null);
+		try {
+			const result = await callbacksRef.current.mutationFn(variables, resolvedFetcher);
+			setData(result);
+			callbacksRef.current.getInvalidatedKeys(variables).forEach((key) => {
+				invalidator.invalidate(key);
+			});
+			callbacksRef.current.onSuccess?.(result, variables);
+			return result;
+		} catch (err) {
+			const mutationError = err instanceof Error ? err : new Error(String(err));
+			setError(mutationError);
+			callbacksRef.current.onError?.(mutationError, variables);
+			throw mutationError;
+		} finally {
+			setIsLoading(false);
+		}
+	}, [invalidator, resolvedFetcher]);
+	return {
+		data,
+		error,
+		isLoading,
+		mutate: useCallback((variables) => mutateAsync(variables).catch(() => void 0), [mutateAsync]),
+		mutateAsync,
+		reset: useCallback(() => {
+			setData(void 0);
+			setError(null);
+		}, [])
+	};
+};
+var useResourceMutation_default = useResourceMutation;
+
+//#endregion
+export { useResourceMutation_default as default };
+//# sourceMappingURL=useResourceMutation.js.map

package/dist/hooks/management/useResourceMutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceMutation.js","names":["useThunderID","resolvedFetcher: ApiFetcher","callbacksRef: {\n    current: {\n      getInvalidatedKeys: typeof getInvalidatedKeys;\n      mutationFn: typeof mutationFn;\n      onError?: ResourceMutationOptions<TData, TVariables>['onError'];\n      onSuccess?: ResourceMutationOptions<TData, TVariables>['onSuccess'];\n    };\n  }","mutateAsync: (variables: TVariables) => Promise<TData>","result: TData","mutationError: Error"],"sources":["../../../src/hooks/management/useResourceMutation.ts"],"sourcesContent":["// Copyright 2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {ResourceQueryKey, fallbackResourceInvalidator, ApiFetcher} from '@thunderid/browser';\nimport {useCallback, useRef, useState} from 'react';\nimport {useResolvedFetcher} from './useResourceQuery';\nimport useThunderID from '../../contexts/ThunderID/useThunderID';\n\n/**\n * Options accepted by every management mutation hook.\n */\nexport interface ResourceMutationOptions<TData, TVariables> {\n  /**\n   * Transport for this hook only. Takes precedence over `ThunderIDProvider`'s `http.fetcher`.\n   */\n  fetcher?: ApiFetcher;\n  /**\n   * Called when the mutation fails.\n   */\n  onError?: (error: Error, variables: TVariables) => void;\n  /**\n   * Called when the mutation succeeds, after the affected queries have been invalidated.\n   */\n  onSuccess?: (data: TData, variables: TVariables) => void;\n}\n\n/**\n * State returned by a management mutation hook.\n */\nexport interface ResourceMutationResult<TData, TVariables> {\n  data: TData | undefined;\n  error: Error | null;\n  isLoading: boolean;\n  /**\n   * Runs the mutation. Never rejects: read `error`, or use `onError`, to handle a failure.\n   */\n  mutate: (variables: TVariables) => Promise<TData | undefined>;\n  /**\n   * Runs the mutation and rejects if it fails.\n   */\n  mutateAsync: (variables: TVariables) => Promise<TData>;\n  /**\n   * Clears `data` and `error`.\n   */\n  reset: () => void;\n}\n\n/**\n * Runs a management mutation and invalidates the queries whose data it changed. Depends on no data\n * fetching library.\n *\n * @param mutationFn - Performs the request with the resolved fetcher.\n * @param getInvalidatedKeys - Returns the query key prefixes to invalidate after a success.\n * @param options - Mutation options.\n * @returns The mutation state.\n */\nconst useResourceMutation = <TData, TVariables>(\n  mutationFn: (variables: TVariables, fetcher: ApiFetcher) => Promise<TData>,\n  getInvalidatedKeys: (variables: TVariables) => ResourceQueryKey[],\n  {fetcher, onError, onSuccess}: ResourceMutationOptions<TData, TVariables> = {},\n): ResourceMutationResult<TData, TVariables> => {\n  const {invalidator = fallbackResourceInvalidator} = useThunderID();\n  const resolvedFetcher: ApiFetcher = useResolvedFetcher(fetcher);\n  const [data, setData] = useState<TData | undefined>(undefined);\n  const [error, setError] = useState<Error | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(false);\n\n  const callbacksRef: {\n    current: {\n      getInvalidatedKeys: typeof getInvalidatedKeys;\n      mutationFn: typeof mutationFn;\n      onError?: ResourceMutationOptions<TData, TVariables>['onError'];\n      onSuccess?: ResourceMutationOptions<TData, TVariables>['onSuccess'];\n    };\n  } = useRef({getInvalidatedKeys, mutationFn, onError, onSuccess});\n  callbacksRef.current = {getInvalidatedKeys, mutationFn, onError, onSuccess};\n\n  const mutateAsync: (variables: TVariables) => Promise<TData> = useCallback(\n    async (variables: TVariables): Promise<TData> => {\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const result: TData = await callbacksRef.current.mutationFn(variables, resolvedFetcher);\n\n        setData(result);\n        callbacksRef.current.getInvalidatedKeys(variables).forEach((key: ResourceQueryKey) => {\n          invalidator.invalidate(key);\n        });\n        callbacksRef.current.onSuccess?.(result, variables);\n\n        return result;\n      } catch (err) {\n        const mutationError: Error = err instanceof Error ? err : new Error(String(err));\n\n        setError(mutationError);\n        callbacksRef.current.onError?.(mutationError, variables);\n\n        throw mutationError;\n      } finally {\n        setIsLoading(false);\n      }\n    },\n    [invalidator, resolvedFetcher],\n  );\n\n  const mutate: (variables: TVariables) => Promise<TData | undefined> = useCallback(\n    (variables: TVariables): Promise<TData | undefined> => mutateAsync(variables).catch((): undefined => undefined),\n    [mutateAsync],\n  );\n\n  const reset: () => void = useCallback((): void => {\n    setData(undefined);\n    setError(null);\n  }, []);\n\n  return {data, error, isLoading, mutate, mutateAsync, reset};\n};\n\nexport default useResourceMutation;\n"],"mappings":";;;;;;;;;;;;;;;AAwDA,MAAM,uBACJ,YACA,oBACA,EAAC,SAAS,SAAS,cAAyD,EAAE,KAChC;CAC9C,MAAM,EAAC,cAAc,gCAA+BA,sBAAc;CAClE,MAAMC,kBAA8B,mBAAmB,QAAQ;CAC/D,MAAM,CAAC,MAAM,WAAW,SAA4B,OAAU;CAC9D,MAAM,CAAC,OAAO,YAAY,SAAuB,KAAK;CACtD,MAAM,CAAC,WAAW,gBAAgB,SAAkB,MAAM;CAE1D,MAAMC,eAOF,OAAO;EAAC;EAAoB;EAAY;EAAS;EAAU,CAAC;AAChE,cAAa,UAAU;EAAC;EAAoB;EAAY;EAAS;EAAU;CAE3E,MAAMC,cAAyD,YAC7D,OAAO,cAA0C;AAC/C,eAAa,KAAK;AAClB,WAAS,KAAK;AAEd,MAAI;GACF,MAAMC,SAAgB,MAAM,aAAa,QAAQ,WAAW,WAAW,gBAAgB;AAEvF,WAAQ,OAAO;AACf,gBAAa,QAAQ,mBAAmB,UAAU,CAAC,SAAS,QAA0B;AACpF,gBAAY,WAAW,IAAI;KAC3B;AACF,gBAAa,QAAQ,YAAY,QAAQ,UAAU;AAEnD,UAAO;WACA,KAAK;GACZ,MAAMC,gBAAuB,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC;AAEhF,YAAS,cAAc;AACvB,gBAAa,QAAQ,UAAU,eAAe,UAAU;AAExD,SAAM;YACE;AACR,gBAAa,MAAM;;IAGvB,CAAC,aAAa,gBAAgB,CAC/B;AAYD,QAAO;EAAC;EAAM;EAAO;EAAW,QAVsC,aACnE,cAAsD,YAAY,UAAU,CAAC,YAAuB,OAAU,EAC/G,CAAC,YAAY,CACd;EAOuC;EAAa,OAL3B,kBAAwB;AAChD,WAAQ,OAAU;AAClB,YAAS,KAAK;KACb,EAAE,CAAC;EAEqD;;AAG7D,kCAAe"}

package/dist/hooks/management/useResourceQuery.d.ts

@@ -0,0 +1,44 @@
+import { ResourceQueryKey, ApiFetcher } from '@thunderid/browser';
+/**
+ * Options accepted by every management query hook.
+ */
+export interface ResourceQueryOptions {
+    /**
+     * Set to `false` to skip fetching, for example until an identifier is known.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Transport for this hook only. Takes precedence over `ThunderIDProvider`'s `http.fetcher`.
+     */
+    fetcher?: ApiFetcher;
+}
+/**
+ * State returned by a management query hook.
+ */
+export interface ResourceQueryResult<T> {
+    data: T | undefined;
+    error: Error | null;
+    isLoading: boolean;
+    /**
+     * Fetches the resource again. Resolves with the new data, or `undefined` if the request failed.
+     */
+    refetch: () => Promise<T | undefined>;
+}
+/**
+ * Resolves the fetcher a management hook should use: the hook's own, then the provider's, then the
+ * SDK's authenticated HTTP client.
+ */
+export declare const useResolvedFetcher: (fetcher?: ApiFetcher) => ApiFetcher;
+/**
+ * Fetches a management resource and keeps it fresh. Depends on no data fetching library: the
+ * request runs through the resolved fetcher, and a matching mutation triggers a refetch.
+ *
+ * @param queryKey - Identifies the data. Changing it refetches; mutations invalidate by key prefix.
+ * @param queryFn - Performs the request with the resolved fetcher.
+ * @param options - Query options.
+ * @returns The query state.
+ */
+declare const useResourceQuery: <T>(queryKey: ResourceQueryKey, queryFn: (fetcher: ApiFetcher) => Promise<T>, { enabled, fetcher }?: ResourceQueryOptions) => ResourceQueryResult<T>;
+export default useResourceQuery;
+//# sourceMappingURL=useResourceQuery.d.ts.map

package/dist/hooks/management/useResourceQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceQuery.d.ts","sourceRoot":"","sources":["../../../src/hooks/management/useResourceQuery.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,gBAAgB,EAA+B,UAAU,EAAC,MAAM,oBAAoB,CAAC;AAK7F;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,UAAU,KAAG,UAQzD,CAAC;AAEF;;;;;;;;GAQG;AACH,QAAA,MAAM,gBAAgB,GAAI,CAAC,EACzB,UAAU,gBAAgB,EAC1B,SAAS,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,EAC5C,uBAA2B,oBAAyB,KACnD,mBAAmB,CAAC,CAAC,CAwDvB,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/hooks/management/useResourceQuery.js

@@ -0,0 +1,83 @@
+import useThunderID_default from "../../contexts/ThunderID/useThunderID.js";
+import createAuthenticatedFetcher_default from "../../utils/createAuthenticatedFetcher.js";
+import { fallbackResourceInvalidator } from "@thunderid/browser";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+
+//#region src/hooks/management/useResourceQuery.ts
+/**
+* Resolves the fetcher a management hook should use: the hook's own, then the provider's, then the
+* SDK's authenticated HTTP client.
+*/
+const useResolvedFetcher = (fetcher) => {
+	const { http, instanceId } = useThunderID_default();
+	const providerFetcher = http?.fetcher;
+	return useMemo(() => fetcher ?? providerFetcher ?? createAuthenticatedFetcher_default(instanceId), [
+		fetcher,
+		providerFetcher,
+		instanceId
+	]);
+};
+/**
+* Fetches a management resource and keeps it fresh. Depends on no data fetching library: the
+* request runs through the resolved fetcher, and a matching mutation triggers a refetch.
+*
+* @param queryKey - Identifies the data. Changing it refetches; mutations invalidate by key prefix.
+* @param queryFn - Performs the request with the resolved fetcher.
+* @param options - Query options.
+* @returns The query state.
+*/
+const useResourceQuery = (queryKey, queryFn, { enabled = true, fetcher } = {}) => {
+	const { invalidator = fallbackResourceInvalidator } = useThunderID_default();
+	const resolvedFetcher = useResolvedFetcher(fetcher);
+	const [data, setData] = useState(void 0);
+	const [error, setError] = useState(null);
+	const [isLoading, setIsLoading] = useState(enabled);
+	const serializedKey = JSON.stringify(queryKey);
+	const queryFnRef = useRef(queryFn);
+	queryFnRef.current = queryFn;
+	const latestRequestRef = useRef(0);
+	const refetch = useCallback(async () => {
+		latestRequestRef.current += 1;
+		const requestId = latestRequestRef.current;
+		setIsLoading(true);
+		try {
+			const result = await queryFnRef.current(resolvedFetcher);
+			if (requestId === latestRequestRef.current) {
+				setData(result);
+				setError(null);
+			}
+			return result;
+		} catch (err) {
+			if (requestId === latestRequestRef.current) setError(err instanceof Error ? err : new Error(String(err)));
+			return;
+		} finally {
+			if (requestId === latestRequestRef.current) setIsLoading(false);
+		}
+	}, [resolvedFetcher]);
+	useEffect(() => {
+		if (!enabled) {
+			setIsLoading(false);
+			return;
+		}
+		refetch();
+		return invalidator.subscribe(JSON.parse(serializedKey), () => {
+			refetch();
+		});
+	}, [
+		enabled,
+		invalidator,
+		refetch,
+		serializedKey
+	]);
+	return {
+		data,
+		error,
+		isLoading,
+		refetch
+	};
+};
+var useResourceQuery_default = useResourceQuery;
+
+//#endregion
+export { useResourceQuery_default as default, useResolvedFetcher };
+//# sourceMappingURL=useResourceQuery.js.map

package/dist/hooks/management/useResourceQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceQuery.js","names":["useThunderID","providerFetcher: ApiFetcher | undefined","createAuthenticatedFetcher","resolvedFetcher: ApiFetcher","serializedKey: string","queryFnRef: {current: (fetcher: ApiFetcher) => Promise<T>}","latestRequestRef: {current: number}","refetch: () => Promise<T | undefined>","requestId: number","result: T"],"sources":["../../../src/hooks/management/useResourceQuery.ts"],"sourcesContent":["// Copyright 2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {ResourceQueryKey, fallbackResourceInvalidator, ApiFetcher} from '@thunderid/browser';\nimport {useCallback, useEffect, useMemo, useRef, useState} from 'react';\nimport useThunderID from '../../contexts/ThunderID/useThunderID';\nimport createAuthenticatedFetcher from '../../utils/createAuthenticatedFetcher';\n\n/**\n * Options accepted by every management query hook.\n */\nexport interface ResourceQueryOptions {\n  /**\n   * Set to `false` to skip fetching, for example until an identifier is known.\n   * @default true\n   */\n  enabled?: boolean;\n  /**\n   * Transport for this hook only. Takes precedence over `ThunderIDProvider`'s `http.fetcher`.\n   */\n  fetcher?: ApiFetcher;\n}\n\n/**\n * State returned by a management query hook.\n */\nexport interface ResourceQueryResult<T> {\n  data: T | undefined;\n  error: Error | null;\n  isLoading: boolean;\n  /**\n   * Fetches the resource again. Resolves with the new data, or `undefined` if the request failed.\n   */\n  refetch: () => Promise<T | undefined>;\n}\n\n/**\n * Resolves the fetcher a management hook should use: the hook's own, then the provider's, then the\n * SDK's authenticated HTTP client.\n */\nexport const useResolvedFetcher = (fetcher?: ApiFetcher): ApiFetcher => {\n  const {http, instanceId} = useThunderID();\n  const providerFetcher: ApiFetcher | undefined = http?.fetcher;\n\n  return useMemo(\n    () => fetcher ?? providerFetcher ?? createAuthenticatedFetcher(instanceId),\n    [fetcher, providerFetcher, instanceId],\n  );\n};\n\n/**\n * Fetches a management resource and keeps it fresh. Depends on no data fetching library: the\n * request runs through the resolved fetcher, and a matching mutation triggers a refetch.\n *\n * @param queryKey - Identifies the data. Changing it refetches; mutations invalidate by key prefix.\n * @param queryFn - Performs the request with the resolved fetcher.\n * @param options - Query options.\n * @returns The query state.\n */\nconst useResourceQuery = <T>(\n  queryKey: ResourceQueryKey,\n  queryFn: (fetcher: ApiFetcher) => Promise<T>,\n  {enabled = true, fetcher}: ResourceQueryOptions = {},\n): ResourceQueryResult<T> => {\n  const {invalidator = fallbackResourceInvalidator} = useThunderID();\n  const resolvedFetcher: ApiFetcher = useResolvedFetcher(fetcher);\n  const [data, setData] = useState<T | undefined>(undefined);\n  const [error, setError] = useState<Error | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(enabled);\n\n  const serializedKey: string = JSON.stringify(queryKey);\n  const queryFnRef: {current: (fetcher: ApiFetcher) => Promise<T>} = useRef(queryFn);\n  queryFnRef.current = queryFn;\n  // Only the latest request may write state, so a slow earlier response cannot overwrite a newer one.\n  const latestRequestRef: {current: number} = useRef(0);\n\n  const refetch: () => Promise<T | undefined> = useCallback(async (): Promise<T | undefined> => {\n    latestRequestRef.current += 1;\n    const requestId: number = latestRequestRef.current;\n\n    setIsLoading(true);\n\n    try {\n      const result: T = await queryFnRef.current(resolvedFetcher);\n\n      if (requestId === latestRequestRef.current) {\n        setData(result);\n        setError(null);\n      }\n\n      return result;\n    } catch (err) {\n      if (requestId === latestRequestRef.current) {\n        setError(err instanceof Error ? err : new Error(String(err)));\n      }\n\n      return undefined;\n    } finally {\n      if (requestId === latestRequestRef.current) {\n        setIsLoading(false);\n      }\n    }\n  }, [resolvedFetcher]);\n\n  useEffect(() => {\n    if (!enabled) {\n      setIsLoading(false);\n\n      return undefined;\n    }\n\n    void refetch();\n\n    return invalidator.subscribe(JSON.parse(serializedKey) as ResourceQueryKey, () => {\n      void refetch();\n    });\n  }, [enabled, invalidator, refetch, serializedKey]);\n\n  return {data, error, isLoading, refetch};\n};\n\nexport default useResourceQuery;\n"],"mappings":";;;;;;;;;;AAwCA,MAAa,sBAAsB,YAAqC;CACtE,MAAM,EAAC,MAAM,eAAcA,sBAAc;CACzC,MAAMC,kBAA0C,MAAM;AAEtD,QAAO,cACC,WAAW,mBAAmBC,mCAA2B,WAAW,EAC1E;EAAC;EAAS;EAAiB;EAAW,CACvC;;;;;;;;;;;AAYH,MAAM,oBACJ,UACA,SACA,EAAC,UAAU,MAAM,YAAiC,EAAE,KACzB;CAC3B,MAAM,EAAC,cAAc,gCAA+BF,sBAAc;CAClE,MAAMG,kBAA8B,mBAAmB,QAAQ;CAC/D,MAAM,CAAC,MAAM,WAAW,SAAwB,OAAU;CAC1D,MAAM,CAAC,OAAO,YAAY,SAAuB,KAAK;CACtD,MAAM,CAAC,WAAW,gBAAgB,SAAkB,QAAQ;CAE5D,MAAMC,gBAAwB,KAAK,UAAU,SAAS;CACtD,MAAMC,aAA6D,OAAO,QAAQ;AAClF,YAAW,UAAU;CAErB,MAAMC,mBAAsC,OAAO,EAAE;CAErD,MAAMC,UAAwC,YAAY,YAAoC;AAC5F,mBAAiB,WAAW;EAC5B,MAAMC,YAAoB,iBAAiB;AAE3C,eAAa,KAAK;AAElB,MAAI;GACF,MAAMC,SAAY,MAAM,WAAW,QAAQ,gBAAgB;AAE3D,OAAI,cAAc,iBAAiB,SAAS;AAC1C,YAAQ,OAAO;AACf,aAAS,KAAK;;AAGhB,UAAO;WACA,KAAK;AACZ,OAAI,cAAc,iBAAiB,QACjC,UAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC,CAAC;AAG/D;YACQ;AACR,OAAI,cAAc,iBAAiB,QACjC,cAAa,MAAM;;IAGtB,CAAC,gBAAgB,CAAC;AAErB,iBAAgB;AACd,MAAI,CAAC,SAAS;AACZ,gBAAa,MAAM;AAEnB;;AAGF,EAAK,SAAS;AAEd,SAAO,YAAY,UAAU,KAAK,MAAM,cAAc,QAA4B;AAChF,GAAK,SAAS;IACd;IACD;EAAC;EAAS;EAAa;EAAS;EAAc,CAAC;AAElD,QAAO;EAAC;EAAM;EAAO;EAAW;EAAQ;;AAG1C,+BAAe"}

package/dist/hooks/management/users/useCreateUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateUser.d.ts","sourceRoot":"","sources":["../../../../src/hooks/management/users/useCreateUser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,wBAAwB,EAAE,WAAW,EAA4B,MAAM,oBAAoB,CAAC;AAEpG,OAA4B,EAAC,uBAAuB,EAAE,sBAAsB,EAAC,MAAM,wBAAwB,CAAC;AAE5G;;;;;GAKG;AACH,QAAA,MAAM,aAAa,GACjB,UAAU,uBAAuB,CAAC,WAAW,EAAE,wBAAwB,CAAC,KACvE,sBAAsB,CAAC,WAAW,EAAE,wBAAwB,CAQ9D,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/hooks/management/users/useCreateUser.js

@@ -0,0 +1,24 @@
+import useManagementEndpoint_default from "../useManagementEndpoint.js";
+import useResourceMutation_default from "../useResourceMutation.js";
+import { UserQueryKeys, createUser } from "@thunderid/browser";
+
+//#region src/hooks/management/users/useCreateUser.ts
+/**
+* Creates a user, then refetches any mounted user lists.
+*
+* @param options - Mutation options, including `onSuccess`, `onError`, and a per-hook `fetcher`.
+* @returns The mutation state. Call `mutate(payload)` to create.
+*/
+const useCreateUser = (options) => {
+	const endpoint = useManagementEndpoint_default("users");
+	return useResourceMutation_default((payload, fetcher) => createUser({
+		...endpoint,
+		fetcher,
+		payload
+	}), () => [[UserQueryKeys.USERS]], options);
+};
+var useCreateUser_default = useCreateUser;
+
+//#endregion
+export { useCreateUser_default as default };
+//# sourceMappingURL=useCreateUser.js.map

package/dist/hooks/management/users/useCreateUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateUser.js","names":["endpoint: ManagementEndpoint","useManagementEndpoint","useResourceMutation"],"sources":["../../../../src/hooks/management/users/useCreateUser.ts"],"sourcesContent":["// Copyright 2025-2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {CreateManagedUserRequest, ManagedUser, UserQueryKeys, createUser} from '@thunderid/browser';\nimport useManagementEndpoint, {ManagementEndpoint} from '../useManagementEndpoint';\nimport useResourceMutation, {ResourceMutationOptions, ResourceMutationResult} from '../useResourceMutation';\n\n/**\n * Creates a user, then refetches any mounted user lists.\n *\n * @param options - Mutation options, including `onSuccess`, `onError`, and a per-hook `fetcher`.\n * @returns The mutation state. Call `mutate(payload)` to create.\n */\nconst useCreateUser = (\n  options?: ResourceMutationOptions<ManagedUser, CreateManagedUserRequest>,\n): ResourceMutationResult<ManagedUser, CreateManagedUserRequest> => {\n  const endpoint: ManagementEndpoint = useManagementEndpoint('users');\n\n  return useResourceMutation(\n    (payload: CreateManagedUserRequest, fetcher) => createUser({...endpoint, fetcher, payload}),\n    () => [[UserQueryKeys.USERS]],\n    options,\n  );\n};\n\nexport default useCreateUser;\n"],"mappings":";;;;;;;;;;;AAaA,MAAM,iBACJ,YACkE;CAClE,MAAMA,WAA+BC,8BAAsB,QAAQ;AAEnE,QAAOC,6BACJ,SAAmC,YAAY,WAAW;EAAC,GAAG;EAAU;EAAS;EAAQ,CAAC,QACrF,CAAC,CAAC,cAAc,MAAM,CAAC,EAC7B,QACD;;AAGH,4BAAe"}

package/dist/hooks/management/users/useDeleteUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteUser.d.ts","sourceRoot":"","sources":["../../../../src/hooks/management/users/useDeleteUser.ts"],"names":[],"mappings":"AAKA,OAA4B,EAAC,uBAAuB,EAAE,sBAAsB,EAAC,MAAM,wBAAwB,CAAC;AAE5G;;;;;GAKG;AACH,QAAA,MAAM,aAAa,GAAI,UAAU,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,KAAG,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAQ3G,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/hooks/management/users/useDeleteUser.js

@@ -0,0 +1,24 @@
+import useManagementEndpoint_default from "../useManagementEndpoint.js";
+import useResourceMutation_default from "../useResourceMutation.js";
+import { UserQueryKeys, deleteUser } from "@thunderid/browser";
+
+//#region src/hooks/management/users/useDeleteUser.ts
+/**
+* Deletes a user, then refetches any mounted user lists.
+*
+* @param options - Mutation options, including `onSuccess`, `onError`, and a per-hook `fetcher`.
+* @returns The mutation state. Call `mutate(userId)` to delete.
+*/
+const useDeleteUser = (options) => {
+	const endpoint = useManagementEndpoint_default("users");
+	return useResourceMutation_default((userId, fetcher) => deleteUser({
+		...endpoint,
+		fetcher,
+		userId
+	}), () => [[UserQueryKeys.USERS]], options);
+};
+var useDeleteUser_default = useDeleteUser;
+
+//#endregion
+export { useDeleteUser_default as default };
+//# sourceMappingURL=useDeleteUser.js.map

package/dist/hooks/management/users/useDeleteUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteUser.js","names":["endpoint: ManagementEndpoint","useManagementEndpoint","useResourceMutation"],"sources":["../../../../src/hooks/management/users/useDeleteUser.ts"],"sourcesContent":["// Copyright 2025-2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {UserQueryKeys, deleteUser} from '@thunderid/browser';\nimport useManagementEndpoint, {ManagementEndpoint} from '../useManagementEndpoint';\nimport useResourceMutation, {ResourceMutationOptions, ResourceMutationResult} from '../useResourceMutation';\n\n/**\n * Deletes a user, then refetches any mounted user lists.\n *\n * @param options - Mutation options, including `onSuccess`, `onError`, and a per-hook `fetcher`.\n * @returns The mutation state. Call `mutate(userId)` to delete.\n */\nconst useDeleteUser = (options?: ResourceMutationOptions<void, string>): ResourceMutationResult<void, string> => {\n  const endpoint: ManagementEndpoint = useManagementEndpoint('users');\n\n  return useResourceMutation(\n    (userId: string, fetcher) => deleteUser({...endpoint, fetcher, userId}),\n    () => [[UserQueryKeys.USERS]],\n    options,\n  );\n};\n\nexport default useDeleteUser;\n"],"mappings":";;;;;;;;;;;AAaA,MAAM,iBAAiB,YAA0F;CAC/G,MAAMA,WAA+BC,8BAAsB,QAAQ;AAEnE,QAAOC,6BACJ,QAAgB,YAAY,WAAW;EAAC,GAAG;EAAU;EAAS;EAAO,CAAC,QACjE,CAAC,CAAC,cAAc,MAAM,CAAC,EAC7B,QACD;;AAGH,4BAAe"}

package/dist/hooks/management/users/useGetUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetUser.d.ts","sourceRoot":"","sources":["../../../../src/hooks/management/users/useGetUser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,WAAW,EAAyB,MAAM,oBAAoB,CAAC;AAEvE,OAAyB,EAAC,oBAAoB,EAAE,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AAEhG;;;;;;GAMG;AACH,QAAA,MAAM,UAAU,GAAI,QAAQ,MAAM,GAAG,SAAS,EAAE,UAAU,oBAAoB,KAAG,mBAAmB,CAAC,WAAW,CAO/G,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/hooks/management/users/useGetUser.js

@@ -0,0 +1,28 @@
+import useManagementEndpoint_default from "../useManagementEndpoint.js";
+import useResourceQuery_default from "../useResourceQuery.js";
+import { UserQueryKeys, getUser } from "@thunderid/browser";
+
+//#region src/hooks/management/users/useGetUser.ts
+/**
+* Fetches a single user. Does nothing until `userId` is set.
+*
+* @param userId - Identifier of the user.
+* @param options - Query options, including a per-hook `fetcher`.
+* @returns The query state.
+*/
+const useGetUser = (userId, options) => {
+	const endpoint = useManagementEndpoint_default("users");
+	return useResourceQuery_default([UserQueryKeys.USER, userId], (fetcher) => getUser({
+		...endpoint,
+		fetcher,
+		userId
+	}), {
+		...options,
+		enabled: Boolean(userId) && options?.enabled !== false
+	});
+};
+var useGetUser_default = useGetUser;
+
+//#endregion
+export { useGetUser_default as default };
+//# sourceMappingURL=useGetUser.js.map

package/dist/hooks/management/users/useGetUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetUser.js","names":["endpoint: ManagementEndpoint","useManagementEndpoint","useResourceQuery"],"sources":["../../../../src/hooks/management/users/useGetUser.ts"],"sourcesContent":["// Copyright 2025-2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {ManagedUser, UserQueryKeys, getUser} from '@thunderid/browser';\nimport useManagementEndpoint, {ManagementEndpoint} from '../useManagementEndpoint';\nimport useResourceQuery, {ResourceQueryOptions, ResourceQueryResult} from '../useResourceQuery';\n\n/**\n * Fetches a single user. Does nothing until `userId` is set.\n *\n * @param userId - Identifier of the user.\n * @param options - Query options, including a per-hook `fetcher`.\n * @returns The query state.\n */\nconst useGetUser = (userId: string | undefined, options?: ResourceQueryOptions): ResourceQueryResult<ManagedUser> => {\n  const endpoint: ManagementEndpoint = useManagementEndpoint('users');\n\n  return useResourceQuery([UserQueryKeys.USER, userId], (fetcher) => getUser({...endpoint, fetcher, userId: userId!}), {\n    ...options,\n    enabled: Boolean(userId) && options?.enabled !== false,\n  });\n};\n\nexport default useGetUser;\n"],"mappings":";;;;;;;;;;;;AAcA,MAAM,cAAc,QAA4B,YAAqE;CACnH,MAAMA,WAA+BC,8BAAsB,QAAQ;AAEnE,QAAOC,yBAAiB,CAAC,cAAc,MAAM,OAAO,GAAG,YAAY,QAAQ;EAAC,GAAG;EAAU;EAAiB;EAAQ,CAAC,EAAE;EACnH,GAAG;EACH,SAAS,QAAQ,OAAO,IAAI,SAAS,YAAY;EAClD,CAAC;;AAGJ,yBAAe"}

package/dist/hooks/management/users/useGetUserGroups.d.ts

@@ -0,0 +1,16 @@
+import { MembershipGroupListResponse } from '@thunderid/browser';
+import { ResourceQueryOptions, ResourceQueryResult } from '../useResourceQuery';
+/**
+ * Fetches a page of the groups a user belongs to.
+ *
+ * @param userId - Identifier of the user. Fetching waits until it is defined.
+ * @param params - Pagination parameters.
+ * @param options - Query options, including a per-hook `fetcher`.
+ * @returns The query state.
+ */
+declare const useGetUserGroups: (userId: string | undefined, { limit, offset }?: {
+    limit?: number;
+    offset?: number;
+}, options?: ResourceQueryOptions) => ResourceQueryResult<MembershipGroupListResponse>;
+export default useGetUserGroups;
+//# sourceMappingURL=useGetUserGroups.d.ts.map

package/dist/hooks/management/users/useGetUserGroups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetUserGroups.d.ts","sourceRoot":"","sources":["../../../../src/hooks/management/users/useGetUserGroups.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,2BAA2B,EAAgB,MAAM,oBAAoB,CAAC;AAE9F,OAAyB,EAAC,oBAAoB,EAAE,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AAEhG;;;;;;;GAOG;AACH,QAAA,MAAM,gBAAgB,GACpB,QAAQ,MAAM,GAAG,SAAS,EAC1B,oBAAiB;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,EACvD,UAAU,oBAAoB,KAC7B,mBAAmB,CAAC,2BAA2B,CAQjD,CAAC;AAEF,eAAe,gBAAgB,CAAC"}