@learnorama/mozaik-sdk 0.8.3-staging.32.1 → 0.9.1-staging.36.1

package/dist/api/partner-catalogue.d.ts

@@ -1,5 +1,5 @@
 
-import { Rn as ListMediaParams, Zi as PartnerProvider, cn as PartnerCategoryListRead, nn as PartnerMediaRead, on as PartnerFavoriteListRead, rn as PartnerMediaPage } from "../chunks/index.js";
+import { Cn as PartnerFavoriteListRead, On as PartnerCategoryListRead, Tn as PartnerFacetsRead, _n as PartnerMediaRead, io as PartnerProvider, mt as ReadPartnerFacetsParams, pt as ReadPartnerHomeParams, sr as ListMediaParams, vn as PartnerMediaPage, xn as PartnerHomeRead } from "../chunks/index.js";
 import { c as request } from "../chunks/client.js";
 //#region src/api/partner-catalogue/partner-catalogue.d.ts
 export declare const getListPartnerCategoriesUrl: (provider: PartnerProvider) => string;
@@ -14,6 +14,16 @@ export declare const getListPartnerCategoriesUrl: (provider: PartnerProvider) =>
  * @summary List Partner Categories
  */
 export declare const listPartnerCategories: (provider: PartnerProvider, options?: Parameters<typeof request>[1]) => Promise<PartnerCategoryListRead>;
+export declare const getReadPartnerFacetsUrl: (provider: PartnerProvider, params?: ReadPartnerFacetsParams) => string;
+/**
+ * Available languages and shelves in this profile's visible catalogue.
+ *
+ * Values are usable directly in ``/media`` filters, including the empty
+ * language value for titles whose provider supplied no language. Each facet
+ * drops its own filter so alternatives remain reachable.
+ * @summary Read Partner Facets
+ */
+export declare const readPartnerFacets: (provider: PartnerProvider, params?: ReadPartnerFacetsParams, options?: Parameters<typeof request>[1]) => Promise<PartnerFacetsRead>;
 export declare const getListPartnerFavoritesUrl: (provider: PartnerProvider) => string;
 /**
  * This reader's bookmarks, filtered to what they may still see.
@@ -45,6 +55,15 @@ export declare const getAddPartnerFavoriteUrl: (provider: PartnerProvider, media
  * @summary Add Partner Favorite
  */
 export declare const addPartnerFavorite: (provider: PartnerProvider, mediaId: number, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getReadPartnerHomeUrl: (provider: PartnerProvider, params?: ReadPartnerHomeParams) => string;
+/**
+ * Visible shelves, favourites and locally saved readings for this profile.
+ *
+ * At most ``limit`` cards per section. No provider request, reader URL, licence
+ * allocation or consumption event is produced by browsing this home.
+ * @summary Read Partner Home
+ */
+export declare const readPartnerHome: (provider: PartnerProvider, params?: ReadPartnerHomeParams, options?: Parameters<typeof request>[1]) => Promise<PartnerHomeRead>;
 export declare const getListMediaUrl: (provider: PartnerProvider, params?: ListMediaParams) => string;
 /**
  * A page of the catalogue.

package/dist/api/partner-catalogue.js

@@ -20,6 +20,28 @@ const listPartnerCategories = async (provider, options) => {
 		method: "GET"
 	});
 };
+const getReadPartnerFacetsUrl = (provider, 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 ? `/partners/${provider}/facets?${stringifiedParams}` : `/partners/${provider}/facets`;
+};
+/**
+* Available languages and shelves in this profile's visible catalogue.
+*
+* Values are usable directly in ``/media`` filters, including the empty
+* language value for titles whose provider supplied no language. Each facet
+* drops its own filter so alternatives remain reachable.
+* @summary Read Partner Facets
+*/
+const readPartnerFacets = async (provider, params, options) => {
+	return request(getReadPartnerFacetsUrl(provider, params), {
+		...options,
+		method: "GET"
+	});
+};
 const getListPartnerFavoritesUrl = (provider) => {
 	return `/partners/${provider}/favorites`;
 };
@@ -72,6 +94,27 @@ const addPartnerFavorite = async (provider, mediaId, options) => {
 		method: "PUT"
 	});
 };
