@learnorama/mozaik-sdk 0.1.0

package/dist/react/biblio-home.d.ts

@@ -0,0 +1,47 @@
+
+import { Gn as HTTPExceptionResponse, Kn as HomeFeedRead, st as ReadHomeFeedParams, t as ValidationErrorResponse } from "../index-wL_20vR8.js";
+import { a as ErrorType, c as request } from "../client-BDwBZYB0.js";
+import { DataTag, DefinedInitialDataOptions, DefinedUseQueryResult, QueryClient, QueryKey, UndefinedInitialDataOptions, UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
+//#region src/react/biblio-home/biblio-home.d.ts
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+export declare const getReadHomeFeedUrl: (params?: ReadHomeFeedParams) => string;
+/**
+ * Everything the home screen needs, in one call (E48).
+ *
+ * Each block is built independently and a block that raises is dropped. The
+ * caller can tell the difference — an absent key means the section could not be
+ * built, an empty list means there was nothing in it — which is more than the
+ * legacy offered, where four carousels were hardcoded to empty and looked
+ * identical to "nothing new".
+ * @summary Read Home Feed
+ */
+export declare const readHomeFeed: (params?: ReadHomeFeedParams, options?: Parameters<typeof request>[1]) => Promise<HomeFeedRead>;
+export declare const getReadHomeFeedQueryKey: (params?: ReadHomeFeedParams) => readonly ["/biblio/home-feed", ...ReadHomeFeedParams[]];
+export declare const getReadHomeFeedQueryOptions: <TData = Awaited<ReturnType<typeof readHomeFeed>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ReadHomeFeedParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}) => UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export type ReadHomeFeedQueryResult = NonNullable<Awaited<ReturnType<typeof readHomeFeed>>>;
+export type ReadHomeFeedQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export declare function useReadHomeFeed<TData = Awaited<ReturnType<typeof readHomeFeed>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params: undefined | ReadHomeFeedParams, options: {
+  query: Partial<UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData>> & Pick<DefinedInitialDataOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, Awaited<ReturnType<typeof readHomeFeed>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): DefinedUseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useReadHomeFeed<TData = Awaited<ReturnType<typeof readHomeFeed>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ReadHomeFeedParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData>> & Pick<UndefinedInitialDataOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, Awaited<ReturnType<typeof readHomeFeed>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useReadHomeFeed<TData = Awaited<ReturnType<typeof readHomeFeed>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ReadHomeFeedParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+//#endregion
+//# sourceMappingURL=biblio-home.d.ts.map

package/dist/react/biblio-home.js

