@owlmeans/web-payment 0.1.18-rc.20 → 0.1.18-rc.21

package/build/consumer/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/consumer/copy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAwCnD,gFAAgF;AAChF,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,KAAK,MAAM,CAAA;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAS,MAAM,KAAG,SAQ3C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,SAUzC,CAAA;AAED,uDAAuD;AACvD,eAAO,MAAM,cAAc,QAAS,MAAM,KAAG,SAAqD,CAAA;AAElG,qDAAqD;AACrD,eAAO,MAAM,YAAY,QAAS,MAAM,KAAG,SAAmD,CAAA;AAE9F,kGAAkG;AAClG,eAAO,MAAM,cAAc,QAAS,MAAM,cAAc,MAAM,KAAG,MAMhE,CAAA"}

package/build/consumer/copy.js

@@ -0,0 +1,75 @@
+import { useMemo } from 'react';
+import { LIB_NAMESPACE, resolveI18nResource } from '@owlmeans/i18n';
+import { baseLanguageOf, consumerText } from '@owlmeans/payment';
+import { WEB_PAYMENT_RESOURCE } from '../i18n.js';
+const isTree = (value) => value != null && typeof value === 'object' && !Array.isArray(value);
+const merge = (base, over) => {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(over ?? {})) {
+        if (isTree(value)) {
+            const current = result[key];
+            result[key] = merge(isTree(current) ? current : {}, value);
+        }
+        else if (typeof value === 'string') {
+            result[key] = value;
+        }
+    }
+    return result;
+};
+const bundleOf = (lng) => {
+    const base = baseLanguageOf(lng);
+    let tree = merge({}, resolveI18nResource('en', WEB_PAYMENT_RESOURCE, LIB_NAMESPACE));
+    if (base !== '' && base !== 'en') {
+        tree = merge(tree, resolveI18nResource(base, WEB_PAYMENT_RESOURCE, LIB_NAMESPACE));
+    }
+    if (lng !== base && lng.trim() !== '') {
+        tree = merge(tree, resolveI18nResource(lng, WEB_PAYMENT_RESOURCE, LIB_NAMESPACE));
+    }
+    return tree;
+};
+const fill = (text, values = {}) => text.replace(/\{\{\s*([\w-]+)\s*\}\}/g, (_, name) => values[name] != null ? String(values[name]) : '');
+/**
+ * The package's own interface strings (`web-payment`, library tier, any application override
+ * included) in a FIXED language, merged key by key over English — no i18next instance and no
+ * draining (`resolveI18nResource`). What lets a consumer-rights dialog render wholly in the
+ * contract language while the rest of the page stays in the interface language.
+ */
+export const paymentTextOf = (lng) => {
+    const tree = bundleOf(lng);
+    return (key, values) => {
+        const value = key.split('.').reduce((node, part) => isTree(node) ? node[part] : undefined, tree);
+        return typeof value === 'string' ? fill(value, values) : key;
+    };
+};
+/**
+ * The legal copy of `@owlmeans/payment` (`payment-consumer-rights`) in a fixed language. A text
+ * that cannot be rendered in the language (a broken application override) falls back to English
+ * rather than blanking the page; one that cannot be rendered at all is `''`.
+ */
+export const legalTextOf = (lng) => (path, values) => {
+    try {
+        return consumerText(lng, path, values);
+    }
+    catch {
+        try {
+            return consumerText('en', path, values);
+        }
+        catch {
+            return '';
+        }
+    }
+};
+/** `paymentTextOf(lng)`, memoised for the language. */
+export const usePaymentText = (lng) => useMemo(() => paymentTextOf(lng), [lng]);
+/** `legalTextOf(lng)`, memoised for the language. */
+export const useLegalText = (lng) => useMemo(() => legalTextOf(lng), [lng]);
+/** A language's own name in another language (`de` in `en` → "German"); the code when unknown. */
+export const languageNameOf = (lng, inLanguage) => {
+    try {
+        return new Intl.DisplayNames([inLanguage], { type: 'language' }).of(lng) ?? lng;
+    }
+    catch {
+        return lng;
+    }
+};
+//# sourceMappingURL=copy.js.map