+const getReadPartnerHomeUrl = (provider, 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 ? `/partners/${provider}/home-feed?${stringifiedParams}` : `/partners/${provider}/home-feed`;
+};
+/**
+* Visible shelves, favourites and locally saved readings for this profile.
+*
+* At most ``limit`` cards per section. No provider request, reader URL, licence
+* allocation or consumption event is produced by browsing this home.
+* @summary Read Partner Home
+*/
+const readPartnerHome = async (provider, params, options) => {
+	return request(getReadPartnerHomeUrl(provider, params), {
+		...options,
+		method: "GET"
+	});
+};
 const getListMediaUrl = (provider, params) => {
 	const normalizedParams = new URLSearchParams();
 	Object.entries(params || {}).forEach(([key, value]) => {
@@ -120,6 +163,6 @@ const readMedia = async (provider, mediaId, options) => {
 	});
 };
 //#endregion
-export { addPartnerFavorite, getAddPartnerFavoriteUrl, getListMediaUrl, getListPartnerCategoriesUrl, getListPartnerFavoritesUrl, getReadMediaUrl, getRemovePartnerFavoriteUrl, listMedia, listPartnerCategories, listPartnerFavorites, readMedia, removePartnerFavorite };
+export { addPartnerFavorite, getAddPartnerFavoriteUrl, getListMediaUrl, getListPartnerCategoriesUrl, getListPartnerFavoritesUrl, getReadMediaUrl, getReadPartnerFacetsUrl, getReadPartnerHomeUrl, getRemovePartnerFavoriteUrl, listMedia, listPartnerCategories, listPartnerFavorites, readMedia, readPartnerFacets, readPartnerHome, removePartnerFavorite };
 
 //# sourceMappingURL=partner-catalogue.js.map

package/dist/api/partner-catalogue.js.map

@@ -1 +1 @@
-{"version":3,"file":"partner-catalogue.js","names":[],"sources":["../../src/api/partner-catalogue/partner-catalogue.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.8.3\n */\nimport type {\n  ListMediaParams,\n  PartnerCategoryListRead,\n  PartnerFavoriteListRead,\n  PartnerMediaPage,\n  PartnerMediaRead,\n  PartnerProvider\n} from '../../models';\n\nimport { request } from '../../client';\n\nexport const getListPartnerCategoriesUrl = (provider: PartnerProvider,) => {\n\n\n\n\n  return `/partners/${provider}/categories`\n}\n\n/**\n * The provider's taxonomy, with a count per node for this caller's slice.\n *\n * Counts come from ``partner_category_total`` and are summed across languages,\n * because the menu shows one number and the rollup is keyed per language. A\n * node with no matching rollup row reports ``0`` rather than being hidden: the\n * tree shape is stable, and a branch that vanishes because today's import found\n * nothing in it is harder to reason about than one that reads zero.\n * @summary List Partner Categories\n */\nexport const listPartnerCategories = async (provider: PartnerProvider, options?: Parameters<typeof request>[1]): Promise<PartnerCategoryListRead> => {\n\n  return request<PartnerCategoryListRead>(getListPartnerCategoriesUrl(provider),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getListPartnerFavoritesUrl = (provider: PartnerProvider,) => {\n\n\n\n\n  return `/partners/${provider}/favorites`\n}\n\n/**\n * This reader's bookmarks, filtered to what they may still see.\n *\n * The filter matters: a title can become adult-only, or leave the plan, between\n * being bookmarked and being listed. The legacy joined favourites to media with\n * no visibility predicate at all.\n * @summary List Partner Favorites\n */\nexport const listPartnerFavorites = async (provider: PartnerProvider, options?: Parameters<typeof request>[1]): Promise<PartnerFavoriteListRead> => {\n\n  return request<PartnerFavoriteListRead>(getListPartnerFavoritesUrl(provider),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getRemovePartnerFavoriteUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/favorites/${mediaId}`\n}\n\n/**\n * Remove a bookmark. Idempotent, and deliberately not visibility-filtered.\n *\n * A reader must be able to unbookmark a title they can no longer see —\n * otherwise a media leaving their plan strands a row they have no way to\n * remove.\n * @summary Remove Partner Favorite\n */\nexport const removePartnerFavorite = async (provider: PartnerProvider,\n    mediaId: number, options?: Parameters<typeof request>[1]): Promise<void> => {\n\n  return request<void>(getRemovePartnerFavoriteUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'DELETE'\n\n\n  }\n);}\n\n\nexport const getAddPartnerFavoriteUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/favorites/${mediaId}`\n}\n\n/**\n * Bookmark a title. Idempotent.\n *\n * ``PUT``/``DELETE`` rather than the legacy's ``POST /toggle-favorite.json``. A\n * toggle is not idempotent, and the legacy's had no uniqueness behind it: two\n * tabs toggling at once left two rows, and un-toggling then removed one of\n * them, so the title stayed bookmarked.\n * @summary Add Partner Favorite\n */\nexport const addPartnerFavorite = async (provider: PartnerProvider,\n    mediaId: number, options?: Parameters<typeof request>[1]): Promise<void> => {\n\n  return request<void>(getAddPartnerFavoriteUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'PUT'\n\n\n  }\n);}\n\n\nexport const getListMediaUrl = (provider: PartnerProvider,\n    params?: ListMediaParams,) => {\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 ? `/partners/${provider}/media?${stringifiedParams}` : `/partners/${provider}/media`\n}\n\n/**\n * A page of the catalogue.\n *\n * ``q`` ranks through Elasticsearch and then **intersects** with the same\n * visibility subquery as an unfiltered listing — the index knows nothing about\n * plans or ages, so authorisation happens here whatever the index returns. An\n * index that is missing or unreachable yields no candidates, which reads as an\n * empty page rather than an unfiltered one.\n *\n * A search result keeps the index's ranking rather than applying ``order``:\n * re-sorting relevance by publication date discards the only thing the search\n * contributed. That is why ``order`` is ignored when ``q`` is present, not\n * silently combined with it.\n * @summary List Media\n */\nexport const listMedia = async (provider: PartnerProvider,\n    params?: ListMediaParams, options?: Parameters<typeof request>[1]): Promise<PartnerMediaPage> => {\n\n  return request<PartnerMediaPage>(getListMediaUrl(provider,params),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getReadMediaUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/media/${mediaId}`\n}\n\n/**\n * One title.\n *\n * A media outside the caller's slice is ``404``, not ``403``: whether an adult\n * title exists is itself something a minor's client should not be able to\n * determine, and the legacy's detail page dereferenced an unknown id straight\n * into a 500.\n * @summary Read Media\n */\nexport const readMedia = async (provider: PartnerProvider,\n    mediaId: number, options?: Parameters<typeof request>[1]): Promise<PartnerMediaRead> => {\n\n  return request<PartnerMediaRead>(getReadMediaUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\n"],"mappings":";;;AAkBA,MAAa,+BAA+B,aAA+B;CAKzE,OAAO,aAAa,SAAS;AAC/B;;;;;;;;;;;AAYA,MAAa,wBAAwB,OAAO,UAA2B,YAA8E;CAEnJ,OAAO,QAAiC,4BAA4B,QAAQ,GAC5E;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,8BAA8B,aAA+B;CAKxE,OAAO,aAAa,SAAS;AAC/B;;;;;;;;;AAUA,MAAa,uBAAuB,OAAO,UAA2B,YAA8E;CAElJ,OAAO,QAAiC,2BAA2B,QAAQ,GAC3E;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,+BAA+B,UACxC,YAAqB;CAKvB,OAAO,aAAa,SAAS,aAAa;AAC5C;;;;;;;;;AAUA,MAAa,wBAAwB,OAAO,UACxC,SAAiB,YAA2D;CAE9E,OAAO,QAAc,4BAA4B,UAAS,OAAO,GACjE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,4BAA4B,UACrC,YAAqB;CAKvB,OAAO,aAAa,SAAS,aAAa;AAC5C;;;;;;;;;;AAWA,MAAa,qBAAqB,OAAO,UACrC,SAAiB,YAA2D;CAE9E,OAAO,QAAc,yBAAyB,UAAS,OAAO,GAC9D;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,mBAAmB,UAC5B,WAA8B;CAChC,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,aAAa,SAAS,SAAS,sBAAsB,aAAa,SAAS;AACnH;;;;;;;;;;;;;;;;AAiBA,MAAa,YAAY,OAAO,UAC5B,QAA0B,YAAuE;CAEnG,OAAO,QAA0B,gBAAgB,UAAS,MAAM,GAChE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,mBAAmB,UAC5B,YAAqB;CAKvB,OAAO,aAAa,SAAS,SAAS;AACxC;;;;;;;;;;AAWA,MAAa,YAAY,OAAO,UAC5B,SAAiB,YAAuE;CAE1F,OAAO,QAA0B,gBAAgB,UAAS,OAAO,GACjE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE"}
+{"version":3,"file":"partner-catalogue.js","names":[],"sources":["../../src/api/partner-catalogue/partner-catalogue.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.9.1\n */\nimport type {\n  ListMediaParams,\n  PartnerCategoryListRead,\n  PartnerFacetsRead,\n  PartnerFavoriteListRead,\n  PartnerHomeRead,\n  PartnerMediaPage,\n  PartnerMediaRead,\n  PartnerProvider,\n  ReadPartnerFacetsParams,\n  ReadPartnerHomeParams\n} from '../../models';\n\nimport { request } from '../../client';\n\nexport const getListPartnerCategoriesUrl = (provider: PartnerProvider,) => {\n\n\n\n\n  return `/partners/${provider}/categories`\n}\n\n/**\n * The provider's taxonomy, with a count per node for this caller's slice.\n *\n * Counts come from ``partner_category_total`` and are summed across languages,\n * because the menu shows one number and the rollup is keyed per language. A\n * node with no matching rollup row reports ``0`` rather than being hidden: the\n * tree shape is stable, and a branch that vanishes because today's import found\n * nothing in it is harder to reason about than one that reads zero.\n * @summary List Partner Categories\n */\nexport const listPartnerCategories = async (provider: PartnerProvider, options?: Parameters<typeof request>[1]): Promise<PartnerCategoryListRead> => {\n\n  return request<PartnerCategoryListRead>(getListPartnerCategoriesUrl(provider),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getReadPartnerFacetsUrl = (provider: PartnerProvider,\n    params?: ReadPartnerFacetsParams,) => {\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 ? `/partners/${provider}/facets?${stringifiedParams}` : `/partners/${provider}/facets`\n}\n\n/**\n * Available languages and shelves in this profile's visible catalogue.\n *\n * Values are usable directly in ``/media`` filters, including the empty\n * language value for titles whose provider supplied no language. Each facet\n * drops its own filter so alternatives remain reachable.\n * @summary Read Partner Facets\n */\nexport const readPartnerFacets = async (provider: PartnerProvider,\n    params?: ReadPartnerFacetsParams, options?: Parameters<typeof request>[1]): Promise<PartnerFacetsRead> => {\n\n  return request<PartnerFacetsRead>(getReadPartnerFacetsUrl(provider,params),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getListPartnerFavoritesUrl = (provider: PartnerProvider,) => {\n\n\n\n\n  return `/partners/${provider}/favorites`\n}\n\n/**\n * This reader's bookmarks, filtered to what they may still see.\n *\n * The filter matters: a title can become adult-only, or leave the plan, between\n * being bookmarked and being listed. The legacy joined favourites to media with\n * no visibility predicate at all.\n * @summary List Partner Favorites\n */\nexport const listPartnerFavorites = async (provider: PartnerProvider, options?: Parameters<typeof request>[1]): Promise<PartnerFavoriteListRead> => {\n\n  return request<PartnerFavoriteListRead>(getListPartnerFavoritesUrl(provider),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getRemovePartnerFavoriteUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/favorites/${mediaId}`\n}\n\n/**\n * Remove a bookmark. Idempotent, and deliberately not visibility-filtered.\n *\n * A reader must be able to unbookmark a title they can no longer see —\n * otherwise a media leaving their plan strands a row they have no way to\n * remove.\n * @summary Remove Partner Favorite\n */\nexport const removePartnerFavorite = async (provider: PartnerProvider,\n    mediaId: number, options?: Parameters<typeof request>[1]): Promise<void> => {\n\n  return request<void>(getRemovePartnerFavoriteUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'DELETE'\n\n\n  }\n);}\n\n\nexport const getAddPartnerFavoriteUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/favorites/${mediaId}`\n}\n\n/**\n * Bookmark a title. Idempotent.\n *\n * ``PUT``/``DELETE`` rather than the legacy's ``POST /toggle-favorite.json``. A\n * toggle is not idempotent, and the legacy's had no uniqueness behind it: two\n * tabs toggling at once left two rows, and un-toggling then removed one of\n * them, so the title stayed bookmarked.\n * @summary Add Partner Favorite\n */\nexport const addPartnerFavorite = async (provider: PartnerProvider,\n    mediaId: number, options?: Parameters<typeof request>[1]): Promise<void> => {\n\n  return request<void>(getAddPartnerFavoriteUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'PUT'\n\n\n  }\n);}\n\n\nexport const getReadPartnerHomeUrl = (provider: PartnerProvider,\n    params?: ReadPartnerHomeParams,) => {\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 ? `/partners/${provider}/home-feed?${stringifiedParams}` : `/partners/${provider}/home-feed`\n}\n\n/**\n * Visible shelves, favourites and locally saved readings for this profile.\n *\n * At most ``limit`` cards per section. No provider request, reader URL, licence\n * allocation or consumption event is produced by browsing this home.\n * @summary Read Partner Home\n */\nexport const readPartnerHome = async (provider: PartnerProvider,\n    params?: ReadPartnerHomeParams, options?: Parameters<typeof request>[1]): Promise<PartnerHomeRead> => {\n\n  return request<PartnerHomeRead>(getReadPartnerHomeUrl(provider,params),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getListMediaUrl = (provider: PartnerProvider,\n    params?: ListMediaParams,) => {\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 ? `/partners/${provider}/media?${stringifiedParams}` : `/partners/${provider}/media`\n}\n\n/**\n * A page of the catalogue.\n *\n * ``q`` ranks through Elasticsearch and then **intersects** with the same\n * visibility subquery as an unfiltered listing — the index knows nothing about\n * plans or ages, so authorisation happens here whatever the index returns. An\n * index that is missing or unreachable yields no candidates, which reads as an\n * empty page rather than an unfiltered one.\n *\n * A search result keeps the index's ranking rather than applying ``order``:\n * re-sorting relevance by publication date discards the only thing the search\n * contributed. That is why ``order`` is ignored when ``q`` is present, not\n * silently combined with it.\n * @summary List Media\n */\nexport const listMedia = async (provider: PartnerProvider,\n    params?: ListMediaParams, options?: Parameters<typeof request>[1]): Promise<PartnerMediaPage> => {\n\n  return request<PartnerMediaPage>(getListMediaUrl(provider,params),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getReadMediaUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/media/${mediaId}`\n}\n\n/**\n * One title.\n *\n * A media outside the caller's slice is ``404``, not ``403``: whether an adult\n * title exists is itself something a minor's client should not be able to\n * determine, and the legacy's detail page dereferenced an unknown id straight\n * into a 500.\n * @summary Read Media\n */\nexport const readMedia = async (provider: PartnerProvider,\n    mediaId: number, options?: Parameters<typeof request>[1]): Promise<PartnerMediaRead> => {\n\n  return request<PartnerMediaRead>(getReadMediaUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\n"],"mappings":";;;AAsBA,MAAa,+BAA+B,aAA+B;CAKzE,OAAO,aAAa,SAAS;AAC/B;;;;;;;;;;;AAYA,MAAa,wBAAwB,OAAO,UAA2B,YAA8E;CAEnJ,OAAO,QAAiC,4BAA4B,QAAQ,GAC5E;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,2BAA2B,UACpC,WAAsC;CACxC,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,aAAa,SAAS,UAAU,sBAAsB,aAAa,SAAS;AACpH;;;;;;;;;AAUA,MAAa,oBAAoB,OAAO,UACpC,QAAkC,YAAwE;CAE5G,OAAO,QAA2B,wBAAwB,UAAS,MAAM,GACzE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,8BAA8B,aAA+B;CAKxE,OAAO,aAAa,SAAS;AAC/B;;;;;;;;;AAUA,MAAa,uBAAuB,OAAO,UAA2B,YAA8E;CAElJ,OAAO,QAAiC,2BAA2B,QAAQ,GAC3E;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,+BAA+B,UACxC,YAAqB;CAKvB,OAAO,aAAa,SAAS,aAAa;AAC5C;;;;;;;;;AAUA,MAAa,wBAAwB,OAAO,UACxC,SAAiB,YAA2D;CAE9E,OAAO,QAAc,4BAA4B,UAAS,OAAO,GACjE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,4BAA4B,UACrC,YAAqB;CAKvB,OAAO,aAAa,SAAS,aAAa;AAC5C;;;;;;;;;;AAWA,MAAa,qBAAqB,OAAO,UACrC,SAAiB,YAA2D;CAE9E,OAAO,QAAc,yBAAyB,UAAS,OAAO,GAC9D;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,yBAAyB,UAClC,WAAoC;CACtC,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,aAAa,SAAS,aAAa,sBAAsB,aAAa,SAAS;AACvH;;;;;;;;AASA,MAAa,kBAAkB,OAAO,UAClC,QAAgC,YAAsE;CAExG,OAAO,QAAyB,sBAAsB,UAAS,MAAM,GACrE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,mBAAmB,UAC5B,WAA8B;CAChC,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,aAAa,SAAS,SAAS,sBAAsB,aAAa,SAAS;AACnH;;;;;;;;;;;;;;;;AAiBA,MAAa,YAAY,OAAO,UAC5B,QAA0B,YAAuE;CAEnG,OAAO,QAA0B,gBAAgB,UAAS,MAAM,GAChE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,mBAAmB,UAC5B,YAAqB;CAKvB,OAAO,aAAa,SAAS,SAAS;AACxC;;;;;;;;;;AAWA,MAAa,YAAY,OAAO,UAC5B,SAAiB,YAAuE;CAE1F,OAAO,QAA0B,gBAAgB,UAAS,OAAO,GACjE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE"}

package/dist/api/partner-reader.d.ts

@@ -1,5 +1,5 @@
 
-import { Zi as PartnerProvider, cs as CurrentReadingListRead, dt as ReadPackageParams, gt as ReadingPositionRead, mt as ReadingPositionWrite, yt as ReaderPackageRead } from "../chunks/index.js";
+import { St as ReadingPositionRead, Tt as ReaderPackageRead, bt as ReadingPositionWrite, gt as ReadPackageParams, io as PartnerProvider, mc as CurrentReadingListRead, n as YouScribeAuthRead, t as YouScribeReaderRead } from "../chunks/index.js";
 import { c as request } from "../chunks/client.js";
 //#region src/api/partner-reader/partner-reader.d.ts
 export declare const getReadPackageUrl: (provider: PartnerProvider, mediaId: number, params?: ReadPackageParams) => string;
@@ -23,7 +23,7 @@ export declare const getReadPackageUrl: (provider: PartnerProvider, mediaId: num
 export declare const readPackage: (provider: PartnerProvider, mediaId: number, params?: ReadPackageParams, options?: Parameters<typeof request>[1]) => Promise<ReaderPackageRead>;
 export declare const getReadPositionUrl: (provider: PartnerProvider, mediaId: number) => string;
 /**
- * Where this reader last was, according to the partner.
+ * The last synchronized local position, or the partner's when none is saved.
  *
  * ``404`` when the partner holds no position — a book never opened has no
  * place to return to, and reporting zero would make a client jump a reader who
@@ -33,14 +33,31 @@ export declare const getReadPositionUrl: (provider: PartnerProvider, mediaId: nu
 export declare const readPosition: (provider: PartnerProvider, mediaId: number, options?: Parameters<typeof request>[1]) => Promise<ReadingPositionRead>;
 export declare const getWritePositionUrl: (provider: PartnerProvider, mediaId: number) => string;
 /**
- * Record progress, and report the partner's own metering alongside it.
+ * Synchronize and save progress, with the partner's metering alongside it.
  *
- * ``usage_blocks`` is forwarded first when present, because the legacy did and
- * the partner treats the two as one act: metering after a position update
- * records consumption against a page the reader has already left.
+ * ``usage_blocks`` is forwarded before a new position, matching the legacy's
+ * call order. The two reports are independent: an older position may carry
+ * usage the partner has not received yet.
+ *
+ * Only a strictly newer ``reachedAt`` replaces the saved position. Stale or
+ * duplicate writes return that saved position without updating it upstream.
+ * Provided usage blocks are still forwarded, including on retries; the
+ * partner's deduplication contract is unknown. Conflicting positions at the
+ * same instant return 409 before any outbound write.
+ * Progress is a resume point, not a measurement of time spent reading.
  * @summary Write Position
  */
 export declare const writePosition: (provider: PartnerProvider, mediaId: number, readingPositionWrite: ReadingPositionWrite, options?: Parameters<typeof request>[1]) => Promise<ReadingPositionRead>;
+export declare const getOpenNativeReaderUrl: (provider: PartnerProvider, mediaId: number) => string;
+/**
+ * Authorize a YouScribe native title and open its consumption lease.
+ *
+ * Pass externalId and token to the YouScribe SDK. Mozaik requests keep using
+ * mediaId. Renew lease.eventId while the reader is open and close it when the
+ * reader exits; reopening the same title reuses its active lease.
+ * @summary Open Native Reader
+ */
+export declare const openNativeReader: (provider: PartnerProvider, mediaId: number, options?: Parameters<typeof request>[1]) => Promise<YouScribeReaderRead>;
 export declare const getListCurrentReadingsUrl: (provider: PartnerProvider) => string;
 /**
  * The partner's own "continue reading" list, joined back to our catalogue.
@@ -52,5 +69,16 @@ export declare const getListCurrentReadingsUrl: (provider: PartnerProvider) => s
  * @summary List Current Readings
  */
 export declare const listCurrentReadings: (provider: PartnerProvider, options?: Parameters<typeof request>[1]) => Promise<CurrentReadingListRead>;
+export declare const getReadNativeAuthUrl: (provider: PartnerProvider) => string;
+/**
+ * YouScribe native SDK credentials for the selected, authorized profile.
+ *
+ * Equivalent to the legacy YouScribe user/auth endpoint. This does not create
+ * a licence or a consumption event. Open a title through its reader-auth POST
+ * to obtain the lease used for consumption heartbeats. The token is personal:
+ * never persist it, log it, or share it between profiles.
+ * @summary Read Native Auth
+ */
+export declare const readNativeAuth: (provider: PartnerProvider, options?: Parameters<typeof request>[1]) => Promise<YouScribeAuthRead>;
 //#endregion
 //# sourceMappingURL=partner-reader.d.ts.map

package/dist/api/partner-reader.js

@@ -36,7 +36,7 @@ const getReadPositionUrl = (provider, mediaId) => {
 	return `/partners/${provider}/media/${mediaId}/position`;
 };
 /**
-* Where this reader last was, according to the partner.
+* The last synchronized local position, or the partner's when none is saved.
 *
 * ``404`` when the partner holds no position — a book never opened has no
 * place to return to, and reporting zero would make a client jump a reader who
@@ -53,11 +53,18 @@ const getWritePositionUrl = (provider, mediaId) => {
 	return `/partners/${provider}/media/${mediaId}/position`;
 };
 /**
-* Record progress, and report the partner's own metering alongside it.
+* Synchronize and save progress, with the partner's metering alongside it.
 *
-* ``usage_blocks`` is forwarded first when present, because the legacy did and
-* the partner treats the two as one act: metering after a position update
-* records consumption against a page the reader has already left.
+* ``usage_blocks`` is forwarded before a new position, matching the legacy's
+* call order. The two reports are independent: an older position may carry
+* usage the partner has not received yet.
+*
+* Only a strictly newer ``reachedAt`` replaces the saved position. Stale or
+* duplicate writes return that saved position without updating it upstream.
+* Provided usage blocks are still forwarded, including on retries; the
+* partner's deduplication contract is unknown. Conflicting positions at the
+* same instant return 409 before any outbound write.
+* Progress is a resume point, not a measurement of time spent reading.
 * @summary Write Position
 */
 const writePosition = async (provider, mediaId, readingPositionWrite, options) => {
@@ -79,6 +86,23 @@ const writePosition = async (provider, mediaId, readingPositionWrite, options) =
 		body: JSON.stringify(readingPositionWrite)
 	});
 };
