@mj-biz-apps/orders-ng 5.20.0 → 5.22.0

package/dist/lib/checkout-widget/checkout-account.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The post-payment account step as the public checkout shows it (#292). Pure, so it can be tested
+ * without the host component.
+ *
+ * `/complete` answers with `AccountStep: true` when a host registered an account step; the widget
+ * then asks `/checkout/account` for it. `Created` with `CanSetPassword` shows a password form;
+ * `Exists` and `Failed` show a message, and `Failed` offers to try again. No `Account` means no
+ * step, and the checkout behaves as it always has.
+ */
+export type CheckoutAccountOutcome = 'Created' | 'Exists' | 'Failed';
+export interface CheckoutAccountView {
+    Outcome: CheckoutAccountOutcome;
+    Message?: string;
+    CanSetPassword: boolean;
+    /** The host will e-mail a link the buyer must use before the account signs in. */
+    VerificationRequired?: boolean;
+}
+/** Shown when the account step could not be reached or did not answer. */
+export declare const ACCOUNT_STEP_FAILED: CheckoutAccountView;
+/** The account the server reported, or null when the response carries none (no step registered). */
+export declare function ReadCheckoutAccount(raw: unknown): CheckoutAccountView | null;
+/** The note shown with the password form when the host will send a verification link. */
+export declare function VerificationNote(account: CheckoutAccountView | null): string | null;
+/** The line shown under the confirmation when no password form is showing. */
+export declare function AccountMessage(account: CheckoutAccountView, passwordSet: boolean): string | null;
+/** Why the two entries cannot be sent, or null when they can. The host's own policy is checked by the server. */
+export declare function CheckPasswordEntry(password: string, confirmation: string): string | null;
+/**
+ * Whether the checkout may leave for its redirect: not while the buyer can still set a password or
+ * try a failed step again, unless the buyer chose to leave it.
+ */
+export declare function MayRedirect(account: CheckoutAccountView | null, dismissed?: boolean): boolean;
+/** True once nothing about the account step is left to do, so a reload need not come back to it. */
+export declare function IsAccountSettled(account: CheckoutAccountView | null): boolean;
+//# sourceMappingURL=checkout-account.d.ts.map

package/dist/lib/checkout-widget/checkout-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-account.d.ts","sourceRoot":"","sources":["../../../src/lib/checkout-widget/checkout-account.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,sBAAsB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,EAAE,mBAAkE,CAAC;AAErG,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAU5E;AAID,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEnF;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAUhG;AAED,iHAAiH;AACjH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIxF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,EAAE,SAAS,UAAQ,GAAG,OAAO,CAG3F;AAED,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAAG,OAAO,CAE7E"}

package/dist/lib/checkout-widget/checkout-account.js

@@ -0,0 +1,67 @@
+/**
+ * The post-payment account step as the public checkout shows it (#292). Pure, so it can be tested
+ * without the host component.
+ *
+ * `/complete` answers with `AccountStep: true` when a host registered an account step; the widget
+ * then asks `/checkout/account` for it. `Created` with `CanSetPassword` shows a password form;
+ * `Exists` and `Failed` show a message, and `Failed` offers to try again. No `Account` means no
+ * step, and the checkout behaves as it always has.
+ */
+/** Shown when the account step could not be reached or did not answer. */
+export const ACCOUNT_STEP_FAILED = { Outcome: 'Failed', CanSetPassword: false };
+/** The account the server reported, or null when the response carries none (no step registered). */
+export function ReadCheckoutAccount(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const a = raw;
+    if (a['Outcome'] !== 'Created' && a['Outcome'] !== 'Exists' && a['Outcome'] !== 'Failed')
+        return null;
+    return {
+        Outcome: a['Outcome'],
+        Message: typeof a['Message'] === 'string' && a['Message'] ? a['Message'] : undefined,
+        CanSetPassword: a['CanSetPassword'] === true,
+        VerificationRequired: a['Outcome'] === 'Created' && a['VerificationRequired'] === true,
+    };
+}
+const VERIFY_NOTE = 'We are sending a link to your e-mail. Use it to verify your account before you sign in.';
+/** The note shown with the password form when the host will send a verification link. */
+export function VerificationNote(account) {
+    return account?.VerificationRequired ? VERIFY_NOTE : null;
+}
+/** The line shown under the confirmation when no password form is showing. */
+export function AccountMessage(account, passwordSet) {
+    if (passwordSet) {
+        return account.VerificationRequired
+            ? 'Your password is set. Check your e-mail for the link to verify your account, then sign in with the e-mail you used here.'
+            : 'Your password is set. You can now sign in with the e-mail you used here.';
+    }
+    if (account.Message)
+        return account.Message;
+    if (account.Outcome === 'Exists')
+        return 'You already have an account with this e-mail. Sign in, or reset your password if you have forgotten it.';
+    if (account.Outcome === 'Failed')
+        return 'We could not set up your account just now. Your order is confirmed. Please try again in a moment.';
+    return VerificationNote(account);
+}
+/** Why the two entries cannot be sent, or null when they can. The host's own policy is checked by the server. */
+export function CheckPasswordEntry(password, confirmation) {
+    if (!password)
+        return 'Please enter a password.';
+    if (password !== confirmation)
+        return 'The two passwords do not match.';
+    return null;
+}
+/**
+ * Whether the checkout may leave for its redirect: not while the buyer can still set a password or
+ * try a failed step again, unless the buyer chose to leave it.
+ */
+export function MayRedirect(account, dismissed = false) {
+    if (dismissed || !account)
+        return true;
+    return !account.CanSetPassword && account.Outcome !== 'Failed';
+}
+/** True once nothing about the account step is left to do, so a reload need not come back to it. */
+export function IsAccountSettled(account) {
+    return !account || (account.Outcome !== 'Failed' && !account.CanSetPassword);
+}
+//# sourceMappingURL=checkout-account.js.map

package/dist/lib/checkout-widget/checkout-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-account.js","sourceRoot":"","sources":["../../../src/lib/checkout-widget/checkout-account.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAwB,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;AAErG,oGAAoG;AACpG,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC5C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACtG,OAAO;QACH,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;QACpF,cAAc,EAAE,CAAC,CAAC,gBAAgB,CAAC,KAAK,IAAI;QAC5C,oBAAoB,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,sBAAsB,CAAC,KAAK,IAAI;KACzF,CAAC;AACN,CAAC;AAED,MAAM,WAAW,GAAG,yFAAyF,CAAC;AAE9G,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAAC,OAAmC;IAChE,OAAO,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAAC,OAA4B,EAAE,WAAoB;IAC7E,IAAI,WAAW,EAAE,CAAC;QACd,OAAO,OAAO,CAAC,oBAAoB;YAC/B,CAAC,CAAC,0HAA0H;YAC5H,CAAC,CAAC,0EAA0E,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC;IAC5C,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,yGAAyG,CAAC;IACnJ,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,mGAAmG,CAAC;IAC7I,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,YAAoB;IACrE,IAAI,CAAC,QAAQ;QAAE,OAAO,0BAA0B,CAAC;IACjD,IAAI,QAAQ,KAAK,YAAY;QAAE,OAAO,iCAAiC,CAAC;IACxE,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAmC,EAAE,SAAS,GAAG,KAAK;IAC9E,IAAI,SAAS,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,CAAC,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC;AACnE,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,gBAAgB,CAAC,OAAmC;IAChE,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;AACjF,CAAC"}

package/dist/lib/checkout-widget/checkout-events.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The DOM events the public checkout element dispatches for its host page (#294).
+ *
+ * Host pages track a checkout funnel — Google Tag Manager, GA4, their own scripts — by listening on
+ * `<mj-orders-checkout>` or on `document`. Every event bubbles and is `composed`, so it crosses a
+ * shadow root. These builders are the element's public contract, kept pure so it is testable.
+ *
+ * NO PERSONAL DATA IN ANY DETAIL. The events reach every script on the host page, so no detail
+ * carries the buyer's e-mail, name or anything they typed beyond the promotion code.
+ */
+/** The element's state, as `checkout-state-change` reports it. */
+export type CheckoutElementState = 'LOADING' | 'CHECKOUT' | 'PROCESSING' | 'PASSWORD' | 'SUCCESS' | 'ERROR';
+export declare const CHECKOUT_STATE_CHANGE_EVENT = "checkout-state-change";
+export declare const CHECKOUT_COMPLETE_EVENT = "checkout-complete";
+export declare const CHECKOUT_ERROR_EVENT = "checkout-error";
+/** The buyer pressed Cancel; the form has been reset. */
+export declare const CHECKOUT_CANCEL_EVENT = "checkout-cancel";
+/** The checkout asks its container to close, e.g. a modal on the host page. Sent with Cancel. */
+export declare const CHECKOUT_CLOSE_EVENT = "checkout-close";
+/** Dispatched ON the element by an embedding host to return it to a blank form. */
+export declare const CHECKOUT_RESET_REQUEST_EVENT = "checkout-reset";
+/** The element refused a reset because a payment is in flight. */
+export declare const CHECKOUT_RESET_REFUSED_EVENT = "checkout-reset-refused";
+export interface CheckoutStateChangeDetail {
+    state: CheckoutElementState;
+}
+/** The `checkout-complete` detail. Shaped for GA4: `amount` in major units, `currency` upper-case. */
+export interface CheckoutCompleteDetail {
+    sessionId: string;
+    productName: string | null;
+    productId: string | null;
+    amount: number | null;
+    currency: string | null;
+    coupon: string | null;
+}
+export interface CheckoutErrorDetail {
+    message: string;
+}
+export interface CheckoutCompleteSource {
+    sessionId: string;
+    productName?: unknown;
+    productId?: unknown;
+    /** The order's charged total from `/complete`, already in major units. */
+    totalGross?: unknown;
+    currency?: unknown;
+    /** The promotion code the buyer applied, if any. */
+    coupon?: unknown;
+}
+export declare function BuildCheckoutCompleteDetail(source: CheckoutCompleteSource): CheckoutCompleteDetail;
+/** A bubbling, composed CustomEvent — the only shape the element dispatches. */
+export declare function CheckoutElementEvent<T>(name: string, detail: T): CustomEvent<T>;
+//# sourceMappingURL=checkout-events.d.ts.map

package/dist/lib/checkout-widget/checkout-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-events.d.ts","sourceRoot":"","sources":["../../../src/lib/checkout-widget/checkout-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5G,eAAO,MAAM,2BAA2B,0BAA0B,CAAC;AACnE,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAC3D,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,iGAAiG;AACjG,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,mFAAmF;AACnF,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAC7D,kEAAkE;AAClE,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AAErE,MAAM,WAAW,yBAAyB;IACtC,KAAK,EAAE,oBAAoB,CAAC;CAC/B;AAED,sGAAsG;AACtG,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,CAWlG;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAE/E"}

package/dist/lib/checkout-widget/checkout-events.js

@@ -0,0 +1,39 @@
+/**
+ * The DOM events the public checkout element dispatches for its host page (#294).
+ *
+ * Host pages track a checkout funnel — Google Tag Manager, GA4, their own scripts — by listening on
+ * `<mj-orders-checkout>` or on `document`. Every event bubbles and is `composed`, so it crosses a
+ * shadow root. These builders are the element's public contract, kept pure so it is testable.
+ *
+ * NO PERSONAL DATA IN ANY DETAIL. The events reach every script on the host page, so no detail
+ * carries the buyer's e-mail, name or anything they typed beyond the promotion code.
+ */
+export const CHECKOUT_STATE_CHANGE_EVENT = 'checkout-state-change';
+export const CHECKOUT_COMPLETE_EVENT = 'checkout-complete';
+export const CHECKOUT_ERROR_EVENT = 'checkout-error';
+/** The buyer pressed Cancel; the form has been reset. */
+export const CHECKOUT_CANCEL_EVENT = 'checkout-cancel';
+/** The checkout asks its container to close, e.g. a modal on the host page. Sent with Cancel. */
+export const CHECKOUT_CLOSE_EVENT = 'checkout-close';
+/** Dispatched ON the element by an embedding host to return it to a blank form. */
+export const CHECKOUT_RESET_REQUEST_EVENT = 'checkout-reset';
+/** The element refused a reset because a payment is in flight. */
+export const CHECKOUT_RESET_REFUSED_EVENT = 'checkout-reset-refused';
+const text = (value) => (typeof value === 'string' && value.trim() ? value.trim() : null);
+export function BuildCheckoutCompleteDetail(source) {
+    const amount = typeof source.totalGross === 'number' && Number.isFinite(source.totalGross) ? source.totalGross : null;
+    const currency = text(source.currency);
+    return {
+        sessionId: source.sessionId,
+        productName: text(source.productName),
+        productId: text(source.productId),
+        amount: amount === null ? null : Math.round(amount * 100) / 100,
+        currency: currency === null ? null : currency.toUpperCase(),
+        coupon: text(source.coupon),
+    };
+}
+/** A bubbling, composed CustomEvent — the only shape the element dispatches. */
+export function CheckoutElementEvent(name, detail) {
+    return new CustomEvent(name, { detail, bubbles: true, composed: true });
+}
+//# sourceMappingURL=checkout-events.js.map

package/dist/lib/checkout-widget/checkout-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-events.js","sourceRoot":"","sources":["../../../src/lib/checkout-widget/checkout-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAAC;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACrD,yDAAyD;AACzD,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AACvD,iGAAiG;AACjG,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACrD,mFAAmF;AACnF,MAAM,CAAC,MAAM,4BAA4B,GAAG,gBAAgB,CAAC;AAC7D,kEAAkE;AAClE,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AA+BrE,MAAM,IAAI,GAAG,CAAC,KAAc,EAAiB,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAElH,MAAM,UAAU,2BAA2B,CAAC,MAA8B;IACtE,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACtH,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO;QACH,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACrC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACjC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG;QAC/D,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE;QAC3D,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;KAC9B,CAAC;AACN,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAI,IAAY,EAAE,MAAS;IAC3D,OAAO,IAAI,WAAW,CAAI,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/lib/checkout-widget/checkout-public-host.component.d.ts

@@ -7,6 +7,7 @@
  * (and usable as a normal Angular component in Explorer or any host app).
  */
 import { AfterViewChecked, OnDestroy, OnInit } from '@angular/core';
+import { type CheckoutAccountView } from './checkout-account.js';
 import { type CheckoutSubmissionEvent, type CheckoutWidgetConfig } from './checkout-widget.component.js';
 import * as i0 from "@angular/core";
 export { buildCheckoutDraftLine } from './checkout-draft-line.js';
@@ -16,6 +17,7 @@ interface StripeCard {
         complete?: boolean;
     }) => void): void;
     unmount?(): void;
