@trymellon/js 2.2.1 → 2.3.0

package/dist/react.cjs

@@ -1,3 +1,3 @@
 "use client";
-"use strict";var c=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var h=(e,t)=>{for(var r in t)c(e,r,{get:t[r],enumerable:!0})},E=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of d(t))!x.call(e,o)&&o!==r&&c(e,o,{get:()=>t[o],enumerable:!(n=A(t,o))||n.enumerable});return e};var S=e=>E(c({},"__esModule",{value:!0}),e);var O={};h(O,{TryMellonProvider:()=>y,useAuthenticate:()=>f,useRegister:()=>R,useTryMellon:()=>l});module.exports=S(O);var i=require("react"),m=require("react/jsx-runtime"),a=(0,i.createContext)(null);function y(e){return(0,m.jsx)(a.Provider,{value:e.client,children:e.children})}function l(){let e=(0,i.useContext)(a);if(e==null)throw new Error("useTryMellon must be used within TryMellonProvider");return e}var T=require("react");var u=require("react");function p(e){let[t,r]=(0,u.useState)({result:null,loading:!1,error:null}),n=(0,u.useCallback)(async o=>{r(g=>({...g,loading:!0,error:null,result:null}));let s=await e(o);return r({result:s,loading:!1,error:s.ok?null:s.error}),s},[e]);return{result:t.result,loading:t.loading,error:t.error,execute:n}}function R(){let e=l(),t=(0,T.useCallback)(r=>e.register(r),[e]);return p(t)}var M=require("react");function f(){let e=l(),t=(0,M.useCallback)(r=>e.authenticate(r),[e]);return p(t)}
+"use strict";var y=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var S=Object.getOwnPropertyNames;var O=Object.prototype.hasOwnProperty;var U=(e,t)=>{for(var r in t)y(e,r,{get:t[r],enumerable:!0})},C=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of S(t))!O.call(e,o)&&o!==r&&y(e,o,{get:()=>t[o],enumerable:!(n=h(t,o))||n.enumerable});return e};var b=e=>C(y({},"__esModule",{value:!0}),e);var P={};U(P,{TryMellonProvider:()=>T,useAuthenticate:()=>x,useEnroll:()=>g,useRegister:()=>M,useTryMellon:()=>l});module.exports=b(P);var p=require("react"),R=require("react/jsx-runtime"),m=(0,p.createContext)(null);function T(e){return(0,R.jsx)(m.Provider,{value:e.client,children:e.children})}function l(){let e=(0,p.useContext)(m);if(e==null)throw new Error("useTryMellon must be used within TryMellonProvider");return e}var f=require("react");var c=require("react");function u(e){let[t,r]=(0,c.useState)({result:null,loading:!1,error:null}),n=(0,c.useCallback)(async o=>{r(a=>({...a,loading:!0,error:null,result:null}));let s=await e(o);return r({result:s,loading:!1,error:s.ok?null:s.error}),s},[e]);return{result:t.result,loading:t.loading,error:t.error,execute:n}}function M(){let e=l(),t=(0,f.useCallback)(r=>e.register(r),[e]);return u(t)}var E=require("react");function x(){let e=l(),t=(0,E.useCallback)(r=>e.authenticate(r),[e]);return u(t)}var i=require("react");function g(){let e=l(),[t,r]=(0,i.useState)("");(0,i.useEffect)(()=>{r(e.getContextHash())},[e]);let n=(0,i.useCallback)(d=>e.enroll(d),[e]),{result:o,loading:s,error:a,execute:A}=u(n);return{result:o,loading:s,error:a,execute:A,contextHash:t}}
 //# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/index.ts","../src/react/context.tsx","../src/react/use-register.tsx","../src/react/use-action.ts","../src/react/use-authenticate.tsx"],"sourcesContent":["export { TryMellonProvider, useTryMellon } from './context';\nexport { useRegister } from './use-register';\nexport { useAuthenticate } from './use-authenticate';\n","import { createContext, useContext, type ReactNode } from 'react';\nimport type { TryMellon } from '../core/trymellon';\n\nconst TryMellonContext = createContext<TryMellon | null>(null);\n\nexport function TryMellonProvider(props: { client: TryMellon; children: ReactNode }) {\n  return (\n    <TryMellonContext.Provider value={props.client}>{props.children}</TryMellonContext.Provider>\n  );\n}\n\nexport function useTryMellon(): TryMellon {\n  const client = useContext(TryMellonContext);\n  if (client == null) {\n    throw new Error('useTryMellon must be used within TryMellonProvider');\n  }\n  return client;\n}\n","import { useCallback } from 'react';\nimport { useTryMellon } from './context';\nimport { useTryMellonAction, type UseActionState } from './use-action';\nimport type { RegisterOptions, RegisterResult } from '../types';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseRegisterState = UseActionState<RegisterResult>;\n\nexport function useRegister(): {\n  result: Result<RegisterResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n  execute: (options: RegisterOptions) => Promise<Result<RegisterResult, TryMellonError>>;\n} {\n  const client = useTryMellon();\n  const action = useCallback((options: RegisterOptions) => client.register(options), [client]);\n  return useTryMellonAction(action);\n}\n","import { useState, useCallback } from 'react';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseActionState<TResult> = {\n  result: Result<TResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n};\n\nexport function useTryMellonAction<TOptions, TResult>(\n  action: (options: TOptions) => Promise<Result<TResult, TryMellonError>>\n) {\n  const [state, setState] = useState<UseActionState<TResult>>({\n    result: null,\n    loading: false,\n    error: null,\n  });\n\n  const execute = useCallback(\n    async (options: TOptions) => {\n      setState((s) => ({ ...s, loading: true, error: null, result: null }));\n      const result = await action(options);\n      setState({\n        result,\n        loading: false,\n        error: result.ok ? null : result.error,\n      });\n      return result;\n    },\n    [action]\n  );\n\n  return {\n    result: state.result,\n    loading: state.loading,\n    error: state.error,\n    execute,\n  };\n}\n","import { useCallback } from 'react';\nimport { useTryMellon } from './context';\nimport { useTryMellonAction, type UseActionState } from './use-action';\nimport type { AuthenticateOptions, AuthenticateResult } from '../types';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseAuthenticateState = UseActionState<AuthenticateResult>;\n\nexport function useAuthenticate(): {\n  result: Result<AuthenticateResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n  execute: (options: AuthenticateOptions) => Promise<Result<AuthenticateResult, TryMellonError>>;\n} {\n  const client = useTryMellon();\n  const action = useCallback(\n    (options: AuthenticateOptions) => client.authenticate(options),\n    [client]\n  );\n  return useTryMellonAction(action);\n}\n"],"mappings":";yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,uBAAAE,EAAA,oBAAAC,EAAA,gBAAAC,EAAA,iBAAAC,IAAA,eAAAC,EAAAN,GCAA,IAAAO,EAA0D,iBAOtDC,EAAA,6BAJEC,KAAmB,iBAAgC,IAAI,EAEtD,SAASC,EAAkBC,EAAmD,CACnF,SACE,OAACF,EAAiB,SAAjB,CAA0B,MAAOE,EAAM,OAAS,SAAAA,EAAM,SAAS,CAEpE,CAEO,SAASC,GAA0B,CACxC,IAAMC,KAAS,cAAWJ,CAAgB,EAC1C,GAAII,GAAU,KACZ,MAAM,IAAI,MAAM,oDAAoD,EAEtE,OAAOA,CACT,CCjBA,IAAAC,EAA4B,iBCA5B,IAAAC,EAAsC,iBAU/B,SAASC,EACdC,EACA,CACA,GAAM,CAACC,EAAOC,CAAQ,KAAI,YAAkC,CAC1D,OAAQ,KACR,QAAS,GACT,MAAO,IACT,CAAC,EAEKC,KAAU,eACd,MAAOC,GAAsB,CAC3BF,EAAUG,IAAO,CAAE,GAAGA,EAAG,QAAS,GAAM,MAAO,KAAM,OAAQ,IAAK,EAAE,EACpE,IAAMC,EAAS,MAAMN,EAAOI,CAAO,EACnC,OAAAF,EAAS,CACP,OAAAI,EACA,QAAS,GACT,MAAOA,EAAO,GAAK,KAAOA,EAAO,KACnC,CAAC,EACMA,CACT,EACA,CAACN,CAAM,CACT,EAEA,MAAO,CACL,OAAQC,EAAM,OACd,QAASA,EAAM,QACf,MAAOA,EAAM,MACb,QAAAE,CACF,CACF,CD9BO,SAASI,GAKd,CACA,IAAMC,EAASC,EAAa,EACtBC,KAAS,eAAaC,GAA6BH,EAAO,SAASG,CAAO,EAAG,CAACH,CAAM,CAAC,EAC3F,OAAOI,EAAmBF,CAAM,CAClC,CElBA,IAAAG,EAA4B,iBASrB,SAASC,GAKd,CACA,IAAMC,EAASC,EAAa,EACtBC,KAAS,eACZC,GAAiCH,EAAO,aAAaG,CAAO,EAC7D,CAACH,CAAM,CACT,EACA,OAAOI,EAAmBF,CAAM,CAClC","names":["react_exports","__export","TryMellonProvider","useAuthenticate","useRegister","useTryMellon","__toCommonJS","import_react","import_jsx_runtime","TryMellonContext","TryMellonProvider","props","useTryMellon","client","import_react","import_react","useTryMellonAction","action","state","setState","execute","options","s","result","useRegister","client","useTryMellon","action","options","useTryMellonAction","import_react","useAuthenticate","client","useTryMellon","action","options","useTryMellonAction"]}