+const getOpenNativeReaderUrl = (provider, mediaId) => {
+	return `/partners/${provider}/media/${mediaId}/reader-auth`;
+};
+/**
+* Authorize a YouScribe native title and open its consumption lease.
+*
+* Pass externalId and token to the YouScribe SDK. Mozaik requests keep using
+* mediaId. Renew lease.eventId while the reader is open and close it when the
+* reader exits; reopening the same title reuses its active lease.
+* @summary Open Native Reader
+*/
+const openNativeReader = async (provider, mediaId, options) => {
+	return request(getOpenNativeReaderUrl(provider, mediaId), {
+		...options,
+		method: "POST"
+	});
+};
 const getListCurrentReadingsUrl = (provider) => {
 	return `/partners/${provider}/readings`;
 };
@@ -97,7 +121,25 @@ const listCurrentReadings = async (provider, options) => {
 		method: "GET"
 	});
 };
+const getReadNativeAuthUrl = (provider) => {
+	return `/partners/${provider}/user/auth`;
+};
+/**
+* YouScribe native SDK credentials for the selected, authorized profile.
+*
+* Equivalent to the legacy YouScribe user/auth endpoint. This does not create
+* a licence or a consumption event. Open a title through its reader-auth POST
+* to obtain the lease used for consumption heartbeats. The token is personal:
+* never persist it, log it, or share it between profiles.
+* @summary Read Native Auth
+*/
+const readNativeAuth = async (provider, options) => {
+	return request(getReadNativeAuthUrl(provider), {
+		...options,
+		method: "GET"
+	});
+};
 //#endregion