+    destroy?(): void;
 }
 interface StripeInstance {
     elements(): {
@@ -57,21 +59,99 @@ export declare class CheckoutPublicHostComponent implements OnInit, AfterViewChe
     loadError: string | null;
     successMessage: string | null;
     orderNumber: string | null;
+    /** The post-payment account step, when the host registered one (#292). */
+    account: CheckoutAccountView | null;
+    password: string;
+    passwordConfirmation: string;
+    passwordError: string | null;
+    passwordBusy: boolean;
+    passwordSet: boolean;
+    /** True while the account step is being asked for. */
+    accountLoading: boolean;
+    /** The buyer chose to leave a failed account step. */
+    private accountDismissed;
+    get accountMessage(): string | null;
+    get verificationNote(): string | null;
     private stripe;
     private card;
     private cardMounted;
     private destroyed;
+    private state;
+    /** Bumped by Cancel: the template re-creates the widget, which clears everything the buyer entered. */
+    formGeneration: number;
+    /** From the element's attributes, for a host that embeds the checkout in its own panel. */
+    prefillEmail: string | null;
+    private attributionSource;
+    private attributionReference;
+    private readonly onResetRequested;
     get isFree(): boolean;
     ngOnInit(): Promise<void>;
     ngAfterViewChecked(): void;
     ngOnDestroy(): void;
+    /**
+     * Cancel resets the checkout to a blank form and tells the host page, which may close the modal
+     * the checkout sits in. The widget is re-created, so every field the buyer filled in is cleared,
+     * and the card field is mounted again on the new form. The session stays open for the next try.
+     */
     onCancelled(): void;
+    /**
+     * A reset the embedding host asked for, by dispatching `checkout-reset` on the element (a voice
+     * or chat agent closing its panel, say). Refused while a payment is in flight — resetting then
+     * would strand a charge the buyer cannot see. Unlike Cancel it sends no `checkout-cancel` or
+     * `checkout-close`: the host started it. Also refused while the account step after a sale is
+     * unsettled, since the buyer could not come back to it.
+     *
+     * A reset always starts a new session, before a sale as well as after one: the server matches
+     * the buyer's person record once per session, so a kept session would carry the previous
+     * conversation's buyer into the next. The e-mail and attribution are read again, so a host
+     * starting a new conversation sets them on the element before it dispatches the reset.
+     */
+    private resetRequested;
+    /** The account step is still asking the buyer for something, and the buyer has not left it. */
+    private get accountUnsettled();
+    /**
+     * Back to a blank form: every field, the error banner and the card entry. The session stays open.
+     * The caller reports the state, since a host reset reports `LOADING` next, not `CHECKOUT`.
+     */
+    private resetForm;
     onSubmitted(event: CheckoutSubmissionEvent): Promise<void>;
     private finish;
+    /** Asks for the account step of the completed checkout. The host is asked again only after a failure. */
+    private loadAccount;
+    /** Asks the host again after the account step failed. */
+    retryAccount(): Promise<void>;
+    /** Leaves a failed account step. A reload of this checkout in the same tab offers it again. */
+    dismissAccount(): void;
+    /**
+     * A reload after payment: when this tab completed a checkout whose account step is not settled,
+     * shows the confirmation and the account step instead of a new checkout.
+     */
+    private resumeAccountStep;
+    /** Sends the new account's password. The host's policy decides; its message is shown when it refuses. */
+    submitPassword(): Promise<void>;
+    /** Leaves the password for later: the buyer can reset it at sign-in. */
+    skipPassword(): void;
+    /** Follows the widget's redirect once nothing is left for the buyer to do here. */
+    private leaveIfDone;
+    /** Reports a state the host page can track; repeats of the same state are not re-sent. */
+    private setState;
+    private reportError;
+    /** Dispatches on the `<mj-orders-checkout>` element; bubbling and composed, so `document` hears it too. */
+    private dispatch;
     private mountStripe;
     private loadStripe;
     private readHostAttributes;
+    /**
+     * For a host that embeds the checkout in its own panel: an e-mail it already knows, and where the
+     * checkout came from. The server keeps the attribution only if it reads as one.
+     */
+    private readConversationAttributes;
+    private forgetClientKey;
     private clientKey;
+    private get completingKey();
+    private rememberCompleting;
+    private forgetCompleting;
+    private completingSession;
     private post;
     private str;
     static ɵfac: i0.ɵɵFactoryDeclaration<CheckoutPublicHostComponent, never>;

package/dist/lib/checkout-widget/checkout-public-host.component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout-public-host.component.d.ts","sourceRoot":"","sources":["../../../src/lib/checkout-widget/checkout-public-host.component.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACH,gBAAgB,EAKhB,SAAS,EACT,MAAM,EAET,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEH,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAC5B,MAAM,6BAA6B,CAAC;;AAQrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,UAAU,UAAU;IAChB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAC1C,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACvE,OAAO,CAAC,IAAI,IAAI,CAAC;CACpB;AAED,UAAU,cAAc;IACpB,QAAQ,IAAI;QAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAC;IACjD,kBAAkB,CACd,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;QAAE,cAAc,EAAE;YAAE,IAAI,EAAE,UAAU,CAAC;YAAC,eAAe,CAAC,EAAE;gBAAE,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,GACrF,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,aAAa,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CACrF;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,cAAc,CAAC;KACvD;CACJ;AAED,qBAOa,2BAA4B,YAAW,MAAM,EAAE,gBAAgB,EAAE,SAAS;IACnF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IAEjC,IAAI,SAAM;IACV,OAAO,SAAe;IAE/B,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IAC3C,UAAU,SAAM;IAChB,SAAS,SAAM;IACf,UAAU,UAAS;IACnB,cAAc,UAAS;IACvB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IACrC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEzC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAE1B,IAAW,MAAM,IAAI,OAAO,CAE3B;IAEY,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC/B,kBAAkB,IAAI,IAAI;IAc1B,WAAW,IAAI,IAAI;IASnB,WAAW,IAAI,IAAI;IAIb,WAAW,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;YAgEzD,MAAM;YAkBN,WAAW;IAoBzB,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,SAAS;YA+BH,IAAI;IAYlB,OAAO,CAAC,GAAG;yCAtRF,2BAA2B;2CAA3B,2BAA2B;CAyRvC"}
+{"version":3,"file":"checkout-public-host.component.d.ts","sourceRoot":"","sources":["../../../src/lib/checkout-widget/checkout-public-host.component.ts"],"names":[],"mappings":"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"}