JSPM – @tn3w/openage@1.0.4

Package Exports

@tn3w/openage

Readme

Privacy-first age verification for the web

OpenAge runs face tracking, liveness checks, and age estimation on-device. Use it as a drop-in age gate with a checkbox-style widget, modal flow, or button binding.

At a Glance

Browser-side	Server-backed	UI
On-device face analysis	Optional WASM verification	Embedded widget + popup
No raw camera upload	Signed sessions and tokens	Normal, compact, invisible
Serverless soft gates	Hosted or custom backend	Auto, light, dark

Install

npm install @tn3w/openage

<script src="https://cdn.jsdelivr.net/npm/@tn3w/openage/dist/openage.min.js"></script>

Quick Start

CDN

<div class="openage" data-sitekey="ag_live_xxxx" data-callback="onVerified"></div>

<script src="https://cdn.jsdelivr.net/npm/@tn3w/openage/dist/openage.min.js"></script>
<script>
    function onVerified(token) {
        console.log('verified', token);
    }
</script>

npm

import OpenAge from '@tn3w/openage';

OpenAge.render('#gate', {
    mode: 'serverless',
    minAge: 18,
    callback: (token) => console.log(token),
    errorCallback: (error) => console.error(error),
});

Bound Flow

OpenAge.bind('#buy-btn', {
    sitekey: 'ag_live_xxxx',
    callback: (token) => submitForm(token),
});

Modes

Mode	Backend	Use case
`serverless`	none	client-only soft gates
`sitekey`	OpenAge hosted	production verification
`custom`	your server	self-hosted verification

serverless keeps everything local and returns a client-signed token. sitekey and custom use a server session and a WASM VM for stronger checks.

Core API

OpenAge.render(container, params);
OpenAge.open(params);
OpenAge.bind(element, params);

OpenAge.reset(widgetId);
OpenAge.remove(widgetId);
OpenAge.getToken(widgetId);
OpenAge.execute(widgetId);

await OpenAge.challenge(params);

Main Params

Param	Values
`mode`	`serverless`, `sitekey`, `custom`
`theme`	`light`, `dark`, `auto`
`size`	`normal`, `compact`, `invisible`
`minAge`	number, default `18`
`sitekey`	required for hosted mode
`server`	required for custom mode

Demo

Static demo: https://tn3w.github.io/OpenAge/
Local server demo:

cd server
pip install -r requirements.txt
python server.py

The repository also includes demo/, a minimal GitHub Pages build that loads the jsDelivr bundle for @tn3w/openage in embedded serverless mode.

Development

npm install
npm test
npm run build
npm run dev

Optional server:

cd server
pip install -r requirements.txt
python server.py

Formatting

pip install black isort
isort . && black .
npx prtfm
clang-format -i server/wasm/src/*.c server/wasm/src/*.h

License

Apache 2.0