package/build/consumer/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../src/consumer/copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAMjD,MAAM,MAAM,GAAG,CAAC,KAAc,EAAiB,EAAE,CAC/C,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAErE,MAAM,KAAK,GAAG,CAAC,IAAU,EAAE,IAAoC,EAAQ,EAAE;IACvE,MAAM,MAAM,GAAS,EAAE,GAAG,IAAI,EAAE,CAAA;IAChC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QACtD,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;YAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QAC5D,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAQ,EAAE;IACrC,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,IAAI,GAAG,KAAK,CAAC,EAAE,EAAE,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAAA;IACpF,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACjC,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAAA;IACpF,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtC,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC,GAAG,EAAE,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAAA;IACnF,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,MAAM,GAAe,EAAE,EAAU,EAAE,CAC7D,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAKhH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAa,EAAE;IACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;IAE1B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;QACrB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAU,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAEzG,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAC9D,CAAC,CAAA;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAa,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IACtE,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;AACH,CAAC,CAAA;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAW,EAAa,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;AAElG,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAa,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;AAE9F,kGAAkG;AAClG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,UAAkB,EAAU,EAAE;IACxE,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,CAAA;IACjF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAA;IACZ,CAAC;AACH,CAAC,CAAA"}

package/build/consumer/ensure.d.ts

@@ -0,0 +1,56 @@
+export interface AskerOptions<Args extends unknown[], View, Answer> {
+    /** Read the current view. */
+    load: (...args: Args) => Promise<View>;
+    /** Whether the view asks the person anything. */
+    required: (view: View) => boolean;
+    /** Show the view to the person (open the dialog). */
+    show: (view: View) => void;
+    /**
+     * The answer when nothing needs asking — and when the read FAILS: the server's refusal stays
+     * the authority, and a flaky read must never block work that needs no consent.
+     */
+    skip: Answer;
+}
+export interface Asker<Args extends unknown[], Answer> {
+    /** Read, and ask only when the view requires it. Concurrent calls share ONE pending answer. */
+    ask: (...args: Args) => Promise<Answer>;
+    /** Answer the pending `ask` (the dialog confirmed or was declined); nothing when none waits. */
+    settle: (answer: Answer) => void;
+    /** Whether an `ask` is waiting for the person. */
+    waiting: () => boolean;
+}
+/**
+ * Read a view, show it when it asks for something, and answer once the person has — the state
+ * machine behind `usePerformanceConsent().ensure` and `useSubscriptionStart().ensure`, free of
+ * React so it is testable on its own. A burst of calls opens one dialog: they all get its answer.
+ */
+export declare const makeAsker: <Args extends unknown[], View, Answer>(opts: AskerOptions<Args, View, Answer>) => Asker<Args, Answer>;
+export interface EnsureOptions {
+    /**
+     * Asked after the server refused with a 428 although the last answer said nothing was needed.
+     * The view is always read fresh; `force` records why the caller asks.
+     */
+    force?: boolean;
+}
+export interface ConsentGate {
+    /**
+     * `true` when nothing needs consent or the person confirmed and it was recorded; `false` when
+     * they declined or closed the dialog. A failed read answers `true`. One pending answer is shared.
+     */
+    ensure: (opts?: EnsureOptions) => Promise<boolean>;
+    /**
+     * Run `action`; when it is refused for the spend consent (`isPerformanceConsentRefusal` — the
+     * class, its marker, or a bare 428, also wrapped inside another error), ask with
+     * `ensure({ force: true })` and run it again exactly ONCE. A decline throws `ConsentDeclined`;
+     * a second refusal, or any other failure, propagates as it is.
+     */
+    withConsent: <T>(action: () => Promise<T>) => Promise<T>;
+}
+/** A gate over an `ensure` — what `useConsentGate` answers inside a `PerformanceConsentProvider`. */
+export declare const makeConsentGate: (ensure: ConsentGate['ensure']) => ConsentGate;
+/**
+ * The gate outside any provider: nothing can be asked, so `ensure` answers `true` and a refusal
+ * propagates unchanged.
+ */
+export declare const passThroughGate: ConsentGate;
+//# sourceMappingURL=ensure.d.ts.map

package/build/consumer/ensure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.d.ts","sourceRoot":"","sources":["../../src/consumer/ensure.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM;IAChE,6BAA6B;IAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,iDAAiD;IACjD,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAA;IACjC,qDAAqD;IACrD,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAC1B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,KAAK,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM;IACnD,+FAA+F;IAC/F,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACvC,gGAAgG;IAChG,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,kDAAkD;IAClD,OAAO,EAAE,MAAM,OAAO,CAAA;CACvB;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,IAAI,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,QACtD,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KACrC,KAAK,CAAC,IAAI,EAAE,MAAM,CAuCpB,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAClD;;;;;OAKG;IACH,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;CACzD;AAED,qGAAqG;AACrG,eAAO,MAAM,eAAe,WAAY,WAAW,CAAC,QAAQ,CAAC,KAAG,WAgB9D,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,WAG7B,CAAA"}

package/build/consumer/ensure.js

