@bespot/gatekeeper-web-sdk

Bespot Gatekeeper Web SDK

Browser SDK for Bespot Gatekeeper antifraud checks. This repository contains pre-built SDK bundles, integration documentation, and starter templates.

Documentation

Document	Description
Integration guide	Full end-to-end integration reference
Authentication	JWT access tokens and OAuth (server-side)
Error reference	Error handling rules and error.name catalog
SDK versioning	SDK package version vs application version
Templates	Copy-paste HTML and config starters

Official authentication API reference: Bespot Authentication Guide.

Installation

npm (recommended)

npm install @bespot/gatekeeper-web-sdk

import SafeSDK from '@bespot/gatekeeper-web-sdk'

CDN / script tag (no build step)

Download safe-sdk.esm.min.js or safe-sdk.umd.min.js from the Releases page and host the files on your CDN or static origin.

Quick start

• Install — npm install @bespot/gatekeeper-web-sdk or download from Releases
• Configure — four runtime fields: baseUrl, apiKey, applicationId, applicationVersion (runtime configuration)
• Authenticate — obtain a JWT from your backend (authentication)
• Integrate — await sdk.initialize(jwt) then await sdk.check() (integration sequence)

const sdk = new SafeSDK({
  baseUrl: 'https://gatekeeper.bespot.dev/v2',
  apiKey: 'your-api-key',
  applicationId: 'your-app-id',
  applicationVersion: 'your-app-version',
})

await sdk.initialize(jwt)

const result = await sdk.check()
if (result instanceof Error) {
  console.error('Check failed:', result.name)
} else {
  console.log('Check passed:', result)
}

Starter pages: templates/integration-esm.html, templates/integration-umd.html.

License

Use of the SDK is governed by LICENSE.

Support

See Support in the integration guide.