@thunderid/react 1.7.0 → 1.9.0

package/dist/cjs/hooks/management/useAccountLifecycle.cjs

@@ -0,0 +1,59 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_useThunderID = require('../../contexts/ThunderID/useThunderID.cjs');
+const require_useResourceQuery = require('./useResourceQuery.cjs');
+const require_useResourceMutation = require('./useResourceMutation.cjs');
+let __thunderid_browser = require("@thunderid/browser");
+__thunderid_browser = require_rolldown_runtime.__toESM(__thunderid_browser);
+let react = require("react");
+react = require_rolldown_runtime.__toESM(react);
+
+//#region src/hooks/management/useAccountLifecycle.ts
+/**
+* Offers the account lifecycle actions (suspend, unsuspend, unlock) of a user, agent or application and
+* runs them. These actions have no management API endpoint: they run only through the administration
+* flows the server configures, so an action is offered only when its flow is configured.
+*
+* @example
+* ```tsx
+* const lifecycle = useAccountLifecycle({enabled: true, invalidatedKeys: [[UserQueryKeys.USER, id]], kind: 'user', status, subject: id});
+* ```
+*/
+const useAccountLifecycle = ({ enabled, invalidatedKeys, kind, status, subject }) => {
+	const { baseUrl } = require_useThunderID.default();
+	const flows = require_useResourceQuery.default([
+		"administration-flows",
+		"account-lifecycle",
+		kind
+	], (fetcher) => (0, __thunderid_browser.resolveAdministrationFlows)({
+		baseUrl,
+		fetcher
+	}, Object.values(__thunderid_browser.AccountLifecycleFlowConfigKey[kind])), { enabled });
+	const execution = require_useResourceMutation.default(({ action, operatorNote }, fetcher) => (0, __thunderid_browser.runAccountLifecycleAction)({
+		action,
+		baseUrl,
+		fetcher,
+		kind,
+		operatorNote,
+		subject
+	}), () => invalidatedKeys);
+	return {
+		actions: (0, react.useMemo)(() => enabled && flows.data ? (0, __thunderid_browser.getAccountLifecycleActions)(kind, status, flows.data) : [], [
+			enabled,
+			flows.data,
+			kind,
+			status
+		]),
+		error: execution.error,
+		isRunning: execution.isLoading,
+		loadError: flows.error,
+		run: (action, operatorNote) => void execution.mutate({
+			action,
+			operatorNote
+		})
+	};
+};
+var useAccountLifecycle_default = useAccountLifecycle;
+
+//#endregion
+exports.default = useAccountLifecycle_default;
+//# sourceMappingURL=useAccountLifecycle.cjs.map