@@ -0,0 +1,75 @@
+"use client";
+import { r as request } from "../client-D3kMOcIr.js";
+import { useQuery } from "@tanstack/react-query";
+//#region src/react/biblio-home/biblio-home.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 getReadHomeFeedUrl = (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 ? `/biblio/home-feed?${stringifiedParams}` : `/biblio/home-feed`;
+};
+/**
+* Everything the home screen needs, in one call (E48).
+*
+* Each block is built independently and a block that raises is dropped. The
+* caller can tell the difference — an absent key means the section could not be
+* built, an empty list means there was nothing in it — which is more than the
+* legacy offered, where four carousels were hardcoded to empty and looked
+* identical to "nothing new".
+* @summary Read Home Feed
+*/
+const readHomeFeed = async (params, options) => {
+	return request(getReadHomeFeedUrl(params), {
+		...options,
+		method: "GET"
+	});
+};
+const getReadHomeFeedQueryKey = (params) => {
+	return [`/biblio/home-feed`, ...params ? [params] : []];
+};
+const getReadHomeFeedQueryOptions = (params, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getReadHomeFeedQueryKey(params);
+	const queryFn = ({ signal }) => readHomeFeed(params, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		...queryOptions
+	};
+};
+/**
+* @summary Read Home Feed
+*/
+function useReadHomeFeed(params, options, queryClient) {
+	const queryOptions = getReadHomeFeedQueryOptions(params, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+//#endregion
+export { getReadHomeFeedQueryKey, getReadHomeFeedQueryOptions, getReadHomeFeedUrl, readHomeFeed, useReadHomeFeed };
+
+//# sourceMappingURL=biblio-home.js.map

package/dist/react/biblio-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"biblio-home.js","names":[],"sources":["../../src/react/biblio-home/biblio-home.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  useQuery\n} from '@tanstack/react-query';\nimport type {\n  DataTag,\n  DefinedInitialDataOptions,\n  DefinedUseQueryResult,\n  QueryClient,\n  QueryFunction,\n  QueryKey,\n  UndefinedInitialDataOptions,\n  UseQueryOptions,\n  UseQueryResult\n} from '@tanstack/react-query';\n\nimport type {\n  HTTPExceptionResponse,\n  HomeFeedRead,\n  ReadHomeFeedParams,\n  ValidationErrorResponse\n} from '../../models';\n\nimport { request } from '../../client';\nimport type { ErrorType } 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 getReadHomeFeedUrl = (params?: ReadHomeFeedParams,) => {\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 ? `/biblio/home-feed?${stringifiedParams}` : `/biblio/home-feed`\n}\n\n/**\n * Everything the home screen needs, in one call (E48).\n *\n * Each block is built independently and a block that raises is dropped. The\n * caller can tell the difference — an absent key means the section could not be\n * built, an empty list means there was nothing in it — which is more than the\n * legacy offered, where four carousels were hardcoded to empty and looked\n * identical to \"nothing new\".\n * @summary Read Home Feed\n */\nexport const readHomeFeed = async (params?: ReadHomeFeedParams, options?: Parameters<typeof request>[1]): Promise<HomeFeedRead> => {\n\n  return request<HomeFeedRead>(getReadHomeFeedUrl(params),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\n\n\n\nexport const getReadHomeFeedQueryKey = (params?: ReadHomeFeedParams,) => {\n    return [\n    `/biblio/home-feed`, ...(params ? [params] : [])\n    ] as const;\n    }\n\n\nexport const getReadHomeFeedQueryOptions = <TData = Awaited<ReturnType<typeof readHomeFeed>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ReadHomeFeedParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData>>, request?: SecondParameter<typeof request>}\n) => {\n\nconst {query: queryOptions, request: requestOptions} = options ?? {};\n\n  const queryKey =  queryOptions?.queryKey ?? getReadHomeFeedQueryKey(params);\n\n\n\n    const queryFn: QueryFunction<Awaited<ReturnType<typeof readHomeFeed>>> = ({ signal }) => readHomeFeed(params, { signal, ...requestOptions });\n\n\n\n\n\n   return  { queryKey, queryFn, ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }\n}\n\nexport type ReadHomeFeedQueryResult = NonNullable<Awaited<ReturnType<typeof readHomeFeed>>>\nexport type ReadHomeFeedQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>\n\n\nexport function useReadHomeFeed<TData = Awaited<ReturnType<typeof readHomeFeed>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n params: undefined |  ReadHomeFeedParams, options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData>> & Pick<\n        DefinedInitialDataOptions<\n          Awaited<ReturnType<typeof readHomeFeed>>,\n          TError,\n          Awaited<ReturnType<typeof readHomeFeed>>\n        > , 'initialData'\n      >, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }\nexport function useReadHomeFeed<TData = Awaited<ReturnType<typeof readHomeFeed>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n params?: ReadHomeFeedParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData>> & Pick<\n        UndefinedInitialDataOptions<\n          Awaited<ReturnType<typeof readHomeFeed>>,\n          TError,\n          Awaited<ReturnType<typeof readHomeFeed>>\n        > , 'initialData'\n      >, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }\nexport function useReadHomeFeed<TData = Awaited<ReturnType<typeof readHomeFeed>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n params?: ReadHomeFeedParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData>>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }\n/**\n * @summary Read Home Feed\n */\n\nexport function useReadHomeFeed<TData = Awaited<ReturnType<typeof readHomeFeed>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(\n params?: ReadHomeFeedParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof readHomeFeed>>, TError, TData>>, request?: SecondParameter<typeof request>}\n , queryClient?: QueryClient\n ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {\n\n  const queryOptions = getReadHomeFeedQueryOptions(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\n"],"mappings":";;;;;;;;;;;AAqCA,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,sBAAsB,WAAiC;CAClE,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,qBAAqB,sBAAsB;AACnF;;;;;;;;;;;AAYA,MAAa,eAAe,OAAO,QAA6B,YAAmE;CAEjI,OAAO,QAAsB,mBAAmB,MAAM,GACtD;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAMF,MAAa,2BAA2B,WAAiC;CACrE,OAAO,CACP,qBAAqB,GAAI,SAAS,CAAC,MAAM,IAAI,CAAC,CAC9C;AACA;AAGJ,MAAa,+BAAsJ,QAA6B,YAC3L;CAEL,MAAM,EAAC,OAAO,cAAc,SAAS,mBAAkB,WAAW,CAAC;CAEjE,MAAM,WAAY,cAAc,YAAY,wBAAwB,MAAM;CAIxE,MAAM,WAAoE,EAAE,aAAa,aAAa,QAAQ;EAAE;EAAQ,GAAG;CAAe,CAAC;CAM5I,OAAQ;EAAE;EAAU;EAAS,GAAG;CAAY;AAC/C;;;;AAkCA,SAAgB,gBACf,QAA6B,SAC3B,aACiF;CAElF,MAAM,eAAe,4BAA4B,QAAO,OAAO;CAE/D,MAAM,QAAQ,SAAS,cAAc,WAAW;CAEhD,OAAO,aAAa,OAAO,aAAa,QAAQ;AAClD"}

package/dist/react/biblio-library.d.ts

@@ -0,0 +1,285 @@
+
+import { $n as FavoritePage, Ct as PreferencesRead, Fr as CategoryListRead, Gn as HTTPExceptionResponse, Ht as PackListRead, Pr as CategoryPreferencesWrite, Tn as ListBiblioFavoritesParams, Zn as HistoryPage, bn as ListHistoryParams, ir as FavoriteAddWrite, t as ValidationErrorResponse } 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/biblio-library/biblio-library.d.ts
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+export declare const getListBiblioCategoriesUrl: () => string;
+/**
+ * The categories this account can reach (E26).
+ *
+ * Two independent gates, and both have to pass. Entitlement answers "did the
+ * company buy this"; ``access_level`` answers "is this person allowed it" — an
+ * ordinal on the account compared against one on the category, which is how a
+ * child profile is kept out of the adult catalogue. Neither substitutes for the
+ * other.
+ * @summary List Biblio Categories
+ */
+export declare const listBiblioCategories: (options?: Parameters<typeof request>[1]) => Promise<CategoryListRead>;
+export declare const getListBiblioCategoriesQueryKey: () => readonly [`/biblio/me/categories`];
+export declare const getListBiblioCategoriesQueryOptions: <TData = Awaited<ReturnType<typeof listBiblioCategories>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listBiblioCategories>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listBiblioCategories>>, TError, TData> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export type ListBiblioCategoriesQueryResult = NonNullable<Awaited<ReturnType<typeof listBiblioCategories>>>;
+export type ListBiblioCategoriesQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export declare function useListBiblioCategories<TData = Awaited<ReturnType<typeof listBiblioCategories>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options: {
+  query: Partial<UseQueryOptions<Awaited<ReturnType<typeof listBiblioCategories>>, TError, TData>> & Pick<DefinedInitialDataOptions<Awaited<ReturnType<typeof listBiblioCategories>>, TError, Awaited<ReturnType<typeof listBiblioCategories>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): DefinedUseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListBiblioCategories<TData = Awaited<ReturnType<typeof listBiblioCategories>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listBiblioCategories>>, TError, TData>> & Pick<UndefinedInitialDataOptions<Awaited<ReturnType<typeof listBiblioCategories>>, TError, Awaited<ReturnType<typeof listBiblioCategories>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListBiblioCategories<TData = Awaited<ReturnType<typeof listBiblioCategories>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listBiblioCategories>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare const getListBiblioFavoritesUrl: (params?: ListBiblioFavoritesParams) => string;
+/**
+ * The caller's favourites (E30), newest first.
+ * @summary List Biblio Favorites
+ */
+export declare const listBiblioFavorites: (params?: ListBiblioFavoritesParams, options?: Parameters<typeof request>[1]) => Promise<FavoritePage>;
+export declare const getListBiblioFavoritesQueryKey: (params?: ListBiblioFavoritesParams) => readonly ["/biblio/me/favorites", ...ListBiblioFavoritesParams[]];
+export declare const getListBiblioFavoritesQueryOptions: <TData = Awaited<ReturnType<typeof listBiblioFavorites>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ListBiblioFavoritesParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listBiblioFavorites>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listBiblioFavorites>>, TError, TData> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export type ListBiblioFavoritesQueryResult = NonNullable<Awaited<ReturnType<typeof listBiblioFavorites>>>;
+export type ListBiblioFavoritesQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export declare function useListBiblioFavorites<TData = Awaited<ReturnType<typeof listBiblioFavorites>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params: undefined | ListBiblioFavoritesParams, options: {
+  query: Partial<UseQueryOptions<Awaited<ReturnType<typeof listBiblioFavorites>>, TError, TData>> & Pick<DefinedInitialDataOptions<Awaited<ReturnType<typeof listBiblioFavorites>>, TError, Awaited<ReturnType<typeof listBiblioFavorites>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): DefinedUseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListBiblioFavorites<TData = Awaited<ReturnType<typeof listBiblioFavorites>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ListBiblioFavoritesParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listBiblioFavorites>>, TError, TData>> & Pick<UndefinedInitialDataOptions<Awaited<ReturnType<typeof listBiblioFavorites>>, TError, Awaited<ReturnType<typeof listBiblioFavorites>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListBiblioFavorites<TData = Awaited<ReturnType<typeof listBiblioFavorites>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ListBiblioFavoritesParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listBiblioFavorites>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare const getRemoveBiblioFavoriteUrl: (contentId: number) => string;
+/**
+ * Remove a favourite (E32). Idempotent — absent is already the desired state.
+ * @summary Remove Biblio Favorite
+ */
+export declare const removeBiblioFavorite: (contentId: number, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getRemoveBiblioFavoriteMutationKey: () => readonly ['removeBiblioFavorite'];
+export declare const getRemoveBiblioFavoriteMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof removeBiblioFavorite>>, TError, RemoveBiblioFavoriteMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof removeBiblioFavorite>>, TError, RemoveBiblioFavoriteMutationVariables, TContext>;
+export type RemoveBiblioFavoriteMutationResult = NonNullable<Awaited<ReturnType<typeof removeBiblioFavorite>>>;
+export type RemoveBiblioFavoriteMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type RemoveBiblioFavoriteMutationVariables = {
+  contentId: number;
+};
+/**
+ * @summary Remove Biblio Favorite
+ */
+export declare const useRemoveBiblioFavorite: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof removeBiblioFavorite>>, TError, RemoveBiblioFavoriteMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof removeBiblioFavorite>>, TError, RemoveBiblioFavoriteMutationVariables, TContext>;
+export declare const getAddBiblioFavoriteUrl: (contentId: number) => string;
+/**
+ * Mark content as a favourite (E31). Idempotent.
+ *
+ * ``PUT`` and :func:`remove_favorite`'s ``DELETE`` replace one
+ * ``POST /favorites`` carrying an ``enabled`` boolean — the verb encoded as
+ * data. A retry after a timeout reversed the user's intent; a repeated ``PUT``
+ * cannot (§4, consequence 3).
+ *
+ * Favouriting is not consumption, so it is not entitlement-gated: a member may
+ * bookmark something their library has not licensed *yet*. Reaching the content
+ * is gated, at the point of reaching it.
+ * @summary Add Biblio Favorite
+ */
+export declare const addBiblioFavorite: (contentId: number, favoriteAddWrite: FavoriteAddWrite, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getAddBiblioFavoriteMutationKey: () => readonly ['addBiblioFavorite'];
+export declare const getAddBiblioFavoriteMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof addBiblioFavorite>>, TError, AddBiblioFavoriteMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof addBiblioFavorite>>, TError, AddBiblioFavoriteMutationVariables, TContext>;
+export type AddBiblioFavoriteMutationResult = NonNullable<Awaited<ReturnType<typeof addBiblioFavorite>>>;
+export type AddBiblioFavoriteMutationBody = BodyType<FavoriteAddWrite>;
+export type AddBiblioFavoriteMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type AddBiblioFavoriteMutationVariables = {
+  contentId: number;
+  data: BodyType<FavoriteAddWrite>;
+};
+/**
+ * @summary Add Biblio Favorite
+ */
+export declare const useAddBiblioFavorite: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof addBiblioFavorite>>, TError, AddBiblioFavoriteMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof addBiblioFavorite>>, TError, AddBiblioFavoriteMutationVariables, TContext>;
+export declare const getListHistoryUrl: (params?: ListHistoryParams) => string;
+/**
+ * What this account has consumed, most recent first (E33).
+ *
+ * One row per content item, not one per view: the caller wants "what have I
+ * been reading", and ``consumption_event`` is append-only with a row per act.
+ * The last access is therefore a MAX, and progress comes from
+ * ``content_progress``, which is LEFT JOINed because an absent row means "not
+ * started" rather than zero.
+ * @summary List History
+ */
+export declare const listHistory: (params?: ListHistoryParams, options?: Parameters<typeof request>[1]) => Promise<HistoryPage>;
+export declare const getListHistoryQueryKey: (params?: ListHistoryParams) => readonly ["/biblio/me/history", ...ListHistoryParams[]];
+export declare const getListHistoryQueryOptions: <TData = Awaited<ReturnType<typeof listHistory>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ListHistoryParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listHistory>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listHistory>>, TError, TData> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export type ListHistoryQueryResult = NonNullable<Awaited<ReturnType<typeof listHistory>>>;
+export type ListHistoryQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export declare function useListHistory<TData = Awaited<ReturnType<typeof listHistory>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params: undefined | ListHistoryParams, options: {
+  query: Partial<UseQueryOptions<Awaited<ReturnType<typeof listHistory>>, TError, TData>> & Pick<DefinedInitialDataOptions<Awaited<ReturnType<typeof listHistory>>, TError, Awaited<ReturnType<typeof listHistory>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): DefinedUseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListHistory<TData = Awaited<ReturnType<typeof listHistory>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ListHistoryParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listHistory>>, TError, TData>> & Pick<UndefinedInitialDataOptions<Awaited<ReturnType<typeof listHistory>>, TError, Awaited<ReturnType<typeof listHistory>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListHistory<TData = Awaited<ReturnType<typeof listHistory>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(params?: ListHistoryParams, options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listHistory>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare const getListPacksUrl: () => string;
+/**
+ * The content packs this account can navigate (E25).
+ *
+ * A pack is a :class:`~app.models.biblio.catalogue.CatalogSection`, and one is
+ * reachable when the contract reaches at least one category inside it. Deriving
+ * it that way rather than granting packs directly means a pack cannot advertise
+ * itself while every category under it is out of contract.
+ *
+ * Empty is a correct answer, not a broken one: an account whose contract has
+ * lapsed reaches nothing.
+ * @summary List Packs
+ */
+export declare const listPacks: (options?: Parameters<typeof request>[1]) => Promise<PackListRead>;
+export declare const getListPacksQueryKey: () => readonly [`/biblio/me/packs`];
+export declare const getListPacksQueryOptions: <TData = Awaited<ReturnType<typeof listPacks>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listPacks>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}) => UseQueryOptions<Awaited<ReturnType<typeof listPacks>>, TError, TData> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export type ListPacksQueryResult = NonNullable<Awaited<ReturnType<typeof listPacks>>>;
+export type ListPacksQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export declare function useListPacks<TData = Awaited<ReturnType<typeof listPacks>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options: {
+  query: Partial<UseQueryOptions<Awaited<ReturnType<typeof listPacks>>, TError, TData>> & Pick<DefinedInitialDataOptions<Awaited<ReturnType<typeof listPacks>>, TError, Awaited<ReturnType<typeof listPacks>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): DefinedUseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListPacks<TData = Awaited<ReturnType<typeof listPacks>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listPacks>>, TError, TData>> & Pick<UndefinedInitialDataOptions<Awaited<ReturnType<typeof listPacks>>, TError, Awaited<ReturnType<typeof listPacks>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useListPacks<TData = Awaited<ReturnType<typeof listPacks>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof listPacks>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare const getReadPreferencesUrl: () => string;
+/**
+ * The caller's own preferences (E28).
+ *
+ * An object with one key rather than a bare array, so a second preference can
+ * be added later without breaking every client.
+ * @summary Read Preferences
+ */
+export declare const readPreferences: (options?: Parameters<typeof request>[1]) => Promise<PreferencesRead>;
+export declare const getReadPreferencesQueryKey: () => readonly [`/biblio/me/preferences`];
+export declare const getReadPreferencesQueryOptions: <TData = Awaited<ReturnType<typeof readPreferences>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof readPreferences>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}) => UseQueryOptions<Awaited<ReturnType<typeof readPreferences>>, TError, TData> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export type ReadPreferencesQueryResult = NonNullable<Awaited<ReturnType<typeof readPreferences>>>;
+export type ReadPreferencesQueryError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export declare function useReadPreferences<TData = Awaited<ReturnType<typeof readPreferences>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options: {
+  query: Partial<UseQueryOptions<Awaited<ReturnType<typeof readPreferences>>, TError, TData>> & Pick<DefinedInitialDataOptions<Awaited<ReturnType<typeof readPreferences>>, TError, Awaited<ReturnType<typeof readPreferences>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): DefinedUseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useReadPreferences<TData = Awaited<ReturnType<typeof readPreferences>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof readPreferences>>, TError, TData>> & Pick<UndefinedInitialDataOptions<Awaited<ReturnType<typeof readPreferences>>, TError, Awaited<ReturnType<typeof readPreferences>>>, 'initialData'>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare function useReadPreferences<TData = Awaited<ReturnType<typeof readPreferences>>, TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>>(options?: {
+  query?: Partial<UseQueryOptions<Awaited<ReturnType<typeof readPreferences>>, TError, TData>>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient): UseQueryResult<TData, TError> & {
+  queryKey: DataTag<QueryKey, TData, TError>;
+};
+export declare const getReplaceCategoryPreferencesUrl: () => string;
+/**
+ * Replace the favourite-category set wholesale (E29).
+ *
+ * ``PUT`` because the legacy handler already replaced the whole set; the verb
+ * now says so. An empty array clears the set and is valid input — the legacy
+ * left that path uncaught and returned ``500``.
+ *
+ * A category the account cannot reach is ``422``, listing the offending ids.
+ * Silently dropping them would leave the client believing it had saved
+ * something it had not.
+ * @summary Replace Category Preferences
+ */
+export declare const replaceCategoryPreferences: (categoryPreferencesWrite: CategoryPreferencesWrite, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getReplaceCategoryPreferencesMutationKey: () => readonly ['replaceCategoryPreferences'];
+export declare const getReplaceCategoryPreferencesMutationOptions: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof replaceCategoryPreferences>>, TError, ReplaceCategoryPreferencesMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}) => UseMutationOptions<Awaited<ReturnType<typeof replaceCategoryPreferences>>, TError, ReplaceCategoryPreferencesMutationVariables, TContext>;
+export type ReplaceCategoryPreferencesMutationResult = NonNullable<Awaited<ReturnType<typeof replaceCategoryPreferences>>>;
+export type ReplaceCategoryPreferencesMutationBody = BodyType<CategoryPreferencesWrite>;
+export type ReplaceCategoryPreferencesMutationError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>;
+export type ReplaceCategoryPreferencesMutationVariables = {
+  data: BodyType<CategoryPreferencesWrite>;
+};
+/**
+ * @summary Replace Category Preferences
+ */
+export declare const useReplaceCategoryPreferences: <TError = ErrorType<HTTPExceptionResponse | ValidationErrorResponse>, TContext = unknown>(options?: {
+  mutation?: UseMutationOptions<Awaited<ReturnType<typeof replaceCategoryPreferences>>, TError, ReplaceCategoryPreferencesMutationVariables, TContext>;
+  request?: SecondParameter<typeof request>;
+}, queryClient?: QueryClient) => UseMutationResult<Awaited<ReturnType<typeof replaceCategoryPreferences>>, TError, ReplaceCategoryPreferencesMutationVariables, TContext>;
+//#endregion
+//# sourceMappingURL=biblio-library.d.ts.map