@@ -0,0 +1,71 @@
+import { ConsentKind } from '@owlmeans/payment';
+import { ConsentDeclined, isPerformanceConsentRefusal } from './refusal.js';
+/**
+ * Read a view, show it when it asks for something, and answer once the person has — the state
+ * machine behind `usePerformanceConsent().ensure` and `useSubscriptionStart().ensure`, free of
+ * React so it is testable on its own. A burst of calls opens one dialog: they all get its answer.
+ */
+export const makeAsker = (opts) => {
+    let inflight = null;
+    let resolver = null;
+    const run = async (args) => {
+        let view;
+        try {
+            view = await opts.load(...args);
+        }
+        catch {
+            return opts.skip;
+        }
+        if (!opts.required(view)) {
+            return opts.skip;
+        }
+        return await new Promise(resolve => {
+            resolver = resolve;
+            opts.show(view);
+        });
+    };
+    return {
+        ask: async (...args) => {
+            if (inflight == null) {
+                inflight = run(args).finally(() => {
+                    inflight = null;
+                    resolver = null;
+                });
+            }
+            return await inflight;
+        },
+        settle: answer => {
+            const resolve = resolver;
+            resolver = null;
+            resolve?.(answer);
+        },
+        waiting: () => resolver != null,
+    };
+};
+/** A gate over an `ensure` — what `useConsentGate` answers inside a `PerformanceConsentProvider`. */
+export const makeConsentGate = (ensure) => ({
+    ensure,
+    withConsent: async (action) => {
+        try {
+            return await action();
+        }
+        catch (e) {
+            if (!isPerformanceConsentRefusal(e)) {
+                throw e;
+            }
+            if (!await ensure({ force: true })) {
+                throw new ConsentDeclined(ConsentKind.Performance);
+            }
+            return await action();
+        }
+    },
+});
+/**
+ * The gate outside any provider: nothing can be asked, so `ensure` answers `true` and a refusal
+ * propagates unchanged.
+ */
+export const passThroughGate = {
+    ensure: async () => true,
+    withConsent: async (action) => await action(),
+};
+//# sourceMappingURL=ensure.js.map

package/build/consumer/ensure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.js","sourceRoot":"","sources":["../../src/consumer/ensure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AAyB3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAsC,EACjB,EAAE;IACvB,IAAI,QAAQ,GAA2B,IAAI,CAAA;IAC3C,IAAI,QAAQ,GAAsC,IAAI,CAAA;IAEtD,MAAM,GAAG,GAAG,KAAK,EAAE,IAAU,EAAmB,EAAE;QAChD,IAAI,IAAU,CAAA;QACd,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,IAAI,CAAA;QAClB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,IAAI,CAAA;QAClB,CAAC;QAED,OAAO,MAAM,IAAI,OAAO,CAAS,OAAO,CAAC,EAAE;YACzC,QAAQ,GAAG,OAAO,CAAA;YAClB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;YACrB,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;gBACrB,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;oBAChC,QAAQ,GAAG,IAAI,CAAA;oBACf,QAAQ,GAAG,IAAI,CAAA;gBACjB,CAAC,CAAC,CAAA;YACJ,CAAC;YAED,OAAO,MAAM,QAAQ,CAAA;QACvB,CAAC;QACD,MAAM,EAAE,MAAM,CAAC,EAAE;YACf,MAAM,OAAO,GAAG,QAAQ,CAAA;YACxB,QAAQ,GAAG,IAAI,CAAA;YACf,OAAO,EAAE,CAAC,MAAM,CAAC,CAAA;QACnB,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,IAAI,IAAI;KAChC,CAAA;AACH,CAAC,CAAA;AAyBD,qGAAqG;AACrG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAA6B,EAAe,EAAE,CAAC,CAAC;IAC9E,MAAM;IACN,WAAW,EAAE,KAAK,EAAK,MAAwB,EAAc,EAAE;QAC7D,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,EAAE,CAAA;QACvB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,CAAA;YACT,CAAC;YACD,IAAI,CAAC,MAAM,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,eAAe,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA;YACpD,CAAC;YAED,OAAO,MAAM,MAAM,EAAE,CAAA;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;IACxB,WAAW,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE,CAAC,MAAM,MAAM,EAAE;CAC5C,CAAA"}

package/build/consumer/fields.d.ts