package/dist/cjs/hooks/management/useAccountLifecycle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAccountLifecycle.cjs","names":["useThunderID","flows: ResourceQueryResult<Record<string, string>>","useResourceQuery","AccountLifecycleFlowConfigKey","execution: ResourceMutationResult<AccountLifecycleResult, AccountLifecycleVariables>","useResourceMutation"],"sources":["../../../../src/hooks/management/useAccountLifecycle.ts"],"sourcesContent":["// Copyright 2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {\n  AccessStatusValue,\n  AccountLifecycleAction,\n  AccountLifecycleFlowConfigKey,\n  AccountLifecycleResult,\n  AccountLifecycleSubjectKind,\n  ResourceQueryKey,\n  getAccountLifecycleActions,\n  resolveAdministrationFlows,\n  runAccountLifecycleAction,\n} from '@thunderid/browser';\nimport {useMemo} from 'react';\nimport useResourceMutation, {ResourceMutationResult} from './useResourceMutation';\nimport useResourceQuery, {ResourceQueryResult} from './useResourceQuery';\nimport useThunderID from '../../contexts/ThunderID/useThunderID';\n\ninterface AccountLifecycleVariables {\n  action: AccountLifecycleAction;\n  operatorNote?: string;\n}\n\nexport interface AccountLifecycleOptions {\n  /**\n   * Whether to offer the actions at all. The configured flows are read only when it is on.\n   */\n  enabled: boolean;\n  /**\n   * Query keys to refetch after an action, such as the record and the list it appears in.\n   */\n  invalidatedKeys: ResourceQueryKey[];\n  kind: AccountLifecycleSubjectKind;\n  /**\n   * The identity's effective access status, from the read that rendered it.\n   */\n  status: AccessStatusValue | undefined;\n  /**\n   * Identifier of the user, agent or application.\n   */\n  subject: string;\n}\n\nexport interface AccountLifecycleState {\n  /**\n   * The actions to offer now: allowed by the status and backed by a configured flow.\n   */\n  actions: AccountLifecycleAction[];\n  /**\n   * Why the last action failed.\n   */\n  error: Error | null;\n  isRunning: boolean;\n  /**\n   * Why the configured flows could not be read, so no action can be offered.\n   */\n  loadError: Error | null;\n  run: (action: AccountLifecycleAction, operatorNote?: string) => void;\n}\n\n/**\n * Offers the account lifecycle actions (suspend, unsuspend, unlock) of a user, agent or application and\n * runs them. These actions have no management API endpoint: they run only through the administration\n * flows the server configures, so an action is offered only when its flow is configured.\n *\n * @example\n * ```tsx\n * const lifecycle = useAccountLifecycle({enabled: true, invalidatedKeys: [[UserQueryKeys.USER, id]], kind: 'user', status, subject: id});\n * ```\n */\nconst useAccountLifecycle = ({\n  enabled,\n  invalidatedKeys,\n  kind,\n  status,\n  subject,\n}: AccountLifecycleOptions): AccountLifecycleState => {\n  const {baseUrl} = useThunderID();\n  const flows: ResourceQueryResult<Record<string, string>> = useResourceQuery(\n    ['administration-flows', 'account-lifecycle', kind],\n    (fetcher) => resolveAdministrationFlows({baseUrl, fetcher}, Object.values(AccountLifecycleFlowConfigKey[kind])),\n    {enabled},\n  );\n  const execution: ResourceMutationResult<AccountLifecycleResult, AccountLifecycleVariables> = useResourceMutation(\n    ({action, operatorNote}: AccountLifecycleVariables, fetcher) =>\n      runAccountLifecycleAction({action, baseUrl, fetcher, kind, operatorNote, subject}),\n    () => invalidatedKeys,\n  );\n\n  const actions: AccountLifecycleAction[] = useMemo(\n    () => (enabled && flows.data ? getAccountLifecycleActions(kind, status, flows.data) : []),\n    [enabled, flows.data, kind, status],\n  );\n\n  return {\n    actions,\n    error: execution.error,\n    isRunning: execution.isLoading,\n    loadError: flows.error,\n    run: (action: AccountLifecycleAction, operatorNote?: string): void => void execution.mutate({action, operatorNote}),\n  };\n};\n\nexport default useAccountLifecycle;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAuEA,MAAM,uBAAuB,EAC3B,SACA,iBACA,MACA,QACA,cACoD;CACpD,MAAM,EAAC,YAAWA,8BAAc;CAChC,MAAMC,QAAqDC,iCACzD;EAAC;EAAwB;EAAqB;EAAK,GAClD,gEAAuC;EAAC;EAAS;EAAQ,EAAE,OAAO,OAAOC,kDAA8B,MAAM,CAAC,EAC/G,EAAC,SAAQ,CACV;CACD,MAAMC,YAAuFC,qCAC1F,EAAC,QAAQ,gBAA0C,+DACxB;EAAC;EAAQ;EAAS;EAAS;EAAM;EAAc;EAAQ,CAAC,QAC9E,gBACP;AAOD,QAAO;EACL,kCALO,WAAW,MAAM,2DAAkC,MAAM,QAAQ,MAAM,KAAK,GAAG,EAAE,EACxF;GAAC;GAAS,MAAM;GAAM;GAAM;GAAO,CACpC;EAIC,OAAO,UAAU;EACjB,WAAW,UAAU;EACrB,WAAW,MAAM;EACjB,MAAM,QAAgC,iBAAgC,KAAK,UAAU,OAAO;GAAC;GAAQ;GAAa,CAAC;EACpH;;AAGH,kCAAe"}

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

@@ -1 +1 @@
-{"version":3,"file":"useManagementEndpoint.cjs","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,8BAAc;AAE3C,QAAO;EAAC;EAAS,sDAA6B,KAAK,EAAC,WAAU,CAAC;EAAC;;AAGlE,oCAAe"}
+{"version":3,"file":"useManagementEndpoint.cjs","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 * The management collections an app can call through the SDK's API functions.\n */\nexport type ManagementCollection = Extract<\n  ResourceEndpointKey,\n  | 'agents'\n  | 'agentTypes'\n  | 'applications'\n  | 'configurationVersions'\n  | 'connections'\n  | 'design'\n  | 'export'\n  | 'flows'\n  | 'gateways'\n  | 'groups'\n  | 'i18n'\n  | 'import'\n  | 'notificationTemplates'\n  | 'organizationUnits'\n  | 'resourceServers'\n  | 'roles'\n  | 'secrets'\n  | 'serverConfig'\n  | 'users'\n  | 'userTypes'\n  | 'variables'\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 = (key: ManagementCollection): ManagementEndpoint => {\n  const {baseUrl, endpoints} = useThunderID();\n\n  return {baseUrl, url: resolveResourceEndpoint(key, {endpoints})};\n};\n\nexport default useManagementEndpoint;\n"],"mappings":";;;;;;;;;;;;;AAqDA,MAAM,yBAAyB,QAAkD;CAC/E,MAAM,EAAC,SAAS,cAAaA,8BAAc;AAE3C,QAAO;EAAC;EAAS,sDAA6B,KAAK,EAAC,WAAU,CAAC;EAAC;;AAGlE,oCAAe"}

