@squonk/account-server-client 4.7.3 → 4.8.0

package/src/api/notifications/notifications.fetch.ts

@@ -0,0 +1,577 @@
+/**
+ * Generated by orval v8.22.0 🍺
+ * Do not edit manually.
+ * Account Server API
+ * The Informatics Matters Account Server API.
+ *
+ * A service that provides access to the Account Server, which gives *registered* users access to and management of **Organisations**, **Units**, **Products**, **Users**, and **Assets**.
+ *
+ * OpenAPI spec version: 4.8
+ */
+import { useQuery, useSuspenseQuery } from "@tanstack/react-query";
+import type {
+  DataTag,
+  DefinedInitialDataOptions,
+  DefinedUseQueryResult,
+  InvalidateOptions,
+  QueryClient,
+  QueryFunction,
+  QueryKey,
+  UndefinedInitialDataOptions,
+  UseQueryOptions,
+  UseQueryResult,
+  UseSuspenseQueryOptions,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+
+import type {
+  AsError,
+  GetIncidentsParams,
+  GetNotificationsParams,
+  IncidentsGetResponse,
+  NotificationsGetResponse,
+} from "../api-schemas";
+
+import { customFetch } from "../../custom-fetch";
+import type { ErrorType } from "../../custom-fetch";
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+const withQueryKey = <T extends object, K>(query: T, queryKey: K): T & { queryKey: K } => {
+  const result = { queryKey } as T & { queryKey: K };
+  for (const key of Object.keys(query)) {
+    // The explicit queryKey always wins, matching the previous
+    // `{ ...query, queryKey }` spread where it was set last.
+    if (key === "queryKey") continue;
+    Object.defineProperty(result, key, {
+      enumerable: true,
+      configurable: true,
+      get: () => (query as Record<string, unknown>)[key],
+    });
+  }
+  return result;
+};
+
+export type getNotificationsResponse200 = { data: NotificationsGetResponse; status: 200 };
+
+export type getNotificationsResponse400 = { data: AsError; status: 400 };
+
+export type getNotificationsResponse401 = { data: void; status: 401 };
+
+export type getNotificationsResponse403 = { data: AsError; status: 403 };
+
+export type getNotificationsResponseSuccess = getNotificationsResponse200 & { headers: Headers };
+export type getNotificationsResponseError = (
+  | getNotificationsResponse400
+  | getNotificationsResponse401
+  | getNotificationsResponse403
+) & { headers: Headers };
+
+export type getNotificationsResponse =
+  | getNotificationsResponseSuccess
+  | getNotificationsResponseError;
+
+export const getGetNotificationsUrl = (params?: GetNotificationsParams) => {
+  const normalizedParams = new URLSearchParams();
+
+  Object.entries(params || {}).forEach(([key, value]) => {
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? "null" : String(value));
+    }
+  });
+
+  const stringifiedParams = normalizedParams.toString();
+
+  return stringifiedParams.length > 0 ? `/notification?${stringifiedParams}` : `/notification`;
+};
+
+/**
+ * Gets Notifications, newest first - who was told about an Incident, over which Relay, and how it went.
+ *
+ * Each Notification has exactly one delivery attempt and is never retried, so the `reason` of a `FAILED` Notification is the whole of its delivery record, and is returned in full.
+ *
+ * You need admin rights to use this path.
+ * @summary Gets Notifications
+ */
+export const getNotifications = async (
+  params?: GetNotificationsParams,
+  options?: RequestInit,
+): Promise<getNotificationsResponse> => {
+  return customFetch<getNotificationsResponse>(getGetNotificationsUrl(params), {
+    ...options,
+    method: "GET",
+  });
+};
+
+export const getGetNotificationsQueryKey = (params?: GetNotificationsParams) => {
+  return ["account-server", "notification", ...(params ? [params] : [])] as const;
+};
+
+export const getGetNotificationsQueryOptions = <
+  TData = Awaited<ReturnType<typeof getNotifications>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetNotificationsParams,
+  options?: {
+    query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getNotifications>>, TError, TData>>;
+    request?: SecondParameter<typeof customFetch>;
+  },
+) => {
+  const { query: queryOptions, request: requestOptions } = options ?? {};
+
+  const queryKey = queryOptions?.queryKey ?? getGetNotificationsQueryKey(params);
+
+  const queryFn: QueryFunction<Awaited<ReturnType<typeof getNotifications>>> = ({ signal }) =>
+    getNotifications(params, { signal, ...requestOptions });
+
+  return { queryKey, queryFn, ...queryOptions } as UseQueryOptions<
+    Awaited<ReturnType<typeof getNotifications>>,
+    TError,
+    TData
+  > & { queryKey: DataTag<QueryKey, TData, TError> };
+};
+
+export type GetNotificationsQueryResult = NonNullable<Awaited<ReturnType<typeof getNotifications>>>;
+export type GetNotificationsQueryError = ErrorType<AsError | void>;
+
+export function useGetNotifications<
+  TData = Awaited<ReturnType<typeof getNotifications>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params: undefined | GetNotificationsParams,
+  options: {
+    query: Partial<UseQueryOptions<Awaited<ReturnType<typeof getNotifications>>, TError, TData>> &
+      Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getNotifications>>,
+          TError,
+          Awaited<ReturnType<typeof getNotifications>>
+        >,
+        "initialData"
+      >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+export function useGetNotifications<
+  TData = Awaited<ReturnType<typeof getNotifications>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetNotificationsParams,
+  options?: {
+    query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getNotifications>>, TError, TData>> &
+      Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getNotifications>>,
+          TError,
+          Awaited<ReturnType<typeof getNotifications>>
+        >,
+        "initialData"
+      >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+export function useGetNotifications<
+  TData = Awaited<ReturnType<typeof getNotifications>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetNotificationsParams,
+  options?: {
+    query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getNotifications>>, TError, TData>>;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+/**
+ * @summary Gets Notifications
+ */
+
+export function useGetNotifications<
+  TData = Awaited<ReturnType<typeof getNotifications>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetNotificationsParams,
+  options?: {
+    query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getNotifications>>, TError, TData>>;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+  const queryOptions = getGetNotificationsQueryOptions(params, options);
+
+  const query = useQuery(queryOptions, queryClient) as UseQueryResult<TData, TError> & {
+    queryKey: DataTag<QueryKey, TData, TError>;
+  };
+
+  return withQueryKey(query, queryOptions.queryKey);
+}
+
+/**
+ * @summary Gets Notifications
+ */
+export const invalidateGetNotifications = async (
+  queryClient: QueryClient,
+  params?: GetNotificationsParams,
+  options?: InvalidateOptions,
+): Promise<QueryClient> => {
+  await queryClient.invalidateQueries({ queryKey: getGetNotificationsQueryKey(params) }, options);
+
+  return queryClient;
+};
+
+export const getGetNotificationsSuspenseQueryOptions = <
+  TData = Awaited<ReturnType<typeof getNotifications>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetNotificationsParams,
+  options?: {
+    query?: Partial<
+      UseSuspenseQueryOptions<Awaited<ReturnType<typeof getNotifications>>, TError, TData>
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+) => {
+  const { query: queryOptions, request: requestOptions } = options ?? {};
+
+  const queryKey = queryOptions?.queryKey ?? getGetNotificationsQueryKey(params);
+
+  const queryFn: QueryFunction<Awaited<ReturnType<typeof getNotifications>>> = ({ signal }) =>
+    getNotifications(params, { signal, ...requestOptions });
+
+  return { queryKey, queryFn, ...queryOptions } as UseSuspenseQueryOptions<
+    Awaited<ReturnType<typeof getNotifications>>,
+    TError,
+    TData
+  > & { queryKey: DataTag<QueryKey, TData, TError> };
+};
+
+export type GetNotificationsSuspenseQueryResult = NonNullable<
+  Awaited<ReturnType<typeof getNotifications>>
+>;
+export type GetNotificationsSuspenseQueryError = ErrorType<AsError | void>;
+
+export function useGetNotificationsSuspense<
+  TData = Awaited<ReturnType<typeof getNotifications>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params: undefined | GetNotificationsParams,
+  options: {
+    query: Partial<
+      UseSuspenseQueryOptions<Awaited<ReturnType<typeof getNotifications>>, TError, TData>
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseSuspenseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+export function useGetNotificationsSuspense<
+  TData = Awaited<ReturnType<typeof getNotifications>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetNotificationsParams,
+  options?: {
+    query?: Partial<
+      UseSuspenseQueryOptions<Awaited<ReturnType<typeof getNotifications>>, TError, TData>
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseSuspenseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+export function useGetNotificationsSuspense<
+  TData = Awaited<ReturnType<typeof getNotifications>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetNotificationsParams,
+  options?: {
+    query?: Partial<
+      UseSuspenseQueryOptions<Awaited<ReturnType<typeof getNotifications>>, TError, TData>
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseSuspenseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+/**
+ * @summary Gets Notifications
+ */
+
+export function useGetNotificationsSuspense<
+  TData = Awaited<ReturnType<typeof getNotifications>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetNotificationsParams,
+  options?: {
+    query?: Partial<
+      UseSuspenseQueryOptions<Awaited<ReturnType<typeof getNotifications>>, TError, TData>
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseSuspenseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+  const queryOptions = getGetNotificationsSuspenseQueryOptions(params, options);
+
+  const query = useSuspenseQuery(queryOptions, queryClient) as UseSuspenseQueryResult<
+    TData,
+    TError
+  > & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return withQueryKey(query, queryOptions.queryKey);
+}
+
+export type getIncidentsResponse200 = { data: IncidentsGetResponse; status: 200 };
+
+export type getIncidentsResponse400 = { data: AsError; status: 400 };
+
+export type getIncidentsResponse401 = { data: void; status: 401 };
+
+export type getIncidentsResponse403 = { data: AsError; status: 403 };
+
+export type getIncidentsResponseSuccess = getIncidentsResponse200 & { headers: Headers };
+export type getIncidentsResponseError = (
+  | getIncidentsResponse400
+  | getIncidentsResponse401
+  | getIncidentsResponse403
+) & { headers: Headers };
+
+export type getIncidentsResponse = getIncidentsResponseSuccess | getIncidentsResponseError;
+
+export const getGetIncidentsUrl = (params?: GetIncidentsParams) => {
+  const normalizedParams = new URLSearchParams();
+
+  Object.entries(params || {}).forEach(([key, value]) => {
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? "null" : String(value));
+    }
+  });
+
+  const stringifiedParams = normalizedParams.toString();
+
+  return stringifiedParams.length > 0 ? `/incident?${stringifiedParams}` : `/incident`;
+};
+
+/**
+ * Gets Incidents, newest first - the conditions the Account Server has detected, each recorded once however many people were told.
+ *
+ * You need admin rights to use this path.
+ * @summary Gets Incidents
+ */
+export const getIncidents = async (
+  params?: GetIncidentsParams,
+  options?: RequestInit,
+): Promise<getIncidentsResponse> => {
+  return customFetch<getIncidentsResponse>(getGetIncidentsUrl(params), {
+    ...options,
+    method: "GET",
+  });
+};
+
+export const getGetIncidentsQueryKey = (params?: GetIncidentsParams) => {
+  return ["account-server", "incident", ...(params ? [params] : [])] as const;
+};
+
+export const getGetIncidentsQueryOptions = <
+  TData = Awaited<ReturnType<typeof getIncidents>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetIncidentsParams,
+  options?: {
+    query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getIncidents>>, TError, TData>>;
+    request?: SecondParameter<typeof customFetch>;
+  },
+) => {
+  const { query: queryOptions, request: requestOptions } = options ?? {};
+
+  const queryKey = queryOptions?.queryKey ?? getGetIncidentsQueryKey(params);
+
+  const queryFn: QueryFunction<Awaited<ReturnType<typeof getIncidents>>> = ({ signal }) =>
+    getIncidents(params, { signal, ...requestOptions });
+
+  return { queryKey, queryFn, ...queryOptions } as UseQueryOptions<
+    Awaited<ReturnType<typeof getIncidents>>,
+    TError,
+    TData
+  > & { queryKey: DataTag<QueryKey, TData, TError> };
+};
+
+export type GetIncidentsQueryResult = NonNullable<Awaited<ReturnType<typeof getIncidents>>>;
+export type GetIncidentsQueryError = ErrorType<AsError | void>;
+
+export function useGetIncidents<
+  TData = Awaited<ReturnType<typeof getIncidents>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params: undefined | GetIncidentsParams,
+  options: {
+    query: Partial<UseQueryOptions<Awaited<ReturnType<typeof getIncidents>>, TError, TData>> &
+      Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getIncidents>>,
+          TError,
+          Awaited<ReturnType<typeof getIncidents>>
+        >,
+        "initialData"
+      >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+export function useGetIncidents<
+  TData = Awaited<ReturnType<typeof getIncidents>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetIncidentsParams,
+  options?: {
+    query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getIncidents>>, TError, TData>> &
+      Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getIncidents>>,
+          TError,
+          Awaited<ReturnType<typeof getIncidents>>
+        >,
+        "initialData"
+      >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+export function useGetIncidents<
+  TData = Awaited<ReturnType<typeof getIncidents>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetIncidentsParams,
+  options?: {
+    query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getIncidents>>, TError, TData>>;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+/**
+ * @summary Gets Incidents
+ */
+
+export function useGetIncidents<
+  TData = Awaited<ReturnType<typeof getIncidents>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetIncidentsParams,
+  options?: {
+    query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof getIncidents>>, TError, TData>>;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+  const queryOptions = getGetIncidentsQueryOptions(params, options);
+
+  const query = useQuery(queryOptions, queryClient) as UseQueryResult<TData, TError> & {
+    queryKey: DataTag<QueryKey, TData, TError>;
+  };
+
+  return withQueryKey(query, queryOptions.queryKey);
+}
+
+/**
+ * @summary Gets Incidents
+ */
+export const invalidateGetIncidents = async (
+  queryClient: QueryClient,
+  params?: GetIncidentsParams,
+  options?: InvalidateOptions,
+): Promise<QueryClient> => {
+  await queryClient.invalidateQueries({ queryKey: getGetIncidentsQueryKey(params) }, options);
+
+  return queryClient;
+};
+
+export const getGetIncidentsSuspenseQueryOptions = <
+  TData = Awaited<ReturnType<typeof getIncidents>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetIncidentsParams,
+  options?: {
+    query?: Partial<
+      UseSuspenseQueryOptions<Awaited<ReturnType<typeof getIncidents>>, TError, TData>
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+) => {
+  const { query: queryOptions, request: requestOptions } = options ?? {};
+
+  const queryKey = queryOptions?.queryKey ?? getGetIncidentsQueryKey(params);
+
+  const queryFn: QueryFunction<Awaited<ReturnType<typeof getIncidents>>> = ({ signal }) =>
+    getIncidents(params, { signal, ...requestOptions });
+
+  return { queryKey, queryFn, ...queryOptions } as UseSuspenseQueryOptions<
+    Awaited<ReturnType<typeof getIncidents>>,
+    TError,
+    TData
+  > & { queryKey: DataTag<QueryKey, TData, TError> };
+};
+
+export type GetIncidentsSuspenseQueryResult = NonNullable<Awaited<ReturnType<typeof getIncidents>>>;
+export type GetIncidentsSuspenseQueryError = ErrorType<AsError | void>;
+
+export function useGetIncidentsSuspense<
+  TData = Awaited<ReturnType<typeof getIncidents>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params: undefined | GetIncidentsParams,
+  options: {
+    query: Partial<
+      UseSuspenseQueryOptions<Awaited<ReturnType<typeof getIncidents>>, TError, TData>
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseSuspenseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+export function useGetIncidentsSuspense<
+  TData = Awaited<ReturnType<typeof getIncidents>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetIncidentsParams,
+  options?: {
+    query?: Partial<
+      UseSuspenseQueryOptions<Awaited<ReturnType<typeof getIncidents>>, TError, TData>
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseSuspenseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+export function useGetIncidentsSuspense<
+  TData = Awaited<ReturnType<typeof getIncidents>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetIncidentsParams,
+  options?: {
+    query?: Partial<
+      UseSuspenseQueryOptions<Awaited<ReturnType<typeof getIncidents>>, TError, TData>
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseSuspenseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+/**
+ * @summary Gets Incidents
+ */
+
+export function useGetIncidentsSuspense<
+  TData = Awaited<ReturnType<typeof getIncidents>>,
+  TError = ErrorType<AsError | void>,
+>(
+  params?: GetIncidentsParams,
+  options?: {
+    query?: Partial<
+      UseSuspenseQueryOptions<Awaited<ReturnType<typeof getIncidents>>, TError, TData>
+    >;
+    request?: SecondParameter<typeof customFetch>;
+  },
+  queryClient?: QueryClient,
+): UseSuspenseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+  const queryOptions = getGetIncidentsSuspenseQueryOptions(params, options);
+
+  const query = useSuspenseQuery(queryOptions, queryClient) as UseSuspenseQueryResult<
+    TData,
+    TError
+  > & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return withQueryKey(query, queryOptions.queryKey);
+}