@@ -0,0 +1,43 @@
+import type { ReactNode } from 'react';
+/** The shape the platform validates an e-mail address with (`@owlmeans/payment` `EmailSchema`). */
+export declare const EMAIL_PATTERN: RegExp;
+export declare const isEmail: (value: string) => boolean;
+export interface FieldProps {
+    id: string;
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+    error?: string | null;
+    type?: 'text' | 'email' | 'date';
+    autoComplete?: string;
+    disabled?: boolean;
+    min?: string;
+    /** A `data-*` hook for tests (`data-withdrawal-field="name"`). */
+    hook?: Record<string, string>;
+    multiline?: boolean;
+}
+export declare const Field: ({ id, label, value, onChange, error, type, autoComplete, disabled, min, hook, multiline, }: FieldProps) => import("react").JSX.Element;
+export interface ChoiceProps {
+    id: string;
+    name: string;
+    checked: boolean;
+    onSelect: () => void;
+    disabled?: boolean;
+    hook?: Record<string, string>;
+    children: ReactNode;
+}
+/** One option of a radio group — a native radio, so the group needs no extra primitive. */
+export declare const Choice: ({ id, name, checked, onSelect, disabled, hook, children }: ChoiceProps) => import("react").JSX.Element;
+export interface HoneypotProps {
+    id: string;
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+}
+/**
+ * A field a person never sees or reaches: off screen, out of the tab order and hidden from
+ * assistive technology, with a plausible name a form-filling bot completes. A filled one marks the
+ * declaration as a bot's, which the server answers like any other (it never says so).
+ */
+export declare const Honeypot: ({ id, label, value, onChange }: HoneypotProps) => import("react").JSX.Element;
+//# sourceMappingURL=fields.d.ts.map

package/build/consumer/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/consumer/fields.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,mGAAmG;AACnG,eAAO,MAAM,aAAa,QAAsB,CAAA;AAEhD,eAAO,MAAM,OAAO,UAAW,MAAM,KAAG,OAAgF,CAAA;AAExH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,eAAO,MAAM,KAAK,+FAEf,UAAU,gCAkBP,CAAA;AAEN,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,2FAA2F;AAC3F,eAAO,MAAM,MAAM,8DAA+D,WAAW,gCASrF,CAAA;AAER,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,mCAAoC,aAAa,gCAOhE,CAAA"}

package/build/consumer/fields.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '@/lib/utils';
+import { Input } from '@/components/ui/input';
+import { Label } from '@/components/ui/label';
+/** The shape the platform validates an e-mail address with (`@owlmeans/payment` `EmailSchema`). */
+export const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+$/;
+export const isEmail = (value) => value.length >= 3 && value.length <= 254 && EMAIL_PATTERN.test(value);
+export const Field = ({ id, label, value, onChange, error, type = 'text', autoComplete, disabled, min, hook, multiline = false, }) => _jsxs("div", { className: "grid gap-1.5", children: [_jsx(Label, { htmlFor: id, children: label }), multiline
+            ? _jsx("textarea", { id: id, value: value, disabled: disabled, rows: 3, maxLength: 2000, "aria-invalid": error != null, "aria-describedby": error != null ? `${id}-error` : undefined, onChange: event => onChange(event.target.value), className: cn('border-input bg-background placeholder:text-muted-foreground w-full min-w-0 rounded-md border px-3 py-2 text-sm shadow-xs outline-none', 'focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] disabled:opacity-50 aria-invalid:border-destructive'), ...hook })
+            : _jsx(Input, { id: id, type: type, value: value, disabled: disabled, autoComplete: autoComplete, min: min, "aria-invalid": error != null, "aria-describedby": error != null ? `${id}-error` : undefined, onChange: event => onChange(event.target.value), ...hook }), error != null && _jsx("p", { id: `${id}-error`, className: "text-destructive text-xs", children: error })] });
+/** One option of a radio group — a native radio, so the group needs no extra primitive. */
+export const Choice = ({ id, name, checked, onSelect, disabled, hook, children }) => _jsxs("label", { htmlFor: id, className: cn('flex cursor-pointer items-start gap-3 rounded-md border p-3 text-sm', checked && 'border-primary bg-muted/30'), children: [_jsx("input", { id: id, type: "radio", name: name, checked: checked, disabled: disabled, onChange: onSelect, className: "accent-primary mt-0.5 size-4 shrink-0", ...hook }), _jsx("span", { className: "grid gap-0.5", children: children })] });
+/**
+ * A field a person never sees or reaches: off screen, out of the tab order and hidden from
+ * assistive technology, with a plausible name a form-filling bot completes. A filled one marks the
+ * declaration as a bot's, which the server answers like any other (it never says so).
+ */
+export const Honeypot = ({ id, label, value, onChange }) => _jsxs("div", { "aria-hidden": "true", "data-honeypot": "", style: { position: 'absolute', left: '-10000px', top: 'auto', width: 1, height: 1, overflow: 'hidden' }, children: [_jsx("label", { htmlFor: id, children: label }), _jsx("input", { id: id, name: "website", type: "text", tabIndex: -1, autoComplete: "off", value: value, onChange: event => onChange(event.target.value) })] });
+//# sourceMappingURL=fields.js.map