-export { getListCurrentReadingsUrl, getReadPackageUrl, getReadPositionUrl, getWritePositionUrl, listCurrentReadings, readPackage, readPosition, writePosition };
+export { getListCurrentReadingsUrl, getOpenNativeReaderUrl, getReadNativeAuthUrl, getReadPackageUrl, getReadPositionUrl, getWritePositionUrl, listCurrentReadings, openNativeReader, readNativeAuth, readPackage, readPosition, writePosition };
 
 //# sourceMappingURL=partner-reader.js.map

package/dist/api/partner-reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"partner-reader.js","names":[],"sources":["../../src/api/partner-reader/partner-reader.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.8.3\n */\nimport type {\n  CurrentReadingListRead,\n  PartnerProvider,\n  ReadPackageParams,\n  ReaderPackageRead,\n  ReadingPositionRead,\n  ReadingPositionWrite\n} from '../../models';\n\nimport { request } from '../../client';\n\nexport const getReadPackageUrl = (provider: PartnerProvider,\n    mediaId: number,\n    params?: ReadPackageParams,) => {\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 ? `/partners/${provider}/media/${mediaId}/package?${stringifiedParams}` : `/partners/${provider}/media/${mediaId}/package`\n}\n\n/**\n * Where to fetch the content itself.\n *\n * The returned URL is a short-lived DRM-wrapped credential. It is not cached\n * here and should not be stored by the client.\n *\n * Opens a consumption lease, so the read appears in the ledger and counts\n * against the establishment's live seats like any other. Its id comes back in\n * ``lease``: keep it alive with ``PUT /consumption/{eventId}`` and drop it with\n * ``DELETE`` when the reader closes. A client that does neither is not broken\n * — the reaper closes the lease about a minute after the last heartbeat — but\n * every such read is a seat held past the end of it.\n *\n * Re-opening the same title returns the lease already held rather than a\n * second one, so a page reload does not leak a seat.\n * @summary Read Package\n */\nexport const readPackage = async (provider: PartnerProvider,\n    mediaId: number,\n    params?: ReadPackageParams, options?: Parameters<typeof request>[1]): Promise<ReaderPackageRead> => {\n\n  return request<ReaderPackageRead>(getReadPackageUrl(provider,mediaId,params),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getReadPositionUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/media/${mediaId}/position`\n}\n\n/**\n * Where this reader last was, according to the partner.\n *\n * ``404`` when the partner holds no position — a book never opened has no\n * place to return to, and reporting zero would make a client jump a reader who\n * *is* mid-book back to the start if the call ever failed soft.\n * @summary Read Position\n */\nexport const readPosition = async (provider: PartnerProvider,\n    mediaId: number, options?: Parameters<typeof request>[1]): Promise<ReadingPositionRead> => {\n\n  return request<ReadingPositionRead>(getReadPositionUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getWritePositionUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/media/${mediaId}/position`\n}\n\n/**\n * Record progress, and report the partner's own metering alongside it.\n *\n * ``usage_blocks`` is forwarded first when present, because the legacy did and\n * the partner treats the two as one act: metering after a position update\n * records consumption against a page the reader has already left.\n * @summary Write Position\n */\nexport const writePosition = async (provider: PartnerProvider,\n    mediaId: number,\n    readingPositionWrite: ReadingPositionWrite, options?: Parameters<typeof request>[1]): Promise<ReadingPositionRead> => {\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<ReadingPositionRead>(getWritePositionUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'PATCH',\n    headers: { 'Content-Type': 'application/json', ...getHeaders(options?.headers) },\n    body: JSON.stringify(readingPositionWrite)\n  }\n);}\n\n\nexport const getListCurrentReadingsUrl = (provider: PartnerProvider,) => {\n\n\n\n\n  return `/partners/${provider}/readings`\n}\n\n/**\n * The partner's own \"continue reading\" list, joined back to our catalogue.\n *\n * Entries the partner knows and our catalogue does not are dropped rather than\n * surfaced with a null id: the import runs nightly and the partner's list is\n * live, so a title added today is genuinely not browsable here yet, and a card\n * that cannot be opened is worse than one that is absent.\n * @summary List Current Readings\n */\nexport const listCurrentReadings = async (provider: PartnerProvider, options?: Parameters<typeof request>[1]): Promise<CurrentReadingListRead> => {\n\n  return request<CurrentReadingListRead>(getListCurrentReadingsUrl(provider),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\n"],"mappings":";;;AAkBA,MAAa,qBAAqB,UAC9B,SACA,WAAgC;CAClC,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,aAAa,SAAS,SAAS,QAAQ,WAAW,sBAAsB,aAAa,SAAS,SAAS,QAAQ;AACvJ;;;;;;;;;;;;;;;;;;AAmBA,MAAa,cAAc,OAAO,UAC9B,SACA,QAA4B,YAAwE;CAEtG,OAAO,QAA2B,kBAAkB,UAAS,SAAQ,MAAM,GAC3E;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,sBAAsB,UAC/B,YAAqB;CAKvB,OAAO,aAAa,SAAS,SAAS,QAAQ;AAChD;;;;;;;;;AAUA,MAAa,eAAe,OAAO,UAC/B,SAAiB,YAA0E;CAE7F,OAAO,QAA6B,mBAAmB,UAAS,OAAO,GACvE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,uBAAuB,UAChC,YAAqB;CAKvB,OAAO,aAAa,SAAS,SAAS,QAAQ;AAChD;;;;;;;;;AAUA,MAAa,gBAAgB,OAAO,UAChC,SACA,sBAA4C,YAA0E;CAEtH,MAAM,cAAc,MAAwF;EAC5G,IAAI,CAAC,GAAG,OAAO,CAAC;EAChB,IAAI,aAAa,SAAS,OAAO,OAAO,YAAY,EAAE,QAAQ,CAAC;EAC/D,IAAI,OAAO,YAAY,GACrB,OAAO,OAAO,YACZ,MAAM,KAAK,IAAkC,UAAU,MAAM,KAAK,KAAK,CAAqB,CAC9F;EAEF,MAAM,UAAsD,CAAC;EAC7D,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAgD,CAAC,GAClF,IAAI,UAAU,KAAA,GAAW,QAAQ,QAAQ;EAE3C,OAAO;CACT;CACF,OAAO,QAA6B,oBAAoB,UAAS,OAAO,GACtE;EACE,GAAG;EACH,QAAQ;EACR,SAAS;GAAE,gBAAgB;GAAoB,GAAG,WAAW,SAAS,OAAO;EAAE;EAC/E,MAAM,KAAK,UAAU,oBAAoB;CAC3C,CACF;AAAE;AAGF,MAAa,6BAA6B,aAA+B;CAKvE,OAAO,aAAa,SAAS;AAC/B;;;;;;;;;;AAWA,MAAa,sBAAsB,OAAO,UAA2B,YAA6E;CAEhJ,OAAO,QAAgC,0BAA0B,QAAQ,GACzE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE"}
+{"version":3,"file":"partner-reader.js","names":[],"sources":["../../src/api/partner-reader/partner-reader.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.9.1\n */\nimport type {\n  CurrentReadingListRead,\n  PartnerProvider,\n  ReadPackageParams,\n  ReaderPackageRead,\n  ReadingPositionRead,\n  ReadingPositionWrite,\n  YouScribeAuthRead,\n  YouScribeReaderRead\n} from '../../models';\n\nimport { request } from '../../client';\n\nexport const getReadPackageUrl = (provider: PartnerProvider,\n    mediaId: number,\n    params?: ReadPackageParams,) => {\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 ? `/partners/${provider}/media/${mediaId}/package?${stringifiedParams}` : `/partners/${provider}/media/${mediaId}/package`\n}\n\n/**\n * Where to fetch the content itself.\n *\n * The returned URL is a short-lived DRM-wrapped credential. It is not cached\n * here and should not be stored by the client.\n *\n * Opens a consumption lease, so the read appears in the ledger and counts\n * against the establishment's live seats like any other. Its id comes back in\n * ``lease``: keep it alive with ``PUT /consumption/{eventId}`` and drop it with\n * ``DELETE`` when the reader closes. A client that does neither is not broken\n * — the reaper closes the lease about a minute after the last heartbeat — but\n * every such read is a seat held past the end of it.\n *\n * Re-opening the same title returns the lease already held rather than a\n * second one, so a page reload does not leak a seat.\n * @summary Read Package\n */\nexport const readPackage = async (provider: PartnerProvider,\n    mediaId: number,\n    params?: ReadPackageParams, options?: Parameters<typeof request>[1]): Promise<ReaderPackageRead> => {\n\n  return request<ReaderPackageRead>(getReadPackageUrl(provider,mediaId,params),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getReadPositionUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/media/${mediaId}/position`\n}\n\n/**\n * The last synchronized local position, or the partner's when none is saved.\n *\n * ``404`` when the partner holds no position — a book never opened has no\n * place to return to, and reporting zero would make a client jump a reader who\n * *is* mid-book back to the start if the call ever failed soft.\n * @summary Read Position\n */\nexport const readPosition = async (provider: PartnerProvider,\n    mediaId: number, options?: Parameters<typeof request>[1]): Promise<ReadingPositionRead> => {\n\n  return request<ReadingPositionRead>(getReadPositionUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getWritePositionUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/media/${mediaId}/position`\n}\n\n/**\n * Synchronize and save progress, with the partner's metering alongside it.\n *\n * ``usage_blocks`` is forwarded before a new position, matching the legacy's\n * call order. The two reports are independent: an older position may carry\n * usage the partner has not received yet.\n *\n * Only a strictly newer ``reachedAt`` replaces the saved position. Stale or\n * duplicate writes return that saved position without updating it upstream.\n * Provided usage blocks are still forwarded, including on retries; the\n * partner's deduplication contract is unknown. Conflicting positions at the\n * same instant return 409 before any outbound write.\n * Progress is a resume point, not a measurement of time spent reading.\n * @summary Write Position\n */\nexport const writePosition = async (provider: PartnerProvider,\n    mediaId: number,\n    readingPositionWrite: ReadingPositionWrite, options?: Parameters<typeof request>[1]): Promise<ReadingPositionRead> => {\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<ReadingPositionRead>(getWritePositionUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'PATCH',\n    headers: { 'Content-Type': 'application/json', ...getHeaders(options?.headers) },\n    body: JSON.stringify(readingPositionWrite)\n  }\n);}\n\n\nexport const getOpenNativeReaderUrl = (provider: PartnerProvider,\n    mediaId: number,) => {\n\n\n\n\n  return `/partners/${provider}/media/${mediaId}/reader-auth`\n}\n\n/**\n * Authorize a YouScribe native title and open its consumption lease.\n *\n * Pass externalId and token to the YouScribe SDK. Mozaik requests keep using\n * mediaId. Renew lease.eventId while the reader is open and close it when the\n * reader exits; reopening the same title reuses its active lease.\n * @summary Open Native Reader\n */\nexport const openNativeReader = async (provider: PartnerProvider,\n    mediaId: number, options?: Parameters<typeof request>[1]): Promise<YouScribeReaderRead> => {\n\n  return request<YouScribeReaderRead>(getOpenNativeReaderUrl(provider,mediaId),\n  {\n    ...options,\n    method: 'POST'\n\n\n  }\n);}\n\n\nexport const getListCurrentReadingsUrl = (provider: PartnerProvider,) => {\n\n\n\n\n  return `/partners/${provider}/readings`\n}\n\n/**\n * The partner's own \"continue reading\" list, joined back to our catalogue.\n *\n * Entries the partner knows and our catalogue does not are dropped rather than\n * surfaced with a null id: the import runs nightly and the partner's list is\n * live, so a title added today is genuinely not browsable here yet, and a card\n * that cannot be opened is worse than one that is absent.\n * @summary List Current Readings\n */\nexport const listCurrentReadings = async (provider: PartnerProvider, options?: Parameters<typeof request>[1]): Promise<CurrentReadingListRead> => {\n\n  return request<CurrentReadingListRead>(getListCurrentReadingsUrl(provider),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\nexport const getReadNativeAuthUrl = (provider: PartnerProvider,) => {\n\n\n\n\n  return `/partners/${provider}/user/auth`\n}\n\n/**\n * YouScribe native SDK credentials for the selected, authorized profile.\n *\n * Equivalent to the legacy YouScribe user/auth endpoint. This does not create\n * a licence or a consumption event. Open a title through its reader-auth POST\n * to obtain the lease used for consumption heartbeats. The token is personal:\n * never persist it, log it, or share it between profiles.\n * @summary Read Native Auth\n */\nexport const readNativeAuth = async (provider: PartnerProvider, options?: Parameters<typeof request>[1]): Promise<YouScribeAuthRead> => {\n\n  return request<YouScribeAuthRead>(getReadNativeAuthUrl(provider),\n  {\n    ...options,\n    method: 'GET'\n\n\n  }\n);}\n\n\n"],"mappings":";;;AAoBA,MAAa,qBAAqB,UAC9B,SACA,WAAgC;CAClC,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,aAAa,SAAS,SAAS,QAAQ,WAAW,sBAAsB,aAAa,SAAS,SAAS,QAAQ;AACvJ;;;;;;;;;;;;;;;;;;AAmBA,MAAa,cAAc,OAAO,UAC9B,SACA,QAA4B,YAAwE;CAEtG,OAAO,QAA2B,kBAAkB,UAAS,SAAQ,MAAM,GAC3E;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,sBAAsB,UAC/B,YAAqB;CAKvB,OAAO,aAAa,SAAS,SAAS,QAAQ;AAChD;;;;;;;;;AAUA,MAAa,eAAe,OAAO,UAC/B,SAAiB,YAA0E;CAE7F,OAAO,QAA6B,mBAAmB,UAAS,OAAO,GACvE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,uBAAuB,UAChC,YAAqB;CAKvB,OAAO,aAAa,SAAS,SAAS,QAAQ;AAChD;;;;;;;;;;;;;;;;AAiBA,MAAa,gBAAgB,OAAO,UAChC,SACA,sBAA4C,YAA0E;CAEtH,MAAM,cAAc,MAAwF;EAC5G,IAAI,CAAC,GAAG,OAAO,CAAC;EAChB,IAAI,aAAa,SAAS,OAAO,OAAO,YAAY,EAAE,QAAQ,CAAC;EAC/D,IAAI,OAAO,YAAY,GACrB,OAAO,OAAO,YACZ,MAAM,KAAK,IAAkC,UAAU,MAAM,KAAK,KAAK,CAAqB,CAC9F;EAEF,MAAM,UAAsD,CAAC;EAC7D,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAgD,CAAC,GAClF,IAAI,UAAU,KAAA,GAAW,QAAQ,QAAQ;EAE3C,OAAO;CACT;CACF,OAAO,QAA6B,oBAAoB,UAAS,OAAO,GACtE;EACE,GAAG;EACH,QAAQ;EACR,SAAS;GAAE,gBAAgB;GAAoB,GAAG,WAAW,SAAS,OAAO;EAAE;EAC/E,MAAM,KAAK,UAAU,oBAAoB;CAC3C,CACF;AAAE;AAGF,MAAa,0BAA0B,UACnC,YAAqB;CAKvB,OAAO,aAAa,SAAS,SAAS,QAAQ;AAChD;;;;;;;;;AAUA,MAAa,mBAAmB,OAAO,UACnC,SAAiB,YAA0E;CAE7F,OAAO,QAA6B,uBAAuB,UAAS,OAAO,GAC3E;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,6BAA6B,aAA+B;CAKvE,OAAO,aAAa,SAAS;AAC/B;;;;;;;;;;AAWA,MAAa,sBAAsB,OAAO,UAA2B,YAA6E;CAEhJ,OAAO,QAAgC,0BAA0B,QAAQ,GACzE;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE;AAGF,MAAa,wBAAwB,aAA+B;CAKlE,OAAO,aAAa,SAAS;AAC/B;;;;;;;;;;AAWA,MAAa,iBAAiB,OAAO,UAA2B,YAAwE;CAEtI,OAAO,QAA2B,qBAAqB,QAAQ,GAC/D;EACE,GAAG;EACH,QAAQ;CAGV,CACF;AAAE"}