+{"version":3,"sources":["../src/react/index.ts","../src/react/context.tsx","../src/react/use-register.tsx","../src/react/use-action.ts","../src/react/use-authenticate.tsx","../src/react/use-enroll.tsx"],"sourcesContent":["export { TryMellonProvider, useTryMellon } from './context';\nexport { useRegister } from './use-register';\nexport { useAuthenticate } from './use-authenticate';\nexport { useEnroll } from './use-enroll';\n","import { createContext, useContext, type ReactNode } from 'react';\nimport type { TryMellon } from '../core/trymellon';\n\nconst TryMellonContext = createContext<TryMellon | null>(null);\n\nexport function TryMellonProvider(props: { client: TryMellon; children: ReactNode }) {\n  return (\n    <TryMellonContext.Provider value={props.client}>{props.children}</TryMellonContext.Provider>\n  );\n}\n\nexport function useTryMellon(): TryMellon {\n  const client = useContext(TryMellonContext);\n  if (client == null) {\n    throw new Error('useTryMellon must be used within TryMellonProvider');\n  }\n  return client;\n}\n","import { useCallback } from 'react';\nimport { useTryMellon } from './context';\nimport { useTryMellonAction, type UseActionState } from './use-action';\nimport type { RegisterOptions, RegisterResult } from '../types';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseRegisterState = UseActionState<RegisterResult>;\n\nexport function useRegister(): {\n  result: Result<RegisterResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n  execute: (options: RegisterOptions) => Promise<Result<RegisterResult, TryMellonError>>;\n} {\n  const client = useTryMellon();\n  const action = useCallback((options: RegisterOptions) => client.register(options), [client]);\n  return useTryMellonAction(action);\n}\n","import { useState, useCallback } from 'react';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseActionState<TResult> = {\n  result: Result<TResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n};\n\nexport function useTryMellonAction<TOptions, TResult>(\n  action: (options: TOptions) => Promise<Result<TResult, TryMellonError>>\n) {\n  const [state, setState] = useState<UseActionState<TResult>>({\n    result: null,\n    loading: false,\n    error: null,\n  });\n\n  const execute = useCallback(\n    async (options: TOptions) => {\n      setState((s) => ({ ...s, loading: true, error: null, result: null }));\n      const result = await action(options);\n      setState({\n        result,\n        loading: false,\n        error: result.ok ? null : result.error,\n      });\n      return result;\n    },\n    [action]\n  );\n\n  return {\n    result: state.result,\n    loading: state.loading,\n    error: state.error,\n    execute,\n  };\n}\n","import { useCallback } from 'react';\nimport { useTryMellon } from './context';\nimport { useTryMellonAction, type UseActionState } from './use-action';\nimport type { AuthenticateOptions, AuthenticateResult } from '../types';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseAuthenticateState = UseActionState<AuthenticateResult>;\n\nexport function useAuthenticate(): {\n  result: Result<AuthenticateResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n  execute: (options: AuthenticateOptions) => Promise<Result<AuthenticateResult, TryMellonError>>;\n} {\n  const client = useTryMellon();\n  const action = useCallback(\n    (options: AuthenticateOptions) => client.authenticate(options),\n    [client]\n  );\n  return useTryMellonAction(action);\n}\n","import { useCallback, useState, useEffect } from 'react';\nimport { useTryMellon } from './context';\nimport { useTryMellonAction, type UseActionState } from './use-action';\nimport type { EnrollOptions, EnrollmentResult } from '../types';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseEnrollState = UseActionState<EnrollmentResult>;\n\nexport function useEnroll(): {\n  result: Result<EnrollmentResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n  execute: (options: EnrollOptions) => Promise<Result<EnrollmentResult, TryMellonError>>;\n  contextHash: string;\n} {\n  const client = useTryMellon();\n  const [contextHash, setContextHash] = useState('');\n\n  useEffect(() => {\n    setContextHash(client.getContextHash());\n  }, [client]);\n\n  const action = useCallback((options: EnrollOptions) => client.enroll(options), [client]);\n  const { result, loading, error, execute } = useTryMellonAction(action);\n\n  return {\n    result,\n    loading,\n    error,\n    execute,\n    contextHash,\n  };\n}\n"],"mappings":";yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,uBAAAE,EAAA,oBAAAC,EAAA,cAAAC,EAAA,gBAAAC,EAAA,iBAAAC,IAAA,eAAAC,EAAAP,GCAA,IAAAQ,EAA0D,iBAOtDC,EAAA,6BAJEC,KAAmB,iBAAgC,IAAI,EAEtD,SAASC,EAAkBC,EAAmD,CACnF,SACE,OAACF,EAAiB,SAAjB,CAA0B,MAAOE,EAAM,OAAS,SAAAA,EAAM,SAAS,CAEpE,CAEO,SAASC,GAA0B,CACxC,IAAMC,KAAS,cAAWJ,CAAgB,EAC1C,GAAII,GAAU,KACZ,MAAM,IAAI,MAAM,oDAAoD,EAEtE,OAAOA,CACT,CCjBA,IAAAC,EAA4B,iBCA5B,IAAAC,EAAsC,iBAU/B,SAASC,EACdC,EACA,CACA,GAAM,CAACC,EAAOC,CAAQ,KAAI,YAAkC,CAC1D,OAAQ,KACR,QAAS,GACT,MAAO,IACT,CAAC,EAEKC,KAAU,eACd,MAAOC,GAAsB,CAC3BF,EAAUG,IAAO,CAAE,GAAGA,EAAG,QAAS,GAAM,MAAO,KAAM,OAAQ,IAAK,EAAE,EACpE,IAAMC,EAAS,MAAMN,EAAOI,CAAO,EACnC,OAAAF,EAAS,CACP,OAAAI,EACA,QAAS,GACT,MAAOA,EAAO,GAAK,KAAOA,EAAO,KACnC,CAAC,EACMA,CACT,EACA,CAACN,CAAM,CACT,EAEA,MAAO,CACL,OAAQC,EAAM,OACd,QAASA,EAAM,QACf,MAAOA,EAAM,MACb,QAAAE,CACF,CACF,CD9BO,SAASI,GAKd,CACA,IAAMC,EAASC,EAAa,EACtBC,KAAS,eAAaC,GAA6BH,EAAO,SAASG,CAAO,EAAG,CAACH,CAAM,CAAC,EAC3F,OAAOI,EAAmBF,CAAM,CAClC,CElBA,IAAAG,EAA4B,iBASrB,SAASC,GAKd,CACA,IAAMC,EAASC,EAAa,EACtBC,KAAS,eACZC,GAAiCH,EAAO,aAAaG,CAAO,EAC7D,CAACH,CAAM,CACT,EACA,OAAOI,EAAmBF,CAAM,CAClC,CCrBA,IAAAG,EAAiD,iBAS1C,SAASC,GAMd,CACA,IAAMC,EAASC,EAAa,EACtB,CAACC,EAAaC,CAAc,KAAI,YAAS,EAAE,KAEjD,aAAU,IAAM,CACdA,EAAeH,EAAO,eAAe,CAAC,CACxC,EAAG,CAACA,CAAM,CAAC,EAEX,IAAMI,KAAS,eAAaC,GAA2BL,EAAO,OAAOK,CAAO,EAAG,CAACL,CAAM,CAAC,EACjF,CAAE,OAAAM,EAAQ,QAAAC,EAAS,MAAAC,EAAO,QAAAC,CAAQ,EAAIC,EAAmBN,CAAM,EAErE,MAAO,CACL,OAAAE,EACA,QAAAC,EACA,MAAAC,EACA,QAAAC,EACA,YAAAP,CACF,CACF","names":["react_exports","__export","TryMellonProvider","useAuthenticate","useEnroll","useRegister","useTryMellon","__toCommonJS","import_react","import_jsx_runtime","TryMellonContext","TryMellonProvider","props","useTryMellon","client","import_react","import_react","useTryMellonAction","action","state","setState","execute","options","s","result","useRegister","client","useTryMellon","action","options","useTryMellonAction","import_react","useAuthenticate","client","useTryMellon","action","options","useTryMellonAction","import_react","useEnroll","client","useTryMellon","contextHash","setContextHash","action","options","result","loading","error","execute","useTryMellonAction"]}