package/build/consumer/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/consumer/fields.tsx"],"names":[],"mappings":"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"}

package/build/consumer/hooks.d.ts

@@ -0,0 +1,113 @@
+import { type ReactNode } from 'react';
+import type { RegisteredEntrypoint, RequestShape } from '@owlmeans/entrypoint';
+import type { CancellationBody, DeclarationReceipt, PerformanceConsentBody, PerformanceConsentResponse, PerformanceConsentView, SubscriptionStartBody, SubscriptionStartQuery, SubscriptionStartResponse, SubscriptionStartView, WithdrawalBody, WithdrawalCandidateList } from '@owlmeans/payment';
+import { type EnsureOptions } from './ensure.js';
+import type { LegalLinksSource, PerformanceConsentDialogProps, SubscriptionStartDialogProps } from './types.js';
+/** A protocol whose request carries `body`: the record, withdraw and cancel routes. */
+type BodyRequest<Body> = RequestShape & {
+    body: Body;
+};
+export interface UsePerformanceConsentOptions {
+    /** Read the view on mount, so `required` is known before anything asks. Default `false`. */
+    enabled?: boolean;
+    uiLanguage?: string;
+    links?: LegalLinksSource;
+    /** Open the withdrawal function; the consent dialog closes (declined) first. */
+    onWithdraw?: () => void;
+    /** After the consent was recorded — refresh an account feed, say. */
+    onRecorded?: (response: PerformanceConsentResponse) => void;
+}
+export interface PerformanceConsentControl {
+    view: PerformanceConsentView | null;
+    /** From the last read; `null` before any. */
+    required: boolean | null;
+    /**
+     * `true` when no consent is needed or it was confirmed and recorded, `false` on a decline or a
+     * closed dialog. Reads the view fresh; a failed read answers `true`. Concurrent calls share one
+     * pending answer — one dialog.
+     */
+    ensure: (opts?: EnsureOptions) => Promise<boolean>;
+    refresh: () => Promise<PerformanceConsentView | null>;
+    /** Spread into ONE `PerformanceConsentDialog`. */
+    dialog: PerformanceConsentDialogProps;
+}
+/**
+ * The spend consent over two protocols — the view (`consent` GET) and the record (`giveConsent`
+ * POST) of `makeConsumerRightsProtocols` — bound with `ctx.entrypoint(protocol)`.
+ */
+export declare const usePerformanceConsent: <RecordRequest extends BodyRequest<PerformanceConsentBody>>(view: RegisteredEntrypoint<{}, PerformanceConsentView>, record: RegisteredEntrypoint<RecordRequest, PerformanceConsentResponse>, opts?: UsePerformanceConsentOptions) => PerformanceConsentControl;
+export interface UseSubscriptionStartOptions {
+    uiLanguage?: string;
+    links?: LegalLinksSource;
+    onWithdraw?: () => void;
+}
+export interface SubscriptionStartParams {
+    /** The plan's title as the application names it — part of the statement. */
+    planTitle: string;
+    /** The price line the dialog shows above the statement. */
+    price?: ReactNode;
+}
+export interface SubscriptionStartControl {
+    /**
+     * The start request id to send with the subscription checkout (`CreateCheckoutBody.
+     * startRequestId`); `''` when none is needed (or the view could not be read — the checkout's
+     * own refusal then decides); `null` when the person declined or closed the dialog.
+     */
+    ensure: (planSku: string, params: SubscriptionStartParams) => Promise<string | null>;
+    view: SubscriptionStartView | null;
+    /** Spread into ONE `SubscriptionStartDialog`. */
+    dialog: SubscriptionStartDialogProps;
+}
+/**
+ * The subscription start request over the `start` GET (`?planSku`) and `requestStart` POST
+ * protocols, asked right before a subscription checkout.
+ */
+export declare const useSubscriptionStart: <ViewRequest extends RequestShape & {
+    query: SubscriptionStartQuery;
+}, RecordRequest extends BodyRequest<SubscriptionStartBody>>(view: RegisteredEntrypoint<ViewRequest, SubscriptionStartView>, record: RegisteredEntrypoint<RecordRequest, SubscriptionStartResponse>, opts?: UseSubscriptionStartOptions) => SubscriptionStartControl;
+export interface DeclarationControl<Body, Receipt> {
+    /** Send the declaration; the revived receipt, or `null` when it failed (`error` holds why). */
+    submit: (body: Body) => Promise<Receipt | null>;
+    receipt: Receipt | null;
+    pending: boolean;
+    error: unknown;
+    /** Forget the receipt and the error — before the form is shown again. */
+    reset: () => void;
+}
+export interface WithdrawalControl<Receipt extends DeclarationReceipt> extends DeclarationControl<WithdrawalBody, Receipt> {
+    /** In-app: the contracts that can still be withdrawn from; `null` before the first read. */
+    list: WithdrawalCandidateList | null;
+    load: () => Promise<WithdrawalCandidateList | null>;
+    /** Spread into a `WithdrawalForm` / `WithdrawalDialog` (with `mode` and `language`). */
+    form: {
+        list: WithdrawalCandidateList | null;
+        pending: boolean;
+        error: boolean;
+        receipt: Receipt | null;
+        onSubmit: (body: WithdrawalBody) => Promise<Receipt | null>;
+    };
+}
+/**
+ * The withdrawal function over the `withdrawals` GET (in-app; `null` on the public page) and a
+ * `withdraw` POST — the account one answers a `WithdrawalReceipt`, the public one a
+ * `DeclarationReceipt`.
+ */
+export declare const useWithdrawal: <Request extends BodyRequest<WithdrawalBody>, Receipt extends DeclarationReceipt>(list: RegisteredEntrypoint<{}, WithdrawalCandidateList> | null, withdraw: RegisteredEntrypoint<Request, Receipt>, opts?: {
+    enabled?: boolean;
+}) => WithdrawalControl<Receipt>;
+export interface CancellationControl<Receipt extends DeclarationReceipt> extends DeclarationControl<CancellationBody, Receipt> {
+    /** Spread into a `CancellationForm` (with `mode` and `language`). */
+    form: {
+        pending: boolean;
+        error: boolean;
+        receipt: Receipt | null;
+        onSubmit: (body: CancellationBody) => Promise<Receipt | null>;
+    };
+}
+/**
+ * The cancellation function over a `cancel` POST — the account one answers a
+ * `CancellationReceipt`, the public one a `DeclarationReceipt`.
+ */
+export declare const useCancellation: <Request extends BodyRequest<CancellationBody>, Receipt extends DeclarationReceipt>(cancel: RegisteredEntrypoint<Request, Receipt>) => CancellationControl<Receipt>;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/build/consumer/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/consumer/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACzF,OAAO,KAAK,EAAiB,oBAAoB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAI7F,OAAO,KAAK,EACV,gBAAgB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,sBAAsB,EAChH,qBAAqB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,cAAc,EAC/G,uBAAuB,EACxB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3D,OAAO,KAAK,EACV,gBAAgB,EAAE,6BAA6B,EAAE,4BAA4B,EAC9E,MAAM,YAAY,CAAA;AAEnB,uFAAuF;AACvF,KAAK,WAAW,CAAC,IAAI,IAAI,YAAY,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAA;AAMtD,MAAM,WAAW,4BAA4B;IAC3C,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;IACvB,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,IAAI,CAAA;CAC5D;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAAA;IACnC,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB;;;;OAIG;IACH,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAClD,OAAO,EAAE,MAAM,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAA;IACrD,kDAAkD;IAClD,MAAM,EAAE,6BAA6B,CAAA;CACtC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,SAAS,WAAW,CAAC,sBAAsB,CAAC,QACvF,oBAAoB,CAAC,EAAE,EAAE,sBAAsB,CAAC,UAC9C,oBAAoB,CAAC,aAAa,EAAE,0BAA0B,CAAC,SACjE,4BAA4B,KACjC,yBAuEF,CAAA;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACpF,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAA;IAClC,iDAAiD;IACjD,MAAM,EAAE,4BAA4B,CAAA;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,WAAW,SAAS,YAAY,GAAG;IAAE,KAAK,EAAE,sBAAsB,CAAA;CAAE,EACpE,aAAa,SAAS,WAAW,CAAC,qBAAqB,CAAC,QAElD,oBAAoB,CAAC,WAAW,EAAE,qBAAqB,CAAC,UACtD,oBAAoB,CAAC,aAAa,EAAE,yBAAyB,CAAC,SAChE,2BAA2B,KAChC,wBAyDF,CAAA;AAED,MAAM,WAAW,kBAAkB,CAAC,IAAI,EAAE,OAAO;IAC/C,+FAA+F;IAC/F,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAC/C,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,yEAAyE;IACzE,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAoCD,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,kBAAkB,CAAE,SAAQ,kBAAkB,CAAC,cAAc,EAAE,OAAO,CAAC;IACxH,4FAA4F;IAC5F,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAAA;IACpC,IAAI,EAAE,MAAM,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAA;IACnD,wFAAwF;IACxF,IAAI,EAAE;QACJ,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAAA;QACpC,OAAO,EAAE,OAAO,CAAA;QAChB,KAAK,EAAE,OAAO,CAAA;QACd,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;QACvB,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;KAC5D,CAAA;CACF;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,SAAS,WAAW,CAAC,cAAc,CAAC,EAAE,OAAO,SAAS,kBAAkB,QACrG,oBAAoB,CAAC,EAAE,EAAE,uBAAuB,CAAC,GAAG,IAAI,YACpD,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,SAC1C;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KAC1B,iBAAiB,CAAC,OAAO,CAmC3B,CAAA;AAED,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,kBAAkB,CAAE,SAAQ,kBAAkB,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAC5H,qEAAqE;IACrE,IAAI,EAAE;QACJ,OAAO,EAAE,OAAO,CAAA;QAChB,KAAK,EAAE,OAAO,CAAA;QACd,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;QACvB,QAAQ,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;KAC9D,CAAA;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,SAAS,WAAW,CAAC,gBAAgB,CAAC,EAAE,OAAO,SAAS,kBAAkB,UACvG,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,KAC7C,mBAAmB,CAAC,OAAO,CAY7B,CAAA"}

