@learnorama/mozaik-sdk 0.1.0

package/dist/react/tutoring-practitioner.d.ts

@@ -0,0 +1,129 @@
+
+import { Gn as HTTPExceptionResponse, S as TutoringAnswerWrite, i as TutoringRoomRead, t as ValidationErrorResponse, y as TutoringCloseWrite } 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/tutoring-practitioner/tutoring-practitioner.d.ts
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+export declare const getAnswerRequestUrl: (requestId: number) => string;
+/**
+ * Deliver the answer.
+ *
+ * The body is stored as the answer and any named attachments are re-roled to
+ * ``answer`` — they were uploaded against this request, so no id from another
+ * request can be attached here.
+ * @summary Answer Request
+ */
+export declare const answerRequest: (requestId: number, tutoringAnswerWrite: TutoringAnswerWrite, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getAnswerRequestMutationKey: () => readonly ['answerRequest'];
+export declare const getAnswerRequestMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof answerRequest>>, TError, AnswerRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof answerRequest>>, TError, AnswerRequestMutationVariables, TContext>;
+export type AnswerRequestMutationResult = NonNullable<Awaited<ReturnType<typeof answerRequest>>>;
+export type AnswerRequestMutationBody = BodyType<TutoringAnswerWrite>;
+export type AnswerRequestMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type AnswerRequestMutationVariables = {
+  requestId: number;
+  data: BodyType<TutoringAnswerWrite>;
+};
+/**
+ * @summary Answer Request
+ */
+export declare const useAnswerRequest: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof answerRequest>>, TError, AnswerRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof answerRequest>>, TError, AnswerRequestMutationVariables, TContext>;
+export declare const getClaimRequestUrl: (requestId: number) => string;
+/**
+ * Take a dispatched request.
+ *
+ * ``409`` if somebody else already holds it. The check and the write are one
+ * statement so that two practitioners hitting claim in the same instant cannot
+ * both win — the legacy reads then writes, so both do.
+ * @summary Claim Request
+ */
+export declare const claimRequest: (requestId: number, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getClaimRequestMutationKey: () => readonly ['claimRequest'];
+export declare const getClaimRequestMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof claimRequest>>, TError, ClaimRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof claimRequest>>, TError, ClaimRequestMutationVariables, TContext>;
+export type ClaimRequestMutationResult = NonNullable<Awaited<ReturnType<typeof claimRequest>>>;
+export type ClaimRequestMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type ClaimRequestMutationVariables = {
+  requestId: number;
+};
+/**
+ * @summary Claim Request
+ */
+export declare const useClaimRequest: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof claimRequest>>, TError, ClaimRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof claimRequest>>, TError, ClaimRequestMutationVariables, TContext>;
+export declare const getCloseRequestUrl: (requestId: number) => string;
+/**
+ * Close a request that will not be answered, with a reason.
+ *
+ * A dispatcher's job rather than a practitioner's: giving up on a request is a
+ * decision about the queue, and the person who could not answer it is not the
+ * person who should decide nobody will.
+ * @summary Close Request
+ */
+export declare const closeRequest: (requestId: number, tutoringCloseWrite: TutoringCloseWrite, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getCloseRequestMutationKey: () => readonly ['closeRequest'];
+export declare const getCloseRequestMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof closeRequest>>, TError, CloseRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof closeRequest>>, TError, CloseRequestMutationVariables, TContext>;
+export type CloseRequestMutationResult = NonNullable<Awaited<ReturnType<typeof closeRequest>>>;
+export type CloseRequestMutationBody = BodyType<TutoringCloseWrite>;
+export type CloseRequestMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type CloseRequestMutationVariables = {
+  requestId: number;
+  data: BodyType<TutoringCloseWrite>;
+};
+/**
+ * @summary Close Request
+ */
+export declare const useCloseRequest: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof closeRequest>>, TError, CloseRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof closeRequest>>, TError, CloseRequestMutationVariables, TContext>;
+export declare const getOpenRoomUrl: (requestId: number) => string;
+/**
+ * Open the room for a live request. The practitioner decides when.
+ *
+ * Deliberately an explicit action rather than a side effect of claiming, which
+ * is what Prof Express does: the teacher presses a button in their own queue,
+ * and ``createTeacherVedamoClasssroom`` refuses unless a teacher is assigned.
+ * A room provisioned at dispatch is a room the pupil joins alone.
+ *
+ * Only the assigned practitioner may open it, and only once — a second call
+ * returns the room that is already open rather than provisioning another. The
+ * legacy has no such check, so pressing its button twice orphans a room the
+ * pupil may already hold a link to.
+ *
+ * ``409`` for a channel with nothing to join, and for a request nobody has
+ * claimed.
+ * @summary Open Room
+ */
+export declare const openRoom: (requestId: number, options?: Parameters<typeof request>[1]) => Promise<TutoringRoomRead>;
+export declare const getOpenRoomMutationKey: () => readonly ['openRoom'];
+export declare const getOpenRoomMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof openRoom>>, TError, OpenRoomMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof openRoom>>, TError, OpenRoomMutationVariables, TContext>;
+export type OpenRoomMutationResult = NonNullable<Awaited<ReturnType<typeof openRoom>>>;
+export type OpenRoomMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type OpenRoomMutationVariables = {
+  requestId: number;
+};
+/**
+ * @summary Open Room
+ */
+export declare const useOpenRoom: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof openRoom>>, TError, OpenRoomMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof openRoom>>, TError, OpenRoomMutationVariables, TContext>;
+//#endregion
+//# sourceMappingURL=tutoring-practitioner.d.ts.map

package/dist/react/tutoring-practitioner.js

@@ -0,0 +1,230 @@
+"use client";
+import { r as request } from "../client-D3kMOcIr.js";
+import { useMutation } from "@tanstack/react-query";
+//#region src/react/tutoring-practitioner/tutoring-practitioner.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 getAnswerRequestUrl = (requestId) => {
+	return `/tutoring/requests/${requestId}/answer`;
+};
+/**
+* Deliver the answer.
+*
+* The body is stored as the answer and any named attachments are re-roled to
+* ``answer`` — they were uploaded against this request, so no id from another
+* request can be attached here.
+* @summary Answer Request
+*/
+const answerRequest = async (requestId, tutoringAnswerWrite, 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(getAnswerRequestUrl(requestId), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(tutoringAnswerWrite)
+	});
+};
+const getAnswerRequestMutationKey = () => ["answerRequest"];
+const getAnswerRequestMutationOptions = (options) => {
+	const mutationKey = getAnswerRequestMutationKey();
+	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 { requestId, data } = props ?? {};
+		return answerRequest(requestId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Answer Request
+*/
+const useAnswerRequest = (options, queryClient) => {
+	return useMutation(getAnswerRequestMutationOptions(options), queryClient);
+};
+const getClaimRequestUrl = (requestId) => {
+	return `/tutoring/requests/${requestId}/claim`;
+};
+/**
+* Take a dispatched request.
+*
+* ``409`` if somebody else already holds it. The check and the write are one
+* statement so that two practitioners hitting claim in the same instant cannot
+* both win — the legacy reads then writes, so both do.
+* @summary Claim Request
+*/
+const claimRequest = async (requestId, options) => {
+	return request(getClaimRequestUrl(requestId), {
+		...options,
+		method: "POST"
+	});
+};
+const getClaimRequestMutationKey = () => ["claimRequest"];
+const getClaimRequestMutationOptions = (options) => {
+	const mutationKey = getClaimRequestMutationKey();
+	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 { requestId } = props ?? {};
+		return claimRequest(requestId, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Claim Request
+*/
+const useClaimRequest = (options, queryClient) => {
+	return useMutation(getClaimRequestMutationOptions(options), queryClient);
+};
+const getCloseRequestUrl = (requestId) => {
+	return `/tutoring/requests/${requestId}/close`;
+};
+/**
+* Close a request that will not be answered, with a reason.
+*
+* A dispatcher's job rather than a practitioner's: giving up on a request is a
+* decision about the queue, and the person who could not answer it is not the
+* person who should decide nobody will.
+* @summary Close Request
+*/
+const closeRequest = async (requestId, tutoringCloseWrite, 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(getCloseRequestUrl(requestId), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(tutoringCloseWrite)
+	});
+};
+const getCloseRequestMutationKey = () => ["closeRequest"];
+const getCloseRequestMutationOptions = (options) => {
+	const mutationKey = getCloseRequestMutationKey();
+	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 { requestId, data } = props ?? {};
+		return closeRequest(requestId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Close Request
+*/
+const useCloseRequest = (options, queryClient) => {
+	return useMutation(getCloseRequestMutationOptions(options), queryClient);
+};
+const getOpenRoomUrl = (requestId) => {
+	return `/tutoring/requests/${requestId}/room`;
+};
+/**
+* Open the room for a live request. The practitioner decides when.
+*
+* Deliberately an explicit action rather than a side effect of claiming, which
+* is what Prof Express does: the teacher presses a button in their own queue,
+* and ``createTeacherVedamoClasssroom`` refuses unless a teacher is assigned.
+* A room provisioned at dispatch is a room the pupil joins alone.
+*
+* Only the assigned practitioner may open it, and only once — a second call
+* returns the room that is already open rather than provisioning another. The
+* legacy has no such check, so pressing its button twice orphans a room the
+* pupil may already hold a link to.
+*
+* ``409`` for a channel with nothing to join, and for a request nobody has
+* claimed.
+* @summary Open Room
+*/
+const openRoom = async (requestId, options) => {
+	return request(getOpenRoomUrl(requestId), {
+		...options,
+		method: "POST"
+	});
+};
+const getOpenRoomMutationKey = () => ["openRoom"];
+const getOpenRoomMutationOptions = (options) => {
+	const mutationKey = getOpenRoomMutationKey();
+	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 { requestId } = props ?? {};
+		return openRoom(requestId, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Open Room
+*/
+const useOpenRoom = (options, queryClient) => {
+	return useMutation(getOpenRoomMutationOptions(options), queryClient);
+};
+//#endregion
+export { answerRequest, claimRequest, closeRequest, getAnswerRequestMutationKey, getAnswerRequestMutationOptions, getAnswerRequestUrl, getClaimRequestMutationKey, getClaimRequestMutationOptions, getClaimRequestUrl, getCloseRequestMutationKey, getCloseRequestMutationOptions, getCloseRequestUrl, getOpenRoomMutationKey, getOpenRoomMutationOptions, getOpenRoomUrl, openRoom, useAnswerRequest, useClaimRequest, useCloseRequest, useOpenRoom };
+
+//# sourceMappingURL=tutoring-practitioner.js.map

package/dist/react/tutoring-practitioner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tutoring-practitioner.js","names":[],"sources":["../../src/react/tutoring-practitioner/tutoring-practitioner.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} from '@tanstack/react-query';\nimport type {\n  MutationFunction,\n  QueryClient,\n  UseMutationOptions,\n  UseMutationResult\n} from '@tanstack/react-query';\n\nimport type {\n  HTTPExceptionResponse,\n  TutoringAnswerWrite,\n  TutoringCloseWrite,\n  TutoringRoomRead,\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\nexport const getAnswerRequestUrl = (requestId: number,) => {\n\n\n\n\n  return `/tutoring/requests/${requestId}/answer`\n}\n\n/**\n * Deliver the answer.\n *\n * The body is stored as the answer and any named attachments are re-roled to\n * ``answer`` — they were uploaded against this request, so no id from another\n * request can be attached here.\n * @summary Answer Request\n */\nexport const answerRequest = async (requestId: number,\n    tutoringAnswerWrite: TutoringAnswerWrite, options?: Parameters<typeof request>[1]): Promise<void> => {\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<void>(getAnswerRequestUrl(requestId),\n  {\n    ...options,\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getHeaders(options?.headers) },\n    body: JSON.stringify(tutoringAnswerWrite)\n  }\n);}\n\n\n\n\n\nexport const getAnswerRequestMutationKey = () => ['answerRequest'] as const;\n\nexport const getAnswerRequestMutationOptions = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof answerRequest>>, TError,AnswerRequestMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n): UseMutationOptions<Awaited<ReturnType<typeof answerRequest>>, TError,AnswerRequestMutationVariables, TContext> => {\n\nconst mutationKey = getAnswerRequestMutationKey();\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 answerRequest>>, AnswerRequestMutationVariables> = (props) => {\n          const {requestId,data} = props ?? {};\n\n          return  answerRequest(requestId,data,requestOptions)\n        }\n\n\n\n\n\n\n  return  { mutationFn, ...mutationOptions }}\n\n    export type AnswerRequestMutationResult = NonNullable<Awaited<ReturnType<typeof answerRequest>>>\n    export type AnswerRequestMutationBody = BodyType<TutoringAnswerWrite>\n    export type AnswerRequestMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>\n    export type AnswerRequestMutationVariables = {requestId: number;data: BodyType<TutoringAnswerWrite>}\n\n    /**\n * @summary Answer Request\n */\nexport const useAnswerRequest = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof answerRequest>>, TError,AnswerRequestMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient): UseMutationResult<\n        Awaited<ReturnType<typeof answerRequest>>,\n        TError,\n        AnswerRequestMutationVariables,\n        TContext\n      > => {\n      return useMutation(getAnswerRequestMutationOptions(options), queryClient);\n    }\n    export const getClaimRequestUrl = (requestId: number,) => {\n\n\n\n\n  return `/tutoring/requests/${requestId}/claim`\n}\n\n/**\n * Take a dispatched request.\n *\n * ``409`` if somebody else already holds it. The check and the write are one\n * statement so that two practitioners hitting claim in the same instant cannot\n * both win — the legacy reads then writes, so both do.\n * @summary Claim Request\n */\nexport const claimRequest = async (requestId: number, options?: Parameters<typeof request>[1]): Promise<void> => {\n\n  return request<void>(getClaimRequestUrl(requestId),\n  {\n    ...options,\n    method: 'POST'\n\n\n  }\n);}\n\n\n\n\n\nexport const getClaimRequestMutationKey = () => ['claimRequest'] as const;\n\nexport const getClaimRequestMutationOptions = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof claimRequest>>, TError,ClaimRequestMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n): UseMutationOptions<Awaited<ReturnType<typeof claimRequest>>, TError,ClaimRequestMutationVariables, TContext> => {\n\nconst mutationKey = getClaimRequestMutationKey();\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 claimRequest>>, ClaimRequestMutationVariables> = (props) => {\n          const {requestId} = props ?? {};\n\n          return  claimRequest(requestId,requestOptions)\n        }\n\n\n\n\n\n\n  return  { mutationFn, ...mutationOptions }}\n\n    export type ClaimRequestMutationResult = NonNullable<Awaited<ReturnType<typeof claimRequest>>>\n\n    export type ClaimRequestMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>\n    export type ClaimRequestMutationVariables = {requestId: number}\n\n    /**\n * @summary Claim Request\n */\nexport const useClaimRequest = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof claimRequest>>, TError,ClaimRequestMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient): UseMutationResult<\n        Awaited<ReturnType<typeof claimRequest>>,\n        TError,\n        ClaimRequestMutationVariables,\n        TContext\n      > => {\n      return useMutation(getClaimRequestMutationOptions(options), queryClient);\n    }\n    export const getCloseRequestUrl = (requestId: number,) => {\n\n\n\n\n  return `/tutoring/requests/${requestId}/close`\n}\n\n/**\n * Close a request that will not be answered, with a reason.\n *\n * A dispatcher's job rather than a practitioner's: giving up on a request is a\n * decision about the queue, and the person who could not answer it is not the\n * person who should decide nobody will.\n * @summary Close Request\n */\nexport const closeRequest = async (requestId: number,\n    tutoringCloseWrite: TutoringCloseWrite, options?: Parameters<typeof request>[1]): Promise<void> => {\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<void>(getCloseRequestUrl(requestId),\n  {\n    ...options,\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getHeaders(options?.headers) },\n    body: JSON.stringify(tutoringCloseWrite)\n  }\n);}\n\n\n\n\n\nexport const getCloseRequestMutationKey = () => ['closeRequest'] as const;\n\nexport const getCloseRequestMutationOptions = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof closeRequest>>, TError,CloseRequestMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n): UseMutationOptions<Awaited<ReturnType<typeof closeRequest>>, TError,CloseRequestMutationVariables, TContext> => {\n\nconst mutationKey = getCloseRequestMutationKey();\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 closeRequest>>, CloseRequestMutationVariables> = (props) => {\n          const {requestId,data} = props ?? {};\n\n          return  closeRequest(requestId,data,requestOptions)\n        }\n\n\n\n\n\n\n  return  { mutationFn, ...mutationOptions }}\n\n    export type CloseRequestMutationResult = NonNullable<Awaited<ReturnType<typeof closeRequest>>>\n    export type CloseRequestMutationBody = BodyType<TutoringCloseWrite>\n    export type CloseRequestMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>\n    export type CloseRequestMutationVariables = {requestId: number;data: BodyType<TutoringCloseWrite>}\n\n    /**\n * @summary Close Request\n */\nexport const useCloseRequest = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof closeRequest>>, TError,CloseRequestMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient): UseMutationResult<\n        Awaited<ReturnType<typeof closeRequest>>,\n        TError,\n        CloseRequestMutationVariables,\n        TContext\n      > => {\n      return useMutation(getCloseRequestMutationOptions(options), queryClient);\n    }\n    export const getOpenRoomUrl = (requestId: number,) => {\n\n\n\n\n  return `/tutoring/requests/${requestId}/room`\n}\n\n/**\n * Open the room for a live request. The practitioner decides when.\n *\n * Deliberately an explicit action rather than a side effect of claiming, which\n * is what Prof Express does: the teacher presses a button in their own queue,\n * and ``createTeacherVedamoClasssroom`` refuses unless a teacher is assigned.\n * A room provisioned at dispatch is a room the pupil joins alone.\n *\n * Only the assigned practitioner may open it, and only once — a second call\n * returns the room that is already open rather than provisioning another. The\n * legacy has no such check, so pressing its button twice orphans a room the\n * pupil may already hold a link to.\n *\n * ``409`` for a channel with nothing to join, and for a request nobody has\n * claimed.\n * @summary Open Room\n */\nexport const openRoom = async (requestId: number, options?: Parameters<typeof request>[1]): Promise<TutoringRoomRead> => {\n\n  return request<TutoringRoomRead>(getOpenRoomUrl(requestId),\n  {\n    ...options,\n    method: 'POST'\n\n\n  }\n);}\n\n\n\n\n\nexport const getOpenRoomMutationKey = () => ['openRoom'] as const;\n\nexport const getOpenRoomMutationOptions = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof openRoom>>, TError,OpenRoomMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n): UseMutationOptions<Awaited<ReturnType<typeof openRoom>>, TError,OpenRoomMutationVariables, TContext> => {\n\nconst mutationKey = getOpenRoomMutationKey();\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 openRoom>>, OpenRoomMutationVariables> = (props) => {\n          const {requestId} = props ?? {};\n\n          return  openRoom(requestId,requestOptions)\n        }\n\n\n\n\n\n\n  return  { mutationFn, ...mutationOptions }}\n\n    export type OpenRoomMutationResult = NonNullable<Awaited<ReturnType<typeof openRoom>>>\n\n    export type OpenRoomMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>\n    export type OpenRoomMutationVariables = {requestId: number}\n\n    /**\n * @summary Open Room\n */\nexport const useOpenRoom = <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>,\n    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof openRoom>>, TError,OpenRoomMutationVariables, TContext>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient): UseMutationResult<\n        Awaited<ReturnType<typeof openRoom>>,\n        TError,\n        OpenRoomMutationVariables,\n        TContext\n      > => {\n      return useMutation(getOpenRoomMutationOptions(options), queryClient);\n    }\n"],"mappings":"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"}

