@trymellon/js 2.2.0 → 2.3.0

package/dist/ui/index.d.ts

@@ -7,7 +7,7 @@ declare const INITIAL_UI_STATE: "IDLE";
 /** UI FSM types — presentation layer. No DOM/core deps (types only). Aligned to 01-arquitectura §4. */
 
 /** UI state machine states. */
-type UIState = 'IDLE' | 'EVALUATING_ENV' | 'READY' | 'READY_REGISTER' | 'READY_LOGIN' | 'AUTHENTICATING' | 'SUCCESS' | 'ERROR' | 'FALLBACK' | 'FALLBACK_EMAIL' | 'FALLBACK_QR';
+type UIState = 'IDLE' | 'EVALUATING_ENV' | 'READY' | 'READY_REGISTER' | 'READY_LOGIN' | 'AUTHENTICATING' | 'SUCCESS' | 'ERROR' | 'FALLBACK' | 'FALLBACK_EMAIL' | 'FALLBACK_QR' | 'ENROLLMENT_READY' | 'ENROLLING' | 'ENROLLMENT_SUCCESS' | 'ENROLLMENT_ERROR';
 /** Component mode (mode attribute). */
 type UIMode = 'login' | 'register' | 'auto';
 /** Client status in UI layer (port/adapter map from core). */
@@ -54,6 +54,19 @@ type FSMEvent = {
     type: 'AUTH_FALLBACK_EMAIL';
 } | {
     type: 'AUTH_FALLBACK_QR';
+} | {
+    type: 'ENROLLMENT_READY_SET';
+    payload?: {
+        ticketId?: string;
+    };
+} | {
+    type: 'START_ENROLL';
+} | {
+    type: 'ENROLL_SUCCESS';
+} | {
+    type: 'ENROLL_ERROR';
+} | {
+    type: 'ENROLL_RETRY';
 };
 
 /**
@@ -104,6 +117,8 @@ type ParsedAttributes = {
     buttonLabel?: string | null;
     /** Optional aria-label for the trigger button (default = TRIGGER_ARIA_LABEL). */
     buttonAriaLabel?: string | null;
+    /** When set, WC runs in enrollment mode: emits context-ready and exposes enroll(). */
+    ticketId?: string | null;
 };
 /** Modal display mode: overlay vs inline. */
 type ModalDisplayMode = 'modal' | 'inline';
@@ -158,13 +173,18 @@ type RenderOptions = {
     primaryButtonAriaLabel?: string;
 };
 
+type EnrollOptions = {
+    ticketId: string;
+    signal?: AbortSignal;
+};
+
 /**
  * Port: core event subscription and re-emission on host. Source of truth for modal WC event contract (names, detail types).
  * Contract only; implementation in adapters. No import from ../core.
  */
 
-/** Public auth operation for host (login | register). */
-type AuthOperation = TabKind;
+/** Public auth operation for host (login | register | enroll). */
+type AuthOperation = TabKind | 'enroll';
 /** Optional user info in mellon:success; minimal shape for host without coupling to core. */
 type MellonSuccessUserInfo = {
     userId: string;
@@ -216,10 +236,12 @@ interface CoreWithEvents {
 interface CoreEventsPort {
     subscribe(core: CoreWithEvents, host: HTMLElement): () => void;
 }
-/** Minimal core surface for UI: start auth and subscribe to events. */
+/** Minimal core surface for UI: start auth, enrollment, context hash, and subscribe to events. */
 interface CoreAuthPort extends CoreWithEvents {
     authenticate(options?: CoreAuthOptions): void;
     register(options?: CoreAuthOptions): void;
+    enroll(options?: EnrollOptions): void;
+    getContextHash(): string;
 }
 /** Options when starting auth from UI. */
 interface CoreAuthOptions {
@@ -253,8 +275,13 @@ declare class AuthController {
     consumeCancelledDetailIfAuthenticating(): MellonOperationDetail | null;
     handleAuthSuccess(): void;
     handleAuthError(): void;
+    handleEnrollSuccess(): void;
+    handleEnrollError(): void;
     onStartEvent(detail: MellonOperationDetail | undefined): void;
     startAuthFromClick(core: CoreAuthPort | null, tab: TabKind, options?: CoreAuthOptions): void;
+    startEnrollment(core: CoreAuthPort | null, options: {
+        ticketId: string;
+    }): void;
     runEnvEval(params: Omit<RunEnvEvalParams, 'currentState'>): Promise<UIState | null>;
     reset(): void;
     setStateForRender(state: UIState): void;
@@ -340,6 +367,8 @@ declare abstract class AuthElementBase extends HTMLElement {
 declare class TryMellonAuthElement extends AuthElementBase {
     static get observedAttributes(): string[];
     protected _parsed: ParsedAttributes;
+    /** When set, WC is in enrollment mode: emits context-ready and exposes enroll(). */
+    get ticketId(): string | null;
     private _internalModal;
     /** Element that opened the modal; single source for focus restore on close. */
     private _focusRestoreTarget;
@@ -348,6 +377,12 @@ declare class TryMellonAuthElement extends AuthElementBase {
     /** Re-dispatch modal success on this element so host can listen on <trymellon-auth> (modal is in body, events don't bubble here). */
     private _onInternalModalSuccess;
     private _restoreFocusToTrigger;
+    /** When ticket-id is set and core is attached, emits mellon:context-ready with contextHash (composed: true). */
+    private _emitContextReadyIfEnrollment;
+    /**
+     * Starts enrollment (only when ticket-id is set). No-op if no ticketId or core. Success/error re-dispatched via mellon:success / mellon:error.
+     */
+    enroll(): void;
     connectedCallback(): void;
     private _registerInteractions;
     attributeChangedCallback(name: string, _oldValue: string | null, _newValue: string | null): void;
@@ -389,6 +424,8 @@ declare class TryMellonAuthModalElement extends AuthElementBase {
     connectedCallback(): void;
     private _registerInteractions;
     attributeChangedCallback(name: string, oldValue: string | null, _newValue: string | null): void;
+    /** Clear any host-injected cross-device slot content so each open starts with a clean slot (avoids stacked QRs). */
+    private _clearCrossDeviceSlot;
     private _startQrLoadWait;
     private _clearQrLoadWait;
     /** Single path to IDLE: close event, cancelled if needed, reset FSM, structure, render, visibility. Called from open→false and reset(). */