package/dist/cjs/hooks/management/useManagementRequestConfig.cjs

@@ -0,0 +1,41 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_useManagementEndpoint = require('./useManagementEndpoint.cjs');
+const require_useResourceQuery = require('./useResourceQuery.cjs');
+let react = require("react");
+react = require_rolldown_runtime.__toESM(react);
+
+//#region src/hooks/management/useManagementRequestConfig.ts
+/**
+* Returns the request config the SDK's management API functions take for a collection: the server URL,
+* the collection URL when `endpoints` overrides it, and a fetcher that sends the signed-in user's access
+* token (`ThunderIDProvider`'s `http.fetcher` when set).
+*
+* Use it to call the API functions from an app's own data layer, such as TanStack Query:
+*
+* @example
+* ```tsx
+* const config = useManagementRequestConfig('groups');
+* const groups = useQuery({
+*   queryKey: [GroupQueryKeys.GROUPS, {limit, offset}],
+*   queryFn: () => getGroups({...config, limit, offset}),
+* });
+* ```
+*/
+const useManagementRequestConfig = (collection) => {
+	const { baseUrl, url } = require_useManagementEndpoint.default(collection);
+	const fetcher = require_useResourceQuery.useResolvedFetcher();
+	return (0, react.useMemo)(() => ({
+		baseUrl,
+		fetcher,
+		url
+	}), [
+		baseUrl,
+		fetcher,
+		url
+	]);
+};
+var useManagementRequestConfig_default = useManagementRequestConfig;
+
+//#endregion
+exports.default = useManagementRequestConfig_default;
+//# sourceMappingURL=useManagementRequestConfig.cjs.map

package/dist/cjs/hooks/management/useManagementRequestConfig.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useManagementRequestConfig.cjs","names":["useManagementEndpoint","fetcher: ApiFetcher","useResolvedFetcher"],"sources":["../../../../src/hooks/management/useManagementRequestConfig.ts"],"sourcesContent":["// Copyright 2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {ApiFetcher, ManagementRequestConfig} from '@thunderid/browser';\nimport {useMemo} from 'react';\nimport useManagementEndpoint, {ManagementCollection, ManagementEndpoint} from './useManagementEndpoint';\nimport {useResolvedFetcher} from './useResourceQuery';\n\nexport type {ManagementCollection};\n\n/**\n * Returns the request config the SDK's management API functions take for a collection: the server URL,\n * the collection URL when `endpoints` overrides it, and a fetcher that sends the signed-in user's access\n * token (`ThunderIDProvider`'s `http.fetcher` when set).\n *\n * Use it to call the API functions from an app's own data layer, such as TanStack Query:\n *\n * @example\n * ```tsx\n * const config = useManagementRequestConfig('groups');\n * const groups = useQuery({\n *   queryKey: [GroupQueryKeys.GROUPS, {limit, offset}],\n *   queryFn: () => getGroups({...config, limit, offset}),\n * });\n * ```\n */\nconst useManagementRequestConfig = (collection: ManagementCollection): ManagementRequestConfig => {\n  const {baseUrl, url}: ManagementEndpoint = useManagementEndpoint(collection);\n  const fetcher: ApiFetcher = useResolvedFetcher();\n\n  return useMemo(() => ({baseUrl, fetcher, url}), [baseUrl, fetcher, url]);\n};\n\nexport default useManagementRequestConfig;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAM,8BAA8B,eAA8D;CAChG,MAAM,EAAC,SAAS,QAA2BA,sCAAsB,WAAW;CAC5E,MAAMC,UAAsBC,6CAAoB;AAEhD,kCAAsB;EAAC;EAAS;EAAS;EAAI,GAAG;EAAC;EAAS;EAAS;EAAI,CAAC;;AAG1E,yCAAe"}