@learnorama/mozaik-sdk 0.12.3-staging.46.1 → 0.13.0-staging.48.1

package/dist/react/biblio-billing.js

@@ -0,0 +1,1491 @@
+"use client";
+import { r as request } from "../chunks/client.js";
+import { useMutation, useQuery } from "@tanstack/react-query";
+//#region src/react/biblio-billing/biblio-billing.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.13.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 getBillingCreateProductUrl = (catalogueId) => {
+	return `/billing/catalogues/${catalogueId}/products`;
+};
+/**
+* A global commercial operator creates an offer and its server-owned net price/tax. New offers default to inactive. Fixed offers need accessMonths or an institutional template; recurring offers cannot use a template. Retention offers require the customer's dated agreement. Requires high-assurance authentication.
+* @summary Create a catalogue billing offer
+*/
+const billingCreateProduct = async (catalogueId, billingProductWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingCreateProductUrl(catalogueId), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(billingProductWrite)
+	});
+};
+const getBillingCreateProductMutationKey = () => ["billingCreateProduct"];
+const getBillingCreateProductMutationOptions = (options) => {
+	const mutationKey = getBillingCreateProductMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { catalogueId, data } = props ?? {};
+		return billingCreateProduct(catalogueId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Create a catalogue billing offer
+*/
+const useBillingCreateProduct = (options, queryClient) => {
+	return useMutation(getBillingCreateProductMutationOptions(options), queryClient);
+};
+const getBillingGeneratePromotionsUrl = (catalogueId) => {
+	return `/billing/catalogues/${catalogueId}/promotion-batches`;
+};
+/**
+* Create 1–500 independent rules and encrypted distribution codes atomically from one reviewed template. Each code is the optional prefix followed by 20 unambiguous characters; rule.code must be null. rule.quantity is stock per generated rule, not the number of codes. Requires global commercial authority. Requires high-assurance authentication.
+* @summary Generate a bounded promotion-code batch
+*/
+const billingGeneratePromotions = async (catalogueId, promotionGeneratorWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingGeneratePromotionsUrl(catalogueId), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(promotionGeneratorWrite)
+	});
+};
+const getBillingGeneratePromotionsMutationKey = () => ["billingGeneratePromotions"];
+const getBillingGeneratePromotionsMutationOptions = (options) => {
+	const mutationKey = getBillingGeneratePromotionsMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { catalogueId, data } = props ?? {};
+		return billingGeneratePromotions(catalogueId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Generate a bounded promotion-code batch
+*/
+const useBillingGeneratePromotions = (options, queryClient) => {
+	return useMutation(getBillingGeneratePromotionsMutationOptions(options), queryClient);
+};
+const getBillingPromotionGeneratorsUrl = (catalogueId, 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 ? `/billing/catalogues/${catalogueId}/promotion-generators?${stringifiedParams}` : `/billing/catalogues/${catalogueId}/promotion-generators`;
+};
+/**
+* Global commercial operators list safe generator definitions, newest first. Includes historical sourceMask and partial rule fields when known; codes and private source metadata require a separate audited export.
+* @summary List catalogue promotion generators
+*/
+const billingPromotionGenerators = async (catalogueId, params, options) => {
+	return request(getBillingPromotionGeneratorsUrl(catalogueId, params), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingPromotionGeneratorsQueryKey = (catalogueId, params) => {
+	return [`/billing/catalogues/${catalogueId}/promotion-generators`, ...params ? [params] : []];
+};
+const getBillingPromotionGeneratorsQueryOptions = (catalogueId, params, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingPromotionGeneratorsQueryKey(catalogueId, params);
+	const queryFn = ({ signal }) => billingPromotionGenerators(catalogueId, params, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: catalogueId !== null && catalogueId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary List catalogue promotion generators
+*/
+function useBillingPromotionGenerators(catalogueId, params, options, queryClient) {
+	const queryOptions = getBillingPromotionGeneratorsQueryOptions(catalogueId, params, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingListPromotionsUrl = (catalogueId, 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 ? `/billing/catalogues/${catalogueId}/promotions?${stringifiedParams}` : `/billing/catalogues/${catalogueId}/promotions`;
+};
+/**
+* Catalogue finance operators list rule metadata, including inactive rules, ordered by promotion ID. Codes are deliberately omitted; explicit audited reveal or export is required to distribute codes.
+* @summary List catalogue promotion rules
+*/
+const billingListPromotions = async (catalogueId, params, options) => {
+	return request(getBillingListPromotionsUrl(catalogueId, params), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingListPromotionsQueryKey = (catalogueId, params) => {
+	return [`/billing/catalogues/${catalogueId}/promotions`, ...params ? [params] : []];
+};
+const getBillingListPromotionsQueryOptions = (catalogueId, params, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingListPromotionsQueryKey(catalogueId, params);
+	const queryFn = ({ signal }) => billingListPromotions(catalogueId, params, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: catalogueId !== null && catalogueId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary List catalogue promotion rules
+*/
+function useBillingListPromotions(catalogueId, params, options, queryClient) {
+	const queryOptions = getBillingListPromotionsQueryOptions(catalogueId, params, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingCreatePromotionUrl = (catalogueId) => {
+	return `/billing/catalogues/${catalogueId}/promotions`;
+};
+/**
+* A global commercial operator creates bounded promotion stock for a catalogue. Discounts apply to explicit checkouts; benefits without payment-method requirements can be redeemed directly. Null code generates three groups of six unambiguous characters. Explicit codes retain their display form; lookup uses NFKC, trim and casefold normalization. Targets must belong to the catalogue. Requires high-assurance authentication.
+* @summary Create a discount or access benefit
+*/
+const billingCreatePromotion = async (catalogueId, promotionWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingCreatePromotionUrl(catalogueId), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(promotionWrite)
+	});
+};
+const getBillingCreatePromotionMutationKey = () => ["billingCreatePromotion"];
+const getBillingCreatePromotionMutationOptions = (options) => {
+	const mutationKey = getBillingCreatePromotionMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { catalogueId, data } = props ?? {};
+		return billingCreatePromotion(catalogueId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Create a discount or access benefit
+*/
+const useBillingCreatePromotion = (options, queryClient) => {
+	return useMutation(getBillingCreatePromotionMutationOptions(options), queryClient);
+};
+const getBillingExportPromotionCodesUrl = (catalogueId) => {
+	return `/billing/catalogues/${catalogueId}/promotions/export`;
+};
+/**
+* Global commercial operators decrypt selected catalogue codes in one audited transaction. Supply unique promotionIds and a reason; all IDs must belong to the selected catalogue or the entire export is refused. The JSON data is ordered by promotion ID. Responses are private, no-store. Requires high-assurance authentication.
+* @summary Export selected promotion codes with an audit reason
+*/
+const billingExportPromotionCodes = async (catalogueId, promotionExportWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingExportPromotionCodesUrl(catalogueId), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(promotionExportWrite)
+	});
+};
+const getBillingExportPromotionCodesMutationKey = () => ["billingExportPromotionCodes"];
+const getBillingExportPromotionCodesMutationOptions = (options) => {
+	const mutationKey = getBillingExportPromotionCodesMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { catalogueId, data } = props ?? {};
+		return billingExportPromotionCodes(catalogueId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Export selected promotion codes with an audit reason
+*/
+const useBillingExportPromotionCodes = (options, queryClient) => {
+	return useMutation(getBillingExportPromotionCodesMutationOptions(options), queryClient);
+};
+const getBillingQuoteCheckoutUrl = () => {
+	return `/billing/checkouts`;
+};
+/**
+* Freeze server-priced purchase and renewal terms for 15 minutes and reserve promotion stock. Reuse requestKey with the same product and normalized promotion set to retrieve the same checkout; changing either under the same key returns 409. No payment is submitted by quoting. Display recurring, renewalAmount and expiresAt before obtaining consent. A fully discounted offer without a required payment method can become fixed access without renewal. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Quote a personal checkout
+*/
+const billingQuoteCheckout = async (billingQuoteWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingQuoteCheckoutUrl(), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(billingQuoteWrite)
+	});
+};
+const getBillingQuoteCheckoutMutationKey = () => ["billingQuoteCheckout"];
+const getBillingQuoteCheckoutMutationOptions = (options) => {
+	const mutationKey = getBillingQuoteCheckoutMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { data } = props ?? {};
+		return billingQuoteCheckout(data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Quote a personal checkout
+*/
+const useBillingQuoteCheckout = (options, queryClient) => {
+	return useMutation(getBillingQuoteCheckoutMutationOptions(options), queryClient);
+};
+const getBillingReadCheckoutUrl = (checkoutId) => {
+	return `/billing/checkouts/${checkoutId}`;
+};
+/**
+* Return persisted quote and outcome without contacting the payment provider. A submitting or unknown checkout requires the explicit reconcile operation; reading it does not retry payment. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached.
+* @summary Read the current profile's checkout
+*/
+const billingReadCheckout = async (checkoutId, options) => {
+	return request(getBillingReadCheckoutUrl(checkoutId), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingReadCheckoutQueryKey = (checkoutId) => {
+	return [`/billing/checkouts/${checkoutId}`];
+};
+const getBillingReadCheckoutQueryOptions = (checkoutId, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingReadCheckoutQueryKey(checkoutId);
+	const queryFn = ({ signal }) => billingReadCheckout(checkoutId, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: checkoutId !== null && checkoutId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary Read the current profile's checkout
+*/
+function useBillingReadCheckout(checkoutId, options, queryClient) {
+	const queryOptions = getBillingReadCheckoutQueryOptions(checkoutId, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingReconcileCheckoutUrl = (checkoutId) => {
+	return `/billing/checkouts/${checkoutId}/reconcile`;
+};
+/**
+* Look up provider evidence using the checkout's existing operation identity and complete the same purchase when a matching receipt is found. This never resubmits payment. An absent receipt leaves the checkout submitting or unknown; terminal and quoted states are returned unchanged. Environment and quote integrity must match before access can be granted. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Reconcile an uncertain checkout
+*/
+const billingReconcileCheckout = async (checkoutId, options) => {
+	return request(getBillingReconcileCheckoutUrl(checkoutId), {
+		...options,
+		method: "POST"
+	});
+};
+const getBillingReconcileCheckoutMutationKey = () => ["billingReconcileCheckout"];
+const getBillingReconcileCheckoutMutationOptions = (options) => {
+	const mutationKey = getBillingReconcileCheckoutMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { checkoutId } = props ?? {};
+		return billingReconcileCheckout(checkoutId, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Reconcile an uncertain checkout
+*/
+const useBillingReconcileCheckout = (options, queryClient) => {
+	return useMutation(getBillingReconcileCheckoutMutationOptions(options), queryClient);
+};
+const getBillingSubmitCheckoutUrl = (checkoutId) => {
+	return `/billing/checkouts/${checkoutId}/submit`;
+};
+/**
+* Submit the owned quote with acceptedTerms=true and a single-use provider nonce when payment or renewal requires it. Completed, submitting and unknown checkouts are returned without another charge. HTTP 200 alone does not mean payment succeeded: complete confirms the receipt, failed records a refusal, and unknown preserves an ambiguous provider outcome. Reconcile the same checkout after uncertainty; do not create a replacement payment. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Submit an accepted checkout
+*/
+const billingSubmitCheckout = async (checkoutId, billingCheckoutSubmitWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingSubmitCheckoutUrl(checkoutId), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(billingCheckoutSubmitWrite)
+	});
+};
+const getBillingSubmitCheckoutMutationKey = () => ["billingSubmitCheckout"];
+const getBillingSubmitCheckoutMutationOptions = (options) => {
+	const mutationKey = getBillingSubmitCheckoutMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { checkoutId, data } = props ?? {};
+		return billingSubmitCheckout(checkoutId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Submit an accepted checkout
+*/
+const useBillingSubmitCheckout = (options, queryClient) => {
+	return useMutation(getBillingSubmitCheckoutMutationOptions(options), queryClient);
+};
+const getBillingCreateClientTokenUrl = () => {
+	return `/billing/client-token`;
+};
+/**
+* Obtain a Braintree client token for an owned, unexpired quoted checkout in the current environment. Pass it to the provider SDK to collect a single-use paymentMethodNonce, then submit the checkout. The token is sensitive and must not be logged or persisted in client analytics. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Create a checkout payment client token
+*/
+const billingCreateClientToken = async (billingClientTokenWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingCreateClientTokenUrl(), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(billingClientTokenWrite)
+	});
+};
+const getBillingCreateClientTokenMutationKey = () => ["billingCreateClientToken"];
+const getBillingCreateClientTokenMutationOptions = (options) => {
+	const mutationKey = getBillingCreateClientTokenMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { data } = props ?? {};
+		return billingCreateClientToken(data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Create a checkout payment client token
+*/
+const useBillingCreateClientToken = (options, queryClient) => {
+	return useMutation(getBillingCreateClientTokenMutationOptions(options), queryClient);
+};
+const getBillingPrepareIdentityUrl = () => {
+	return `/billing/identity`;
+};
+/**
+* Return or create the stable server-issued billing subject for the selected provider in the configured environment. Supply this subject to the mobile billing SDK; never substitute a profile ID or email. This explicit request does not grant course access or charge a payment method. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Prepare the current profile's billing identity
+*/
+const billingPrepareIdentity = async (billingIdentityWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingPrepareIdentityUrl(), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(billingIdentityWrite)
+	});
+};
+const getBillingPrepareIdentityMutationKey = () => ["billingPrepareIdentity"];
+const getBillingPrepareIdentityMutationOptions = (options) => {
+	const mutationKey = getBillingPrepareIdentityMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { data } = props ?? {};
+		return billingPrepareIdentity(data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Prepare the current profile's billing identity
+*/
+const useBillingPrepareIdentity = (options, queryClient) => {
+	return useMutation(getBillingPrepareIdentityMutationOptions(options), queryClient);
+};
+const getBillingListProductsUrl = (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 ? `/billing/products?${stringifiedParams}` : `/billing/products`;
+};
+/**
+* List active offers visible to the profile, with server-calculated tax-inclusive prices. Retention offers appear only within seven days of their exact institution agreement's end. checkoutAvailable reflects configured web payment capability; providerProducts identifies active mappings in the current billing environment. Listing never starts a purchase. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached.
+* @summary List personal purchase offers
+*/
+const billingListProducts = async (params, options) => {
+	return request(getBillingListProductsUrl(params), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingListProductsQueryKey = (params) => {
+	return [`/billing/products`, ...params ? [params] : []];
+};
+const getBillingListProductsQueryOptions = (params, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingListProductsQueryKey(params);
+	const queryFn = ({ signal }) => billingListProducts(params, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		...queryOptions
+	};
+};
+/**
+* @summary List personal purchase offers
+*/
+function useBillingListProducts(params, options, queryClient) {
+	const queryOptions = getBillingListProductsQueryOptions(params, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingSetOfferAvailabilityUrl = (productId) => {
+	return `/billing/products/${productId}/availability`;
+};
+/**
+* Set offer availability after commercial review and record the reason in the audit trail. Requires catalogue finance and global commercial authority. Returns 204 with no response body. Requires high-assurance authentication.
+* @summary Activate or withdraw an offer
+*/
+const billingSetOfferAvailability = async (productId, billingProductAvailabilityWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingSetOfferAvailabilityUrl(productId), {
+		...options,
+		method: "PUT",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(billingProductAvailabilityWrite)
+	});
+};
+const getBillingSetOfferAvailabilityMutationKey = () => ["billingSetOfferAvailability"];
+const getBillingSetOfferAvailabilityMutationOptions = (options) => {
+	const mutationKey = getBillingSetOfferAvailabilityMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { productId, data } = props ?? {};
+		return billingSetOfferAvailability(productId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Activate or withdraw an offer
+*/
+const useBillingSetOfferAvailability = (options, queryClient) => {
+	return useMutation(getBillingSetOfferAvailabilityMutationOptions(options), queryClient);
+};
+const getBillingBindProviderProductUrl = (productId) => {
+	return `/billing/products/${productId}/provider`;
+};
+/**
+* Catalogue finance operators associate an offer with an exact provider product and sandbox or production environment. A provider/environment/product identifier cannot be shared by different offers. Store products must be public recurring offers. Returns 204 with no response body. Requires high-assurance authentication.
+* @summary Bind an offer to a provider product
+*/
+const billingBindProviderProduct = async (productId, billingProviderProductWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingBindProviderProductUrl(productId), {
+		...options,
+		method: "PUT",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(billingProviderProductWrite)
+	});
+};
+const getBillingBindProviderProductMutationKey = () => ["billingBindProviderProduct"];
+const getBillingBindProviderProductMutationOptions = (options) => {
+	const mutationKey = getBillingBindProviderProductMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { productId, data } = props ?? {};
+		return billingBindProviderProduct(productId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Bind an offer to a provider product
+*/
+const useBillingBindProviderProduct = (options, queryClient) => {
+	return useMutation(getBillingBindProviderProductMutationOptions(options), queryClient);
+};
+const getBillingPromotionGeneratorUrl = (generatorId) => {
+	return `/billing/promotion-generators/${generatorId}`;
+};
+/**
+* Return a safe definition to a global commercial operator. batchSize counts generated codes while rule.quantity describes permitted uses of each code. Historical missing rule values stay null.
+* @summary Read a promotion generator definition
+*/
+const billingPromotionGenerator = async (generatorId, options) => {
+	return request(getBillingPromotionGeneratorUrl(generatorId), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingPromotionGeneratorQueryKey = (generatorId) => {
+	return [`/billing/promotion-generators/${generatorId}`];
+};
+const getBillingPromotionGeneratorQueryOptions = (generatorId, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingPromotionGeneratorQueryKey(generatorId);
+	const queryFn = ({ signal }) => billingPromotionGenerator(generatorId, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: generatorId !== null && generatorId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary Read a promotion generator definition
+*/
+function useBillingPromotionGenerator(generatorId, options, queryClient) {
+	const queryOptions = getBillingPromotionGeneratorQueryOptions(generatorId, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingRedeemPromotionUrl = () => {
+	return `/billing/promotions/redeem`;
+};
+/**
+* Redeem a usable benefit code that does not require a payment method, atomically consuming stock and creating personal access through shared contracts. Discounts use checkout instead. Reusing requestKey for the same promotion returns the previous redemption; reuse for another code returns 409. Case/Unicode-normalized lookup, per-user stock and access-window limits apply. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Redeem an access benefit for the current profile
+*/
+const billingRedeemPromotion = async (promotionRedeemWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingRedeemPromotionUrl(), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(promotionRedeemWrite)
+	});
+};
+const getBillingRedeemPromotionMutationKey = () => ["billingRedeemPromotion"];
+const getBillingRedeemPromotionMutationOptions = (options) => {
+	const mutationKey = getBillingRedeemPromotionMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { data } = props ?? {};
+		return billingRedeemPromotion(data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Redeem an access benefit for the current profile
+*/
+const useBillingRedeemPromotion = (options, queryClient) => {
+	return useMutation(getBillingRedeemPromotionMutationOptions(options), queryClient);
+};
+const getBillingPromotionCapacityUrl = (promotionId) => {
+	return `/billing/promotions/${promotionId}/capacity`;
+};
+/**
+* Global commercial operators inspect total and per-user limits, redeemed stock and live reservations. Submitting or unknown checkouts keep reservations even after quote expiry. remaining is max(0, quantity - redeemed - reserved); a positive count alone does not prove a rule is active or usable.
+* @summary Inspect promotion stock and payment reservations
+*/
+const billingPromotionCapacity = async (promotionId, options) => {
+	return request(getBillingPromotionCapacityUrl(promotionId), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingPromotionCapacityQueryKey = (promotionId) => {
+	return [`/billing/promotions/${promotionId}/capacity`];
+};
+const getBillingPromotionCapacityQueryOptions = (promotionId, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingPromotionCapacityQueryKey(promotionId);
+	const queryFn = ({ signal }) => billingPromotionCapacity(promotionId, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: promotionId !== null && promotionId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary Inspect promotion stock and payment reservations
+*/
+function useBillingPromotionCapacity(promotionId, options, queryClient) {
+	const queryOptions = getBillingPromotionCapacityQueryOptions(promotionId, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingRevealPromotionCodeUrl = (promotionId) => {
+	return `/billing/promotions/${promotionId}/code`;
+};
+/**
+* A catalogue finance operator decrypts one distribution code and records the supplied reason. The response is private, no-store; do not expose it in public reports. Requires high-assurance authentication.
+* @summary Reveal one promotion code with an audit reason
+*/
+const billingRevealPromotionCode = async (promotionId, promotionRevealWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingRevealPromotionCodeUrl(promotionId), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(promotionRevealWrite)
+	});
+};
+const getBillingRevealPromotionCodeMutationKey = () => ["billingRevealPromotionCode"];
+const getBillingRevealPromotionCodeMutationOptions = (options) => {
+	const mutationKey = getBillingRevealPromotionCodeMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { promotionId, data } = props ?? {};
+		return billingRevealPromotionCode(promotionId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Reveal one promotion code with an audit reason
+*/
+const useBillingRevealPromotionCode = (options, queryClient) => {
+	return useMutation(getBillingRevealPromotionCodeMutationOptions(options), queryClient);
+};
+const getBillingPromotionRedemptionsUrl = (promotionId, 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 ? `/billing/promotions/${promotionId}/redemptions?${stringifiedParams}` : `/billing/promotions/${promotionId}/redemptions`;
+};
+/**
+* Global commercial operators list a promotion's native and imported redemptions, newest first. Historical beneficiary, contract, transaction, discount and time references can be null; do not infer a payment from a redemption. Codes and raw source identifiers are omitted.
+* @summary List promotion redemption evidence
+*/
+const billingPromotionRedemptions = async (promotionId, params, options) => {
+	return request(getBillingPromotionRedemptionsUrl(promotionId, params), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingPromotionRedemptionsQueryKey = (promotionId, params) => {
+	return [`/billing/promotions/${promotionId}/redemptions`, ...params ? [params] : []];
+};
+const getBillingPromotionRedemptionsQueryOptions = (promotionId, params, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingPromotionRedemptionsQueryKey(promotionId, params);
+	const queryFn = ({ signal }) => billingPromotionRedemptions(promotionId, params, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: promotionId !== null && promotionId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary List promotion redemption evidence
+*/
+function useBillingPromotionRedemptions(promotionId, params, options, queryClient) {
+	const queryOptions = getBillingPromotionRedemptionsQueryOptions(promotionId, params, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingRestoreStorePurchasesUrl = () => {
+	return `/billing/store/restore`;
+};
+/**
+* Fetch RevenueCat evidence for the server-issued billing subject and reconcile supported store receipts in the current environment with active provider mappings. Receipts belonging to another profile are refused. Unknown receipt price, tax or renewal values stay unknown. The returned page contains restored subscriptions and can be empty; there is no client-supplied receipt-owner ID. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Restore the current profile's mobile purchases
+*/
+const billingRestoreStorePurchases = async (billingIdentityWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingRestoreStorePurchasesUrl(), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(billingIdentityWrite)
+	});
+};
+const getBillingRestoreStorePurchasesMutationKey = () => ["billingRestoreStorePurchases"];
+const getBillingRestoreStorePurchasesMutationOptions = (options) => {
+	const mutationKey = getBillingRestoreStorePurchasesMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { data } = props ?? {};
+		return billingRestoreStorePurchases(data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Restore the current profile's mobile purchases
+*/
+const useBillingRestoreStorePurchases = (options, queryClient) => {
+	return useMutation(getBillingRestoreStorePurchasesMutationOptions(options), queryClient);
+};
+const getBillingListSubscriptionsUrl = (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 ? `/billing/subscriptions?${stringifiedParams}` : `/billing/subscriptions`;
+};
+/**
+* List local subscription projections, newest first. No provider refresh occurs. autoRenew=null means renewal is unknown, and unknown historical price/currency remain null; use explicit reconciliation or store restoration to obtain current evidence. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached.
+* @summary List the current profile's subscriptions
+*/
+const billingListSubscriptions = async (params, options) => {
+	return request(getBillingListSubscriptionsUrl(params), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingListSubscriptionsQueryKey = (params) => {
+	return [`/billing/subscriptions`, ...params ? [params] : []];
+};
+const getBillingListSubscriptionsQueryOptions = (params, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingListSubscriptionsQueryKey(params);
+	const queryFn = ({ signal }) => billingListSubscriptions(params, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		...queryOptions
+	};
+};
+/**
+* @summary List the current profile's subscriptions
+*/
+function useBillingListSubscriptions(params, options, queryClient) {
+	const queryOptions = getBillingListSubscriptionsQueryOptions(params, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingReadSubscriptionUrl = (subscriptionId) => {
+	return `/billing/subscriptions/${subscriptionId}`;
+};
+/**
+* Read the local subscription and its known access, price and renewal terms. managementUrl is provided for mobile store subscriptions. This GET neither refreshes receipts nor changes renewal. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached.
+* @summary Read the current profile's subscription
+*/
+const billingReadSubscription = async (subscriptionId, options) => {
+	return request(getBillingReadSubscriptionUrl(subscriptionId), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingReadSubscriptionQueryKey = (subscriptionId) => {
+	return [`/billing/subscriptions/${subscriptionId}`];
+};
+const getBillingReadSubscriptionQueryOptions = (subscriptionId, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingReadSubscriptionQueryKey(subscriptionId);
+	const queryFn = ({ signal }) => billingReadSubscription(subscriptionId, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: subscriptionId !== null && subscriptionId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary Read the current profile's subscription
+*/
+function useBillingReadSubscription(subscriptionId, options, queryClient) {
+	const queryOptions = getBillingReadSubscriptionQueryOptions(subscriptionId, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingCancelSubscriptionUrl = (subscriptionId) => {
+	return `/billing/subscriptions/${subscriptionId}/cancel`;
+};
+/**
+* Cancel Braintree renewal and project the provider-confirmed access end, or cancel a local fixed subscription. Existing paid access follows the confirmed period. Optional feedback is stored separately. Mobile store renewal must be managed through managementUrl; this operation returns 409 for stores. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Cancel a personal subscription's renewal
+*/
+const billingCancelSubscription = async (subscriptionId, billingCancelWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingCancelSubscriptionUrl(subscriptionId), {
+		...options,
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(billingCancelWrite)
+	});
+};
+const getBillingCancelSubscriptionMutationKey = () => ["billingCancelSubscription"];
+const getBillingCancelSubscriptionMutationOptions = (options) => {
+	const mutationKey = getBillingCancelSubscriptionMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { subscriptionId, data } = props ?? {};
+		return billingCancelSubscription(subscriptionId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Cancel a personal subscription's renewal
+*/
+const useBillingCancelSubscription = (options, queryClient) => {
+	return useMutation(getBillingCancelSubscriptionMutationOptions(options), queryClient);
+};
+const getBillingCancellationFeedbackUrl = (subscriptionId, 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 ? `/billing/subscriptions/${subscriptionId}/cancellation-feedback?${stringifiedParams}` : `/billing/subscriptions/${subscriptionId}/cancellation-feedback`;
+};
+/**
+* List only this profile's recorded cancellation feedback for the owned subscription, newest first. Missing historical answers and dates stay null. Feedback is not evidence of current provider renewal state. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached.
+* @summary List an owned subscription's cancellation feedback
+*/
+const billingCancellationFeedback = async (subscriptionId, params, options) => {
+	return request(getBillingCancellationFeedbackUrl(subscriptionId, params), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingCancellationFeedbackQueryKey = (subscriptionId, params) => {
+	return [`/billing/subscriptions/${subscriptionId}/cancellation-feedback`, ...params ? [params] : []];
+};
+const getBillingCancellationFeedbackQueryOptions = (subscriptionId, params, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingCancellationFeedbackQueryKey(subscriptionId, params);
+	const queryFn = ({ signal }) => billingCancellationFeedback(subscriptionId, params, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: subscriptionId !== null && subscriptionId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary List an owned subscription's cancellation feedback
+*/
+function useBillingCancellationFeedback(subscriptionId, params, options, queryClient) {
+	const queryOptions = getBillingCancellationFeedbackQueryOptions(subscriptionId, params, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingSubscriptionClientTokenUrl = (subscriptionId) => {
+	return `/billing/subscriptions/${subscriptionId}/client-token`;
+};
+/**
+* Initialize payment-method collection for an owned Braintree subscription whose renewal is confirmed active. Unknown renewal must be reconciled first; store and nonrenewing subscriptions are not editable here. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Create a subscription payment-method token
+*/
+const billingSubscriptionClientToken = async (subscriptionId, options) => {
+	return request(getBillingSubscriptionClientTokenUrl(subscriptionId), {
+		...options,
+		method: "POST"
+	});
+};
+const getBillingSubscriptionClientTokenMutationKey = () => ["billingSubscriptionClientToken"];
+const getBillingSubscriptionClientTokenMutationOptions = (options) => {
+	const mutationKey = getBillingSubscriptionClientTokenMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { subscriptionId } = props ?? {};
+		return billingSubscriptionClientToken(subscriptionId, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Create a subscription payment-method token
+*/
+const useBillingSubscriptionClientToken = (options, queryClient) => {
+	return useMutation(getBillingSubscriptionClientTokenMutationOptions(options), queryClient);
+};
+const getBillingSubscriptionHistoryUrl = (subscriptionId, 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 ? `/billing/subscriptions/${subscriptionId}/history?${stringifiedParams}` : `/billing/subscriptions/${subscriptionId}/history`;
+};
+/**
+* List preserved subscription events, newest local identifier first. Source status and transactionType are evidence labels, not current renewal guarantees. Unknown source times remain null with clockBasis; amount may also be null and this projection does not supply a currency. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached.
+* @summary List an owned subscription's source events
+*/
+const billingSubscriptionHistory = async (subscriptionId, params, options) => {
+	return request(getBillingSubscriptionHistoryUrl(subscriptionId, params), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingSubscriptionHistoryQueryKey = (subscriptionId, params) => {
+	return [`/billing/subscriptions/${subscriptionId}/history`, ...params ? [params] : []];
+};
+const getBillingSubscriptionHistoryQueryOptions = (subscriptionId, params, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingSubscriptionHistoryQueryKey(subscriptionId, params);
+	const queryFn = ({ signal }) => billingSubscriptionHistory(subscriptionId, params, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: subscriptionId !== null && subscriptionId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary List an owned subscription's source events
+*/
+function useBillingSubscriptionHistory(subscriptionId, params, options, queryClient) {
+	const queryOptions = getBillingSubscriptionHistoryQueryOptions(subscriptionId, params, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingUpdatePaymentMethodUrl = (subscriptionId) => {
+	return `/billing/subscriptions/${subscriptionId}/payment-method`;
+};
+/**
+* Use a new provider SDK nonce to update the current profile's renewing Braintree subscription and apply the returned receipt. acceptedOutstandingBalance explicitly allows collection of an outstanding balance; it defaults to false. Store subscriptions use their original provider. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Update a renewing subscription's payment method
+*/
+const billingUpdatePaymentMethod = async (subscriptionId, billingPaymentMethodWrite, options) => {
+	const getHeaders = (h) => {
+		if (!h) return {};
+		if (h instanceof Headers) return Object.fromEntries(h.entries());
+		if (Symbol.iterator in h) return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+		const headers = {};
+		for (const [name, value] of Object.entries(h)) if (value !== void 0) headers[name] = value;
+		return headers;
+	};
+	return request(getBillingUpdatePaymentMethodUrl(subscriptionId), {
+		...options,
+		method: "PUT",
+		headers: {
+			"Content-Type": "application/json",
+			...getHeaders(options?.headers)
+		},
+		body: JSON.stringify(billingPaymentMethodWrite)
+	});
+};
+const getBillingUpdatePaymentMethodMutationKey = () => ["billingUpdatePaymentMethod"];
+const getBillingUpdatePaymentMethodMutationOptions = (options) => {
+	const mutationKey = getBillingUpdatePaymentMethodMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { subscriptionId, data } = props ?? {};
+		return billingUpdatePaymentMethod(subscriptionId, data, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Update a renewing subscription's payment method
+*/
+const useBillingUpdatePaymentMethod = (options, queryClient) => {
+	return useMutation(getBillingUpdatePaymentMethodMutationOptions(options), queryClient);
+};
+const getBillingReconcileSubscriptionUrl = (subscriptionId) => {
+	return `/billing/subscriptions/${subscriptionId}/reconcile`;
+};
+/**
+* Read the existing Braintree subscription, refresh authoritative renewal/access terms and project shared contract access. The existing provider identity and current billing environment must match. Use store restoration for App Store and Play Store subscriptions. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached. Requires high-assurance authentication.
+* @summary Refresh a Braintree subscription from its receipt
+*/
+const billingReconcileSubscription = async (subscriptionId, options) => {
+	return request(getBillingReconcileSubscriptionUrl(subscriptionId), {
+		...options,
+		method: "POST"
+	});
+};
+const getBillingReconcileSubscriptionMutationKey = () => ["billingReconcileSubscription"];
+const getBillingReconcileSubscriptionMutationOptions = (options) => {
+	const mutationKey = getBillingReconcileSubscriptionMutationKey();
+	const { mutation: mutationOptions, request: requestOptions } = options ? options.mutation && "mutationKey" in options.mutation && options.mutation.mutationKey ? options : {
+		...options,
+		mutation: {
+			...options.mutation,
+			mutationKey
+		}
+	} : {
+		mutation: { mutationKey },
+		request: void 0
+	};
+	const mutationFn = (props) => {
+		const { subscriptionId } = props ?? {};
+		return billingReconcileSubscription(subscriptionId, requestOptions);
+	};
+	return {
+		mutationFn,
+		...mutationOptions
+	};
+};
+/**
+* @summary Refresh a Braintree subscription from its receipt
+*/
+const useBillingReconcileSubscription = (options, queryClient) => {
+	return useMutation(getBillingReconcileSubscriptionMutationOptions(options), queryClient);
+};
+const getBillingListTransactionsUrl = (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 ? `/billing/transactions?${stringifiedParams}` : `/billing/transactions`;
+};
+/**
+* List private native and imported transactions, newest local identifier first. Historical timestamps, money and currency remain null when unverified. amountBasis distinguishes verified_receipt, historical_provider_evidence and unknown. listedAmountBeforeDiscount and calculatedAmountAfterDiscount preserve source arithmetic; they must not be presented as confirmed paid amounts. clockBasis describes time evidence. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached.
+* @summary List the current profile's payment history
+*/
+const billingListTransactions = async (params, options) => {
+	return request(getBillingListTransactionsUrl(params), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingListTransactionsQueryKey = (params) => {
+	return [`/billing/transactions`, ...params ? [params] : []];
+};
+const getBillingListTransactionsQueryOptions = (params, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingListTransactionsQueryKey(params);
+	const queryFn = ({ signal }) => billingListTransactions(params, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		...queryOptions
+	};
+};
+/**
+* @summary List the current profile's payment history
+*/
+function useBillingListTransactions(params, options, queryClient) {
+	const queryOptions = getBillingListTransactionsQueryOptions(params, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+const getBillingReadTransactionUrl = (transactionId) => {
+	return `/billing/transactions/${transactionId}`;
+};
+/**
+* Return one transaction belonging to the authenticated profile. Historical timestamps, money and currency remain null when unverified. amountBasis distinguishes verified_receipt, historical_provider_evidence and unknown. listedAmountBeforeDiscount and calculatedAmountAfterDiscount preserve source arithmetic; they must not be presented as confirmed paid amounts. clockBasis describes time evidence. Uses the authenticated independent profile in the Biblio product context; support impersonation is refused. Responses are private and must not be cached.
+* @summary Read an owned transaction's payment evidence
+*/
+const billingReadTransaction = async (transactionId, options) => {
+	return request(getBillingReadTransactionUrl(transactionId), {
+		...options,
+		method: "GET"
+	});
+};
+const getBillingReadTransactionQueryKey = (transactionId) => {
+	return [`/billing/transactions/${transactionId}`];
+};
+const getBillingReadTransactionQueryOptions = (transactionId, options) => {
+	const { query: queryOptions, request: requestOptions } = options ?? {};
+	const queryKey = queryOptions?.queryKey ?? getBillingReadTransactionQueryKey(transactionId);
+	const queryFn = ({ signal }) => billingReadTransaction(transactionId, {
+		signal,
+		...requestOptions
+	});
+	return {
+		queryKey,
+		queryFn,
+		enabled: transactionId !== null && transactionId !== void 0,
+		...queryOptions
+	};
+};
+/**
+* @summary Read an owned transaction's payment evidence
+*/
+function useBillingReadTransaction(transactionId, options, queryClient) {
+	const queryOptions = getBillingReadTransactionQueryOptions(transactionId, options);
+	const query = useQuery(queryOptions, queryClient);
+	return withQueryKey(query, queryOptions.queryKey);
+}
+//#endregion
+export { billingBindProviderProduct, billingCancelSubscription, billingCancellationFeedback, billingCreateClientToken, billingCreateProduct, billingCreatePromotion, billingExportPromotionCodes, billingGeneratePromotions, billingListProducts, billingListPromotions, billingListSubscriptions, billingListTransactions, billingPrepareIdentity, billingPromotionCapacity, billingPromotionGenerator, billingPromotionGenerators, billingPromotionRedemptions, billingQuoteCheckout, billingReadCheckout, billingReadSubscription, billingReadTransaction, billingReconcileCheckout, billingReconcileSubscription, billingRedeemPromotion, billingRestoreStorePurchases, billingRevealPromotionCode, billingSetOfferAvailability, billingSubmitCheckout, billingSubscriptionClientToken, billingSubscriptionHistory, billingUpdatePaymentMethod, getBillingBindProviderProductMutationKey, getBillingBindProviderProductMutationOptions, getBillingBindProviderProductUrl, getBillingCancelSubscriptionMutationKey, getBillingCancelSubscriptionMutationOptions, getBillingCancelSubscriptionUrl, getBillingCancellationFeedbackQueryKey, getBillingCancellationFeedbackQueryOptions, getBillingCancellationFeedbackUrl, getBillingCreateClientTokenMutationKey, getBillingCreateClientTokenMutationOptions, getBillingCreateClientTokenUrl, getBillingCreateProductMutationKey, getBillingCreateProductMutationOptions, getBillingCreateProductUrl, getBillingCreatePromotionMutationKey, getBillingCreatePromotionMutationOptions, getBillingCreatePromotionUrl, getBillingExportPromotionCodesMutationKey, getBillingExportPromotionCodesMutationOptions, getBillingExportPromotionCodesUrl, getBillingGeneratePromotionsMutationKey, getBillingGeneratePromotionsMutationOptions, getBillingGeneratePromotionsUrl, getBillingListProductsQueryKey, getBillingListProductsQueryOptions, getBillingListProductsUrl, getBillingListPromotionsQueryKey, getBillingListPromotionsQueryOptions, getBillingListPromotionsUrl, getBillingListSubscriptionsQueryKey, getBillingListSubscriptionsQueryOptions, getBillingListSubscriptionsUrl, getBillingListTransactionsQueryKey, getBillingListTransactionsQueryOptions, getBillingListTransactionsUrl, getBillingPrepareIdentityMutationKey, getBillingPrepareIdentityMutationOptions, getBillingPrepareIdentityUrl, getBillingPromotionCapacityQueryKey, getBillingPromotionCapacityQueryOptions, getBillingPromotionCapacityUrl, getBillingPromotionGeneratorQueryKey, getBillingPromotionGeneratorQueryOptions, getBillingPromotionGeneratorUrl, getBillingPromotionGeneratorsQueryKey, getBillingPromotionGeneratorsQueryOptions, getBillingPromotionGeneratorsUrl, getBillingPromotionRedemptionsQueryKey, getBillingPromotionRedemptionsQueryOptions, getBillingPromotionRedemptionsUrl, getBillingQuoteCheckoutMutationKey, getBillingQuoteCheckoutMutationOptions, getBillingQuoteCheckoutUrl, getBillingReadCheckoutQueryKey, getBillingReadCheckoutQueryOptions, getBillingReadCheckoutUrl, getBillingReadSubscriptionQueryKey, getBillingReadSubscriptionQueryOptions, getBillingReadSubscriptionUrl, getBillingReadTransactionQueryKey, getBillingReadTransactionQueryOptions, getBillingReadTransactionUrl, getBillingReconcileCheckoutMutationKey, getBillingReconcileCheckoutMutationOptions, getBillingReconcileCheckoutUrl, getBillingReconcileSubscriptionMutationKey, getBillingReconcileSubscriptionMutationOptions, getBillingReconcileSubscriptionUrl, getBillingRedeemPromotionMutationKey, getBillingRedeemPromotionMutationOptions, getBillingRedeemPromotionUrl, getBillingRestoreStorePurchasesMutationKey, getBillingRestoreStorePurchasesMutationOptions, getBillingRestoreStorePurchasesUrl, getBillingRevealPromotionCodeMutationKey, getBillingRevealPromotionCodeMutationOptions, getBillingRevealPromotionCodeUrl, getBillingSetOfferAvailabilityMutationKey, getBillingSetOfferAvailabilityMutationOptions, getBillingSetOfferAvailabilityUrl, getBillingSubmitCheckoutMutationKey, getBillingSubmitCheckoutMutationOptions, getBillingSubmitCheckoutUrl, getBillingSubscriptionClientTokenMutationKey, getBillingSubscriptionClientTokenMutationOptions, getBillingSubscriptionClientTokenUrl, getBillingSubscriptionHistoryQueryKey, getBillingSubscriptionHistoryQueryOptions, getBillingSubscriptionHistoryUrl, getBillingUpdatePaymentMethodMutationKey, getBillingUpdatePaymentMethodMutationOptions, getBillingUpdatePaymentMethodUrl, useBillingBindProviderProduct, useBillingCancelSubscription, useBillingCancellationFeedback, useBillingCreateClientToken, useBillingCreateProduct, useBillingCreatePromotion, useBillingExportPromotionCodes, useBillingGeneratePromotions, useBillingListProducts, useBillingListPromotions, useBillingListSubscriptions, useBillingListTransactions, useBillingPrepareIdentity, useBillingPromotionCapacity, useBillingPromotionGenerator, useBillingPromotionGenerators, useBillingPromotionRedemptions, useBillingQuoteCheckout, useBillingReadCheckout, useBillingReadSubscription, useBillingReadTransaction, useBillingReconcileCheckout, useBillingReconcileSubscription, useBillingRedeemPromotion, useBillingRestoreStorePurchases, useBillingRevealPromotionCode, useBillingSetOfferAvailability, useBillingSubmitCheckout, useBillingSubscriptionClientToken, useBillingSubscriptionHistory, useBillingUpdatePaymentMethod };
+
+//# sourceMappingURL=biblio-billing.js.map