package/dist/api/profiles.d.ts

@@ -1,64 +1,117 @@
 
-import { Dt as ProfileCreateWrite, Et as ProfileRead, Tt as ProfileListRead, wt as ProfileUpdateWrite } from "../chunks/index.js";
+import { At as ProfileUpdateWrite, Fr as IndependentInvitationWrite, Ft as ProfileRead, Mt as ProfileSessionRead, Pn as OpenChildProfileWrite, Pt as ProfileListRead, Rt as ProfileCreateWrite, _i as GuardianPinWrite, ci as HouseholdGuardianListRead, ii as HouseholdInvitationRead, ji as ExitChildProfileWrite, ni as HouseholdInvitationWrite, oi as HouseholdInvitationAcceptWrite, ri as HouseholdInvitationListRead, si as HouseholdGuardianWrite, vi as GuardianPinResetWrite, yi as GuardianPinResetRead } from "../chunks/index.js";
 import { c as request } from "../chunks/client.js";
 //#region src/api/profiles/profiles.d.ts
+export declare const getSetPinUrl: () => string;
+/**
+ * @summary Set Pin
+ */
+export declare const setPin: (guardianPinWrite: GuardianPinWrite, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getRequestResetUrl: () => string;
+/**
+ * @summary Request Reset
+ */
+export declare const requestReset: (options?: Parameters<typeof request>[1]) => Promise<GuardianPinResetRead>;
+export declare const getConfirmResetUrl: () => string;
+/**
+ * @summary Confirm Reset
+ */
+export declare const confirmReset: (guardianPinResetWrite: GuardianPinResetWrite, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getProfileSessionUrl: () => string;
+/**
+ * @summary Profile Session
+ */
+export declare const profileSession: (options?: Parameters<typeof request>[1]) => Promise<ProfileSessionRead>;
+export declare const getOpenChildUrl: () => string;
+/**
+ * @summary Open Child
+ */
+export declare const openChild: (openChildProfileWrite: OpenChildProfileWrite, options?: Parameters<typeof request>[1]) => Promise<ProfileSessionRead>;
+export declare const getExitChildUrl: () => string;
+/**
+ * @summary Exit Child
+ */
+export declare const exitChild: (exitChildProfileWrite: ExitChildProfileWrite, options?: Parameters<typeof request>[1]) => Promise<ProfileSessionRead>;
 export declare const getListProfilesUrl: () => string;
 /**
- * Every profile on this account, the holder included (E20).
+ * Holder sees household cards; another adult sees self and supervised children.
  *
- * Unpaginated: the cap is :data:`PROFILE_LIMIT`, so there is no page to turn.
- * One endpoint replaces two legacy routes that rendered the same collection
- * differently — the difference was presentation, which is the client's problem.
+ * Cards never grant the right to open another adult's profile. Expired pending
+ * invitations remain manageable but no longer reserve capacity.
  * @summary List Profiles
  */
 export declare const listProfiles: (options?: Parameters<typeof request>[1]) => Promise<ProfileListRead>;
 export declare const getCreateProfileUrl: () => string;
 /**
- * Add a profile to this account (E21).
- *
- * The new row inherits ``tenant_id`` from the holder rather than accepting one:
- * a profile belongs to the same company as the account it hangs off, and
- * letting that be supplied would be a way into another tenant.
- *
- * A profile has no credential of its own. It has no ``login``, no ``email`` and
- * no password — it is reached by switching within an authenticated session, so
- * there is nothing for it to authenticate *with*.
  * @summary Create Profile
  */
 export declare const createProfile: (profileCreateWrite: ProfileCreateWrite, options?: Parameters<typeof request>[1]) => Promise<ProfileRead>;
+export declare const getGuardianCandidatesUrl: () => string;
+/**
+ * @summary Guardian Candidates
+ */
+export declare const guardianCandidates: (options?: Parameters<typeof request>[1]) => Promise<HouseholdGuardianListRead>;
+export declare const getListInvitationsUrl: () => string;
+/**
+ * @summary List Invitations
+ */
+export declare const listInvitations: (options?: Parameters<typeof request>[1]) => Promise<HouseholdInvitationListRead>;
+export declare const getInviteAdultUrl: () => string;
+/**
+ * @summary Invite Adult
+ */
+export declare const inviteAdult: (householdInvitationWrite: HouseholdInvitationWrite, options?: Parameters<typeof request>[1]) => Promise<HouseholdInvitationRead>;
+export declare const getAcceptInvitationUrl: () => string;
+/**
+ * Requires a verified login email; never creates an unrelated root account.
+ * @summary Accept Invitation
+ */
+export declare const acceptInvitation: (householdInvitationAcceptWrite: HouseholdInvitationAcceptWrite, options?: Parameters<typeof request>[1]) => Promise<ProfileRead>;
+export declare const getRevokeInvitationUrl: (invitationId: number) => string;
+/**
+ * @summary Revoke Invitation
+ */
+export declare const revokeInvitation: (invitationId: number, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getResendInvitationUrl: (invitationId: number) => string;
+/**
+ * @summary Resend Invitation
+ */
+export declare const resendInvitation: (invitationId: number, options?: Parameters<typeof request>[1]) => Promise<HouseholdInvitationRead>;
 export declare const getDeleteProfileUrl: (profileId: number) => string;
 /**
- * Remove a profile (E24). Idempotent.
- *
- * Deleting a profile that is already gone is ``204``, not ``404``: the caller
- * asked for it to be absent and it is absent. A retried delete after a timeout
- * must not read as a failure.
- *
- * The account holder cannot be deleted this way — that is E17, which anonymises
- * the whole account and is a different decision with different consequences.
+ * Deactivate membership without discarding profile history or its ancestry.
  * @summary Delete Profile
  */
 export declare const deleteProfile: (profileId: number, options?: Parameters<typeof request>[1]) => Promise<void>;
 export declare const getReadProfileUrl: (profileId: number) => string;
 /**
- * One profile (E22). Returns the resource; the legacy rendered an edit form.
  * @summary Read Profile
  */
 export declare const readProfile: (profileId: number, options?: Parameters<typeof request>[1]) => Promise<ProfileRead>;
 export declare const getUpdateProfileUrl: (profileId: number) => string;
 /**
- * Partially update a profile (E23).
- *
- * The target comes from the path and the row is re-read from the database
- * before anything is written, so nothing in the body can retarget the write.
- * That is the one habit worth keeping from the legacy handler, which overwrote
- * the identity fields from the trusted record for exactly this reason.
- *
- * ``exclude_unset`` is what makes this a PATCH rather than a PUT wearing the
- * wrong verb: a field the client did not send is untouched, which is not the
- * same as a field it sent as null.
  * @summary Update Profile
  */
 export declare const updateProfile: (profileId: number, profileUpdateWrite: ProfileUpdateWrite, options?: Parameters<typeof request>[1]) => Promise<ProfileRead>;
+export declare const getListGuardiansUrl: (profileId: number) => string;
+/**
+ * @summary List Guardians
+ */
+export declare const listGuardians: (profileId: number, options?: Parameters<typeof request>[1]) => Promise<HouseholdGuardianListRead>;
+export declare const getAddGuardianUrl: (profileId: number) => string;
+/**
+ * @summary Add Guardian
+ */
+export declare const addGuardian: (profileId: number, householdGuardianWrite: HouseholdGuardianWrite, options?: Parameters<typeof request>[1]) => Promise<HouseholdGuardianListRead>;
+export declare const getRemoveGuardianUrl: (profileId: number, adultId: number) => string;
+/**
+ * @summary Remove Guardian
+ */
+export declare const removeGuardian: (profileId: number, adultId: number, options?: Parameters<typeof request>[1]) => Promise<void>;
+export declare const getInviteIndependentMinorUrl: (profileId: number) => string;
+/**
+ * @summary Invite Independent Minor
+ */
+export declare const inviteIndependentMinor: (profileId: number, independentInvitationWrite: IndependentInvitationWrite, options?: Parameters<typeof request>[1]) => Promise<HouseholdInvitationRead>;
 //#endregion
 //# sourceMappingURL=profiles.d.ts.map