@persona-js/verify

@persona-js/verify

A vanilla JavaScript module to run embedded/hosted flow without any dependencies, against the official npm module which has some dependencies in both internally/externally.

⚠️ This package is still in beta and missing some features of official module, so still not recommended using in production.

Install

npx i @persona-js/verify

Usage

import { newInquiry } from '@persona-js/verify'

const TEMPLATE_ID = 'tmpl_xyzxyzxyz'

const verificationWithPersona = newInquiry(TEMPLATE_ID)

// prefilling
verificationWithPersona.prefill({ nameFirst: 'Kengo' })

// Also constructor function can accepts prefiling
newInquiry(TEMPLATE_ID, { prefill: { nameFirst: 'Kengo' } })

// Event listening
verificationWIthPersona.on('start', (inquiryId) => { /* what I want to do on starting inquiry flow */ })

verificationWithPersona.getHostedFlowUrl() //=> Returns URL for the hosted flow
verificationWithPersona.start() //=> Embedded flow starts on current window

// Can chain
newInquiry(TEMPLATE_ID)
  .prefill({ nameLast: 'Hamasaki' })
  .on('complete', (inquiryId) => { /* what I want to do on completing embedded flow */ })
  .on('fail', (inquiryId) => { /* what I want to do on failing embedded flow */ })
  .on('exit', () => { /* what I want to do on exiting embedded flow */ })

License

MIT

ToDo

• Use shadow DOM
• Avoid multiple UI insertions
• Support undocumented events?
  • Like verification-change, country-select...etc
• Support insertion into a specific element on HTML?
• Throw exceptions on unintentional parameters/arguments
• a11y
• ESM build
• Separate down the monolithic index.ts
• License
  • For each module
  • For cdn build
• Test
• Demo
  • Resume inquriy demo
  • Popup events from embedded flow
  • Do with TypeScript