package/build/consumer/hooks.js

@@ -0,0 +1,225 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { reviveConsentResponse, reviveConsentView, reviveReceipt, reviveStartResponse, reviveWithdrawalList, } from '@owlmeans/payment';
+import { makeAsker } from './ensure.js';
+import { isConsentRefusal } from './refusal.js';
+/** One call argument built by the hook — the protocol's own `CallArguments`, completed here. */
+const argsOf = (request) => [request];
+/**
+ * The spend consent over two protocols — the view (`consent` GET) and the record (`giveConsent`
+ * POST) of `makeConsumerRightsProtocols` — bound with `ctx.entrypoint(protocol)`.
+ */
+export const usePerformanceConsent = (view, record, opts = {}) => {
+    const viewRef = useRef(view);
+    viewRef.current = view;
+    const recordRef = useRef(record);
+    recordRef.current = record;
+    const optsRef = useRef(opts);
+    optsRef.current = opts;
+    const [current, setCurrent] = useState(null);
+    const [open, setOpen] = useState(false);
+    const [pending, setPending] = useState(false);
+    const [error, setError] = useState(false);
+    const load = useCallback(async () => {
+        const next = reviveConsentView(await viewRef.current.call());
+        setCurrent(next);
+        return next;
+    }, []);
+    const asker = useMemo(() => makeAsker({
+        load, required: next => next.required, skip: true,
+        show: () => { setError(false); setOpen(true); },
+    }), [load]);
+    useEffect(() => {
+        if (opts.enabled === true)
+            void load().catch(() => undefined);
+    }, [opts.enabled, load]);
+    const decline = useCallback(() => {
+        setOpen(false);
+        asker.settle(false);
+    }, [asker]);
+    const onConfirm = useCallback(async (body) => {
+        setPending(true);
+        setError(false);
+        try {
+            const response = reviveConsentResponse(await recordRef.current.call(...argsOf({ body })));
+            setCurrent(held => held == null ? held : { ...held, required: false, purchases: [] });
+            setOpen(false);
+            asker.settle(true);
+            optsRef.current.onRecorded?.(response);
+        }
+        catch (e) {
+            setError(true);
+            // A stale text version is refused with a 428: show the current wording to confirm again.
+            if (isConsentRefusal(e))
+                void load().catch(() => undefined);
+        }
+        finally {
+            setPending(false);
+        }
+    }, [asker, load]);
+    const refresh = useCallback(async () => {
+        try {
+            return await load();
+        }
+        catch {
+            return null;
+        }
+    }, [load]);
+    const ensure = useCallback(async () => await asker.ask(), [asker]);
+    const onWithdraw = opts.onWithdraw;
+    const dialog = {
+        open, view: current, pending, error, onConfirm, onDecline: decline,
+        onOpenChange: next => { if (next)
+            setOpen(true);
+        else
+            decline(); },
+        uiLanguage: opts.uiLanguage,
+        links: opts.links,
+        onWithdraw: onWithdraw != null ? () => { decline(); onWithdraw(); } : undefined,
+    };
+    return { view: current, required: current?.required ?? null, ensure, refresh, dialog };
+};
+/**
+ * The subscription start request over the `start` GET (`?planSku`) and `requestStart` POST
+ * protocols, asked right before a subscription checkout.
+ */
+export const useSubscriptionStart = (view, record, opts = {}) => {
+    const viewRef = useRef(view);
+    viewRef.current = view;
+    const recordRef = useRef(record);
+    recordRef.current = record;
+    const [current, setCurrent] = useState(null);
+    const [params, setParams] = useState({ planTitle: '' });
+    const [open, setOpen] = useState(false);
+    const [pending, setPending] = useState(false);
+    const [error, setError] = useState(false);
+    const asker = useMemo(() => makeAsker({
+        load: async (planSku, next) => {
+            const answer = await viewRef.current.call(...argsOf({ query: { planSku } }));
+            setCurrent(answer);
+            setParams(next);
+            return answer;
+        },
+        required: next => next.required,
+        skip: '',
+        show: () => { setError(false); setOpen(true); },
+    }), []);
+    const decline = useCallback(() => {
+        setOpen(false);
+        asker.settle(null);
+    }, [asker]);
+    const onConfirm = useCallback(async (body) => {
+        setPending(true);
+        setError(false);
+        try {
+            const response = reviveStartResponse(await recordRef.current.call(...argsOf({ body })));
+            setOpen(false);
+            asker.settle(response.startRequestId);
+        }
+        catch {
+            setError(true);
+        }
+        finally {
+            setPending(false);
+        }
+    }, [asker]);
+    const ensure = useCallback(async (planSku, next) => await asker.ask(planSku, next), [asker]);
+    const onWithdraw = opts.onWithdraw;
+    const dialog = {
+        open, view: current, planTitle: params.planTitle, price: params.price, pending, error, onConfirm,
+        onDecline: decline,
+        onOpenChange: next => { if (next)
+            setOpen(true);
+        else
+            decline(); },
+        uiLanguage: opts.uiLanguage,
+        links: opts.links,
+        onWithdraw: onWithdraw != null ? () => { decline(); onWithdraw(); } : undefined,
+    };
+    return { ensure, view: current, dialog };
+};
+/** The submit half both statutory functions share: one protocol, one receipt. */
+const useDeclaration = (entry) => {
+    const entryRef = useRef(entry);
+    entryRef.current = entry;
+    const [receipt, setReceipt] = useState(null);
+    const [pending, setPending] = useState(false);
+    const [error, setError] = useState(null);
+    const submit = useCallback(async (body) => {
+        setPending(true);
+        setError(null);
+        try {
+            const answer = reviveReceipt(await entryRef.current.call(...argsOf({ body })));
+            setReceipt(answer);
+            return answer;
+        }
+        catch (e) {
+            setError(e);
+            return null;
+        }
+        finally {
+            setPending(false);
+        }
+    }, []);
+    const reset = useCallback(() => {
+        setReceipt(null);
+        setError(null);
+    }, []);
+    return { submit, receipt, pending, error, reset };
+};
+/**
+ * The withdrawal function over the `withdrawals` GET (in-app; `null` on the public page) and a
+ * `withdraw` POST — the account one answers a `WithdrawalReceipt`, the public one a
+ * `DeclarationReceipt`.
+ */
+export const useWithdrawal = (list, withdraw, opts = {}) => {
+    const listRef = useRef(list);
+    listRef.current = list;
+    const [candidates, setCandidates] = useState(null);
+    const declaration = useDeclaration(withdraw);
+    const load = useCallback(async () => {
+        if (listRef.current == null) {
+            return null;
+        }
+        try {
+            const next = reviveWithdrawalList(await listRef.current.call());
+            setCandidates(next);
+            return next;
+        }
+        catch {
+            return null;
+        }
+    }, []);
+    useEffect(() => {
+        if (opts.enabled === true)
+            void load();
+    }, [opts.enabled, load]);
+    return {
+        ...declaration,
+        list: candidates,
+        load,
+        form: {
+            list: candidates,
+            pending: declaration.pending,
+            error: declaration.error != null,
+            receipt: declaration.receipt,
+            onSubmit: declaration.submit,
+        },
+    };
+};
+/**
+ * The cancellation function over a `cancel` POST — the account one answers a
+ * `CancellationReceipt`, the public one a `DeclarationReceipt`.
+ */
+export const useCancellation = (cancel) => {
+    const declaration = useDeclaration(cancel);
+    return {
+        ...declaration,
+        form: {
+            pending: declaration.pending,
+            error: declaration.error != null,
+            receipt: declaration.receipt,
+            onSubmit: declaration.submit,
+        },
+    };
+};
+//# sourceMappingURL=hooks.js.map