@learnorama/mozaik-sdk 0.1.0

package/dist/react/admin-reviews.js

@@ -0,0 +1,135 @@
+"use client";
+import { r as request } from "../client-D3kMOcIr.js";
+import { useMutation, useQuery } from "@tanstack/react-query";
+//#region src/react/admin-reviews/admin-reviews.ts
+/**
+* Generated by orval 🍺
+* Do not edit manually.
+* Mozaik backend
+* Four products behind one API — Biblio, Médiathèques, the partner catalogues (Nextory and YouScribe) and Prof Express. Authentication is Keycloak SSO only, once, for all of them: see the **auth** section below for the browser flow and the three failure modes.
+* OpenAPI spec version: 0.1.0
+*/
+const withQueryKey = (query, queryKey) => {
+	const result = { queryKey };
+	for (const key of Object.keys(query)) {
+		if (key === "queryKey") continue;
+		Object.defineProperty(result, key, {
+			enumerable: true,
+			configurable: true,
+			get: () => query[key]
+		});
+	}
+	return result;
+};
+const getListReviewsUrl = (params) => {
+	const normalizedParams = new URLSearchParams();
+	Object.entries(params || {}).forEach(([key, value]) => {
+		if (value !== void 0) normalizedParams.append(key, value === null ? "null" : String(value));
+	});
+	const stringifiedParams = normalizedParams.toString();
+	return stringifiedParams.length > 0 ? `/admin/reviews?${stringifiedParams}` : `/admin/reviews`;
+};
+/**
+* Reviews awaiting a decision, oldest first.
+*
+* Oldest first on purpose: a moderation queue sorted newest-first starves its
+* tail, and the review that has waited longest is the one whose author is
+* wondering what happened.
+* @summary List Reviews
+*/
+const listReviews = async (params, options) => {
+	return request(getListReviewsUrl(params), {
+		...options,
+		method: "GET"
+	});
+};
+const getListReviewsQueryKey = (params) => {
+	return [`/admin/reviews`, ...params ? [params] : []];
+};
+const getListReviewsQueryOptions = (params, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getListReviewsQueryKey(params);
+	const queryFn = ({ signal }) => listReviews(params, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		...queryOptions
+	};
+};
+/**
+* @summary List Reviews
+*/
+function useListReviews(params, options, queryClient) {
+	const queryOptions = getListReviewsQueryOptions(params, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getModerateReviewUrl = (reviewId) => {
+	return `/admin/reviews/${reviewId}/moderation`;
+};
+/**
+* Publish or reject one review.
+*
+* ``PUT`` on a moderation sub-resource rather than ``POST /approve`` and
+* ``POST /reject``: the outcome is a state the review is *in*, not two different
+* events, and a repeated decision must be harmless.
+*
+* Rejecting requires a reason. The author is owed one, and the moderator is the
+* only person who has it — the audit row is where it survives after the queue
+* has moved on.
+* @summary Moderate Review
+*/
+const moderateReview = async (reviewId, moderationWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getModerateReviewUrl(reviewId), {
+		...options,
+		method: "PUT",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(moderationWrite)
+	});
+};
+const getModerateReviewMutationKey = () => ["moderateReview"];
+const getModerateReviewMutationOptions = (options) => {
+	const mutationKey = getModerateReviewMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { reviewId, data } = props ?? {};
+		return moderateReview(reviewId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Moderate Review
+*/
+const useModerateReview = (options, queryClient) => {
+	return useMutation(getModerateReviewMutationOptions(options), queryClient);
+};
+//#endregion
+export { getListReviewsQueryKey, getListReviewsQueryOptions, getListReviewsUrl, getModerateReviewMutationKey, getModerateReviewMutationOptions, getModerateReviewUrl, listReviews, moderateReview, useListReviews, useModerateReview };
+
+//# sourceMappingURL=admin-reviews.js.map

package/dist/react/admin-reviews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-reviews.js","names":[],"sources":["../../src/react/admin-reviews/admin-reviews.ts"],"sourcesContent":["/**\n * Generated by orval 🍺\n * Do not edit manually.\n * Mozaik backend\n * Four products behind one API — Biblio, Médiathèques, the partner catalogues (Nextory and YouScribe) and Prof Express. Authentication is Keycloak SSO only, once, for all of them: see the **auth** section below for the browser flow and the three failure modes.\n * OpenAPI spec version: 0.1.0\n */\nimport {\n  useMutation,\n  useQuery\n} from '@tanstack/react-query';\nimport type {\n  DataTag,\n  DefinedInitialDataOptions,\n  DefinedUseQueryResult,\n  MutationFunction,\n  QueryClient,\n  QueryFunction,\n  QueryKey,\n  UndefinedInitialDataOptions,\n  UseMutationOptions,\n  UseMutationResult,\n  UseQueryOptions,\n  UseQueryResult\n} from '@tanstack/react-query';\n\nimport type {\n  HTTPExceptionResponse,\n  ListReviewsParams,\n  ModerationWrite,\n  ReviewModerationRead,\n  ReviewPage,\n  ValidationErrorResponse\n} from '../../models';\n\nimport { request } from '../../client';\nimport type { ErrorType , BodyType } from '../../client';\n\n\ntype SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];\n\n\n\nconst withQueryKey = <T extends object, K>(query: T, queryKey: K): T & { queryKey: K } => {\n  const result = { queryKey } as T & { queryKey: K };\n  for (const key of Object.keys(query)) {\n    // The explicit queryKey always wins, matching the previous\n    // `{ ...query, queryKey }` spread where it was set last.\n    if (key === 'queryKey') continue;\n    Object.defineProperty(result, key, {\n      enumerable: true,\n      configurable: true,\n      get: () => (query as Record<string, unknown>)[key],\n    });\n  }\n  return result;\n};\n\nexport const getListReviewsUrl = (params?: ListReviewsParams,) => {\n  const normalizedParams = new URLSearchParams();\n\n  Object.entries(params || {}).forEach(([key, value]) => {\n\n    if (value !== undefined) {\n      normalizedParams.append(key, value === null ? 'null' : String(value))\n    }\n  });\n\n  const stringifiedParams = normalizedParams.toString();\n\n  return stringifiedParams.length > 0 ? `/admin/reviews?${stringifiedParams}` : `/admin/reviews`\n}\n\n/**\n * Reviews awaiting a decision, oldest first.\n *\n * Oldest first on purpose: a moderation queue sorted newest-first starves its\n * tail, and the review that has waited longest is the one whose author is\n * wondering what happened.\n * @summary List Reviews\n */\nexport const listReviews = async (params?: ListReviewsParams, options?: Parameters<typeof request>[1]): Promise<ReviewPage> => {\n\n  return request<ReviewPage>(getListReviewsUrl(params),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\n\n\n\nexport const getListReviewsQueryKey = (params?: ListReviewsParams,) => {\n    return [\n    `/admin/reviews`, ...(params ? [params] : [])\n    ] as const;\n    }\n\n\nexport const getListReviewsQueryOptions = <TData = Awaited<ReturnType<typeof listReviews>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ListReviewsParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listReviews>>, TError, TData>>, request?: SecondParameter<typeof request>}\n) => {\n\nconst {query: queryOptions, request: requestOptions} = options ?? {};\n\n  const queryKey =  queryOptions?.queryKey ?? getListReviewsQueryKey(params);\n\n\n\n    const queryFn: QueryFunction<Awaited<ReturnType<typeof listReviews>>> = ({ signal }) => listReviews(params, { signal, ...requestOptions });\n\n\n\n\n\n   return  { queryKey, queryFn, ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof listReviews>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }\n}\n\nexport type ListReviewsQueryResult = NonNullable<Awaited<ReturnType<typeof listReviews>>>\nexport type ListReviewsQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>\n\n\nexport function useListReviews<TData = Awaited<ReturnType<typeof listReviews>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n params: undefined |  ListReviewsParams, options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof listReviews>>, TError, TData>> & Pick<\n        DefinedInitialDataOptions<\n          Awaited<ReturnType<typeof listReviews>>,\n          TError,\n          Awaited<ReturnType<typeof listReviews>>\n        > , 'initialData'\n      >, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }\nexport function useListReviews<TData = Awaited<ReturnType<typeof listReviews>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n params?: ListReviewsParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listReviews>>, TError, TData>> & Pick<\n        UndefinedInitialDataOptions<\n          Awaited<ReturnType<typeof listReviews>>,\n          TError,\n          Awaited<ReturnType<typeof listReviews>>\n        > , 'initialData'\n      >, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }\nexport function useListReviews<TData = Awaited<ReturnType<typeof listReviews>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n params?: ListReviewsParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listReviews>>, TError, TData>>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }\n/**\n * @summary List Reviews\n */\n\nexport function useListReviews<TData = Awaited<ReturnType<typeof listReviews>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n params?: ListReviewsParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listReviews>>, TError, TData>>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {\n\n  const queryOptions = getListReviewsQueryOptions(params,options)\n\n  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };\n\n  return withQueryKey(query, queryOptions.queryKey);\n}\n\n\n\n\n\n\nexport const getModerateReviewUrl = (reviewId: number,) => {\n\n\n\n\n  return `/admin/reviews/${reviewId}/moderation`\n}\n\n/**\n * Publish or reject one review.\n *\n * ``PUT`` on a moderation sub-resource rather than ``POST /approve`` and\n * ``POST /reject``: the outcome is a state the review is *in*, not two different\n * events, and a repeated decision must be harmless.\n *\n * Rejecting requires a reason. The author is owed one, and the moderator is the\n * only person who has it — the audit row is where it survives after the queue\n * has moved on.\n * @summary Moderate Review\n */\nexport const moderateReview = async (reviewId: number,\n    moderationWrite: ModerationWrite, options?: Parameters<typeof request>[1]): Promise<ReviewModerationRead> => {\n\n    const getHeaders = (h?: NonNullable<RequestInit['headers']>): Record<string, string | readonly string[]> => {\n    if (!h) return {};\n    if (h instanceof Headers) return Object.fromEntries(h.entries());\n    if (Symbol.iterator in h) {\n      return Object.fromEntries(\n        Array.from(h as Iterable<Iterable<string>>, (entry) => Array.from(entry) as [string, string]),\n      );\n    }\n    const headers: Record<string, string | readonly string[]> = {};\n    for (const [name, value] of Object.entries<string | readonly string[] | undefined>(h)) {\n      if (value !== undefined) headers[name] = value;\n    }\n    return headers;\n  };\nreturn request<ReviewModerationRead>(getModerateReviewUrl(reviewId),\n  {\n    ...options,\n    method: 'PUT',\n    headers: { 'Content-Type': 'application/json', ...getHeaders(options?.headers) },\n    body: JSON.stringify(moderationWrite)\n  }\n);}\n\n\n\n\n\nexport const getModerateReviewMutationKey = () => ['moderateReview'] as const;\n\nexport const getModerateReviewMutationOptions = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof moderateReview>>, TError,ModerateReviewMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n): UseMutationOptions<Awaited<ReturnType<typeof moderateReview>>, TError,ModerateReviewMutationVariables, TContext> => {\n\nconst mutationKey = getModerateReviewMutationKey();\nconst {mutation: mutationOptions, request: requestOptions} = options ?\n      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?\n      options\n      : {...options, mutation: {...options.mutation, mutationKey}}\n      : {mutation: { mutationKey, }, request: undefined};\n\n\n\n\n      const mutationFn: MutationFunction<Awaited<ReturnType<typeof moderateReview>>, ModerateReviewMutationVariables> = (props) => {\n          const {reviewId,data} = props ?? {};\n\n          return  moderateReview(reviewId,data,requestOptions)\n        }\n\n\n\n\n\n\n  return  { mutationFn, ...mutationOptions }}\n\n    export type ModerateReviewMutationResult = NonNullable<Awaited<ReturnType<typeof moderateReview>>>\n    export type ModerateReviewMutationBody = BodyType<ModerationWrite>\n    export type ModerateReviewMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>\n    export type ModerateReviewMutationVariables = {reviewId: number;data: BodyType<ModerationWrite>}\n\n    /**\n * @summary Moderate Review\n */\nexport const useModerateReview = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof moderateReview>>, TError,ModerateReviewMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient): UseMutationResult<\n        Awaited<ReturnType<typeof moderateReview>>,\n        TError,\n        ModerateReviewMutationVariables,\n        TContext\n      > => {\n      return useMutation(getModerateReviewMutationOptions(options), queryClient);\n    }\n"],"mappings":";;;;;;;;;;;AA2CA,MAAM,gBAAqC,OAAU,aAAqC;CACxF,MAAM,SAAS,EAAE,SAAS;CAC1B,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,GAAG;EAGpC,IAAI,QAAQ,YAAY;EACxB,OAAO,eAAe,QAAQ,KAAK;GACjC,YAAY;GACZ,cAAc;GACd,WAAY,MAAkC;EAChD,CAAC;CACH;CACA,OAAO;AACT;AAEA,MAAa,qBAAqB,WAAgC;CAChE,MAAM,mBAAmB,IAAI,gBAAgB;CAE7C,OAAO,QAAQ,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,WAAW;EAErD,IAAI,UAAU,KAAA,GACZ,iBAAiB,OAAO,KAAK,UAAU,OAAO,SAAS,OAAO,KAAK,CAAC;CAExE,CAAC;CAED,MAAM,oBAAoB,iBAAiB,SAAS;CAEpD,OAAO,kBAAkB,SAAS,IAAI,kBAAkB,sBAAsB;AAChF;;;;;;;;;AAUA,MAAa,cAAc,OAAO,QAA4B,YAAiE;CAE7H,OAAO,QAAoB,kBAAkB,MAAM,GACnD;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAMF,MAAa,0BAA0B,WAAgC;CACnE,OAAO,CACP,kBAAkB,GAAI,SAAS,CAAC,MAAM,IAAI,CAAC,CAC3C;AACA;AAGJ,MAAa,8BAAoJ,QAA4B,YACxL;CAEL,MAAM,EAAC,OAAO,cAAc,SAAS,mBAAkB,WAAW,CAAC;CAEjE,MAAM,WAAY,cAAc,YAAY,uBAAuB,MAAM;CAIvE,MAAM,WAAmE,EAAE,aAAa,YAAY,QAAQ;EAAE;EAAQ,GAAG;CAAe,CAAC;CAM1I,OAAQ;EAAE;EAAU;EAAS,GAAG;CAAY;AAC/C;;;;AAkCA,SAAgB,eACf,QAA4B,SAC1B,aACiF;CAElF,MAAM,eAAe,2BAA2B,QAAO,OAAO;CAE9D,MAAM,QAAQ,SAAS,cAAc,WAAW;CAEhD,OAAO,aAAa,OAAO,aAAa,QAAQ;AAClD;AAOA,MAAa,wBAAwB,aAAsB;CAKzD,OAAO,kBAAkB,SAAS;AACpC;;;;;;;;;;;;;AAcA,MAAa,iBAAiB,OAAO,UACjC,iBAAkC,YAA2E;CAE7G,MAAM,cAAc,MAAwF;EAC5G,IAAI,CAAC,GAAG,OAAO,CAAC;EAChB,IAAI,aAAa,SAAS,OAAO,OAAO,YAAY,EAAE,QAAQ,CAAC;EAC/D,IAAI,OAAO,YAAY,GACrB,OAAO,OAAO,YACZ,MAAM,KAAK,IAAkC,UAAU,MAAM,KAAK,KAAK,CAAqB,CAC9F;EAEF,MAAM,UAAsD,CAAC;EAC7D,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAgD,CAAC,GAClF,IAAI,UAAU,KAAA,GAAW,QAAQ,QAAQ;EAE3C,OAAO;CACT;CACF,OAAO,QAA8B,qBAAqB,QAAQ,GAChE;EACE,GAAG;EACH,QAAQ;EACR,SAAS;GAAE,gBAAgB;GAAoB,GAAG,WAAW,SAAS,OAAO;EAAE;EAC/E,MAAM,KAAK,UAAU,eAAe;CACtC,CACF;AAAE;AAMF,MAAa,qCAAqC,CAAC,gBAAgB;AAEnE,MAAa,oCACW,YAC+F;CAEvH,MAAM,cAAc,6BAA6B;CACjD,MAAM,EAAC,UAAU,iBAAiB,SAAS,mBAAkB,UACvD,QAAQ,YAAY,iBAAiB,QAAQ,YAAY,QAAQ,SAAS,cAC1E,UACE;EAAC,GAAG;EAAS,UAAU;GAAC,GAAG,QAAQ;GAAU;EAAW;CAAC,IACzD;EAAC,UAAU,EAAE,YAAa;EAAG,SAAS,KAAA;CAAS;CAKjD,MAAM,cAA6G,UAAU;EACzH,MAAM,EAAC,UAAS,SAAQ,SAAS,CAAC;EAElC,OAAQ,eAAe,UAAS,MAAK,cAAc;CACrD;CAON,OAAQ;EAAE;EAAY,GAAG;CAAgB;AAAC;;;;AAU5C,MAAa,qBACW,SACrB,gBAKQ;CACL,OAAO,YAAY,iCAAiC,OAAO,GAAG,WAAW;AAC3E"}

package/dist/react/admin-roles.d.ts

@@ -0,0 +1,82 @@
+
+import { Gn as HTTPExceptionResponse, _t as ProductGrantWrite, t as ValidationErrorResponse, vt as ProductGrantListRead } from "../index-wL_20vR8.js";
+import { a as ErrorType, c as request, n as BodyType } from "../client-BDwBZYB0.js";
+import { DataTag, DefinedInitialDataOptions, DefinedUseQueryResult, QueryClient, QueryKey, UndefinedInitialDataOptions, UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
+//#region src/react/admin-roles/admin-roles.d.ts
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+export declare const getListGrantsUrl: (userId: number) => string;
+/**
+ * Everything this account is, across products and organisations.
+ *
+ * Readable by SUPPORT as well as ADMIN: knowing what somebody is, is part of
+ * helping them. Changing it is not.
+ * @summary List Grants
+ */
+export declare const listGrants: (userId: number, options?: Parameters<typeof request>[1]) => Promise<ProductGrantListRead>;
+export declare const getListGrantsQueryKey: (userId: number) => readonly [`/admin/users/${number}/product-roles`];
+export declare const getListGrantsQueryOptions: <TData = Awaited<ReturnType<typeof listGrants>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(userId: number, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export type ListGrantsQueryResult = NonNullable<Awaited<ReturnType<typeof listGrants>>>;
+export type ListGrantsQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export declare function useListGrants<TData = Awaited<ReturnType<typeof listGrants>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(userId: number, options: {
+  query: Partial<UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData>> & Pick<DefinedInitialDataOptions<Awaited<ReturnType<typeof listGrants>>, TError, Awaited<ReturnType<typeof listGrants>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): DefinedUseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListGrants<TData = Awaited<ReturnType<typeof listGrants>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(userId: number, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData>> & Pick<UndefinedInitialDataOptions<Awaited<ReturnType<typeof listGrants>>, TError, Awaited<ReturnType<typeof listGrants>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListGrants<TData = Awaited<ReturnType<typeof listGrants>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(userId: number, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare const getReplaceGrantsUrl: (userId: number) => string;
+/**
+ * Replace this account's roles for one product at one organisation.
+ *
+ * ``PUT`` because it is idempotent and the body is the whole desired state for
+ * that ``(tenant, product)`` slice — sending it twice leaves the same grants.
+ *
+ * Two scope checks, and both are needed. The *subject* must be an account the
+ * operator reaches, and the ``tenantId`` being granted at must be one they
+ * reach too: without the second, an operator could grant a remit at an
+ * organisation they have no authority over, which is how a scoped
+ * administrator becomes an unscoped one.
+ *
+ * ``422`` for a role the product does not recognise —
+ * :data:`~app.models.enums.PRODUCT_ROLES` decides, so ``student`` for biblio is
+ * refused rather than stored and puzzled over later.
+ * @summary Replace Grants
+ */
+export declare const replaceGrants: (userId: number, productGrantWrite: ProductGrantWrite, options?: Parameters<typeof request>[1]) => Promise<ProductGrantListRead>;
+export declare const getReplaceGrantsMutationKey: () => readonly ['replaceGrants'];
+export declare const getReplaceGrantsMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof replaceGrants>>, TError, ReplaceGrantsMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof replaceGrants>>, TError, ReplaceGrantsMutationVariables, TContext>;
+export type ReplaceGrantsMutationResult = NonNullable<Awaited<ReturnType<typeof replaceGrants>>>;
+export type ReplaceGrantsMutationBody = BodyType<ProductGrantWrite>;
+export type ReplaceGrantsMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type ReplaceGrantsMutationVariables = {
+  userId: number;
+  data: BodyType<ProductGrantWrite>;
+};
+/**
+ * @summary Replace Grants
+ */
+export declare const useReplaceGrants: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof replaceGrants>>, TError, ReplaceGrantsMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof replaceGrants>>, TError, ReplaceGrantsMutationVariables, TContext>;
+//#endregion
+//# sourceMappingURL=admin-roles.d.ts.map

package/dist/react/admin-roles.js

@@ -0,0 +1,135 @@
+"use client";
+import { r as request } from "../client-D3kMOcIr.js";
+import { useMutation, useQuery } from "@tanstack/react-query";
+//#region src/react/admin-roles/admin-roles.ts
+/**
+* Generated by orval 🍺
+* Do not edit manually.
+* Mozaik backend
+* Four products behind one API — Biblio, Médiathèques, the partner catalogues (Nextory and YouScribe) and Prof Express. Authentication is Keycloak SSO only, once, for all of them: see the **auth** section below for the browser flow and the three failure modes.
+* OpenAPI spec version: 0.1.0
+*/
+const withQueryKey = (query, queryKey) => {
+	const result = { queryKey };
+	for (const key of Object.keys(query)) {
+		if (key === "queryKey") continue;
+		Object.defineProperty(result, key, {
+			enumerable: true,
+			configurable: true,
+			get: () => query[key]
+		});
+	}
+	return result;
+};
+const getListGrantsUrl = (userId) => {
+	return `/admin/users/${userId}/product-roles`;
+};
+/**
+* Everything this account is, across products and organisations.
+*
+* Readable by SUPPORT as well as ADMIN: knowing what somebody is, is part of
+* helping them. Changing it is not.
+* @summary List Grants
+*/
+const listGrants = async (userId, options) => {
+	return request(getListGrantsUrl(userId), {
+		...options,
+		method: "GET"
+	});
+};
+const getListGrantsQueryKey = (userId) => {
+	return [`/admin/users/${userId}/product-roles`];
+};
+const getListGrantsQueryOptions = (userId, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getListGrantsQueryKey(userId);
+	const queryFn = ({ signal }) => listGrants(userId, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: userId !== null && userId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary List Grants
+*/
+function useListGrants(userId, options, queryClient) {
+	const queryOptions = getListGrantsQueryOptions(userId, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getReplaceGrantsUrl = (userId) => {
+	return `/admin/users/${userId}/product-roles`;
+};
+/**
+* Replace this account's roles for one product at one organisation.
+*
+* ``PUT`` because it is idempotent and the body is the whole desired state for
+* that ``(tenant, product)`` slice — sending it twice leaves the same grants.
+*
+* Two scope checks, and both are needed. The *subject* must be an account the
+* operator reaches, and the ``tenantId`` being granted at must be one they
+* reach too: without the second, an operator could grant a remit at an
+* organisation they have no authority over, which is how a scoped
+* administrator becomes an unscoped one.
+*
+* ``422`` for a role the product does not recognise —
+* :data:`~app.models.enums.PRODUCT_ROLES` decides, so ``student`` for biblio is
+* refused rather than stored and puzzled over later.
+* @summary Replace Grants
+*/
+const replaceGrants = async (userId, productGrantWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getReplaceGrantsUrl(userId), {
+		...options,
+		method: "PUT",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(productGrantWrite)
+	});
+};
+const getReplaceGrantsMutationKey = () => ["replaceGrants"];
+const getReplaceGrantsMutationOptions = (options) => {
+	const mutationKey = getReplaceGrantsMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { userId, data } = props ?? {};
+		return replaceGrants(userId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Replace Grants
+*/
+const useReplaceGrants = (options, queryClient) => {
+	return useMutation(getReplaceGrantsMutationOptions(options), queryClient);
+};
+//#endregion
+export { getListGrantsQueryKey, getListGrantsQueryOptions, getListGrantsUrl, getReplaceGrantsMutationKey, getReplaceGrantsMutationOptions, getReplaceGrantsUrl, listGrants, replaceGrants, useListGrants, useReplaceGrants };
+
+//# sourceMappingURL=admin-roles.js.map

package/dist/react/admin-roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-roles.js","names":[],"sources":["../../src/react/admin-roles/admin-roles.ts"],"sourcesContent":["/**\n * Generated by orval 🍺\n * Do not edit manually.\n * Mozaik backend\n * Four products behind one API — Biblio, Médiathèques, the partner catalogues (Nextory and YouScribe) and Prof Express. Authentication is Keycloak SSO only, once, for all of them: see the **auth** section below for the browser flow and the three failure modes.\n * OpenAPI spec version: 0.1.0\n */\nimport {\n  useMutation,\n  useQuery\n} from '@tanstack/react-query';\nimport type {\n  DataTag,\n  DefinedInitialDataOptions,\n  DefinedUseQueryResult,\n  MutationFunction,\n  QueryClient,\n  QueryFunction,\n  QueryKey,\n  UndefinedInitialDataOptions,\n  UseMutationOptions,\n  UseMutationResult,\n  UseQueryOptions,\n  UseQueryResult\n} from '@tanstack/react-query';\n\nimport type {\n  HTTPExceptionResponse,\n  ProductGrantListRead,\n  ProductGrantWrite,\n  ValidationErrorResponse\n} from '../../models';\n\nimport { request } from '../../client';\nimport type { ErrorType , BodyType } from '../../client';\n\n\ntype SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];\n\n\n\nconst withQueryKey = <T extends object, K>(query: T, queryKey: K): T & { queryKey: K } => {\n  const result = { queryKey } as T & { queryKey: K };\n  for (const key of Object.keys(query)) {\n    // The explicit queryKey always wins, matching the previous\n    // `{ ...query, queryKey }` spread where it was set last.\n    if (key === 'queryKey') continue;\n    Object.defineProperty(result, key, {\n      enumerable: true,\n      configurable: true,\n      get: () => (query as Record<string, unknown>)[key],\n    });\n  }\n  return result;\n};\n\nexport const getListGrantsUrl = (userId: number,) => {\n\n\n\n\n  return `/admin/users/${userId}/product-roles`\n}\n\n/**\n * Everything this account is, across products and organisations.\n *\n * Readable by SUPPORT as well as ADMIN: knowing what somebody is, is part of\n * helping them. Changing it is not.\n * @summary List Grants\n */\nexport const listGrants = async (userId: number, options?: Parameters<typeof request>[1]): Promise<ProductGrantListRead> => {\n\n  return request<ProductGrantListRead>(getListGrantsUrl(userId),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\n\n\n\nexport const getListGrantsQueryKey = (userId: number,) => {\n    return [\n    `/admin/users/${userId}/product-roles`\n    ] as const;\n    }\n\n\nexport const getListGrantsQueryOptions = <TData = Awaited<ReturnType<typeof listGrants>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(userId: number, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData>>, request?: SecondParameter<typeof request>}\n) => {\n\nconst {query: queryOptions, request: requestOptions} = options ?? {};\n\n  const queryKey =  queryOptions?.queryKey ?? getListGrantsQueryKey(userId);\n\n\n\n    const queryFn: QueryFunction<Awaited<ReturnType<typeof listGrants>>> = ({ signal }) => listGrants(userId, { signal, ...requestOptions });\n\n\n\n\n\n   return  { queryKey, queryFn, enabled: userId !== null && userId !== undefined, ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }\n}\n\nexport type ListGrantsQueryResult = NonNullable<Awaited<ReturnType<typeof listGrants>>>\nexport type ListGrantsQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>\n\n\nexport function useListGrants<TData = Awaited<ReturnType<typeof listGrants>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n userId: number, options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData>> & Pick<\n        DefinedInitialDataOptions<\n          Awaited<ReturnType<typeof listGrants>>,\n          TError,\n          Awaited<ReturnType<typeof listGrants>>\n        > , 'initialData'\n      >, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }\nexport function useListGrants<TData = Awaited<ReturnType<typeof listGrants>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n userId: number, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData>> & Pick<\n        UndefinedInitialDataOptions<\n          Awaited<ReturnType<typeof listGrants>>,\n          TError,\n          Awaited<ReturnType<typeof listGrants>>\n        > , 'initialData'\n      >, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }\nexport function useListGrants<TData = Awaited<ReturnType<typeof listGrants>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n userId: number, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData>>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }\n/**\n * @summary List Grants\n */\n\nexport function useListGrants<TData = Awaited<ReturnType<typeof listGrants>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n userId: number, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listGrants>>, TError, TData>>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {\n\n  const queryOptions = getListGrantsQueryOptions(userId,options)\n\n  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };\n\n  return withQueryKey(query, queryOptions.queryKey);\n}\n\n\n\n\n\n\nexport const getReplaceGrantsUrl = (userId: number,) => {\n\n\n\n\n  return `/admin/users/${userId}/product-roles`\n}\n\n/**\n * Replace this account's roles for one product at one organisation.\n *\n * ``PUT`` because it is idempotent and the body is the whole desired state for\n * that ``(tenant, product)`` slice — sending it twice leaves the same grants.\n *\n * Two scope checks, and both are needed. The *subject* must be an account the\n * operator reaches, and the ``tenantId`` being granted at must be one they\n * reach too: without the second, an operator could grant a remit at an\n * organisation they have no authority over, which is how a scoped\n * administrator becomes an unscoped one.\n *\n * ``422`` for a role the product does not recognise —\n * :data:`~app.models.enums.PRODUCT_ROLES` decides, so ``student`` for biblio is\n * refused rather than stored and puzzled over later.\n * @summary Replace Grants\n */\nexport const replaceGrants = async (userId: number,\n    productGrantWrite: ProductGrantWrite, options?: Parameters<typeof request>[1]): Promise<ProductGrantListRead> => {\n\n    const getHeaders = (h?: NonNullable<RequestInit['headers']>): Record<string, string | readonly string[]> => {\n    if (!h) return {};\n    if (h instanceof Headers) return Object.fromEntries(h.entries());\n    if (Symbol.iterator in h) {\n      return Object.fromEntries(\n        Array.from(h as Iterable<Iterable<string>>, (entry) => Array.from(entry) as [string, string]),\n      );\n    }\n    const headers: Record<string, string | readonly string[]> = {};\n    for (const [name, value] of Object.entries<string | readonly string[] | undefined>(h)) {\n      if (value !== undefined) headers[name] = value;\n    }\n    return headers;\n  };\nreturn request<ProductGrantListRead>(getReplaceGrantsUrl(userId),\n  {\n    ...options,\n    method: 'PUT',\n    headers: { 'Content-Type': 'application/json', ...getHeaders(options?.headers) },\n    body: JSON.stringify(productGrantWrite)\n  }\n);}\n\n\n\n\n\nexport const getReplaceGrantsMutationKey = () => ['replaceGrants'] as const;\n\nexport const getReplaceGrantsMutationOptions = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof replaceGrants>>, TError,ReplaceGrantsMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n): UseMutationOptions<Awaited<ReturnType<typeof replaceGrants>>, TError,ReplaceGrantsMutationVariables, TContext> => {\n\nconst mutationKey = getReplaceGrantsMutationKey();\nconst {mutation: mutationOptions, request: requestOptions} = options ?\n      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?\n      options\n      : {...options, mutation: {...options.mutation, mutationKey}}\n      : {mutation: { mutationKey, }, request: undefined};\n\n\n\n\n      const mutationFn: MutationFunction<Awaited<ReturnType<typeof replaceGrants>>, ReplaceGrantsMutationVariables> = (props) => {\n          const {userId,data} = props ?? {};\n\n          return  replaceGrants(userId,data,requestOptions)\n        }\n\n\n\n\n\n\n  return  { mutationFn, ...mutationOptions }}\n\n    export type ReplaceGrantsMutationResult = NonNullable<Awaited<ReturnType<typeof replaceGrants>>>\n    export type ReplaceGrantsMutationBody = BodyType<ProductGrantWrite>\n    export type ReplaceGrantsMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>\n    export type ReplaceGrantsMutationVariables = {userId: number;data: BodyType<ProductGrantWrite>}\n\n    /**\n * @summary Replace Grants\n */\nexport const useReplaceGrants = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof replaceGrants>>, TError,ReplaceGrantsMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient): UseMutationResult<\n        Awaited<ReturnType<typeof replaceGrants>>,\n        TError,\n        ReplaceGrantsMutationVariables,\n        TContext\n      > => {\n      return useMutation(getReplaceGrantsMutationOptions(options), queryClient);\n    }\n"],"mappings":";;;;;;;;;;;AAyCA,MAAM,gBAAqC,OAAU,aAAqC;CACxF,MAAM,SAAS,EAAE,SAAS;CAC1B,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,GAAG;EAGpC,IAAI,QAAQ,YAAY;EACxB,OAAO,eAAe,QAAQ,KAAK;GACjC,YAAY;GACZ,cAAc;GACd,WAAY,MAAkC;EAChD,CAAC;CACH;CACA,OAAO;AACT;AAEA,MAAa,oBAAoB,WAAoB;CAKnD,OAAO,gBAAgB,OAAO;AAChC;;;;;;;;AASA,MAAa,aAAa,OAAO,QAAgB,YAA2E;CAE1H,OAAO,QAA8B,iBAAiB,MAAM,GAC5D;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAMF,MAAa,yBAAyB,WAAoB;CACtD,OAAO,CACP,gBAAgB,OAAO,eACvB;AACA;AAGJ,MAAa,6BAAkJ,QAAgB,YAC1K;CAEL,MAAM,EAAC,OAAO,cAAc,SAAS,mBAAkB,WAAW,CAAC;CAEjE,MAAM,WAAY,cAAc,YAAY,sBAAsB,MAAM;CAItE,MAAM,WAAkE,EAAE,aAAa,WAAW,QAAQ;EAAE;EAAQ,GAAG;CAAe,CAAC;CAMxI,OAAQ;EAAE;EAAU;EAAS,SAAS,WAAW,QAAQ,WAAW,KAAA;EAAW,GAAG;CAAY;AACjG;;;;AAkCA,SAAgB,cACf,QAAgB,SACd,aACiF;CAElF,MAAM,eAAe,0BAA0B,QAAO,OAAO;CAE7D,MAAM,QAAQ,SAAS,cAAc,WAAW;CAEhD,OAAO,aAAa,OAAO,aAAa,QAAQ;AAClD;AAOA,MAAa,uBAAuB,WAAoB;CAKtD,OAAO,gBAAgB,OAAO;AAChC;;;;;;;;;;;;;;;;;;AAmBA,MAAa,gBAAgB,OAAO,QAChC,mBAAsC,YAA2E;CAEjH,MAAM,cAAc,MAAwF;EAC5G,IAAI,CAAC,GAAG,OAAO,CAAC;EAChB,IAAI,aAAa,SAAS,OAAO,OAAO,YAAY,EAAE,QAAQ,CAAC;EAC/D,IAAI,OAAO,YAAY,GACrB,OAAO,OAAO,YACZ,MAAM,KAAK,IAAkC,UAAU,MAAM,KAAK,KAAK,CAAqB,CAC9F;EAEF,MAAM,UAAsD,CAAC;EAC7D,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAgD,CAAC,GAClF,IAAI,UAAU,KAAA,GAAW,QAAQ,QAAQ;EAE3C,OAAO;CACT;CACF,OAAO,QAA8B,oBAAoB,MAAM,GAC7D;EACE,GAAG;EACH,QAAQ;EACR,SAAS;GAAE,gBAAgB;GAAoB,GAAG,WAAW,SAAS,OAAO;EAAE;EAC/E,MAAM,KAAK,UAAU,iBAAiB;CACxC,CACF;AAAE;AAMF,MAAa,oCAAoC,CAAC,eAAe;AAEjE,MAAa,mCACW,YAC6F;CAErH,MAAM,cAAc,4BAA4B;CAChD,MAAM,EAAC,UAAU,iBAAiB,SAAS,mBAAkB,UACvD,QAAQ,YAAY,iBAAiB,QAAQ,YAAY,QAAQ,SAAS,cAC1E,UACE;EAAC,GAAG;EAAS,UAAU;GAAC,GAAG,QAAQ;GAAU;EAAW;CAAC,IACzD;EAAC,UAAU,EAAE,YAAa;EAAG,SAAS,KAAA;CAAS;CAKjD,MAAM,cAA2G,UAAU;EACvH,MAAM,EAAC,QAAO,SAAQ,SAAS,CAAC;EAEhC,OAAQ,cAAc,QAAO,MAAK,cAAc;CAClD;CAON,OAAQ;EAAE;EAAY,GAAG;CAAgB;AAAC;;;;AAU5C,MAAa,oBACW,SACrB,gBAKQ;CACL,OAAO,YAAY,gCAAgC,OAAO,GAAG,WAAW;AAC1E"}

package/dist/react/admin-support.d.ts

@@ -0,0 +1,123 @@
+
+import { Cr as DemoUserWrite, Gn as HTTPExceptionResponse, Wn as ImpersonationWrite, j as SupportSessionRead, t as ValidationErrorResponse, wr as DemoUserRead } from "../index-wL_20vR8.js";
+import { a as ErrorType, c as request, n as BodyType } from "../client-BDwBZYB0.js";
+import { QueryClient, UseMutationOptions, UseMutationResult } from "@tanstack/react-query";
+//#region src/react/admin-support/admin-support.d.ts
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+export declare const getCreateDemoUserUrl: () => string;
+/**
+ * Create, or return, a demonstration account for an establishment (E57).
+ *
+ * ``RequireAdmin`` rather than ``RequireStaff``: this creates an account inside
+ * a customer's tenant, which is a change to what the customer has, not an
+ * assistance to one of their members.
+ *
+ * **The account has no password and cannot be signed into directly.** The
+ * legacy derived one from the establishment id alone — ``Etab{id padded}$``,
+ * at ``etab_{id}@ta.com`` — and then redirected into the impersonation route
+ * (defect D15). Anyone who noticed the pattern held a working credential for
+ * every establishment. Here the row is created without a credential and is
+ * reached through E56, which is audited.
+ *
+ * ``201`` when created, ``200`` when it already existed. Idempotent, because a
+ * salesperson clicking twice should not end up with two demo accounts.
+ * @summary Create Demo User
+ */
+export declare const createDemoUser: (demoUserWrite: DemoUserWrite, options?: Parameters<typeof request>[1]) => Promise<DemoUserRead>;
+export declare const getCreateDemoUserMutationKey: () => readonly ['createDemoUser'];
+export declare const getCreateDemoUserMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof createDemoUser>>, TError, CreateDemoUserMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof createDemoUser>>, TError, CreateDemoUserMutationVariables, TContext>;
+export type CreateDemoUserMutationResult = NonNullable<Awaited<ReturnType<typeof createDemoUser>>>;
+export type CreateDemoUserMutationBody = BodyType<DemoUserWrite>;
+export type CreateDemoUserMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type CreateDemoUserMutationVariables = {
+  data: BodyType<DemoUserWrite>;
+};
+/**
+ * @summary Create Demo User
+ */
+export declare const useCreateDemoUser: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof createDemoUser>>, TError, CreateDemoUserMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof createDemoUser>>, TError, CreateDemoUserMutationVariables, TContext>;
+export declare const getOpenSupportSessionUrl: () => string;
+/**
+ * Open a support session acting as another account (E56).
+ *
+ * ``reason`` is mandatory and exists to be logged. A support action with no
+ * stated reason cannot be told apart from an abuse of the same endpoint.
+ *
+ * **This returns no tokens.** It used to: a Keycloak token-exchange session for
+ * the subject, on the reasoning that the platform should mint no credentials and
+ * that the subject's own assurance level would keep privileged operations out of
+ * reach. Both halves turned out to be wrong. The exchanged token carried no
+ * actor claim, so it was indistinguishable from the patron's own and the trail
+ * stopped at this row; and it carried no ``assurance`` claim either, which
+ * ``clamp_assurance`` reads as *unconstrained* — so the operator resolved to
+ * ``HIGH`` and could close the account, the single thing the design promised to
+ * prevent. Keycloak 26 also rejects the grant outright.
+ *
+ * So the operator keeps their own token and sends ``X-Acting-As`` with the id
+ * returned here. Nothing is minted, the authenticated identity stays the
+ * operator, and the session is clamped to the lowest assurance by
+ * :func:`app.core.security.acting_as` — which makes E14 and E17 unreachable
+ * through the guard that already exists rather than through a special case.
+ *
+ * Ending it early is ``DELETE /admin/impersonations/{id}``, which must be sent
+ * *without* the header: a support session holds no staff roles.
+ * @summary Open Support Session
+ */
+export declare const openSupportSession: (impersonationWrite: ImpersonationWrite, options?: Parameters<typeof request>[1]) => Promise<SupportSessionRead>;
+export declare const getOpenSupportSessionMutationKey: () => readonly ['openSupportSession'];
+export declare const getOpenSupportSessionMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof openSupportSession>>, TError, OpenSupportSessionMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof openSupportSession>>, TError, OpenSupportSessionMutationVariables, TContext>;
+export type OpenSupportSessionMutationResult = NonNullable<Awaited<ReturnType<typeof openSupportSession>>>;
+export type OpenSupportSessionMutationBody = BodyType<ImpersonationWrite>;
+export type OpenSupportSessionMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type OpenSupportSessionMutationVariables = {
+  data: BodyType<ImpersonationWrite>;
+};
+/**
+ * @summary Open Support Session
+ */
+export declare const useOpenSupportSession: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof openSupportSession>>, TError, OpenSupportSessionMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof openSupportSession>>, TError, OpenSupportSessionMutationVariables, TContext>;
+export declare const getCloseSupportSessionUrl: (supportSessionId: number) => string;
+/**
+ * End a support session early. Idempotent.
+ *
+ * Must be called *without* ``X-Acting-As``: a session in progress carries no
+ * staff roles, so a request made through one cannot reach this endpoint. That
+ * is deliberate — the operator steps out before they can close it, and simply
+ * dropping the header ends the session's effect immediately either way.
+ *
+ * ``204`` whether or not the row was still open, and whether or not it was
+ * theirs. A support session id is a bare integer and must not be an oracle.
+ * @summary Close Support Session
+ */
+export declare const closeSupportSession: (supportSessionId: number, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getCloseSupportSessionMutationKey: () => readonly ['closeSupportSession'];
+export declare const getCloseSupportSessionMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof closeSupportSession>>, TError, CloseSupportSessionMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof closeSupportSession>>, TError, CloseSupportSessionMutationVariables, TContext>;
+export type CloseSupportSessionMutationResult = NonNullable<Awaited<ReturnType<typeof closeSupportSession>>>;
+export type CloseSupportSessionMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type CloseSupportSessionMutationVariables = {
+  supportSessionId: number;
+};
+/**
+ * @summary Close Support Session
+ */
+export declare const useCloseSupportSession: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof closeSupportSession>>, TError, CloseSupportSessionMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof closeSupportSession>>, TError, CloseSupportSessionMutationVariables, TContext>;
+//#endregion
+//# sourceMappingURL=admin-support.d.ts.map