@verifiedinc-public/client-sdk

An SDK for serving Verified's 1-click service into web applications.

Features

• 🔒 Secure iframe-based integration
• 📝 Type-safe implementation with TypeScript
• 📊 Built-in logging system for debugging
• 🌐 Multiple module format support (ESM, UMD)
• 🛠️ Modern build tooling with Vite

Installation

npm install @verifiedinc-public/client-sdk

Usage

import {
  VerifiedClientSdk,
  SdkResult,
  SdkEvent,
  SdkError,
  SdkResultValues,
  SdkEventValues,
  SdkErrorReasons,
} from '@verifiedinc-public/client-sdk';

// Initialize the SDK
const sdk = new VerifiedClientSdk({
  sessionKey: 'YOUR_SESSION_KEY',
  onResult: handleResult,
  onError: handleError,
  onEvent: handleEvent,
});

// Handle successful results
function handleResult(data: SdkResult) {
  switch (data.type) {
    case SdkResultValues.USER_SHARED_CREDENTIALS:
      console.log('User shared credentials', data);
      break;
    case SdkResultValues.USER_SHARED_HEALTH_DATA:
      console.log('User shared health data', data);
      break;
    case SdkResultValues.USER_OPTED_OUT:
      console.log('User opted out', data);
      break;
    case SdkResultValues.NO_CREDENTIALS_FOUND:
      console.log('No credentials found', data);
      break;
    case SdkResultValues.NO_INSURANCE_FOUND:
      console.log('No insurance found', data);
      break;
    case SdkResultValues.RISK_SCORE_TOO_HIGH:
      console.log('Risk score too high', data);
      break;
    case SdkResultValues.MAX_INPUT_ATTEMPTS_EXCEEDED:
      console.log('Max input attempts exceeded', data);
      break;
    case SdkResultValues.MAX_VERIFICATION_CODE_ATTEMPTS_EXCEEDED:
      console.log('Max OTP attempts exceeded', data);
      break;
  }
}

// Handle errors
function handleError(error: SdkError) {
  console.error('SDK error:', error.reason);

  switch (error.reason) {
    case SdkErrorReasons.INVALID_SESSION_KEY:
      // Call POST /sessionKey on server to get a new session key
      break;
    case SdkErrorReasons.SESSION_TIMEOUT:
      // Call POST /sessionKey on server and create new VerifiedClientSdk instance
      break;
    case SdkErrorReasons.SHARE_CREDENTIALS_ERROR:
      // Handle credential sharing error
      break;
  }
}

// Handle intermediary events
function handleEvent(event: SdkEvent) {
  // metadata is always available
  console.log(event.metadata);

  switch (event.type) {
    case SdkEventValues.SDK_READY:
      // Web app rendered the content
      break;
    case SdkEventValues.USER_STEP_CHANGE:
      // User navigated to a new step
      console.log(event.step, event.previousStep);
      break;
    case SdkEventValues.STEP_TIME_SPENT:
      // User left a step, includes duration
      console.log(event.step, event.durationMs);
      break;
    case SdkEventValues.USER_COMPLETED_PRODUCT:
      // User completed a product flow
      console.log(event.product);
      break;
    case SdkEventValues.ONE_CLICK_SIGNUP_FORM_SUBMITTED:
      // Signup form submitted
      console.log(event.form);
      break;
    case SdkEventValues.ONE_CLICK_HEALTH_FORM_SUBMITTED:
      // Health form submitted
      console.log(event.form);
      break;
  }
}

// Display the SDK in your application
sdk.show(document.getElementById('sdk-container') as HTMLElement);

Module Formats

The SDK is available in multiple formats:

• ESM (default): dist/index.esm.js
• UMD (browser): dist/index.umd.js
• TypeScript declarations: dist/index.d.ts