package/dist/react/tutoring-requests.d.ts

@@ -0,0 +1,233 @@
+
+import { Gn as HTTPExceptionResponse, Gr as BodyUploadAttachment, a as TutoringRequestWrite, c as TutoringRequestRead, hn as ListMyRequestsParams, p as TutoringFeedbackWrite, s as TutoringRequestPage, t as ValidationErrorResponse, x as TutoringAttachmentRead } 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/tutoring-requests/tutoring-requests.d.ts
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+export declare const getListMyRequestsUrl: (params?: ListMyRequestsParams) => string;
+/**
+ * The caller's own requests, newest first.
+ *
+ * Includes requests they submitted for a child profile, which is what the
+ * ``requested_by_id`` half of the predicate is for — a parent's list should not
+ * go empty the moment they ask on somebody else's behalf.
+ * @summary List My Requests
+ */
+export declare const listMyRequests: (params?: ListMyRequestsParams, options?: Parameters<typeof request>[1]) => Promise<TutoringRequestPage>;
+export declare const getListMyRequestsQueryKey: (params?: ListMyRequestsParams) => readonly ["/tutoring/requests", ...ListMyRequestsParams[]];
+export declare const getListMyRequestsQueryOptions: <TData = Awaited<ReturnType<typeof listMyRequests>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ListMyRequestsParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listMyRequests>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listMyRequests>>, TError, TData> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export type ListMyRequestsQueryResult = NonNullable<Awaited<ReturnType<typeof listMyRequests>>>;
+export type ListMyRequestsQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export declare function useListMyRequests<TData = Awaited<ReturnType<typeof listMyRequests>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params: undefined | ListMyRequestsParams, options: {
+  query: Partial<UseQueryOptions<Awaited<ReturnType<typeof listMyRequests>>, TError, TData>> & Pick<DefinedInitialDataOptions<Awaited<ReturnType<typeof listMyRequests>>, TError, Awaited<ReturnType<typeof listMyRequests>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): DefinedUseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListMyRequests<TData = Awaited<ReturnType<typeof listMyRequests>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ListMyRequestsParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listMyRequests>>, TError, TData>> & Pick<UndefinedInitialDataOptions<Awaited<ReturnType<typeof listMyRequests>>, TError, Awaited<ReturnType<typeof listMyRequests>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListMyRequests<TData = Awaited<ReturnType<typeof listMyRequests>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ListMyRequestsParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listMyRequests>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare const getSubmitRequestUrl: () => string;
+/**
+ * Ask for help.
+ *
+ * Debits the tenant's tutoring entitlement, which is what makes this a ``409``
+ * when the allowance is spent rather than a queued request nobody may answer.
+ * ``403`` from the entitlement layer is reported as ``404`` for the subject, per
+ * the convention the loan routes already follow.
+ *
+ * ``onBehalfOfId`` must name a profile of the caller. Anything else is ``403``:
+ * the legacy accepts a ``user_id`` in the body and trusts it, which is an
+ * authorization decision made by whoever wrote the client.
+ * @summary Submit Request
+ */
+export declare const submitRequest: (tutoringRequestWrite: TutoringRequestWrite, options?: Parameters<typeof request>[1]) => Promise<TutoringRequestRead>;
+export declare const getSubmitRequestMutationKey: () => readonly ['submitRequest'];
+export declare const getSubmitRequestMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof submitRequest>>, TError, SubmitRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof submitRequest>>, TError, SubmitRequestMutationVariables, TContext>;
+export type SubmitRequestMutationResult = NonNullable<Awaited<ReturnType<typeof submitRequest>>>;
+export type SubmitRequestMutationBody = BodyType<TutoringRequestWrite>;
+export type SubmitRequestMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type SubmitRequestMutationVariables = {
+  data: BodyType<TutoringRequestWrite>;
+};
+/**
+ * @summary Submit Request
+ */
+export declare const useSubmitRequest: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof submitRequest>>, TError, SubmitRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof submitRequest>>, TError, SubmitRequestMutationVariables, TContext>;
+export declare const getGetRequestUrl: (requestId: number) => string;
+/**
+ * One of the caller's own requests, with signed links to its files.
+ * @summary Get Request
+ */
+export declare const getRequest: (requestId: number, options?: Parameters<typeof request>[1]) => Promise<TutoringRequestRead>;
+export declare const getGetRequestQueryKey: (requestId: number) => readonly [`/tutoring/requests/${number}`];
+export declare const getGetRequestQueryOptions: <TData = Awaited<ReturnType<typeof getRequest>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(requestId: number, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getRequest>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}) => UseQueryOptions<Awaited<ReturnType<typeof getRequest>>, TError, TData> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export type GetRequestQueryResult = NonNullable<Awaited<ReturnType<typeof getRequest>>>;
+export type GetRequestQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export declare function useGetRequest<TData = Awaited<ReturnType<typeof getRequest>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(requestId: number, options: {
+  query: Partial<UseQueryOptions<Awaited<ReturnType<typeof getRequest>>, TError, TData>> & Pick<DefinedInitialDataOptions<Awaited<ReturnType<typeof getRequest>>, TError, Awaited<ReturnType<typeof getRequest>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): DefinedUseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useGetRequest<TData = Awaited<ReturnType<typeof getRequest>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(requestId: number, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getRequest>>, TError, TData>> & Pick<UndefinedInitialDataOptions<Awaited<ReturnType<typeof getRequest>>, TError, Awaited<ReturnType<typeof getRequest>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useGetRequest<TData = Awaited<ReturnType<typeof getRequest>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(requestId: number, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getRequest>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare const getUploadAttachmentUrl: (requestId: number) => string;
+/**
+ * Attach a file to a request. One per call.
+ *
+ * One per call rather than an array, deliberately. A pupil photographing four
+ * pages on a phone connection wants three of them to survive the fourth
+ * timing out, and the legacy's ``documents[]`` array is all-or-nothing — with
+ * no cap on how many, so a single request can be arbitrarily large.
+ *
+ * The role follows from who is asking: the pupil is attaching to a question,
+ * the assigned practitioner to an answer. Nobody declares it, so nobody can
+ * claim the wrong one.
+ *
+ * ``415`` for a format we do not accept, ``413`` for a file over the ceiling,
+ * ``409`` once the per-request cap is reached, and ``404`` for a request that
+ * is not the caller's.
+ * @summary Upload Attachment
+ */
+export declare const uploadAttachment: (requestId: number, bodyUploadAttachment: BodyUploadAttachment, options?: Parameters<typeof request>[1]) => Promise<TutoringAttachmentRead>;
+export declare const getUploadAttachmentMutationKey: () => readonly ['uploadAttachment'];
+export declare const getUploadAttachmentMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof uploadAttachment>>, TError, UploadAttachmentMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof uploadAttachment>>, TError, UploadAttachmentMutationVariables, TContext>;
+export type UploadAttachmentMutationResult = NonNullable<Awaited<ReturnType<typeof uploadAttachment>>>;
+export type UploadAttachmentMutationBody = BodyType<BodyUploadAttachment>;
+export type UploadAttachmentMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type UploadAttachmentMutationVariables = {
+  requestId: number;
+  data: BodyType<BodyUploadAttachment>;
+};
+/**
+ * @summary Upload Attachment
+ */
+export declare const useUploadAttachment: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof uploadAttachment>>, TError, UploadAttachmentMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof uploadAttachment>>, TError, UploadAttachmentMutationVariables, TContext>;
+export declare const getDeleteAttachmentUrl: (requestId: number, attachmentId: number) => string;
+/**
+ * Remove a file the caller uploaded.
+ *
+ * Only the uploader, and only while the request is still open — a file that
+ * formed part of a delivered answer is part of the record.
+ *
+ * The object goes and the row goes with it: this is a mistaken upload being
+ * withdrawn, not a retention event. Retention is the bucket's lifecycle rule,
+ * which removes objects and leaves rows behind.
+ * @summary Delete Attachment
+ */
+export declare const deleteAttachment: (requestId: number, attachmentId: number, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getDeleteAttachmentMutationKey: () => readonly ['deleteAttachment'];
+export declare const getDeleteAttachmentMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteAttachment>>, TError, DeleteAttachmentMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof deleteAttachment>>, TError, DeleteAttachmentMutationVariables, TContext>;
+export type DeleteAttachmentMutationResult = NonNullable<Awaited<ReturnType<typeof deleteAttachment>>>;
+export type DeleteAttachmentMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type DeleteAttachmentMutationVariables = {
+  requestId: number;
+  attachmentId: number;
+};
+/**
+ * @summary Delete Attachment
+ */
+export declare const useDeleteAttachment: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof deleteAttachment>>, TError, DeleteAttachmentMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof deleteAttachment>>, TError, DeleteAttachmentMutationVariables, TContext>;
+export declare const getCancelRequestUrl: (requestId: number) => string;
+/**
+ * Withdraw a request the caller asked.
+ *
+ * The debit is **not** reversed. A pupil who asks and withdraws has occupied a
+ * dispatcher's attention, and refunding it would make cancel-and-resubmit a way
+ * around the allowance. If a tenant should get the unit back, that is a credit
+ * somebody grants, which is a different act with a different audit trail.
+ * @summary Cancel Request
+ */
+export declare const cancelRequest: (requestId: number, options?: Parameters<typeof request>[1]) => Promise<TutoringRequestRead>;
+export declare const getCancelRequestMutationKey: () => readonly ['cancelRequest'];
+export declare const getCancelRequestMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof cancelRequest>>, TError, CancelRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof cancelRequest>>, TError, CancelRequestMutationVariables, TContext>;
+export type CancelRequestMutationResult = NonNullable<Awaited<ReturnType<typeof cancelRequest>>>;
+export type CancelRequestMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type CancelRequestMutationVariables = {
+  requestId: number;
+};
+/**
+ * @summary Cancel Request
+ */
+export declare const useCancelRequest: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof cancelRequest>>, TError, CancelRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof cancelRequest>>, TError, CancelRequestMutationVariables, TContext>;
+export declare const getRateRequestUrl: (requestId: number) => string;
+/**
+ * Rate the answer. One rating per request, enforced by the table.
+ * @summary Rate Request
+ */
+export declare const rateRequest: (requestId: number, tutoringFeedbackWrite: TutoringFeedbackWrite, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getRateRequestMutationKey: () => readonly ['rateRequest'];
+export declare const getRateRequestMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof rateRequest>>, TError, RateRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof rateRequest>>, TError, RateRequestMutationVariables, TContext>;
+export type RateRequestMutationResult = NonNullable<Awaited<ReturnType<typeof rateRequest>>>;
+export type RateRequestMutationBody = BodyType<TutoringFeedbackWrite>;
+export type RateRequestMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type RateRequestMutationVariables = {
+  requestId: number;
+  data: BodyType<TutoringFeedbackWrite>;
+};
+/**
+ * @summary Rate Request
+ */
+export declare const useRateRequest: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof rateRequest>>, TError, RateRequestMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof rateRequest>>, TError, RateRequestMutationVariables, TContext>;
+//#endregion
+//# sourceMappingURL=tutoring-requests.d.ts.map