package/dist/react.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { T as TryMellon, R as Result, a as RegisterResult, b as TryMellonError, c as RegisterOptions, A as AuthenticateResult, d as AuthenticateOptions } from './trymellon-P7BPxIry.cjs';
+import { T as TryMellon, R as Result, a as RegisterResult, b as TryMellonError, c as RegisterOptions, A as AuthenticateResult, d as AuthenticateOptions, E as EnrollmentResult, e as EnrollOptions } from './trymellon-DItEFTiv.cjs';
 
 declare function TryMellonProvider(props: {
     client: TryMellon;
@@ -22,4 +22,12 @@ declare function useAuthenticate(): {
     execute: (options: AuthenticateOptions) => Promise<Result<AuthenticateResult, TryMellonError>>;
 };
 
-export { TryMellonProvider, useAuthenticate, useRegister, useTryMellon };
+declare function useEnroll(): {
+    result: Result<EnrollmentResult, TryMellonError> | null;
+    loading: boolean;
+    error: TryMellonError | null;
+    execute: (options: EnrollOptions) => Promise<Result<EnrollmentResult, TryMellonError>>;
+    contextHash: string;
+};
+
+export { TryMellonProvider, useAuthenticate, useEnroll, useRegister, useTryMellon };

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { T as TryMellon, R as Result, a as RegisterResult, b as TryMellonError, c as RegisterOptions, A as AuthenticateResult, d as AuthenticateOptions } from './trymellon-P7BPxIry.js';
+import { T as TryMellon, R as Result, a as RegisterResult, b as TryMellonError, c as RegisterOptions, A as AuthenticateResult, d as AuthenticateOptions, E as EnrollmentResult, e as EnrollOptions } from './trymellon-DItEFTiv.js';
 
 declare function TryMellonProvider(props: {
     client: TryMellon;
@@ -22,4 +22,12 @@ declare function useAuthenticate(): {
     execute: (options: AuthenticateOptions) => Promise<Result<AuthenticateResult, TryMellonError>>;
 };
 
-export { TryMellonProvider, useAuthenticate, useRegister, useTryMellon };
+declare function useEnroll(): {
+    result: Result<EnrollmentResult, TryMellonError> | null;
+    loading: boolean;
+    error: TryMellonError | null;
+    execute: (options: EnrollOptions) => Promise<Result<EnrollmentResult, TryMellonError>>;
+    contextHash: string;
+};
+
+export { TryMellonProvider, useAuthenticate, useEnroll, useRegister, useTryMellon };

package/dist/react.js

@@ -1,3 +1,3 @@
 "use client";
-import{createContext as c,useContext as a}from"react";import{jsx as m}from"react/jsx-runtime";var s=c(null);function y(e){return m(s.Provider,{value:e.client,children:e.children})}function o(){let e=a(s);if(e==null)throw new Error("useTryMellon must be used within TryMellonProvider");return e}import{useCallback as M}from"react";import{useState as T,useCallback as R}from"react";function n(e){let[t,r]=T({result:null,loading:!1,error:null}),i=R(async u=>{r(p=>({...p,loading:!0,error:null,result:null}));let l=await e(u);return r({result:l,loading:!1,error:l.ok?null:l.error}),l},[e]);return{result:t.result,loading:t.loading,error:t.error,execute:i}}function f(){let e=o(),t=M(r=>e.register(r),[e]);return n(t)}import{useCallback as g}from"react";function A(){let e=o(),t=g(r=>e.authenticate(r),[e]);return n(t)}export{y as TryMellonProvider,A as useAuthenticate,f as useRegister,o as useTryMellon};
+import{createContext as y,useContext as m}from"react";import{jsx as R}from"react/jsx-runtime";var p=y(null);function T(e){return R(p.Provider,{value:e.client,children:e.children})}function o(){let e=m(p);if(e==null)throw new Error("useTryMellon must be used within TryMellonProvider");return e}import{useCallback as E}from"react";import{useState as f,useCallback as M}from"react";function n(e){let[t,r]=f({result:null,loading:!1,error:null}),s=M(async u=>{r(i=>({...i,loading:!0,error:null,result:null}));let l=await e(u);return r({result:l,loading:!1,error:l.ok?null:l.error}),l},[e]);return{result:t.result,loading:t.loading,error:t.error,execute:s}}function x(){let e=o(),t=E(r=>e.register(r),[e]);return n(t)}import{useCallback as g}from"react";function A(){let e=o(),t=g(r=>e.authenticate(r),[e]);return n(t)}import{useCallback as d,useState as h,useEffect as S}from"react";function O(){let e=o(),[t,r]=h("");S(()=>{r(e.getContextHash())},[e]);let s=d(a=>e.enroll(a),[e]),{result:u,loading:l,error:i,execute:c}=n(s);return{result:u,loading:l,error:i,execute:c,contextHash:t}}export{T as TryMellonProvider,A as useAuthenticate,O as useEnroll,x as useRegister,o as useTryMellon};
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/context.tsx","../src/react/use-register.tsx","../src/react/use-action.ts","../src/react/use-authenticate.tsx"],"sourcesContent":["import { createContext, useContext, type ReactNode } from 'react';\nimport type { TryMellon } from '../core/trymellon';\n\nconst TryMellonContext = createContext<TryMellon | null>(null);\n\nexport function TryMellonProvider(props: { client: TryMellon; children: ReactNode }) {\n  return (\n    <TryMellonContext.Provider value={props.client}>{props.children}</TryMellonContext.Provider>\n  );\n}\n\nexport function useTryMellon(): TryMellon {\n  const client = useContext(TryMellonContext);\n  if (client == null) {\n    throw new Error('useTryMellon must be used within TryMellonProvider');\n  }\n  return client;\n}\n","import { useCallback } from 'react';\nimport { useTryMellon } from './context';\nimport { useTryMellonAction, type UseActionState } from './use-action';\nimport type { RegisterOptions, RegisterResult } from '../types';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseRegisterState = UseActionState<RegisterResult>;\n\nexport function useRegister(): {\n  result: Result<RegisterResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n  execute: (options: RegisterOptions) => Promise<Result<RegisterResult, TryMellonError>>;\n} {\n  const client = useTryMellon();\n  const action = useCallback((options: RegisterOptions) => client.register(options), [client]);\n  return useTryMellonAction(action);\n}\n","import { useState, useCallback } from 'react';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseActionState<TResult> = {\n  result: Result<TResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n};\n\nexport function useTryMellonAction<TOptions, TResult>(\n  action: (options: TOptions) => Promise<Result<TResult, TryMellonError>>\n) {\n  const [state, setState] = useState<UseActionState<TResult>>({\n    result: null,\n    loading: false,\n    error: null,\n  });\n\n  const execute = useCallback(\n    async (options: TOptions) => {\n      setState((s) => ({ ...s, loading: true, error: null, result: null }));\n      const result = await action(options);\n      setState({\n        result,\n        loading: false,\n        error: result.ok ? null : result.error,\n      });\n      return result;\n    },\n    [action]\n  );\n\n  return {\n    result: state.result,\n    loading: state.loading,\n    error: state.error,\n    execute,\n  };\n}\n","import { useCallback } from 'react';\nimport { useTryMellon } from './context';\nimport { useTryMellonAction, type UseActionState } from './use-action';\nimport type { AuthenticateOptions, AuthenticateResult } from '../types';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseAuthenticateState = UseActionState<AuthenticateResult>;\n\nexport function useAuthenticate(): {\n  result: Result<AuthenticateResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n  execute: (options: AuthenticateOptions) => Promise<Result<AuthenticateResult, TryMellonError>>;\n} {\n  const client = useTryMellon();\n  const action = useCallback(\n    (options: AuthenticateOptions) => client.authenticate(options),\n    [client]\n  );\n  return useTryMellonAction(action);\n}\n"],"mappings":";AAAA,OAAS,iBAAAA,EAAe,cAAAC,MAAkC,QAOtD,cAAAC,MAAA,oBAJJ,IAAMC,EAAmBH,EAAgC,IAAI,EAEtD,SAASI,EAAkBC,EAAmD,CACnF,OACEH,EAACC,EAAiB,SAAjB,CAA0B,MAAOE,EAAM,OAAS,SAAAA,EAAM,SAAS,CAEpE,CAEO,SAASC,GAA0B,CACxC,IAAMC,EAASN,EAAWE,CAAgB,EAC1C,GAAII,GAAU,KACZ,MAAM,IAAI,MAAM,oDAAoD,EAEtE,OAAOA,CACT,CCjBA,OAAS,eAAAC,MAAmB,QCA5B,OAAS,YAAAC,EAAU,eAAAC,MAAmB,QAU/B,SAASC,EACdC,EACA,CACA,GAAM,CAACC,EAAOC,CAAQ,EAAIL,EAAkC,CAC1D,OAAQ,KACR,QAAS,GACT,MAAO,IACT,CAAC,EAEKM,EAAUL,EACd,MAAOM,GAAsB,CAC3BF,EAAUG,IAAO,CAAE,GAAGA,EAAG,QAAS,GAAM,MAAO,KAAM,OAAQ,IAAK,EAAE,EACpE,IAAMC,EAAS,MAAMN,EAAOI,CAAO,EACnC,OAAAF,EAAS,CACP,OAAAI,EACA,QAAS,GACT,MAAOA,EAAO,GAAK,KAAOA,EAAO,KACnC,CAAC,EACMA,CACT,EACA,CAACN,CAAM,CACT,EAEA,MAAO,CACL,OAAQC,EAAM,OACd,QAASA,EAAM,QACf,MAAOA,EAAM,MACb,QAAAE,CACF,CACF,CD9BO,SAASI,GAKd,CACA,IAAMC,EAASC,EAAa,EACtBC,EAASC,EAAaC,GAA6BJ,EAAO,SAASI,CAAO,EAAG,CAACJ,CAAM,CAAC,EAC3F,OAAOK,EAAmBH,CAAM,CAClC,CElBA,OAAS,eAAAI,MAAmB,QASrB,SAASC,GAKd,CACA,IAAMC,EAASC,EAAa,EACtBC,EAASC,EACZC,GAAiCJ,EAAO,aAAaI,CAAO,EAC7D,CAACJ,CAAM,CACT,EACA,OAAOK,EAAmBH,CAAM,CAClC","names":["createContext","useContext","jsx","TryMellonContext","TryMellonProvider","props","useTryMellon","client","useCallback","useState","useCallback","useTryMellonAction","action","state","setState","execute","options","s","result","useRegister","client","useTryMellon","action","useCallback","options","useTryMellonAction","useCallback","useAuthenticate","client","useTryMellon","action","useCallback","options","useTryMellonAction"]}
+{"version":3,"sources":["../src/react/context.tsx","../src/react/use-register.tsx","../src/react/use-action.ts","../src/react/use-authenticate.tsx","../src/react/use-enroll.tsx"],"sourcesContent":["import { createContext, useContext, type ReactNode } from 'react';\nimport type { TryMellon } from '../core/trymellon';\n\nconst TryMellonContext = createContext<TryMellon | null>(null);\n\nexport function TryMellonProvider(props: { client: TryMellon; children: ReactNode }) {\n  return (\n    <TryMellonContext.Provider value={props.client}>{props.children}</TryMellonContext.Provider>\n  );\n}\n\nexport function useTryMellon(): TryMellon {\n  const client = useContext(TryMellonContext);\n  if (client == null) {\n    throw new Error('useTryMellon must be used within TryMellonProvider');\n  }\n  return client;\n}\n","import { useCallback } from 'react';\nimport { useTryMellon } from './context';\nimport { useTryMellonAction, type UseActionState } from './use-action';\nimport type { RegisterOptions, RegisterResult } from '../types';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseRegisterState = UseActionState<RegisterResult>;\n\nexport function useRegister(): {\n  result: Result<RegisterResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n  execute: (options: RegisterOptions) => Promise<Result<RegisterResult, TryMellonError>>;\n} {\n  const client = useTryMellon();\n  const action = useCallback((options: RegisterOptions) => client.register(options), [client]);\n  return useTryMellonAction(action);\n}\n","import { useState, useCallback } from 'react';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseActionState<TResult> = {\n  result: Result<TResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n};\n\nexport function useTryMellonAction<TOptions, TResult>(\n  action: (options: TOptions) => Promise<Result<TResult, TryMellonError>>\n) {\n  const [state, setState] = useState<UseActionState<TResult>>({\n    result: null,\n    loading: false,\n    error: null,\n  });\n\n  const execute = useCallback(\n    async (options: TOptions) => {\n      setState((s) => ({ ...s, loading: true, error: null, result: null }));\n      const result = await action(options);\n      setState({\n        result,\n        loading: false,\n        error: result.ok ? null : result.error,\n      });\n      return result;\n    },\n    [action]\n  );\n\n  return {\n    result: state.result,\n    loading: state.loading,\n    error: state.error,\n    execute,\n  };\n}\n","import { useCallback } from 'react';\nimport { useTryMellon } from './context';\nimport { useTryMellonAction, type UseActionState } from './use-action';\nimport type { AuthenticateOptions, AuthenticateResult } from '../types';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseAuthenticateState = UseActionState<AuthenticateResult>;\n\nexport function useAuthenticate(): {\n  result: Result<AuthenticateResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n  execute: (options: AuthenticateOptions) => Promise<Result<AuthenticateResult, TryMellonError>>;\n} {\n  const client = useTryMellon();\n  const action = useCallback(\n    (options: AuthenticateOptions) => client.authenticate(options),\n    [client]\n  );\n  return useTryMellonAction(action);\n}\n","import { useCallback, useState, useEffect } from 'react';\nimport { useTryMellon } from './context';\nimport { useTryMellonAction, type UseActionState } from './use-action';\nimport type { EnrollOptions, EnrollmentResult } from '../types';\nimport type { TryMellonError } from '../errors';\nimport type { Result } from '../utils/result';\n\nexport type UseEnrollState = UseActionState<EnrollmentResult>;\n\nexport function useEnroll(): {\n  result: Result<EnrollmentResult, TryMellonError> | null;\n  loading: boolean;\n  error: TryMellonError | null;\n  execute: (options: EnrollOptions) => Promise<Result<EnrollmentResult, TryMellonError>>;\n  contextHash: string;\n} {\n  const client = useTryMellon();\n  const [contextHash, setContextHash] = useState('');\n\n  useEffect(() => {\n    setContextHash(client.getContextHash());\n  }, [client]);\n\n  const action = useCallback((options: EnrollOptions) => client.enroll(options), [client]);\n  const { result, loading, error, execute } = useTryMellonAction(action);\n\n  return {\n    result,\n    loading,\n    error,\n    execute,\n    contextHash,\n  };\n}\n"],"mappings":";AAAA,OAAS,iBAAAA,EAAe,cAAAC,MAAkC,QAOtD,cAAAC,MAAA,oBAJJ,IAAMC,EAAmBH,EAAgC,IAAI,EAEtD,SAASI,EAAkBC,EAAmD,CACnF,OACEH,EAACC,EAAiB,SAAjB,CAA0B,MAAOE,EAAM,OAAS,SAAAA,EAAM,SAAS,CAEpE,CAEO,SAASC,GAA0B,CACxC,IAAMC,EAASN,EAAWE,CAAgB,EAC1C,GAAII,GAAU,KACZ,MAAM,IAAI,MAAM,oDAAoD,EAEtE,OAAOA,CACT,CCjBA,OAAS,eAAAC,MAAmB,QCA5B,OAAS,YAAAC,EAAU,eAAAC,MAAmB,QAU/B,SAASC,EACdC,EACA,CACA,GAAM,CAACC,EAAOC,CAAQ,EAAIL,EAAkC,CAC1D,OAAQ,KACR,QAAS,GACT,MAAO,IACT,CAAC,EAEKM,EAAUL,EACd,MAAOM,GAAsB,CAC3BF,EAAUG,IAAO,CAAE,GAAGA,EAAG,QAAS,GAAM,MAAO,KAAM,OAAQ,IAAK,EAAE,EACpE,IAAMC,EAAS,MAAMN,EAAOI,CAAO,EACnC,OAAAF,EAAS,CACP,OAAAI,EACA,QAAS,GACT,MAAOA,EAAO,GAAK,KAAOA,EAAO,KACnC,CAAC,EACMA,CACT,EACA,CAACN,CAAM,CACT,EAEA,MAAO,CACL,OAAQC,EAAM,OACd,QAASA,EAAM,QACf,MAAOA,EAAM,MACb,QAAAE,CACF,CACF,CD9BO,SAASI,GAKd,CACA,IAAMC,EAASC,EAAa,EACtBC,EAASC,EAAaC,GAA6BJ,EAAO,SAASI,CAAO,EAAG,CAACJ,CAAM,CAAC,EAC3F,OAAOK,EAAmBH,CAAM,CAClC,CElBA,OAAS,eAAAI,MAAmB,QASrB,SAASC,GAKd,CACA,IAAMC,EAASC,EAAa,EACtBC,EAASC,EACZC,GAAiCJ,EAAO,aAAaI,CAAO,EAC7D,CAACJ,CAAM,CACT,EACA,OAAOK,EAAmBH,CAAM,CAClC,CCrBA,OAAS,eAAAI,EAAa,YAAAC,EAAU,aAAAC,MAAiB,QAS1C,SAASC,GAMd,CACA,IAAMC,EAASC,EAAa,EACtB,CAACC,EAAaC,CAAc,EAAIC,EAAS,EAAE,EAEjDC,EAAU,IAAM,CACdF,EAAeH,EAAO,eAAe,CAAC,CACxC,EAAG,CAACA,CAAM,CAAC,EAEX,IAAMM,EAASC,EAAaC,GAA2BR,EAAO,OAAOQ,CAAO,EAAG,CAACR,CAAM,CAAC,EACjF,CAAE,OAAAS,EAAQ,QAAAC,EAAS,MAAAC,EAAO,QAAAC,CAAQ,EAAIC,EAAmBP,CAAM,EAErE,MAAO,CACL,OAAAG,EACA,QAAAC,EACA,MAAAC,EACA,QAAAC,EACA,YAAAV,CACF,CACF","names":["createContext","useContext","jsx","TryMellonContext","TryMellonProvider","props","useTryMellon","client","useCallback","useState","useCallback","useTryMellonAction","action","state","setState","execute","options","s","result","useRegister","client","useTryMellon","action","useCallback","options","useTryMellonAction","useCallback","useAuthenticate","client","useTryMellon","action","useCallback","options","useTryMellonAction","useCallback","useState","useEffect","useEnroll","client","useTryMellon","contextHash","setContextHash","useState","useEffect","action","useCallback","options","result","loading","error","execute","useTryMellonAction"]}

package/dist/{trymellon-P7BPxIry.d.cts → trymellon-DItEFTiv.d.cts}

@@ -1,4 +1,4 @@
-type TryMellonErrorCode = 'NOT_SUPPORTED' | 'USER_CANCELLED' | 'PASSKEY_NOT_FOUND' | 'SESSION_EXPIRED' | 'NETWORK_FAILURE' | 'INVALID_ARGUMENT' | 'TIMEOUT' | 'ABORTED' | 'ABORT_ERROR' | 'CHALLENGE_MISMATCH' | 'UNKNOWN_ERROR';
+type TryMellonErrorCode = 'NOT_SUPPORTED' | 'USER_CANCELLED' | 'PASSKEY_NOT_FOUND' | 'SESSION_EXPIRED' | 'NETWORK_FAILURE' | 'INVALID_ARGUMENT' | 'TIMEOUT' | 'ABORTED' | 'ABORT_ERROR' | 'CHALLENGE_MISMATCH' | 'TICKET_NOT_FOUND' | 'TICKET_EXPIRED' | 'TICKET_ALREADY_USED' | 'PIN_MISMATCH' | 'PIN_LOCKED' | 'BRIDGE_SESSION_EXPIRED' | 'UNKNOWN_ERROR';
 declare class TryMellonError extends Error {
     readonly code: TryMellonErrorCode;
     readonly details?: unknown;
@@ -61,6 +61,14 @@ type TryMellonConfig = {
      * Set this in Node or when the document origin is not the correct one (e.g. SSR).
      */
     origin?: string;
+    /**
+     * Optional storage for context hash (e.g. sessionStorage). If not set, browser sessionStorage or in-memory fallback is used.
+     * Injected for testability and SSR; must implement getItem/setItem.
+     */
+    contextHashStorage?: {
+        getItem(key: string): string | null;
+        setItem(key: string, value: string): void;
+    };
 };
 interface RegisterOptions {
     /**
@@ -108,19 +116,19 @@ type SuccessEventUserInfo = {
 /** Success payload: token always present (03-eventos-seguridad). Nonce when flow generates it. */
 type SuccessEventPayload = {
     type: 'success';
-    operation: 'register' | 'authenticate';
+    operation: 'register' | 'authenticate' | 'enroll';
     token: string;
     user?: SuccessEventUserInfo;
     nonce?: string;
 };
 type EventPayload = {
     type: 'start';
-    operation: 'register' | 'authenticate';
+    operation: 'register' | 'authenticate' | 'enroll';
     nonce?: string;
 } | SuccessEventPayload | {
     type: 'error';
     error: TryMellonError;
-    operation?: 'register' | 'authenticate';
+    operation?: 'register' | 'authenticate' | 'enroll';
     nonce?: string;
 } | {
     type: 'cancelled';
@@ -143,6 +151,31 @@ type EmailFallbackVerifyResult = {
     /** Set when successUrl was passed and allowed by application allowlist */
     redirectUrl?: string;
 };
+type EnrollOptions = {
+    ticketId: string;
+    signal?: AbortSignal;
+};
+/** Result of finish enrollment; aligns with backend envelope (session_token). */
+type EnrollmentResult = {
+    sessionToken: string;
+};
+/** Backend response for POST /v1/enrollment/register/options. Validators use this shape. */
+type EnrollmentStartResponse = {
+    session_id: string;
+    challenge: RegisterStartResponse['challenge'];
+};
+/** Backend response for POST /v1/enrollment/register. Validators use this shape. */
+type EnrollmentFinishResponse = {
+    credential_id: string;
+    status: string;
+    session_token: string;
+    user: {
+        user_id: string;
+        external_user_id?: string;
+        email?: string;
+        metadata?: Record<string, unknown>;
+    };
+};
 type RecoveryVerifyResponse = {
     challenge: Record<string, unknown>;
     recovery_session_id: string;
@@ -240,6 +273,62 @@ type CrossDeviceVerifyRegistrationRequest = {
     session_id: string;
     credential: RegisterFinishRequest['credential'];
 };
+/** Response from GET context/:sessionId (auth or registration). Aligns with backend unwrapped result. */
+type BridgeContextResponse = {
+    type: 'auth' | 'registration';
+    options: Record<string, unknown>;
+    application_name?: string;
+};
+/** Response from POST verify/:sessionId (challenge / options for WebAuthn). */
+type BridgeChallengeResponse = {
+    session_id: string;
+    challenge?: string;
+    registration_options?: Record<string, unknown>;
+    authentication_options?: Record<string, unknown>;
+};
+/** Backend result of POST complete (enrollment). Validators use this shape. */
+type BridgeCompleteEnrollmentResult = {
+    credential_id: string;
+    entity_id: string;
+    user_id: string;
+    session_token: string;
+};
+/** Backend result of POST complete (auth). */
+type BridgeCompleteAuthResult = {
+    session_token: string;
+};
+/** Options for bridge flows: PIN callback, optional preset PIN, abort signal. */
+type BridgeOptions = {
+    onPinRequired?: () => Promise<string>;
+    presencePin?: string;
+    signal?: AbortSignal;
+};
+/** Public result of bridge enrollment: sessionToken and optional credential/user/entity ids. */
+type BridgeEnrollmentResult = {
+    sessionToken: string;
+    credentialId?: string;
+    userId?: string;
+    entityId?: string;
+};
+/** Public result of bridge auth: sessionToken only. */
+type BridgeAuthResult = {
+    sessionToken: string;
+};
+/** Union: bridge completion returns enrollment or auth result. */
+type BridgeResult = BridgeEnrollmentResult | BridgeAuthResult;
+/** Status snapshot from GET .../status/:sessionId (polling or SSE event). Terminal: pin_verified | pin_locked | completed. */
+type BridgeStatusSnapshot = {
+    status: 'pending' | 'pin_verified' | 'pin_locked' | 'completed';
+    ts?: string;
+};
+/** Options for complete(): BridgeOptions plus kind and enrollment-only fields. */
+type BridgeCompleteOptions = BridgeOptions & {
+    kind: 'enrollment' | 'auth';
+    /** Required when completing enrollment bridge. */
+    ticketId?: string;
+    /** Required when completing enrollment bridge. */
+    entityId?: string;
+};
 type RegisterStartRequest = {
     external_user_id: string;
 };
@@ -458,6 +547,8 @@ type OnboardingRegisterResponseWithChallenge = OnboardingRegisterResponse & {
     challenge?: RegisterStartResponse['challenge'];
 };
 
+/** Bridge kind: enrollment-bridge (registration flow) or auth-bridge (auth flow). */
+type BridgeKind = 'enrollment' | 'auth';
 declare class ApiClient {
     private readonly httpClient;
     private readonly baseUrl;
@@ -504,6 +595,49 @@ declare class ApiClient {
     verifyCrossDeviceRegistration(request: CrossDeviceVerifyRegistrationRequest): Promise<Result<void, TryMellonError>>;
     verifyAccountRecoveryOtp(externalUserId: string, otp: string): Promise<Result<RecoveryVerifyResponse, TryMellonError>>;
     completeAccountRecovery(recoverySessionId: string, credential: Record<string, unknown>): Promise<Result<RecoveryCompleteResponse, TryMellonError>>;
+    startEnrollment(ticketId: string, contextHash: string, headers?: Record<string, string>): Promise<Result<EnrollmentStartResponse, TryMellonError>>;
+    finishEnrollment(ticketId: string, body: {
+        credential: unknown;
+        context_hash: string;
+    }, headers?: Record<string, string>): Promise<Result<EnrollmentFinishResponse, TryMellonError>>;
+    private bridgePrefix;
+    getBridgeContext(sessionId: string, kind: BridgeKind, headers?: Record<string, string>): Promise<Result<BridgeContextResponse, TryMellonError>>;
+    verifyBridgePin(sessionId: string, pin: string, kind: BridgeKind, headers?: Record<string, string>): Promise<Result<BridgeChallengeResponse, TryMellonError>>;
+    completeBridgeEnrollment(body: {
+        session_id: string;
+        ticket_id: string;
+        entity_id: string;
+        context_hash: string;
+        registration_response: {
+            id: string;
+            rawId: string;
+            response: {
+                clientDataJSON: string;
+                attestationObject: string;
+            };
+            type: string;
+        };
+    }, headers?: Record<string, string>): Promise<Result<BridgeCompleteEnrollmentResult, TryMellonError>>;
+    completeBridgeAuth(body: {
+        session_id: string;
+        credential: {
+            id: string;
+            rawId: string;
+            response: {
+                authenticatorData: string;
+                clientDataJSON: string;
+                signature: string;
+                userHandle?: string;
+            };
+            type: string;
+        };
+    }, headers?: Record<string, string>): Promise<Result<BridgeCompleteAuthResult, TryMellonError>>;
+    /**
+     * Full URL for GET bridge status (polling or EventSource). Same path as getBridgeStatus.
+     * Used by BridgeManager for SSE when EventSource is available (browser only; Node has no EventSource).
+     */
+    getBridgeStatusUrl(sessionId: string, kind: BridgeKind): string;
+    getBridgeStatus(sessionId: string, kind: BridgeKind, headers?: Record<string, string>): Promise<Result<BridgeStatusSnapshot, TryMellonError>>;
 }
 
 declare class OnboardingManager {
@@ -531,6 +665,9 @@ declare class TryMellon {
     private authService;
     private recoveryService;
     onboarding: OnboardingManager;
+    private readonly enrollmentManager;
+    private readonly bridgeManager;
+    private readonly contextHashStorage;
     /**
      * Creates a new TryMellon instance.
      * Validates config and returns a Result.
@@ -542,9 +679,25 @@ declare class TryMellon {
      * This constructor will throw errors if configuration is invalid.
      */
     constructor(config: TryMellonConfig);
+    /**
+     * Bridge (KP-BRIDGE-04): complete enrollment or auth from a second device (e.g. mobile scanning desktop QR).
+     * Use kind 'enrollment' for enrollment-bridge sessions, 'auth' for auth-bridge sessions.
+     */
+    get bridge(): {
+        getContext(sessionId: string, kind: 'enrollment' | 'auth'): Promise<Result<BridgeContextResponse, TryMellonError>>;
+        verifyPin(sessionId: string, pin: string, kind: 'enrollment' | 'auth'): Promise<Result<BridgeChallengeResponse, TryMellonError>>;
+        complete(sessionId: string, options?: BridgeCompleteOptions): Promise<Result<BridgeResult, TryMellonError>>;
+        waitForResult(sessionId: string, options?: {
+            useSse?: boolean;
+            kind?: 'enrollment' | 'auth';
+            timeoutMs?: number;
+        }): Promise<Result<BridgeStatusSnapshot, TryMellonError>>;
+    };
     static isSupported(): boolean;
     register(options: RegisterOptions): Promise<Result<RegisterResult, TryMellonError>>;
     authenticate(options: AuthenticateOptions): Promise<Result<AuthenticateResult, TryMellonError>>;
+    enroll(options: EnrollOptions): Promise<Result<EnrollmentResult, TryMellonError>>;
+    getContextHash(): string;
     validateSession(sessionToken: string): Promise<Result<SessionValidateResponse, TryMellonError>>;
     getStatus(): Promise<ClientStatus>;
     on(event: TryMellonEvent, handler: EventHandler): () => void;
@@ -573,4 +726,4 @@ declare class TryMellon {
     };
 }
 
-export { type AuthenticateResult as A, type Result as R, TryMellon as T, type RegisterResult as a, TryMellonError as b, type RegisterOptions as c, type AuthenticateOptions as d, type TryMellonConfig as e };
+export { type AuthenticateResult as A, type EnrollmentResult as E, type Result as R, TryMellon as T, type RegisterResult as a, TryMellonError as b, type RegisterOptions as c, type AuthenticateOptions as d, type EnrollOptions as e, type TryMellonConfig as f };

package/dist/{trymellon-P7BPxIry.d.ts → trymellon-DItEFTiv.d.ts}

@@ -1,4 +1,4 @@
-type TryMellonErrorCode = 'NOT_SUPPORTED' | 'USER_CANCELLED' | 'PASSKEY_NOT_FOUND' | 'SESSION_EXPIRED' | 'NETWORK_FAILURE' | 'INVALID_ARGUMENT' | 'TIMEOUT' | 'ABORTED' | 'ABORT_ERROR' | 'CHALLENGE_MISMATCH' | 'UNKNOWN_ERROR';
+type TryMellonErrorCode = 'NOT_SUPPORTED' | 'USER_CANCELLED' | 'PASSKEY_NOT_FOUND' | 'SESSION_EXPIRED' | 'NETWORK_FAILURE' | 'INVALID_ARGUMENT' | 'TIMEOUT' | 'ABORTED' | 'ABORT_ERROR' | 'CHALLENGE_MISMATCH' | 'TICKET_NOT_FOUND' | 'TICKET_EXPIRED' | 'TICKET_ALREADY_USED' | 'PIN_MISMATCH' | 'PIN_LOCKED' | 'BRIDGE_SESSION_EXPIRED' | 'UNKNOWN_ERROR';
 declare class TryMellonError extends Error {
     readonly code: TryMellonErrorCode;
     readonly details?: unknown;
@@ -61,6 +61,14 @@ type TryMellonConfig = {
      * Set this in Node or when the document origin is not the correct one (e.g. SSR).
      */
     origin?: string;
+    /**
+     * Optional storage for context hash (e.g. sessionStorage). If not set, browser sessionStorage or in-memory fallback is used.
+     * Injected for testability and SSR; must implement getItem/setItem.
+     */
+    contextHashStorage?: {
+        getItem(key: string): string | null;
+        setItem(key: string, value: string): void;
+    };
 };
 interface RegisterOptions {
     /**
@@ -108,19 +116,19 @@ type SuccessEventUserInfo = {
 /** Success payload: token always present (03-eventos-seguridad). Nonce when flow generates it. */
 type SuccessEventPayload = {
     type: 'success';
-    operation: 'register' | 'authenticate';
+    operation: 'register' | 'authenticate' | 'enroll';
     token: string;
     user?: SuccessEventUserInfo;
     nonce?: string;
 };
 type EventPayload = {
     type: 'start';
-    operation: 'register' | 'authenticate';
+    operation: 'register' | 'authenticate' | 'enroll';
     nonce?: string;
 } | SuccessEventPayload | {
     type: 'error';
     error: TryMellonError;
-    operation?: 'register' | 'authenticate';
+    operation?: 'register' | 'authenticate' | 'enroll';
     nonce?: string;
 } | {
     type: 'cancelled';
@@ -143,6 +151,31 @@ type EmailFallbackVerifyResult = {
     /** Set when successUrl was passed and allowed by application allowlist */
     redirectUrl?: string;
 };
+type EnrollOptions = {
+    ticketId: string;
+    signal?: AbortSignal;
+};
+/** Result of finish enrollment; aligns with backend envelope (session_token). */
+type EnrollmentResult = {
+    sessionToken: string;
+};
+/** Backend response for POST /v1/enrollment/register/options. Validators use this shape. */
+type EnrollmentStartResponse = {
+    session_id: string;
+    challenge: RegisterStartResponse['challenge'];
+};
+/** Backend response for POST /v1/enrollment/register. Validators use this shape. */
+type EnrollmentFinishResponse = {
+    credential_id: string;
+    status: string;
+    session_token: string;
+    user: {
+        user_id: string;
+        external_user_id?: string;
+        email?: string;
+        metadata?: Record<string, unknown>;
+    };
+};
 type RecoveryVerifyResponse = {
     challenge: Record<string, unknown>;
     recovery_session_id: string;
@@ -240,6 +273,62 @@ type CrossDeviceVerifyRegistrationRequest = {
     session_id: string;
     credential: RegisterFinishRequest['credential'];
 };
+/** Response from GET context/:sessionId (auth or registration). Aligns with backend unwrapped result. */
+type BridgeContextResponse = {
+    type: 'auth' | 'registration';
+    options: Record<string, unknown>;
+    application_name?: string;
+};
+/** Response from POST verify/:sessionId (challenge / options for WebAuthn). */
+type BridgeChallengeResponse = {
+    session_id: string;
+    challenge?: string;
+    registration_options?: Record<string, unknown>;
+    authentication_options?: Record<string, unknown>;
+};
+/** Backend result of POST complete (enrollment). Validators use this shape. */
+type BridgeCompleteEnrollmentResult = {
+    credential_id: string;
+    entity_id: string;
+    user_id: string;
+    session_token: string;
+};
+/** Backend result of POST complete (auth). */
+type BridgeCompleteAuthResult = {
+    session_token: string;
+};
+/** Options for bridge flows: PIN callback, optional preset PIN, abort signal. */
+type BridgeOptions = {
+    onPinRequired?: () => Promise<string>;
+    presencePin?: string;
+    signal?: AbortSignal;
+};
+/** Public result of bridge enrollment: sessionToken and optional credential/user/entity ids. */
+type BridgeEnrollmentResult = {
+    sessionToken: string;
+    credentialId?: string;
+    userId?: string;
+    entityId?: string;
+};
+/** Public result of bridge auth: sessionToken only. */
+type BridgeAuthResult = {
+    sessionToken: string;
+};
+/** Union: bridge completion returns enrollment or auth result. */
+type BridgeResult = BridgeEnrollmentResult | BridgeAuthResult;
+/** Status snapshot from GET .../status/:sessionId (polling or SSE event). Terminal: pin_verified | pin_locked | completed. */
+type BridgeStatusSnapshot = {
+    status: 'pending' | 'pin_verified' | 'pin_locked' | 'completed';
+    ts?: string;
+};
+/** Options for complete(): BridgeOptions plus kind and enrollment-only fields. */
+type BridgeCompleteOptions = BridgeOptions & {
+    kind: 'enrollment' | 'auth';
+    /** Required when completing enrollment bridge. */
+    ticketId?: string;
+    /** Required when completing enrollment bridge. */
+    entityId?: string;
+};
 type RegisterStartRequest = {
     external_user_id: string;
 };
@@ -458,6 +547,8 @@ type OnboardingRegisterResponseWithChallenge = OnboardingRegisterResponse & {
     challenge?: RegisterStartResponse['challenge'];
 };
 
+/** Bridge kind: enrollment-bridge (registration flow) or auth-bridge (auth flow). */
+type BridgeKind = 'enrollment' | 'auth';
 declare class ApiClient {
     private readonly httpClient;
     private readonly baseUrl;
@@ -504,6 +595,49 @@ declare class ApiClient {
     verifyCrossDeviceRegistration(request: CrossDeviceVerifyRegistrationRequest): Promise<Result<void, TryMellonError>>;
     verifyAccountRecoveryOtp(externalUserId: string, otp: string): Promise<Result<RecoveryVerifyResponse, TryMellonError>>;
     completeAccountRecovery(recoverySessionId: string, credential: Record<string, unknown>): Promise<Result<RecoveryCompleteResponse, TryMellonError>>;
+    startEnrollment(ticketId: string, contextHash: string, headers?: Record<string, string>): Promise<Result<EnrollmentStartResponse, TryMellonError>>;
+    finishEnrollment(ticketId: string, body: {
+        credential: unknown;
+        context_hash: string;
+    }, headers?: Record<string, string>): Promise<Result<EnrollmentFinishResponse, TryMellonError>>;
+    private bridgePrefix;
+    getBridgeContext(sessionId: string, kind: BridgeKind, headers?: Record<string, string>): Promise<Result<BridgeContextResponse, TryMellonError>>;
+    verifyBridgePin(sessionId: string, pin: string, kind: BridgeKind, headers?: Record<string, string>): Promise<Result<BridgeChallengeResponse, TryMellonError>>;
+    completeBridgeEnrollment(body: {
+        session_id: string;
+        ticket_id: string;
+        entity_id: string;
+        context_hash: string;
+        registration_response: {
+            id: string;
+            rawId: string;
+            response: {
+                clientDataJSON: string;
+                attestationObject: string;
+            };
+            type: string;
+        };
+    }, headers?: Record<string, string>): Promise<Result<BridgeCompleteEnrollmentResult, TryMellonError>>;
+    completeBridgeAuth(body: {
+        session_id: string;
+        credential: {
+            id: string;
+            rawId: string;
+            response: {
+                authenticatorData: string;
+                clientDataJSON: string;
+                signature: string;
+                userHandle?: string;
+            };
+            type: string;
+        };
+    }, headers?: Record<string, string>): Promise<Result<BridgeCompleteAuthResult, TryMellonError>>;
+    /**
+     * Full URL for GET bridge status (polling or EventSource). Same path as getBridgeStatus.
+     * Used by BridgeManager for SSE when EventSource is available (browser only; Node has no EventSource).
+     */
+    getBridgeStatusUrl(sessionId: string, kind: BridgeKind): string;
+    getBridgeStatus(sessionId: string, kind: BridgeKind, headers?: Record<string, string>): Promise<Result<BridgeStatusSnapshot, TryMellonError>>;
 }
 
 declare class OnboardingManager {
@@ -531,6 +665,9 @@ declare class TryMellon {
     private authService;
     private recoveryService;
     onboarding: OnboardingManager;
+    private readonly enrollmentManager;
+    private readonly bridgeManager;
+    private readonly contextHashStorage;
     /**
      * Creates a new TryMellon instance.
      * Validates config and returns a Result.
@@ -542,9 +679,25 @@ declare class TryMellon {
      * This constructor will throw errors if configuration is invalid.
      */
     constructor(config: TryMellonConfig);
+    /**
+     * Bridge (KP-BRIDGE-04): complete enrollment or auth from a second device (e.g. mobile scanning desktop QR).
+     * Use kind 'enrollment' for enrollment-bridge sessions, 'auth' for auth-bridge sessions.
+     */
+    get bridge(): {
+        getContext(sessionId: string, kind: 'enrollment' | 'auth'): Promise<Result<BridgeContextResponse, TryMellonError>>;
+        verifyPin(sessionId: string, pin: string, kind: 'enrollment' | 'auth'): Promise<Result<BridgeChallengeResponse, TryMellonError>>;
+        complete(sessionId: string, options?: BridgeCompleteOptions): Promise<Result<BridgeResult, TryMellonError>>;
+        waitForResult(sessionId: string, options?: {
+            useSse?: boolean;
+            kind?: 'enrollment' | 'auth';
+            timeoutMs?: number;
+        }): Promise<Result<BridgeStatusSnapshot, TryMellonError>>;
+    };
     static isSupported(): boolean;
     register(options: RegisterOptions): Promise<Result<RegisterResult, TryMellonError>>;
     authenticate(options: AuthenticateOptions): Promise<Result<AuthenticateResult, TryMellonError>>;
+    enroll(options: EnrollOptions): Promise<Result<EnrollmentResult, TryMellonError>>;
+    getContextHash(): string;
     validateSession(sessionToken: string): Promise<Result<SessionValidateResponse, TryMellonError>>;
     getStatus(): Promise<ClientStatus>;
     on(event: TryMellonEvent, handler: EventHandler): () => void;
@@ -573,4 +726,4 @@ declare class TryMellon {
     };
 }
 
-export { type AuthenticateResult as A, type Result as R, TryMellon as T, type RegisterResult as a, TryMellonError as b, type RegisterOptions as c, type AuthenticateOptions as d, type TryMellonConfig as e };
+export { type AuthenticateResult as A, type EnrollmentResult as E, type Result as R, TryMellon as T, type RegisterResult as a, TryMellonError as b, type RegisterOptions as c, type AuthenticateOptions as d, type EnrollOptions as e, type TryMellonConfig as f };